ECSS Space Environment — Reference Atmosphere Data (space-systems/ecss/e1004-ref-atmosphere)
Use when the task is an ECSS-E-ST-10-04C Annex G (informative) reference
atmosphere lookup -- deciding which published atmosphere model covers a
given celestial body, altitude, and analysis purpose, and confirming the
model's activity/trajectory inputs are on hand before it is run.
Domain quick reference
- Annex G points the engineer at external reference atmosphere models
rather than defining one: NRLMSISE-00 and JB-2006 are Earth
thermosphere/exosphere density models used for orbital drag and
lifetime analysis, each covering an altitude band and each needing
current solar-activity and geomagnetic-activity inputs to run.
JB-2006 is the higher-fidelity drag-focused option above its
altitude floor; NRLMSISE-00 covers a broader density-reference role
and a lower floor. GRAM-class models (Earth-GRAM, Mars-GRAM,
Venus-GRAM) give a full surface-to-orbit engineering profile for one
body, including trajectory-driven inputs (date, latitude,
longitude, altitude).
- A model only applies within its cataloged altitude range for its
body; a request outside every cataloged model's range for that body
has no coverage and must be flagged rather than silently answered
with the nearest model.
- Model selection follows the analysis purpose: drag prediction on
Earth prefers JB-2006 where its floor allows, falling back to
NRLMSISE-00 and then Earth-GRAM; a general density reference prefers
NRLMSISE-00, falling back to Earth-GRAM; a full-profile need (or any
non-Earth body, since JB-2006/NRLMSISE-00 are Earth-only) uses the
GRAM-class model for that body.
- A selected model is not actually runnable until every input it
requires (solar flux, geomagnetic index, epoch, or trajectory
position) is on record; a missing input is a finding against the
lookup, separate from the model-selection step itself.
- Earth altitude additionally classifies into an atmospheric regime
(troposphere, stratosphere, mesosphere, thermosphere, exosphere),
useful for scoping which phenomena (e.g. drag-relevant density vs.
launch-ascent aerodynamics) are in play at a given altitude.
Workflow
- Identify the target body and confirm it is one the catalog covers;
reject an unrecognized body before selecting a model for it.
- State the analysis purpose (drag prediction, density reference, or
full-profile engineering) and the altitude of interest; reject a
negative altitude or an unrecognized purpose.
- Select the model using the purpose-driven preference order for the
body, checking each candidate's altitude range in turn; if no
cataloged model for that body covers the altitude, flag a coverage
gap rather than forcing the nearest model.
- Once a model is selected, compare the inputs on hand against that
model's required-input set; flag each missing input by name.
- For Earth-altitude scoping, classify the altitude into its
atmospheric regime alongside the model selection.
- Aggregate the coverage and input findings for the lookup; the
lookup is not ready to hand to the model until both are empty.
Pitfalls
- Picking the nearest cataloged model when the requested altitude is
actually outside every model's range for that body -- that is a
coverage gap to report, not an approximation to make silently.
- Treating JB-2006 as available below its altitude floor just because
NRLMSISE-00 would be -- each model's range is independent and the
fallback order exists precisely because JB-2006 cannot cover that
band.
- Using an Earth-only model (NRLMSISE-00, JB-2006) for a non-Earth
body -- only the body's GRAM-class model applies there regardless of
purpose.
- Reading "a model was selected" as "the lookup is ready" -- a
selected model with missing required inputs (solar flux,
geomagnetic index, trajectory epoch/position) cannot actually be
run and must still be flagged.
Behavior contract (gate 3)
The model-range lookup, altitude-in-range check, body-to-model
mapping, purpose-driven selection, required-input gap check, and
altitude-regime classification are exercised by the gate 3 contract
test: scripts/test_e1004_ref_atmosphere.py against
scripts/e1004_ref_atmosphere_logic.py (stdlib unittest, offline). Run:
python3 scripts/test_e1004_ref_atmosphere.py
Compliance
- ECSS standards are freely downloadable (ESA); cite the source and
paraphrase per standards-map.yaml.
- compliance: STANDARDS-REF, gated: false.
1---2name: e1004-ref-atmosphere3description: "Use when determining which reference atmosphere model and4 inputs apply to a mission atmosphere lookup under ECSS-E-ST-10-04C Annex G:5 map the target body and altitude to the cataloged reference models6 (NRLMSISE-00, JB-2006, and GRAM-class planetary models), select the model7 that matches the analysis purpose (drag prediction, density reference, or8 full-profile engineering) while validating the altitude against that9 model's supported range, and verify every input the selected model needs10 (solar/geomagnetic activity or trajectory fields) is present before the11 model is run; also classifies an Earth altitude into its atmospheric12 regime for scoping. Trigger: ecss, e-st-10-04c, annex g, atmosphere model,13 nrlmsise-00, jb-2006, gram, planetary atmosphere, reference atmosphere,14 drag prediction."15license: Apache-2.016compliance: STANDARDS-REF17standards:18 - id: ecss19 reference-only: true20gated: false21domain: space-systems22pack: space-systems23compatibility: "agentskills.io SKILL.md; any SKILL.md host (Claude Code, Hermes, OpenClaw)"24metadata:25 source: https://skillmd.com/skills/ashfordeou/e1004-ref-atmosphere26 domain: space-systems27 subdomain: ecss28 tags: [ecss, e-st-10-04c, atmosphere, nrlmsise-00, jb-2006, gram, reference-atmosphere]29 version: 0.1.030 author: Aero Agent Skills31---3233# ECSS Space Environment — Reference Atmosphere Data (space-systems/ecss/e1004-ref-atmosphere)3435Use when the task is an ECSS-E-ST-10-04C Annex G (informative) reference36atmosphere lookup -- deciding which published atmosphere model covers a37given celestial body, altitude, and analysis purpose, and confirming the38model's activity/trajectory inputs are on hand before it is run.3940## Domain quick reference4142- Annex G points the engineer at external reference atmosphere models43 rather than defining one: NRLMSISE-00 and JB-2006 are Earth44 thermosphere/exosphere density models used for orbital drag and45 lifetime analysis, each covering an altitude band and each needing46 current solar-activity and geomagnetic-activity inputs to run.47 JB-2006 is the higher-fidelity drag-focused option above its48 altitude floor; NRLMSISE-00 covers a broader density-reference role49 and a lower floor. GRAM-class models (Earth-GRAM, Mars-GRAM,50 Venus-GRAM) give a full surface-to-orbit engineering profile for one51 body, including trajectory-driven inputs (date, latitude,52 longitude, altitude).53- A model only applies within its cataloged altitude range for its54 body; a request outside every cataloged model's range for that body55 has no coverage and must be flagged rather than silently answered56 with the nearest model.57- Model selection follows the analysis purpose: drag prediction on58 Earth prefers JB-2006 where its floor allows, falling back to59 NRLMSISE-00 and then Earth-GRAM; a general density reference prefers60 NRLMSISE-00, falling back to Earth-GRAM; a full-profile need (or any61 non-Earth body, since JB-2006/NRLMSISE-00 are Earth-only) uses the62 GRAM-class model for that body.63- A selected model is not actually runnable until every input it64 requires (solar flux, geomagnetic index, epoch, or trajectory65 position) is on record; a missing input is a finding against the66 lookup, separate from the model-selection step itself.67- Earth altitude additionally classifies into an atmospheric regime68 (troposphere, stratosphere, mesosphere, thermosphere, exosphere),69 useful for scoping which phenomena (e.g. drag-relevant density vs.70 launch-ascent aerodynamics) are in play at a given altitude.7172## Workflow73741. Identify the target body and confirm it is one the catalog covers;75 reject an unrecognized body before selecting a model for it.762. State the analysis purpose (drag prediction, density reference, or77 full-profile engineering) and the altitude of interest; reject a78 negative altitude or an unrecognized purpose.793. Select the model using the purpose-driven preference order for the80 body, checking each candidate's altitude range in turn; if no81 cataloged model for that body covers the altitude, flag a coverage82 gap rather than forcing the nearest model.834. Once a model is selected, compare the inputs on hand against that84 model's required-input set; flag each missing input by name.855. For Earth-altitude scoping, classify the altitude into its86 atmospheric regime alongside the model selection.876. Aggregate the coverage and input findings for the lookup; the88 lookup is not ready to hand to the model until both are empty.8990## Pitfalls9192- Picking the nearest cataloged model when the requested altitude is93 actually outside every model's range for that body -- that is a94 coverage gap to report, not an approximation to make silently.95- Treating JB-2006 as available below its altitude floor just because96 NRLMSISE-00 would be -- each model's range is independent and the97 fallback order exists precisely because JB-2006 cannot cover that98 band.99- Using an Earth-only model (NRLMSISE-00, JB-2006) for a non-Earth100 body -- only the body's GRAM-class model applies there regardless of101 purpose.102- Reading "a model was selected" as "the lookup is ready" -- a103 selected model with missing required inputs (solar flux,104 geomagnetic index, trajectory epoch/position) cannot actually be105 run and must still be flagged.106107## Behavior contract (gate 3)108109The model-range lookup, altitude-in-range check, body-to-model110mapping, purpose-driven selection, required-input gap check, and111altitude-regime classification are exercised by the gate 3 contract112test: scripts/test_e1004_ref_atmosphere.py against113scripts/e1004_ref_atmosphere_logic.py (stdlib unittest, offline). Run:114python3 scripts/test_e1004_ref_atmosphere.py115116## Compliance117118- ECSS standards are freely downloadable (ESA); cite the source and119 paraphrase per standards-map.yaml.120- compliance: STANDARDS-REF, gated: false.