GNU MCSim

GNU MCSim is a simulation package, written in C, which allows you to:

design your own statistical or simulation models (eventually dynamic, via ODEs),
perform Monte Carlo stochastic simulations,
do Bayesian inference through Markov Chain Monte Carlo simulations.

News

January 21st, 2017 - Release of GNU MCSim version 5.6.6.

Version 5.6.6 fixes a bug that affected the code generated for R by mod, introduces the PerTransit input function, allows symbols in Events times and magnitudes, and extends the tempered MCMC specification.

December 9th, 2016 - Using GNU MCSim under Microsoft Windows

The basic tools needed to build and run GNU MCSim are not available to most users of Windows systems. At least two options exists:

The R software (http://www.r-project.org/), installed together with Rtools (this requires administrator's rights), can compile and run GNU MCSim models.
Follow this link to download the corresponding scripts, code, and README detailed instructions file.
Pr. W. Chiu, of Texas A&M, proposes an alternative (using minGW). It requires no administrator's rights. However, only 32 bits code is generated (it is at bit slower).
Follow this link to download the detailed instructions file.

Downloading GNU MCSim

The latest version of GNU MCSim (5.6.6) can be found on any GNU mirror.

You can also download it from the main GNU ftp server:

via HTTP at http://ftp.gnu.org/gnu/mcsim/
via FTP at ftp://ftp.gnu.org/gnu/mcsim/.

The gzipped tar archive contains:

A User's Manual (in Texinfo, pdf and HTML formats)
The ASCII source code of the Mod program (to preprocess your models)
The ASCII source code of the GNU MCSim routines (to link with your models)
Examples of model and simulation files

Older versions can also be obtained on the GNU ftp mirrors and main page.

GNU MCSim development is hosted on savannah.gnu.org. See the MCSim project page on Savannah, where the latest development sources are publicly available.

Documentation

The User's manual for GNU MCSim is available online, as is documentation for most GNU software. You may also find more information about GNU MCSim by running info mcsim, or by looking at /usr/share/mcsim/doc, or similar directories on your system.

The pdf version of the manual can be found here here

Citation

To cite GNU MCSim in publications you should refer to this page or to: Bois F., 2009, GNU MCSim: Bayesian statistical inference for SBML-coded systems biology models Bioinformatics, 25:1453-1454, doi: 10.1093/bioinformatics/btp162.

Installation

To install GNU MCSim, you will need a C compiler and linker to compile the sources and obtain executables. For any machine we recommend the GNU gcc compiler, but standard C compilers should also work.

Versions 5.0.0 up to 5.3.1 required GNU Scientific Library (gsl, and its companion gslcblas) to be installed. With version 5.4.0, GNU gsl becomes optional (but recommended).

Versions above 5.4.0 also prefers libSBML v4.2.0 or above to be installed, but that is not needed if you do not want to read SBML model files.

The user's manual (online here) provides detailed instructions for installation for several platforms.

The basic tools needed to build and run GNU MCSim are not available to most users of Windows systems. At least two simple options exists for them:

The R software (http://www.r-project.org/), installed together with Rtools (this requires administrator's rights), can compile and run GNU MCSim models.
Follow this link to download the corresponding scripts, code, and README detailed instructions file.
Pr. W. Chiu, of Texas A&M, proposes an alternative (using minGW). It requires no administrator's rights. However, only 32 bits code is generated (it is at bit slower).
Follow this link to download the detailed instructions file.

Mailing lists

GNU MCSim has the following mailing lists:

bug-mcsim is used to discuss most aspects of GNU MCSim, including development and enhancement requests, as well as bug reports.
help-mcsim is for general user help and discussion.

Announcements about GNU MCSim and most other GNU software are made on info-gnu (archive). See also info-mcsim.

Security reports that should not be made immediately public can be sent directly to the maintainer. If there is no response to an urgent issue, you can escalate to the general security mailing list for advice.

You can also look at the same lists, GNU MCSim help, and GNU MCSim bug report, on the gmane portal which has spam control.

Contributed material and related links

GNU MCSim older news
GNU MCSim-related links
Supplementary material for the article "GNU MCSim: Bayesian statistical inference for SBML-coded systems biology models" Bioinformatics, 1 June 2009; 25: 1453 - 1454. That paper demonstrates the application of GNU MCSim MCMC sampling, optimal design and multilevel modeling to SBML models.
Supplementary material containing all model and input files for predicting interactions between benzene, toluene, ethylbenzene and xylene via PBPK and systems biology coupling.
A PDF software validation report for version 5.0.0 can be found here. (The bug with the half-normal distribution it mentions has been fixed in version 5.1.0 and later versions.)
A Debian package of version 5.4.0, prepared by Bill Harris (mcsim_5.4.0-1_amd64.deb, 2.7 MB, 25/02/2012).
A nice quick reference card, again by Bill.

Getting involved

Development of GNU MCSim, and GNU in general, is a volunteer effort, and you can contribute. For information, please read How to help GNU. If you'd like to get involved, it's a good idea to join the discussion mailing list (see above).

Development: For development sources, issue trackers, and other information, please see the GNU MCSim project page at savannah.gnu.org.
Maintainer: GNU MCSim is currently being maintained by Frederic Y. Bois. Please use the mailing lists for contact.

Licensing

GNU MCSim is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.