ResQRoute is a sophisticated 3D simulation environment built in Unity, designed for visualizing and optimizing disaster response logistics. By leveraging real-world geospatial data from OpenStreetMap (OSM), the system generates a 1:1 scale virtual city. It integrates dynamic pathfinding, volumetric population estimation, and interactive disaster zoning to test rescue station placements and route efficiency in real-time.
- 1:1 Real-World Mapping: Procedural city generation using OpenStreetMap XML data.
- Dynamic Pathfinding: Optimized A* (A-Star) algorithm that adapts to road closures and disaster zones.
- Disaster Zoning: Interactive tools for defining flood, fire, or earthquake zones (Circular and Polygonal).
- Resource Planning: Automated calculations for affected populations and required rescue capacity based on 3D building volume.
- Real-time Visualization: High-performance rendering of evacuation and supply routes.
- Unity Hub
- Unity 2022.3 LTS (Recommended) or higher.
- Universal Render Pipeline (URP) support.
- Clone the Repository:
git clone https://github.com/MudasserKhan/ResQRoute.git
- Open in Unity:
- Launch Unity Hub.
- Click Add -> Add project from disk.
- Select the
ResQRoutefolder.
- Setup Scene:
- Open
Assets/Scenes/Main.unity(or whichever scene you intend to run). - Ensure the
OSMImportercomponent has a valid.xmlmap file path (e.g.,Assets/map.xml).
- Open
- Define Infrastructure: Right-click any building in the scene to tag it as a Rescue Station or Hospital.
- Simulate Disaster: Use the on-screen UI buttons or hotkeys:
X: Circle Tool (Click and drag to define a radius).Y: Polygon Tool (Click to place points, close the loop).
- Analyze: Watch as the system calculates the most efficient paths from stations to the disaster edge, and from the edge to hospitals. Results are displayed on the Simulation Dashboard.
- Engine: Unity 3D (C#)
- Algorithms: A* Search, Ear Clipping (Triangulation), Mercator Projection, Raycasting (Point-in-Polygon).
- Data Source: OpenStreetMap (OSM) XML.
We are looking for contributors to help finish this project and take it to the next level! This project is currently in an "unfinished but functional" state and has transition to an Open Source model.
See CONTRIBUTING.md for detailed instructions on how to get started.
- Traffic Simulation: Adding moving agents to simulate congestion during evacuation.
- C++ Backend: Moving heavy pathfinding calculations to a C++ library for maximum performance.
- Visual Enhancements: Better shaders for disaster zones and detailed building models.
- Bug Fixes: Refinement of the Ear Clipping algorithm for very complex building footprints.
Check out ISSUES.md for a list of prioritized tasks and suggestions for new contributors.
This project is open-sourced under the MIT License. Use it, improve it, and help save lives!
Developed by Mudasser Khan
Project Title: ResQRoute
Domain: Disaster Management / Smart City Simulation