Metadata-Version: 2.4
Name: simulateur-trafic-aya-zid
Version: 0.1.0
Summary: Simulateur de trafic routier intelligent avec modélisation de réseaux
Author: Aya Zid
Author-email: aya-zid <azid28278@gmail.com>
License: MIT
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: numpy<3.0.0,>=2.3.4
Requires-Dist: pandas<3.0.0,>=2.3.3
Requires-Dist: matplotlib<4.0.0,>=3.10.7
Requires-Dist: seaborn<0.14.0,>=0.13.2
Requires-Dist: openpyxl<4.0.0,>=3.1.5
Requires-Dist: tqdm<5.0.0,>=4.67.1
Requires-Dist: python-dateutil<3.0.0,>=2.9.0.post0
Dynamic: author
Dynamic: license-file

# 🚦 Simulateur de Trafic Routier Intelligent

[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

Un simulateur de trafic routier complet écrit en **Python**, permettant de **modéliser, simuler et analyser** un réseau routier intelligent composé de routes, intersections et véhicules.

---

## 🧠 Objectifs du projet
- Concevoir une **application orientée objet complète**.  
- Simuler la **circulation de véhicules** dans un réseau défini.  
- Fournir des **statistiques dynamiques** (vitesses, congestions, temps de parcours).  
- Produire des **visualisations graphiques** et **exports de données**.  
- Démontrer une **architecture modulaire, testable et extensible**.

---

## 🚀 Exécution

### 1️⃣ Simulation complète :
```bash
python main.py -t 60 -d 60 -c data/config_reseau.json --graphique --export --affichage
```
- `-t` : nombre de tours (par ex. 60 minutes)  
- `-d` : durée d’un pas de simulation (en secondes)  
- `-c` : fichier de configuration du réseau  
- `--graphique` : active les visualisations  
- `--export` : exporte les résultats  
- `--affichage` : affiche la progression en temps réel  

### 2️⃣ Démonstration rapide :
```bash
python main.py
```
(exécute la simulation par défaut sans arguments)

---

## 🧮 Exemple de configuration (`data/config_reseau.json`)
Ce fichier définit le **réseau routier initial** :
- les **routes** et leurs caractéristiques (longueur, vitesse limite),  
- les **intersections** et connexions entre routes,  
- la **liste des véhicules** avec leur position et vitesse initiale.  

---

## 📊 Fonctionnalités principales

| Module | Rôle |
|--------|------|
| `Vehicule` | Modélise un véhicule (position, vitesse, route actuelle). |
| `Route` | Gère les véhicules circulant sur une route et leurs mises à jour. |
| `ReseauRoutier` | Coordonne l’ensemble des routes et intersections. |
| `Simulateur` | Lance la simulation, fait évoluer les états et collecte les données. |
| `Analyseur` | Calcule vitesses moyennes, congestions, et temps de parcours. |
| `Affichage` | Affiche la simulation et les statistiques sous forme graphique. |
| `Export` | Enregistre les résultats dans différents formats. |

---

## 📈 Résultats attendus
- Évolution des vitesses et densités au cours du temps.  
- Détection automatique des zones de congestion.  
- Statistiques globales sur la performance du réseau.  
- Visualisation du trafic sous forme de graphiques et tableaux.

---

## 📜 Licence
Projet distribué sous licence **MIT**.  
© 2025 Aya Zid — Simulateur de Trafic Routier Intelligent.
