GRIP-F1

---

The Graphical Racing Insights Package - Formula 1 (GRIP-F1 for short) is a python package for analyzing and visualizing Formula 1 timing & telemetry data and results.

GRIP-F1 relies heavily on other packages and projects to achieve its functionality. A complete list can be found under Dependencies.

Warning

GRIP-F1 was created as part of a final project and is only being developed and tested occasionally at present. I am working on making GRIP-F1 as stable and accurate as possible, but I cannot guarantee anything.

Features

• Simplified integration of FastF1: the package can be initialized with just one line of code
• Driver class containing all important attributes and methods related to drivers
• TimeSeriesPlot class enabling the simple creation of time series diagrams. This class can be used directly, but also serves as foundation for all ready-to-use time series diagrams below
  • LapTimeChart class for plotting lap times of specified drivers over the course of a race (or any other session)
  • SpeedChart class for plotting the speed of specified drivers during a single lap

Installation

For now the only way to use GRIP-F1 is to download or clone this repository and work directly in the source code. But a simpler installation method is currently being worked on.

You will need additional packages to use GRIP-F1. These can be downloaded from pip with the following command (only FastF1 needs to be installed as all other packages are installed with it automatically):

pip install fastf1

There are some examples of how GRIP-F1 can be used in the tests folder. Detailed instructions will follow in the future.

Important

• It is highly recommended that you work within this tests/private folder if you've cloned the repository as this folder is excluded from GitHub and therefore nothing will be overwritten by future updates.
• It is important to open the folder containing all files from GRIP-F1 as a project in your IDE to avoid problems with importing and referencing GRIP-F1.
• Due to limitations of the APIs, some analyses can only be performed from 2018 onwards.

Dependencies

GRIP-F1 depends on a variety of different cool open souurce projects and uses the following packages to function correctly:

• FastF1 (Access to F1 data)
• matplotlib (Data visualisation)
• pandas (Structurizing data)
• NumPy (Calculations)
• Ergast (Archive for historical F1 data)

Notice

GRIP-F1 and all of its related components are unofficial and in no way affiliated with Formula 1. F1, FORMULA ONE, FORMULA 1, FIA FORMULA ONE WORLD CHAMPIONSHIP, GRAND PRIX and related marks are trade marks of Formula One Licensing B.V.