How irenemarta/macromobilitysumoagent works
Macro Mobility SUMO Agent combines a conversational scenario interface with a traffic digital-twin pipeline. A user describes a what-if change; the agent validates the request, resolves it against the road index, and submits a scenario for simulation and comparison with a baseline. The twin prepares demand and zones, performs iterative assignment and SUMO simulation, and provides analysis and sensor-validation capabilities. Relationships for unsampled modules are included only where the README or SOURCE INDEX supports them; implementation details of those modules were not inspected.
Main entry points: run.py What-if runner · agente.py Request agent · motore.py Scenario engine · config.py Twin configuration
Components 28
Conversational agent
- Web and CLI
src/agent/app.py - Request agent
src/agent/agente.py - Agent settings
src/agent/configurazione.py - Road index
src/agent/indice_rete.py - Request resolution
src/agent/risolvi.py - Scenario engine
src/agent/motore.py - Simulation interface
src/agent/simula.py
Twin inputs
- Twin configuration
src/dtsumo/inputs/config.py - Input database
src/dtsumo/inputs/database.py - OD preparation
src/dtsumo/inputs/dayODs.py - TAZ zones
src/dtsumo/operations/taz_zones.py - Assignment entities
src/dtsumo/modules/entities.py
Assignment and scenarios
- Assignment orchestration
src/dtsumo/operations/assignment.py - Iterative assignment
src/dtsumo/operations/marouter_cycle.py - OD extension
src/dtsumo/operations/od_extension.py - SUMO tool commands
src/dtsumo/operations/cmd.py - Scenario interpretation
src/dtsumo/whatif/scenario.py - Scenario network
src/dtsumo/whatif/network.py - What-if runner
src/dtsumo/whatif/run.py
Analysis and validation
- Detector processing
src/dtsumo/tools/detectors.py - Scenario comparison
src/dtsumo/analysis/compare.py - Sensor analysis
src/dtsumo/analysis/sensors.py - Sensor validation
src/dtsumo/analysis/sensors_validation.py - Result maps
src/dtsumo/analysis/maps.py - SUMO results
src/dtsumo/analysis/sumoResults.py
Other components
- User
- SUMO simulator
- CinqueT sensor data
Connections 34
- User → Web and CLI: submits request
- Web and CLI → Request agent: routes interaction
src/agent/app.py - Request agent → Agent settings: loads settings
src/agent/agente.py - Request agent → Road index: looks up roads
src/agent/agente.py - Request agent → Request resolution: validates request
src/agent/agente.py - Request agent → Scenario engine: invokes tools
src/agent/agente.py - Scenario engine → Scenario interpretation: uses scenario format
src/agent/motore.py - Scenario engine → What-if runner: runs scenario
src/agent/motore.py - Scenario engine → Twin configuration: reads configuration
src/agent/motore.py - Web and CLI → Simulation interface: starts simulation
src/agent/app.py - Simulation interface → Scenario engine: coordinates execution
src/agent/simula.py - Simulation interface → Scenario comparison: compares results
src/agent/simula.py - What-if runner → Scenario interpretation: resolves interventions
src/dtsumo/whatif/run.py - What-if runner → Scenario network: builds scenario network
src/dtsumo/whatif/run.py - What-if runner → Assignment orchestration: runs assignment
src/dtsumo/whatif/run.py - What-if runner → OD extension: extends demand
src/dtsumo/whatif/run.py - What-if runner → Detector processing: uses detectors
src/dtsumo/whatif/run.py - What-if runner → SUMO simulator: runs simulation
src/dtsumo/whatif/run.py - Assignment orchestration → TAZ zones: uses zones
src/dtsumo/operations/assignment.py - Assignment orchestration → Iterative assignment: runs cycles
src/dtsumo/operations/assignment.py - Assignment orchestration → OD extension: extends OD
src/dtsumo/operations/assignment.py - Iterative assignment → SUMO tool commands: invokes tools
src/dtsumo/operations/marouter_cycle.py - Iterative assignment → SUMO simulator: simulates rounds
src/dtsumo/operations/marouter_cycle.py - TAZ zones → Assignment entities: builds context
src/dtsumo/operations/taz_zones.py - OD extension → SUMO tool commands: invokes routing
src/dtsumo/operations/od_extension.py - Input database → Twin configuration: uses paths
src/dtsumo/inputs/database.py - OD preparation → Twin configuration: uses settings
src/dtsumo/inputs/dayODs.py - Scenario comparison → Twin configuration: reads settings
src/dtsumo/analysis/compare.py - Sensor validation → Result maps: uses map analysis
src/dtsumo/analysis/sensors_validation.py - Sensor validation → Sensor analysis: uses sensor analysis
src/dtsumo/analysis/sensors_validation.py - Sensor validation → Detector processing: uses detector data
src/dtsumo/analysis/sensors_validation.py - Sensor validation → CinqueT sensor data: validates against
- Result maps → Detector processing: uses detector data
src/dtsumo/analysis/maps.py - SUMO results → Twin configuration: uses settings
src/dtsumo/analysis/sumoResults.py