How som3aa-cpu/race-strategy-decision-support-system-rsdss- works
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: Feature_Pipeline.py Feature Pipeline · Enrich_data.py Circuit Enrichment · Modeling Degradation Models · featured_dataset.csv Featured Dataset
Components 22
Data Preparation
- Clean Laps
src/data/Data_Cleaning.py - Validate Data
src/data/Data_Validating.py - Merge Races
src/data/Merge_data.py - Circuit Enrichment
src/data/Enrich_data.py - Feature Validation
Notebooks/07_Features_Validation.py
Feature Engineering
- Feature Pipeline
src/Features/Feature_Pipeline.py - Race Features
src/Features/Race_Features.py - Lap Features
src/Features/Lap_Features.py - Tire Features
src/Features/Tire_Features.py - Circuit Features
src/Features/Circuit_Features.py - Temperature Features
src/Features/Temperature_Features.py
Strategy Analysis
- Degradation Models
src/Modeling - Strategy Simulation
src/Optimization - Race Analysis
Notebooks
Data Assets
- Circuit Metadata
Data/Refrences/Circuit_Characteristics.csv - Trained Model
src/Models/gradient_boosting_model.pkl - Cleaned Race Data
Data/Processed/Cleaned_Unmerged_Data - Master Dataset
Data/Processed/Master/Master_Dataset.csv - Enriched Dataset
Data/Processed/Master/enriched_dataset.csv - Featured Dataset
Data/Processed/Master/featured_dataset.csv - Validation Reports
Data/Processed/validation_report.txt
Other components
- Strategy Engineer
Connections 21
- Clean Laps → Cleaned Race Data: writes cleaned laps
- Validate Data → Cleaned Race Data: checks race files
- Merge Races → Cleaned Race Data: reads race files
src/data/Merge_data.py - Merge Races → Master Dataset: writes master
src/data/Merge_data.py - Circuit Enrichment → Master Dataset: reads master
src/data/Enrich_data.py - Circuit Enrichment → Circuit Metadata: loads metadata
src/data/Enrich_data.py - Circuit Enrichment → Enriched Dataset: writes enriched data
src/data/Enrich_data.py - Feature Pipeline → Enriched Dataset: loads input
src/Features/Feature_Pipeline.py - Feature Pipeline → Race Features: calls
src/Features/Feature_Pipeline.py - Feature Pipeline → Lap Features: calls
src/Features/Feature_Pipeline.py - Feature Pipeline → Tire Features: calls
src/Features/Feature_Pipeline.py - Feature Pipeline → Circuit Features: calls
src/Features/Feature_Pipeline.py - Feature Pipeline → Temperature Features: calls
src/Features/Feature_Pipeline.py - Feature Pipeline → Featured Dataset: writes output
src/Features/Feature_Pipeline.py - Feature Validation → Featured Dataset: reads dataset
Notebooks/07_Features_Validation.py - Feature Validation → Validation Reports: writes issues
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