Metadata-Version: 2.4
Name: cobaya
Version: 3.6
Summary: Code for Bayesian Analysis
Author: Jesus Torrado, Antony Lewis
License-Expression: LGPL-3.0-or-later AND LicenseRef-GFDL-1.3-or-later
Project-URL: Homepage, https://cobaya.readthedocs.io
Project-URL: Documentation, https://cobaya.readthedocs.io
Project-URL: Source, https://github.com/CobayaSampler/cobaya
Project-URL: Tracker, https://github.com/CobayaSampler/cobaya/issues
Project-URL: Licensing, https://github.com/CobayaSampler/cobaya/blob/master/LICENCE.txt
Keywords: montecarlo,sampling,MCMC,cosmology
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10.0
Description-Content-Type: text/x-rst
License-File: LICENCE.txt
Requires-Dist: numpy>=1.17.0
Requires-Dist: scipy>=1.5
Requires-Dist: pandas>=1.0.1
Requires-Dist: PyYAML>=5.1
Requires-Dist: requests>=2.18
Requires-Dist: py-bobyqa>=1.4
Requires-Dist: GetDist>=1.3.1
Requires-Dist: thefuzz>=0.17
Requires-Dist: packaging>=24.2
Requires-Dist: tqdm
Requires-Dist: portalocker>=2.3.0
Requires-Dist: dill>=0.3.3
Requires-Dist: typing_extensions
Provides-Extra: speed
Requires-Dist: numba; extra == "speed"
Requires-Dist: mpi4py; extra == "speed"
Provides-Extra: gui
Requires-Dist: pyside6; extra == "gui"
Requires-Dist: matplotlib; extra == "gui"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx_rtd_theme>=1.0; extra == "docs"
Requires-Dist: sphinxcontrib-jquery; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: sphinxcontrib-programoutput; extra == "docs"
Provides-Extra: devel
Requires-Dist: ruff; extra == "devel"
Requires-Dist: pre-commit; extra == "devel"
Requires-Dist: pyupgrade; extra == "devel"
Requires-Dist: pytest; extra == "devel"
Requires-Dist: pytest-xdist; extra == "devel"
Requires-Dist: pytest-cov; extra == "devel"
Requires-Dist: flaky; extra == "devel"
Requires-Dist: dill; extra == "devel"
Requires-Dist: mpi4py; extra == "devel"
Requires-Dist: iminuit; extra == "devel"
Dynamic: license-file

*Cobaya*, a code for Bayesian analysis in Cosmology
===================================================

:Author: `Jesus Torrado`_ and `Antony Lewis`_

:Source: `Source code at GitHub <https://github.com/CobayaSampler/cobaya>`_

:Documentation: `Documentation at Readthedocs <https://cobaya.readthedocs.org>`_

:Licence: `LGPL <https://www.gnu.org/licenses/lgpl-3.0.en.html>`_ + bug reporting asap + `arXiv'ing <https://arxiv.org>`_ of publications using it (see `LICENCE.txt <https://github.com/CobayaSampler/cobaya/blob/master/LICENCE.txt>`_ for details and exceptions). The documentation is licensed under the `GFDL <https://www.gnu.org/licenses/fdl-1.3.en.html>`_.

:E-mail list: https://cosmocoffee.info/cobaya/ – **sign up for important bugs and release announcements!**

:Support: For general support, CosmoCoffee_; for bugs and issues, use the `issue tracker <https://github.com/CobayaSampler/cobaya/issues>`_.

:Installation: ``pip install cobaya --upgrade`` (see the `installation instructions <https://cobaya.readthedocs.io/en/latest/installation.html>`_; in general do *not* clone)

.. image:: https://github.com/CobayaSampler/cobaya/actions/workflows/tests.yml/badge.svg?branch=master
   :target: https://github.com/CobayaSampler/cobaya/actions
.. image:: https://readthedocs.org/projects/cobaya/badge/?version=latest
   :target: https://cobaya.readthedocs.org/en/latest
.. image:: https://codecov.io/gh/CobayaSampler/cobaya/branch/master/graphs/badge.svg
   :target: https://codecov.io/github/CobayaSampler/cobaya/branch/master
.. image:: https://img.shields.io/pypi/v/cobaya.svg?style=flat
   :target: https://pypi.python.org/pypi/cobaya/
.. image:: https://static.pepy.tech/personalized-badge/cobaya?period=total&units=international_system&left_color=grey&right_color=blue&left_text=pypi%20downloads
   :target: https://pepy.tech/project/cobaya
.. image:: https://img.shields.io/badge/arXiv-2005.05290-b31b1b.svg?color=0B6523
   :target: https://arxiv.org/abs/2005.05290

**Cobaya** (**co**\ de for **bay**\ esian **a**\ nalysis, and Spanish for *Guinea Pig*) is a framework for sampling and statistical modelling: it allows you to explore an arbitrary prior or posterior using a range of Monte Carlo samplers (including the advanced MCMC sampler from CosmoMC_, and the advanced nested sampler PolyChord_). The results of the sampling can be analysed with GetDist_. It supports MPI parallelization.

