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]= |  |