# prisma-drone-team/h-core architecture

> Architecture diagram of the GitHub repository prisma-drone-team/h-core, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/prisma-drone-team/h-core
- Repository: https://github.com/prisma-drone-team/h-core

## Overview

This repository is an overview and deployment guide for H-CoRE, not the ROS 2 runtime implementation. The documented user workflow is to follow the simulation or hardware tutorial and configure the relevant agent environments. The README identifies the GCS, UAV, UGV, and PTZ repositories, but their internal runtime relationships are not shown here; the graph therefore describes documented scope rather than inferred message flow.

Main entry points: [`tutorials/hardware_deployment.md`](https://github.com/prisma-drone-team/h-core/blob/main/tutorials/hardware_deployment.md) (Hardware deployment), [`README.md`](https://github.com/prisma-drone-team/h-core/blob/main/README.md) (H-CoRE overview), [`tutorials/sitl_setup.md`](https://github.com/prisma-drone-team/h-core/blob/main/tutorials/sitl_setup.md) (Simulation setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guides["Setup guides"]
  node_simulation_guide["Simulation setup<br/>[sitl_setup.md]"]
  node_hardware_guide["Hardware deployment"]
end

subgraph group_agents["Robot agents"]
  node_gcs["Ground control station"]
  node_uav["UAV agent"]
  node_ugv["UGV agent"]
  node_ptz["PTZ camera agent"]
end

node_operator(("Researcher / operator"))
node_overview["H-CoRE overview<br/>[README.md]"]
node_simulation["SITL environments"]
node_hardware["Deployed hardware"]

node_operator -->|"consults"| node_overview
node_operator -->|"follows"| node_simulation_guide
node_operator -->|"follows"| node_hardware_guide
node_simulation_guide -->|"guides setup"| node_simulation
node_hardware_guide -->|"guides deployment"| node_hardware
node_overview -->|"identifies repository"| node_gcs
node_overview -->|"identifies repository"| node_uav
node_overview -->|"identifies repositories"| node_ugv
node_overview -->|"identifies repository"| node_ptz
node_simulation_guide -->|"covers setup"| node_uav
node_simulation_guide -->|"covers setup"| node_ugv
node_hardware_guide -->|"covers deployment"| node_uav
node_hardware_guide -->|"covers deployment"| node_ugv
node_hardware_guide -->|"covers deployment"| node_ptz

click node_overview "https://github.com/prisma-drone-team/h-core/blob/main/README.md"
click node_simulation_guide "https://github.com/prisma-drone-team/h-core/blob/main/tutorials/sitl_setup.md"
click node_hardware_guide "https://github.com/prisma-drone-team/h-core/blob/main/tutorials/hardware_deployment.md"

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_simulation_guide,node_hardware_guide,node_overview toneBlue
class node_gcs,node_uav,node_ugv,node_ptz toneAmber
class node_operator,node_simulation,node_hardware toneIndigo
```

## Components

### Setup guides

- [Simulation setup](https://github.com/prisma-drone-team/h-core/blob/main/tutorials/sitl_setup.md): `tutorials/sitl_setup.md`
- [Hardware deployment](https://github.com/prisma-drone-team/h-core/blob/main/tutorials/hardware_deployment.md): `tutorials/hardware_deployment.md`

### Robot agents

- **Ground control station**
- **UAV agent**
- **UGV agent**
- **PTZ camera agent**

### Other components

- **Researcher / operator**
- [H-CoRE overview](https://github.com/prisma-drone-team/h-core/blob/main/README.md): `README.md`
- **SITL environments**
- **Deployed hardware**

## Connections

- Researcher / operator → H-CoRE overview: consults (evidence: `README.md`)
- Researcher / operator → Simulation setup: follows (evidence: `README.md`)
- Researcher / operator → Hardware deployment: follows (evidence: `README.md`)
- Simulation setup → SITL environments: guides setup (evidence: `README.md`)
- Hardware deployment → Deployed hardware: guides deployment (evidence: `README.md`)
- H-CoRE overview → Ground control station: identifies repository (evidence: `README.md`)
- H-CoRE overview → UAV agent: identifies repository (evidence: `README.md`)
- H-CoRE overview → UGV agent: identifies repositories (evidence: `README.md`)
- H-CoRE overview → PTZ camera agent: identifies repository (evidence: `README.md`)
- Simulation setup → UAV agent: covers setup (evidence: `README.md`)
- Simulation setup → UGV agent: covers setup (evidence: `README.md`)
- Hardware deployment → UAV agent: covers deployment (evidence: `README.md`)
- Hardware deployment → UGV agent: covers deployment (evidence: `README.md`)
- Hardware deployment → PTZ camera agent: covers deployment (evidence: `README.md`)