Installation

Just run

pip install corner

to get the most recent stable version.

Usage

The main entry point is the corner.corner function. You’ll just use it like this:

import numpy as np
import corner

ndim, nsamples = 5, 10000
samples = np.random.randn(ndim * nsamples).reshape([nsamples, ndim])
figure = corner.corner(samples)
figure.savefig("corner.png")

With some other tweaks (see demo.py) you can get something that looks awesome like:

By default, data points are shown as grayscale points with contours. Contours are shown at 0.5, 1, 1.5, and 2 sigma.

For more usage examples, take a look at tests.py.

Documentation

All the options are documented in the docstrings for the corner and hist2d functions. These can be viewed in a Python shell using:

import corner
print(corner.corner.__doc__)

or, in IPython using:

import corner
corner.corner?

pdf(r) = exp(-(r/s)^2/2) / (2*pi*s^2)

cdf(x) = Integral(r * exp(-(r/s)^2/2) / s^2, {r, 0, x})
       = 1 - exp(-(x/s)^2/2)

Attribution

If you make use of this code, please cite it.

License

Copyright 2013, 2014 Dan Foreman-Mackey

corner.py is free software made available under the BSD License. For details see the LICENSE file.