# trimodaldataset/multi-modal-drone-data architecture

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

- Interactive diagram: https://gitdiagram.com/trimodaldataset/multi-modal-drone-data
- Repository: https://github.com/trimodaldataset/multi-modal-drone-data

## Overview

This repository is a small multi-sensor data-collection application, not a drone-detection pipeline. Its runtime entry point starts separate audio, video, and RF recorders; the RF recorder signals readiness before the audio and video scripts begin. The scripts save modality-specific recordings. The README describes a broader synchronized drone/background dataset, but the shown code records background data and does not implement dataset labeling or synchronization. Relationships below follow the excerpts; broader dataset capabilities are documented, not shown as runtime components.

Main entry points: [`main.py`](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/main.py) (Capture controller), [`iq_recording.py`](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/iq_recording.py) (RF recorder), [`audio_recording.py`](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/audio_recording.py) (Audio recorder), [`video_recording.py`](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/video_recording.py) (Video recorder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Capture orchestration"]
  node_controller["Capture controller<br/>[main.py]"]
  node_ready_signal["Ready signal file<br/>[iq_recording.py]"]
end

subgraph group_modalities["Sensor capture"]
  node_audio_capture["Audio recorder<br/>[audio_recording.py]"]
  node_video_capture["Video recorder<br/>[video_recording.py]"]
  node_rf_capture["RF recorder<br/>[iq_recording.py]"]
  node_usrp["USRP sensor"]
end

subgraph group_outputs["Recording outputs"]
  node_audio_files["WAV recordings<br/>[audio_recording.py]"]
  node_video_files["MP4 recordings<br/>[video_recording.py]"]
  node_rf_files["I/Q binary recording<br/>[iq_recording.py]"]
end

node_operator(("Operator"))

node_operator -->|"starts capture"| node_controller
node_controller -->|"launches process"| node_audio_capture
node_controller -->|"launches process"| node_video_capture
node_controller -->|"launches process"| node_rf_capture
node_rf_capture -->|"receives I/Q"| node_usrp
node_rf_capture -->|"writes samples"| node_rf_files
node_rf_capture -->|"creates signal"| node_ready_signal
node_audio_capture -->|"waits for file"| node_ready_signal
node_video_capture -->|"waits for file"| node_ready_signal
node_controller -->|"removes file"| node_ready_signal
node_audio_capture -->|"writes segments"| node_audio_files
node_video_capture -->|"writes segments"| node_video_files

click node_controller "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/main.py"
click node_audio_capture "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/audio_recording.py"
click node_video_capture "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/video_recording.py"
click node_rf_capture "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/iq_recording.py"
click node_audio_files "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/audio_recording.py"
click node_video_files "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/video_recording.py"
click node_rf_files "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/iq_recording.py"
click node_ready_signal "https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/iq_recording.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_controller,node_ready_signal toneBlue
class node_audio_capture,node_video_capture,node_rf_capture,node_usrp toneAmber
class node_audio_files,node_video_files,node_rf_files toneMint
class node_operator toneIndigo
```

## Components

### Capture orchestration

- [Capture controller](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/main.py): `main.py`
- [Ready signal file](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/iq_recording.py): `iq_recording.py`

### Sensor capture

- [Audio recorder](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/audio_recording.py): `audio_recording.py`
- [Video recorder](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/video_recording.py): `video_recording.py`
- [RF recorder](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/iq_recording.py): `iq_recording.py`
- **USRP sensor**

### Recording outputs

- [WAV recordings](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/audio_recording.py): `audio_recording.py`
- [MP4 recordings](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/video_recording.py): `video_recording.py`
- [I/Q binary recording](https://github.com/trimodaldataset/multi-modal-drone-data/blob/main/iq_recording.py): `iq_recording.py`

### Other components

- **Operator**

## Connections

- Operator → Capture controller: starts capture (evidence: `main.py`)
- Capture controller → Audio recorder: launches process (evidence: `main.py`)
- Capture controller → Video recorder: launches process (evidence: `main.py`)
- Capture controller → RF recorder: launches process (evidence: `main.py`)
- RF recorder → USRP sensor: receives I/Q (evidence: `iq_recording.py`)
- RF recorder → I/Q binary recording: writes samples (evidence: `iq_recording.py`)
- RF recorder → Ready signal file: creates signal (evidence: `iq_recording.py`)
- Audio recorder → Ready signal file: waits for file (evidence: `audio_recording.py`)
- Video recorder → Ready signal file: waits for file (evidence: `video_recording.py`)
- Capture controller → Ready signal file: removes file (evidence: `main.py`)
- Audio recorder → WAV recordings: writes segments (evidence: `audio_recording.py`)
- Video recorder → MP4 recordings: writes segments (evidence: `video_recording.py`)
