Skip to content

Metric reference

Generated from core 0.8.1. Download the complete manifest.

The complete built-in catalog contains 77 metric identities. Availability follows the installed architecture and mechanisms. A declared metric can return an empty value when geometry is undefined or required physical inputs are missing. Custom user-defined derivatives are outside this finite catalog.

Corner identities receive _left and _right suffixes in axle exports. Axle identities are already complete: a derivative ending in hub_z_left, for example, names its driver and does not receive another side suffix. See Export columns for other CSV/Parquet fields.

DWB = Double wishbone; MPS = MacPherson strut; ML = Multi-link (five-link); STA = Semi-trailing arm. An asterisk (*) marks conditional availability.

State metrics

IdentityLabelUnitScopeArchitectures
ackermann_percentageAckermann%AxleDWB, MPS, ML, STA
anti_diveAnti-Dive%CornerDWB, MPS, ML, STA
anti_liftAnti-Lift%CornerDWB, MPS, ML, STA
anti_squatAnti-Squat%CornerDWB, MPS, ML, STA
arb_arm_angleARB Arm AngledegCornerDWB*, ML*
arb_end_displacementARB End DisplacementmmCornerDWB*, ML*
arb_twistARB TwistdegAxleDWB*, ML*
braking_anti_angleBraking Anti AngledegCornerDWB, MPS, ML, STA
braking_anti_ratioBraking Anti Ratio1CornerDWB, MPS, ML, STA
camberCamberdegCornerDWB, MPS, ML, STA
casterCasterdegCornerDWB, MPS, STA
caster_virtualCaster, VirtualdegCornerDWB*, MPS*, ML*
contact_patch_lateral_migrationContact-Patch Lateral MigrationmmCornerDWB, MPS, ML, STA
damper_lengthDamper LengthmmCornerDWB, MPS, ML, STA
fvic_yFVIC YmmCornerDWB, MPS, ML, STA
fvic_zFVIC ZmmCornerDWB, MPS, ML, STA
fvsa_lengthFVSA LengthmmCornerDWB, MPS, ML, STA
half_trackHalf-TrackmmCornerDWB, MPS, ML, STA
heaveHeavemmAxleDWB, MPS, ML, STA
heave_link_lengthHeave Link LengthmmAxleDWB*, ML*
kpiKPIdegCornerDWB, MPS, STA
kpi_virtualKPI, VirtualdegCornerDWB*, MPS*, ML*
mechanical_trailMechanical TrailmmCornerDWB, MPS, STA
mechanical_trail_virtualMechanical Trail, VirtualmmCornerDWB*, MPS*, ML*
rack_displacementRack DisplacementmmAxleDWB, MPS, ML, STA
ride_height_changeRide Height ChangemmAxleDWB, MPS, ML, STA
rocker_angleRocker AngledegCornerDWB*, ML*
rollRolldegAxleDWB, MPS, ML, STA
roll_center_yRoll Center YmmAxleDWB, MPS, ML, STA
roll_center_zRoll Center ZmmAxleDWB, MPS, ML, STA
scrub_radiusScrub RadiusmmCornerDWB, MPS, STA
scrub_radius_virtualScrub Radius, VirtualmmCornerDWB*, MPS*, ML*
spring_lengthSpring LengthmmCornerDWB, MPS, ML, STA
steer_angleSteer AngledegCornerDWB, MPS, ML, STA
steering_axis_lateral_offset_wheel_centerSteering-Axis Lateral Offset at Wheel CentermmCornerDWB, MPS, STA
steering_axis_lateral_offset_wheel_center_virtualSteering-Axis Lateral Offset at Wheel Center, VirtualmmCornerDWB*, MPS*, ML*
steering_axis_longitudinal_offset_wheel_centerSteering-Axis Longitudinal Offset at Wheel CentermmCornerDWB, MPS, STA
steering_axis_longitudinal_offset_wheel_center_virtualSteering-Axis Longitudinal Offset at Wheel Center, VirtualmmCornerDWB*, MPS*, ML*
steering_axis_offset_groundSteering-Axis Offset at GroundmmCornerDWB, MPS, STA
steering_axis_offset_ground_virtualSteering-Axis Offset at Ground, VirtualmmCornerDWB*, MPS*, ML*
svic_xSVIC XmmCornerDWB, MPS, ML, STA
svic_zSVIC ZmmCornerDWB, MPS, ML, STA
svsa_angleSVSA AngledegCornerDWB, MPS, ML, STA
svsa_lengthSVSA LengthmmCornerDWB, MPS, ML, STA
t_bar_heave_angleT-Bar Heave AngledegAxleDWB*, ML*
toe_angleToe AngledegCornerDWB, MPS, ML, STA
torsion_bar_twistTorsion Bar TwistdegCornerDWB*, ML*, STA*
trackTrackmmAxleDWB, MPS, ML, STA
track_changeTrack ChangemmAxleDWB, MPS, ML, STA
traction_anti_angleTraction Anti AngledegCornerDWB, MPS, ML, STA
traction_anti_ratioTraction Anti Ratio1CornerDWB, MPS, ML, STA
wheel_center_recessionWheel Center RecessionmmCornerDWB, MPS, ML, STA
wheel_travelWheel TravelmmCornerDWB, MPS, ML, STA

