TheoreticalBestAnalyzer - Rally Stage - Citroen C4 WRC
Calculate theoretical best lap time by combining fastest mini-sectors from all laps
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 | time, distance |
When to Use
- User asks 'what's my theoretical best' or 'what if I put it all together'
- User wants to know their potential with current skill level
- User asks how much time is 'on the table' if they drive perfectly
- User wants to see which sectors have the most improvement potential
Key Options
| Option | Description |
|---|---|
lap_selection | all |
n_best_laps | Limit to N best laps for sector comparison (default: 5) |
sector_size_m | Mini-sector size in meters for granular analysis (default: 50) |
Sample Output
Subjects Analyzed: 1 Context: Rally stage data
Top 5 Laps (Default)
Options: n_best_laps=5, _config_label=Top 5 Laps (Default)
Error: Invalid options for analyzer 'TheoreticalBestAnalyzer': 1 validation error for TheoreticalBestOptions
_config_label
Extra inputs are not permitted [type=extra_forbidden, input_value='Top 5 Laps (Default)', input_type=str]
For further information visit https://errors.pydantic.dev/2.12/v/extra_forbidden
Example Calls
What's my theoretical best lap if I put all my best sectors together?
analyze(analyzers='theoretical_best', event='01H8SP4HK4')
Calculates theoretical best by taking fastest mini-sector times across all laps
How much faster could I go in this session?
analyze(analyzers='theoretical_best', event='01H8SP4HK4', lap_selection='best', n_best_laps=10)
Uses only top 10 laps to calculate realistic theoretical best
Generated from b4racing.analysis.analyzers.theoretical_best.TheoreticalBestAnalyzer