This project does not aim to be commercialized in any way. It is a personal project for learning purposes only.

• About
• Getting Started
• Usage

To get started with this project, you will need to follow the instructions below.

1. Have both Python 3.7 or higher and Jupiter Notebook installed.

2. Clone this repository using the following command:

   git clone https://github.com/dorian-roux/Formula1-analysis

3. Navigate to the repository and create virtual environment and activate it using the following commands:

   python -m venv ${YOUR_ENV_NAME}
   source ${YOUR_ENV_NAME}/bin/activate # For Linux

   You can replace ${YOUR_ENV_NAME} with the name you want to give to your virtual environment.

4. Install the required packages using the following command:

   pip install -r requirements.txt

After those steps, you should be able to run the Notebooks.

The Ergast Developer API. is used to get the data for this project. It is an experimental web service which provides a historical record of motor racing data for non-commercial purposes.

To generate the data files formula1-circuits.json and formula1-data.json, you need to run the Notebook DataF1-ErgastAPI.ipynb which will generate the data in their corresponding folder. Those data will be used in the analysis and visualization Notebooks.

The data file formula1-circuits.json will contain the following information about the circuits based on the CIRCUIT_ID :

• Circuit : The name of the circuit.
• Country : The country where the circuit is located.
• City : The city where the circuit is located.
• Coordinates : The coordinates of the circuit.

Example with the Silverstone circuit :

"silverstone": {
    "CIRCUIT_NAME": "Silverstone Circuit",
    "COUNTRY": "UK",
    "CITY": "Silverstone",
    "COORDINATES": ["52.0786", "-1.01694"]
},

the data file formula1-data.json will contain global information regarding Formula 1. It contains the racing information based on the YEAR:

• Drivers : Information about the drivers including their full name, birthdate and nationality.
• Constructors : Information about the constructors including their name and nationality.
• Circuits : Information about the circuits including their id, name and the date.
• Laps : Information about the laps including for each lap all the drivers position and time. The laps are not available for every year (most unlikely to be available for the early years).
• Results : Information about the results for each race including the driver, construction, grid position, final position, time, fastest lap and fastest lap ranking. The time of the driver is based on the time of the winner of the race (for instance D1 finished first in 1h30m00s and D2 finished second in 1h30m10s, D2 will have a time of +10s). Here also the availability of the fastest lap is not guaranteed for every year.