How raghavkp2006-ux/dsp-based-classical-signal-processing- works
SignalChain is an on-device Android speech-enhancement app, supported by a separate offline Python toolchain for training and evaluating its CNN post-filter. The user selects or records audio, starts processing, and views or shares the enhanced result. In the app, RunPipeline loads the WAV, analyzes speech and noise, selects DSP settings, enhances the signal, optionally applies ONNX inference, and writes a WAV. The graph also preserves training, export, and ablation capabilities documented in the README; unsampled implementations are included only where the tree or documentation establishes their role.
Main entry points: RunPipeline.kt Run pipeline · MainActivity.kt App coordinator · UploadScreen.kt Audio input · dsp_pipeline.py Reference DSP pipeline
Components 24
App interaction
- App coordinator
signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt - Audio input
signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt - Microphone capture
signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioRecorder.kt - Audio playback
signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioPlayer.kt - Processing view
signalchain-android/app/src/main/java/com/signalchain/app/ui/ProcessingScreen.kt - Results and sharing
signalchain-android/app/src/main/java/com/signalchain/app/ui/ResultsScreen.kt - Run history
signalchain-android/app/src/main/java/com/signalchain/app/ui/HistorySection.kt
Enhancement engine
- Run pipeline
signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt - WAV loading
signalchain-android/app/src/main/java/com/signalchain/app/audio/WavLoader.kt - Signal analysis
signalchain-android/app/src/main/java/com/signalchain/app/agent/AudioAnalyzer.kt - Strategy selection
signalchain-android/app/src/main/java/com/signalchain/app/agent/DecisionAgent.kt - DSP enhancement
signalchain-android/app/src/main/java/com/signalchain/app/dsp - FFT and framing
signalchain-android/app/src/main/java/com/signalchain/app/dsp/Fft.kt - CNN post-filter
signalchain-android/app/src/main/java/com/signalchain/app/ml/OnnxDenoiser.kt - WAV output
signalchain-android/app/src/main/java/com/signalchain/app/audio/WavWriter.kt
Model lifecycle
- Reference DSP pipeline
dsp_pipeline.py - CNN training
train_denoiser.py - Training model
trained_ml_denoiser.py - ONNX export
export_onnx.py
Evaluation
- Ablation runner
ablation_runner.py - Test-set generation
make_ablation_testset.py - Audio evaluation
self_eval.py - STT feedback
stt_module.py
Other components
- User
Connections 26
- User → Audio input: selects or records
- App coordinator → Run pipeline: runs
signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt - App coordinator → Audio input: shows
signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt - App coordinator → Processing view: shows
signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt - App coordinator → Results and sharing: shows
signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt - App coordinator → Run history: shows
signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt - Audio input → Microphone capture: uses
signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt - Audio input → Audio playback: uses
signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt - Microphone capture → WAV output: writes capture
signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioRecorder.kt - Run pipeline → WAV loading: loads input
signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt - Run pipeline → Signal analysis: analyzes signal
signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt - Run pipeline → Strategy selection: requests strategy
signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt - Run pipeline → DSP enhancement: applies stages
signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt - Run pipeline → CNN post-filter: applies optional filter
signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt - Run pipeline → WAV output: writes result
signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt - CNN post-filter → FFT and framing: uses transforms
signalchain-android/app/src/main/java/com/signalchain/app/ml/OnnxDenoiser.kt - Results and sharing → Audio playback: plays result
signalchain-android/app/src/main/java/com/signalchain/app/ui/ResultsScreen.kt - CNN training → Reference DSP pipeline: uses DSP targets
train_denoiser.py - CNN training → Training model: trains
train_denoiser.py - ONNX export → CNN post-filter: exports runtime model
- Test-set generation → CNN training: shares data split
make_ablation_testset.py - Ablation runner → Reference DSP pipeline: evaluates
ablation_runner.py - Ablation runner → Audio evaluation: scores audio
ablation_runner.py - Ablation runner → STT feedback: uses optional transcription
ablation_runner.py - Reference DSP pipeline → Audio evaluation: checks quality
dsp_pipeline.py - Reference DSP pipeline → STT feedback: requests optional feedback
dsp_pipeline.py