Skip to content

Vehicle Performance Metrics ​

This page lists the metrics that BobSim exports, grouped by the workflow that produces them. Each section gives the workflow, the maneuver, and the metric table.

A metric has meaning only with its maneuver, operating region, signal definitions, and extraction method. For how to read, choose, and extend metrics, see Choosing Metrics.

FamilyWorkflowSection
Steady-state handlingRampSteerEval, SteadyStateEvalSteady-state handling
Transient and frequency responseTransientEvalTransient handling
Kinematics and complianceFourPostEvalSuspension, kinematics, and compliance
Envelope limitsEnvelopeSim GGVGGV
Yaw moment and trimEnvelopeSim YMDYMD
Design sensitivityOptSimSensitivity

Steady-state handling ​

WorkflowsRampSteerEval and SteadyStateEval in _3_StandardSim/
ManeuverRampSteerEval ramps the handwheel angle at each test velocity. SteadyStateEval holds a closed-loop lateral-acceleration target until the car settles, for each target and velocity.
ReductionFits each signal against measured ay along velocity isolines
Reported velocityThe velocity nearest report.metric_target_velocity_mps (15 m/s in the shipped configs)

Both workflows export the table below.

GroupMetrics
Run health and sourcen_cases, n_successful_cases, n_failed_cases, standard_sweep_max_ay_mps2, metric_target_velocity_mps, metric_source_velocity_mps
Lateral rangeay_min, ay_max, limit_ay_mps2
Linear response gradientssideslip_gradient_rad_per_mps2, sideslip_gradient_deg_per_g, understeer_gradient_rad_per_mps2, understeer_gradient_deg_per_g, handwheel_angle_gradient_rad_per_mps2, handwheel_angle_gradient_deg_per_g, roll_gradient_deg_per_g
Limit response gradientslimit_sideslip_gradient_rad_per_mps2, limit_sideslip_gradient_deg_per_g, limit_understeer_gradient_rad_per_mps2, limit_understeer_gradient_deg_per_g, limit_handwheel_gradient_rad_per_mps2, limit_handwheel_gradient_deg_per_g, limit_roll_gradient_rad_per_mps2, limit_roll_gradient_deg_per_g
Steering effortpeak_handwheel_torque_Nm, peak_handwheel_torque_ay_mps2
Fit qualityroadwheel_fit_nrmse, handwheel_fit_nrmse, steer_excess_fit_nrmse, roll_fit_nrmse, sideslip_fit_nrmse
Velocity sensitivitysideslip_gradient_velocity_slope_deg_per_g_per_mps, limit_sideslip_gradient_velocity_slope_deg_per_g_per_mps, understeer_gradient_velocity_slope_deg_per_g_per_mps, limit_understeer_gradient_velocity_slope_deg_per_g_per_mps, handwheel_angle_gradient_velocity_slope_deg_per_g_per_mps, limit_handwheel_gradient_velocity_slope_deg_per_g_per_mps, roll_gradient_velocity_slope_deg_per_g_per_mps, limit_roll_gradient_velocity_slope_deg_per_g_per_mps

SteadyStateEval also exports:

GroupMetrics
Sweep definitionstandard_sweep_target_count, and standard_sweep_includes_negative_targets when sweep.includeNegative is on
Limit detectionlimit_nonlinearity_fraction, limit_nonlinearity_threshold_fraction, limit_nonlinearity_reached, limit_nonlinearity_metric

Definitions:

  • Linear gradients are linear slopes versus measured ay.
  • Limit gradients are local slopes at limit_ay_mps2. That is the fitted ay where local steering-gradient nonlinearity first reaches the configured threshold. If the fit never reaches it, the limit is the largest settled fitted point.
  • Understeer gradients are slopes of steer excess, the steering above the geometric curvature requirement.
ay=v2RKδ=∂δ∂ay

ay is lateral acceleration, v is speed, R is turn radius, and δ is a steering measure such as roadwheel or handwheel angle.

Transient handling ​

