# zhaoliangbin42/uplinksensing_mmwave architecture

> Architecture diagram of the GitHub repository zhaoliangbin42/uplinksensing_mmwave, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zhaoliangbin42/uplinksensing_mmwave
- Repository: https://github.com/zhaoliangbin42/uplinksensing_mmwave

## Overview

##### Project type and purpose
- This is an open-source MATLAB simulation toolbox implementing high-resolution uplink sensing algorithms for millimeter-wave ISAC systems (based on the cited paper).
- It’s not a web or database system, but a research‐oriented signal-processing pipeline: config → data generation → signal processing → visualization.

##### File structure
Top-level files:
- Main.m         – entry point: loads params, runs the end-to-end simulation
- Params.m       – advanced system and scenario parameters
- Readme.md      – project overview, usage, algorithm descriptions
- LICENSE        – MIT license
- .gitignore

Directories:
- Gen_Data/      – functions to synthetically generate received signals (Gen_Y_AoA.m, Gen_Y_DD.m)
- Funcs/         – core signal-processing routines:
– Customed_Figure.m (plot helpers)
– Func_Array_Response.m (array manifold computation)
– Func_Detect_LoS.m (LoS path detection)
– Func_MUSIC_* (AoA and Doppler-Delay estimation)
– Func_Opt_* (beamforming optimizers: NULL, SINR, HYBD, BART)
– Func_Compare_Sets.m (utility for comparing result sets)
- Figs/          – generated SVGs for visualization (AoA spectrum, beam patterns, 2D-MUSIC)

##### Key insights from README
- Workflow:
1) Generate received signal snapshots for static/dynamic targets
2) High-resolution AoA estimation with MUSIC
3) LoS detection
4) Beamforming vector design (multiple strategies)
5) 2D-FFT-MUSIC for joint Doppler & delay estimation
6) Plot and save figures
- Parameters defined in Main.m vs. Params.m
- Outputs: SVG figures in Figs/

##### Elements
– Blue for configuration/parameters
– Green for data generation
– Orange for processing modules
– Purple for visualization/output

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Configuration Layer
    subgraph "Configuration"
        Main["Main.m"]:::config
        Params["Params.m"]:::config
    end

    %% Data Generation Layer
    subgraph "Data Generation"
        GenAoA["Gen_Y_AoA.m"]:::dataGen
        GenDD["Gen_Y_DD.m"]:::dataGen
    end

    %% Processing Pipeline
    subgraph "Processing Pipeline"
        subgraph "Array Response"
            ARR["Func_Array_Response.m"]:::processing
        end
        subgraph "AoA Estimation"
            MUSIC_AoA["Func_MUSIC_AoA_Smooth.m"]:::processing
        end
        subgraph "LoS Detection"
            LOS["Func_Detect_LoS.m"]:::processing
        end
        subgraph "Beamforming Design"
            BFV["Func_Beamforming_Vec.m"]:::processing
            NULLOpt["Func_Opt_NULL.m"]:::processing
            SINROpt["Func_Opt_SINR.m"]:::processing
            HYBDOpt["Func_Opt_Hybrid.m"]:::processing
        end
        subgraph "Doppler-Delay Estimation"
            MUSIC_DD["Func_MUSIC_Doppler_Delay.m"]:::processing
        end
        Compare["Func_Compare_Sets.m"]:::processing
    end

    %% Visualization Layer
    subgraph "Visualization"
        Figure["Customed_Figure.m"]:::viz
        FigsDir["Figs/"]:::viz
    end

    %% Flow Arrows
    Params --> Main
    Main --> GenAoA
    Main --> GenDD
    GenAoA --> ARR
    GenDD --> ARR
    ARR --> MUSIC_AoA
    MUSIC_AoA --> LOS
    LOS --> BFV
    BFV --> MUSIC_DD
    MUSIC_DD --> Compare
    Compare --> Figure
    Figure --> FigsDir

    %% Click Events
    click Main "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Main.m"
    click Params "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Params.m"
    click GenAoA "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Gen_Data/Gen_Y_AoA.m"
    click GenDD "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Gen_Data/Gen_Y_DD.m"
    click ARR "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_Array_Response.m"
    click MUSIC_AoA "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_MUSIC_AoA_Smooth.m"
    click MUSIC_DD "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_MUSIC_Doppler_Delay.m"
    click LOS "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_Detect_LoS.m"
    click BFV "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_Beamforming_Vec.m"
    click NULLOpt "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_Opt_NULL.m"
    click SINROpt "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_Opt_SINR.m"
    click HYBDOpt "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_Opt_Hybrid.m"
    click Compare "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Func_Compare_Sets.m"
    click Figure "https://github.com/zhaoliangbin42/uplinksensing_mmwave/blob/master/Funcs/Customed_Figure.m"
    click FigsDir "https://github.com/zhaoliangbin42/uplinksensing_mmwave/tree/master/Figs/"

    %% Styles
    classDef config fill:#bbdefb,stroke:#0d47a1;
    classDef dataGen fill:#c8e6c9,stroke:#1b5e20;
    classDef processing fill:#ffe0b2,stroke:#e65100;
    classDef viz fill:#e1bee7,stroke:#6a1b9a;
```
