# andreamarichon-bit/rtl-sdr-projects architecture

> Architecture diagram of the GitHub repository andreamarichon-bit/rtl-sdr-projects, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andreamarichon-bit/rtl-sdr-projects
- Repository: https://github.com/andreamarichon-bit/rtl-sdr-projects

## Overview

This repository is a collection of four independent RTL-SDR projects: FM scanning, live spectrum sensing, ADS-B decoding/tracking, and modulation classification. The principal workflows capture radio samples and produce visualizations, decoded telemetry, or class predictions. ADS-B tracking is a separate dump1090-fed workflow from the standalone decoder. The excerpts show these paths; no unsampled wiring is assumed.

Main entry points: [`03_adsb_decoder/adsb_analizer.py`](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_analizer.py) (Telemetry Engine), [`01_fm_scanner/fm_scanner.py`](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/01_fm_scanner/fm_scanner.py) (FM Scanner), [`02_spectrum_sensing/waterfall.py`](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/02_spectrum_sensing/waterfall.py) (Live Waterfall), [`03_adsb_decoder/adsb_decoder.py`](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_decoder.py) (ADS-B Decoder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_spectrum["Spectrum Tools"]
  node_fm["FM Scanner<br/>[fm_scanner.py]"]
  node_waterfall["Live Waterfall<br/>[waterfall.py]"]
end

subgraph group_adsb["ADS-B Tracking"]
  node_adsb_radio["ADS-B Decoder<br/>[adsb_decoder.py]"]
  node_telemetry["Telemetry Engine<br/>[adsb_analizer.py]"]
  node_link_budget["Link Budget<br/>[adsb_analizer.py]"]
  node_kml_export["KML Exporter<br/>[adsb_analizer.py]"]
  node_kml["Flight KML<br/>[live.link.kml]"]
end

subgraph group_amc["Modulation Classification"]
  node_capture["Dataset Capture<br/>[capture_dataset.py]"]
  node_train["Model Training"]
  node_model["Saved Model"]
  node_live["Live Classifier<br/>[live_classifier.py]"]
end

node_sdr(("RTL-SDR"))
node_dump1090["dump1090"]
node_google_earth(("Google Earth"))

node_sdr -->|"supplies IQ"| node_fm
node_fm -->|"plots scan"| node_fm
node_sdr -->|"supplies IQ"| node_waterfall
node_waterfall -->|"renders spectrum"| node_waterfall
node_sdr -->|"supplies IQ"| node_adsb_radio
node_adsb_radio -->|"decodes messages"| node_adsb_radio
node_dump1090 -->|"streams telemetry"| node_telemetry
node_telemetry -->|"calculates metrics"| node_link_budget
node_telemetry -->|"updates aircraft"| node_kml_export
node_kml_export -->|"writes KML"| node_kml
node_kml -->|"visualized in"| node_google_earth
node_sdr -->|"supplies IQ"| node_capture
node_capture -->|"writes training data"| node_train
node_train -->|"saves model"| node_model
node_model -->|"loads model"| node_live
node_sdr -->|"supplies IQ"| node_live

click node_fm "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/01_fm_scanner/fm_scanner.py"
click node_waterfall "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/02_spectrum_sensing/waterfall.py"
click node_adsb_radio "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_decoder.py"
click node_telemetry "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_analizer.py"
click node_link_budget "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_analizer.py"
click node_kml_export "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_analizer.py"
click node_kml "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/live.link.kml"
click node_capture "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/capture_dataset.py"
click node_train "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/train_classifier.py"
click node_model "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/train_classifier.py"
click node_live "https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/live_classifier.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_fm,node_waterfall toneBlue
class node_adsb_radio,node_telemetry,node_link_budget,node_kml_export,node_kml toneAmber
class node_capture,node_train,node_model,node_live toneMint
class node_sdr,node_dump1090,node_google_earth toneIndigo
```

## Components

### Spectrum Tools

- [FM Scanner](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/01_fm_scanner/fm_scanner.py): `01_fm_scanner/fm_scanner.py`
- [Live Waterfall](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/02_spectrum_sensing/waterfall.py): `02_spectrum_sensing/waterfall.py`

### ADS-B Tracking

- [ADS-B Decoder](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_decoder.py): `03_adsb_decoder/adsb_decoder.py`
- [Telemetry Engine](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_analizer.py): `03_adsb_decoder/adsb_analizer.py`
- [Link Budget](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_analizer.py): `03_adsb_decoder/adsb_analizer.py`
- [KML Exporter](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/03_adsb_decoder/adsb_analizer.py): `03_adsb_decoder/adsb_analizer.py`
- [Flight KML](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/live.link.kml): `live.link.kml`

### Modulation Classification

- [Dataset Capture](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/capture_dataset.py): `04_amc_classifier/capture_dataset.py`
- [Model Training](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/train_classifier.py): `04_amc_classifier/train_classifier.py`
- [Saved Model](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/train_classifier.py): `04_amc_classifier/train_classifier.py`
- [Live Classifier](https://github.com/andreamarichon-bit/rtl-sdr-projects/blob/main/04_amc_classifier/live_classifier.py): `04_amc_classifier/live_classifier.py`

### Other components

- **RTL-SDR**
- **dump1090**
- **Google Earth**

## Connections

- RTL-SDR → FM Scanner: supplies IQ (evidence: `01_fm_scanner/fm_scanner.py`)
- FM Scanner → FM Scanner: plots scan (evidence: `01_fm_scanner/fm_scanner.py`)
- RTL-SDR → Live Waterfall: supplies IQ (evidence: `02_spectrum_sensing/waterfall.py`)
- Live Waterfall → Live Waterfall: renders spectrum (evidence: `02_spectrum_sensing/waterfall.py`)
- RTL-SDR → ADS-B Decoder: supplies IQ (evidence: `03_adsb_decoder/adsb_decoder.py`)
- ADS-B Decoder → ADS-B Decoder: decodes messages (evidence: `03_adsb_decoder/adsb_decoder.py`)
- dump1090 → Telemetry Engine: streams telemetry (evidence: `03_adsb_decoder/adsb_analizer.py`)
- Telemetry Engine → Link Budget: calculates metrics (evidence: `03_adsb_decoder/adsb_analizer.py`)
- Telemetry Engine → KML Exporter: updates aircraft (evidence: `03_adsb_decoder/adsb_analizer.py`)
- KML Exporter → Flight KML: writes KML (evidence: `03_adsb_decoder/adsb_analizer.py`)
- Flight KML → Google Earth: visualized in (evidence: `README.md`)
- RTL-SDR → Dataset Capture: supplies IQ (evidence: `04_amc_classifier/capture_dataset.py`)
- Dataset Capture → Model Training: writes training data (evidence: `04_amc_classifier/capture_dataset.py`)
- Model Training → Saved Model: saves model (evidence: `04_amc_classifier/train_classifier.py`)
- Saved Model → Live Classifier: loads model (evidence: `04_amc_classifier/live_classifier.py`)
- RTL-SDR → Live Classifier: supplies IQ (evidence: `04_amc_classifier/live_classifier.py`)
