Formula 1 Analysis is an interactive data visualization system that explores historical trends in Formula 1.
Our dataset was obtained from Kaggle, and it captures over 7 decades of Formula 1 racing (1950-2024). It includes detailed data on races, drivers, teams, circuits, and more, offering insights into the Formula 1 sport. Similarly, it's organized into multiple CSV files (comma as separator), where each file contains the list of drivers with their details, the list of circuits, all the race results with their timings per driver per team, all the race schedules across time, and more.
- Dataset link: https://www.kaggle.com/datasets/muhammadehsan02/formula-1-world-championship-history-1950-2024
- Luis Aguilar (MS in CS at SFSU)
- Siham Argaw (MS in CS at SFSU)
- Matthew Bush (MS in Data Science and AI at SFSU)
| Category | Name | Description |
|---|---|---|
| Language | Python 3 | Main programming language |
| Dependency | Pandas | To clean, explore, and manipulate data. |
| Dependency | Plotly | To generate interactive web-based visualizations. |
| Dependency | Shiny | Framework to build interactive web apps only using Python. |
Layer in charge of loading, parsing, cleaning, and manipulating the data. After this process, it passes the processed data to the plotting layer.
Layer in charge of generating visualizations with filtered formatted data.
Layer in charge of rendering the visualizations on a multi-page web application
- Install the latest version of Python 3 in your machine
- Install the latest version of VSCode in your machine
- Clone the repository
git clone https://github.com/LMAR5/formula1-analysis.git
- Go into the new directory
cd formula1-analysis
- Create a virtual environment with the following command (will create a
.venvdirectory):
- Note: Instead of relying and installing several system-wide Python libraries, we'll use an isolated virtual environment.
python3 -m venv .venv
- Activate the virtual environment with the following command:
source .venv/bin/activate
- To check if your virtual environment is activated, use the following command:
(If the virtual environment is activated, the command will output a filepath that includes the
.venvdirectory)
which python
- If you want deactivate the virtual environment (not needed right now), run the following command:
deactivate
- Install dependencies from the requirements.txt file
pip install -r requirements.txt
- Run the Shiny app with the following command:
--reloadwill reload the app anytime you save changes in your Python file.--launch-browserwill automatically open your browser.
shiny run --reload --launch-browser app.py
- The app should be running on
http://127.0.0.1:8000/
At VSCode, if you get the report missing imports from Pylance (error message) check the following link:
You'll have to create the .vscode directory, create a settings.json file, and add the python.defaultInterpreterPath property so VSCode can find the dependencies from your Python path.
