# apurba-06/spectra-signal-analysis architecture

> Architecture diagram of the GitHub repository apurba-06/spectra-signal-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/apurba-06/spectra-signal-analysis
- Repository: https://github.com/apurba-06/spectra-signal-analysis

## Overview

SPECTRA is a signal-analysis workbench: users load WAV or raw IQ captures, inspect estimated signal characteristics, and follow receiver results through synchronization, coding hypotheses, and CRC-checked frames. The browser and desktop interfaces expose visualizations, BER benchmarking, and report export. The main receive chain is explicit in analysis.py; some interface-to-backend wiring is supported only by the README, so uncertain implementation-level links are omitted.

Main entry points: [`streamlit_app.py`](https://github.com/apurba-06/spectra-signal-analysis/blob/main/streamlit_app.py) (Browser workbench), [`analysis.py`](https://github.com/apurba-06/spectra-signal-analysis/blob/main/analysis.py) (Receive orchestration), [`blind.py`](https://github.com/apurba-06/spectra-signal-analysis/blob/main/blind.py) (Coding detection), [`main.py`](https://github.com/apurba-06/spectra-signal-analysis/blob/main/main.py) (Desktop workbench)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_webapp["Browser workbench<br/>[streamlit_app.py]"]
  node_desktop["Desktop workbench<br/>[main.py]"]
end

subgraph group_receiver["Signal receiver"]
  node_loader["Capture loader<br/>[signal_loader.py]"]
  node_analysis["Receive orchestration<br/>[analysis.py]"]
  node_demod["Demodulation front end<br/>[demod.py]"]
  node_dsp["DSP and estimation<br/>[dsp_core.py]"]
end

subgraph group_recovery["Frame recovery"]
  node_sync["Sync and frame parsing<br/>[correlation.py]"]
  node_blind["Coding detection<br/>[blind.py]"]
  node_deinterleave["De-interleaving<br/>[deinterleave.py]"]
  node_fec["FEC decoding<br/>[fec.py]"]
end

subgraph group_insight["Diagnostics and reporting"]
  node_visuals["Signal visualizations<br/>[analysis.py]"]
  node_reports["Report export<br/>[report_export.py]"]
  node_benchmark["BER benchmark<br/>[benchmark.py]"]
end

node_user(("Signal analyst"))
node_gemini{{"Gemini API"}}

node_user -->|"uploads capture"| node_webapp
node_user -->|"opens capture"| node_desktop
node_webapp -->|"loads capture"| node_loader
node_desktop -.->|"loads capture"| node_loader
node_webapp -->|"runs analysis"| node_analysis
node_desktop -.->|"runs analysis"| node_analysis
node_analysis -->|"demodulates samples"| node_demod
node_demod -->|"calls receiver"| node_dsp
node_analysis -->|"searches sync"| node_sync
node_analysis -->|"detects coding"| node_blind
node_analysis -->|"applies decode chain"| node_blind
node_blind -->|"deinterleaves"| node_deinterleave
node_blind -->|"decodes FEC"| node_fec
node_webapp -->|"renders diagnostics"| node_visuals
node_webapp -->|"exports reports"| node_reports
node_webapp -->|"runs benchmark"| node_benchmark
node_webapp -.->|"optionally queries"| node_gemini

click node_webapp "https://github.com/apurba-06/spectra-signal-analysis/blob/main/streamlit_app.py"
click node_desktop "https://github.com/apurba-06/spectra-signal-analysis/blob/main/main.py"
click node_loader "https://github.com/apurba-06/spectra-signal-analysis/blob/main/signal_loader.py"
click node_analysis "https://github.com/apurba-06/spectra-signal-analysis/blob/main/analysis.py"
click node_demod "https://github.com/apurba-06/spectra-signal-analysis/blob/main/demod.py"
click node_dsp "https://github.com/apurba-06/spectra-signal-analysis/blob/main/dsp_core.py"
click node_sync "https://github.com/apurba-06/spectra-signal-analysis/blob/main/correlation.py"
click node_blind "https://github.com/apurba-06/spectra-signal-analysis/blob/main/blind.py"
click node_deinterleave "https://github.com/apurba-06/spectra-signal-analysis/blob/main/deinterleave.py"
click node_fec "https://github.com/apurba-06/spectra-signal-analysis/blob/main/fec.py"
click node_visuals "https://github.com/apurba-06/spectra-signal-analysis/blob/main/analysis.py"
click node_reports "https://github.com/apurba-06/spectra-signal-analysis/blob/main/report_export.py"
click node_benchmark "https://github.com/apurba-06/spectra-signal-analysis/blob/main/benchmark.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_webapp,node_desktop toneBlue
class node_loader,node_analysis,node_demod,node_dsp toneAmber
class node_sync,node_blind,node_deinterleave,node_fec,node_gemini toneMint
class node_visuals,node_reports,node_benchmark toneRose
class node_user toneIndigo
```

## Components

### User interfaces

- [Browser workbench](https://github.com/apurba-06/spectra-signal-analysis/blob/main/streamlit_app.py): `streamlit_app.py`
- [Desktop workbench](https://github.com/apurba-06/spectra-signal-analysis/blob/main/main.py): `main.py`

### Signal receiver

- [Capture loader](https://github.com/apurba-06/spectra-signal-analysis/blob/main/signal_loader.py): `signal_loader.py`
- [Receive orchestration](https://github.com/apurba-06/spectra-signal-analysis/blob/main/analysis.py): `analysis.py`
- [Demodulation front end](https://github.com/apurba-06/spectra-signal-analysis/blob/main/demod.py): `demod.py`
- [DSP and estimation](https://github.com/apurba-06/spectra-signal-analysis/blob/main/dsp_core.py): `dsp_core.py`

### Frame recovery

- [Sync and frame parsing](https://github.com/apurba-06/spectra-signal-analysis/blob/main/correlation.py): `correlation.py`
- [Coding detection](https://github.com/apurba-06/spectra-signal-analysis/blob/main/blind.py): `blind.py`
- [De-interleaving](https://github.com/apurba-06/spectra-signal-analysis/blob/main/deinterleave.py): `deinterleave.py`
- [FEC decoding](https://github.com/apurba-06/spectra-signal-analysis/blob/main/fec.py): `fec.py`

### Diagnostics and reporting

- [Signal visualizations](https://github.com/apurba-06/spectra-signal-analysis/blob/main/analysis.py): `analysis.py`
- [Report export](https://github.com/apurba-06/spectra-signal-analysis/blob/main/report_export.py): `report_export.py`
- [BER benchmark](https://github.com/apurba-06/spectra-signal-analysis/blob/main/benchmark.py): `benchmark.py`

### Other components

- **Signal analyst**
- **Gemini API**

## Connections

- Signal analyst → Browser workbench: uploads capture (evidence: `README.md`)
- Signal analyst → Desktop workbench: opens capture (evidence: `README.md`)
- Browser workbench → Capture loader: loads capture (evidence: `README.md`)
- Desktop workbench → Capture loader: loads capture (evidence: `main.py`)
- Browser workbench → Receive orchestration: runs analysis (evidence: `README.md`)
- Desktop workbench → Receive orchestration: runs analysis (evidence: `main.py`)
- Receive orchestration → Demodulation front end: demodulates samples (evidence: `analysis.py`)
- Demodulation front end → DSP and estimation: calls receiver (evidence: `demod.py`)
- Receive orchestration → Sync and frame parsing: searches sync (evidence: `analysis.py`)
- Receive orchestration → Coding detection: detects coding (evidence: `analysis.py`)
- Receive orchestration → Coding detection: applies decode chain (evidence: `analysis.py`)
- Coding detection → De-interleaving: deinterleaves (evidence: `blind.py`)
- Coding detection → FEC decoding: decodes FEC (evidence: `blind.py`)
- Browser workbench → Signal visualizations: renders diagnostics (evidence: `README.md`)
- Browser workbench → Report export: exports reports (evidence: `README.md`)
- Browser workbench → BER benchmark: runs benchmark (evidence: `README.md`)
- Browser workbench → Gemini API: optionally queries (evidence: `README.md`)
