# aniket-gupt/terrain-following-quad-using-dem architecture

> Architecture diagram of the GitHub repository aniket-gupt/terrain-following-quad-using-dem, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aniket-gupt/terrain-following-quad-using-dem
- Repository: https://github.com/aniket-gupt/terrain-following-quad-using-dem

## Overview

This repository implements a PX4 UAV terrain-following mission: it reads waypoint plans and DEM terrain, creates terrain-adjusted altitudes, then monitors flight and revises mission altitudes when AGL error exceeds 5 m. The runtime workflow is centered in terrainfollow.py; dem.py is a separate DEM viewing and elevation-query utility. The map reflects only relationships visible in the supplied excerpts or README; unsampled implementation details are omitted.

Main entry points: [`terrainfollow.py`](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py) (Mission Runtime), [`output_be.tif`](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/output_be.tif) (Elevation Raster), [`dem.py`](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/dem.py) (DEM Viewer), [`old5.plan`](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/old5.plan) (Mission Plan)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Mission and Terrain Inputs"]
  node_plan["Mission Plan<br/>[old5.plan]"]
  node_plan_loader["Waypoint Loader<br/>[terrainfollow.py]"]
  node_dem_file["Elevation Raster<br/>[output_be.tif]"]
  node_terrain_map["Terrain Map<br/>[terrainfollow.py]"]
  node_dem_viewer["DEM Viewer<br/>[dem.py]"]
end

subgraph group_planning["Altitude Planning"]
  node_mission_planner["Terrain Mission Planner<br/>[terrainfollow.py]"]
  node_waypoint_builder["Waypoint Builder<br/>[terrainfollow.py]"]
end

subgraph group_flight["Flight Control"]
  node_runtime["Mission Runtime<br/>[terrainfollow.py]"]
  node_aircraft["PX4 Aircraft"]
  node_connection["Aircraft Connection<br/>[terrainfollow.py]"]
  node_mission_control["Mission Control<br/>[terrainfollow.py]"]
  node_takeoff["Takeoff Sequence<br/>[terrainfollow.py]"]
end

subgraph group_monitoring["Monitoring and Adjustment"]
  node_progress["Mission Progress<br/>[terrainfollow.py]"]
  node_telemetry["Position Telemetry"]
  node_altitude_check["Altitude Check<br/>[terrainfollow.py]"]
  node_update_policy["Update Policy<br/>[terrainfollow.py]"]
  node_altitude_updater["Altitude Updater<br/>[terrainfollow.py]"]
  node_completion["Mission Completion Check<br/>[terrainfollow.py]"]
end

node_operator(("Mission Operator"))

node_operator -.->|"starts"| node_runtime
node_runtime -->|"loads waypoints"| node_plan_loader
node_plan_loader -->|"reads"| node_plan
node_runtime -->|"loads terrain"| node_terrain_map
node_terrain_map -->|"reads raster"| node_dem_file
node_dem_viewer -->|"opens raster"| node_dem_file
node_runtime -->|"connects"| node_connection
node_connection -->|"connects MAVSDK"| node_aircraft
node_runtime -->|"prepares mission"| node_mission_planner
node_mission_planner -->|"samples elevations"| node_terrain_map
node_mission_planner -->|"builds waypoints"| node_waypoint_builder
node_runtime -->|"uploads mission"| node_mission_control
node_mission_control -->|"uploads and starts"| node_aircraft
node_runtime -->|"starts takeoff"| node_takeoff
node_takeoff -->|"arms and takes off"| node_aircraft
node_runtime -->|"checks progress"| node_progress
node_progress -->|"reads mission state"| node_aircraft
node_runtime -->|"checks periodically"| node_altitude_check
node_altitude_check -->|"reads position"| node_telemetry
node_altitude_check -->|"samples ground height"| node_terrain_map
node_runtime -->|"tests altitude error"| node_update_policy
node_update_policy -->|"requests revision"| node_altitude_updater
node_altitude_updater -->|"samples waypoint terrain"| node_terrain_map
node_altitude_updater -->|"rebuilds waypoints"| node_waypoint_builder
node_altitude_updater -->|"replaces mission"| node_mission_control
node_runtime -->|"checks endpoint"| node_completion
node_completion -->|"reads position"| node_telemetry

