Skip to main content

1. Load a Session

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

2. Access Lap Data

The first access to .laps downloads the lap data of all drivers. Later accesses return the same DataFrame from memory.
LapTime is a pandas Timedelta. LapTimeSeconds holds the same value as a float in seconds.

3. Analyze a Specific Driver

Examine the data for one driver with the 3-letter driver code. session.drivers lists driver numbers; session.drivers_df["Driver"] lists the codes.

4. Examine Telemetry

Telemetry holds samples of Speed, RPM, Throttle, and other channels along one lap.

5. List the Available Data

Use the helper functions to list the available events and sessions.

6. Create a Chart in One Call

Every chart function in tif1.charts loads its own session. It produces a complete figure in one call. The functions are also re-exported at the top level.
See the Charts API for all chart functions and their shared filters.

Load Laps in Async Code

session.laps already runs the parallel fetch. In code that already runs an event loop, such as an async web app, await laps_async() instead. It returns the same Laps object as session.laps (a polars DataFrame with lib="polars").

Learn More

Read the tutorials for advanced analysis examples.

Getting Started

Comprehensive guide.

Examples

More code examples.

API Reference

Core API details.

Charts API

22 one-call chart functions.

Tutorials

Detailed tutorials.
Last modified on October 15, 2026