FrictionCircleAnalyzer
Friction circle analysis: grip utilization from G-force data
Configuration
- 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)
Options
| Option | Type | Default | Description |
|---|---|---|---|
granularity | Literal[coarse, normal, detailed] | "normal" | Level of detail in analysis output |
comparison_mode | Literal[absolute, relative, percentage] | "absolute" | How to compare metrics across subjects |
max_theoretical_g | float | 1.5 | Theoretical maximum grip circle radius in G Constraints: ≥ 0.5, ≤ 5.0 |
sample_rate | int | 1 | Sample every Nth point (1 = all points, 10 = every 10th) Constraints: ≥ 1, ≤ 100 |
lap_selection | str | "all" | Lap selection mode: 'all', 'best', 'n_best' |
n_best_laps | int | None | 5 | Number of best laps when lap_selection='n_best' |
Examples
Example 1
User Query: Show me my grip utilization
Call:
analyze(analyzers='friction_circle', event='...')
Explanation: Analyzes G-force data to show grip envelope
Example 2
User Query: Am I using all available grip on my best lap?
Call:
analyze(analyzers='friction_circle', event='...', lap_selection='best')
Explanation: Friction circle analysis for best lap only