radiation.space
Wiki contents

Precomputed tables

Inputs computed offline with IRBEM and Geant4, checked in with recorded hashes.

Purpose

Two model inputs require tools that do not run in a browser:

These are computed once by the Python reference engine and stored as tables; the browser model computes everything else.

Tables

FileWhat it holdsProduced byToolsSize
data/orbit_data.jsonOrbit-averaged AP8/AE8 trapped proton and electron spectra (solar minimum and maximum, with and without the low-orbit proton correction), and the sampling of McIlwain L and magnetic latitude along each of 68 orbits: 13 altitudes by 5 inclinations, plus GEO, Molniya and GTO.engine/scripts/build_orbit_data.pySpacePy 0.7 (IRBEM: AP8/AE8, IGRF)512 kB
data/shield_data.jsonGeant4 response matrices of a spherical aluminum shell at 0.3, 1, 3, 10, 30, 60 and 100 g/cm², packed for the browser (5 output bins per decade, 0.06 dex steps), with water stopping powers and the neutron and photon dose coefficients.engine/scripts/build_shield_data.pyNumPy487 kB
data/trapped.jsonAP8/AE8 equatorial flux against L, and its dependence on B/B0, in three energy bands per species and for solar minimum and maximum. It places the radiation-belt tracers and the local readouts of the 3D explorer.engine/scripts/build_trapped_data.pySpacePy 0.7 (IRBEM: AP8/AE8, IGRF)54 kB
engine/spacerad/data/phi_usoskin2017_monthly.csvMonthly solar modulation potential, 1951 to 2016, in MV.Transcribed from Usoskin et al. (2017), Table 2 (reference usoskin_2017).none4 kB
engine/spacerad/data/shield/Al_0.3gcm2.npzResponse matrices of a spherical aluminum shell of 0.3 g/cm²: what an isotropic field outside becomes inside, by incident species and energy.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.3284 kB
engine/spacerad/data/shield/Al_10gcm2.npzResponse matrices of a spherical aluminum shell of 10 g/cm²: what an isotropic field outside becomes inside, by incident species and energy.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.3333 kB
engine/spacerad/data/shield/Al_1gcm2.npzResponse matrices of a spherical aluminum shell of 1 g/cm²: what an isotropic field outside becomes inside, by incident species and energy.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.3320 kB
engine/spacerad/data/shield/Al_30gcm2.npzResponse matrices of a spherical aluminum shell of 30 g/cm²: what an isotropic field outside becomes inside, by incident species and energy.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.3321 kB
engine/spacerad/data/shield/Al_3gcm2.npzResponse matrices of a spherical aluminum shell of 3 g/cm²: what an isotropic field outside becomes inside, by incident species and energy.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.3335 kB
engine/spacerad/data/shield/neutral_dose.npzMean dose and dose equivalent in a water sphere of 15 cm radius per unit fluence of neutrons and photons.engine/scripts/build_neutral_dose.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.35 kB
engine/spacerad/data/shield/stopping.npzStopping powers of water and silicon by particle species, from Geant4: the basis of the charged-particle dose estimate.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.378 kB
engine/spacerad/data/shield/Al_60gcm2.npzResponse matrices of a spherical aluminum shell of 60 g/cm²: what an isotropic field outside becomes inside, by incident species and energy.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.3315 kB
engine/spacerad/data/shield/Al_100gcm2.npzResponse matrices of a spherical aluminum shell of 100 g/cm²: what an isotropic field outside becomes inside, by incident species and energy.engine/scripts/build_shield_matrices.pyGeant4 11.4.1 (QBBC physics list, 0.1 mm production cut) through geant4_pybind 0.1.3291 kB

Each table has a recorded SHA-256; a check fails if a table differs from its record, whether from an unrecorded rebuild or a manual edit.

Consequences for the browser model

Regeneration

From the repository root, with the Python engine installed:

python engine/scripts/build_orbit_data.py       about 2 minutes; needs SpacePy (IRBEM)
python engine/scripts/build_trapped_data.py     needs SpacePy (IRBEM)
python engine/scripts/build_shield_data.py      repacks the Geant4 matrices for the browser
node tools/data-manifest.mjs --write            records the new hashes
python engine/scripts/build_parity_fixture.py   refreshes the reference values for the parity tests
npm test

The Geant4 matrices are rebuilt with engine/scripts/build_shield_matrices.py; setup is described in the engine's Geant4 notes.

Reference and browser implementations

The Python engine is the reference and is compared with measurements in validation. The browser model is a port, tested against the reference engine on integral fluxes and doses to 5 % in free space and 6 % behind a wall.

Page status: draft, updated 2026-11-16. radiation.space 0.1.0 (e1a50c428882).
These are estimates for learning and early trade studies. They are not a substitute for a mission radiation analysis, and nothing here is medical advice.
Developed and hosted by Such Software.