Previous Page Previous Page Next Page TOC
Multistate Model Builder

Multistate Model Builder


Writing a model is a creative effort that calls for more flexibility than can be tolerated by today's SBML editors.
MSMB (the Multistate Model Builder) is a software tool that aims to help users write biological models as chemical reaction systems.

MSMB merges a compact spreadsheet interface front-end with a COPASI data model back-end.

The compact spreadsheet interface allows the user to edit different parts of the model (Reactions, Species, Parameters, etc.) in an easy and intuitive way. The COPASI back-end allows the user to easily export to standard formats (like SBML and COPASI) for further simulation and analysis of the model.

MSMB offers many innovative features:

Editor support includes:
  • Customizable auto-completion support.
  • Customizable behavior of the tool when making changes to the model. For example, the user has complete control on the effect of deletion/renaming of elements in the model. The user can change the appearance of the tool (font size, color of the different error message, etc), the amount of warnings/pop-up and the default values of several elements. All the customization can be achieved using the "Preferences" menu of MSMB.
  • Import/export to SBML and COPASI format (of valid models).
  • Transient inconsistent models can be saved in MSMB format, together with the set of errors that they contain.
  • Meaningful error messages that guide the modeler toward creating valid models. This is done without forcing them to follow a specific path in defining the elements of the model. For example, the user can define an expression using a variable that is not yet defined.
  • Beginner users can be supported by wizard-like popup windows to help those unfamiliar with the tool and modeling syntax to build models.
  • Advanced users already familiar with the syntax can use more free-form typing into spreadsheet cells to quickly input their model data.
  • Context assistance available to support typing of complex mathematical expressions involving elements of the model.
  • Print to PDF for all spreadsheets, for an easy way of sharing/debugging the model

Multistate model syntax features:
  • A multistate species is a protein with a defined set of sites, each associated with an ordered list of states, which collectively describe a group of different forms of the same conceptual species. While modelers might naturally think of their models in terms of multistate species, this representation is not well supported by existing reaction model editors.
  • MSMB defines a compact syntax to describe multisate species. For example, Cdh1(p{0:10} is the representation of a species (called Cdh1), with a single site (called p), which has the following 11 ordered numerical states 0,1,2,3,4,5,6,7,8,9,10.
  • MSMB defines operators on sites (i.e. successor and predecessor) that can be used to compactly describe a set of reactions with a single reaction (e.g. Cdh1(p{0:9}) + ClbM -> Cdh1(succ(p)) + ClbM is a single reaction that represent the fact that ClbM is phosphorylating Cdh1 at each of Cdh1's possible phosphorylation states. This reaction has to be expanded into 10 independent, but essentially identical, reactions in formats that do not handle multistate species like SBML and COPASI.
  • MSMB defines operators that collect different states of a multistate species. For example, SUM(Cdh1) represents the total amount of Cdh1 in all its forms, SUM(Cdh1,p{2:6}) represents the total amount of Cdh1 protein in the states 2,3,4,5,6.
  • Future export to the sbml-multi package. The sbml-multi package is a package of SBML level 3 whose purpose is to define "object structures for representing entity pools with multiple states and composed of multiple components, and reaction rules involving them". The package is still in the proposal stage.

For more details about the multistate format (e.g. definition of site's state as strings, mathematical operations on state values, definition of complexes, reactions that transfer the state of a multistate species to another multistate species, parametric definition of sites' states, etc.), see the User Manual (table of content below), or the pdf version available in the MSMB installation package.

Here are examples that show the reduction in model size due to the use of our multistate syntax.

Cell cycle model:
D. Barik, W.T. Baumann, M.R. Paul, B. Novak, and J.J. Tyson.
A model of yeast cell-cycle regulation based on multisite phosphorylation.
Molecular Systems Biology, 6(1), 2010

  • Species: original version = 72, MSMB version = 23
  • Reactions: original version = 220, MSMB version = 73

mRNA translation:
H. Firczuk, S. Kannambath, J. Pahle, A. Claydon, R. Beynon, J. Duncan, H. Westerhoff, P. Mendes and J.E. McCarthy.
An in vivo control map for the eukaryotic mRNA translation machinery.
Molecular Systems Biology, 9(1), 2013

  • Species: original version = 166, MSMB version = 56
  • Reactions: original version = 200, MSMB version = 58


MSMB Publications:

  • (Journal paper) Palmisano, A., Hoops, S., Watson, L. T., Jones, T. C., Tyson, J. J., & Shaffer, C. A. (2014). Multistate Model Builder (MSMB): a flexible editor for compact biochemical models. BMC systems biology, 8(1), 42.
  • (poster) International Conference on Computational Cell Biology (ICCCB), August 2013, Blacksburg, Virginia, USA
  • (poster) International Conference on Systems Biology (ICSB 2012), August 2012, Toronto, Canada

MSMB Documentation:

This documentation applies to MSMB - version 1.0 - released on December 2013.
A pdf version of this documentation is available in the MSMB installation package.

Table of Contents: