Use and Citations
=================

.. raw:: html

   <p id="dev-version"><strong>Warning:</strong> This is a development version and should not be cited. To find the specific version to cite, please go to <a href="https://pyhf.readthedocs.io/">ReadTheDocs</a>.</p>

Citation
--------

The preferred BibTeX entry for citation of ``pyhf`` includes both the  `Zenodo <https://zenodo.org/>`__
archive and the `JOSS <https://joss.theoj.org/>`__ paper:

.. literalinclude:: bib/preferred.bib
   :language: bibtex

Use in Publications
-------------------

The following is an updating list of citations and use cases of :code:`pyhf`.
There is an incomplete but automatically updated `list of citations on INSPIRE
<https://inspirehep.net/literature/1845084>`__ as well.

Use Citations
~~~~~~~~~~~~~

.. bibliography:: bib/use_citations.bib
   :list: enumerated
   :all:
   :style: unsrt

General Citations
~~~~~~~~~~~~~~~~~

.. bibliography:: bib/general_citations.bib
   :list: enumerated
   :all:
   :style: unsrt

Published Statistical Models
----------------------------

The following is an updating list of HEPData entries for publications using ``HistFactory`` JSON statistical models.

.. note::

   There is also an automatically generated list of statistical models that is updated
   nightly available at `pyhf.github.io/public-probability-models
   <https://pyhf.github.io/public-probability-models>`__.

.. bibliography:: bib/HEPData_likelihoods.bib
   :list: enumerated
   :all:
   :style: unsrt

.. note::

   ATLAS maintains a public listing of all published statistical models on the `ATLAS public results
   page <https://twiki.cern.ch/twiki/bin/view/AtlasPublic>`__ which can be found by filtering all
   public results by the "Likelihood available" analysis characteristics keyword.