A python package for accessible F1 historical data and telemetry.
You can install this package using pip
pip install git+https://github.com/theOehrly/Fast-F1.git
Note that this package requires Python 3.8.
Full documentation can be found here.
Setting up an experiment is easy, especially if you are already familiar with pandas and numpy.
Suppose that we want to analyse the race pace of Leclerc compared to Hamilton from the Bahrain GP (weekend number 2) of 2019.
import fastf1 as ff1
from fastf1 import plotting
from matplotlib import pyplot as plt
ff1.utils.enable_cache('path/to/folder/for/cache') # optional but recommended
race = ff1.get_session(2019, 'Bahrain', 'R')
laps = race.load_laps()
lec = laps.pick_driver('LEC')
ham = laps.pick_driver('HAM')Once the session is loaded, and drivers are selected, you can plot the information. It is not necessary to enable the usage of a cache but it is recommended. Simply provide the path to some empty folder on your system.
fig, ax = plt.subplots()
ax.plot(lec['LapNumber'], lec['LapTime'], color='red')
ax.plot(ham['LapNumber'], ham['LapTime'], color='cyan')
ax.set_title("LEC vs HAM")
ax.set_xlabel("Lap Number")
ax.set_ylabel("Lap Time")
plt.show()
Starting with the Austrian GP 2020 the API provides the position data in a somewhat different format. This currently breaks ALL functionality of the track class. Maybe also other functionality.
Library is fully compatible with 2018 and 2019 season. While previous seasons are still accessible and it is possible to obtain general weekend information (basically what you can get from Ergast web api) live timing and telemetry data is only available starting from 2018.