How guruchiwate06/path_rl works
This is a 2D multi-agent evacuation simulation and scenario-analysis framework. A user selects a scenario and run mode; the system configures a building and occupants, simulates movement and capacity conflicts, then reports metrics or runs repeated parameter sweeps. Major documented capabilities also include exit-configuration generation, regulatory evaluation and search, agent profiles, and interactive/offline visualization. The README documents the simulation’s main dependency flow; sampled source confirms the timestep loop, movement conflict resolution, experiment orchestration, and visualization. Exit-search implementation files are not present in the supplied tree, so that capability is represented at the simulation-directory level.
Main entry points: simulation.py Timestep simulation · main.py CLI runner · config.py Scenario models · experiment.py Batch experiments
Components 20
Run Interface
- CLI runner
main.py
Scenario Setup
- Scenario JSON
scenarios - Scenario models
simulation/config.py - Candidate exits
simulation/generation.py - Exit compliance and search
simulation
Simulation Engine
- Building grid
simulation/environment.py - Occupant agents
simulation/agent.py - Agent profiles
simulation/profile.py - Navigation graph
simulation/pathfinding.py - Movement strategy
simulation/strategy.py - Cell capacity
simulation/occupancy.py - Move resolution
simulation/movement.py - Timestep simulation
simulation/simulation.py
Analysis Tools
- Run metrics
simulation/metrics.py - Batch experiments
simulation/experiment.py - RL environment
simulation/rl_environment.py - Run outputs
experiment_output
Visualization
- Interactive inspector
visualize.py - Browser visualizer
visualize.html
Other components
- Scenario analyst
Connections 23
- Scenario analyst → CLI runner: selects run
README.md - CLI runner → Scenario JSON: loads scenario
main.py - CLI runner → Scenario models: validates config
README.md - Scenario models → Building grid: defines geometry
README.md - Candidate exits → Exit compliance and search: proposes exits
README.md - Exit compliance and search → Scenario models: selects exits
README.md - Scenario models → Building grid: provides layout
README.md - Building grid → Navigation graph: builds graph
README.md - Occupant agents → Timestep simulation: participate in
README.md - Agent profiles → Timestep simulation: sets eligibility
simulation/simulation.py - Navigation graph → Movement strategy: guides routes
simulation/strategy.py - Movement strategy → Timestep simulation: proposes moves
README.md - Timestep simulation → Move resolution: resolves requests
README.md - Move resolution → Cell capacity: checks capacity
README.md - Timestep simulation → Run metrics: records outcomes
README.md - CLI runner → Timestep simulation: runs simulation
main.py - CLI runner → Batch experiments: starts batch run
main.py - Batch experiments → Timestep simulation: executes runs
simulation/experiment.py - Batch experiments → Run outputs: exports results
README.md - Timestep simulation → RL environment: supports RL interface
- Scenario analyst → Interactive inspector: inspects run
README.md - Interactive inspector → Timestep simulation: displays state
visualize.py - Scenario analyst → Browser visualizer: views visualization
README.md