Types
The MASS Toolbox relies heavily on data types and custom notation to facilitate the process of model construction, manipulation, and analysis.
Out[2]= | |
Out[2]= | |
It is very important to make clear that although metabolites (and many of the following data types) are displayed in a human readable format (e.g
atpc), the internal representation is conserved,
Out[3]//FullForm= |
| |
and is in this respect very similar to other
Mathematica definitions, e.g.,
Out[4]//FullForm= |
| |
It is possible to use "Evaluation-> Evaluate in place" in the menu (or Cmd + Shift + Enter or the mouse context menu) for inplace replacements (select the next line and try it)
Select the following code and hit Cmd + Shift + Enter (metabolite["atp","cytosol"] should be converted to
atpcytosol)
Out[6]= | |
Out[8]= | |
Species
In order to define a model of biochemical process one has to define the participating species. The Toolbox provides a series of species type definitions.
species["id"] | a species |
species["id", "compartment"] | a species in a particular compartment |
species["id", _] | a species in any compartment |
metabolite["id", "compartment"] | a small compound in a particular compartment |
m["id", "compartment"] | shorthand for metabolite["id", "compartment"] |
enzyme["ID"→"id", "Compartment"→"compartment",opts] | a enzyme in a particular compartment |
Toolbox species types
This defines adenosine triphosphate (ATP) in the cytosol
Out[35]= | |
This defines adenosine triphosphate (ATP) using a slightly shorter notation
Out[36]= | |
However, the full type expression (metabolite) is used internally
Out[37]//FullForm= |
| |
Reactions
Chemical reactions are defined in the following way:
reaction["id", substrates, products, stoichiometry] | a reversible reaction |
reaction["id", substrates, products, stoichiometry, False] | an irreversible reaction |
r[args] | a shorthand for reaction |
Toolbox reactions
Out[38]= | |
Define an irreversible reaction
Out[38]= | |
Query data types
Toolbox typical accessor function
Query the ID and compartment of a metabolite
Out[45]= | |
Out[46]= | |
Query the ID and compartment of an reaction
Out[42]= | |
Out[43]= | |
Textual input
str2mass["ID"] | a metabolite (ID) |
str2mass["ID[Comp]"] | a metabolite in a particular compartment (IDComp) |
str2mass["ID: 2 x <=> y + z"] | a reversible reaction () |
str2mass["ID: 2 x[c] --> y[c] + z[c]"] | an irreversible reaction () |
str2mass["Keq_ID"] | an equilibrium constant for reaction ID () |
str2mass["k_ID_fwd"] | forward rate constant |
str2mass["k_ID_rev"] | reverse rate constant |
Use textual input to declare species, parameters, reactions etc.
Out[54]= | |
Out[55]//FullForm= |
| |
Parse a metabolite with a specific compartment
Out[56]= | |
Out[57]//FullForm= |
| |
Facilitate
str2mass to quickly define a model
Out[90]= | |
Out[91]= | |