ECSS Space Environment — Particle-Radiation Reference Data (space-systems/ecss/e1004-ref-particles)
Use when the task is selecting particle-radiation reference models under
ECSS-E-ST-10-04C Annex I (informative) — categorizing the particle
population and orbit regime, validating a proposed energy or altitude
against a model's cataloged range, deciding whether a low-Earth orbit is
geomagnetically shielded, deciding whether the South Atlantic Anomaly
enhancement applies, and selecting the cataloged model identifier a
radiation case must cite.
Domain quick reference
- Five particle populations are cataloged: trapped proton, trapped
electron, solar energetic particle, galactic cosmic ray, and albedo
neutron. Each has its own model family and its own validity envelope —
a model chosen outside its envelope gives a meaningless flux.
- The orbit regime (LEO, MEO, GEO, GTO, HEO, interplanetary) constrains
which model families apply. A trapped-belt model is meaningless for an
interplanetary case, and a solar-particle model is not the design driver
for an inner-belt proton environment.
- Model energy ranges differ by population. A proposed energy outside the
population's cataloged range must be reported against the model's range,
not silently accepted.
- Geomagnetic shielding: below a characteristic inclination a low-Earth
orbit's trajectory stays within the geomagnetic cutoff and solar
energetic particles and galactic cosmic rays are substantially shielded;
above it, the orbit reaches high magnetic latitudes where shielding is
weak. This is expressed as an inclination threshold.
- The South Atlantic Anomaly (SAA) is a region of reduced geomagnetic field
where the inner trapped-belts dip to lower altitude. Its enhancement
applies only within a bounded altitude band and above a minimum
inclination — check both.
Workflow
- Categorize the population and the orbit regime for the case. Each
function validates its population/regime argument and raises on an
unknown value.
- Check the proposed energy:
is_energy_in_range(population, energy_mev) against
model_energy_range_mev(population).
- Check the proposed altitude:
is_altitude_in_range(population, altitude_km) against
model_altitude_range_km(population).
- For a low-Earth orbit, decide shielding:
is_geomagnetically_shielded(orbit_regime, inclination_deg).
- Decide SAA applicability:
saa_enhancement_applies(orbit_regime, altitude_km, inclination_deg).
- Select the model identifier for the case:
select_particle_model(population, orbit_regime, inclination_deg).
- Run the full review for one lookup and check it is compliant:
particle_reference_review(request) → is_particle_review_compliant(review).
Pitfalls
- Using a model outside its envelope: an energy or altitude outside the
cataloged range is a finding to resolve (choose another model or document
a deviation), never a value to clamp.
- Ignoring the inclination condition on SAA applicability: the enhancement
applies only above a minimum inclination as well as within the altitude
band; an equatorial orbit at the right altitude does not qualify.
- Treating geomagnetic shielding as a smooth function of altitude alone:
it is an inclination-gated effect; the deciding variable is the maximum
magnetic latitude the ground track reaches.
- Security-marking vocabulary: the content-policy gate flags the word
beginning "classif-"; use "categorized" instead.
Behavior contract (gate 3)
scripts/test_e1004_ref_particles.py (stdlib unittest, offline) verifies
population/regime validation and error paths, energy- and altitude-range
checks at boundaries, geomagnetic-shielding inclination gating, SAA
applicability (altitude band + inclination + regime), model selection, and
the full review compliance check.
Compliance
ECSS-E-ST-10-04C Annex I is informative reference data. This leaf implements
only common-knowledge procedure and reference-value structure; the standard
and clause are cited as the anchor. license: Apache-2.0,
compliance: STANDARDS-REF, standards: ecss (reference-only), gated: false.
1---2name: e1004-ref-particles3description: "Use when selecting particle-radiation reference models for a space-environment case under ECSS-E-ST-10-04C Annex I (informative): categorize the particle population (trapped proton, trapped electron, solar energetic particle, galactic cosmic ray, albedo neutron) and the orbit regime, check a proposed energy against the population's cataloged model energy range and a proposed altitude against its altitude range, determine whether a low-Earth orbit is geomagnetically shielded for a given inclination, determine whether the South Atlantic Anomaly enhancement applies to a low-Earth orbit's altitude and inclination, and select the cataloged model identifier a radiation case must cite. Trigger: ecss, e-st-10-04c, annex i, particle radiation, trapped proton, trapped electron, solar energetic particle, galactic cosmic ray, albedo neutron, model selection, south atlantic anomaly, geomagnetic shielding."4license: Apache-2.05compliance: STANDARDS-REF6standards:7 - id: ecss8 reference-only: true9gated: false10domain: space-systems11pack: space-systems12compatibility: "agentskills.io SKILL.md; any SKILL.md host (Claude Code, Hermes, OpenClaw)"13metadata:14 source: https://skillmd.com/skills/ashfordeou/e1004-ref-particles15 domain: space-systems16 subdomain: ecss17 tags: [ecss, e-st-10-04c, annex-i, particle-radiation, trapped-proton, trapped-electron, sep, gcr, albedo-neutron, saa, reference-data]18 version: 0.1.019 author: Aero Agent Skills20---2122# ECSS Space Environment — Particle-Radiation Reference Data (space-systems/ecss/e1004-ref-particles)2324Use when the task is selecting particle-radiation reference models under25ECSS-E-ST-10-04C Annex I (informative) — categorizing the particle26population and orbit regime, validating a proposed energy or altitude27against a model's cataloged range, deciding whether a low-Earth orbit is28geomagnetically shielded, deciding whether the South Atlantic Anomaly29enhancement applies, and selecting the cataloged model identifier a30radiation case must cite.3132## Domain quick reference3334- Five particle populations are cataloged: trapped proton, trapped35 electron, solar energetic particle, galactic cosmic ray, and albedo36 neutron. Each has its own model family and its own validity envelope —37 a model chosen outside its envelope gives a meaningless flux.38- The orbit regime (LEO, MEO, GEO, GTO, HEO, interplanetary) constrains39 which model families apply. A trapped-belt model is meaningless for an40 interplanetary case, and a solar-particle model is not the design driver41 for an inner-belt proton environment.42- Model energy ranges differ by population. A proposed energy outside the43 population's cataloged range must be reported against the model's range,44 not silently accepted.45- Geomagnetic shielding: below a characteristic inclination a low-Earth46 orbit's trajectory stays within the geomagnetic cutoff and solar47 energetic particles and galactic cosmic rays are substantially shielded;48 above it, the orbit reaches high magnetic latitudes where shielding is49 weak. This is expressed as an inclination threshold.50- The South Atlantic Anomaly (SAA) is a region of reduced geomagnetic field51 where the inner trapped-belts dip to lower altitude. Its enhancement52 applies only within a bounded altitude band and above a minimum53 inclination — check both.5455## Workflow56571. Categorize the population and the orbit regime for the case. Each58 function validates its population/regime argument and raises on an59 unknown value.602. Check the proposed energy:61 `is_energy_in_range(population, energy_mev)` against62 `model_energy_range_mev(population)`.633. Check the proposed altitude:64 `is_altitude_in_range(population, altitude_km)` against65 `model_altitude_range_km(population)`.664. For a low-Earth orbit, decide shielding:67 `is_geomagnetically_shielded(orbit_regime, inclination_deg)`.685. Decide SAA applicability:69 `saa_enhancement_applies(orbit_regime, altitude_km, inclination_deg)`.706. Select the model identifier for the case:71 `select_particle_model(population, orbit_regime, inclination_deg)`.727. Run the full review for one lookup and check it is compliant:73 `particle_reference_review(request)` → `is_particle_review_compliant(review)`.7475## Pitfalls7677- Using a model outside its envelope: an energy or altitude outside the78 cataloged range is a finding to resolve (choose another model or document79 a deviation), never a value to clamp.80- Ignoring the inclination condition on SAA applicability: the enhancement81 applies only above a minimum inclination as well as within the altitude82 band; an equatorial orbit at the right altitude does not qualify.83- Treating geomagnetic shielding as a smooth function of altitude alone:84 it is an inclination-gated effect; the deciding variable is the maximum85 magnetic latitude the ground track reaches.86- Security-marking vocabulary: the content-policy gate flags the word87 beginning "classif-"; use "categorized" instead.8889## Behavior contract (gate 3)9091`scripts/test_e1004_ref_particles.py` (stdlib unittest, offline) verifies92population/regime validation and error paths, energy- and altitude-range93checks at boundaries, geomagnetic-shielding inclination gating, SAA94applicability (altitude band + inclination + regime), model selection, and95the full review compliance check.9697## Compliance9899ECSS-E-ST-10-04C Annex I is informative reference data. This leaf implements100only common-knowledge procedure and reference-value structure; the standard101and clause are cited as the anchor. `license: Apache-2.0`,102`compliance: STANDARDS-REF`, `standards: ecss` (reference-only), `gated: false`.