From Optflux
Jump to: navigation, search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 2: Line 2:
  
 
=Example file=
 
=Example file=
 
You can download it here -> [[Media:IntegratedModelToy.zip|IntegratedModelToy.zip]]
 
 
 
[[Image:IntegratedModel.png‎]]
 
 
This tutorial uses this example based on an example from '''J. Kim and J. Reed'''.''OptORF: Optimal metabolic and regulatory perturbations for metabolic engineering of microbial strains''. BMC, 2010
 
 
 
*The regulatory model is composed by a transcription factor (TF1) that is activated when metabolite S is present, activates the expression of two genes (G3, G5) and represses the expression of gene G1A.
 
 
*The Gene Reactions rules said us that: R1 is catalyzed when the gene G1A and G1B are activated; R2 is catalyzed by the gene G2; R3 and R4 are catalyzed by the genes G3 and G4, respectively; finally, R5 can be catalyzed by either genes G5 or G6.
 
 
*In the metabolic level, the substrate (S) is utilized to produce biomass (B) and by-products P1 and P2. The cellular objective is to maximize biomass production (B) and the engineering objective is the production of P1. Reaction R2 converts the internal metabolite I1 into product P1 and 0.08 biomass (B), whereas reaction R5 converts the internal metabolite I2 into product P2 and 0.12 Biomass. The stoichiometric coefficients of all other reactions reflect a one-to-one relationship between molecule quantities.
 
 
  
 
=Brief tutorial=
 
=Brief tutorial=
This brief tutorial will help you to begin working with RegulatoryTool4OptFlux.
 
 
*To start, you will need load a model in OptFlux(see how to [[HowTos| here]]). In the '''New Project Wizard'''  you have to chose the the ''toy.fluxes'' file as the '''Fluxes File'''; the ''toy.matrix'' file as the '''Stoichiometric Matrix'''; the ''toy.metab'' file as the '''Metabolites File''' and the ''toy.gr'' file as the '''Load GPR Information'''.
 
 
[[Image:LoadToyMetModel.png‎]]
 
 
*On the wizard Step3, you have to chose '''indexing started at zero(0)'''
 
 
*You must pay attention to select a correct biomass flux ('''R_Biomass''').
 
  
 
==How to integrate a regulatory model==
 
==How to integrate a regulatory model==
To start using all features present in Regulatory plug-in, you have to integrate a regulatory model with a metabolic model previous loaded in OptFlux.
 
 
*After loaded the metabolic model in OptFlux, accessing the '''Load Regulatory Net''' option under the '''Plugins->Regulatory Tool''' menu
 
[[Image:PathForIntegratedModel.png]]
 
 
 
*The following dialog will be displayed.
 
[[Image:IntegrateRegulatoryModel.png‎]]
 
 
<b>1. <i>Select Project and Model</i></b><br>
 
You can select the model/project to integrate the regulatory model.<br>
 
<br>
 
<b>2. <i>File Options</i></b><br>
 
You can select the regulatory model file. In our example the regulatory model file name  is '''toy.regNet'''.
 
 
 
*After execution, the '''Metabolic Model''' datatype will replaced by '''Integrated Model''' in the clipboard.
 
[[Image:ClipBoardAfterIntegrateModel.png‎]]
 
  
 
==How to do a mutant simulation==
 
==How to do a mutant simulation==
*You can access the '''Simulation''' option under the '''Plugins->Regulatory Tool''' menu or right clicking on the Integrated Model icon on the clipboard.
 
[[Image:PathForSimAndOpt.png]]<br>
 
<br>
 
*In the Integrated Simulation you can select the model/project to work, and set up your configuration.<br>
 
[[Image:IntegratedSimulationOperaion.png]]
 
<br>
 
<b>1. <i>Gene Options</i></b><br>
 
Selecting in the Gene list you can add/remove (using the arrows buttons) genes to the knockout list (the list of genes to be knocked out, in the right). <br>
 
<br>
 
<b>2. <i>Select Environmental Conditions</i></b><br>
 
If you have created [[Environmental conditions|environmental conditions]] you can select them to be used as constraints in the simulation. These can be used to define the values of drain fluxes, i.e. the rates at which metabolites are consumed or produced.<br>
 
<br>
 
<b>3. <i>Objective Function Definition </i></b><br>
 
Here you can select the reaction to optimize (biomass, by default), and you can also define if you will be maximizing or minimizing that flux.<br>
 
<br>
 
<b>4. <i>Set Regulatory Variables</i></b><br>
 
Here you can define the value of all regulatory user variables, and see the values of the model variables.<br>
 
<br>
 
<b>5. <i>Select Simulation Method</i></b><br>
 
OptFlux can use several simulation methods for knockout simulations, namely:<br>
 
BRN+FBA, BRN+ROOM, BRN+MOMA and SR-FBA<br>
 
<br>
 
*And that's all!! You can press OK and the results will be loaded into the clipboard.<br>
 
 
[[Image:ClipboarIntegratedSi_mulation.png]]
 
  
 
==Critical Genes==
 
==Critical Genes==
 
