Skip to content

FjellOverflow/f1-analysis

Repository files navigation

F1 Analysis

Exploratory Formula 1 data analysis and visualization

Contents | Installation | Getting started | Development

Contents

Notebook Description Preview
01_drivers_vs_teammate.ipynb General comparison of driver's win ratios vs teammates logo
02_notable_drivers_vs_teammate.ipynb Comparing single driver's winratios vs their teammates logo
03_practice_vs_qualifying.ipynb Relationship between practice and qualifying performance logo

Installation

  1. Make sure you have poetry installed on your system.

  2. Clone this repository with git clone https://github.com/FjellOverflow/f1-analysis.git.

  3. Run poetry install.

Getting started

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

Development

  1. Make sure to install the project with its development dependencies
poetry install --with dev
  1. Install the pre-commit hooks
poetry run pre-commit install
  1. 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:

  • sqlfluff to format SQL scripts
  • ruff for Python/Jupyter files
  • pyrefly for Python type checking

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.

About

Exploratory Formula 1 data analysis and visualization

Topics

Resources

License

Stars

Watchers

Forks