FrictionCircleAnalyzer - Rally Stage - Citroen C4 WRC
Friction circle analysis: grip utilization from G-force data
Sample Data
| Attribute | Value |
|---|---|
| Source | motec |
| Category | rally_stage |
| File | /Users/mhild/src/durandom/racing/b4racing/packages/source-motec/tests/fixtures/telemetry-NGP-Car_5-Citroen_C4_WRC-Stage_230-20260122_130000.ld |
Available Channels (30): brake, brake_layer_temp_fl, brake_layer_temp_fr, brake_layer_temp_rl, brake_layer_temp_rr, brake_temp_fl, brake_temp_fr, brake_temp_rl, brake_temp_rr, brake_wear_fl, brake_wear_fr, brake_wear_rl, brake_wear_rr, clutch, damping_force_fl, damping_force_fr, damping_force_rl, damping_force_rr, distance, engine_temp, gear, handbrake, lap_distance_pct, lat_accel, long_accel, pitch, position_x, position_y, position_z, roll
Configuration
| Setting | Value |
|---|---|
| Slice Type | lap |
| Metadata Only | False |
| Required Channels | lat_accel, long_accel |
When to Use
- User asks about grip utilization or traction
- User wants to see friction circle or G-G diagram
- User asks 'am I using all available grip?'
- User wants to analyze car balance (under/oversteer tendency)
Key Options
| Option | Description |
|---|---|
max_theoretical_g | Theoretical max grip in G (default: 1.5) |
lap_selection | all |
sample_rate | Downsample rate for large datasets (default: 1) |
Sample Output
Subjects Analyzed: 1 Context: Rally stage data
Standard Grip (Default)
Options: max_theoretical_g=1.5, _config_label=Standard Grip (Default)
Error: Invalid options for analyzer 'FrictionCircleAnalyzer': 1 validation error for FrictionCircleOptions
_config_label
Extra inputs are not permitted [type=extra_forbidden, input_value='Standard Grip (Default)', input_type=str]
For further information visit https://errors.pydantic.dev/2.12/v/extra_forbidden
Example Calls
Show me my grip utilization
analyze(analyzers='friction_circle', event='...')
Analyzes G-force data to show grip envelope
Am I using all available grip on my best lap?
analyze(analyzers='friction_circle', event='...', lap_selection='best')
Friction circle analysis for best lap only
Generated from b4racing.analysis.analyzers.friction_circle.FrictionCircleAnalyzer