AeroForge — Starship Aero & Aerothermal Toolkit
Overview
AeroForge — Delivery Package
Engineering-level aerodynamics & aerothermodynamics prediction toolkit for a two-stage Starship-class vehicle, subsonic → hypersonic. Dependency-free (Python standard library only), validated against published authoritative references.
Contents
user-guide.md— how an aero engineer uses the toolkit day-to-day.run-deploy-instructions.md— how to run locally and on a Linux/Unix CFD host.verification-report.md— the 59 validation checks and what each asserts.certification-report.md— honest certification + disclosed seams.release-notes.md— v1.0.0 summary.evidence/— machine-readable results (aerodb_ship.json,trajectory.json,
postflight_reconciliation.json, workflow-summary.md) and figures under evidence/screenshots/.
Headline results (reproducible)
| Result | Value | Source |
|---|---|---|
| Validation checks passing | 59 / 59 | verify.py → verification-report.json |
| Max relative error vs NACA 1135 | 3.5e-5 (37 reference points) | verification-report.json#/officialBenchmark |
| Watertight closure residual | ~0 vs 204 m² wetted area | evidence/workflow-summary.md |
| Representative entry max-q | 148.9 kPa at M≈15 | evidence/trajectory.json |
| Peak stagnation heat flux | 208.2 W/cm² | evidence/trajectory.json |
| Integrated heat load | 4.13 kJ/cm² | evidence/trajectory.json |
| Pre/post-flight reconciliation | R² = 0.998, 6/7 within 10% band | evidence/postflight_reconciliation.json |
All "post-flight" data is synthetic/representative (DISCLOSED_SEAM). This is a
lower-order engineering tool that brackets and feeds high-fidelity CFD; it does
not run a Navier-Stokes solver. Seecertification-report.md.
How to reproduce
py verify.py # 59/59 checks + benchmark
py scripts/run_workflow.py --vehicle ship # regenerate all evidence + figures