LEACH vs LEACH-C Simulation

Discrete event simulation of LEACH and LEACH-C clustering protocols for wireless sensor networks with node mobility.

Installation

With Poetry:

poetry install
poetry run python code/main.py

With pip:

pip install -r requirements.txt
python3 code/main.py

Running

Default (lightweight simulator):

python3 code/main.py

With hybrid full-featured simulator:

python3 code/main.py --simpy-hybrid

Simulators

Two SimPy implementations available:

1. Lightweight - Simple event-driven wrapper (120 lines)
2. Hybrid - Full discrete event simulator with parallel processes (470 lines)

Both generate identical results. See HYBRID_APPROACH.md for comparison.

Output

Generated files in results/:

• simulation_results_dynamic.json - Dynamic network results
• simulation_results_static.json - Static network results
• comparison_static_dynamic.csv - Comparison table
• PNG graphs comparing metrics

Configuration

Edit code/config.py to change:

• Network size, packet size
• Energy parameters
• Simulation scenarios
• ENABLE_MOBILITY flag (static vs dynamic)

Structure

code/
  ├── main.py                    - Simulation controller
  ├── leach.py, leach_c.py      - Protocol implementations
  ├── node.py                    - Node class
  ├── metrics.py                 - Performance metrics
  ├── config.py                  - Configuration
  ├── simpy_simulator.py         - Lightweight wrapper
  ├── simpy_simulator_hybrid.py  - Full hybrid simulator
  └── analysis.py                - Analysis and plotting

results/ - Generated simulation outputs
rapport/ - Final report

Metrics

10 performance metrics calculated:

• First Dead Node (FDN)
• First Muted Round (FMR)
• Dynamic Load Balancing Index (DLBI)
• Relative Silence Period Index (RSPI)
• Energy consumption
• Packet statistics
• Node statistics

Scenarios

6 test scenarios with varying:

• Packet sizes (2000-4000 bits)
• Activity probability (0.05-0.95)
• Network size (100-200 nodes)