Skip to main content

A set of Python tools for statistically analyzing correlated data. This includes aspects of lattice QCD applications related to QCD phenomenology.

Project description

AnalysisToolbox

Maintenance DOI

The AnalysisToolbox set of Python tools for statistically analyzing correlated data. This includes aspects of lattice QCD applications related to QCD phenomenology.

We advertise briefly here some features of the AnalysisToolbox:

  • General mathematics: Numerical differentiation, convenience wrappers for SciPy numerical integration and solving IVPs.
  • General statistics: Jackknife, bootstrap, Gaussian bootstrap, error propagation, various information criteria, estimation of integrated autocorrelation time, error ellipses, Kolmogorov-Smirnov tests, and curve fitting with and without Bayesian priors. We stress that our math and statistics methods are generally useful, independent of physics contexts.
  • General physics: Unit conversions, critical exponents for various universality classes, physical constants, framework for spin models.
  • QCD physics: Hadron resonance gas model, HotQCD equation of state, and the QCD beta function. These methods are useful for QCD phenomenology, independent of lattice contexts.
  • Lattice QCD: Continuum-limit extrapolation, Polyakov loop observables, SU(3) gauge fields, reading in gauge fields, and the static quark-antiquark potential. These methods rather target lattice QCD.

In any of the above cases, after installing the AnalysisToolbox, you can easily incorporate its features in your own Python scripts like any other library. Some simple examples are in the tutorial. A realistic use-case that weaves the AnalysisToolbox into a lattice QCD workflow can be found in this data publication. More information can be found in the documentation.

To use the AnalysisToolbox, make sure you have Python 3.9+. You should then be able to conveniently install it using

pip install latqcdtools

Besides this, there is a latexify() command you can use when plotting to make your plot font match typical LaTeX documents. In order for this command to work, you need to have LaTeX installed on your system. We recommend installing TeXLive-Full.

Getting started and documentation

To acquaint yourself with the AnalysisToolbox, you can start by having a look at the tutorial, which walks through some scripts in the examples directory. You can also look at some of the scripts in the applications and testing directories.

To learn about the code in more detail, especially learning how to contribute, please have a look the documentation.

Getting help and bug reports

Open an issue, if...

  • you have troubles running the code.
  • you have questions on how to implement your own routine.
  • you have found a bug.
  • you have a feature request.

If none of the above cases apply, you may also send an email to clarke(dot)davida(at)gmail(dot)com.

Contributors

D. A. Clarke, L. Altenkort, H. Dick, J. Goswami, O. Kaczmarek, L. Mazur, H. Sandmeyer, M. Sarkar, C. Schmidt, H.-T. Shu, T. Ueding

Crediting AnalysisToolbox

If you used this code in your research, your teaching, or found it generally useful, please help us out by citing

@inproceedings{Altenkort:2023xxi,
    author = "Altenkort, Luis and Clarke, David Anthony and Goswami, Jishnu and Sandmeyer, Hauke",
    title = "{Streamlined data analysis in Python}",
    eprint = "2308.06652",
    archivePrefix = "arXiv",
    primaryClass = "hep-lat",
    month = "8",
    year = "2023"
}

Acknowledgments

  • We acknowledge support by the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) through the CRC-TR 211 'Strong-interaction matter under extreme conditions'– project number 315477589 – TRR 211.
  • This work was partly performed in the framework of the PUNCH4NFDI consortium supported by DFG fund "NFDI 39/1", Proj.No. 460248186 (PUNCH4NFDI).
  • DAC acknowledges helpful discussions with C. DeTar, S. Lahert, and G. P. LePage.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

latqcdtools-1.2.2.tar.gz (95.8 kB view details)

Uploaded Source

Built Distribution

latqcdtools-1.2.2-py3-none-any.whl (107.1 kB view details)

Uploaded Python 3

File details

Details for the file latqcdtools-1.2.2.tar.gz.

File metadata

  • Download URL: latqcdtools-1.2.2.tar.gz
  • Upload date:
  • Size: 95.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.3

File hashes

Hashes for latqcdtools-1.2.2.tar.gz
Algorithm Hash digest
SHA256 3cc49146905dbf292153652bc9db9bc5a7ad4430b9a7dffe1895d0fae15196dc
MD5 a7c8f04986c93f691b85fe08ccc1c122
BLAKE2b-256 3da323c5a1ee873282302f377798ef1578c467e5426a619e809d4da1c8223737

See more details on using hashes here.

File details

Details for the file latqcdtools-1.2.2-py3-none-any.whl.

File metadata

  • Download URL: latqcdtools-1.2.2-py3-none-any.whl
  • Upload date:
  • Size: 107.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.3

File hashes

Hashes for latqcdtools-1.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 543d66bb36837291518f3b8192fc85d58a564ab9f29df6e90416aa4c378e528b
MD5 303c729bb828877841bb1dc3f9017f6d
BLAKE2b-256 b133286353546051a3b6e6634d789c97bfa28cf0d4c78d064da322e83c3e030a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page