Skip to main content

SessionsOverviewAnalyzer

Overview of recent sessions grouped by car/track with summary statistics

Configuration

  • Metadata Only: True

When to Use

  • User asks to see their sessions or 'what have I driven recently'
  • User wants to discover available sessions before detailed analysis
  • User asks about session dates, lap counts, or clean lap percentages
  • User needs to find a specific session ID for deeper analysis

Options

OptionTypeDefaultDescription
granularityLiteral[coarse, normal, detailed]"normal"Level of detail in analysis output
comparison_modeLiteral[absolute, relative, percentage]"absolute"How to compare metrics across subjects
sort_bystr"date"
sort_orderstr"desc"
group_bystr"car_track"
max_sessionsint | None"—"
days_backint | None"—"
min_lapsint0
show_invalid_lapsboolTrue

Examples

Example 1

User Query: Show me my recent sessions

Call:

analyze(days_back=30, sort_by='date', sort_order='desc')

Explanation: Uses default sessions_overview analyzer to list sessions from the last 30 days, sorted by date (newest first).

Example 2

User Query: Which sessions had the most laps?

Call:

analyze(sort_by='lap_count', sort_order='desc', max_sessions=20)

Explanation: Lists sessions sorted by lap count (highest first), limited to 20 results.

Example 3

User Query: Show me all sessions with at least 5 laps, best lap times first

Call:

analyze(min_laps=5, sort_by='best_lap', sort_order='asc')

Explanation: Filters to sessions with at least 5 laps and sorts by best lap time (fastest first).