Its authors are `Jesus Torrado`_ and `Antony Lewis`_. Some ideas and pieces of code have been adapted from other codes (e.g CosmoMC_ by `Antony Lewis`_ and contributors, and `Monte Python`_, by `J. Lesgourgues`_ and `B. Audren`_).

**Cobaya** has been conceived from the beginning to be highly and effortlessly extensible: without touching **cobaya**'s source code, you can define your own priors and likelihoods, create new parameters as functions of other parameters...

Though **cobaya** is a general purpose statistical framework, it includes interfaces to cosmological *theory codes* (CAMB_ and CLASS_) and *likelihoods of cosmological experiments* (Planck, Bicep-Keck, SDSS... and more coming soon). Automatic installers are included for all those external modules. You can also use **cobaya** simply as a wrapper for cosmological models and likelihoods, and integrate it in your own sampler/pipeline.

The interfaces to most cosmological likelihoods are agnostic as to which theory code is used to compute the observables, which facilitates comparison between those codes. Those interfaces are also parameter-agnostic, so using your own modified versions of theory codes and likelihoods requires no additional editing of **cobaya**'s source.


How to cite us
--------------

If you use **cobaya**, please cite its pre-print, `arXiv:2005.05290 <https://arxiv.org/abs/2005.05290>`_, and its ASCL record, `ascl:1910.019 <https://ascl.net/1910.019>`_.

To appropriately cite the packages (samplers, theory codes, likelihoods) that you have used, simply run the script `cobaya-bib` with your input file(s) as argument(s), and you will get *bibtex* references and a short suggested text snippet for each module mentioned in your input file. You can find a usage example `here <https://cobaya.readthedocs.io/en/latest/cosmo_basic_runs.html#citations>`_.


Acknowledgements
----------------

Thanks to `J. Lesgourgues`_ and `W. Handley`_ for support on interfacing CLASS_ and PolyChord_ respectively.

Thanks too to `G. Cañas Herrera`_, `A. Finke`_, `X. Garrido`_, `S. Heimersheim`_, `L. Hergt`_, `C. Hill`_, `P. Lemos`_, `M.S. Madhavacheril`_, `V. Miranda`_, `T. Morton`_,  `M. Rashkovetskyi`_, `J. Zunz`_ and many others for extensive and somewhat painful testing.

.. _`Jesus Torrado`: https://web.physik.rwth-aachen.de/user/torrado
.. _`Antony Lewis`: https://cosmologist.info
.. _CosmoMC: https://cosmologist.info/cosmomc/
.. _CosmoCoffee: https://cosmocoffee.info/viewforum.php?f=11
.. _`Monte Python`: https://baudren.github.io/montepython.html
.. _Camb: https://camb.info/
.. _Class: https://class-code.net/
.. _GetDist: https://github.com/cmbant/getdist
.. _PolyChord: https://github.com/PolyChord/PolyChordLite
.. _`J. Lesgourgues`: https://www.particle-theory.rwth-aachen.de/cms/Particle-Theory/Das-Institut/Mitarbeiter-TTK/Professoren/~gufe/Lesgourgues-Julien/?lidx=1
.. _`B. Audren`: https://baudren.github.io/
.. _`W. Handley`: https://www.kicc.cam.ac.uk/directory/wh260
.. _`G. Cañas Herrera`: https://gcanasherrera.github.io/pages/about-me.html#about-me
.. _`A. Finke`: https://cosmology.unige.ch/users/andreas-finke
.. _`X. Garrido`: https://xgarrido.github.io/
.. _`S. Heimersheim`: https://www.ast.cam.ac.uk/people/Stefan.Heimersheim
.. _`L. Hergt`: https://www.kicc.cam.ac.uk/directory/lh561
.. _`C. Hill`: http://user.astro.columbia.edu/~jch/
.. _`P. Lemos`: https://pablo-lemos.github.io/
.. _`M.S. Madhavacheril`: https://msyriac.github.io/
.. _`V. Miranda`: https://github.com/vivianmiranda
.. _`T. Morton`: https://github.com/timothydmorton
.. _`M. Rashkovetskyi`: https://misharash.github.io/
.. _`J. Zunz`: https://github.com/joezuntz


===================

.. image:: https://raw.githubusercontent.com/CobayaSampler/cobaya/master/img/Sussex_white.svg
   :alt: University of Sussex
   :target: https://www.sussex.ac.uk/astronomy/
   :height: 150px
   :width: 150px

.. image:: https://raw.githubusercontent.com/CobayaSampler/cobaya/master/img/logo_ttk.png
   :alt: RWTH Aachen
   :target: https://www.particle-theory.rwth-aachen.de/
   :height: 150px

.. image:: https://raw.githubusercontent.com/CobayaSampler/cobaya/master/img/ERC_white.svg
   :alt: European Research Council
   :target: https://erc.europa.eu/
   :height: 150px
   :width: 150px

.. image:: https://cdn.cosmologist.info/antony/STFC_white.svg
   :alt: STFC
   :target: https://stfc.ukri.org/
   :height: 150px
   :width: 150px

(Copyright for the logos above belongs to their respective institutions.)
