Error propagation and statistical analysis for Markov chain Monte Carlo simulations in lattice QCD and statistical mechanics using autograd
Find a file
2021-01-29 12:25:20 +01:00
examples Typos corrected in examples 2021-01-29 12:13:30 +01:00
pyerrors dependency on PySimpleGUI removed 2021-01-29 12:25:20 +01:00
tests Initial public release 2020-10-13 16:53:00 +02:00
.gitignore Initial public release 2020-10-13 16:53:00 +02:00
CHANGELOG.md Hotfix 1.0.1 2020-11-03 15:12:18 +01:00
conftest.py Initial public release 2020-10-13 16:53:00 +02:00
LICENSE Initial public release 2020-10-13 16:53:00 +02:00
pytest.ini Initial public release 2020-10-13 16:53:00 +02:00
README.md Initial public release 2020-10-13 16:53:00 +02:00
setup.py correlators module cleaned up, GUI_range_finder commented out for now 2021-01-29 11:52:36 +01:00

pyerrors

pyerrors is a python package for error computation and propagation of Markov Chain Monte Carlo data. It is based on the gamma method arXiv:hep-lat/0306017. Some of its features are:

  • automatic differentiation as suggested in arXiv:1809.01289 (partly based on the autograd package)
  • the treatment of slow modes in the simulation as suggested in arXiv:1009.5228
  • multi ensemble analyses
  • non-linear fits with y-errors and exact linear error propagation based on automatic differentiation as introduced in [arXiv:1809.01289]
  • non-linear fits with x- and y-errors and exact linear error propagation based on automatic differentiation
  • matrix valued operations and their error propagation based on automatic differentiation (cholesky decomposition, calculation of eigenvalues and eigenvectors, singular value decomposition...)
  • implementation of the matrix-pencil-method IEEE Trans. Acoust. 38, 814-824 (1990) for the extraction of energy levels, especially suited for noisy data and excited states

There exist similar implementations of gamma method error analysis suites in

Installation

pyerrors requires python versions >= 3.5.0

Install the package for the local user:

pip install . --user

Run tests to verify the installation:

pytest .

Usage

The basic objects of a pyerrors analysis are instances of the class Obs. They can be initialized with an array of Monte Carlo data (e.g. samples1) and a name for the given ensemble (e.g. 'ensemble1'). The gamma_method can then be used to compute the statistical error, taking into account autocorrelations. The print method outputs a human readable result.

import numpy as np
import pyerrors as pe

observable1 = pe.Obs([samples1], ['ensemble1'])
observable1.gamma_method()
observable1.print()

Often one is interested in secondary observables which can be arbitrary functions of primary observables. pyerrors overloads most basic math operations and numpy functions such that the user can work with Obs objects as if they were floats

observable3 = 12.0 / observable1 ** 2 - np.exp(-1.0 / observable2)
observable3.gamma_method()
observable3.print()

More detailed examples can be found in the /examples folder:

License

MIT