# sidgaikwad07/f1_tire_degradation_strategy_predictor architecture

> Architecture diagram of the GitHub repository sidgaikwad07/f1_tire_degradation_strategy_predictor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sidgaikwad07/f1_tire_degradation_strategy_predictor
- Repository: https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor

## Overview

This repository is an F1 telemetry, tire-degradation, strategy-analysis, and race-prediction suite. Its documented workflow collects session data, cleans and integrates multiple seasons, analyzes telemetry and tire behavior, trains a degradation model, and uses predictions in race-strategy and visualization outputs. Season-specific collectors, cleaners, and analysis scripts form substantial subsystems; they are represented by their existing directories. README statements support the broad workflow, but source excerpts do not establish every implementation-level handoff.

Main entry points: [`f1_tiredecay_pipeline_raw+preprocessed.py`](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/f1_tiredecay_pipeline_raw%2Bpreprocessed.py) (Feature integration), [`data_collector`](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_collector) (Session collection), [`data_cleaning`](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_cleaning) (Season cleaning), [`cleaned_data_2022`](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/cleaned_data_2022) (Processed season data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Data ingestion"]
  node_collect["Session collection"]
  node_clean["Season cleaning"]
  node_rawdata[("Collected session data")]
end

subgraph group_analysis["Season analysis"]
  node_seasoneda["2022 telemetry analysis"]
  node_seasonedb["2023 telemetry analysis"]
  node_seasonedc["2024 telemetry analysis"]
  node_seasonedd["2025 telemetry analysis"]
  node_gen24["2024 tire data"]
  node_gen25["2025 tire data"]
  node_cleaned[("Processed season data")]
end

subgraph group_modeling["Tire modeling"]
  node_engineer["Feature integration"]
  node_train["Model training"]
  node_model["Trained model"]
end

subgraph group_outputs["Prediction and presentation"]
  node_predict["Canadian GP predictor"]
  node_results["Prediction workbook"]
  node_viz["Canada telemetry visuals"]
end

node_user(("Analyst"))

node_user -.->|"initiates collection"| node_collect
node_collect -.->|"writes sessions"| node_rawdata
node_rawdata -.->|"loads raw data"| node_clean
node_clean -.->|"writes processed data"| node_cleaned
node_cleaned -->|"integrates seasons"| node_engineer
node_gen24 -.->|"provides tire data"| node_engineer
node_gen25 -.->|"provides tire data"| node_engineer
node_engineer -->|"prepares features"| node_train
node_train -.->|"saves model"| node_model
node_model -.->|"loads model"| node_predict
node_predict -.->|"exports predictions"| node_results
node_user -.->|"runs analysis"| node_seasoneda
node_user -.->|"runs analysis"| node_seasonedb
node_user -.->|"runs analysis"| node_seasonedc
node_user -.->|"runs analysis"| node_seasonedd
node_user -.->|"creates visuals"| node_viz

click node_collect "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_collector"
click node_clean "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_cleaning"
click node_rawdata "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_collector"
click node_seasoneda "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2022.py"
click node_seasonedb "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2023.py"
click node_seasonedc "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2024.py"
click node_seasonedd "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2025.py"
click node_gen24 "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/f1_2024_tire_data_generator.py"
click node_gen25 "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/f1_2025_tire_data_generator.py"
click node_cleaned "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/cleaned_data_2022"
click node_engineer "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/f1_tiredecay_pipeline_raw%2Bpreprocessed.py"
click node_train "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/f1_tire_degradation_deeplearning_pipeline_trainmodel.py"
click node_model "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/best_enhanced_model.keras"
click node_predict "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/fixed_2025_Canadian_GP_Predictor.py"
click node_results "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Canadian_GP_2025_Predictions_FIXED.xlsx"
click node_viz "https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Canada_2025_GP_Telemetary_Visualisation.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_collect,node_clean,node_rawdata toneBlue
class node_seasoneda,node_seasonedb,node_seasonedc,node_seasonedd,node_gen24,node_gen25,node_cleaned toneAmber
class node_engineer,node_train,node_model toneMint
class node_predict,node_results,node_viz toneRose
class node_user toneIndigo
```

## Components

### Data ingestion

- [Session collection](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_collector): `data_collector`
- [Season cleaning](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_cleaning): `data_cleaning`
- [Collected session data](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/data_collector): `data_collector`

### Season analysis

- [2022 telemetry analysis](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2022.py): `Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2022.py`
- [2023 telemetry analysis](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2023.py): `Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2023.py`
- [2024 telemetry analysis](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2024.py): `Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2024.py`
- [2025 telemetry analysis](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2025.py): `Explanatory_Data_Analysis/F1_Exploratory_Data_Analysis_Telemetary_2025.py`
- [2024 tire data](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/f1_2024_tire_data_generator.py): `Explanatory_Data_Analysis/f1_2024_tire_data_generator.py`
- [2025 tire data](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Explanatory_Data_Analysis/f1_2025_tire_data_generator.py): `Explanatory_Data_Analysis/f1_2025_tire_data_generator.py`
- [Processed season data](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/tree/main/cleaned_data_2022): `cleaned_data_2022`

### Tire modeling

- [Feature integration](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/f1_tiredecay_pipeline_raw%2Bpreprocessed.py): `f1_tiredecay_pipeline_raw+preprocessed.py`
- [Model training](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/f1_tire_degradation_deeplearning_pipeline_trainmodel.py): `f1_tire_degradation_deeplearning_pipeline_trainmodel.py`
- [Trained model](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/best_enhanced_model.keras): `best_enhanced_model.keras`

### Prediction and presentation

- [Canadian GP predictor](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/fixed_2025_Canadian_GP_Predictor.py): `fixed_2025_Canadian_GP_Predictor.py`
- [Prediction workbook](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Canadian_GP_2025_Predictions_FIXED.xlsx): `Canadian_GP_2025_Predictions_FIXED.xlsx`
- [Canada telemetry visuals](https://github.com/sidgaikwad07/f1_tire_degradation_strategy_predictor/blob/main/Canada_2025_GP_Telemetary_Visualisation.py): `Canada_2025_GP_Telemetary_Visualisation.py`

### Other components

- **Analyst**

## Connections

- Analyst → Session collection: initiates collection
- Session collection → Collected session data: writes sessions
- Collected session data → Season cleaning: loads raw data
- Season cleaning → Processed season data: writes processed data
- Processed season data → Feature integration: integrates seasons (evidence: `README.md`)
- 2024 tire data → Feature integration: provides tire data
- 2025 tire data → Feature integration: provides tire data
- Feature integration → Model training: prepares features (evidence: `README.md`)
- Model training → Trained model: saves model
- Trained model → Canadian GP predictor: loads model
- Canadian GP predictor → Prediction workbook: exports predictions
- Analyst → 2022 telemetry analysis: runs analysis
- Analyst → 2023 telemetry analysis: runs analysis
- Analyst → 2024 telemetry analysis: runs analysis
- Analyst → 2025 telemetry analysis: runs analysis
- Analyst → Canada telemetry visuals: creates visuals
