# generalized-intelligence/gaas architecture

> Architecture diagram of the GitHub repository generalized-intelligence/gaas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/generalized-intelligence/gaas
- Repository: https://github.com/generalized-intelligence/gaas

## Overview

GAAS is a modular autonomous-flight framework for drones and VTOL aircraft. Its documented operational workflow combines lidar-based localization and mapping with path planning and flight control; simulation supplies lidar and camera environments. The tree exposes Fast GICP/NDT implementations and a PX4/MAVROS controller, but does not show how the current modules are wired together, so those broader workflow links are documented rather than inferred from source. Other README-listed capabilities are represented as subsystems at their existing directories because their implementations were not sampled.

Main entry points: [`algorithms/src/LocalizationAndMapping`](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping) (Map Localization), [`algorithms/src`](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src) (A* Planner), [`simulation`](https://github.com/generalized-intelligence/gaas/tree/main/simulation) (Sensor Simulation), [`algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_gicp.cpp`](https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_gicp.cpp) (Fast GICP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_localization["Localization and Mapping"]
  node_gicp["Fast GICP<br/>[fast_gicp.cpp]"]
  node_vgicp["Voxel GICP<br/>[fast_vgicp.cpp]"]
  node_ndt["NDT CUDA<br/>[ndt_cuda.cpp]"]
  node_maplocal["Map Localization"]
  node_imu["IMU Preintegration"]
  node_hdmap["HD Map Relocalization"]
end

subgraph group_perception["Lidar Perception"]
  node_lidarimage["Lidar Projection"]
  node_groundremove["Ground Removal"]
  node_clustering["Euclidean Clustering"]
  node_mapbuild["Map Building"]
end

subgraph group_navigation["Navigation and Control"]
  node_planner["A* Planner"]
  node_replanning["Dynamic Replanning"]
  node_targetgui["HD Map Target GUI"]
  node_px4["PX4 Commander"]
  node_flightstate["Flight State"]
  node_surveillance["State Surveillance"]
end

subgraph group_simulation["Simulation"]
  node_sim["Sensor Simulation"]
  node_velodyne["Velodyne Plugin"]
  node_livox["Livox Simulation"]
end

node_operator(("Flight Operator"))
node_lidar(("Lidar Sensor"))

node_operator -.->|"selects target"| node_targetgui
node_lidar -.->|"provides scans"| node_gicp
node_lidar -.->|"provides scans"| node_ndt
node_gicp -.->|"supports localization"| node_maplocal
node_vgicp -.->|"supports localization"| node_maplocal
node_ndt -.->|"matches map"| node_maplocal
node_maplocal -.->|"informs navigation"| node_planner
node_imu -.->|"aids localization"| node_maplocal
node_hdmap -.->|"supports relocalization"| node_maplocal
node_lidar -.->|"projects points"| node_lidarimage
node_lidarimage -.->|"provides point data"| node_clustering
node_lidar -.->|"provides point cloud"| node_groundremove
node_mapbuild -.->|"builds map"| node_hdmap
node_planner -.->|"guides flight"| node_px4
node_targetgui -.->|"sets destination"| node_planner
node_replanning -.->|"updates route"| node_planner
node_flightstate -.->|"manages flight state"| node_px4
node_surveillance -.->|"monitors state"| node_flightstate
node_sim -.->|"simulates sensors"| node_lidar
node_velodyne -.->|"provides lidar"| node_sim
node_livox -.->|"provides lidar"| node_sim

click node_gicp "https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_gicp.cpp"
click node_vgicp "https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_vgicp.cpp"
click node_ndt "https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/ndt/ndt_cuda.cpp"
click node_maplocal "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping"
click node_imu "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping"
click node_hdmap "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping"
click node_lidarimage "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src"
click node_groundremove "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src"
click node_clustering "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src"
click node_mapbuild "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping"
click node_planner "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src"
click node_replanning "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src"
click node_targetgui "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src"
click node_px4 "https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/Navigation/px4_mavros_controller/src/px4_mavros_controller.cpp"
click node_flightstate "https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/SystemManagement/basic_state_libs/src/flight_controller_state.h"
click node_surveillance "https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src"
click node_sim "https://github.com/generalized-intelligence/gaas/tree/main/simulation"
click node_velodyne "https://github.com/generalized-intelligence/gaas/blob/main/simulation/simulation_with_velodyne_in_gazebo9_ws/src/velodyne_simulator/velodyne_gazebo_plugins/src/GazeboRosVelodyneLaser.cpp"
click node_livox "https://github.com/generalized-intelligence/gaas/blob/main/simulation/src/livox_horizon_simulation/src/livox_horizon_simulation_node.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gicp,node_vgicp,node_ndt,node_maplocal,node_imu,node_hdmap toneBlue
class node_lidarimage,node_groundremove,node_clustering,node_mapbuild toneAmber
class node_planner,node_replanning,node_targetgui,node_px4,node_flightstate,node_surveillance toneMint
class node_sim,node_velodyne,node_livox toneRose
class node_operator,node_lidar toneIndigo
```

## Components

### Localization and Mapping

- [Fast GICP](https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_gicp.cpp): `algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_gicp.cpp`
- [Voxel GICP](https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_vgicp.cpp): `algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/gicp/fast_vgicp.cpp`
- [NDT CUDA](https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/ndt/ndt_cuda.cpp): `algorithms/src/LocalizationAndMapping/icp_lidar_localization/fast_gicp/src/fast_gicp/ndt/ndt_cuda.cpp`
- [Map Localization](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping): `algorithms/src/LocalizationAndMapping`
- [IMU Preintegration](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping): `algorithms/src/LocalizationAndMapping`
- [HD Map Relocalization](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping): `algorithms/src/LocalizationAndMapping`

### Lidar Perception

- [Lidar Projection](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src): `algorithms/src`
- [Ground Removal](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src): `algorithms/src`
- [Euclidean Clustering](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src): `algorithms/src`
- [Map Building](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src/LocalizationAndMapping): `algorithms/src/LocalizationAndMapping`

### Navigation and Control

- [A* Planner](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src): `algorithms/src`
- [Dynamic Replanning](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src): `algorithms/src`
- [HD Map Target GUI](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src): `algorithms/src`
- [PX4 Commander](https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/Navigation/px4_mavros_controller/src/px4_mavros_controller.cpp): `algorithms/src/Navigation/px4_mavros_controller/src/px4_mavros_controller.cpp`
- [Flight State](https://github.com/generalized-intelligence/gaas/blob/main/algorithms/src/SystemManagement/basic_state_libs/src/flight_controller_state.h): `algorithms/src/SystemManagement/basic_state_libs/src/flight_controller_state.h`
- [State Surveillance](https://github.com/generalized-intelligence/gaas/tree/main/algorithms/src): `algorithms/src`

### Simulation

- [Sensor Simulation](https://github.com/generalized-intelligence/gaas/tree/main/simulation): `simulation`
- [Velodyne Plugin](https://github.com/generalized-intelligence/gaas/blob/main/simulation/simulation_with_velodyne_in_gazebo9_ws/src/velodyne_simulator/velodyne_gazebo_plugins/src/GazeboRosVelodyneLaser.cpp): `simulation/simulation_with_velodyne_in_gazebo9_ws/src/velodyne_simulator/velodyne_gazebo_plugins/src/GazeboRosVelodyneLaser.cpp`
- [Livox Simulation](https://github.com/generalized-intelligence/gaas/blob/main/simulation/src/livox_horizon_simulation/src/livox_horizon_simulation_node.cpp): `simulation/src/livox_horizon_simulation/src/livox_horizon_simulation_node.cpp`

### Other components

- **Flight Operator**
- **Lidar Sensor**

## Connections

- Flight Operator → HD Map Target GUI: selects target (evidence: `README.md`)
- Lidar Sensor → Fast GICP: provides scans (evidence: `README.md`)
- Lidar Sensor → NDT CUDA: provides scans (evidence: `README.md`)
- Fast GICP → Map Localization: supports localization (evidence: `README.md`)
- Voxel GICP → Map Localization: supports localization (evidence: `README.md`)
- NDT CUDA → Map Localization: matches map (evidence: `README.md`)
- Map Localization → A* Planner: informs navigation (evidence: `README.md`)
- IMU Preintegration → Map Localization: aids localization (evidence: `README.md`)
- HD Map Relocalization → Map Localization: supports relocalization (evidence: `README.md`)
- Lidar Sensor → Lidar Projection: projects points (evidence: `README.md`)
- Lidar Projection → Euclidean Clustering: provides point data (evidence: `README.md`)
- Lidar Sensor → Ground Removal: provides point cloud (evidence: `README.md`)
- Map Building → HD Map Relocalization: builds map (evidence: `README.md`)
- A* Planner → PX4 Commander: guides flight (evidence: `README.md`)
- HD Map Target GUI → A* Planner: sets destination (evidence: `README.md`)
- Dynamic Replanning → A* Planner: updates route (evidence: `README.md`)
- Flight State → PX4 Commander: manages flight state (evidence: `README.md`)
- State Surveillance → Flight State: monitors state (evidence: `README.md`)
- Sensor Simulation → Lidar Sensor: simulates sensors (evidence: `README.md`)
- Velodyne Plugin → Sensor Simulation: provides lidar (evidence: `README.md`)
- Livox Simulation → Sensor Simulation: provides lidar (evidence: `README.md`)
