Quickstart - tif1

1. Load a Session

A session is the entry point for all data in tif1. You specify the year, the Grand Prix, and the session type.

import tif1

# Get the 2025 abu dhabi grand prix race session
session = tif1.get_session(2025, "Abu Dhabi Grand Prix", "Race")

2. Access Lap Data

The first time you access .laps, tif1 fetches the data in parallel. Subsequent calls are instant due to the caching layer.

# Load all laps
laps = session.laps

# View driver information
print(session.drivers_df[["Driver", "Team", "DriverNumber"]])

# Get the top 5 fastest laps in the session
fastest_5 = laps.nsmallest(5, "LapTime")
print(fastest_5[["Driver", "LapTime", "Compound"]])

3. analyze a specific driver

You can easily drill down into data for a specific driver using their 3-letter code.

# Get driver data for Max Verstappen
ver = session.get_driver("VER")

# Get his fastest lap
fastest_lap = ver.get_fastest_lap()
print(f"Max's fastest lap: {fastest_lap['LapTime'].iloc[0]:.3f}s")

4. deep dive into telemetry

Telemetry provides high-frequency data (Speed, RPM, Throttle, etc.) for every moment of a lap.

# Get telemetry for lap 19
lap_19 = ver.get_lap(19)
telemetry = lap_19.telemetry

# Check his top speed on that lap
top_speed = telemetry["Speed"].max()
print(f"Top Speed on Lap 19: {top_speed} km/h")

5. list available data

Not sure what events or sessions are available? Use the helper functions.

# List all GPs in 2025
events = tif1.get_events(2025)

# List all sessions for a GP
sessions = tif1.get_sessions(2025, "British Grand Prix")
# ['Practice 1', 'Practice 2', 'Practice 3', 'Qualifying', 'Race']

Pro Tip: Speed it up!

If you’re loading data for the first time, use laps_async() to fetch all drivers’ data simultaneously:

import asyncio

async def main():
    session = tif1.get_session(2025, "Monaco Grand Prix", "Race")
    laps = await session.laps_async()
    print(f"Loaded {len(laps)} laps")

asyncio.run(main())

Learn More

Check out our tutorials for more advanced analysis examples.

Getting Started

Comprehensive guide

Examples

More code examples

API Reference

Core API details

Tutorials

Detailed tutorials

​1. Load a Session

​2. Access Lap Data

​3. analyze a specific driver

​4. deep dive into telemetry

​5. list available data

​Pro Tip: Speed it up!