Skip to content

DARKQUAD/GT3-Telemetry-Analyzer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

🏎️ GT3 Telemetry Analyzer — Streamlit Edition

Une application web interactive et moderne conçue pour analyser les données de télémétrie de Simracing (Assetto Corsa, avec la McLaren MP4-12C GT3 sur le circuit de Monza). Elle fournit des outils statistiques avancés, des calculs de probabilités, des modèles de Machine Learning et un système d'évaluation des performances.


🌟 Fonctionnalités

📊 1. Analyse Télémétrique & Statistiques Descriptives

  • Résumé des Tours : Comparaison du temps au tour, écarts (gaps), vitesses maximales/moyennes, régime moteur (RPM) maximal et force G latérale.
  • Comportement des Commandes : Analyse détaillée de l'utilisation de l'accélérateur (Throttle), du frein (Brake) et du temps passé en roue libre (Coast).
  • Graphiques Interactifs : Tracés multi-variables dynamiques avec Plotly (Vitesse, Force G, Commutateur de rapports, etc.).

🎲 2. Analyses Probabilistes

  • Analyse de la distribution de la vitesse et de l'accélérateur.
  • Évaluation statistique de la régularité et des plages de vitesse par tour.

🤖 3. Pipeline de Machine Learning

  • Réduction de dimensionnalité (PCA) et Clustering (K-Means) pour profiler les différents styles de conduite.
  • Détection d'anomalies (Isolation Forest) avec un taux de contamination de 3% pour identifier les erreurs de pilotage (sorties de piste, freinages ratés).
  • Régression (Random Forest Regressor) pour prédire le temps au tour à partir des métriques de pilotage et identifier l'importance de chaque variable.

🏆 4. Système de Score (Performance Scoring)

  • Calcul d'une note globale sur 100 basée sur des critères clés : vitesse de pointe, efficacité de freinage, gestion des régimes moteurs et régularité.

💾 5. Export de Rapports

  • Exportation de rapports de synthèse textuels formatés.
  • Exportation des données de télémétrie nettoyées au format CSV.

📊 À propos du jeu de données (Dataset)

Source : Kaggle - Assetto Corsa GT3 Telemetry Monza Full Course (par Nasim, mis à jour en 2026/récemment).

Cet ensemble de données contient les données télémétriques de tours de piste brutes exportées directement depuis le simulateur de course Assetto Corsa lors d'une session de conduite sans incident.

🎮 Spécifications du jeu et véhicule

  • Jeu : Assetto Corsa (Développeur : Kunos Simulazioni)
  • Voiture : McLaren MP4-12C GT3
  • Circuit : Autodromo Nazionale di Monza (Parcours complet)
    • Longueur de la voie : 10 019,8 m (Note : correspond à la distance cumulée des tours dans l'export)
  • Détails de la session :
    • Nombre total de tours enregistrés : 5
    • Météo : Dégagé
    • État de la piste : Sec

📈 Fonctionnalités enregistrées (Colonnes)

Chaque ligne représente un échantillon de télémétrie capturé à intervalles réguliers pendant le tour, incluant :

  • Identifiants de voiture et de piste
  • Indice du tour et numéro du tour
  • Référence du temps au tour
  • Position mondiale (X, Y, Z)
  • Vecteurs d'orientation de la voiture
  • Composantes de la vitesse (X, Y, Z)
  • Force G longitudinale
  • Entrée d'accélérateur (Throttle)
  • Entrée de freinage (Brake)
  • Entrée de direction (Steering)
  • Rapport engagé (Gear)
  • Régime moteur (RPM)
  • Position en course
  • Indice de bin et indicateur de validité

Note

Les données de télémétrie sont exportées directement du jeu, puis nettoyées pour un formatage correct. Aucun paramètre de simulation n'a été modifié pendant l'enregistrement. Cet ensemble de données est destiné à l'inspection télémétrique, à la visualisation et à l'analyse des courses simulées.


🛠️ Prérequis et Installation

1. Cloner ou télécharger le projet

Assurez-vous d'avoir les fichiers suivants dans votre répertoire de travail :

  • gt3_telemetry.py (Script principal Streamlit)
  • Monzafc-5lap.csv (Fichier de données de télémétrie)
  • monza_layout.png (Tracé du circuit)

2. Installer les dépendances

Installez les bibliothèques requises à l'aide de pip :

pip install streamlit pandas numpy scipy scikit-learn matplotlib plotly

🚀 Utilisation

Pour lancer l'application Streamlit localement, exécutez la commande suivante dans votre terminal :

streamlit run gt3_telemetry.py

L'application s'ouvrira automatiquement dans votre navigateur par défaut à l'adresse suivante : 👉 http://localhost:8501

About

Une application web interactive et moderne conçue pour analyser les données de télémétrie de Simracing (Assetto Corsa, avec la McLaren MP4-12C GT3 sur le circuit de Monza). Elle fournit des outils statistiques avancés, des calculs de probabilités, des modèles de Machine Learning et un système d'évaluation des performances.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages