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 parameterised model 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 annual limits imposed by regulatory organisations.

The example to the right shows the API called using the curl command. The particle type and the altitude and date of the calculation are specified. The API returns the value and units of the dose rate in JSON format.

Terminal
curl -X GET "https://cosmicrays.amentum.space/api/calculate_dose_rate?altitude=10&latitude=34.4&longitude=180&year=1998&month=5&day=28&particle=gamma" -H "accept: application/json"
{
  "dose rate": {
    "units": "uSv/hr",
    "value": 0.3267316594698155
  }
}
                  

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 left 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 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).

documentation

The API is auto-documentating thanks to the Open API specification, the docs are available here.

support

Feel free to email if you have any questions regarding the APIs or enterprise support plans.