Skip to main content

Database of published cosmic-ray energy spectra

Project description

This package is deprecated. Please use the official CRDB Python package.

This Python package provides a database of published cosmic-ray energy spectra, measured by surface detectors like IceTop or the Pierre Auger Observatory; see references. Moreover, it gives access to the Cosmic-Ray DataBase (CRDB), which includes electrons, positrons, anti-protons, and nuclide up to Z = 30 for energies below the cosmic-ray knee.

Installation

The easiest way to install this project is by using pip:

pip install crspectra

Getting started

The measured cosmic-ray energy spectra can be requested via:

import crspectra

with crspectra.connect() as database:
   for experiment in database:
      spectrum = database[experiment]

A structured NumPy array is returned containing the requested cosmic-ray data. The fields are energy, flux, statistical stat and systematical sys uncertainty on the flux, and uncertainty is upper a limit uplim. The energy is given in GeV and the flux is given in GeV^-1 m^-2 s^-1 sr^-1. The uncertainties describe the lower and upper uncertainty relative to the flux.

Data from CRDB can be requested via:

spectrum = crspectra.from_external("AMS-02")

Note that CRDB also provides the papers that should be citied.

The following plot was created using this package; see the example Jupyter Notebook:

https://github.com/kkrings/crspectra/raw/main/example/crspectra.png

References

Please cite the following papers when using this database:

Auger

The Pierre Auger Collaboration, Proceedings of the 35th International Cosmic Ray Conference, Vol. ICRC2017, Proceedings of Science, 2017, p. 486

CREAM-I/III

Yoon et al., The Astrophysical Journal 839.1 (2017), p. 5

GAMMA

Ter-Antonyan, Physical Review D89.12 (2014), p. 123003

HAWC

Alfaro et al., Physical Review D96.12 (2017), p. 12201

HiRes/MIA

Abu-Zayyad et al., The Astrophysical Journal 557 (2001), pp. 686-699

HiRes-I and HiRes-II

Abbasi et al., Physical Review Letters 100 (2008), p. 101101

IceTop-73

Aartsen et al., Physical Review D88.4 (2013), p. 042004

KASCADE

Antoni et al., Astroparticle Physics 24 (2005), pp. 1-25

KASCADE-Grande

Apel et al., The Astrophysical Journal 36 (2012), pp. 183-194

Tibet-III

Amenomori et al., The Astrophysical Journal 678 (2008), pp. 1165-1179

CRDB

Maurin et al., Astronomy & Astrophysics 569 (2014), A32

CRDB v4.0

Maurin et al., Universe 6 (2020) 8, 102

Notes

I have created this database in mid of 2017 when I started writing on my PhD thesis. In case you find a publication with newer data, feel free to request its addition.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

crspectra-1.1.1.tar.gz (28.0 kB view hashes)

Uploaded Source

Built Distribution

crspectra-1.1.1-py3-none-any.whl (27.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page