radiation.space
Wiki contents

Precomputed tables

Some of the physics needs tools that will not run in a browser. Those parts are computed ahead of time, checked in, and tracked by hash.

Why there are tables

Two pieces of the model depend on heavy tools.

Neither can run in a browser, and neither needs to run more than once. So their results are computed by the Python reference engine and stored as tables. The browser model does everything else itself.

The 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 and 30 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.pyNumPy361 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

Each table has a recorded SHA-256. A check fails if a table no longer matches its record, which catches both a rebuild that was not written down and an edit by hand.

What the browser cannot do, as a result

Rebuilding

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 themselves are rebuilt with engine/scripts/build_shield_matrices.py; the engine's Geant4 notes explain the setup.

Two engines, one answer

The Python engine is the reference: it is the one compared with measurements on the validation page. The browser model is a port of it, held to it by tests that compare integral fluxes and doses for a set of scenarios, to 5 % in free space and 6 % behind a wall.

Page status: draft, updated 2026-11-15. radiation.space 0.1.0 (3bb1861af578).
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.