TheoreticalBestAnalyzer
Calculate theoretical best lap time by combining fastest mini-sectors from all laps
Configuration
- 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
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 |
lap_selection | str | "all" | Which laps to include: 'all', 'valid', 'best', 'n_best' |
n_best_laps | int | 5 | Number of best laps when using n_best selection Constraints: ≥ 1 |
landmark_kind | str | "turn_full_track" | Landmark kind to use for mini-sectors |
Examples
Example 1
User Query: What's my theoretical best lap if I put all my best sectors together?
Call:
analyze(analyzers='theoretical_best', event='01H8SP4HK4')
Explanation: Calculates theoretical best by taking fastest mini-sector times across all laps
Example 2
User Query: How much faster could I go in this session?
Call:
analyze(analyzers='theoretical_best', event='01H8SP4HK4', lap_selection='best', n_best_laps=10)
Explanation: Uses only top 10 laps to calculate realistic theoretical best