Suspension¶

The Suspension page configures all spring, damper, bump stop, and anti-roll bar components for your vehicle. The suspension is modular — each subsystem is an independent library component that can be saved, loaded, and shared separately.
Component Structure¶
The suspension system is organized per axle (front and rear), with each axle containing corner components (left and right) and optional shared components.
graph TD
SUSP["<b>Suspension</b><br/><i>Front + Rear axles</i>"]
SPR["<b>Springs</b><br/><i>Linear or Torsion Bar</i>"]
DMP["<b>Dampers</b><br/><i>Damping coefficient</i>"]
ARB["<b>Anti-Roll Bar</b><br/><i>Roll stiffness</i>"]
BS["<b>Bump Stops</b><br/><i>Progressive spring + damping</i>"]
HS["<b>Heave System</b><br/><i>3rd spring, damper, bumpstop</i>"]
SUSP --> SPR
SUSP --> DMP
SUSP --> ARB
SUSP --> BS
SUSP --> HS
style SUSP fill:#6366f1,color:#fff
style SPR fill:#ef4444,color:#fff
style DMP fill:#10b981,color:#fff
style ARB fill:#f59e0b,color:#fff
style BS fill:#8b5cf6,color:#fff
style HS fill:#64748b,color:#fff
Not all components are required. ARBs, bump stops, and heave systems are optional and toggled per axle.
Page Layout¶

The Suspension page uses a tabbed layout to organize subsystems:
| Tab | Contents |
|---|---|
| Springs | Corner springs (left/right) and optional heave springs |
| Dampers | Corner dampers (left/right) and optional heave dampers |
| ARBs | Anti-roll bars (one per axle, optional) |
| Bump Stops | Corner bump stops (left/right) and optional heave bump stops |
Each tab shows both the front and rear axle side by side. Within each axle, left and right corners are displayed as separate fieldsets.
Axle and Corner Structure¶
Each axle (front and rear) has:
- Left corner — independent spring, damper, and optional bump stop
- Right corner — independent spring, damper, and optional bump stop
- Shared components — ARB and heave system apply to the full axle
Symmetry Toggles¶
Each component type has a symmetry toggle per axle. When symmetry is enabled, left-side values are automatically mirrored to the right side. This is the default for most setups.
Symmetry
Use symmetry for symmetric setups (most production and race cars). Disable symmetry only when you need deliberately different left/right settings, such as oval-track configurations.
Heave System¶
The heave system is an optional subsystem toggled independently for each axle. When enabled, it adds:
- Heave spring — a third spring acting on average wheel displacement
- Heave damper — a third damper acting on average wheel velocity
- Heave bump stop — a bump stop on the heave system
Heave systems are commonly used in Formula-style cars and prototypes to control pitch and heave independently from roll. Geometry-driven heave systems require the relevant heave pickup points to be defined in Kinematics. For T-bar heave systems, define the heave spring body point, T-bar arm point, and the two T-bar centre points that describe the pivot axis.
Suspension Metrics Panel¶

