Metadata-Version: 2.4
Name: simulateur-trafic-ibt
Version: 1.0.0
Summary: Un simulateur modulaire pour modéliser et analyser le trafic routier
Home-page: https://github.com/IbtissemLW/simulateur-traffic
Author: Ibtissem
Author-email: Ibtissem <learn.and.work.2025@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/IbtissemLW/simulateur-traffic
Project-URL: Documentation, https://github.com/IbtissemLW/simulateur-traffic#readme
Project-URL: Repository, https://github.com/IbtissemLW/simulateur-traffic
Project-URL: Issues, https://github.com/IbtissemLW/simulateur-traffic/issues
Keywords: traffic,simulation,routing,traffic-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: License MIT
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: numpy>=1.21.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: flake8>=7.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Simulateur de Trafic Routier

Simulateur Python pour la modélisation et l'analyse du comportement des véhicules sur un réseau routier. Cet outil offre une plateforme flexible pour tester des politiques de gestion du trafic et étudier les dynamiques des flux routiers.

## 🚀 Installation

### Via PyPI (une fois publié)
\`\`\`bash
pip install simulateur-trafic
\`\`\`

### Via TestPyPI (pour tests)
\`\`\`bash
pip install --index-url https://test.pypi.org/simple/ simulateur-trafic
\`\`\`

### Installation locale (développement)
\`\`\`bash
git clone https://github.com/yourusername/simulateur-trafic.git
cd simulateur-trafic
pip install -e ".[dev]"
\`\`\`

## 📖 Utilisation Rapide

\`\`\`python
from simulateur_trafic import Vehicule, Route, ReseauRoutier, Simulateur

# Créer une route
route_a1 = Route("A1", longueur=1000, limite_vitesse_kph=90)

# Créer un réseau
reseau = ReseauRoutier()
reseau.ajouter_route(route_a1)

# Lancer la simulation
simulateur = Simulateur("config.json")
simulateur.lancer_simulation(n_tours=100, delta_t=1.0)
\`\`\`

## 🏗️ Architecture

\`\`\`
simulateur_trafic/
├── models/
│   ├── vehicule.py       # Classe Vehicule
│   ├── route.py          # Classe Route
│   ├── reseau.py         # Classe ReseauRoutier
│   └── simulateur.py     # Classe Simulateur principale
├── core/
│   └── analyseur.py      # Collecte et export des données
├── numba_kernels/        # Optimisations Numba
└── cython_modules/       # Optimisations Cython
\`\`\`

## 🧪 Tests

\`\`\`bash
# Exécuter tous les tests
pytest tests/ -v

# Avec couverture de code
pytest tests/ --cov=simulateur_trafic

# Test spécifique
pytest tests/test_vehicule.py -v
\`\`\`

## 🔧 Configuration

Créez un fichier `config.json`:

\`\`\`json
{
  "routes": [
    {
      "nom": "A1",
      "longueur": 1000,
      "limite_vitesse": 90,
      "intersection_debut": "Paris",
      "intersection_fin": "Lyon"
    }
  ],
  "vehicules_initiaux": [
    {
      "nombre": 10,
      "route_depart": "A1",
      "vitesse_max_mps": 25
    }
  ]
}
\`\`\`

## ⚡ Optimisations Disponibles

### Numba JIT Compilation
\`\`\`python
from numba_kernels.vehicule_numba import calculer_position_numba
# 5-100x speedup pour calculs numériques
\`\`\`

### Cython (compilé en C)
\`\`\`python
from cython_modules.vehicule_cy import Vehicule as VehiculeCython
# Performance native C
\`\`\`

## 📊 Résultats et Analyses

L'outil génère automatiquement:
- Statistiques de trafic en temps réel
- Données d'exportation CSV/JSON
- Graphiques de densité et vitesse

## 📝 License

Distributed under the MIT License. See `LICENSE` for more information.

## 👤 Auteur

**Votre Nom** - votre.email@example.com

## 🙏 Remerciements

- Inspiré par les modèles de trafic IDM (Intelligent Driver Model)
- Utilise NumPy, Numba et Cython pour les optimisations
