How remete618/drone-acoustic-detection works
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: runner.py Experiment protocols · recorder.py Audio recorder · analyze.py Analysis CLI · logger.py Field data logger
Components 16
Audio capture
- Audio recorder
capture/recorder.py - Signal simulator
capture/mock.py - WAV recording
Signal analysis
- Analysis CLI
processing/analyze.py - Audio features
processing/spectrogram.py - Analysis results
Experiments and reporting
- Experiment protocols
experiments/runner.py - Statistical analysis
processing/statistics.py - Experiment outputs
- Research figures
visualization/figures.py
Field and radar tools
- Field data logger
fieldlog/logger.py - Field logs
- mmWave radar driver
radar/mmwave.py
Other components
- Field researcher
- Audio devices
- TI radar
Connections 20
- Field researcher → Audio recorder: starts capture
README.md - Audio devices → Audio recorder: provides audio
README.md - Audio recorder → Signal simulator: generates mock
capture/recorder.py - Audio recorder → WAV recording: writes recording
capture/recorder.py - Field researcher → Analysis CLI: runs analysis
README.md - WAV recording → Analysis CLI: supplies recording
README.md - Analysis CLI → Audio features: calls features
processing/analyze.py - Analysis CLI → Analysis results: writes results
processing/analyze.py - Field researcher → Experiment protocols: runs protocol
README.md - Experiment protocols → Audio recorder: uses capture
experiments/runner.py - Experiment protocols → Signal simulator: generates signals
experiments/runner.py - Experiment protocols → Audio features: computes features
experiments/runner.py - Experiment protocols → Statistical analysis: summarizes results
experiments/runner.py - Experiment protocols → Experiment outputs: exports results
README.md - Experiment outputs → Research figures: provides plot data
README.md - Field researcher → Research figures: generates figures
README.md - Field researcher → Field data logger: creates field sheet
README.md - Field data logger → Field logs: writes field logs
fieldlog/logger.py - Field researcher → mmWave radar driver: uses radar option
README.md - TI radar → mmWave radar driver: streams frames
radar/mmwave.py