WorkflowTransientEval in _3_StandardSim/
ManeuverStep steer and continuous (sustained) sine steer
ReductionStep-response features in time, and gain and phase from sine fits
Reported velocityThe velocity nearest report.metric_target_velocity_mps (15 m/s in the shipped config)
GroupMetrics
Run health and sourcen_cases, n_successful_cases, n_failed_cases, representative_testVel_mps, metric_target_velocity_mps, n_velocity_groups
Lateral acceleration step responseay_peak, ay_ss, ay_rise_time_s, ay_peak_response_time_s, ay_gain_dc, ay_overshoot_pct
Sideslip step responsesideslip_ss, sideslip_rise_time_s, sideslip_gain_dc
Yaw step responseyaw_peak, yaw_ss, yaw_rise_time_s, yaw_peak_response_time_s, yaw_gain_dc, yaw_overshoot_rad_per_s, yaw_overshoot_pct
Roll step responseroll_peak, roll_ss, roll_gain_dc, roll_overshoot_rad, roll_overshoot_pct
Settlingsettling_time_s
Frequency response gainay_gain_dc, yaw_gain_dc, ay_gain_peak, ay_gain_peak_freq, yaw_gain_peak, yaw_gain_peak_freq, bandwidth_hz, gain_variation_pct
Frequency response phase and lagay_phase_1hz, ay_phase_0p5hz, yaw_phase_1hz, yaw_phase_0p5hz, ay_lag_0p5hz, yaw_lag_0p5hz, yaw_to_ay_lag_0p5hz, ay_lag_1hz, yaw_lag_1hz, yaw_to_ay_lag_1hz, lag_steer_to_ay, lag_steer_to_yaw, yaw_to_ay_lag, ay_phase_45_freq, yaw_phase_45_freq
Frequency trend and fit qualityay_gain_slope, yaw_gain_slope, ay_phase_slope, yaw_phase_slope, ay_fit_error, yaw_fit_error
Velocity sensitivity<metric>_velocity_slope for every metric above except the run-health and source group

Definitions:

  • Steady-state values are the mean of the last 20 samples of the step run.
  • Rise time is the time from 50% of steady-state steer to 90% of steady-state response.
  • Peak response time is the time from 50% of steady-state steer to the peak response.
  • Overshoot is peak absolute response minus absolute steady-state response. The _pct form divides that by the absolute steady-state response.
  • DC gain is steady-state response divided by steady-state steer.
  • _velocity_slope metrics are linear slopes versus velocity across velocity groups, in the metric's units per m/s.
Gr=rδAr=rpeakrssϕr(ω)=∠R(jω)Δ(jω)

r is yaw rate, δ is steering input, R(jω) is yaw-rate response, and Δ(jω) is steering input in the frequency domain.

Suspension, kinematics, and compliance ​

WorkflowFourPostEval in _3_StandardSim/
ManeuverHeave and roll sweeps on a four-post rig
ReductionK&C-style gains and averages over the sweep
GroupMetrics
Run health and static balanceroll_contact_valid_points, roll_contact_rejected_points, minimum_roll_pulse_contact_fz_n, static_balance_iterations, static_balance_max_abs_fz_error_n, static_balance_max_abs_fz_error_pct, static_balance_pass, static_motion_ratio_front, static_motion_ratio_rear
Heave alignment gainscamber_gain_heave_rad_per_m, toe_gain_heave_rad_per_m, caster_gain_heave_rad_per_m, kpi_gain_heave_rad_per_m, trail_gain_heave_m_per_m, scrub_gain_heave_m_per_m
Roll alignment gainscamber_gain_roll_rad_per_rad, toe_gain_roll_rad_per_rad, caster_gain_roll_rad_per_rad, kpi_gain_roll_rad_per_rad, trail_gain_roll_m_per_rad, scrub_gain_roll_m_per_rad
Motion ratiosavg_motion_ratio_front, avg_motion_ratio_rear, avg_stabar_motion_ratio_front, avg_stabar_motion_ratio_rear
Anti and jacking behavioravg_anti_dive_pct, avg_anti_squat_pct, avg_anti_roll_front_pct, avg_anti_roll_rear_pct, avg_lateral_jacking_coeff_front, avg_lateral_jacking_coeff_rear, avg_longitudinal_jacking_coeff_front, avg_longitudinal_jacking_coeff_rear
Force-based roll centeravg_fbrc_equivalent_height_front_m, avg_fbrc_equivalent_height_rear_m, avg_fbrc_differential_jacking_ratio_front, avg_fbrc_differential_jacking_ratio_rear
Roll stiffness and LLTDspring_roll_stiffness_front_Nm_per_rad, spring_roll_stiffness_rear_Nm_per_rad, arb_roll_stiffness_front_Nm_per_rad, arb_roll_stiffness_rear_Nm_per_rad, elastic_roll_stiffness_front_Nm_per_rad, elastic_roll_stiffness_rear_Nm_per_rad, avg_lltd_front_frac, avg_lltd_front_pct, avg_roll_rate_distribution_front_pct, avg_antiroll_geometry_lltd_delta_pct

Definitions:

  • Alignment gains are for the front-left corner.
  • Anti percentages divide the jacking coefficient by hcg/L for heave and by hcg/T¯ for roll. T¯ is the mean of front and rear track.
  • Elastic roll stiffness is spring plus anti-roll-bar roll stiffness.
  • avg_lltd_front_* comes from contact-patch load changes in roll. avg_roll_rate_distribution_front_pct comes from roll stiffness. avg_antiroll_geometry_lltd_delta_pct is the difference between the two.
  • The force-based roll center height is heq=T2(ΔFz,R−ΔFz,L)/Fy, per axle, from loaded contact patches only.

GGV ​

