How sumehrashaikh/spectra works
Spectra is a Python RF/IQ signal-analysis prototype. Its main workflow loads a capture, detects and isolates candidate signals, estimates parameters, synchronizes and classifies them, then demodulates and optionally decodes frames and measures BER. The same analysis is exposed through the CLI and desktop GUI, with batch analysis, reporting, provenance, optional ML assistance and GNU Radio ingest. Pipeline-stage relationships are based on the README’s documented chain; some subsystem details are not shown in source excerpts.
Main entry points: pipeline.py Analysis pipeline · cli.py Command line · window.py Desktop GUI · loaders.py Capture loaders
Components 24
Signal analysis
- Capture loaders
prototype/io/loaders.py - Analysis pipeline
prototype/pipeline.py - Preprocessing
prototype/core/preprocessor.py - Signal detection
prototype/detection/detector.py - Candidate isolation
prototype/core/isolator.py - Parameter estimation
prototype/parameters/symbol_rate.py - Carrier and timing sync
prototype/core/synchronization.py - Modulation classification
prototype/modulation/classifier.py
Bit and frame decoding
- Demodulation
prototype/demodulation/demodulator.py - De-interleaving
prototype/fec/interleaving.py - FEC identification and decoding
prototype/fec/identification.py - Frame and sync-word parsing
prototype/protocol/parser.py - BER measurement
prototype/core/ber.py
User interfaces
- Command line
prototype/cli.py - Desktop GUI
prototype/gui/window.py - Batch candidate analysis
prototype/pipeline_batch.py
Optional extensions
- GNU Radio ingest
prototype/io/gnuradio - Optional ML assist
prototype/ml/cnn.py - Channel simulation
prototype/simulation/channel.py - External validation
prototype/external_validation/evaluate.py
Results and evidence
- Run provenance
prototype/core/provenance.py - Result export
prototype/reporting/export.py
Other components
- Analyst
- IQ/WAV capture
Connections 26
- Analyst → Command line: runs commands
README.md - Analyst → Desktop GUI: uses desktop app
README.md - IQ/WAV capture → Capture loaders: loads samples
README.md - Capture loaders → Analysis pipeline: supplies capture
prototype/pipeline.py - Command line → Analysis pipeline: runs analysis
README.md - Desktop GUI → Analysis pipeline: runs analysis
- Desktop GUI → Batch candidate analysis: requests batch analysis
- Batch candidate analysis → Analysis pipeline: analyzes candidates
prototype/pipeline_batch.py - Analysis pipeline → Preprocessing: preprocesses
README.md - Analysis pipeline → Signal detection: detects candidates
prototype/pipeline.py - Analysis pipeline → Candidate isolation: isolates candidates
README.md - Analysis pipeline → Parameter estimation: estimates parameters
README.md - Analysis pipeline → Carrier and timing sync: synchronizes
README.md - Analysis pipeline → Modulation classification: classifies modulation
README.md - Analysis pipeline → Demodulation: demodulates
README.md - Analysis pipeline → De-interleaving: de-interleaves
README.md - Analysis pipeline → FEC identification and decoding: decodes FEC
README.md - Analysis pipeline → Frame and sync-word parsing: parses configured frames
README.md - Analysis pipeline → BER measurement: measures BER
README.md - Analysis pipeline → Optional ML assist: adds ML evidence
README.md - Analysis pipeline → Run provenance: records run details
README.md - Analysis pipeline → Result export: exports results
- Command line → Result export: requests reports
README.md - GNU Radio ingest → Analysis pipeline: supplies signal
prototype/io/gnuradio/gui_controller.py - Channel simulation → Analysis pipeline: benchmarks chain
README.md - External validation → Analysis pipeline: evaluates chain
README.md