Skip to content

Suspension

Suspension Page

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

Suspension Tabs

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

Suspension Metrics

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:

$ "MR"_s = (d x_"spring") / (d x_"wheel"), quad "MR"_d = (d x_"damper") / (d x_"wheel") $

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:

$ "MR"_theta = (d theta_"bar") / (d x_"wheel"), quad "MR"_"arb" = (d theta_"bar") / (d phi) $

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:

$ k_w = k_s dot "MR"_s^2 + k_"bs" dot "MR"_"bs"^2 + 1/2 (k_"heave" dot "MR"_"heave"^2 + k_"hbs" dot "MR"_"hbs"^2) $

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$:

$ k_r = (1/k_w + 1/k_t)^(-1) $

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_w = c_"damper" dot "MR"_d^2 $

$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:

$ c_r = c_w dot (k_t / (k_w + k_t))^2 + c_t dot (k_w / (k_w + k_t))^2 $

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:

$ f_n = 1/(2 pi) sqrt((2 k) / m), quad C_"crit" = 2 sqrt(k dot m/2), quad zeta = c / C_"crit" $
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