# eratenaina-code/autonomous architecture

> Architecture diagram of the GitHub repository eratenaina-code/autonomous, 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/eratenaina-code/autonomous
- Repository: https://github.com/eratenaina-code/autonomous

## Overview

This C++ point-cloud application reads sequential PCD frames, filters and segments them, extracts obstacle clusters, and displays the results with distance labels and bounding boxes. The main processing function owns the filtering, plane removal, clustering, and rendering calls; the custom kd-tree is an alternate clustering implementation. The README is empty, so capabilities and relationships are based on the shown source and source index. Dataset 2 is present in the tree, but the excerpt only shows dataset 1 being selected.

Main entry points: [`assignment_1/src/cluster_extraction.cpp`](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp) (Frame Processing), [`assignment_1/src/Renderer.cpp`](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/Renderer.cpp) (Scene Renderer), [`dataset_1`](https://github.com/eratenaina-code/autonomous/tree/main/dataset_1) (Dataset 1), [`assignment_1/include/tree_utilities.hpp`](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/include/tree_utilities.hpp) (Custom Kd-Tree)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Point Cloud Input"]
  node_dataset1[("Dataset 1")]
  node_dataset2[("Dataset 2")]
  node_frame_loader["PCD Frame Loading"]
end

subgraph group_processing["Obstacle Processing"]
  node_processor["Frame Processing"]
  node_plane_filter["Plane Segmentation"]
  node_cluster_extract["Cluster Extraction"]
  node_custom_tree["Custom Kd-Tree<br/>[tree_utilities.hpp]"]
end

subgraph group_display["3D Display"]
  node_renderer["Scene Renderer<br/>[Renderer.cpp]"]
end

subgraph group_models["Data Structures"]
  node_box_model["Bounding Box Types<br/>[Box.hpp]"]
end

node_user(("Application User"))
node_viewer["3D Viewer"]

node_user -->|"runs"| node_frame_loader
node_dataset1 -->|"provides frames"| node_frame_loader
node_frame_loader -->|"passes frame"| node_processor
node_processor -->|"segments planes"| node_plane_filter
node_processor -->|"extracts clusters"| node_cluster_extract
node_processor -->|"uses alternate search"| node_custom_tree
node_processor -->|"renders results"| node_renderer
node_renderer -->|"updates scene"| node_viewer
node_processor -->|"creates boxes"| node_box_model

click node_dataset1 "https://github.com/eratenaina-code/autonomous/tree/main/dataset_1"
click node_dataset2 "https://github.com/eratenaina-code/autonomous/tree/main/dataset_2"
click node_frame_loader "https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp"
click node_processor "https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp"
click node_plane_filter "https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp"
click node_cluster_extract "https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp"
click node_custom_tree "https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/include/tree_utilities.hpp"
click node_renderer "https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/Renderer.cpp"
click node_box_model "https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/include/Box.hpp"

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_dataset1,node_dataset2,node_frame_loader,node_user,node_viewer toneBlue
class node_processor,node_plane_filter,node_cluster_extract,node_custom_tree toneAmber
class node_renderer toneMint
class node_box_model toneRose
```

## Components

### Point Cloud Input

- [Dataset 1](https://github.com/eratenaina-code/autonomous/tree/main/dataset_1): `dataset_1`
- [Dataset 2](https://github.com/eratenaina-code/autonomous/tree/main/dataset_2): `dataset_2`
- [PCD Frame Loading](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp): `assignment_1/src/cluster_extraction.cpp`

### Obstacle Processing

- [Frame Processing](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp): `assignment_1/src/cluster_extraction.cpp`
- [Plane Segmentation](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp): `assignment_1/src/cluster_extraction.cpp`
- [Cluster Extraction](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/cluster_extraction.cpp): `assignment_1/src/cluster_extraction.cpp`
- [Custom Kd-Tree](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/include/tree_utilities.hpp): `assignment_1/include/tree_utilities.hpp`

### 3D Display

- [Scene Renderer](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/src/Renderer.cpp): `assignment_1/src/Renderer.cpp`

### Data Structures

- [Bounding Box Types](https://github.com/eratenaina-code/autonomous/blob/main/assignment_1/include/Box.hpp): `assignment_1/include/Box.hpp`

### Other components

- **Application User**
- **3D Viewer**

## Connections

- Application User → PCD Frame Loading: runs (evidence: `assignment_1/src/cluster_extraction.cpp`)
- Dataset 1 → PCD Frame Loading: provides frames (evidence: `assignment_1/src/cluster_extraction.cpp`)
- PCD Frame Loading → Frame Processing: passes frame (evidence: `assignment_1/src/cluster_extraction.cpp`)
- Frame Processing → Plane Segmentation: segments planes (evidence: `assignment_1/src/cluster_extraction.cpp`)
- Frame Processing → Cluster Extraction: extracts clusters (evidence: `assignment_1/src/cluster_extraction.cpp`)
- Frame Processing → Custom Kd-Tree: uses alternate search (evidence: `assignment_1/src/cluster_extraction.cpp`)
- Frame Processing → Scene Renderer: renders results (evidence: `assignment_1/src/cluster_extraction.cpp`)
- Scene Renderer → 3D Viewer: updates scene (evidence: `assignment_1/src/Renderer.cpp`)
- Frame Processing → Bounding Box Types: creates boxes (evidence: `assignment_1/src/cluster_extraction.cpp`)
