Skip to content
Python implementation of MATLAB toolbox "mcmcstat"
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc updated how documentation reads the version number May 2, 2019
paper Removed Zenodo reference Jun 6, 2019
test added test to confirm version attribute exists and matches format May 2, 2019
tutorials added compiled shared object May 17, 2019
.gitignore added ipython checkpoints to ignore file May 17, 2019
.travis.yml Update .travis.yml Apr 5, 2019
CHANGELOG.rst Added v1.7.1 to changelog May 18, 2019
LICENSE.txt added MIT license statement Oct 20, 2017
README.rst Added JOSS citation information and badge Jun 7, 2019
requirements.txt added versions to requirements.txt Jul 12, 2018



docs build coverage license zenodo joss pypi pyversion

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

This package is an adaptation of the MATLAB toolbox mcmcstat. 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.

Note, advanced plotting routines are available in the mcmcplot package. Many plotting features are directly available within pymcmcstat, but some user's may find mcmcplot useful.


This code can be found on the Github project page. This package is available on the PyPI distribution site and the latest version can be installed via

pip install pymcmcstat

The master branch on Github typically matches the latest version on the PyPI distribution site. To install the master branch directly from Github,

pip install git+

You can also clone the repository and run python install.

Getting Started




See the GitHub contributor page

Citing pymcmcstat

Miles, (2019). pymcmcstat: A Python Package for Bayesian Inference Using Delayed Rejection Adaptive Metropolis. Journal of Open Source Software, 4(38), 1417,

Also, please cite the appropriate Zenodo archive for the version of pymcmcstat that you are using.



This work was sponsored in part by the NNSA Office of Defense Nuclear Nonproliferation R&D through the Consortium for Nonproliferation Enabling Capabilities.


You can’t perform that action at this time.