Config Spine Review

Run: vehicle_sizing

Commit: f3b78a75c0c2b91e920ee3d6da04c1b2146576d8

Targets: aero_report, performance_rollup

Tasks: 9

Analysis graph

flowchart LR
    subgraph cycle0 ["iterate: tol=0.5 max=25 relax=1.0"]
        propulsion[propulsion]
        trajectory[trajectory]
    end
    subgraph cycle1 ["iterate: tol=0.01 max=25 relax=0.9"]
        thermal[thermal]
        vehicle_structures[vehicle_structures]
    end
    aero_report[aero_report]
    gnc_margins[gnc_margins]
    mass_properties[mass_properties]
    performance_rollup[performance_rollup]
    vehicle_aero[vehicle_aero]
    vehicle_aero -->|DragAreaTable| aero_report
    gnc_margins -->|ControlMargin| performance_rollup
    propulsion -->|Mass| mass_properties
    mass_properties -->|InertiaTensor| gnc_margins
    propulsion -->|EnginePerformance| trajectory
    vehicle_structures -->|Mass| mass_properties
    vehicle_structures -->|StructureLayout| thermal
    thermal -->|Mass| vehicle_structures
    mass_properties -->|Mass| performance_rollup
    thermal -->|Mass| mass_properties
    trajectory -->|TrajectorySummary| propulsion
    trajectory -->|TrajectorySummary| vehicle_structures
    vehicle_aero -->|DragTable| trajectory

    classDef provOk fill:#d4edda,stroke:#28a745,color:#155724
    classDef provFailed fill:#f8d7da,stroke:#dc3545,color:#721c24
    classDef provNotRun fill:#e9ecef,stroke:#6c757d,color:#495057,stroke-dasharray: 5 5
    class aero_report,gnc_margins,mass_properties,performance_rollup,propulsion,thermal,trajectory,vehicle_aero,vehicle_structures provOk

N×N Design Structure Matrix

Above diagonal: feed-forward · Below diagonal: feedback · External column: file-bound inputs · Amber outline: draft (machine-proposed, unconfirmed) · NASA/TM-1999-209877

From → To External vehicle_aero aero_report propulsion trajectory thermal vehicle_structures mass_properties gnc_margins performance_rollup
vehicle_aero vehicle_team VehicleGeometry vehicle_aero ok DragAreaTable DragTable
aero_report vehicle_team aero_report ok
propulsion vehicle_team EngineSpec propulsion 9 iter EnginePerformance cycle0 Mass
trajectory vehicle_team trajectory 9 iter TrajectorySummary
thermal vehicle_team thermal 5 iter Mass cycle1 Mass
vehicle_structures vehicle_team VehicleGeometry vehicle_structures 5 iter Mass
mass_properties vehicle_team MassTable, VehicleGeometry mass_properties ok InertiaTensor Mass
gnc_margins vehicle_team gnc_margins ok ControlMargin
performance_rollup vehicle_team performance_rollup ok

Run provenance

Status: ok

Git commit: f3b78a75c0c2b91e920ee3d6da04c1b2146576d8

Provenance dir: outputs/vehicle_sizing/provenance

AnalysisStatusError
aero_reportok
gnc_marginsok
mass_propertiesok
performance_rollupok
propulsionok (9 iteration(s))
thermalok (5 iteration(s))
trajectoryok (9 iteration(s))
vehicle_aerook
vehicle_structuresok (5 iteration(s))

Convergence

Cycle: propulsion, trajectory

converged — tolerance 0.5, max_iterations 25, relaxation 1.0, acceleration none

3.06e+04 0.163 2 9 iteration residual (log)
IterationMetricResidualMember max |Δ|
1283572
231417030598propulsion: 231.3, trajectory: 3.06e+04
33195715401.16propulsion: 40.83, trajectory: 5401
4320524953.41propulsion: 7.208, trajectory: 953.4
5320693168.296propulsion: 1.272, trajectory: 168.3
632072229.7075propulsion: 0.2246, trajectory: 29.71
73207285.24396propulsion: 0.03964, trajectory: 5.244
83207290.925662propulsion: 0.006998, trajectory: 0.9257
93207290.163398propulsion: 0.001235, trajectory: 0.1634

Cycle: thermal, vehicle_structures

converged — tolerance 0.01, max_iterations 25, relaxation 0.9, acceleration none

1.38 0.00145 2 5 iteration residual (log)
IterationMetricResidualMember max |Δ|
1764.575
2765.9511.37623thermal: 1.376, vehicle_structures: 68.81
3766.0910.140101thermal: 0.1401, vehicle_structures: 7.005
4766.1050.0142622thermal: 0.01426, vehicle_structures: 0.7131
5766.1070.0014519thermal: 0.001452, vehicle_structures: 0.07259

