Enzyme usage#
MATLAB functions in GECKO/src/enzyme_usage of the GECKO toolbox.
Functions#
Function |
Summary |
|---|---|
Top-N enzymes limiting the current objective. |
|
Compute enzyme usages from a provided flux distribution. |
|
Summarize the results from getEnzymeUsage. |
Reference#
getEnzymeBottlenecks#
function bottlenecks = getEnzymeBottlenecks(model, varargin)
Top-N enzymes limiting the current objective.
Solves the model and ranks every enzyme by the change of the objective
after the upper bound of its usage_prot_
The shadow price of the prot_
Parameters
model: structa full ecModel (with ecModel.ec structure). Not supported for gecko-light models, which have no per-enzyme prot_
/ usage_prot_ machinery.
Name-Value Arguments
top: doublenumber of enzymes to return (default 10).
foldChange: doublea value how much to increase the usage upper bound of an enzyme that runs at its upper bound; must be greater than 1 (default 2).
Returns
bottlenecks: tableone row per returned enzyme, sorted by descending objectiveGain, with columns uniprot, gene, objectiveGain (objective after raising the bound minus the objective of the unchanged model; 0 for enzymes not at their upper bound, for gains below 1e-10 and for solves that are not optimal), shadowPrice, flux, capUsage (abs(flux)/upperBound, NaN if upperBound is 0), upperBound and multipleActive. An enzyme is at its upper bound when upperBound is above 0 and capUsage is at least 1 - 1e-6. multipleActive is true when at least one other constraint is active: another enzyme at its upper bound, or prot_pool_exchange at its upper bound (within 1e-6 relative). Where it is true, the dual is not informative about a single enzyme. The table property UserData.nResolved holds the number of enzymes that were solved again and UserData.activeConstraints the number of active constraints. When no enzyme is at its usage bound a warning (getEnzymeBottlenecks:noEnzymeAtBound) says that no single enzyme limits the objective; every objectiveGain is then 0 and the rows are in model order.
Examples
bottlenecks = getEnzymeBottlenecks(ecModel);
bottlenecks = getEnzymeBottlenecks(ecModel, 'top', 5, 'foldChange', 3);
getEnzymeUsage#
function usageData = getEnzymeUsage(ecModel,fluxes,varargin)
Compute enzyme usages from a provided flux distribution.
Gives enzyme usages based on a provided flux distribution, as obtained from a full GECKO model. It can give:
absolute usage: the specific enzyme usage in mg/gDCW, which can be given for enzymes with- and without concentration information;
capacity usage: the ratio of available enzyme that is used, calculated by (absUsage/UB). An enzyme without a measured concentration has the default upper bound of 1000, so its capacity usage is absUsage/1000. An upper bound of 0 gives NaN when absUsage is 0 and Inf otherwise;
UB: the upper bound of each enzyme exchange reaction, which may not be the same as the enzyme concentration, if it has been flexibilized;
protID: the protein identifiers for each enzyme, in the same order as ecModel.ec.enzymes.
Parameters
ecModel: structan ecModel (with ecModel.ec structure).
fluxes: doublevector of fluxes, for instance sol.x.
Name-Value Arguments
zero: logicalwhether also enzymes with zero absolute usage should be included (default true).
Returns
usageData: structstructure with enzyme usage data.
Notes
The usageData structure has the following fields:
capUsage : vector of enzyme capacity usages.
absUsage : vector of absolute enzyme usages.
UB : vector of enzyme exchange reaction upper bounds.
protID : string array of matching protein IDs. An enzyme without a usage_prot_
reaction in the model is left out, with the warning getEnzymeUsage:missingUsageReaction. fluxes : vector of fluxes, copy of input fluxes.
measuredProtein : sum of the measured concentrations in model.ec.concs (mg/gDCW), over the enzymes with a non-NaN entry.
demandedProtein : sum of absUsage over the same enzymes (mg/gDCW).
demandRatio : demandedProtein / measuredProtein. NaN when no concentration is measured; Inf when the measured concentrations sum to 0 and the demand is positive. A ratio above 1 means that the solution uses more of the measured enzymes than was measured, which happens when the upper bounds of the usage reactions are above the measurements (for instance after flexibilizeEnzConcs). A ratio at or below 1 does not exclude that one enzyme exceeds its measurement, since the sum is over all measured enzymes; capUsage gives the ratio per enzyme. Enzymes without a measured concentration draw from the protein pool and are not counted.
measuredProteinActive, demandRatioActive : the same two values restricted to the enzymes with an absUsage above 1e-7 mg/gDCW. Measured enzymes that are inactive in the solution raise measuredProtein and can hide a conflict among the active ones. The five fields are computed over all enzymes with a usage reaction, whatever the value of zero.
Examples
% optional arguments may be given positionally or as name-value pairs:
usageData = getEnzymeUsage(ecModel,fluxes,zero);
usageData = getEnzymeUsage(ecModel,fluxes,'zero',false);
See also
reportEnzymeUsage
reportEnzymeUsage#
function usageReport = reportEnzymeUsage(ecModel, usageData, varargin)
Summarize the results from getEnzymeUsage.
Ranks the enzymes from getEnzymeUsage into two tables: those with the highest capacity usage, and those with the highest absolute usage.
Parameters
ecModel: structan ecModel (with ecModel.ec structure).
usageData: structoutput from getEnzymeUsage.
Name-Value Arguments
highCapUsage: doublefraction of enzyme capacity usage above which an enzyme is listed as high usage (default 0.9, i.e. more than 90% capacity usage).
topAbsUsage: doublehow many top enzymes by absolute usage to list (default 10). Use 0 or Inf to list all enzymes instead. Enzymes whose reactions carry no flux are never listed here, as they do not contribute to the solution. A negative value raises reportEnzymeUsage:invalidTopAbsUsage.
Returns
usageReport: structhighCapUsage : table enzymes above the highCapUsage threshold. topAbsUsage : table the topAbsUsage enzymes with the highest absolute usage. totalUsageFlux : double total protein pool used, i.e. the upper bound of prot_pool_exchange. demandRatio : double demandRatio of usageData: the protein used of the enzymes with a measured concentration divided by their measured concentrations. Above 1, the solution needs more of those enzymes than was measured. NaN when usageData has no demandRatio field. demandRatioActive : double demandRatioActive of usageData: the same ratio over the enzymes that carry flux in the solution.
Examples
% optional arguments may be given positionally or as name-value pairs:
usageReport = reportEnzymeUsage(ecModel, usageData, highCapUsage, topAbsUsage);
usageReport = reportEnzymeUsage(ecModel, usageData, 'topAbsUsage', 20);
See also
getEnzymeUsage