# remete618/drone-acoustic-detection architecture

> Architecture diagram of the GitHub repository remete618/drone-acoustic-detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/remete618/drone-acoustic-detection
- Repository: https://github.com/remete618/drone-acoustic-detection

## Overview

This is a field-research toolkit for establishing acoustic drone-detection baselines, with optional mmWave radar support. The main workflow captures hardware or modeled multichannel audio, analyzes spectral features and SNR, runs structured mock experiment protocols and statistical summaries, then produces figures. Separate capabilities include field-data logging and a radar driver. The experiment runner’s excerpt directly shows its use of capture, processing, and statistics; README documents broader reporting and optional radar, but does not show their runtime wiring. Radar integration is therefore shown as a standalone capability.

Main entry points: [`experiments/runner.py`](https://github.com/remete618/drone-acoustic-detection/blob/main/experiments/runner.py) (Experiment protocols), [`capture/recorder.py`](https://github.com/remete618/drone-acoustic-detection/blob/main/capture/recorder.py) (Audio recorder), [`processing/analyze.py`](https://github.com/remete618/drone-acoustic-detection/blob/main/processing/analyze.py) (Analysis CLI), [`fieldlog/logger.py`](https://github.com/remete618/drone-acoustic-detection/blob/main/fieldlog/logger.py) (Field data logger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Audio capture"]
  node_recorder["Audio recorder<br/>[recorder.py]"]
  node_signal_model["Signal simulator<br/>[mock.py]"]
  node_wav["WAV recording"]
end

subgraph group_analysis["Signal analysis"]
  node_analyzer["Analysis CLI<br/>[analyze.py]"]
  node_signal_features["Audio features<br/>[spectrogram.py]"]
  node_analysis_results["Analysis results"]
end

subgraph group_research["Experiments and reporting"]
  node_experiment_runner["Experiment protocols<br/>[runner.py]"]
  node_statistics["Statistical analysis<br/>[statistics.py]"]
  node_experiment_data["Experiment outputs"]
  node_figures["Research figures<br/>[figures.py]"]
end

subgraph group_field["Field and radar tools"]
  node_field_logger["Field data logger<br/>[logger.py]"]
  node_field_records["Field logs"]
  node_radar_driver["mmWave radar driver<br/>[mmwave.py]"]
end

node_operator(("Field researcher"))
node_hardware["Audio devices"]
node_radar_hardware["TI radar"]

node_operator -->|"starts capture"| node_recorder
node_hardware -->|"provides audio"| node_recorder
node_recorder -->|"generates mock"| node_signal_model
node_recorder -->|"writes recording"| node_wav
node_operator -->|"runs analysis"| node_analyzer
node_wav -->|"supplies recording"| node_analyzer
node_analyzer -->|"calls features"| node_signal_features
node_analyzer -->|"writes results"| node_analysis_results
node_operator -->|"runs protocol"| node_experiment_runner
node_experiment_runner -->|"uses capture"| node_recorder
node_experiment_runner -->|"generates signals"| node_signal_model
node_experiment_runner -->|"computes features"| node_signal_features
node_experiment_runner -->|"summarizes results"| node_statistics
node_experiment_runner -->|"exports results"| node_experiment_data
node_experiment_data -->|"provides plot data"| node_figures
node_operator -->|"generates figures"| node_figures
node_operator -->|"creates field sheet"| node_field_logger
node_field_logger -->|"writes field logs"| node_field_records
node_operator -.->|"uses radar option"| node_radar_driver
node_radar_hardware -->|"streams frames"| node_radar_driver

click node_recorder "https://github.com/remete618/drone-acoustic-detection/blob/main/capture/recorder.py"
click node_signal_model "https://github.com/remete618/drone-acoustic-detection/blob/main/capture/mock.py"
click node_analyzer "https://github.com/remete618/drone-acoustic-detection/blob/main/processing/analyze.py"
click node_signal_features "https://github.com/remete618/drone-acoustic-detection/blob/main/processing/spectrogram.py"
click node_experiment_runner "https://github.com/remete618/drone-acoustic-detection/blob/main/experiments/runner.py"
click node_statistics "https://github.com/remete618/drone-acoustic-detection/blob/main/processing/statistics.py"
click node_figures "https://github.com/remete618/drone-acoustic-detection/blob/main/visualization/figures.py"
click node_field_logger "https://github.com/remete618/drone-acoustic-detection/blob/main/fieldlog/logger.py"
click node_radar_driver "https://github.com/remete618/drone-acoustic-detection/blob/main/radar/mmwave.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_recorder,node_signal_model,node_wav toneBlue
class node_analyzer,node_signal_features,node_analysis_results toneAmber
class node_experiment_runner,node_statistics,node_experiment_data,node_figures toneMint
class node_field_logger,node_field_records,node_radar_driver toneRose
class node_operator,node_hardware,node_radar_hardware toneIndigo
```

## Components

### Audio capture

- [Audio recorder](https://github.com/remete618/drone-acoustic-detection/blob/main/capture/recorder.py): `capture/recorder.py`
- [Signal simulator](https://github.com/remete618/drone-acoustic-detection/blob/main/capture/mock.py): `capture/mock.py`
- **WAV recording**

### Signal analysis

- [Analysis CLI](https://github.com/remete618/drone-acoustic-detection/blob/main/processing/analyze.py): `processing/analyze.py`
- [Audio features](https://github.com/remete618/drone-acoustic-detection/blob/main/processing/spectrogram.py): `processing/spectrogram.py`
- **Analysis results**

### Experiments and reporting

- [Experiment protocols](https://github.com/remete618/drone-acoustic-detection/blob/main/experiments/runner.py): `experiments/runner.py`
- [Statistical analysis](https://github.com/remete618/drone-acoustic-detection/blob/main/processing/statistics.py): `processing/statistics.py`
- **Experiment outputs**
- [Research figures](https://github.com/remete618/drone-acoustic-detection/blob/main/visualization/figures.py): `visualization/figures.py`

### Field and radar tools

- [Field data logger](https://github.com/remete618/drone-acoustic-detection/blob/main/fieldlog/logger.py): `fieldlog/logger.py`
- **Field logs**
- [mmWave radar driver](https://github.com/remete618/drone-acoustic-detection/blob/main/radar/mmwave.py): `radar/mmwave.py`

### Other components

- **Field researcher**
- **Audio devices**
- **TI radar**

## Connections

- Field researcher → Audio recorder: starts capture (evidence: `README.md`)
- Audio devices → Audio recorder: provides audio (evidence: `README.md`)
- Audio recorder → Signal simulator: generates mock (evidence: `capture/recorder.py`)
- Audio recorder → WAV recording: writes recording (evidence: `capture/recorder.py`)
- Field researcher → Analysis CLI: runs analysis (evidence: `README.md`)
- WAV recording → Analysis CLI: supplies recording (evidence: `README.md`)
- Analysis CLI → Audio features: calls features (evidence: `processing/analyze.py`)
- Analysis CLI → Analysis results: writes results (evidence: `processing/analyze.py`)
- Field researcher → Experiment protocols: runs protocol (evidence: `README.md`)
- Experiment protocols → Audio recorder: uses capture (evidence: `experiments/runner.py`)
- Experiment protocols → Signal simulator: generates signals (evidence: `experiments/runner.py`)
- Experiment protocols → Audio features: computes features (evidence: `experiments/runner.py`)
- Experiment protocols → Statistical analysis: summarizes results (evidence: `experiments/runner.py`)
- Experiment protocols → Experiment outputs: exports results (evidence: `README.md`)
- Experiment outputs → Research figures: provides plot data (evidence: `README.md`)
- Field researcher → Research figures: generates figures (evidence: `README.md`)
- Field researcher → Field data logger: creates field sheet (evidence: `README.md`)
- Field data logger → Field logs: writes field logs (evidence: `fieldlog/logger.py`)
- Field researcher → mmWave radar driver: uses radar option (evidence: `README.md`)
- TI radar → mmWave radar driver: streams frames (evidence: `radar/mmwave.py`)
