How potatoish/disaster-route-sim works
AGNAS is a pre-disaster evacuation route simulator for two Pasig barangays. A visitor selects a barangay and hazard, places map pins, and runs a simulation: flood runs seek routes between two pins, while earthquake runs seek evacuation sites. The Flask app queues simulation work and returns ranked route results for the interactive map. The README documents map layers, route alternatives and reports, responsive controls, tutorial and hotline content, plus contact and feedback features. Some API and data-loading details are not shown in the excerpts, so those links rely on README statements or are omitted.
Main entry points: app.py Flask app and job queue · script.js Simulator interface · osm_routing.py Flood route search · earthquake_data.py Earthquake data loading
Components 21
Web experience
- Simulator interface
Frontend/static/script.js - Mobile layout
Frontend/static/mobile-sim.js - Route map
Frontend/static/osm.js - Flood views
Frontend/static/flood.js - Earthquake views
Frontend/static/earthquake.js - Tutorial
Frontend/static/tutorial.js - Pages and contacts
Frontend/templates
Application API
- Flask app and job queue
Backend/app.py - Simulation progress
Backend/simulation_progress.py
Routing and hazards
- Flood request validation
Backend/main.py - Flood route search
Backend/osm_routing.py - Earthquake routing
Backend/earthquake_service.py - Earthquake data loading
Backend/earthquake_data.py
Geospatial data
- Barangay boundaries
Backend/data/boundaries - Walking road graphs
Backend/data/graphs - Flood hazard layers
Backend/data/flood_classes - Earthquake hazard layers
Backend/data/earthquake
Visitor services
- Contact and feedback
Backend/contact_service.py - Resend email
- Google Sheet
Other components
- Visitor
Connections 24
- Visitor → Simulator interface: sets pins
README.md - Simulator interface → Flask app and job queue: submits simulation
Frontend/static/script.js - Flask app and job queue → Flood request validation: dispatches flood
Backend/app.py - Flood request validation → Flood route search: calls route search
Backend/main.py - Flask app and job queue → Earthquake routing: dispatches earthquake
Backend/app.py - Flask app and job queue → Simulation progress: tracks progress
Backend/app.py - Flood route search → Barangay boundaries: reads boundaries
- Flood route search → Walking road graphs: uses road network
README.md - Flood route search → Flood hazard layers: uses flood layers
README.md - Earthquake routing → Earthquake data loading: loads dataset
Backend/earthquake_service.py - Earthquake routing → Flood route search: reuses routing core
README.md - Earthquake data loading → Earthquake hazard layers: reads hazard layers
- Earthquake data loading → Barangay boundaries: uses boundaries
- Earthquake data loading → Walking road graphs: uses road graphs
- Flask app and job queue → Simulator interface: returns results
- Simulator interface → Route map: draws routes
README.md - Simulator interface → Flood views: shows flood results
README.md - Simulator interface → Earthquake views: shows quake views
README.md - Visitor → Mobile layout: uses responsive controls
README.md - Visitor → Tutorial: opens guidance
README.md - Visitor → Pages and contacts: visits pages
README.md - Flask app and job queue → Contact and feedback: routes submissions
Backend/app.py - Contact and feedback → Resend email: sends email
Backend/contact_service.py - Contact and feedback → Google Sheet: records feedback
Backend/contact_service.py