Skip to main content

Stochastic Simulations

Project description

What is this?

StoSim is a light-weight framework for parameterised stochastic simulations. The researcher provides the simulation code (written in the programming language of his/her choice), but StoSim takes over a lot of tedious work from there on. StoSim can

  • create all necessary computation jobs (from lists of parameter settings)

  • execute these jobs on available CPUs (only your computer, the local network or PBS computation cluster)

  • handle stochastic repetition of settings and seeding of randomness (for repeatable experiments)

  • analyse the results with graphical plots and T-tests (it is easy to analyse results made with specific parameter settings)

  • back up code and results (to be able to go back to important milestones)

You can find extensive documentation at and example simulations in the “example” folder.


the short answer:

pip install stosim

More details and help are in the documentation.


  • You need Python 3.3+, 2.7, or 2.6 if you install the argparse module locally.

  • Distributing jobs needs Unix Screens, so if the screen command is not available on your system, you need to install it, e.g. on Debian::

    sudo apt-get install screen

  • To use the in-built plotting, you need gnuplot and epstopdf, e.g. on Debian::

    sudo apt-get install gnuplot texlive-extra-utils

  • For T-Tests, you need Gnu R installed.

More details and help are in the documentation.

Running a simulation: A quick overview

Place an experiment configuration (stosim.conf) and your simulation code in a folder of your choice (see basic example in the examples folder). Call:

stosim --folder <path-to-your-experiment-folder>

You can leave the –folder option away if stosim.conf is in the current directory. The results will be put in the “data” directory, in your folder (but if you like the plotting capabilities of StoSim you might never have to look there).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stosim-0.2.21.tar.gz (21.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page