# alexaltomi/radarsense architecture

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

- Interactive diagram: https://gitdiagram.com/alexaltomi/radarsense
- Repository: https://github.com/alexaltomi/radarsense

## Overview

RadarSense replays recorded 60 GHz radar data to an Android app, which displays live frames and recognizes gestures; no radar hardware is used. The offline workflow processes dataset recordings into range-Doppler/phase frames, creates labeled windows, and trains/evaluates models for mobile inference. The graph preserves the documented training and export capabilities, but those unsampled subsystems are represented at directory level. Some backend and DSP connections are omitted because the excerpts do not establish their call direction.

Main entry points: [`android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt) (Stream orchestration), [`android/app/src/main/java/com/radarsense/app/MainActivity.kt`](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/MainActivity.kt) (App navigation), [`android/app/src/main/java/com/radarsense/app/data/net/FrameStreamClient.kt`](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/net/FrameStreamClient.kt) (WebSocket client), [`backend/replay/replay/server.py`](https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/server.py) (Replay WebSocket)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_activity["App navigation<br/>[MainActivity.kt]"]
  node_connect["Connect screen<br/>[ConnectScreen.kt]"]
  node_live["Live display<br/>[LiveScreen.kt]"]
  node_actions["Actions screen<br/>[ActionsScreen.kt]"]
  node_vm["Stream orchestration<br/>[StreamViewModel.kt]"]
  node_client["WebSocket client"]
  node_protocol["Stream protocol<br/>[StreamProtocol.kt]"]
  node_parser["Frame parser<br/>[FrameParser.kt]"]
  node_frame["Frame data<br/>[Frame.kt]"]
  node_buffer["Frame buffer<br/>[FrameBuffer.kt]"]
  node_decoder["Window decoder<br/>[WindowDecoder.kt]"]
  node_classifier["Gesture classifier"]
  node_detector["Gesture detector<br/>[GestureDetector.kt]"]
  node_dispatcher["Action dispatcher"]
end

subgraph group_replay["Replay service"]
  node_server["Replay WebSocket<br/>[server.py]"]
  node_index["Replay index<br/>[index.py]"]
  node_codec["Frame encoding<br/>[codec.py]"]
  node_sources["Replay sources<br/>[sources.py]"]
end

subgraph group_dsp["Dataset processing"]
  node_cache[("Processed cache<br/>[cache.py]")]
  node_frames["Radar transforms<br/>[frames.py]"]
  node_io["Dataset access<br/>[io.py]"]
  node_windows["Window labeling<br/>[windows.py]"]
end

subgraph group_ml["Model development"]
  node_build["Cache build<br/>[build_cache.py]"]
  node_baseline["Baseline training<br/>[baseline.py]"]
  node_model["CNN model<br/>[model.py]"]
  node_train["CNN training<br/>[train.py]"]
  node_eval["Model evaluation<br/>[eval.py]"]
  node_export["Model export<br/>[convert_litert.py]"]
end

node_user(("App user"))

node_user -->|"opens"| node_activity
node_activity -->|"shows"| node_connect
node_activity -->|"shows"| node_live
node_activity -->|"shows"| node_actions
node_activity -->|"creates"| node_vm
node_connect -.->|"configures"| node_vm
node_vm -->|"starts stream"| node_client
node_client -->|"requests frames"| node_server
node_server -->|"builds index"| node_index
node_server -->|"streams frames"| node_user
node_client -->|"formats messages"| node_protocol
node_client -.->|"parses frames"| node_parser
node_vm -->|"adds frames"| node_buffer
node_buffer -->|"stores"| node_frame
node_vm -->|"decodes window"| node_decoder
node_vm -->|"classifies window"| node_classifier
node_vm -->|"filters predictions"| node_detector
node_vm -->|"dispatches fires"| node_dispatcher
node_live -->|"renders"| node_frame
node_actions -->|"configures"| node_dispatcher
node_index -->|"loads cache windows"| node_windows
node_build -->|"builds"| node_cache
node_cache -.->|"reads recordings"| node_io
node_cache -.->|"transforms frames"| node_frames
node_baseline -->|"uses labeled windows"| node_windows
node_train -->|"trains"| node_model
node_eval -->|"evaluates"| node_model
node_train -->|"loads training windows"| node_windows
node_export -.->|"exports for inference"| node_classifier

click node_activity "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/MainActivity.kt"
click node_connect "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/stream/ConnectScreen.kt"
click node_live "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/stream/LiveScreen.kt"
click node_actions "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/actions/ActionsScreen.kt"
click node_vm "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt"
click node_client "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/net/FrameStreamClient.kt"
click node_protocol "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/net/StreamProtocol.kt"
click node_parser "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/net/FrameParser.kt"
click node_frame "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/Frame.kt"
click node_buffer "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/FrameBuffer.kt"
click node_decoder "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/WindowDecoder.kt"
click node_classifier "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/ml/LiteRtGestureClassifier.kt"
click node_detector "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/GestureDetector.kt"
click node_dispatcher "https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/ActionDispatcher.kt"
click node_server "https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/server.py"
click node_index "https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/index.py"
click node_codec "https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/codec.py"
click node_sources "https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/sources.py"
click node_cache "https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/cache.py"
click node_frames "https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/frames.py"
click node_io "https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/io.py"
click node_windows "https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/windows.py"
click node_build "https://github.com/alexaltomi/radarsense/blob/main/training/build_cache.py"
click node_baseline "https://github.com/alexaltomi/radarsense/blob/main/training/baseline.py"
click node_model "https://github.com/alexaltomi/radarsense/blob/main/training/model.py"
click node_train "https://github.com/alexaltomi/radarsense/blob/main/training/train.py"
click node_eval "https://github.com/alexaltomi/radarsense/blob/main/training/eval.py"
click node_export "https://github.com/alexaltomi/radarsense/blob/main/training/convert_litert.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_activity,node_connect,node_live,node_actions,node_vm,node_client,node_protocol,node_parser,node_frame,node_buffer,node_decoder,node_classifier,node_detector,node_dispatcher,node_user toneBlue
class node_server,node_index,node_codec,node_sources toneAmber
class node_cache,node_frames,node_io,node_windows toneMint
class node_build,node_baseline,node_model,node_train,node_eval,node_export toneRose
```

## Components

### Android app

- [App navigation](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/MainActivity.kt): `android/app/src/main/java/com/radarsense/app/MainActivity.kt`
- [Connect screen](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/stream/ConnectScreen.kt): `android/app/src/main/java/com/radarsense/app/ui/stream/ConnectScreen.kt`
- [Live display](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/stream/LiveScreen.kt): `android/app/src/main/java/com/radarsense/app/ui/stream/LiveScreen.kt`
- [Actions screen](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/actions/ActionsScreen.kt): `android/app/src/main/java/com/radarsense/app/ui/actions/ActionsScreen.kt`
- [Stream orchestration](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt): `android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`
- [WebSocket client](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/net/FrameStreamClient.kt): `android/app/src/main/java/com/radarsense/app/data/net/FrameStreamClient.kt`
- [Stream protocol](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/net/StreamProtocol.kt): `android/app/src/main/java/com/radarsense/app/data/net/StreamProtocol.kt`
- [Frame parser](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/net/FrameParser.kt): `android/app/src/main/java/com/radarsense/app/data/net/FrameParser.kt`
- [Frame data](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/Frame.kt): `android/app/src/main/java/com/radarsense/app/domain/Frame.kt`
- [Frame buffer](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/FrameBuffer.kt): `android/app/src/main/java/com/radarsense/app/domain/FrameBuffer.kt`
- [Window decoder](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/WindowDecoder.kt): `android/app/src/main/java/com/radarsense/app/domain/WindowDecoder.kt`
- [Gesture classifier](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/data/ml/LiteRtGestureClassifier.kt): `android/app/src/main/java/com/radarsense/app/data/ml/LiteRtGestureClassifier.kt`
- [Gesture detector](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/GestureDetector.kt): `android/app/src/main/java/com/radarsense/app/domain/GestureDetector.kt`
- [Action dispatcher](https://github.com/alexaltomi/radarsense/blob/main/android/app/src/main/java/com/radarsense/app/domain/ActionDispatcher.kt): `android/app/src/main/java/com/radarsense/app/domain/ActionDispatcher.kt`

### Replay service

- [Replay WebSocket](https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/server.py): `backend/replay/replay/server.py`
- [Replay index](https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/index.py): `backend/replay/replay/index.py`
- [Frame encoding](https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/codec.py): `backend/replay/replay/codec.py`
- [Replay sources](https://github.com/alexaltomi/radarsense/blob/main/backend/replay/replay/sources.py): `backend/replay/replay/sources.py`

### Dataset processing

- [Processed cache](https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/cache.py): `dsp/radarsense_dsp/cache.py`
- [Radar transforms](https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/frames.py): `dsp/radarsense_dsp/frames.py`
- [Dataset access](https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/io.py): `dsp/radarsense_dsp/io.py`
- [Window labeling](https://github.com/alexaltomi/radarsense/blob/main/dsp/radarsense_dsp/windows.py): `dsp/radarsense_dsp/windows.py`

### Model development

- [Cache build](https://github.com/alexaltomi/radarsense/blob/main/training/build_cache.py): `training/build_cache.py`
- [Baseline training](https://github.com/alexaltomi/radarsense/blob/main/training/baseline.py): `training/baseline.py`
- [CNN model](https://github.com/alexaltomi/radarsense/blob/main/training/model.py): `training/model.py`
- [CNN training](https://github.com/alexaltomi/radarsense/blob/main/training/train.py): `training/train.py`
- [Model evaluation](https://github.com/alexaltomi/radarsense/blob/main/training/eval.py): `training/eval.py`
- [Model export](https://github.com/alexaltomi/radarsense/blob/main/training/convert_litert.py): `training/convert_litert.py`

### Other components

- **App user**

## Connections

- App user → App navigation: opens (evidence: `android/app/src/main/java/com/radarsense/app/MainActivity.kt`)
- App navigation → Connect screen: shows (evidence: `android/app/src/main/java/com/radarsense/app/MainActivity.kt`)
- App navigation → Live display: shows (evidence: `android/app/src/main/java/com/radarsense/app/MainActivity.kt`)
- App navigation → Actions screen: shows (evidence: `android/app/src/main/java/com/radarsense/app/MainActivity.kt`)
- App navigation → Stream orchestration: creates (evidence: `android/app/src/main/java/com/radarsense/app/MainActivity.kt`)
- Connect screen → Stream orchestration: configures
- Stream orchestration → WebSocket client: starts stream (evidence: `android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`)
- WebSocket client → Replay WebSocket: requests frames (evidence: `README.md`)
- Replay WebSocket → Replay index: builds index (evidence: `backend/replay/replay/server.py`)
- Replay WebSocket → App user: streams frames (evidence: `backend/replay/replay/server.py`)
- WebSocket client → Stream protocol: formats messages (evidence: `android/app/src/main/java/com/radarsense/app/data/net/FrameStreamClient.kt`)
- WebSocket client → Frame parser: parses frames (evidence: `android/app/src/main/java/com/radarsense/app/data/net/FrameStreamClient.kt`)
- Stream orchestration → Frame buffer: adds frames (evidence: `android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`)
- Frame buffer → Frame data: stores (evidence: `android/app/src/main/java/com/radarsense/app/domain/FrameBuffer.kt`)
- Stream orchestration → Window decoder: decodes window (evidence: `android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`)
- Stream orchestration → Gesture classifier: classifies window (evidence: `android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`)
- Stream orchestration → Gesture detector: filters predictions (evidence: `android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`)
- Stream orchestration → Action dispatcher: dispatches fires (evidence: `android/app/src/main/java/com/radarsense/app/ui/stream/StreamViewModel.kt`)
- Live display → Frame data: renders (evidence: `android/app/src/main/java/com/radarsense/app/ui/stream/LiveScreen.kt`)
- Actions screen → Action dispatcher: configures (evidence: `android/app/src/main/java/com/radarsense/app/ui/actions/ActionsScreen.kt`)
- Replay index → Window labeling: loads cache windows (evidence: `backend/replay/replay/index.py`)
- Cache build → Processed cache: builds (evidence: `training/build_cache.py`)
- Processed cache → Dataset access: reads recordings (evidence: `dsp/radarsense_dsp/cache.py`)
- Processed cache → Radar transforms: transforms frames (evidence: `dsp/radarsense_dsp/cache.py`)
- Baseline training → Window labeling: uses labeled windows (evidence: `training/baseline.py`)
- CNN training → CNN model: trains (evidence: `training/train.py`)
- Model evaluation → CNN model: evaluates (evidence: `training/eval.py`)
- CNN training → Window labeling: loads training windows (evidence: `training/train.py`)
- Model export → Gesture classifier: exports for inference
