Exploratory Formula 1 data analysis and visualization
Contents | Installation | Getting started | Development
-
Make sure you have poetry installed on your system.
-
Clone this repository with
git clone https://github.com/FjellOverflow/f1-analysis.git. -
Run
poetry install.
All data analysis happens in the Jupyter notebooks in the notebooks directory. They are numbered for a recommended sequence, but you’re welcome to explore them in any order you prefer.
# run jupyter to explore all notebooks
poetry run jupyter notebook notebooks
# or run a specific notebook with
poetry run jupyter notebook notebooks/01_drivers_vs_teammate.ipynb- Make sure to install the project with its development dependencies
poetry install --with dev- Install the pre-commit hooks
poetry run pre-commit install- Install the recommended extensions for VSCode, by opening the Extensions tab and typing
@recommended.
The repository ships with pre‑configured tools to keep the codebase consistent:
A pre-commit hook runs the above tools, as well as nb-clean before each commit. If any style violations are detected, the commit is blocked until they are resolved.


