Metadata-Version: 2.1
Name: magic-cta-pipe
Version: 0.4.1
Summary: pipeline for the analysis of joint MAGIC+LST-1 data
Home-page: https://github.com/cta-observatory/magic-cta-pipe
Author: magic-cta-pipe developers
Author-email: alessioberti90@gmail.com
License: BSD 3-Clause
Project-URL: Bug Tracker, https://github.com/cta-observatory/magic-cta-pipe/issues
Project-URL: Source Code, https://github.com/cta-observatory/magic-cta-pipe
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: ctapipe ~=0.19.2
Requires-Dist: lstchain ~=0.10.5
Requires-Dist: ctaplot ~=0.6.4
Requires-Dist: ctapipe-io-magic ~=0.5.4
Requires-Dist: gammapy ~=1.1
Requires-Dist: uproot ~=5.0
Requires-Dist: pandas
Requires-Dist: pyirf ~=0.10.0
Requires-Dist: seaborn
Requires-Dist: astropy
Requires-Dist: bokeh
Requires-Dist: eventio <2.0.0a0,>=1.9.1
Requires-Dist: h5py
Requires-Dist: iminuit >=2
Requires-Dist: joblib ~=1.2.0
Requires-Dist: matplotlib ~=3.0
Requires-Dist: numba
Requires-Dist: numpy
Requires-Dist: protobuf ~=3.20.0
Requires-Dist: scipy <=1.10
Requires-Dist: scikit-learn ~=1.2
Requires-Dist: tables
Requires-Dist: pymongo
Requires-Dist: pyparsing
Requires-Dist: jinja2 ~=3.0.2
Provides-Extra: all
Requires-Dist: pytest ; extra == 'all'
Requires-Dist: sphinx ; extra == 'all'
Requires-Dist: pydata-sphinx-theme ; extra == 'all'
Requires-Dist: sphinx-automodapi ; extra == 'all'
Requires-Dist: sphinx-argparse ; extra == 'all'
Requires-Dist: nbsphinx ; extra == 'all'
Requires-Dist: numpydoc ; extra == 'all'
Requires-Dist: sphinx-design ; extra == 'all'
Requires-Dist: jupyter ; extra == 'all'
Requires-Dist: notebook ; extra == 'all'
Requires-Dist: pandas ; extra == 'all'
Requires-Dist: ipython ; extra == 'all'
Requires-Dist: setuptools-scm[toml] ; extra == 'all'
Provides-Extra: dev
Requires-Dist: setuptools-scm[toml] ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'
Requires-Dist: pydata-sphinx-theme ; extra == 'docs'
Requires-Dist: sphinx-automodapi ; extra == 'docs'
Requires-Dist: sphinx-argparse ; extra == 'docs'
Requires-Dist: nbsphinx ; extra == 'docs'
Requires-Dist: numpydoc ; extra == 'docs'
Requires-Dist: sphinx-design ; extra == 'docs'
Requires-Dist: jupyter ; extra == 'docs'
Requires-Dist: notebook ; extra == 'docs'
Requires-Dist: pandas ; extra == 'docs'
Requires-Dist: ipython ; extra == 'docs'
Provides-Extra: tests
Requires-Dist: pytest ; extra == 'tests'

==============
magic-cta-pipe
==============

.. container::

    |Actions Status| |PyPI Status| |Documentation Status| |Pre-Commit| |isort Status| |black|

Repository for the analysis of MAGIC and MAGIC+LST1 data, based on `ctapipe <https://github.com/cta-observatory/ctapipe>`_.

* Code: https://github.com/cta-observatory/magic-cta-pipe
* Docs (preliminary): https://magic-cta-pipe.readthedocs.io/

v0.4.1 of *magic-cta-pipe* provides all the functionalities to perform a MAGIC+LST-1 or a MAGIC-only analysis. Both types of analyses can be performed using the scripts within the *lst1_magic* folder.
See `here <https://magic-cta-pipe.readthedocs.io/en/latest/user-guide/magic-lst-scripts.html>`_ for more details on how to run the analysis.

v0.4.1 is based on *ctapipe* v0.19.x and *cta-lstchain* v0.10.x.

**NOTE ON OLD RELEASES**

v0.3.1 of *magic-cta-pipe* was the last release before the cleanup of old files. Also, it was the last one supporting ctapipe v0.12.
In order to exploit fully the new functionalities provided by *ctapipe*, use always the latest stable release of *magic-cta-pipe* (currently v0.4.1).
v0.4.1 contains backward incompatible changes with respect to v0.3.1. Therefore, you cannot mix analyses performed with the two releases.

Installation for users
----------------------

*magic-cta-pipe* 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 master environment (this is optional).

The following command will set up a conda virtual environment, add the necessary package channels, and install *magic-cta-pipe* and its dependencies::

    git clone https://github.com/cta-observatory/magic-cta-pipe.git
    cd magic-cta-pipe
    conda env create -n magic-lst1 -f environment.yml
    conda activate magic-lst1
    pip install .

In general, *magic-cta-pipe* is still in heavy development phase, so expect large changes between different releases.

Instructions for developers
---------------------------

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

.. |Actions Status| image:: https://github.com/cta-observatory/magic-cta-pipe/actions/workflows/ci.yml/badge.svg?branch=master
    :target: https://github.com/cta-observatory/magic-cta-pipe/actions
    :alt: magic-cta-pipe GitHub Actions CI Status

.. |PyPI Status| image:: https://badge.fury.io/py/magic-cta-pipe.svg
    :target: https://pypi.org/project/magic-cta-pipe
    :alt: magic-cta-pipe PyPI Status

.. |Documentation Status| image:: https://readthedocs.org/projects/magic-cta-pipe/badge/?version=latest&style=flat
    :target: https://magic-cta-pipe.readthedocs.io/en/latest/
    :alt: magic-cta-pipe documentation Status

.. |Pre-Commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
   :target: https://github.com/pre-commit/pre-commit
   :alt: pre-commit

.. |isort Status| image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336
    :target: https://pycqa.github.io/isort/
    :alt: isort Status

.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black
