Two simulations of the same principle. The first is the example of the documentation, simple enough for its small calculations to be done by hand. The second applies the same method to the active suspension of a car, and shows what scheduling buys.
1The example of the documentation: a mass, a spring, a damper
The documentation builds everything on a deliberately simple system: a mass m, tied to a wall by a spring of varying stiffness k(ρ) and a damper c, which must follow a reference r. It has only two states, position and speed. That is small enough for the calculations behind the proofs and the intuition to be done by hand: the LFT, the stored energy, its balance, the range in which the mass alone stays stable.
The controller itself is not computed by hand: it comes out of a problem of matrix inequalities solved offline, and the page only runs its matrices. Move the parameter ρ and leave the range stated by the synthesis.
∣ρ∣≤1.17: inside the range shown
y(t) vs r(t) [m]
u(t), control effort [N]
ρ(t), parameter
y axis
u axis
Mass-spring-damper system
Visualizing LPV dynamics
my¨+cy˙+k(ρ(t))y=u
1.0y¨+2.0y˙+10.00y=0.00
k(ρ(t))=10(1+0.4ρ(t)) is the varying stiffness.
Observe how stiffness affects system response.
Blue background: ∣ρ∣≤1.17, a range covered by the certificate for the unsaturated model. The background turns copper when the parameter crosses the displayed limit.
Tip: with a mouse, drag vertically on the y or u plot to rescale, Shift+drag to pan, double-click to reset. The buttons below the plots do the same by keyboard and touch.
2The same principle on the suspension of a car
A car drives. The driver sets the stiffness of its air springs, k(ρ), with the parameter ρ; an actuator in the strut applies the force u between the body and the wheel.
The dotted curves follow the same car with a fixed controller, computed the same way for the normal setting only.
∣ρ∣≤1.17: within the reference band
z¨s(t), body acceleration [m/s²]: comfort
Load of the front tyre, as a share of the static load: road holding
u(t), force of the actuator [kN]
ρ(t), stiffness setting
Solid: the drawn car, with the engaged controller. Dots: fixed controller from the start. Dashes: no actuator.
z¨s axis
u axis
Active suspension of a car
The front strut, in a cutaway view
Motorway · 108 km/h
Arrows along the strut: force u of the actuator, on the body and, in reaction, on the wheel. Arrow under the front wheel: load of the tyre. Displacements to scale.
k(ρ)=25(1+0.4ρ)kN/m: stiffness of the air spring. ms=400kg,mu=40kg,c=1.5kN⋅s/m,kt=200kN/m.
Blue band: ∣ρ∣≤1.17. This band contains the three suspension settings available on the road. On the test bench, the sliders let you explore values beyond it.
On the z¨s and u plots: drag vertically to rescale, Shift+drag to pan, double-click to reset; or use the buttons below the plots.
3What is simulated, and how
The mass
Plant
m=1kg,c=2N⋅s/m,k(ρ)=10(1+0.4ρ)N/m
Discretization
Explicit Euler for the mass, Ts=1ms, 20 steps per displayed frame. The controller is synthesized in discrete time on this sampled model, whereas the documentation reasons in continuous time (Section 5.8)
Square wave between 0.2 m and 0, switching every 2 s
Parameter
ρ(t)=ρ0+Aρsin(2πfρt), adjustable above
Saturation
±20N on the control input, outside the synthesis model
The car
Plant
Two-mass quarter car: body ms=400kg, wheel mu=40kg, air spring k(ρ)=25(1+0.4ρ)kN/m, damper c=1.5kN⋅s/m, tyre kt=200kN/m, actuator of force u between the body and the wheel. Front and rear are two independent quarter cars, without pitch or roll
Measurements
Strut deflection and vertical speed of the body
Objective
Rejection of the road, for a road rising or falling at 0.1 m/s: limit the body acceleration (0.7 m/s² below 8 Hz), the strut travel (8 cm), the variation of the tyre load (20% of the static load) and the effort (3 kN)
Discretization
Zero-order hold, Ts=1ms; the synthesis is made on this sampled model
LPV controller
Gain-scheduled, 6 states, LFT dependence on ρ, shaded reference range ∣ρ∣≤1.17
Fixed controller
The same synthesis without the parameter channel, for the normal setting only, ρ=0. This nominal controller is used for comparison.
Parameter
On the road, the setting of the driver, ρ∈{−1,0,1}; on the bench, ρ(t)=ρ0+Aρsin(2πfρt)
Saturation
±4kN on the force, outside the synthesis model
End stops
Stops at 7 cm in compression and 9 cm in extension, a tyre that can leave the road, a rim that can touch it. The simulation adds these mechanical effects to the linear design model
Display: 400 samples for each simulation, a sliding window of 8 s.
Technical decisions
Numerical cores separated from the display
The calculations live in modules with no interface. The tests reproduce the reference trajectories of the mass with its original controller. For the new mass and car controllers, they compare the simulation matrices against the synthesis data.
SVG drawings updated directly
The simulations update the curves and drawings on each frame without asking React to render the entire page again.
Equations rendered on the server with KaTeX
They appear without JavaScript and stay readable by assistive technologies.
4Good to know
A run without divergence does not prove stability, and leaving the stated range does not imply instability: these limits are conservative. For the mass, the certified limit of the unsaturated discrete model is 1/γ≈1.17647. The figure rounds this limit down to 1.17.
The simulation represents a change in air-spring volume by changing stiffness at a fixed ride height. It omits pressure and airflow dynamics. The parallel actuator can supply energy to the suspension. A semi-active damper adjusts how much energy it dissipates.
5Controller data
Show the matrices of the controller of the mass
Values run by this page, with the certified level γ=0.85. The controller LFT depends on ρ through a single channel, wθ=ρzθ, like that of the mass.
Show the matrices of the LPV controller of the car
Matrices used in the simulation. The controller receives the strut deflection and the body speed and returns the force u in kN; its LFT depends on ρ through a single channel, wθ=ρzθ, like that of the spring.