Motion ratios & response derivatives

IdentityLabelUnitScopeArchitectures
deriv_arb_end_displacement_wrt_hub_z_leftARB End Displacement wrt. Left Hub Zmm/mmAxleDWB*, ML*
deriv_arb_end_displacement_wrt_hub_z_rightARB End Displacement wrt. Right Hub Zmm/mmAxleDWB*, ML*
deriv_arb_twist_wrt_hub_z_leftARB Twist wrt. Left Hub Zdeg/mmAxleDWB*, ML*
deriv_arb_twist_wrt_hub_z_rightARB Twist wrt. Right Hub Zdeg/mmAxleDWB*, ML*
deriv_camber_wrt_hub_zCamber wrt. Hub Zdeg/mmCornerDWB, MPS, ML, STA
deriv_camber_wrt_rack_displacementCamber wrt. Rack Displacementdeg/mmCornerDWB*, MPS*, ML*
deriv_caster_wrt_hub_zCaster wrt. Hub Zdeg/mmCornerDWB, MPS, STA
deriv_contact_patch_lateral_migration_wrt_hub_zContact-Patch Lateral Migration wrt. Hub Zmm/mmCornerDWB, MPS, ML, STA
deriv_damper_length_wrt_hub_zDamper Length wrt. Hub Zmm/mmCornerDWB*, MPS, ML*, STA
deriv_half_track_wrt_hub_zHalf-Track wrt. Hub Zmm/mmCornerDWB, MPS, ML, STA
deriv_heave_link_length_wrt_hub_z_leftHeave Link Length wrt. Left Hub Zmm/mmAxleDWB*, ML*
deriv_heave_link_length_wrt_hub_z_rightHeave Link Length wrt. Right Hub Zmm/mmAxleDWB*, ML*
deriv_kpi_wrt_hub_zKPI wrt. Hub Zdeg/mmCornerDWB, MPS, STA
deriv_rocker_angle_wrt_hub_zRocker Angle wrt. Hub Zdeg/mmCornerDWB*, ML*
deriv_spring_length_wrt_hub_zSpring Length wrt. Hub Zmm/mmCornerDWB*, MPS, ML*, STA*
deriv_steer_angle_wrt_hub_zSteer Angle wrt. Hub Zdeg/mmCornerDWB, MPS, ML, STA
deriv_steer_angle_wrt_rack_displacementSteer Angle wrt. Rack Displacementdeg/mmCornerDWB*, MPS*, ML*
deriv_t_bar_center_x_wrt_hub_z_leftT-Bar Center X wrt. Left Hub Zmm/mmAxleDWB*, ML*
deriv_t_bar_center_x_wrt_hub_z_rightT-Bar Center X wrt. Right Hub Zmm/mmAxleDWB*, ML*
deriv_toe_angle_wrt_hub_zToe Angle wrt. Hub Zdeg/mmCornerDWB, MPS, ML, STA
deriv_toe_angle_wrt_rack_displacementToe Angle wrt. Rack Displacementdeg/mmCornerDWB*, MPS*, ML*
deriv_torsion_bar_twist_wrt_hub_zTorsion Bar Twist wrt. Hub Zdeg/mmCornerDWB*, ML*, STA*
deriv_wheel_center_recession_wrt_hub_zWheel Center Recession wrt. Hub Zmm/mmCornerDWB, MPS, ML, STA
deriv_wheel_center_x_wrt_hub_zWheel Center X wrt. Hub Zmm/mmCornerDWB, MPS, ML, STA

Configuration availability

An asterisk (*) means that some valid configurations omit this metric. The downloaded manifest records exact membership: select a row from configurations, then resolve its metric_set in metric_sets. The resulting keys refer to metrics. This includes steering, spring, damper, rocker, ARB, and heave-link dependencies. Supported options are listed in Suspension options.

Derivative units preserve both operands, including mm/mm and deg/mm. These are geometric responses; they do not imply spring forces, stiffness, damping forces, or dynamic simulation.