docs build coverage license codacy zenodo

The pymcmcstat package is a Python program for running Markov Chain Monte Carlo (MCMC) simulations. Included in this package is the ability to use different Metropolis based sampling techniques:

  • Metropolis-Hastings (MH): Primary sampling method.
  • Adaptive-Metropolis (AM): Adapts covariance matrix at specified intervals.
  • Delayed-Rejection (DR): Delays rejection by sampling from a narrower distribution. Capable of n-stage delayed rejection.
  • Delayed Rejection Adaptive Metropolis (DRAM): DR + AM

The pymcmcstat homepage contains tutorials for users as well as installation instructions.

Python implementation of MATLAB toolbox “mcmcstat”. This code is designed to replicate the functionality of the MATLAB routines developed and posted here:

The user interface is designed to be as similar to the MATLAB version as possible, but this implementation has taken advantage of certain data structure concepts more amenable to Python.


This code can be found on the Github project page. It is open source and provided under the MIT license. To install directly from Github,

pip install git+

You can also clone the repository and run python install.

Package is also available on the PyPI distribution site.

pip install pymcmcstat

Getting Started




See the GitHub contributor page


Indices and tables