The right-hand column of the Suspension page displays a Suspension Metrics panel that calculates and shows derived vehicle properties based on your current suspension configuration. These metrics update automatically when you save changes.
Units
Rates, roll rates and critical damping are shown in the units their setup fields are entered in: the front spring rate, ARB stiffness and damper. The Units button at the top right of the panel picks a unit per quantity instead, or switches everything to metric or imperial. The choice is saved for your account.
Balance¶
- Mechanical Balance — front/rear distribution of roll stiffness accounting for both suspension and tyre contributions. A balanced setup (45–55%) promotes neutral handling; front-biased can cause understeer on corner entry, rear-biased can cause oversteer.
- Roll Stiffness Distribution — front/rear split of suspension roll stiffness alone.
- Tyre Roll Distribution — front/rear split of tyre roll stiffness.
Motion Ratio Analysis¶
Displays the spring (or torsion bar), damper and ARB motion ratios for front and rear axles, with a red dot on the spring and damper when the ratio is Low or High (none when it is in range; hover it for which). A torsion bar's good range depends on the bar's own rate, and an ARB's ratio on its geometry; the bar's effect is judged by the roll stiffness distribution. Spring and damper ratios are the axle's (one ratio for both sides), at its static ride height; the ARB ratio is read with the body upright. See How the metrics are calculated.
Stiffness¶
- Wheel Rate (per wheel) — stiffness of one corner's suspension at the wheel, at static ride height, accounting for the motion ratio. Not the axle total.
- Roll Rates — front and rear roll rates (Nm/deg), the angular stiffness of each axle in roll including springs and anti-roll bars.
- Tyre Rate (per wheel) — the tyre's vertical stiffness at its static load, camber and pressure.
- Ride Rate (per wheel) — the wheel rate in series with the tyre, which determines the vehicle's dynamic response and ride frequencies.
Frequency Analysis¶
- Sprung Mass Frequencies — natural frequencies of the body (front and rear).
- Ride Frequencies — natural frequencies including tyre compliance.
- Wheel Hop Frequencies — unsprung mass natural frequencies.
Damping Analysis¶
- Sprung Mass Damping Ratio — ratio of actual damping to critical damping for the body. Typical ranges: about 0.2–0.4 for ride comfort, 0.5–0.8 for performance.
- Wheel Hop Damping Ratio — damping ratio for unsprung mass oscillations.
- Critical Damping (C_crit, per wheel) — the damping at the wheel that would make one corner critically damped ($zeta = 1$). Compare it with a damper's coefficient referred to the wheel, not with the damper's own coefficient.
See How the metrics are calculated for the formulas.
How the metrics are calculated¶
Rates, damping and frequencies are evaluated at static ride height, per wheel, as the mean of the left and right corners. Roll rates are axle totals, read with the body upright; the mechanical balance is the front share of the elastic roll stiffness (springs and anti-roll bars, with the tyres in series) — the rMechBal channel. The lateral load transfer distribution, which also includes geometric and unsprung transfer, is the separate rLLTBal channel. Motion ratios follow the Kinematics convention, component travel over wheel travel:
A torsion bar's ratio is its twist per metre of wheel travel, in rad/m, so $k_w = k_theta dot "MR"^2$ with $k_theta$ the bar's rate in Nm/rad (1 rad/m = 0.0573 °/mm; the sign is only the direction the rocker turns). The ARB's ratio is bar twist per radian of body roll, read upright, and the bar adds $k_"bar" dot "MR"_"arb"^2$ to the axle's roll rate:
Wheel rate (per wheel). The spring rate referred to the wheel, plus any bump stop in contact and half of any heave spring and heave bump stop:
The axle's vertical stiffness is $2 k_w$. With an installation stiffness $k_"inst"$ set on the chassis, $k_w$ is in series with $k_"inst" \/ 2$.
Ride rate (per wheel). The wheel rate in series with the tyre rate $k_t$:
Damping at the wheel (per wheel). A damper strokes at $v_d = "MR"_d dot v_w$, and its force reaches the wheel multiplied by $"MR"_d$ again, so it picks up the same squared ratio as a spring:
$c_"damper"$ is the damper's coefficient, or the least-squares slope of its force–velocity map. Heave dampers are not included, so on a car with one the sprung $zeta$ is understated.
Ride damping (per wheel). The suspension damper in series with the tyre's damping $c_t$, the counterpart of the ride rate. Each damper counts by the square of the share of the travel it sees:
Natural frequency, critical damping and damping ratio. Each axle is one mass $m$ on its two wheels. Per wheel, with $k$ and $c$ the mean of the left and right wheels, that is a quarter car carrying $m/2$, which gives exactly the same frequency and damping ratio as the axle:
| Mode | $k$ | $c$ | $m$ |
|---|---|---|---|
| Sprung mass | wheel rate $k_w$ | damping at the wheel $c_w$ | axle sprung mass |
| Ride | ride rate $k_r$ | ride damping $c_r$ | axle sprung mass |
| Wheel hop | tyre rate + wheel rate, $k_t + k_w$ | tyre damping + damping at the wheel, $c_t + c_w$ | axle unsprung mass |
The sprung and ride modes hold the wheel still. Wheel hop holds the body still, so the tyre and the suspension both act on the unsprung mass.
Checking it by hand
A spring of 30.6 N/mm (175 lb/in) with $"MR"_s = 1.14$ gives $k_w = 30.6 times 1.14^2 = 39.8$ N/mm (227 lb/in) per wheel. A front axle with 120 kg sprung mass then has $C_"crit" = 2 sqrt(39800 times 60) = 3.09$ N·s/mm per wheel. A damper with $"MR"_d = 1.0$ needs 3.09 N·s/mm for $zeta = 1$. With $"MR"_d = 0.8$ it needs $3.09 \/ 0.64 = 4.83$ N·s/mm at the damper.
Unsaved Changes
If you have unsaved suspension changes, the metrics panel will show a warning indicating that calculations may not reflect your latest edits. Save your changes to update the metrics.
Validation Warnings¶
The suspension validates the overall system configuration. Subsystem-specific warnings are documented on each component's page. The parent suspension level checks composite properties that depend on multiple components together.
Motion Ratio Warnings¶
| Condition | Warning |
|---|---|
| Spring motion ratio < 0.3 | Very low motion ratio |
| Spring motion ratio > 2.0 (non-torsion bar) | Very high motion ratio |
Wheel Rate Warnings¶
| Condition | Warning |
|---|---|
| Wheel rate < 15 N/mm | Low wheel rate |
| Wheel rate > 300 N/mm | High wheel rate |
Side Matching Warnings¶
| Condition | Warning |
|---|---|
| Left/right spring rates differ by > 1000 N/m (or Nm/rad) | Mismatched spring rates |
| Left/right damping coefficients differ by > 1000 Ns/m | Mismatched damping coefficients |
Subsystem Pages¶
- Springs — Linear springs, torsion bars, heave springs
- Dampers — Corner dampers and heave dampers
- Anti-Roll Bars — Roll stiffness distribution
- Bump Stops — Progressive rate bump stops