Skip to main content

magic-cta-pipe

magic-cta-pipe GitHub Actions CI Status magic-cta-pipe PyPI Status magic-cta-pipe Conda Status magic-cta-pipe documentation Status pre-commit isort Status black

Repository for the analysis of MAGIC and MAGIC+LST1 data, based on ctapipe.

The latest stable release, v0.6.2, 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 for more details on how to run the analysis.

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. v0.4.0 contained backward incompatible changes with respect to v0.3.1. Therefore, you cannot mix analyses performed with the two releases (and more recent ones). v0.5.* is based on ctapipe v0.19.x and cta-lstchain v0.10.x (with 5<=x<12). v0.6.0 is the first magic-cta-pipe release based on ctapipe v0.25.x and cta-lstchain v0.11. Note that calculation of some of the event parameters (leakage and height of the shower maximum) is different w.r.t. ctapipe 0.19, which means that one should not mix data and MCs processed with <=0.5 and >=0.6 versions of MCP

COMPATIBILITY OF MAGIC-CTA-PIPE WITH LSTCHAIN DATA

At the moment of the release v0.4.0 of magic-cta-pipe, some LST-1 data were processed with cta-lstchain v0.9.x, while the most recent ones are processed with v0.10.x. v0.4.2 of magic-cta-pipe and more recent releases allow to read in LST data files created with both v0.9.x and v0.10.x, so that you do not need to use different versions of magic-cta-pipe to process LST data.

Note that there are quite a lot of differences between v0.3.1 and v0.4.x, like for the telescope combinations definition, the way IRF are created (due to different pyirf versions) and so on. Therefore it may not be straightforward to stack the data at high level. We recommend to use only releases more recent than v0.4.2 for the processing, so that there will be no mismatches during the analysis.

Installation for users

The very first step to reduce MAGIC-LST data is to have remote access/credentials to the IT Container. If you do not have it, please write an email to request it to <admin-ctan@cta-observatory.org>, and the admin will send you the instructions to connect to the IT container.

magic-cta-pipe and its dependencies may be installed using the Anaconda or Miniconda package system (if you have mamba installed, we recommend you to use it instead of conda, so that the installation process will be much faster; if you don’t have anaconda/miniconda/miniforge, please install one of them into your workspace directory). We recommend creating a conda virtual environment first, to isolate the installed version and dependencies from your master environment (this is optional).

Since version 0.5.1, magic-cta-pipe is on conda-forge (https://anaconda.org/conda-forge/magic-cta-pipe), which is the easiest way to install it.

To install into an exisiting environment, just do:

# or conda
$ mamba install -c conda-forge magic-cta-pipe

or, to create a new environment:

# or conda
mamba create -c conda-forge -n mcp python=3.11 magic-cta-pipe

Alternatively, 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-lst -f environment.yml
conda activate magic-lst
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.

Metadata

Release files for magic-cta-pipe 0.6.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for magic-cta-pipe 0.6.2
File Size Uploaded Provenance Actions
magic_cta_pipe-0.6.2.tar.gz 2.7 MB Without provenance Details for magic_cta_pipe-0.6.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for magic-cta-pipe 0.6.2
File Interpreter ABI Platform Actions
magic_cta_pipe-0.6.2-py3-none-any.whl Python 3 none any Details for magic_cta_pipe-0.6.2-py3-none-any.whl

Total release size: 2.8 MB

Release files / magic_cta_pipe-0.6.2.tar.gz

Download URL magic_cta_pipe-0.6.2.tar.gz
Size 2.7 MB
Tags Source
SHA-256 checksum
How to use checksums
44fa47ba9ba8729c4d6a162d6d539aaaff2f821535342cf1481aa17936475f0b
BLAKE2b-256 checksum
How to use checksums
14db2934e893d2bf7cbb3a6a45d92ebf3609c3c7668d0ccc91866fd1fc7ce83a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / magic_cta_pipe-0.6.2-py3-none-any.whl

Download URL magic_cta_pipe-0.6.2-py3-none-any.whl
Size 181.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
447bd674a31b8d46fee1c04cb04cb0d34a9a2c0d73344bc5b49c0fc94b72cf21
BLAKE2b-256 checksum
How to use checksums
5e81c11e0c554ed94f0dfa65b9ff6606218aa79b4848af7c43693821300d04f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Security for magic-cta-pipe 0.6.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page