click node_runtime "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_plan "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/old5.plan"
click node_plan_loader "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_dem_file "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/output_be.tif"
click node_terrain_map "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_dem_viewer "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/dem.py"
click node_mission_planner "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_waypoint_builder "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_connection "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_mission_control "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_takeoff "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_progress "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_altitude_check "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_update_policy "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_altitude_updater "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"
click node_completion "https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py"

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_plan,node_plan_loader,node_dem_file,node_terrain_map,node_dem_viewer toneBlue
class node_mission_planner,node_waypoint_builder toneAmber
class node_runtime,node_aircraft,node_connection,node_mission_control,node_takeoff toneMint
class node_progress,node_telemetry,node_altitude_check,node_update_policy,node_altitude_updater,node_completion toneRose
class node_operator toneIndigo
```

## Components

### Mission and Terrain Inputs

- [Mission Plan](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/old5.plan): `old5.plan`
- [Waypoint Loader](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [Elevation Raster](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/output_be.tif): `output_be.tif`
- [Terrain Map](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [DEM Viewer](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/dem.py): `dem.py`

### Altitude Planning

- [Terrain Mission Planner](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [Waypoint Builder](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`

### Flight Control

- [Mission Runtime](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- **PX4 Aircraft**
- [Aircraft Connection](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [Mission Control](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [Takeoff Sequence](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`

### Monitoring and Adjustment

- [Mission Progress](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- **Position Telemetry**
- [Altitude Check](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [Update Policy](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [Altitude Updater](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`
- [Mission Completion Check](https://github.com/aniket-gupt/terrain-following-quad-using-dem/blob/main/terrainfollow.py): `terrainfollow.py`

### Other components

- **Mission Operator**

## Connections

- Mission Operator → Mission Runtime: starts
- Mission Runtime → Waypoint Loader: loads waypoints (evidence: `terrainfollow.py`)
- Waypoint Loader → Mission Plan: reads (evidence: `terrainfollow.py`)
- Mission Runtime → Terrain Map: loads terrain (evidence: `terrainfollow.py`)
- Terrain Map → Elevation Raster: reads raster (evidence: `terrainfollow.py`)
- DEM Viewer → Elevation Raster: opens raster (evidence: `dem.py`)
- Mission Runtime → Aircraft Connection: connects (evidence: `terrainfollow.py`)
- Aircraft Connection → PX4 Aircraft: connects MAVSDK (evidence: `terrainfollow.py`)
- Mission Runtime → Terrain Mission Planner: prepares mission (evidence: `terrainfollow.py`)
- Terrain Mission Planner → Terrain Map: samples elevations (evidence: `terrainfollow.py`)
- Terrain Mission Planner → Waypoint Builder: builds waypoints (evidence: `terrainfollow.py`)
- Mission Runtime → Mission Control: uploads mission (evidence: `terrainfollow.py`)
- Mission Control → PX4 Aircraft: uploads and starts (evidence: `terrainfollow.py`)
- Mission Runtime → Takeoff Sequence: starts takeoff (evidence: `terrainfollow.py`)
- Takeoff Sequence → PX4 Aircraft: arms and takes off (evidence: `terrainfollow.py`)
- Mission Runtime → Mission Progress: checks progress (evidence: `terrainfollow.py`)
- Mission Progress → PX4 Aircraft: reads mission state (evidence: `terrainfollow.py`)
- Mission Runtime → Altitude Check: checks periodically (evidence: `terrainfollow.py`)
- Altitude Check → Position Telemetry: reads position (evidence: `terrainfollow.py`)
- Altitude Check → Terrain Map: samples ground height (evidence: `terrainfollow.py`)
- Mission Runtime → Update Policy: tests altitude error (evidence: `terrainfollow.py`)
- Update Policy → Altitude Updater: requests revision (evidence: `terrainfollow.py`)
- Altitude Updater → Terrain Map: samples waypoint terrain (evidence: `terrainfollow.py`)
- Altitude Updater → Waypoint Builder: rebuilds waypoints (evidence: `terrainfollow.py`)
- Altitude Updater → Mission Control: replaces mission (evidence: `terrainfollow.py`)
- Mission Runtime → Mission Completion Check: checks endpoint (evidence: `terrainfollow.py`)
- Mission Completion Check → Position Telemetry: reads position (evidence: `terrainfollow.py`)
