Guide#

The guide shows how to build an enzyme-constrained model (ecModel) from a conventional genome-scale metabolic model (GEM) with GECKO (MATLAB) or geckopy (Python), and how to analyse it. Build an ecModel makes a working ecModel with the default settings. Each step of that page links to a decision page, which describes the options of the step, what each option needs and what it changes in the model. The background pages describe the file formats and the parameters.

GECKO 4 pre-release

GECKO 4 is a pre-release, and the guide describes GECKO 4. For GECKO 3 users, GECKO 3 to GECKO 4 lists the changes.

MATLAB and Python

Task pages show both languages in tabs: GECKO (MATLAB), built on RAVEN, and geckopy (Python), built on cobrapy. Function names differ in case (camelCase and snake_case), and some differ in the word as well; MATLAB vs Python lists the name of each function in both languages, and the API reference lists the signatures.

Text outside a MATLAB or Python tab reads the same in both languages. Where it refers to the enzyme data of a model, ec.kcat stands for ecModel.ec.kcat in MATLAB and ec_model.ec.kcat in Python. The field names are identical in both languages except rxnEnzMat (Python: rxn_enz_mat) and ec.geckoLight (Python: gecko_light).

Start#

Quick path#

  • Build an ecModel: create a project, make the ecModel, assign kcats, set the protein pool, check the growth rate and save the model, with the default settings.

Workflow#

Flowchart of the guide pages: project, ecModel structure, kcat sources, protein pool, kcat tuning, proteomics, relaxation and analysis

The workflow overview shows the order of the pages below, the steps of the quick path, the alternative paths and the functions of each page, in MATLAB and Python.

Decisions#

The decision pages are in the order of the work.

Page

Choice

Choose the ecModel structure

full or light ecModel, matching of genes to UniProt and KEGG, enzyme complexes

Choose the kcat sources

the kcat assignment preset, and the treatment of isozymes and of reactions without a kcat

Set custom kcats

curated kcats that take precedence over the kcat sources

Set the protein pool

the values of the total protein content, the enzyme fraction \(f\) and the saturation factor \(\sigma\)

Choose a kcat tuning

standard or advanced kcat tuning, when the ecModel grows too slowly

Tune kcats against experimental data

the data and the settings of the advanced kcat tuning

Constrain enzymes with proteomics

the integration of measured enzyme concentrations

Relax proteomics constraints

the method that loosens proteomics constraints that prevent growth

Analyse an ecModel

objectives, flux variability, sampling and the mapping of fluxes to the conventional GEM

Find engineering targets

the reactions and genes to change for the production of a compound

Make a context-specific ecModel

an ecModel of a tissue, cell line or strain, trimmed from a generic ecModel

Enzyme usage and bottlenecks

which enzymes a solution uses and which enzymes limit the objective

Background#

Migration#

See also#

  • API reference: the generated documentation of the functions of both toolboxes.

  • MATLAB vs Python: the names of the functions in GECKO and geckopy.