How sriramjayanti/astra works
ASTRA is a blind RF signal analysis and recovery system: it takes unknown I/Q or WAV captures through signal conditioning, modulation and baud estimation, synchronization, decoding, and payload extraction. Its documented pipeline also branches into independent validation, constellation-quality analysis, bitstream intelligence, and final ranking/explanation. The README establishes the stage sequence; the sampled source excerpts and index confirm selected orchestrators and subsystem calls, but do not expose every integration detail.
Main entry points: src/inference.py Frame Validation · src/inference.py Spectral and Temporal DSP · src/inference.py Candidate Hypotheses · main.py Command Line
Components 20
User Interfaces
- Command Line
astra_cli/main.py - Desktop Interface
astra_gui/src/app/main_window.py - Pipeline Runner
run_complete_astra_ai.py
Signal Analysis
- Signal Conditioning
astra_synchronization/src/preprocessing.py - Spectral and Temporal DSP
astra_symbol_rate/src/inference.py - Modulation Inference
astra_fusion/src/inference.py - Symbol Rate Estimation
astra_symbol_rate/src/inference.py
Candidate Decoding
- Candidate Hypotheses
astra_candidate_engine/src/inference.py - Synchronization
astra_synchronization/src/router.py - Demodulation
astra_demodulation/src/router.py - Deinterleaving
astra_interleaver/src/router.py - FEC Decoding
astra_fec/src/router.py
Recovery Analysis
- Frame Validation
astra_validation/src/inference.py - Constellation Quality
astra_constellation/src/inference.py - Bitstream Intelligence
astra_bitstream_intelligence/src/inference.py - Framing and Headers
astra_payload_explorer/src/header_parser.py - Payload Extraction
astra_payload_explorer/src/inference.py
Ranking and Explanation
- Pipeline Ranking
astra_pipeline_scorer/src/inference.py - Evidence and Explanation
astra_explainability/src/inference.py
Other components
- Analyst
Connections 19
- Analyst → Command Line: runs analysis
README.md - Analyst → Desktop Interface: uses interface
README.md - Command Line → Pipeline Runner: invokes
astra_cli/main.py - Signal Conditioning → Spectral and Temporal DSP: feeds signal
README.md - Spectral and Temporal DSP → Modulation Inference: supports inference
README.md - Spectral and Temporal DSP → Symbol Rate Estimation: supports estimation
README.md - Modulation Inference → Candidate Hypotheses: supplies hypotheses
README.md - Symbol Rate Estimation → Candidate Hypotheses: supplies hypotheses
README.md - Candidate Hypotheses → Synchronization: tests candidates
README.md - Synchronization → Demodulation: provides symbols
README.md - Demodulation → Deinterleaving: provides bits
README.md - Deinterleaving → FEC Decoding: provides bitstreams
README.md - FEC Decoding → Frame Validation: validates decoded bits
README.md - Frame Validation → Constellation Quality: supports quality analysis
README.md - Frame Validation → Bitstream Intelligence: supports bit analysis
README.md - Frame Validation → Framing and Headers: supports frame detection
README.md - Framing and Headers → Payload Extraction: guides extraction
README.md - Payload Extraction → Pipeline Ranking: contributes results
- Pipeline Ranking → Evidence and Explanation: informs reasoning