Fusion Space
Docs

Documentation

How Loft computes what it shows, where the model is weak, and how its accuracy is measured. The repository is open — the math here is meant to be checked, not trusted.

Validation

Trust in a simulator comes from checkable outputs, not from who wrote it. Loft is validated two ways: against first-principles physics, and against OpenRocket's own stored results.

Against physics (the test suite)

The engine's core is checked in the test suite (lib/**/*.test.ts, run in CI on every change):

Against OpenRocket (the free oracle)

A .orkyou simulated in OpenRocket carries OpenRocket's own stored flight results. When you import such a file, Loft flies it under the same stored launch conditions and diffs each metric — apogee, velocity, Mach, timings — reporting the signed error and the mean absolute percentage error (MAPE). That comparison appears right in the results, and the method is in lib/validation/compare.ts.

The honest oracle is your own design. The two bundled samples below ship with author-estimated stored figures (Loft can't run OpenRocket here), so their comparison is a demonstration of the mechanism, not an accuracy claim. Import a real file for a real check.

Bundled sample comparisons

Computed at build time from the committed fixtures — these numbers are always current with the engine. “Stored” is the fixture's author-estimated figure; “Loft” is this engine's output.

Loft Demo 38mm — single deploy — mean abs. error 27%

MetricStored (est.)LoftΔ
Apogee980 m1,182.2 m+21%
Max velocity190 m/s211.8 m/s+11%
Max acceleration238 m/s²234.5 m/s²-1%
Max Mach0.55 0.62 +13%
Time to apogee12.4 s14.3 s+15%
Flight time122 s180 s+48%
Ground-hit velocity4.7 m/s7.2 m/s+54%
Rail-exit velocity19.4 m/s23.7 m/s+22%
Deployment velocity3.2 m/s1.1 m/s-65%
Optimum delay11.1 s13 s+17%

Loft Demo 54mm — dual deploy — mean abs. error 22%

MetricStored (est.)LoftΔ
Apogee2,250 m2,994.9 m+33%
Max velocity305 m/s436.8 m/s+43%
Max acceleration208 m/s²280.9 m/s²+35%
Max Mach0.89 1.29 +45%
Time to apogee20.2 s20.9 s+3%
Flight time214 s218.3 s+2%
Ground-hit velocity5.6 m/s6.1 m/s+8%
Rail-exit velocity26.2 m/s29.1 m/s+11%
Deployment velocity4 m/s2.6 m/s-34%
Optimum delay17.3 s17.5 s+1%

Community validation cases

Over time the most valuable record is predicted-vs-actual: Loft's prediction against a real recorded flight (an altimeter apogee, a tracked descent). If you've flown a design you're willing to share, open an issue with the .ork, the motor, and the measured result — verified cases will be collected here as an ongoing accuracy record. Until then, this page is honest about being early.

See also the limitations log for where to expect the largest differences.