# som3aa-cpu/race-strategy-decision-support-system-rsdss- architecture

> Architecture diagram of the GitHub repository som3aa-cpu/race-strategy-decision-support-system-rsdss-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-
- Repository: https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-

## Overview

This repository is a Formula 1 race-strategy decision-support project, combining lap data preparation and feature engineering with machine-learning degradation prediction and pit-stop strategy work. The visible data workflow cleans and validates race records, merges them into a master dataset, enriches circuit metadata, and engineers race, lap, tire, circuit, and temperature features. README capabilities and notebook/model directories indicate downstream modeling and strategy simulation, but their internal calls and outputs were not sampled; those links are therefore marked unverified.

Main entry points: [`src/Features/Feature_Pipeline.py`](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Feature_Pipeline.py) (Feature Pipeline), [`src/data/Enrich_data.py`](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Enrich_data.py) (Circuit Enrichment), [`src/Modeling`](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/src/Modeling) (Degradation Models), [`Data/Processed/Master/featured_dataset.csv`](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/Master/featured_dataset.csv) (Featured Dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data Preparation"]
  node_clean["Clean Laps<br/>[Data_Cleaning.py]"]
  node_validate["Validate Data<br/>[Data_Validating.py]"]
  node_merge["Merge Races<br/>[Merge_data.py]"]
  node_enrich["Circuit Enrichment<br/>[Enrich_data.py]"]
  node_feature_validation["Feature Validation"]
end

subgraph group_features["Feature Engineering"]
  node_features_pipeline["Feature Pipeline"]
  node_race_features["Race Features<br/>[Race_Features.py]"]
  node_lap_features["Lap Features<br/>[Lap_Features.py]"]
  node_tire_features["Tire Features<br/>[Tire_Features.py]"]
  node_circuit_features["Circuit Features"]
  node_temp_features["Temperature Features"]
end

subgraph group_strategy["Strategy Analysis"]
  node_modeling["Degradation Models"]
  node_simulation["Strategy Simulation"]
  node_analysis["Race Analysis"]
end

subgraph group_assets["Data Assets"]
  node_circuitdata[("Circuit Metadata")]
  node_model_assets["Trained Model"]
  node_cleaned_data[("Cleaned Race Data")]
  node_master_data[("Master Dataset<br/>[Master_Dataset.csv]")]
  node_enriched_data[("Enriched Dataset")]
  node_featured_data[("Featured Dataset")]
  node_validation_reports["Validation Reports"]
end

node_engineer(("Strategy Engineer"))

node_clean -.->|"writes cleaned laps"| node_cleaned_data
node_validate -.->|"checks race files"| node_cleaned_data
node_merge -->|"reads race files"| node_cleaned_data
node_merge -->|"writes master"| node_master_data
node_enrich -->|"reads master"| node_master_data
node_enrich -->|"loads metadata"| node_circuitdata
node_enrich -->|"writes enriched data"| node_enriched_data
node_features_pipeline -->|"loads input"| node_enriched_data
node_features_pipeline -->|"calls"| node_race_features
node_features_pipeline -->|"calls"| node_lap_features
node_features_pipeline -->|"calls"| node_tire_features
node_features_pipeline -->|"calls"| node_circuit_features
node_features_pipeline -->|"calls"| node_temp_features
node_features_pipeline -->|"writes output"| node_featured_data
node_feature_validation -->|"reads dataset"| node_featured_data
node_feature_validation -->|"writes issues"| node_validation_reports
node_engineer -.->|"explores races"| node_analysis
node_engineer -.->|"assesses strategy"| node_simulation
node_featured_data -.->|"trains predictions"| node_modeling
node_modeling -.->|"uses model artifact"| node_model_assets
node_modeling -.->|"informs strategy"| node_simulation

click node_clean "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Data_Cleaning.py"
click node_validate "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Data_Validating.py"
click node_merge "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Merge_data.py"
click node_enrich "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Enrich_data.py"
click node_circuitdata "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Refrences/Circuit_Characteristics.csv"
click node_features_pipeline "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Feature_Pipeline.py"
click node_race_features "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Race_Features.py"
click node_lap_features "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Lap_Features.py"
click node_tire_features "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Tire_Features.py"
click node_circuit_features "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Circuit_Features.py"
click node_temp_features "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Temperature_Features.py"
click node_feature_validation "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Notebooks/07_Features_Validation.py"
click node_modeling "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/src/Modeling"
click node_model_assets "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Models/gradient_boosting_model.pkl"
click node_simulation "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/src/Optimization"
click node_analysis "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/Notebooks"
click node_cleaned_data "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/Data/Processed/Cleaned_Unmerged_Data"
click node_master_data "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/Master/Master_Dataset.csv"
click node_enriched_data "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/Master/enriched_dataset.csv"
click node_featured_data "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/Master/featured_dataset.csv"
click node_validation_reports "https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/validation_report.txt"

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_clean,node_validate,node_merge,node_enrich,node_feature_validation toneBlue
class node_features_pipeline,node_race_features,node_lap_features,node_tire_features,node_circuit_features,node_temp_features toneAmber
class node_modeling,node_simulation,node_analysis toneMint
class node_circuitdata,node_model_assets,node_cleaned_data,node_master_data,node_enriched_data,node_featured_data,node_validation_reports toneRose
class node_engineer toneIndigo
```

## Components

### Data Preparation

- [Clean Laps](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Data_Cleaning.py): `src/data/Data_Cleaning.py`
- [Validate Data](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Data_Validating.py): `src/data/Data_Validating.py`
- [Merge Races](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Merge_data.py): `src/data/Merge_data.py`
- [Circuit Enrichment](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/data/Enrich_data.py): `src/data/Enrich_data.py`
- [Feature Validation](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Notebooks/07_Features_Validation.py): `Notebooks/07_Features_Validation.py`

### Feature Engineering

- [Feature Pipeline](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Feature_Pipeline.py): `src/Features/Feature_Pipeline.py`
- [Race Features](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Race_Features.py): `src/Features/Race_Features.py`
- [Lap Features](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Lap_Features.py): `src/Features/Lap_Features.py`
- [Tire Features](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Tire_Features.py): `src/Features/Tire_Features.py`
- [Circuit Features](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Circuit_Features.py): `src/Features/Circuit_Features.py`
- [Temperature Features](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Features/Temperature_Features.py): `src/Features/Temperature_Features.py`

### Strategy Analysis

- [Degradation Models](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/src/Modeling): `src/Modeling`
- [Strategy Simulation](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/src/Optimization): `src/Optimization`
- [Race Analysis](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/Notebooks): `Notebooks`

### Data Assets

- [Circuit Metadata](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Refrences/Circuit_Characteristics.csv): `Data/Refrences/Circuit_Characteristics.csv`
- [Trained Model](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/src/Models/gradient_boosting_model.pkl): `src/Models/gradient_boosting_model.pkl`
- [Cleaned Race Data](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/tree/main/Data/Processed/Cleaned_Unmerged_Data): `Data/Processed/Cleaned_Unmerged_Data`
- [Master Dataset](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/Master/Master_Dataset.csv): `Data/Processed/Master/Master_Dataset.csv`
- [Enriched Dataset](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/Master/enriched_dataset.csv): `Data/Processed/Master/enriched_dataset.csv`
- [Featured Dataset](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/Master/featured_dataset.csv): `Data/Processed/Master/featured_dataset.csv`
- [Validation Reports](https://github.com/som3aa-cpu/race-strategy-decision-support-system-rsdss-/blob/main/Data/Processed/validation_report.txt): `Data/Processed/validation_report.txt`

### Other components

- **Strategy Engineer**

## Connections

- Clean Laps → Cleaned Race Data: writes cleaned laps
- Validate Data → Cleaned Race Data: checks race files
- Merge Races → Cleaned Race Data: reads race files (evidence: `src/data/Merge_data.py`)
- Merge Races → Master Dataset: writes master (evidence: `src/data/Merge_data.py`)
- Circuit Enrichment → Master Dataset: reads master (evidence: `src/data/Enrich_data.py`)
- Circuit Enrichment → Circuit Metadata: loads metadata (evidence: `src/data/Enrich_data.py`)
- Circuit Enrichment → Enriched Dataset: writes enriched data (evidence: `src/data/Enrich_data.py`)
- Feature Pipeline → Enriched Dataset: loads input (evidence: `src/Features/Feature_Pipeline.py`)
- Feature Pipeline → Race Features: calls (evidence: `src/Features/Feature_Pipeline.py`)
- Feature Pipeline → Lap Features: calls (evidence: `src/Features/Feature_Pipeline.py`)
- Feature Pipeline → Tire Features: calls (evidence: `src/Features/Feature_Pipeline.py`)
- Feature Pipeline → Circuit Features: calls (evidence: `src/Features/Feature_Pipeline.py`)
- Feature Pipeline → Temperature Features: calls (evidence: `src/Features/Feature_Pipeline.py`)
- Feature Pipeline → Featured Dataset: writes output (evidence: `src/Features/Feature_Pipeline.py`)
- Feature Validation → Featured Dataset: reads dataset (evidence: `Notebooks/07_Features_Validation.py`)
- Feature Validation → Validation Reports: writes issues (evidence: `Notebooks/07_Features_Validation.py`)
- Strategy Engineer → Race Analysis: explores races
- Strategy Engineer → Strategy Simulation: assesses strategy
- Featured Dataset → Degradation Models: trains predictions
- Degradation Models → Trained Model: uses model artifact
- Degradation Models → Strategy Simulation: informs strategy
