Skip to content

docs: state the 15 % fuel reserve and the mass-estimate iterations as the code runs them - #74

Merged
ramondalmau merged 2 commits into
devfrom
docs/fuel-reserve-15pct
Oct 21, 2026
Merged

ramondalmau merged 2 commits into
devfrom
docs/fuel-reserve-15pct

Conversation

@ramondalmau

Copy link
Copy Markdown
Collaborator

Docs only, no code change.

  • Fuel reserve in the initial mass estimate: the docs said about 3 % of trip fuel; the code uses
    15 % (DEFAULT_FUEL_RESERVE_FRACTION = 0.15, following Teoh et al. 2024).
  • Iterations: the docs said steps 2–4 run twice. The code runs one constant-mass BADA pass, then
    up to three passes from the updated TOW, and stops when the TOW changes by 1 % or less of the
    previous TOW (max_mass_estimation_iter = 4, max_rel_mass_diff = 0.01). The last pass is
    kept; a BADA 3 or altitude-fallback retry starts the estimate again.
  • Measured with the real code on the 4,303 computed NEATS_FINAL sample flights: 2,769 stop after
    two passes, 1,415 after three, 119 after four (3 of them at the cap with a change of 1.0–1.4 %).
  • Units audit updated (follow-up status table and Section 9).

Files: docs/explanation/input-prioritization.md, docs/explanation/mrv-specification.md,
docs/internal/pyneats_units_audit.md. Docs build checked.

ramondalmau and others added 2 commits October 21, 2026 10:27
input-prioritization.md and mrv-specification.md gave the fuel reserve of
the initial mass estimate as about 3 % of trip fuel. The code uses 15 %
(DEFAULT_FUEL_RESERVE_FRACTION = 0.15, following Teoh et al. 2024).

Records the item in the units audit (Section 9 and the follow-up status
table) and sets the I4 status row to #73.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The user docs said steps 2-4 of the mass estimate run twice. The code
runs one constant-mass BADA pass, then up to three passes from the
updated TOW, and stops when the TOW changes by 1 % or less of the
previous TOW (max_mass_estimation_iter = 4, max_rel_mass_diff = 0.01).
The last pass is kept; a BADA 3 or altitude-fallback retry starts the
estimate again.

Measured with the real code on the 4,303 computed NEATS_FINAL sample
flights: 2,769 stop after two passes, 1,415 after three, 119 after four
(3 of them at the cap with a change of 1.0-1.4 %). Recorded in the units
audit, Section 9.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ramondalmau
ramondalmau merged commit 5ed919e into dev Oct 21, 2026
5 checks passed
@ramondalmau
ramondalmau deleted the docs/fuel-reserve-15pct branch October 21, 2026 08:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant