Project APEX

by 434 Aerospace

Add Your Heading Text Here

Add Your Heading Text Here

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.

Save and Export 2

Export & Save Config

Save your work, share configurations, and export full results for analysis

Project APEX has no accounts and no server storage — but everything you need to save and reload your work is built into the toolbar. Configurations are stored as files on your computer, so you own your data completely.

Save & Load Config

Save Config

Click Save Config in the toolbar at any time. A .json file is downloaded to your computer containing every current parameter value. JSON format preserves all parameters exactly and is the recommended format for saving and sharing rocket configurations.

Tip: Save a config for each rocket you fly. Name the file with the rocket name and motor — e.g. Wildfire_J460T.json — so you can reload a past run in seconds.

Load Config

Click Load Config in the toolbar and select a previously saved .json or .csv config file. All parameters are populated immediately — no re-entry needed. The simulator automatically handles format differences between older and newer config versions.

Compatibility note: If you load a CSV config created with an older version that uses the finSweepLength key, the app will automatically convert it to the current finChordOffset key. No data is lost.

The CSV Template

Click Template in the toolbar to download a .csv file pre-filled with the current parameter values. This is useful if you prefer to edit parameters in a spreadsheet application before loading them back into the simulator.

The template includes inline comments (rows beginning with #) that explain each parameter, its units, and acceptable value ranges. Edit the values in your spreadsheet, save, and load the file back in using Load Config.

File type How to create it Best used for
.json — Config Click Save Config in the toolbar Saving and reloading complete rocket setups. Recommended format.
.csv — Template Click Template in the toolbar Editing parameters in Excel, batch preparation of multiple configs.

Exporting Results

After running a simulation, an Export CSV button appears in the toolbar. This downloads a full time-series CSV of the simulation run — every recorded timestep with all computed values.

Simulation results with Export CSV button visible in toolbar
After a successful simulation run — the Export CSV button appears in the toolbar alongside Save Config and Template

The exported CSV includes the following columns at each timestep:

Tip: Export CSVs from multiple motor or geometry configurations and compare them side-by-side in Excel. Each export is a complete snapshot — use it for design reviews, flight cards, or post-flight reporting.
Column Description
timeElapsed flight time (seconds)
altitudeAltitude above launch site (m or ft)
velocityTotal velocity (m/s or ft/s)
machMach number (dimensionless)
accelerationAxial acceleration (G)
dragTotal drag force (N or lbf)
thrustMotor thrust at this timestep (N or lbf)
cdTotal drag coefficient at this Mach
cp_posCentre of pressure from nose (cm or in)
cg_posCentre of gravity from nose (cm or in)
stabilityStability margin (calibers)
dyn_pressureDynamic pressure (Pa or lbf/ft²)
air_densityAir density at altitude (kg/m³ or slug/ft³)
Parameter Sweep 2

Parameter Sweep

Vary any single parameter across a range — see the full performance picture instantly

The Parameter Sweep tab lets you automatically run a full simulation across a range of values for any one parameter. Instead of manually re-running dozens of times and recording each result, the sweep gives you a complete chart of how apogee, velocity, Mach, and stability margin respond to the parameter — in a single click.

Parameter Sweep tab showing sweep results
Parameter Sweep — top chart shows apogee vs parameter value; bottom chart shows max velocity, max Mach, and stability margin across the same range
Setting Up a Sweep

  1. Navigate to the Sweep tab in the chart panel.
  2. Select the parameter you want to sweep from the dropdown — for example Fin Semi-Span, Launch Mass, Nosecone Shape, or Tip Chord Offset.
  3. Set the sweep range: enter a minimum value, a maximum value, and a number of steps. More steps gives a smoother curve at the cost of a slightly longer run time.
  4. Click Run Sweep. The simulator runs a complete RK4 simulation for every step in the range.
  5. The results charts update automatically showing performance across the full sweep range.
Tip: Start with a wide range and a low step count (10–15 steps) to see the overall shape, then narrow the range around the region of interest and increase steps for precision.
Reading Sweep Results

The sweep produces two charts stacked vertically:

Top chart — Apogee vs parameter value. The primary performance metric. Look for the peak of this curve to find the parameter value that maximises altitude, or look for the flat region that gives the most stable performance across manufacturing tolerances.

Bottom chart — Max velocity, max Mach, and stability margin. These three traces share the x-axis with the apogee chart, so any point on the x-axis corresponds directly across both charts. Hover over any point to see the exact values.

Stability margin: While sweeping to maximise apogee, keep an eye on the stability margin trace. A parameter value that produces high apogee but drops the stability margin below 1 caliber is not a safe design choice — the sweep makes this trade-off immediately visible.
Design optimisation example: Sweeping Fin Semi-Span from 50 mm to 150 mm shows exactly how fin size affects both apogee (drag penalty) and stability margin (CP shift). You can identify the minimum fin size that keeps the stability margin above your target — directly from the chart.
Flight Overlay 2

Flight Data Overlay

Load real altimeter data alongside the simulation to validate your model

One of the most powerful features of Project APEX is the ability to load real altimeter data from an actual flight alongside the simulation. This lets you see exactly how well the physics model predicts measured performance — and where to tune it.

Flight data overlay showing LR and HR altimeter traces
Flight data overlay — dashed lines show measured altitude and acceleration from the altimeter, overlaid directly on the simulation traces. The shaded region marks the motor burn phase.
Supported altimeters — v2025.04.1: The current version supports Featherweight Blue Raven altimeter CSV exports only. Support for additional altimeter brands (Raven, StratologgerCF, EasyMega, and others) is planned for future releases.
Loading Blue Raven Data

The Featherweight Blue Raven exports two types of CSV data files from its onboard logging. Both are loaded from the Flight Profile tab toolbar and can be used independently or together.

File type What it contains Toolbar button
LR CSV Low-rate barometric altitude and velocity data. Overlaid on the altitude and velocity charts in the Flight Profile tab. LR CSV
HR CSV High-rate IMU acceleration data. Overlaid on the acceleration chart. Higher noise than LR — use the Smooth toggle to filter. HR CSV
  1. Run a simulation first so the time axis is established.
  2. Navigate to the Flight Profile tab in the chart panel.
  3. Click LR CSV in the tab toolbar and select your Blue Raven low-rate export file.
  4. Click HR CSV and select your Blue Raven high-rate export file.
  5. The measured data traces appear as dashed lines overlaid on the simulation charts.
  6. Use the Trim to sim / Full flight toggle to either align the data window to the simulation, or view the full flight including recovery descent.
  7. Use the Raw / Smooth toggle on the velocity and acceleration traces to toggle noise filtering on the high-rate data.
Aerodynamics tab with real flight Cd scatter overlay
Aerodynamics tab with flight data loaded — yellow scatter points show Cd back-calculated from measured flight data, plotted directly against the model Cd curve for drag model validation

Calibrating Your Model

If the simulated apogee does not match the measured apogee from the overlay, the most likely cause is a difference between the modelled drag and the actual drag experienced in flight. You can correct this with the Cd Scale Factor.

  1. Load the LR CSV and observe how the simulated altitude trace compares to the measured trace.
  2. If the simulation overshoots (predicted apogee higher than actual), the model is under-predicting drag — increase the Cd Scale Factor above 1.0.
  3. If the simulation undershoots (predicted apogee lower than actual), the model is over-predicting drag — reduce the Cd Scale Factor below 1.0.
  4. Adjust in small increments (0.05 steps) and re-run the simulation until the traces align.
  5. Once calibrated, save the config with Save Config — the Cd Scale Factor is included in the saved file and will reload automatically for future flights on the same airframe.
What the Cd Scale Factor means: A value of 1.0 means the model's drag matches the prediction exactly. A value of 1.15 means the rocket experienced 15% more drag than the baseline model predicted — this can indicate surface roughness, fin attachment drag, or a payload bay with a less clean profile than the model assumes.

OpenRocket Cd Import

If you have an OpenRocket model of the same rocket, you can export its Mach vs Cd data and overlay it on the Aerodynamics tab for a direct model-to-model comparison. This is useful for cross-checking your Project APEX drag model against an existing OpenRocket build.

  1. In OpenRocket, run a simulation and export the Cd vs Mach data as a CSV (column headers: Mach, Total Cd).
  2. In Project APEX, navigate to the Aerodynamics tab in the chart panel.
  3. Click OR Cd CSV in the tab toolbar and select your OpenRocket export file.
  4. The OpenRocket Cd curve overlays on the Cd vs Mach chart in a contrasting colour for direct comparison.
Note: The overlay is for visual comparison only — it does not affect the simulation. Differences between the two curves reflect the different drag models used by each tool. Project APEX uses a 7-component breakdown (skin friction, base drag, nosecone wave drag, fin wave drag, fin pressure drag, fin interference, shoulder drag); OpenRocket uses its own component breakdown method.