How spk-22/urban_el works
This is a Bengaluru urban-infrastructure cascading-failure research project. Researchers reconstruct road, power, and water networks, seed disruptions, and simulate layer-specific failure propagation; Phase 2 maps dependencies and iterates coupled cascades, then compares scenarios and sensitivities. The graph preserves the documented validation, spatial-map, and coupling-hierarchy branches. Source excerpts show key model behavior and some orchestration; several analysis steps are represented by their indexed entry-point files, so uncertain internal calls are omitted.
Main entry points: graph_builder.py Graph builder · run_all_phase1_validation.py Phase 1 validation · run_phase2_analysis.py Phase 2 analysis · plot_m7_propagation_curves.py M7 propagation analysis
Components 20
Network reconstruction
- Graph builder
models/graph_builder.py - Road network
models/graph_builder.py - Power network
models/graph_builder.py - Water network
models/graph_builder.py
Single-layer cascades
- Road cascade
models/road_cascade.py - Power cascade
models/power_cascade.py - Water cascade
models/water_cascade.py - Phase 1 validation
simulations/run_all_phase1_validation.py
Cross-layer coupling
- Dependency mapper
models/dependency_mapper.py - Coupled cascade controller
models/multi_layer_cascade.py - Phase 2 analysis
simulations/run_phase2_analysis.py
Research analysis
- Coupling hierarchy experiments
simulations/run_coupling_hierarchy.py - M7 propagation analysis
simulations/plot_m7_propagation_curves.py - Phase 1 findings
PHASE1_REPORT.md - Phase 2 findings
PHASE2_REPORT.md
Maps and results
- Phase 2 result tables
phase2_results/tables - Spatial maps
simulations/generate_spatial_maps.py - Map outputs
outputs/figures
Other components
- Researcher
- Processed networks
processed
Connections 33
- Researcher → Phase 1 validation: runs validation
README.md - Researcher → Phase 2 analysis: runs analysis
README.md - Processed networks → Graph builder: supplies network data
- Graph builder → Road network: reconstructs
models/graph_builder.py - Graph builder → Power network: reconstructs
models/graph_builder.py - Graph builder → Water network: reconstructs
models/graph_builder.py - Phase 1 validation → Graph builder: builds graphs
simulations/run_all_phase1_validation.py - Phase 1 validation → Road cascade: runs scenarios
simulations/run_all_phase1_validation.py - Phase 1 validation → Power cascade: runs scenarios
simulations/run_all_phase1_validation.py - Phase 1 validation → Water cascade: runs scenarios
simulations/run_all_phase1_validation.py - Phase 1 validation → Phase 1 findings: informs findings
- Phase 2 analysis → Graph builder: builds graphs
simulations/run_phase2_analysis.py - Phase 2 analysis → Dependency mapper: maps dependencies
simulations/run_phase2_analysis.py - Phase 2 analysis → Coupled cascade controller: runs coupled cases
simulations/run_phase2_analysis.py - Dependency mapper → Coupled cascade controller: provides dependency maps
models/multi_layer_cascade.py - Coupled cascade controller → Power cascade: runs inner cascade
models/multi_layer_cascade.py - Coupled cascade controller → Water cascade: runs inner cascade
models/multi_layer_cascade.py - Coupled cascade controller → Road cascade: runs inner cascade
models/multi_layer_cascade.py - Phase 2 analysis → Phase 2 result tables: records comparisons
- Phase 2 analysis → Phase 2 findings: informs findings
- Researcher → Coupling hierarchy experiments: runs experiments
README.md - Coupling hierarchy experiments → Graph builder: builds graphs
simulations/run_coupling_hierarchy.py - Coupling hierarchy experiments → Dependency mapper: maps dependencies
simulations/run_coupling_hierarchy.py - Coupling hierarchy experiments → Coupled cascade controller: tests coupling models
simulations/run_coupling_hierarchy.py - Researcher → M7 propagation analysis: inspects propagation
- M7 propagation analysis → Graph builder: builds graphs
simulations/plot_m7_propagation_curves.py - M7 propagation analysis → Dependency mapper: maps dependencies
simulations/plot_m7_propagation_curves.py - M7 propagation analysis → Power cascade: runs cascade
simulations/plot_m7_propagation_curves.py - M7 propagation analysis → Water cascade: runs cascade
simulations/plot_m7_propagation_curves.py - M7 propagation analysis → Road cascade: runs cascade
simulations/plot_m7_propagation_curves.py - Researcher → Spatial maps: generates maps
README.md - Spatial maps → Graph builder: builds graphs
simulations/generate_spatial_maps.py - Spatial maps → Map outputs: writes maps
simulations/generate_spatial_maps.py