LapStatisticsAnalyzer
Detailed lap timing statistics with best/worst/average times and consistency metrics
Configuration
- Slice Type:
lap - Metadata Only: True
When to Use
- User asks about lap times or 'what was my best lap'
- User wants consistency analysis across laps
- User asks 'how fast did I go' or lap time distribution
- User wants to see improvement over a session
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" | Lap selection mode: 'all' for all laps, 'best' for single best lap, 'n_best' for top N laps Choices: all, best, n_best |
n_best_laps | int | None | 5 | Number of best laps to analyze when using 'n_best' lap selection mode |
filter_outliers | bool | True | Automatically filter outlier laps (outlaps, invalid laps) using IQR method |
outlier_threshold | float | 1.5 | IQR multiplier for outlier detection (higher = more permissive, typical: 1.5) |
Examples
Example 1
User Query: Show me detailed lap times for that Formula Vee session
Call:
analyze(analyzers='lapstats', event='01H8SP4HK4')
Explanation: Displays all lap times with statistics including best, worst, average, and consistency
Example 2
User Query: What were my 10 best laps?
Call:
analyze(analyzers='lapstats', event='01H8SP4HK4', lap_selection='best', n_best_laps=10)
Explanation: Shows only the top 10 fastest laps with detailed statistics
Example 3
User Query: How consistent were my lap times today?
Call:
analyze(analyzers='lapstats', after='2023-08-26', lap_selection='all')
Explanation: Analyzes all laps to show consistency metrics (std dev, coefficient of variation)