Metadata-Version: 2.4
Name: ctapipe
Version: 0.30.0
Summary: Event reconstruction framework for Imaging Atmospheric Cherenkov Telescopes developed for CTAO.
Author: ctapipe developers
Maintainer-email: Karl Kosack <karl.kosack@cea.fr>, Maximilian Linhoff <maximilian.linhoff@tu-dortmund.de>
License-Expression: BSD-3-Clause
Project-URL: repository, https://github.com/cta-observatory/ctapipe/
Project-URL: documentation, https://ctapipe.readthedocs.io/
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Development Status :: 3 - Alpha
Requires-Python: >=3.12
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: astropy<8.0.0,>=6.1
Requires-Dist: docutils
Requires-Dist: joblib
Requires-Dist: numba>=0.59.0
Requires-Dist: numpy<3.0.0,>=1.26
Requires-Dist: packaging
Requires-Dist: psutil
Requires-Dist: pyyaml>=5.1
Requires-Dist: requests
Requires-Dist: scikit-learn!=1.4.0
Requires-Dist: scipy~=1.15
Requires-Dist: tables~=3.4
Requires-Dist: tqdm>=4.32
Requires-Dist: traitlets~=5.6
Provides-Extra: eventio
Requires-Dist: eventio<3.0.0,>=1.9.1; extra == "eventio"
Provides-Extra: all
Requires-Dist: bokeh~=3.0; extra == "all"
Requires-Dist: ctapipe[eventio]; extra == "all"
Requires-Dist: iminuit>=2; extra == "all"
Requires-Dist: matplotlib~=3.0; extra == "all"
Requires-Dist: pyirf~=0.13.0; extra == "all"
Provides-Extra: tests
Requires-Dist: ctapipe[eventio]; extra == "tests"
Requires-Dist: h5py; extra == "tests"
Requires-Dist: pandas; extra == "tests"
Requires-Dist: pytest>=9.0; extra == "tests"
Requires-Dist: pytest-cov; extra == "tests"
Requires-Dist: pytest-xdist; extra == "tests"
Requires-Dist: pytest_astropy_header; extra == "tests"
Requires-Dist: tomli; extra == "tests"
Requires-Dist: astroquery; extra == "tests"
Provides-Extra: docs
Requires-Dist: ctapipe[all]; extra == "docs"
Requires-Dist: ffmpeg-python; extra == "docs"
Requires-Dist: graphviz; extra == "docs"
Requires-Dist: ipython; extra == "docs"
Requires-Dist: jupyter; extra == "docs"
Requires-Dist: nbsphinx; extra == "docs"
Requires-Dist: notebook; extra == "docs"
Requires-Dist: numpydoc; extra == "docs"
Requires-Dist: pandas; extra == "docs"
Requires-Dist: pydata_sphinx_theme; extra == "docs"
Requires-Dist: pypandoc; extra == "docs"
Requires-Dist: sphinx~=8.2.0; extra == "docs"
Requires-Dist: sphinx-automodapi==0.22.0; extra == "docs"
Requires-Dist: sphinx-design; extra == "docs"
Requires-Dist: sphinx-gallery>=0.16.0; extra == "docs"
Requires-Dist: sphinxcontrib-bibtex; extra == "docs"
Requires-Dist: sphinx-changelog; extra == "docs"
Provides-Extra: dev
Requires-Dist: ctapipe[all,docs,tests]; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: setuptools_scm[toml]; extra == "dev"
Dynamic: license-file

==================================================================================
 ctapipe |pypi| |conda| |doilatest| |ci| |sonarqube_coverage| |sonarqube_quality|
==================================================================================

.. |ci| image:: https://github.com/cta-observatory/ctapipe/actions/workflows/ci.yml/badge.svg?branch=main
    :target: https://github.com/cta-observatory/ctapipe/actions/workflows/ci.yml
    :alt: Test Status
