A Pycellerator Tutorial

  • Bruce E. ShapiroEmail author
  • Eric Mjolsness
Part of the Methods in Molecular Biology book series (MIMB, volume 1945)


We present a tutorial on using Pycellerator for biomolecular simulations. Models are described in human readable (and editable) text files (UTF8 or ASCII) containing collections of reactions, assignments, initial conditions, function definitions, and rate constants. These models are then converted into a Python program that can optionally solve the system, e.g., as a system of differential equations using ODEINT, or be run by another program. The input language implements an extended version of the Cellerator arrow notation, including mass action, Hill functions, S-Systems, MWC, and reactions with user-defined kinetic laws. Simple flux balance analysis is also implemented. We will demonstrate the implementation and analysis of progressively more complex models, starting from simple mass action through indexed cascades. Pycellerator can be used as a library that is integrated into other programs, run as a command line program, or in iPython notebooks. It is implemented in Python 2.7 and available under an open source GPL license.

Key words

Cellerator SBML Systems biology Python 


  1. 1.
    Shapiro BE, Mjolsess E (2016) Pycellerator: an arrow-based reaction-like modelling language for biological simulations. Bioinformatics 32(4):629–631. CrossRefGoogle Scholar
  2. 2.
    Shapiro BE, Levchenko A, Meyerowitz EM, Wold BJ, Mjolsness ED (2003) Cellerator: extending a computer algebra system to include biochemical arrows for signal transduction simulations. Bioinformatics 19:677–678. CrossRefGoogle Scholar
  3. 3.
    Hucka M, Finney A, Sauro HM et al (2003) The systems biology markup language (SBML): a medium for representation and exchange of biochemical network models. Bioinformatics 19:513–523. CrossRefGoogle Scholar
  4. 4.
    Jones E, Oliphant E, Peterson P et al (2001) SciPy: open source scientific tools for Python. Accessed 1 Aug 2016
  5. 5.
    van der Walt S, Colbert SC, Varoquaux G (2011) The NumPy array: a structure for efficient numerical computation. Comput Sci Eng 13:22–30. CrossRefGoogle Scholar
  6. 6.
    Waage P, Guldherg CM (1864) Studies in affinity [in Swedish, as Forhandlinger i Videnskabs Selskabet i Christiania, 37], (translated by H.I. Abrash, reprinted in Journal of Chemical Education, 63(12):1044–1047 (1966)Google Scholar
  7. 7.
    Field RJ, Noyes RM (1974) Oscillations in chemical systems. IV. Limit cycle behavior in a model of a real chemical reaction. J Chem Phys 60:1877–1884. Google Scholar
  8. 8.
    Henri V (1903) Lois Générales de l’action des Distases. Hermann, ParisGoogle Scholar
  9. 9.
    Michaelis L, Menten ML (1913) Die Kinetik der Invertinwirkung. Biochem Z 49:333–369Google Scholar
  10. 10.
    Briggs GE, Haldane JBS (1925) A note on the kinetics of enzyme action. Biochem J 19(2):338–339. CrossRefGoogle Scholar
  11. 11.
    Hill AV (1910) The possible effects of the aggregation of the molecules of haemoglobin on its dissociation curve. Proc Physiol Soc 40(Suppl):4–7. Google Scholar
  12. 12.
    Mjolsness E, Sharp DH, Reinitz J (1991) A connectionist model of development. J Theor Biol 152:429–453.
  13. 13.
    Murphy KP (2012) Machine learning, a probabilistic perspective. MIT Press, CambridgeGoogle Scholar
  14. 14.
    Monod J, Wyman J, Changeux JP (1965) On the nature of allosteric transitions: a plausible model. J Mol Biol 12:88–118.
  15. 15.
    Najdi T, Yang C-R, Shapiro BE, Hatfield W, Mjolsness E (2006) Application of a generalized MWC model for the mathematical simulation of metabolic pathways regulated by allosteric enzymes. J Bioinform Comput Biol 4(2):335–355. CrossRefGoogle Scholar
  16. 16.
    Mjolsness E (2000) Trainable gene regulation networks with applications to Drosophila pattern formation. In: Bower JM, Bolouri H (eds) Computational models of genetic and biochemical networks. MIT Press, CambridgeGoogle Scholar
  17. 17.
    Shapiro BE, Mjolsness ED (2001) Developmental simulations with Cellerator. Paper presented at Second International Conference on Systems Biology, Pasadena, 4–7 Nov 2001Google Scholar
  18. 18.
    Huang CY, Ferrell JE Jr (1996) Ultrasensitivity in the mitogen-activated protein kinase cascade. Proc Natl Acad Sci USA 93(19):10078–10083CrossRefGoogle Scholar
  19. 19.
    Kholodenko BN (2000) Negative feedback and ultrasensitivity can bring about oscillations in the mitogen-activated protein kinase cascades. Eur J Biochem 267(6):1583–1588 CrossRefGoogle Scholar
  20. 20.
    Mitchell S, O’Sulivan M, Dunning I (2011) PuLP: a linear programming toolkit for Python. Accessed 31 July 2016
  21. 21.
    Goldbeter A (1991) A minimal cascade model for the mitotic oscillator involving cyclin and cdc2 kinase. Proc Natl Acad Sci USA 88:9107–1101. CrossRefGoogle Scholar
  22. 22.
    Kermack WO, McKendrick AG (1927) A contribution to the mathematical theory of epidemics. Proc R Soc A 115(772):700–721. CrossRefGoogle Scholar

Copyright information

© Springer Science+Business Media, LLC, part of Springer Nature 2019

Authors and Affiliations

  1. 1.Department of MathematicsCalifornia State UniversityNorthridgeUSA
  2. 2.Departments of Computer Science and MathematicsUniversity of CaliforniaIrvineUSA

Personalised recommendations