# nessry/hybrid-beamforming architecture

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

- Interactive diagram: https://gitdiagram.com/nessry/hybrid-beamforming
- Repository: https://github.com/nessry/hybrid-beamforming

## Overview

This is a compact MATLAB example, not a general beamforming framework. Its workflow is to simulate the documented MIMO array, derive hybrid precoding and combining weights with orthogonal matching pursuit (OMP), and compare spectral efficiency against optimal digital weights over SNR and Monte Carlo trials. The README documents these stages, but no source excerpts were provided, so internal call order and the contents of `results` cannot be verified.

Main entry points: [`beamforming.m`](https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m) (MIMO simulation), [`results`](https://github.com/nessry/hybrid-beamforming/tree/master/results) (Results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Beamforming simulation"]
  node_sim["MIMO simulation<br/>[beamforming.m]"]
  node_omp["OMP hybrid weights<br/>[beamforming.m]"]
  node_optimal["Optimal digital weights<br/>[beamforming.m]"]
end

subgraph group_evaluation["Performance evaluation"]
  node_efficiency["Spectral efficiency<br/>[beamforming.m]"]
  node_trials["SNR Monte Carlo trials<br/>[beamforming.m]"]
  node_results["Results"]
end

node_user(("Engineer"))

node_user -->|"runs"| node_sim
node_sim -->|"derives weights"| node_omp
node_sim -->|"compares against"| node_optimal
node_sim -->|"evaluates across"| node_trials
node_trials -->|"yields comparison"| node_efficiency
node_efficiency -.->|"records curve"| node_results

click node_sim "https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m"
click node_omp "https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m"
click node_optimal "https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m"
click node_efficiency "https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m"
click node_trials "https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m"
click node_results "https://github.com/nessry/hybrid-beamforming/tree/master/results"

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_sim,node_omp,node_optimal toneBlue
class node_efficiency,node_trials,node_results toneAmber
class node_user toneIndigo
```

## Components

### Beamforming simulation

- [MIMO simulation](https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m): `beamforming.m`
- [OMP hybrid weights](https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m): `beamforming.m`
- [Optimal digital weights](https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m): `beamforming.m`

### Performance evaluation

- [Spectral efficiency](https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m): `beamforming.m`
- [SNR Monte Carlo trials](https://github.com/nessry/hybrid-beamforming/blob/master/beamforming.m): `beamforming.m`
- [Results](https://github.com/nessry/hybrid-beamforming/tree/master/results): `results`

### Other components

- **Engineer**

## Connections

- Engineer → MIMO simulation: runs (evidence: `README.md`)
- MIMO simulation → OMP hybrid weights: derives weights (evidence: `README.md`)
- MIMO simulation → Optimal digital weights: compares against (evidence: `README.md`)
- MIMO simulation → SNR Monte Carlo trials: evaluates across (evidence: `README.md`)
- SNR Monte Carlo trials → Spectral efficiency: yields comparison (evidence: `README.md`)
- Spectral efficiency → Results: records curve