The regulatory plug-in allows the users to define which are the genes present on the integrated model that are essential for the strain to survive, i.e. to keep a value of growth (biomass reaction flux) different from zero. The essential genes can be calculated using BRN+FBA method. Also, the software allows the user to load these genes or reactions from a file (if they are available). The list of essential genes can be manually edited, allowing users to add or remove elements, given their knowledge or the purpose of their experiments.
 
  
 
===How to do load critical genes from a file===
 
===How to do load critical genes from a file===
 
*To load the information from a file just access the '''Load Critical Regulatory Genes''' option under the '''Plugins->Regulatory Tool->Critical Information''' menu in the Project Menu or right click on the Integrated Model icon in the clipboard.
 
 
 
[[Image:PathForCriticalGenes.png]]
 
*The following dialog will be displayed.
 
[[Image:LoadCriticalRegulatoryGenesOperation.png‎]]<br>
 
<b>1. <i>Select Project and Model</i></b><br>
 
You can select the model/project to integrate the regulatory model.<br>
 
<br>
 
<b>2. <i>File Options</i></b><br>
 
You can select the file that have the critical genes information.<br>
 
<br>
 
*Now press OK and you can see a new element on the clipboard with the loaded critical genes.
 
[[Image:ClipboardAfterCriticalGenes.png‎]]
 
  
 
===How to determining essential genes===
 
===How to determining essential genes===
*You can access the '''Compute Critical Regulatory Genes''' option under the '''Plugins->Regulatory Tool->Critical Information''' menu or by right clicking on the Integrated Model icon on the clipboard.
 
[[Image:PathForCriticalGenes.png]]<br>
 
<br>
 
*In the options you can select the model/project to work, and set up the process.
 
[[Image:ComputeCriticalGenesOperation.png‎]]
 
 
<b>1. <i>Set Regulatory User Variables</i></b><br>
 
Here you can define the value of all regulatory user variables, and see the values of the model variables.<br>
 
<br>
 
<b>2. <i>Select Environmental Conditions</i></b><br>
 
If you have created environmental conditions you can select them to be used as constraints in the critical genes/reactions calculation. This means that in this case you will calculate essential genes in a given environment.<br>
 
<br>
 
 
*And that's all !! Now you can press OK and check the results in the clipboard.
 
[[Image:ClipboardAfterCriticalGenes.png‎]]
 
  
 
==How to optimise the gene knockouts set==
 
==How to optimise the gene knockouts set==
*You can access the '''Optimization''' option under the '''Plugins->Regulatory Tool''' menu.<br>
 
[[Image:PathForSimAndOpt.png]]<br>
 
<br>
 
*The following dialog will be displayed.<br>
 
[[Image:IntegrateOptimizationOperation.png]]
 
<br>
 
<b>1. <i>Select Project and Model</i></b><br>
 
In the Project combo box select the project where you want to perform the
 
optimization, in the Model combo box select the model in the project
 
that you want to use.<br>
 
<br>
 
<b>2. <i>Select Simulation Method</i></b><br>
 
OptFlux can use several simulation methods for knockout simulations, namely:<br>
 
BRN+FBA, BRN+ROOM, BRN+MOMA and SR-FBA <br>
 
<br>
 
<b>3. <i>Select Environmental Conditions</i></b><br>
 
If you have created [[Environmental conditions|environmental conditions]] you can select them to be used as constraints in the simulation.<br>
 
<br>
 
<b>4. <i>Select Objective Function</i></b><br>
 
OptFlux can use two types of objective function:<br>
 
<b>BPCY - Biomass-Product Coupled Yield</b>; <b>YIELD - Product Yield with Minimum Biomass</b>.
 
<br>
 
The first calculates the product of the biomass flux and the compound production flux; the second, returns the value of the target compound production flux divided by the substrate consumption flux, if the biomass is larger than a minimum value, defined by the user<br>
 
<br>
 
<b>5. <i>Objective Function Configuration</i></b><br>
 
Here you can set the configuration of the selected objective function.
 
In both BPCY and YIELD objective functions you can select the flux to be optimize (the compound you wish to produce) and the flux that represents the biomass.
 
On BPCY you can also select the substrate flux that is in use. On YIELD you have to set the percentage of the wild-type minimum value.<br>
 
<br>
 
<b>6. <i>Select Optimization Algorithm</i></b><br>
 
OptFlux allows you to perform optimizations using one of the following algorithms:<br>
 
Cellular Genetic Algorithm, Evolutionary Algorithm, Simulated Annealing<br>
 
<br>
 
<b>7. <i>Optimization Basic Setup</i></b><br>
 
Here you can configure the maximum number of solution evaluations (simulations) and check the expected time to perform that number of evaluations.<br>
 
You can also set up the maximum number of knockouts and if the set of knockouts should be static or have a variable size.<br>
 
<br>
 
<b>8. <i>Essential information</i></b><br>
 
If you loaded/created some essential genes you can define if it is
 
possible to knockout some critical genes.<br>
 
<br>
 
<b>9. <i>Set Regulatory Variables</i></b><br>
 
Here you can define the value of all regulatory user variables, and see the values of the model variables.<br>
 
<br>
 
 
[[Image:ClipboardAfterIntegrateOptimization.png‎]]
 

Please note that all contributions to Optflux may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see Optflux:Copyrights for details). Do not submit copyrighted work without permission!

Cancel | Editing help (opens in new window)