https://github.com/aliaksei135/uasgroundrisk
Risk quantification of UAS (drones) in the real world using OSM data.
https://github.com/aliaksei135/uasgroundrisk
aviation-safety drones probabilistic-models risk-assessment uas
Last synced: 2 days ago
JSON representation
Risk quantification of UAS (drones) in the real world using OSM data.
- Host: GitHub
- URL: https://github.com/aliaksei135/uasgroundrisk
- Owner: aliaksei135
- License: lgpl-2.1
- Created: 2021-06-16T13:15:33.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-07-11T18:34:25.000Z (11 months ago)
- Last Synced: 2026-06-14T23:34:19.324Z (2 days ago)
- Topics: aviation-safety, drones, probabilistic-models, risk-assessment, uas
- Language: C++
- Homepage:
- Size: 50.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# uasgroundrisk
Ground Risk calculation for Unmanned Aerial Systems.
## Project Overview
uasgroundrisk is a C++ library for calculating ground risk for Unmanned Aerial Systems (UAS). It provides tools for generating risk maps based on population density, road networks, building footprints, and other geospatial data. The library also includes models for aircraft descent and weather conditions to provide a comprehensive risk assessment.
## Modules
The `uasgroundrisk` library is composed of several interconnected modules:
* **GridMap (`gridmap`):** This is a foundational module providing a generic 2D grid data structure. It's used by other modules to store and query spatially referenced data. Each cell in the grid can hold multiple layers of information.
* **Map Generation (`map_gen`):** This module is responsible for creating various types of maps used in risk assessment.
* **PopulationMap:** Generates static population density maps, typically derived from census data. It uses the `GridMap` to store population counts or densities per grid cell.
* **TemporalPopulationMap:** Extends `PopulationMap` to account for changes in population density over time (e.g., day vs. night, weekday vs. weekend). This also utilizes the `GridMap` structure.
* **OSMMap:** Integrates with OpenStreetMap (OSM) data to extract features like roads, buildings, and points of interest. It processes OSM data and can populate `GridMap` layers with relevant information (e.g., building footprints, road locations).
* **GeospatialGridMap:** A specialized `GridMap` that understands geographic coordinate systems and projections, crucial for accurately representing real-world data.
* **Risk Analysis (`risk_analysis`):** This core module performs the actual ground risk calculations.
* **Aircraft Models (`aircraft`):** Contains models for aircraft behavior, particularly descent characteristics (e.g., ballistic descent, glide, parachute). These models help predict the potential impact area in case of an incident.
* **ObstacleMap:** Represents obstacles on the ground, primarily buildings, which can affect aircraft descent paths and shelter populations. This often sources data from `OSMMap`.
* **WeatherMap:** Incorporates weather data, such as wind speed and direction, which can influence an aircraft's trajectory during an emergency descent.
* **RiskMap:** Combines data from `PopulationMap` (or `TemporalPopulationMap`), `AircraftModel`, `ObstacleMap`, and `WeatherMap` to calculate a comprehensive ground risk score for each cell in a `GridMap`. It assesses the probability of an aircraft impacting a given area and the potential consequences based on population and obstacles.
* **IncrementalRiskMap:** An extension of `RiskMap` that allows for efficient updates to the risk assessment as new data (e.g., updated weather, new obstacle information) becomes available, without needing to recalculate everything from scratch.
* **Pathfinding (`pathfinding`):** This module includes algorithms like A* search. While not directly part of risk calculation, it can utilize `RiskMap` outputs to find the safest routes for UAS operations, avoiding high-risk areas.
* **Utilities (`utils`):** Contains helper functions and classes used across the library, such as geometry operations, data fitting algorithms, and projection utilities for handling geospatial coordinate transformations.
These modules work together: `map_gen` creates the foundational data layers (population, OSM features) stored in `GridMap` structures. The `risk_analysis` module then consumes these maps, along with aircraft and weather models, to produce detailed risk assessments, also often stored as `GridMap` layers. The `pathfinding` module can then use these risk maps for operational planning.
### Module Relationships Diagram
```mermaid
graph TD
subgraph CoreDataStructure["Core Data Structure"]
GridMap["GridMap (`gridmap`)
Generic 2D grid"]
end
subgraph DataPreparation["Data Preparation (map_gen)"]
direction LR
CensusData[("Census Data")] --> PopulationMap
OSMData[("OpenStreetMap Data")] --> OSMMap
PopulationMap["PopulationMap
Static population density"] --> GridMap
TemporalPopulationMap["TemporalPopulationMap
Time-varying population"] --> PopulationMap
OSMMap["OSMMap
Roads, Buildings, POIs"] --> GridMap
GeospatialGridMap["GeospatialGridMap
Geo-aware GridMap"] --> GridMap
end
subgraph RiskCalculation["Risk Calculation (risk_analysis)"]
direction LR
AircraftModels["AircraftModels (`aircraft`)
Descent characteristics"]
ObstacleMap["ObstacleMap
Building footprints, etc."]
WeatherMap["WeatherMap
Wind speed/direction"]
OSMMap --> ObstacleMap
PopulationMap --> RiskMapComponent["RiskMap Components"]
TemporalPopulationMap --> RiskMapComponent
AircraftModels --> RiskMapComponent
ObstacleMap --> RiskMapComponent
WeatherMap --> RiskMapComponent
RiskMapComponent --> RiskMap["RiskMap
Comprehensive risk score"]
RiskMap --> GridMap
IncrementalRiskMap["IncrementalRiskMap
Efficient updates"] --> RiskMap
end
subgraph Applications["Applications (pathfinding)"]
direction LR
RiskMap --> Pathfinding["Pathfinding
A* search for safe routes"]
end
subgraph SharedServices["Shared Services (utils)"]
Utils["Utilities
Geometry ops, Projections, Data fitting"]
end
Utils --> GridMap
Utils --> PopulationMap
Utils --> TemporalPopulationMap
Utils --> OSMMap
Utils --> GeospatialGridMap
Utils --> AircraftModels
Utils --> ObstacleMap
Utils --> WeatherMap
Utils --> RiskMap
Utils --> IncrementalRiskMap
Utils --> Pathfinding
classDef default fill:#f9f,stroke:#333,stroke-width:1px,font-family:arial,font-size:12px;
classDef subgraphStyle fill:#eee,stroke:#999,stroke-width:1px,rx:5,ry:5,color:#333;
classDef dataInput fill:#lightgrey,stroke:#333,stroke-width:1px;
class CoreDataStructure,DataPreparation,RiskCalculation,Applications,SharedServices subgraphStyle;
class CensusData,OSMData dataInput;
```
## Dependencies
This project uses [Conan](https://conan.io/) to manage dependencies. To install the dependencies, you will need to have Conan installed.
```bash
# Install dependencies using Conan
conan install . --output-folder=build --build=missing
```
## Building the Project
This project uses CMake for building.
```bash
# Create a build directory
mkdir build && cd build
# Configure CMake
# Replace with the actual path to the conan_toolchain.cmake file generated by conan install
# e.g., build/conan_toolchain.cmake if you ran conan install from the project root and specified --output-folder=build
cmake .. -DCMAKE_TOOLCHAIN_FILE=
# Build the project
cmake --build .
```
### Build Options
* `UGR_BUILD_TESTS`: Set to `ON` to build tests (default: `OFF`).
```bash
cmake .. -DCMAKE_TOOLCHAIN_FILE= -DUGR_BUILD_TESTS=ON
```
* `UGR_BUILD_DOCS`: Set to `ON` to build documentation (default: `OFF`).
```bash
cmake .. -DCMAKE_TOOLCHAIN_FILE= -DUGR_BUILD_DOCS=ON
```
## Running Tests
If you built the project with `UGR_BUILD_TESTS=ON`, you can run the tests using CTest:
```bash
# From the build directory
ctest
```
## License
This project is licensed under the GNU Lesser General Public License v2.1 - see the [LICENSE](LICENSE) file for details.