Difference between revisions of "Flux balance analysis"

From BioUML platform
Jump to: navigation, search
(FBA via Analysis tab)
 
Line 7: Line 7:
 
==FBA via Diagram==
 
==FBA via Diagram==
 
<font size="3">
 
<font size="3">
If the {{Type link|diagram}} contains fluxes properties written as fbc extension of the SBML "FBC table" tab can be used. Advantage of this tab usage is lack of necessity in creation table with data about fluxes: it will be created automatically using {{Type link|diagram}}. The step-by-step instruction of the analysis will be demonstrated on the <I>[https://ict.biouml.org/bioumlweb/#de=data/Collaboration/FBA%20models/Data/Geobacillus%20icigianus/iMK1321_Model iMK1321]</i> model for <i>Geobacillus icigianus</i> developed by our research group and [https://doi.org/10.3390/microorganisms8071002 recently published]. <b><i>Note:</i></b> opening of the large-size diagram may take a while due to the size and layouting of the diagram.
+
If the {{Type link|diagram}} contains fluxes properties written as fbc extension of the SBML "FBC table" tab can be used. Advantage of this tab usage is lack of necessity in creation table with data about fluxes: it will be created automatically using {{Type link|diagram}}. The step-by-step instruction of the analysis will be demonstrated on the <i>[https://ict.biouml.org/bioumlweb/#de=data/Collaboration/FBA%20models/Data/Geobacillus%20icigianus/iMK1321_Model iMK1321]</i> model for <i>Geobacillus icigianus</i> developed by our research group and [https://doi.org/10.3390/microorganisms8071002 recently published]. <b><i>Note:</i></b> opening of the large-size diagram may take a while due to the size and layouting of the diagram.
  
  
Line 45: Line 45:
  
 
</font size="3">
 
</font size="3">
 +
 +
  
 
==FBA via Analysis tab==
 
==FBA via Analysis tab==
Line 89: Line 91:
  
 
<span style="font-size: 90%"> '''Figure 10.''' Resulting "FBC table" tab usage for <i>iMK1321</i> model. The objective function's value of the model is marked red.</span>
 
<span style="font-size: 90%"> '''Figure 10.''' Resulting "FBC table" tab usage for <i>iMK1321</i> model. The objective function's value of the model is marked red.</span>
 +
</font size="3">
 +
 +
 +
 +
==FBA using Jupyter Notebook==
 +
<font size="3">
 +
Furthermore, the Jupyter Notebook core in BioUML has been extented on our web-server to run this type of models using well-known [http://dx.doi.org/doi:10.1186/1752-0509-7-74 COBRAPy package] and corresponding [https://ict.biouml.org/bioumlweb/#de=data/Collaboration/FBA%20models/Data/Geobacillus%20icigianus/FBA_in_BioUML.ipynb Jupyter Notebook] has been created to run the [https://doi.org/10.3390/microorganisms8071002 <i>iMK1321</i> metabolic model] using [http://www.gnu.org/software/glpk/glpk.html GLPK (GNU Linear Programming Kit) solver] as an example. To open the Notebook, double-click of the left mouse button the file name in the <b>Tree Area</b> (marked red below).
 +
 +
[[File:FBA_viaJNotebook_Fig1_18_03.png|1000px]]
 +
 +
<span style="font-size: 90%"> '''Figure 11.''' User guide: FBA via COBRApy in BioUML for <i>iMK1321</i> model.</span>
 
</font size="3">
 
</font size="3">

Latest revision as of 18:06, 18 March 2022

Constraint-based flux balance analysis (FBA) is a mathematical approach that enables to provide a holistic view of the cellular metabolism in pro- and eukaryotes and predict flux distribution in a global (on a genome-scale level) metabolic network both under a range of environmental conditions and genetic perturbations. The maximization of the biomass equation is typically used as an objective function of the model for FBA. There are two ways to run the analysis in the BioUML. Below is a step-by-step instruction for both ways.


Contents

[edit] FBA via Diagram

If the Type-diagram-icon.png diagram contains fluxes properties written as fbc extension of the SBML "FBC table" tab can be used. Advantage of this tab usage is lack of necessity in creation table with data about fluxes: it will be created automatically using Type-diagram-icon.png diagram. The step-by-step instruction of the analysis will be demonstrated on the iMK1321 model for Geobacillus icigianus developed by our research group and recently published. Note: opening of the large-size diagram may take a while due to the size and layouting of the diagram.


FBA viaDiagram Fig1 18 03.png

Figure 1. View of the iMK1321 model diagram in BioUML. Double-click of the left mouse button the diagram icon (marked red as 1) opens the diagram in the Work Space (marked red as 2).


Flux Balance tab in the Operations Field

To launch the analysis, move to the Flux Balance tab in the Operations Field (Figure 1, marked red at the bottom) and push the corresponding button in upper left corner of the tab (marked red as 3). It will lead to pop-up window where a specification of the analysis settings is required.

FBA viaDiagram Fig2 18 03.png

Figure 2. Solver type selection and specification of the optimization (maximize or minimize the objective function's value) in BioUML. One-click of the left mouse button Ok button runs the FBA.


Optimal solution in the tab

The outcome of the FBA will be automatically presented upon completion of the analysis in the Flux Balance tab.

FBA viaDiagram Fig3 18 03.png

Figure 3. Results of the FBA in corresponding tab for iMK1321 model. The flux distribution of the model is marked red at the bottom.


The flux distribution can be saved as a table via one-click of the left mouse button the save icon in upper left corner of the tab (Figure 3, marked red as 1). It will lead to pop-up window where a specification of the path and name of the table file are required.

FBA viaDiagram Fig4 18 03.png

Figure 4. Specification of the path and name of the table file with the output flux distribution of the model.


As a result, the table will be automatically opened in the Work Space. The table consists of two columns: reaction ID and optimal value of the reaction flux obtained by FBA.

FBA viaDiagram Fig5 18 03.png

Figure 5. Resulting FBA table usage for iMK1321 model.


[edit] FBA via Analysis tab

FBA can be also conducted via the Flux Balance Constraint (FBC) analysis in the BioUML. Firstly, move to Analysis tab in the Tree Area by a single click with the right mouse button on the corresponding tab.

FBC data table creation

To start the analysis via the tab it is required to create the table with flux balance constraint data. It can be created via Building Flux Balance Data Table analysis. It is worth noting that the Building Flux Balance Data Table analysis and "FBC table" tab work only with SBML L3v1 Type-diagram-icon.png diagrams with special fbc package. Thus, if the Type-diagram-icon.png diagram does not satisfy these conditions it should be transformed before using this analysis. For example, if the Type-diagram-icon.png diagram does not use fbc package but contains all necessary information about fluxes, it should be preprocessed by Recon transformer firstly.

FBA viaAnalysis Fig1 18 03.png

Figure 6. View of Building Flux Balance Data Table analysis. Double-click of the left mouse button the analysis icon (marked red) opens the analysis settings in the Work Space (marked red). It is necessary to specify a path to the diagram, output path for the table and values of lower and upper bounds in mmol*gDCW-1*h-1.


One click of the left mouse button on the Run will launch the analysis. The resulting Flux Balance Data Table for FBA will be automatically opened in the Work Space as an output of the analysis.

FBA viaAnalysis Fig2 18 03.png

Figure 7. Resulting Flux Balance Data Table for iMK1321 model. The objective function of the model is marked red.


FBC analysis usage

To start work with the Flux Balance Constraint analysis one needs a Type-diagram-icon.png diagram and a special table with data about its fluxes (names, bounds, objective function coefficients, etc.). To open the analysis settings in the Work Space double-click of the left mouse button the analysis icon (marked red).

FBA viaAnalysis Fig3 18 03.png

Figure 8. Flux Balance Constraint analysis in the BioUML.


Analysis enables to select path to the Type-diagram-icon.png diagram, to the data table and to the table with output results. It has also an expert mode where user can select type of the objective function, solver type (GLPK, Apache simplex solver and Gurobi solver are available) and some solver's properties.

FBA viaAnalysis Fig4 18 03.png

Figure 9. Solver type selection in the FBC analysis.


One click of the left mouse button on the Run will launch the analysis. The outcome of the FBA will be automatically opened in the Work Space as an output table of the analysis.

FBA viaAnalysis Fig5 18 03.png

Figure 10. Resulting "FBC table" tab usage for iMK1321 model. The objective function's value of the model is marked red.


[edit] FBA using Jupyter Notebook

Furthermore, the Jupyter Notebook core in BioUML has been extented on our web-server to run this type of models using well-known COBRAPy package and corresponding Jupyter Notebook has been created to run the iMK1321 metabolic model using GLPK (GNU Linear Programming Kit) solver as an example. To open the Notebook, double-click of the left mouse button the file name in the Tree Area (marked red below).

FBA viaJNotebook Fig1 18 03.png

Figure 11. User guide: FBA via COBRApy in BioUML for iMK1321 model.

Personal tools
Namespaces

Variants
Actions
BioUML platform
Community
Modelling
Analysis & Workflows
Collaborative research
Development
Virtual biology
Wiki
Toolbox