Margins

RequirementApplies toValue LimitMarginStatusOwners
REQ-GLOW-001performance_rollup.vehicle_performance/gross_mass_kg18447.1 kgmax 20000+8.4%passvehicle_team
REQ-PROP-001trajectory.trajectory_summary/required_propellant_lbm145480 kgmax 160000+10.0%passvehicle_team

Change history

projects/vehicle_sizing/examples/vehicle/engine_spec.yaml

CommitDateAuthorChanges
74578415902026-07-25T22:43:36+10:00David Prime/artifact_type added = 'EngineSpec'
/data added = {'vacuum_thrust_n': 1000000.0, 'specific_impulse_s': 300.0, 'engine_dry_mass_kg': 1500.0}

projects/vehicle_sizing/examples/vehicle/vehicle_geometry.yaml

CommitDateAuthorChanges
74578415902026-07-25T22:43:36+10:00David Prime/artifact_type added = 'VehicleGeometry'
/data added = {'diameter_m': 3.0, 'length_m': 30.0, 'reference_area_m2': 7.0686}

Execution layers

#Step
1vehicle_aero
2aero_report
2cycle: propulsion <-> trajectory | converge trajectory.trajectory_summary/required_propellant_lbm tol=0.5 max_iter=25 relax=1.0
3cycle: thermal <-> vehicle_structures | converge thermal.tps_mass tol=0.01 max_iter=25 relax=0.9
4mass_properties
5gnc_margins
6performance_rollup

Port-level data flow

ProducerConsumerArtifact MappingSource file
vehicle_aero.drag_area_tableaero_report.drag_profileDragAreaTableaero_to_report_drag_profileprojects/vehicle_sizing/mappings/aero_to_report_drag_profile.yaml
gnc_margins.control_marginperformance_rollup.control_marginControlMargincontrol_margin_to_rolluplib/mappings/control_margin_to_rollup.yaml
propulsion.engine_massmass_properties.component_massesMassengine_mass_to_mass_propertiesprojects/vehicle_sizing/mappings/engine_mass_to_mass_properties.yaml
mass_properties.inertia_tensorgnc_margins.inertia_tensorInertiaTensorinertia_to_gncprojects/vehicle_sizing/mappings/inertia_to_gnc.yaml
propulsion.engine_performancetrajectory.engine_performanceEnginePerformancepropulsion_to_trajectoryprojects/vehicle_sizing/mappings/propulsion_to_trajectory.yaml
vehicle_structures.structure_massmass_properties.component_massesMassstructure_mass_to_mass_propertiesprojects/vehicle_sizing/mappings/structure_mass_to_mass_properties.yaml
vehicle_structures.structure_layoutthermal.structure_layoutStructureLayoutstructures_to_thermalprojects/vehicle_sizing/mappings/structures_to_thermal.yaml
thermal.tps_massvehicle_structures.tps_massMassthermal_to_structures_feedbackprojects/vehicle_sizing/mappings/thermal_to_structures_feedback.yaml
mass_properties.total_massperformance_rollup.total_massMasstotal_mass_to_rolluplib/mappings/total_mass_to_rollup.yaml
thermal.tps_massmass_properties.component_massesMasstps_mass_to_mass_propertiesprojects/vehicle_sizing/mappings/tps_mass_to_mass_properties.yaml
trajectory.trajectory_summarypropulsion.required_propellantTrajectorySummarytrajectory_to_propulsion_feedbackprojects/vehicle_sizing/mappings/trajectory_to_propulsion_feedback.yaml
trajectory.trajectory_summaryvehicle_structures.max_qTrajectorySummarytrajectory_to_structures_max_qprojects/vehicle_sizing/mappings/trajectory_to_structures_max_q.yaml
vehicle_aero.drag_tabletrajectory.drag_tableDragTablevehicle_aero_to_trajectoryprojects/vehicle_sizing/mappings/vehicle_aero_to_trajectory.yaml

External inputs

PortFile
mass_properties.fixed_massesprojects/vehicle_sizing/examples/vehicle/data/vehicle_fixed_masses.csv
mass_properties.geometryprojects/vehicle_sizing/examples/vehicle/vehicle_geometry.yaml
propulsion.engine_specprojects/vehicle_sizing/examples/vehicle/engine_spec.yaml
vehicle_aero.geometryprojects/vehicle_sizing/examples/vehicle/vehicle_geometry.yaml
vehicle_structures.geometryprojects/vehicle_sizing/examples/vehicle/vehicle_geometry.yaml

Source files

Analyses

Mappings