COSMIC RAY API

Cosmic ray intensities and radiation protection quantities in the atmosphere

background


cosmic rays in earth's atmosphere

Our atmosphere protects us from a hostile space radiation environment comprised of high energy particles of solar and intergalactic origin

  • solar radiation is significant during unpredictable and short lived solar flares and coronal mass ejections (CMEs).
  • galactic cosmic radiation (GCR) is omnipresent. The GCR intensity varies with latitude, longitude, and time of year due to effects of solar activity on the interplanetary magnetic field.

Space radiation collides with the nuclei of gases in the atmosphere, leading to a cascade of nuclear and electromagnetic reactions. The result is a complex shower of high energy radiation, the intensity and composition of which varies spatially and temporally.

predictive modelling of aviation radiation

Excessive exposure to radiation can damage DNA and lead to long-term health effects such as an increased risk of cancer.

Radiation levels at altitudes used by commercial aircraft are greater than at sea level due to cosmic rays. Aircrew are classified as radiation workers in some countries; however, planning to limit their exposure, and monitoring, is generally lacking.

Both real-time measurements and predictive modelling of radiation in the atmosphere are important to mitigate the radiation risk to assets and crew.

Amentum Aerospace has developed a RESTful API based on the PARMA and CARI7 parameterised models of GCR induced radiation in the atmosphere. The API provides radiation doses and other quantities on a particular date, latitude, longitude, and altitude.

usage


dose calculation

Understanding the effective dose to aircrew is important to ensuring their exposure does not exceed safe limits.

The example to the right shows the API called from Python code (see the validation section for more examples like this). Click the Play icon to run the code. The API returns the value and units of the dose rate in JSON format for the PARMA and CARI7 endpoints.

documentation

The API documentation is available here for the PARMA model and here for the CARI-7 model.

support

Please email if you have any questions.

differential intensity spectra

The radiation environment is often characterised by measuring the spectrum of energies of different particle types. Predictive models must be able to accurately reproduce these experimental measurements. The information is also important for atmospheric research.

The example to the right shows the API called using the CURL command line program. The API returns the energy differential intensity spectrum in JSON format as two arrays. The first array is the energy (in MeV); the second is the corresponding intensity (in /cm2/sr/MeV/s).

Terminal
curl -X GET "https://cosmicrays.amentum.space/parma/differential_intensity?altitude=10&latitude=34.4&longitude=180&year=1998&month=5&day=28&angle=0.5&particle=gamma" -H "accept: application/json"{
  {
    "energies": {
      "data": [
        0.01059253725177289,
        0.011885022274370187,
        0.013335214321633244,
        :
        8413.951416451862,
        9440.608762859129
      ],
      "units": "MeV"
    },
    "intensities": {
      "data": [
        0.022431196764976548,
        0.03818678678702315,
        0.06502678751397192,
        :
        1.1955713392470168e-08,
        9.228169660238456e-09
      ],
      "units": "/cm2/s/sr/Mev"
    }
  }