# cse220-project/signal_scissor architecture

> Architecture diagram of the GitHub repository cse220-project/signal_scissor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cse220-project/signal_scissor
- Repository: https://github.com/cse220-project/signal_scissor

## Overview

Signal Scissors is a browser-based DSP workstation with a FastAPI/NumPy-SciPy backend. Users load, synthesize, or record audio, process it with Fourier filters and LTI-style effects, then inspect and play the results. A separate noise-removal feature uses FFmpeg and does not share the workstation signal state. The graph includes major documented pages and capabilities; some frontend and backend wiring is inferred only from the README because those source excerpts were not shown.

Main entry points: [`frontend/src/App.tsx`](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/App.tsx) (Routed App), [`backend/server.py`](https://github.com/cse220-project/signal_scissor/blob/main/backend/server.py) (DSP API), [`frontend/src/store/useAudioStore.ts`](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/store/useAudioStore.ts) (Audio State), [`backend/noise_service.py`](https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_service.py) (Noise Processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Workstation UI"]
  node_app["Routed App<br/>[App.tsx]"]
  node_dashboard["Signal Loading<br/>[Dashboard.tsx]"]
  node_capture["Mic Capture<br/>[MicCapture.tsx]"]
  node_studio["Studio Controls<br/>[Studio.tsx]"]
  node_effectsui["Acoustic Presets<br/>[Effects.tsx]"]
  node_store["Audio State<br/>[useAudioStore.ts]"]
  node_player["Audio Playback<br/>[useAudioPlayer.ts]"]
  node_client["API Client<br/>[client.ts]"]
end

subgraph group_signal["Signal Processing"]
  node_server["DSP API<br/>[server.py]"]
  node_io["Signal I/O<br/>[signal_io.py]"]
  node_filter["Fourier Filter<br/>[fourier_filter.py]"]
  node_effects["Audio Effects<br/>[audio_effects.py]"]
  node_analysis["Signal Metrics<br/>[signal_analysis.py]"]
end

subgraph group_noise["Noise Remover"]
  node_noiseui["Denoiser Page<br/>[NoiseRemover.tsx]"]
  node_noiseroutes["Noise API Routes<br/>[noise_routes.py]"]
  node_noiseservice["Noise Processing<br/>[noise_service.py]"]
  node_noiseconfig["Noise Limits<br/>[noise_config.py]"]
  node_storage[("Result Storage<br/>[noise_storage.py]")]
end

subgraph group_inspection["Inspection and Learning"]
  node_compare["Signal Inspector<br/>[Compare.tsx]"]
  node_theory["DSP Academy<br/>[Theory.tsx]"]
  node_visuals["Signal Visualizers"]
end

node_user(("User"))
node_ffmpeg["FFmpeg / FFprobe"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_studio
node_app -->|"routes to"| node_capture
node_app -->|"routes to"| node_effectsui
node_app -->|"routes to"| node_compare
node_app -->|"routes to"| node_theory
node_dashboard -.->|"loads signals"| node_store
node_capture -.->|"commits recording"| node_store
node_studio -.->|"controls processing"| node_store
node_effectsui -.->|"applies presets"| node_store
node_store -->|"requests operations"| node_client
node_client -->|"calls API"| node_server
node_server -->|"loads and synthesizes"| node_io
node_server -->|"applies filtering"| node_filter
node_server -->|"applies effects"| node_effects
node_server -->|"computes metrics"| node_analysis
node_store -->|"provides track state"| node_player
node_player -->|"gets audio stream"| node_client
node_server -->|"registers routes"| node_noiseroutes
node_user -->|"uploads recording"| node_noiseui
node_noiseui -.->|"submits audio"| node_noiseroutes
node_noiseroutes -->|"processes request"| node_noiseservice
node_noiseservice -->|"reads limits"| node_noiseconfig
node_noiseservice -->|"publishes results"| node_storage
node_noiseservice -->|"runs reduction"| node_ffmpeg
node_user -->|"inspects results"| node_compare
node_user -->|"explores DSP"| node_theory
node_studio -.->|"shows signal views"| node_visuals

click node_app "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/App.tsx"
click node_dashboard "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Dashboard.tsx"
click node_capture "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/MicCapture.tsx"
click node_studio "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Studio.tsx"
click node_effectsui "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Effects.tsx"
click node_store "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/store/useAudioStore.ts"
click node_player "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/hooks/useAudioPlayer.ts"
click node_client "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/api/client.ts"
click node_server "https://github.com/cse220-project/signal_scissor/blob/main/backend/server.py"
click node_io "https://github.com/cse220-project/signal_scissor/blob/main/backend/signal_io.py"
click node_filter "https://github.com/cse220-project/signal_scissor/blob/main/backend/fourier_filter.py"
click node_effects "https://github.com/cse220-project/signal_scissor/blob/main/backend/audio_effects.py"
click node_analysis "https://github.com/cse220-project/signal_scissor/blob/main/backend/signal_analysis.py"
click node_compare "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Compare.tsx"
click node_theory "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Theory.tsx"
click node_visuals "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/components/WaveformVisualizer.jsx"
click node_noiseui "https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/NoiseRemover.tsx"
click node_noiseroutes "https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_routes.py"
click node_noiseservice "https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_service.py"
click node_noiseconfig "https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_config.py"
click node_storage "https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_storage.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_app,node_dashboard,node_capture,node_studio,node_effectsui,node_store,node_player,node_client,node_user toneBlue
class node_server,node_io,node_filter,node_effects,node_analysis toneAmber
class node_noiseui,node_noiseroutes,node_noiseservice,node_noiseconfig,node_storage toneMint
class node_compare,node_theory,node_visuals toneRose
class node_ffmpeg toneIndigo
```

## Components

### Workstation UI

- [Routed App](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Signal Loading](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Mic Capture](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/MicCapture.tsx): `frontend/src/pages/MicCapture.tsx`
- [Studio Controls](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Studio.tsx): `frontend/src/pages/Studio.tsx`
- [Acoustic Presets](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Effects.tsx): `frontend/src/pages/Effects.tsx`
- [Audio State](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/store/useAudioStore.ts): `frontend/src/store/useAudioStore.ts`
- [Audio Playback](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/hooks/useAudioPlayer.ts): `frontend/src/hooks/useAudioPlayer.ts`
- [API Client](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### Signal Processing

- [DSP API](https://github.com/cse220-project/signal_scissor/blob/main/backend/server.py): `backend/server.py`
- [Signal I/O](https://github.com/cse220-project/signal_scissor/blob/main/backend/signal_io.py): `backend/signal_io.py`
- [Fourier Filter](https://github.com/cse220-project/signal_scissor/blob/main/backend/fourier_filter.py): `backend/fourier_filter.py`
- [Audio Effects](https://github.com/cse220-project/signal_scissor/blob/main/backend/audio_effects.py): `backend/audio_effects.py`
- [Signal Metrics](https://github.com/cse220-project/signal_scissor/blob/main/backend/signal_analysis.py): `backend/signal_analysis.py`

### Noise Remover

- [Denoiser Page](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/NoiseRemover.tsx): `frontend/src/pages/NoiseRemover.tsx`
- [Noise API Routes](https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_routes.py): `backend/noise_routes.py`
- [Noise Processing](https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_service.py): `backend/noise_service.py`
- [Noise Limits](https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_config.py): `backend/noise_config.py`
- [Result Storage](https://github.com/cse220-project/signal_scissor/blob/main/backend/noise_storage.py): `backend/noise_storage.py`

### Inspection and Learning

- [Signal Inspector](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Compare.tsx): `frontend/src/pages/Compare.tsx`
- [DSP Academy](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/pages/Theory.tsx): `frontend/src/pages/Theory.tsx`
- [Signal Visualizers](https://github.com/cse220-project/signal_scissor/blob/main/frontend/src/components/WaveformVisualizer.jsx): `frontend/src/components/WaveformVisualizer.jsx`

### Other components

- **User**
- **FFmpeg / FFprobe**

## Connections

- User → Routed App: uses (evidence: `README.md`)
- Routed App → Signal Loading: routes to (evidence: `frontend/src/App.tsx`)
- Routed App → Studio Controls: routes to (evidence: `frontend/src/App.tsx`)
- Routed App → Mic Capture: routes to (evidence: `frontend/src/App.tsx`)
- Routed App → Acoustic Presets: routes to (evidence: `frontend/src/App.tsx`)
- Routed App → Signal Inspector: routes to (evidence: `frontend/src/App.tsx`)
- Routed App → DSP Academy: routes to (evidence: `frontend/src/App.tsx`)
- Signal Loading → Audio State: loads signals
- Mic Capture → Audio State: commits recording
- Studio Controls → Audio State: controls processing
- Acoustic Presets → Audio State: applies presets
- Audio State → API Client: requests operations (evidence: `frontend/src/store/useAudioStore.ts`)
- API Client → DSP API: calls API (evidence: `frontend/src/api/client.ts`)
- DSP API → Signal I/O: loads and synthesizes (evidence: `backend/server.py`)
- DSP API → Fourier Filter: applies filtering (evidence: `backend/server.py`)
- DSP API → Audio Effects: applies effects (evidence: `backend/server.py`)
- DSP API → Signal Metrics: computes metrics (evidence: `backend/server.py`)
- Audio State → Audio Playback: provides track state (evidence: `frontend/src/hooks/useAudioPlayer.ts`)
- Audio Playback → API Client: gets audio stream (evidence: `frontend/src/hooks/useAudioPlayer.ts`)
- DSP API → Noise API Routes: registers routes (evidence: `backend/server.py`)
- User → Denoiser Page: uploads recording (evidence: `README.md`)
- Denoiser Page → Noise API Routes: submits audio
- Noise API Routes → Noise Processing: processes request (evidence: `backend/noise_routes.py`)
- Noise Processing → Noise Limits: reads limits (evidence: `backend/noise_service.py`)
- Noise Processing → Result Storage: publishes results (evidence: `backend/noise_service.py`)
- Noise Processing → FFmpeg / FFprobe: runs reduction (evidence: `README.md`)
- User → Signal Inspector: inspects results (evidence: `README.md`)
- User → DSP Academy: explores DSP (evidence: `README.md`)
- Studio Controls → Signal Visualizers: shows signal views
