Skip to main content

​
What is a Session?

A Session represents a single F1 track session (Practice, Qualifying, Sprint, or Race). It contains all data for that session including drivers, laps, telemetry, weather, and race control messages.

​
Session Hierarchy

tif1 supports all F1 session types:
  • Practice 1, Practice 2, Practice 3
  • Qualifying
  • Sprint, Sprint Qualifying, Sprint Shootout
  • Race

​
Lazy Loading

Sessions use lazy loading for optimal performance. Data is only fetched when you access it: 
session = tif1.get_session(2025, "Bahrain Grand Prix", "Race")
# No data fetched yet

laps = session.laps  # Data fetched now
# Subsequent access is instant from cache
```yaml

## Data Enrichment

tif1 automatically enriches data with additional information:

- Weather data is included in every lap
- Telemetry includes DriverAhead and DistanceToDriverAhead
- LapTimeSeconds is provided as a numeric helper alongside LapTime
- Position and acceleration data (X, Y, Z) in telemetry

---

## Related Pages

<CardGroup cols={2}>
  <Card title="Core API" href="/api-reference/core">
    Session class
  </Card>
  <Card title="Getting Started" href="/getting-started">
    Usage guide
  </Card>
  <Card title="Race Analysis" href="/tutorials/race-analysis">
    Tutorial
  </Card>
</CardGroup>
Last modified on March 4, 2026