Package org.simulator.fba

Class COBRAsolver

java.lang.Object

org.simulator.fba.COBRAsolver

public class COBRAsolver
extends Object

This solver implementation only accepts SBML models with FBC package versions 1 or 2.

Since:

1.5

Author:

Andreas Dräger, Ali Ebrahim, Shalin Shah

Constructor Summary

Constructors

Constructor	Description
COBRAsolver(org.sbml.jsbml.SBMLDocument doc)	Initializes the linear program and all data structures based on the definitions in the given SBMLDocument.

Method Summary

Modifier and Type	Method	Description
double	getObjetiveValue()	Returns the objective value of the current solution.
double	getValue(String reactionId)	Returns the solution value for the Reaction variable with the given identifier.
double[]	getValues()	Returns solution values for an array of Reaction variables.
boolean	solve()	Solves the linear program that is defined in the SBMLDocument with which this solver was initialized.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

COBRAsolver

public COBRAsolver(org.sbml.jsbml.SBMLDocument doc)
            throws org.sbml.jsbml.SBMLException,
                   org.sbml.jsbml.validator.ModelOverdeterminedException

Initializes the linear program and all data structures based on the definitions in the given SBMLDocument. This implementation should work for diverse levels and versions of SBML Models given that the model contains an fbc package in version 1 or 2.

Parameters:

doc - the SBML container from which the Model is taken. This implementation only understands SBML core (diverse levels and versions) in combination with fbc versions 1 and 2.

Throws:

org.sbml.jsbml.validator.ModelOverdeterminedException - if the Model is over determined through AlgebraicRules.

org.sbml.jsbml.SBMLException - if the Model is invalid or inappropriate for flux balance analysis.

Method Detail

solve

public boolean solve()
              throws NullPointerException

Solves the linear program that is defined in the SBMLDocument with which this solver was initialized.

Returns:

A Boolean value reporting whether a feasible solution has been found. This solution is not necessarily optimal. If false is returned, a feasible solution may still be present, but IloCplex has not been able to prove its feasibility.

Throws:

NullPointerException - If the method fails, an exception of type NullPointerException, or one of its derived classes, is thrown.

getObjetiveValue

public double getObjetiveValue()
                        throws NullPointerException

Returns the objective value of the current solution.

Returns:

the objective value of the current solution.

Throws:

NullPointerException - If the method fails, an exception of type IloException, or one of its derived classes, is thrown.

getValue

public double getValue(String reactionId)
                throws NullPointerException,
                       ArrayIndexOutOfBoundsException

Returns the solution value for the Reaction variable with the given identifier.

Parameters:

reactionId - the identifier of the Reaction of interest.

Returns:

The value the Reaction takes for the current solution.

Throws:

NullPointerException - If the Reaction identifier is not in the active model.

ArrayIndexOutOfBoundsException - If the method fails, an exception of type ArrayIndexOutOfBoundsException, or one of its derived classes, is thrown.

getValues

public double[] getValues()
                   throws NullPointerException

Returns solution values for an array of Reaction variables.

Returns:

The solution values for the variables in the list of reactions.

Throws:

NullPointerException - If the method fails, an exception of type NullPointerException, or one of its derived classes, is thrown.