Metadata-Version: 2.1
Name: simulateur-trafic-ahmed-hamed-2025
Version: 1.0.0
Summary: A traffic simulation application
Home-page: https://github.com/ahmedhdhd/simulateur_trafic
Author: Ahmed Hamed
Author-email: ahmad.hamed.work@gmail.com
License: MIT
Project-URL: Homepage, https://github.com/ahmedhdhd/simulateur_trafic
Project-URL: Repository, https://github.com/ahmedhdhd/simulateur_trafic
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: numpy>=1.21.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: cython>=0.29.0; extra == "dev"
Requires-Dist: numba>=0.50.0; extra == "dev"
Provides-Extra: optimize
Requires-Dist: cython>=0.29.0; extra == "optimize"
Requires-Dist: numba>=0.50.0; extra == "optimize"


 

# Simulateur de Trafic (Traffic Simulator)

**Simulateur de Trafic** is a Python package for simulating vehicle traffic on customizable road networks.
It models vehicle motion, road connections, and collects useful traffic statistics for analysis and optimization.

 

## Features

* Vehicle movement simulation on a configurable road network
* Roads with speed limits and lengths
* Traffic statistics (speed, flow, time)
* Results exportable to CSV or JSON
* Fully customizable through a JSON configuration file
 
 

## Installation

### From PyPI

```bash
pip install simulateur-trafic-ahmed-hamed-2025
```

### For development (editable mode)

```bash
pip install -e .
```

---

## Usage

### Default execution

```bash
simulateur-trafic
```

Runs the simulation with:

* `n_tours=5`
* `delta_t=60` (seconds)
* `config=config_reseau.json`

---

### Custom parameters

You can specify the number of simulation turns, time step, and configuration file path:

```bash
simulateur-trafic --n_tours 10 --delta_t 30 --config config_reseau.json
```

Or run it directly from Python:

```bash
python -m simulateur_trafic.main --n_tours 10 --delta_t 30 --config config_reseau.json
```

---

## License

This project is licensed under the **MIT License**.
See the `LICENSE` file for details.

---

## Author

**Ahmed Hamed**
📧 [ahmad.hamed.work@gmail.com](mailto:ahmad.hamed.work@gmail.com)

---

 
