Suspension Explorer is an open-core geometric constraint solver and interactive application for simulating and analyzing vehicle suspension kinematics. It can validate suspension geometry, solve coordinated bump, roll, and steering sweeps, calculate suspension metrics, and visualize the resulting motion.
The solver models ideal rigid parts and joints. It calculates geometry and motion; it is not a compliance, load, or structural analysis tool.
- App: edit a suspension definition, solve a sweep, and inspect its geometry and metrics in the browser.
suspension-explorer-core: the open-core Python solver, application API, and command-line interface.
Suspension Explorer currently supports double-wishbone and MacPherson strut geometry, as either individual corners or composed two-corner axles. Models can include rack steering or fixed toe links, direct or pushrod-rocker actuation, coilovers or torsion bars, anti-roll mechanisms, heave links, and outboard camber shims where applicable.
Calculated outputs include wheel travel, track, roadwheel angle, camber, caster, kingpin inclination, scrub radius, mechanical trail, instant-center geometry, roll center, heave, roll, anti-pitch geometry, mechanism travel, and applicable motion ratios and response derivatives.
Suspension Explorer uses the ISO 8855 vehicle coordinate system:
- Positive X points forwards.
- Positive Y points left.
- Positive Z points upwards.
- Authored hardpoints and linear outputs use millimeters.
- Angles use degrees in configuration and output.
The project is in an early, evolving stage. Bug reports, focused feature requests,
documentation fixes, and pull requests are welcome in the relevant repository.
For solver behaviour and data-model changes, start with
suspension-explorer-core.