.. |sonarqube_quality| image:: https://sonar-ctao.zeuthen.desy.de/api/project_badges/measure?project=cta-observatory_ctapipe_6122e87b-83f3-4db1-8287-457e752adf01&metric=alert_status&token=sqb_3fa6e5337b8d7a2b09fd616cc5424a2e77d4be06
    :target: https://sonar-ctao.zeuthen.desy.de/dashboard?id=cta-observatory_ctapipe_6122e87b-83f3-4db1-8287-457e752adf01&codeScope=overall
    :alt: sonarqube quality gate
.. |sonarqube_coverage| image:: https://sonar-ctao.zeuthen.desy.de/api/project_badges/measure?project=cta-observatory_ctapipe_6122e87b-83f3-4db1-8287-457e752adf01&metric=coverage&token=sqb_3fa6e5337b8d7a2b09fd616cc5424a2e77d4be06
    :target: https://sonar-ctao.zeuthen.desy.de/component_measures?id=cta-observatory_ctapipe_6122e87b-83f3-4db1-8287-457e752adf01&metric=coverage&view=list
    :alt: sonarqube code coverage
.. |conda| image:: https://anaconda.org/conda-forge/ctapipe/badges/version.svg
  :target: https://anaconda.org/conda-forge/ctapipe
.. |doilatest| image:: https://zenodo.org/badge/37927055.svg
  :target: https://zenodo.org/badge/latestdoi/37927055
.. |pypi| image:: https://badge.fury.io/py/ctapipe.svg
    :target: https://pypi.org/project/ctapipe

Low-level data processing pipeline software for the
`CTAO (Cherenkov Telescope Array Observatory) <https://www.ctao.org>`__.

This code is a prototype data processing framework and is under rapid
development. It is not recommended for production use unless you are an
expert or developer!

* Code: https://github.com/cta-observatory/ctapipe
* Docs: https://ctapipe.readthedocs.io/
* Slack: Contact Karl Kosack for invite

Citing this software
====================

If you use this software for a publication, please cite the Zenodo Record
for the specific version you are using and our latest publication.

You can find all ctapipe Zenodo records here: `List of ctapipe Records on Zenodo <https://zenodo.org/search?q=conceptrecid:%223372210%22&sort=-version&all_versions=True>`__.

There is also a Zenodo DOI always pointing to the latest version: |doilatest|

At this point, the latest publication is our contribution in the `2023 ICRC proceedings <https://doi.org/10.22323/1.444.0703>`_, which you can
cite using this bibtex entry:

.. code::

   @inproceedings{ctapipe-icrc-2023,
     author = {Linhoff, Maximilian and Beiske, Lukas and Biederbeck, Noah and Fröse, Stefan and Kosack, Karl and Nickel, Lukas},
     title = {ctapipe -- Prototype Open Event Reconstruction Pipeline for the Cherenkov Telescope Array},
     usera = {for the CTA Consortium and Observatory},
     doi = {10.22323/1.444.0703},
     booktitle = {Proceedings, 38th International Cosmic Ray Conference},
     year=2023,
     volume={444},
     number={703},
     location={Nagoya, Japan},
   }


Installation for Users
======================

*ctapipe* and its dependencies may be installed using the *Anaconda* or
*Miniconda* package system. We recommend creating a conda virtual environment
first, to isolate the installed version and dependencies from your main
environment (this is optional).


The latest version of ``ctapipe`` can be installed via::

  mamba install -c conda-forge ctapipe

or via::

  pip install ctapipe

**Note**: to install a specific version of ctapipe take a look at the documentation `here <https://ctapipe.readthedocs.io/en/latest/user-guide/index.html>`__.

**Note**: ``mamba`` is a C++ reimplementation of conda and can be found `here <https://github.com/mamba-org/mamba>`__.

Note that this is *pre-alpha* software and is not yet stable enough for end-users (expect large API changes until the first stable 1.0 release).

Developers should follow the development install instructions found in the
`documentation <https://ctapipe.readthedocs.io/en/latest/developer-guide/getting-started.html>`__.