WorkflowEnvelopeSim GGV in _2_EnvelopeSim/GGV/
ManeuverReduced-order acceleration envelope over a set of speed slices
ReductionEnvelope size, shape, and peaks, plus summaries over a track profile
GroupMetrics
Speed coveragereference_speed_mps, n_speed_slices, speed_min_mps, speed_max_mps
Envelope size and reference sliceggv_volume_g2_mps, ggv_area_ref_g2, ggv_cornering_ref_g, ggv_accel_ref_g, ggv_braking_ref_g
Mean and minimum capabilityggv_mean_cornering_g, ggv_mean_accel_g, ggv_mean_braking_g, ggv_min_cornering_g, ggv_min_accel_g, ggv_min_braking_g
Shape and balanceggv_area_fill_factor_ref, ggv_longitudinal_balance_ref, ggv_min_area_g2, ggv_min_area_speed_mps, ggv_max_area_g2, ggv_max_area_speed_mps
Peak capabilityggv_max_cornering_g, ggv_max_cornering_speed_mps, ggv_min_cornering_speed_mps, ggv_max_accel_g, ggv_max_accel_speed_mps, ggv_min_accel_speed_mps, ggv_max_braking_g, ggv_max_braking_speed_mps, ggv_min_braking_speed_mps
Track-profile summariestrack_corner_speed_mean_mps, track_corner_speed_min_mps, track_velocity_mean_mps, track_velocity_peak_mps, track_path_distance_m, track_straight_distance_m, track_straight_speed_mean_mps, track_accel_capacity_mean_mps2, track_brake_capacity_mean_mps2, track_longitudinal_capacity_mean_mps2
Normalized track indicestrack_lateral_performance_index, track_longitudinal_performance_index, track_accel_performance_index, track_brake_performance_index, track_combined_performance_index

YMD ​

WorkflowEnvelopeSim YMD in _2_EnvelopeSim/YMD/
ManeuverYaw moment diagram over sideslip and handwheel angle, at one or more speeds
ReductionPeaks, zero-yaw-moment trim, local gradients, and a speed sweep
GroupMetrics
Map healthspeed_mps, converged_fraction
Peak lateral accelerationpeak_lateral_accel_mps2, peak_lateral_accel_g, peak_lateral_accel_abs_g, yaw_moment_at_peak_lateral_accel_nm, beta_at_peak_lateral_accel_deg, hwa_at_peak_lateral_accel_deg
Yaw moment authoritypeak_abs_yaw_moment_nm, yaw_moment_peak_signed_nm, lateral_accel_at_peak_yaw_moment_g, max_positive_yaw_moment_nm, max_negative_yaw_moment_nm, yaw_moment_range_nm, yaw_moment_balance
Local yaw moment gradientsyaw_moment_hwa_gradient_nm_per_deg, yaw_moment_beta_gradient_nm_per_deg
Zero-yaw trimtrim_points_count, trim_peak_lateral_accel_mps2, trim_peak_lateral_accel_g, trim_peak_lateral_accel_abs_g, trim_beta_at_peak_lateral_accel_deg, trim_hwa_at_peak_lateral_accel_deg, trim_max_positive_lateral_accel_g, trim_max_negative_lateral_accel_g, trim_lateral_accel_range_g, trim_lateral_accel_balance, trim_steer_gradient_deg_per_g, trim_beta_gradient_deg_per_g
Zero-input sanityzero_input_lateral_accel_g, zero_input_yaw_moment_nm
Speed sweepspeed_sweep_min_speed_mps, speed_sweep_max_speed_mps, speed_sweep_peak_lateral_accel_abs_g, speed_sweep_peak_lateral_accel_speed_mps, speed_sweep_peak_trim_lateral_accel_abs_g, speed_sweep_peak_trim_lateral_accel_speed_mps, speed_sweep_peak_abs_yaw_moment_nm, speed_sweep_peak_abs_yaw_moment_speed_mps

Sensitivity ​

WorkflowOptSim in _4_OptSim/ (StandardSens and EnvelopeSens)
ManeuverNone of its own. OptSim reruns the workflows above across design variables.
ReductionMetric change versus design variable

OptSim does not add a physical metric family. Its outputs are:

  • StandardSim sensitivity results from selected SteadyStateEval metrics
  • EnvelopeSim sensitivity results from reduced envelope metrics
  • refined response-surface results
  • tornado-style effect sizes
  • Pearson correlation tables when enabled
  • percent or absolute metric deltas from a baseline

A sensitivity is not a design recommendation. It shows how a chosen metric moves under a chosen set of assumptions.

Model quality metrics ​

Some exported metrics describe trust in a result, not vehicle behavior:

MetricWorkflow
*_fit_nrmseRampSteerEval, SteadyStateEval
ay_fit_error, yaw_fit_errorTransientEval
n_failed_casesRampSteerEval, SteadyStateEval, TransientEval
converged_fractionYMD

For quality and uncertainty metrics that BobSim does not export yet, see Choosing Metrics.

Released as open-source vehicle simulation tooling.