TheoreticalBestAnalyzer - Circuit Session - Lime Rock MX-5

Calculate theoretical best lap time by combining fastest mini-sectors from all laps

Sample Data

Attribute	Value
Source	garage61
Category	circuit_lap
File	01K451BYJ64G0T2GPQ44AKXC86

Available Channels: LongAccel, VertAccel, YawRate, abs_active, brake, clutch, drs_active, gear, lap_distance_pct, lat_accel, latitude, longitude, position_type, rpm, speed, speed_kph, speed_mph, steering, throttle, time, track_pct, yaw

---

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

Top 5 Laps (Default)

Options: n_best_laps=5

{
  "metrics": [],
  "mini_sectors": {},
  "warnings": [],
  "metadata": {
    "analyzer": "theoretical_best",
    "subjects_analyzed": 0
  }
}

Top 3 Laps

Options: n_best_laps=3

{
  "metrics": [],
  "mini_sectors": {},
  "warnings": [],
  "metadata": {
    "analyzer": "theoretical_best",
    "subjects_analyzed": 0
  }
}

---

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