Getting started

The MuMoT user manual (a Jupyter Notebook) provides the most accessible introduction to working with MuMoT.

MuMoT (Multiscale Modelling Tool) is a tool designed to allow sophisticated mathematical modelling and analysis, without writing equations - the class of models that can be represented is broad, ranging from chemical reaction kinetics to demography and collective behaviour - by using a web-based interactive interface with minimal coding, rapid development and exploration of models is facilitated - the tool may also be particularly useful for pedagogical demonstrations


View and interact with the user manual online:

Start running MuMoT user manual on

Note that this uses the excellent and free service, funded by the Gordon and Betty Moore Foundation, which may not always be available at times of very high demand.

Also, note that the sessions may sometimes take several minutes to start: will use a cached MuMoT environment if one is available but this may not always be the case (e.g. immediately after an update to the MuMoT package).

Demo notebooks

The following demo notebooks are also available online:

  • Paper: (MuMoT authors, University of Sheffield)
  • Epidemics: (Renato Pagliara, Princeton University)
  • Agent density: (Yara Khaluf, Ghent University, and MuMoT authors, University of Sheffield)
  • COVID-19: (James A. R. Marshall, University of Sheffield)
  • Variance suppression: (Andreagiovanni Reina, University of Sheffield)
  • Michaelis-Menten: (Aldo Segura, University of Sheffield)

On your own machine

  1. Follow the install and post-install instructions. If you have already created your MuMoT conda environment or virtualenv you only need to activate it.

  2. Start a Jupyter Notebook server, unless you have done so already:

    jupyter notebook
  3. Within the Jupyter file browser, browse to a clone of this Git repository, find the docs subdirectory then open docs/MuMoTuserManual.ipynb, which is the MuMoT User Manual. To view demo notebooks navigate to DemoNotebooks.