# akhas2000/aris-matmpc architecture

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

- Interactive diagram: https://gitdiagram.com/akhas2000/aris-matmpc
- Repository: https://github.com/akhas2000/aris-matmpc

## Overview

This MATLAB project evaluates orientation-aware UAV control and trajectory design for RIS-assisted wireless communication. Its main workflow initializes a benchmark, runs closed-loop NMPC simulation, and produces plots; separate workflows evaluate scalability and compare reference-trajectory methods. The graph follows relationships documented in the README; no source excerpts were available, so undocumented calls are omitted.

Main entry points: [`Main_Ref_Traj.m`](https://github.com/akhas2000/aris-matmpc/blob/main/Main_Ref_Traj.m) (Reference Trajectory Study), [`Main_Ref_Djikstra_Vs_PSCA.m`](https://github.com/akhas2000/aris-matmpc/blob/main/Main_Ref_Djikstra_Vs_PSCA.m) (Dijkstra–PSCA Comparison), [`Simulation.m`](https://github.com/akhas2000/aris-matmpc/blob/main/Simulation.m) (HoT Simulation), [`Main.m`](https://github.com/akhas2000/aris-matmpc/blob/main/Main.m) (Benchmark Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["NMPC Simulation"]
  node_model["UAV Model Generation<br/>[Model_Generation.m]"]
  node_uavmodel["Symbolic UAV Model<br/>[GTMR_4_com_soft.m]"]
  node_benchmark["Benchmark Runner<br/>[Main.m]"]
  node_simulation_run["HoT Simulation<br/>[Simulation.m]"]
  node_nmpc_init["NMPC Initialization<br/>[InitData_Main.m]"]
  node_nmpc_run["Closed-Loop NMPC<br/>[Simulation_Main.m]"]
end

subgraph group_communications["RIS Communications"]
  node_communication_setup["Communication Setup<br/>[Setup_env.m]"]
  node_communication_rates["Rate Evaluation"]
  node_path_rates["Path Rate Summary"]
  node_bs_array["Base Station Response"]
  node_ris_array["RIS Phase Response"]
  node_aperture_gain["Aperture Gain"]
end

subgraph group_trajectories["Trajectory Design"]
  node_reference_runner["Reference Trajectory Study<br/>[Main_Ref_Traj.m]"]
  node_trajectory_planner["Proxy Utility Planner"]
  node_astar_planner["A-star Planner"]
  node_knn_planner["Random KNN Planner"]
  node_comparison_runner["Dijkstra–PSCA Comparison"]
  node_psca_position["PSCA Position Optimization"]
  node_psca_reference["PSCA Reference Generation<br/>[PSCA_REF_NoReg.m]"]
  node_psca_interpolate["PSCA Trajectory Densification<br/>[PSCA_Interpolate.m]"]
end

subgraph group_scaling["Scalability Analysis"]
  node_scale_k["User Count Study"]
  node_scale_m["RIS Size Study<br/>[Main_Scale_M.m]"]
  node_scale_model["Scale Model Generation"]
  node_scale_init["Scale Initialization<br/>[InitData_Scale.m]"]
  node_scale_sim["Scale Simulation<br/>[Simulation_Scale.m]"]
  node_scale_main["Scale Simulation Runner<br/>[Main_Scale.m]"]
end

subgraph group_presentation["Results"]
  node_draw["Simulation Plots<br/>[Draw.m]"]
  node_draw_main["Benchmark Comparison Plots<br/>[Draw_Main.m]"]
  node_pdf["PDF Export<br/>[From_Fig_To_PDF.m]"]
end

node_user(("Researcher"))

node_user -->|"generates model"| node_model
node_model -->|"compiles dynamics"| node_uavmodel
node_user -->|"runs HoT"| node_simulation_run
node_user -->|"runs benchmarks"| node_benchmark
node_benchmark -->|"initializes"| node_nmpc_init
node_benchmark -->|"launches"| node_simulation_run
node_simulation_run -->|"initializes"| node_nmpc_init
node_simulation_run -->|"runs controller"| node_nmpc_run
node_simulation_run -->|"generates plots"| node_draw
node_benchmark -->|"generates comparisons"| node_draw_main
node_user -->|"evaluates trajectories"| node_reference_runner
node_reference_runner -->|"evaluates algorithm"| node_trajectory_planner
node_reference_runner -->|"evaluates algorithm"| node_astar_planner
node_reference_runner -->|"evaluates algorithm"| node_knn_planner
node_reference_runner -->|"compares rate utility"| node_communication_rates
node_user -->|"compares methods"| node_comparison_runner
node_comparison_runner -->|"uses proxy planner"| node_trajectory_planner
node_comparison_runner -->|"uses PSCA method"| node_psca_position
node_comparison_runner -->|"generates reference"| node_psca_reference
node_comparison_runner -->|"densifies trajectory"| node_psca_interpolate
node_comparison_runner -->|"compares performance"| node_communication_rates
node_user -->|"varies users"| node_scale_k
node_user -->|"varies RIS size"| node_scale_m
node_scale_k -->|"generates model"| node_scale_model
node_scale_m -->|"generates model"| node_scale_model
node_scale_k -->|"initializes"| node_scale_init
node_scale_m -->|"initializes"| node_scale_init
node_scale_k -->|"runs simulations"| node_scale_main
node_scale_m -->|"runs simulations"| node_scale_main
node_scale_main -->|"executes"| node_scale_sim
node_reference_runner -.->|"summarizes path rates"| node_path_rates
node_simulation_run -.->|"configures channel"| node_communication_setup
node_communication_setup -.->|"uses array response"| node_bs_array
node_communication_setup -.->|"uses phase response"| node_ris_array
node_communication_rates -.->|"uses orientation gain"| node_aperture_gain
node_user -.->|"exports figures"| node_pdf

click node_model "https://github.com/akhas2000/aris-matmpc/blob/main/Model_Generation.m"
click node_uavmodel "https://github.com/akhas2000/aris-matmpc/blob/main/examples/GTMR_4_com_soft.m"
click node_benchmark "https://github.com/akhas2000/aris-matmpc/blob/main/Main.m"
click node_simulation_run "https://github.com/akhas2000/aris-matmpc/blob/main/Simulation.m"
click node_nmpc_init "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/InitData_Main.m"
click node_nmpc_run "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Simulation_Main.m"
click node_communication_setup "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/Setup_env.m"
click node_communication_rates "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/Rates_No_Complex_phase.m"
click node_path_rates "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/computeTotalRateAlongPath.m"
click node_bs_array "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/array_response_phases_BS.m"
click node_ris_array "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/phase_array_response_RIS.m"
click node_aperture_gain "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/compute_aperture_gain_from_rotation.m"
click node_reference_runner "https://github.com/akhas2000/aris-matmpc/blob/main/Main_Ref_Traj.m"
click node_trajectory_planner "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Robotic_Functions/optimalTrajectoryPU.m"
click node_astar_planner "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Robotic_Functions/optimalTrajectoryPU_Astar.m"
click node_knn_planner "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Robotic_Functions/optimalTrajectoryRandomKNN.m"
click node_comparison_runner "https://github.com/akhas2000/aris-matmpc/blob/main/Main_Ref_Djikstra_Vs_PSCA.m"
click node_psca_position "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Ref_Generation_PSCA/PSCA_Optimal_Position.m"
click node_psca_reference "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Ref_Generation_PSCA/PSCA_REF_NoReg.m"
click node_psca_interpolate "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Ref_Generation_PSCA/PSCA_Interpolate.m"
click node_scale_k "https://github.com/akhas2000/aris-matmpc/blob/main/Main_Scale_K_User.m"
click node_scale_m "https://github.com/akhas2000/aris-matmpc/blob/main/Main_Scale_M.m"
click node_scale_model "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Model_Generation_Scale.m"
click node_scale_init "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/InitData_Scale.m"
click node_scale_sim "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Simulation_Scale.m"
click node_scale_main "https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Main_Scale.m"
click node_draw "https://github.com/akhas2000/aris-matmpc/blob/main/Draw.m"
click node_draw_main "https://github.com/akhas2000/aris-matmpc/blob/main/Draw_Main.m"
click node_pdf "https://github.com/akhas2000/aris-matmpc/blob/main/From_Fig_To_PDF.m"

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_model,node_uavmodel,node_benchmark,node_simulation_run,node_nmpc_init,node_nmpc_run toneBlue
class node_communication_setup,node_communication_rates,node_path_rates,node_bs_array,node_ris_array,node_aperture_gain toneAmber
class node_reference_runner,node_trajectory_planner,node_astar_planner,node_knn_planner,node_comparison_runner,node_psca_position,node_psca_reference,node_psca_interpolate toneMint
class node_scale_k,node_scale_m,node_scale_model,node_scale_init,node_scale_sim,node_scale_main toneRose
class node_draw,node_draw_main,node_pdf,node_user toneIndigo
```

## Components

### NMPC Simulation

- [UAV Model Generation](https://github.com/akhas2000/aris-matmpc/blob/main/Model_Generation.m): `Model_Generation.m`
- [Symbolic UAV Model](https://github.com/akhas2000/aris-matmpc/blob/main/examples/GTMR_4_com_soft.m): `examples/GTMR_4_com_soft.m`
- [Benchmark Runner](https://github.com/akhas2000/aris-matmpc/blob/main/Main.m): `Main.m`
- [HoT Simulation](https://github.com/akhas2000/aris-matmpc/blob/main/Simulation.m): `Simulation.m`
- [NMPC Initialization](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/InitData_Main.m): `Functions/MATMPC_Functions/InitData_Main.m`
- [Closed-Loop NMPC](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Simulation_Main.m): `Functions/MATMPC_Functions/Simulation_Main.m`

### RIS Communications

- [Communication Setup](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/Setup_env.m): `Functions/Communication_Functions/Setup_env.m`
- [Rate Evaluation](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/Rates_No_Complex_phase.m): `Functions/Communication_Functions/Rates_No_Complex_phase.m`
- [Path Rate Summary](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/computeTotalRateAlongPath.m): `Functions/Communication_Functions/computeTotalRateAlongPath.m`
- [Base Station Response](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/array_response_phases_BS.m): `Functions/Communication_Functions/array_response_phases_BS.m`
- [RIS Phase Response](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/phase_array_response_RIS.m): `Functions/Communication_Functions/phase_array_response_RIS.m`
- [Aperture Gain](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Communication_Functions/compute_aperture_gain_from_rotation.m): `Functions/Communication_Functions/compute_aperture_gain_from_rotation.m`

### Trajectory Design

- [Reference Trajectory Study](https://github.com/akhas2000/aris-matmpc/blob/main/Main_Ref_Traj.m): `Main_Ref_Traj.m`
- [Proxy Utility Planner](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Robotic_Functions/optimalTrajectoryPU.m): `Functions/Robotic_Functions/optimalTrajectoryPU.m`
- [A-star Planner](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Robotic_Functions/optimalTrajectoryPU_Astar.m): `Functions/Robotic_Functions/optimalTrajectoryPU_Astar.m`
- [Random KNN Planner](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Robotic_Functions/optimalTrajectoryRandomKNN.m): `Functions/Robotic_Functions/optimalTrajectoryRandomKNN.m`
- [Dijkstra–PSCA Comparison](https://github.com/akhas2000/aris-matmpc/blob/main/Main_Ref_Djikstra_Vs_PSCA.m): `Main_Ref_Djikstra_Vs_PSCA.m`
- [PSCA Position Optimization](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Ref_Generation_PSCA/PSCA_Optimal_Position.m): `Functions/Ref_Generation_PSCA/PSCA_Optimal_Position.m`
- [PSCA Reference Generation](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Ref_Generation_PSCA/PSCA_REF_NoReg.m): `Functions/Ref_Generation_PSCA/PSCA_REF_NoReg.m`
- [PSCA Trajectory Densification](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/Ref_Generation_PSCA/PSCA_Interpolate.m): `Functions/Ref_Generation_PSCA/PSCA_Interpolate.m`

### Scalability Analysis

- [User Count Study](https://github.com/akhas2000/aris-matmpc/blob/main/Main_Scale_K_User.m): `Main_Scale_K_User.m`
- [RIS Size Study](https://github.com/akhas2000/aris-matmpc/blob/main/Main_Scale_M.m): `Main_Scale_M.m`
- [Scale Model Generation](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Model_Generation_Scale.m): `Functions/MATMPC_Functions/Model_Generation_Scale.m`
- [Scale Initialization](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/InitData_Scale.m): `Functions/MATMPC_Functions/InitData_Scale.m`
- [Scale Simulation](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Simulation_Scale.m): `Functions/MATMPC_Functions/Simulation_Scale.m`
- [Scale Simulation Runner](https://github.com/akhas2000/aris-matmpc/blob/main/Functions/MATMPC_Functions/Main_Scale.m): `Functions/MATMPC_Functions/Main_Scale.m`

### Results

- [Simulation Plots](https://github.com/akhas2000/aris-matmpc/blob/main/Draw.m): `Draw.m`
- [Benchmark Comparison Plots](https://github.com/akhas2000/aris-matmpc/blob/main/Draw_Main.m): `Draw_Main.m`
- [PDF Export](https://github.com/akhas2000/aris-matmpc/blob/main/From_Fig_To_PDF.m): `From_Fig_To_PDF.m`

### Other components

- **Researcher**

## Connections

- Researcher → UAV Model Generation: generates model (evidence: `README.md`)
- UAV Model Generation → Symbolic UAV Model: compiles dynamics (evidence: `README.md`)
- Researcher → HoT Simulation: runs HoT (evidence: `README.md`)
- Researcher → Benchmark Runner: runs benchmarks (evidence: `README.md`)
- Benchmark Runner → NMPC Initialization: initializes (evidence: `README.md`)
- Benchmark Runner → HoT Simulation: launches (evidence: `README.md`)
- HoT Simulation → NMPC Initialization: initializes (evidence: `README.md`)
- HoT Simulation → Closed-Loop NMPC: runs controller (evidence: `README.md`)
- HoT Simulation → Simulation Plots: generates plots (evidence: `README.md`)
- Benchmark Runner → Benchmark Comparison Plots: generates comparisons (evidence: `README.md`)
- Researcher → Reference Trajectory Study: evaluates trajectories (evidence: `README.md`)
- Reference Trajectory Study → Proxy Utility Planner: evaluates algorithm (evidence: `README.md`)
- Reference Trajectory Study → A-star Planner: evaluates algorithm (evidence: `README.md`)
- Reference Trajectory Study → Random KNN Planner: evaluates algorithm (evidence: `README.md`)
- Reference Trajectory Study → Rate Evaluation: compares rate utility (evidence: `README.md`)
- Researcher → Dijkstra–PSCA Comparison: compares methods (evidence: `README.md`)
- Dijkstra–PSCA Comparison → Proxy Utility Planner: uses proxy planner (evidence: `README.md`)
- Dijkstra–PSCA Comparison → PSCA Position Optimization: uses PSCA method (evidence: `README.md`)
- Dijkstra–PSCA Comparison → PSCA Reference Generation: generates reference (evidence: `README.md`)
- Dijkstra–PSCA Comparison → PSCA Trajectory Densification: densifies trajectory (evidence: `README.md`)
- Dijkstra–PSCA Comparison → Rate Evaluation: compares performance (evidence: `README.md`)
- Researcher → User Count Study: varies users (evidence: `README.md`)
- Researcher → RIS Size Study: varies RIS size (evidence: `README.md`)
- User Count Study → Scale Model Generation: generates model (evidence: `README.md`)
- RIS Size Study → Scale Model Generation: generates model (evidence: `README.md`)
- User Count Study → Scale Initialization: initializes (evidence: `README.md`)
- RIS Size Study → Scale Initialization: initializes (evidence: `README.md`)
- User Count Study → Scale Simulation Runner: runs simulations (evidence: `README.md`)
- RIS Size Study → Scale Simulation Runner: runs simulations (evidence: `README.md`)
- Scale Simulation Runner → Scale Simulation: executes (evidence: `README.md`)
- Reference Trajectory Study → Path Rate Summary: summarizes path rates
- HoT Simulation → Communication Setup: configures channel
- Communication Setup → Base Station Response: uses array response
- Communication Setup → RIS Phase Response: uses phase response
- Rate Evaluation → Aperture Gain: uses orientation gain
- Researcher → PDF Export: exports figures
