# raghavkp2006-ux/dsp-based-classical-signal-processing- architecture

> Architecture diagram of the GitHub repository raghavkp2006-ux/dsp-based-classical-signal-processing-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raghavkp2006-ux/dsp-based-classical-signal-processing-
- Repository: https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-

## Overview

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: [`signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt) (Run pipeline), [`signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt`](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt) (App coordinator), [`signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt`](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt) (Audio input), [`dsp_pipeline.py`](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/dsp_pipeline.py) (Reference DSP pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["App interaction"]
  node_main["App coordinator<br/>[MainActivity.kt]"]
  node_upload["Audio input<br/>[UploadScreen.kt]"]
  node_recorder["Microphone capture<br/>[AudioRecorder.kt]"]
  node_player["Audio playback<br/>[AudioPlayer.kt]"]
  node_processing_ui["Processing view"]
  node_results["Results and sharing<br/>[ResultsScreen.kt]"]
  node_history["Run history<br/>[HistorySection.kt]"]
end

subgraph group_enhancement["Enhancement engine"]
  node_pipeline["Run pipeline<br/>[RunPipeline.kt]"]
  node_wav_loader["WAV loading<br/>[WavLoader.kt]"]
  node_analyzer["Signal analysis<br/>[AudioAnalyzer.kt]"]
  node_decision["Strategy selection<br/>[DecisionAgent.kt]"]
  node_dsp["DSP enhancement"]
  node_fft["FFT and framing<br/>[Fft.kt]"]
  node_onnx["CNN post-filter<br/>[OnnxDenoiser.kt]"]
  node_wav_writer["WAV output<br/>[WavWriter.kt]"]
end

subgraph group_model_lifecycle["Model lifecycle"]
  node_python_pipeline["Reference DSP pipeline<br/>[dsp_pipeline.py]"]
  node_trainer["CNN training<br/>[train_denoiser.py]"]
  node_trained_model["Training model"]
  node_exporter["ONNX export<br/>[export_onnx.py]"]
end

subgraph group_evaluation["Evaluation"]
  node_ablation["Ablation runner<br/>[ablation_runner.py]"]
  node_testset["Test-set generation"]
  node_metrics["Audio evaluation<br/>[self_eval.py]"]
  node_stt["STT feedback<br/>[stt_module.py]"]
end

node_user(("User"))

node_user -->|"selects or records"| node_upload
node_main -->|"runs"| node_pipeline
node_main -->|"shows"| node_upload
node_main -->|"shows"| node_processing_ui
node_main -->|"shows"| node_results
node_main -->|"shows"| node_history
node_upload -->|"uses"| node_recorder
node_upload -->|"uses"| node_player
node_recorder -->|"writes capture"| node_wav_writer
node_pipeline -->|"loads input"| node_wav_loader
node_pipeline -->|"analyzes signal"| node_analyzer
node_pipeline -->|"requests strategy"| node_decision
node_pipeline -->|"applies stages"| node_dsp
node_pipeline -->|"applies optional filter"| node_onnx
node_pipeline -->|"writes result"| node_wav_writer
node_onnx -->|"uses transforms"| node_fft
node_results -->|"plays result"| node_player
node_trainer -->|"uses DSP targets"| node_python_pipeline
node_trainer -->|"trains"| node_trained_model
node_exporter -.->|"exports runtime model"| node_onnx
node_testset -->|"shares data split"| node_trainer
node_ablation -->|"evaluates"| node_python_pipeline
node_ablation -->|"scores audio"| node_metrics
node_ablation -->|"uses optional transcription"| node_stt
node_python_pipeline -->|"checks quality"| node_metrics
node_python_pipeline -->|"requests optional feedback"| node_stt

click node_main "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt"
click node_upload "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt"
click node_recorder "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioRecorder.kt"
click node_player "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioPlayer.kt"
click node_processing_ui "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/ProcessingScreen.kt"
click node_results "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/ResultsScreen.kt"
click node_history "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/HistorySection.kt"
click node_pipeline "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt"
click node_wav_loader "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/WavLoader.kt"
click node_analyzer "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/agent/AudioAnalyzer.kt"
click node_decision "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/agent/DecisionAgent.kt"
click node_dsp "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/tree/main/signalchain-android/app/src/main/java/com/signalchain/app/dsp"
click node_fft "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/dsp/Fft.kt"
click node_onnx "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ml/OnnxDenoiser.kt"
click node_wav_writer "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/WavWriter.kt"
click node_python_pipeline "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/dsp_pipeline.py"
click node_trainer "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/train_denoiser.py"
click node_trained_model "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/trained_ml_denoiser.py"
click node_exporter "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/export_onnx.py"
click node_ablation "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/ablation_runner.py"
click node_testset "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/make_ablation_testset.py"
click node_metrics "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/self_eval.py"
click node_stt "https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/stt_module.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_main,node_upload,node_recorder,node_player,node_processing_ui,node_results,node_history,node_user toneBlue
class node_pipeline,node_wav_loader,node_analyzer,node_decision,node_dsp,node_fft,node_onnx,node_wav_writer toneAmber
class node_python_pipeline,node_trainer,node_trained_model,node_exporter toneMint
class node_ablation,node_testset,node_metrics,node_stt toneRose
```

## Components

### App interaction

- [App coordinator](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt): `signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt`
- [Audio input](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt): `signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt`
- [Microphone capture](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioRecorder.kt): `signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioRecorder.kt`
- [Audio playback](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioPlayer.kt): `signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioPlayer.kt`
- [Processing view](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/ProcessingScreen.kt): `signalchain-android/app/src/main/java/com/signalchain/app/ui/ProcessingScreen.kt`
- [Results and sharing](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/ResultsScreen.kt): `signalchain-android/app/src/main/java/com/signalchain/app/ui/ResultsScreen.kt`
- [Run history](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ui/HistorySection.kt): `signalchain-android/app/src/main/java/com/signalchain/app/ui/HistorySection.kt`

### Enhancement engine

- [Run pipeline](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt): `signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`
- [WAV loading](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/WavLoader.kt): `signalchain-android/app/src/main/java/com/signalchain/app/audio/WavLoader.kt`
- [Signal analysis](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/agent/AudioAnalyzer.kt): `signalchain-android/app/src/main/java/com/signalchain/app/agent/AudioAnalyzer.kt`
- [Strategy selection](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/agent/DecisionAgent.kt): `signalchain-android/app/src/main/java/com/signalchain/app/agent/DecisionAgent.kt`
- [DSP enhancement](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/tree/main/signalchain-android/app/src/main/java/com/signalchain/app/dsp): `signalchain-android/app/src/main/java/com/signalchain/app/dsp`
- [FFT and framing](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/dsp/Fft.kt): `signalchain-android/app/src/main/java/com/signalchain/app/dsp/Fft.kt`
- [CNN post-filter](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/ml/OnnxDenoiser.kt): `signalchain-android/app/src/main/java/com/signalchain/app/ml/OnnxDenoiser.kt`
- [WAV output](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/signalchain-android/app/src/main/java/com/signalchain/app/audio/WavWriter.kt): `signalchain-android/app/src/main/java/com/signalchain/app/audio/WavWriter.kt`

### Model lifecycle

- [Reference DSP pipeline](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/dsp_pipeline.py): `dsp_pipeline.py`
- [CNN training](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/train_denoiser.py): `train_denoiser.py`
- [Training model](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/trained_ml_denoiser.py): `trained_ml_denoiser.py`
- [ONNX export](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/export_onnx.py): `export_onnx.py`

### Evaluation

- [Ablation runner](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/ablation_runner.py): `ablation_runner.py`
- [Test-set generation](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/make_ablation_testset.py): `make_ablation_testset.py`
- [Audio evaluation](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/self_eval.py): `self_eval.py`
- [STT feedback](https://github.com/raghavkp2006-ux/dsp-based-classical-signal-processing-/blob/main/stt_module.py): `stt_module.py`

### Other components

- **User**

## Connections

- User → Audio input: selects or records
- App coordinator → Run pipeline: runs (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt`)
- App coordinator → Audio input: shows (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt`)
- App coordinator → Processing view: shows (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt`)
- App coordinator → Results and sharing: shows (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt`)
- App coordinator → Run history: shows (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/MainActivity.kt`)
- Audio input → Microphone capture: uses (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt`)
- Audio input → Audio playback: uses (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/ui/UploadScreen.kt`)
- Microphone capture → WAV output: writes capture (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/audio/AudioRecorder.kt`)
- Run pipeline → WAV loading: loads input (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`)
- Run pipeline → Signal analysis: analyzes signal (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`)
- Run pipeline → Strategy selection: requests strategy (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`)
- Run pipeline → DSP enhancement: applies stages (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`)
- Run pipeline → CNN post-filter: applies optional filter (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`)
- Run pipeline → WAV output: writes result (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/pipeline/RunPipeline.kt`)
- CNN post-filter → FFT and framing: uses transforms (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/ml/OnnxDenoiser.kt`)
- Results and sharing → Audio playback: plays result (evidence: `signalchain-android/app/src/main/java/com/signalchain/app/ui/ResultsScreen.kt`)
- CNN training → Reference DSP pipeline: uses DSP targets (evidence: `train_denoiser.py`)
- CNN training → Training model: trains (evidence: `train_denoiser.py`)
- ONNX export → CNN post-filter: exports runtime model
- Test-set generation → CNN training: shares data split (evidence: `make_ablation_testset.py`)
- Ablation runner → Reference DSP pipeline: evaluates (evidence: `ablation_runner.py`)
- Ablation runner → Audio evaluation: scores audio (evidence: `ablation_runner.py`)
- Ablation runner → STT feedback: uses optional transcription (evidence: `ablation_runner.py`)
- Reference DSP pipeline → Audio evaluation: checks quality (evidence: `dsp_pipeline.py`)
- Reference DSP pipeline → STT feedback: requests optional feedback (evidence: `dsp_pipeline.py`)
