Skip to main content

TrackHeatmapAnalyzer

Track heatmap showing speed or other metrics overlaid on track layout

Configuration

  • Metadata Only: False

When to Use

  • User asks 'where on track am I fastest/slowest'
  • User wants visual speed map of the circuit
  • User wants to see racing line colored by performance metric
  • User asks to visualize throttle or brake application on track

Options

  • lap_selection: best | all (default: best - use best lap for heatmap)
  • value_column: speed | throttle | brake (default: speed)
  • colormap: viridis | plasma | turbo | jet (default: plasma)
  • speed_unit: kph | mph | mps (default: kph for speed display)

Examples

Example 1

User Query: Show me where on track I'm fastest and slowest

Call:

analyze(analyzers='track_heatmap', event='01H8SP4HK4', lap_selection='best', value_column='speed')

Explanation: Creates speed heatmap of best lap with color from slow (blue/purple) to fast (yellow/red)

Example 2

User Query: Visualize my throttle application on the track

Call:

analyze(analyzers='track_heatmap', event='01H8SP4HK4', value_column='throttle', colormap='viridis')

Explanation: Shows throttle position (0-100%) overlaid on track layout