Find engineering targets#
Flux scanning with enforced objective function (FSEOF) finds the reactions whose flux changes with the production of a compound. ecFSEOF returns reaction and gene targets for the production of a compound by an ecModel, each with a suggested action: over-express, knock down or knock out.
Place in the workflow
The diagram orders the functions of this page within the workflow. Boxes with a dashed outline are optional steps, a dotted arrow is an optional path, and a diamond is a choice. Rounded boxes with a dotted outline are the context, other pages or the model to start from, and a click on one opens its page.
---
config:
flowchart:
useMaxWidth: false
---
flowchart TB
classDef opt stroke-dasharray: 5 4
classDef ctx fill:transparent,stroke-dasharray: 2 3
PV(["Start: a functional or relaxed ecModel"]):::ctx
TS["production reaction<br/>and carbon source uptake"]
FS["ecFSEOF"]
PV --> TS --> FS
click PV href "first-ecmodel.html"
---
config:
flowchart:
useMaxWidth: false
---
flowchart TB
classDef opt stroke-dasharray: 5 4
classDef ctx fill:transparent,stroke-dasharray: 2 3
PV(["Start: a functional or relaxed ecModel"]):::ctx
TS["production reaction<br/>and carbon source uptake"]
FS["ec_fseof"]
PV --> TS --> FS
click PV href "first-ecmodel.html"
Functions#
Setup#
The examples use the ecModel and the model adapter parameters params, loaded as in the setup of Analyse an ecModel. The biomass reaction is read from the model adapter. Set the bounds of the condition, such as the medium and the uptake rate of the carbon source, before the scan (Basic model operations).
The other names in the examples are placeholders for values of the project:
MATLAB |
Python |
Value |
|---|---|---|
|
|
identifier of the production reaction, for example the exchange reaction of the product |
|
|
identifier of the uptake reaction of the carbon source |
Target selection#
ecFSEOF first finds the production at maximum growth and the maximum production. It then fixes the production reaction at nSteps (Python: n_steps, default 16) evenly spaced values from the first to 90 % of the second. At each value it maximises growth and then minimises the total flux. A reaction is a target when the absolute Pearson correlation between its absolute flux and the enforced production is at least corrThreshold (Python: correlation_threshold, default 0.9). The scan covers the reactions with a gene rule, except those that use the standard enzyme (Choose the kcat sources). The usage_prot_* reactions take part in the scan and are left out of the result.
Each target reaction gets an action from the slope of its absolute flux:
Slope |
Absolute flux at the last step |
Action |
|---|---|---|
positive |
any |
|
negative |
at most 1e-8 |
|
negative |
above 1e-8 |
|
A gene gets one action from its target reactions. When these reactions have one action, the gene keeps it, also when the gene is essential. When they have different actions, the gene gets OE if one of them is OE, otherwise KO if the gene is not essential, otherwise KD. A gene is essential when growth is infeasible or below 1e-8 with the usage reactions of its enzymes fixed at 0 and the production fixed at the last value of the scan.
When the production at maximum growth is equal to 90 % of the maximum production, there is no range to scan, and the function raises an error.
Run the scan#
fseof = ecFSEOF(ecModel, prodTargetRxn, csRxn, 'nSteps', 16, 'outputFile', true);
fseof.geneTargets
rxnTargets and transportTargets list the target reactions with identifier, name, slope, gene rule and equation, ordered by the product of slope and correlation; they have no action column. geneTargets has one row per gene of the target reactions: gene, short name, mean slope, action and essentiality. With outputFile set to true, the function writes ecFSEOF_genes.tsv, ecFSEOF_rxns.tsv and ecFSEOF_transporter.tsv to the output folder of the project. The function warns when the lower bound of csRxn is below the uptake at maximum growth, that is, when the uptake does not reach its bound.
from geckopy import ec_fseof
result = ec_fseof(ec_model, prod_target_rxn, cs_rxn, n_steps=16)
result.targets
result.gene_targets
result.targets is one DataFrame with the reaction targets first and the transport targets after them (column transport), each group ordered by score, the product of the absolute slope and the absolute correlation. The column target_type holds the action of each reaction. result.gene_targets has one row per gene of the target reactions, with the columns gene, name, slope (mean absolute slope), action, essentiality and reactions, ordered by slope. result.scan holds the fluxes at each step. ec_fseof writes no files; result.targets.to_csv(...) writes the table. The biomass reaction is read from ec_model.adapter, or from the argument bio_rxn. When cs_rxn is given, the function logs a warning when the lower bound of cs_rxn is below the uptake at maximum growth.
Troubleshooting#
Problem |
Possible reason |
Solution |
|---|---|---|
no reaction reaches |
Lower the threshold, or check the bounds of the production and carbon source reactions |
|
|
the production at maximum growth is equal to 90 % of the maximum production |
Check the bounds of the production reaction and of the carbon source reaction |
Warning about the lower bound of the carbon source |
the uptake at maximum growth does not reach the lower bound of the carbon source reaction |
Set the lower bound to the uptake rate of the condition |
See also#
Analyse an ecModel: the other analyses of an ecModel and the shared setup.
Enzyme usage and bottlenecks: the enzymes that a flux distribution uses and the enzymes that limit the objective.
API reference and MATLAB vs Python: the signature of each function in the table.