# jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking architecture

> Architecture diagram of the GitHub repository jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking
- Repository: https://github.com/jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking

## Overview

##### Project type and purpose
- This is a model-based control simulation project that integrates CarSim (vehicle dynamics) with Simulink for MPC (Model Predictive Control) circle-trajectory tracking.
- The key artifacts are a Simulink model (MPCTracking.slx), MATLAB controller scripts (MY_MPCController3.m, quadprog.m), and a parameter file (mpc.cpar).

##### File structure
- Top-level:
- MPCTracking.slx – the Simulink model coordinating the simulation
- MY_MPCController3.m – the MATLAB function implementing the MPC control law
- quadprog.m – the QP‐solver script for the MPC optimization problem
- mpc.cpar – a data file containing MPC parameters (horizon, weights, constraints)
- README.md – project description
- There are no separate “frontend/backend” directories; instead the structure focuses on model, controller code, solver, and parameters.

##### README for additional insights
- Confirms that CarSim and Simulink run jointly (“联合轨迹跟踪仿真”) for circle trajectory following.
- Implies an external simulation engine (CarSim) feeding vehicle states into Simulink and receiving control inputs.

## Diagram (Mermaid)

```mermaid
graph TD
    CarSim["CarSim Vehicle Dynamics Engine"]:::sim
    subgraph "Simulink Real-Time Simulation Environment" 
        direction TB
        Traj["Reference Trajectory Generator"]:::ctrl
        MPC["MPC Controller Subsystem"]:::ctrl
    end
    QP["QP Solver"]:::opt
    Params["Parameter Store"]:::config

    CarSim -->|"x, y, ψ, v"| Traj
    CarSim -->|"x, y, ψ, v"| MPC
    Traj -->|"reference r"| MPC
    Params -->|"mpc parameters"| MPC
    MPC -->|"cost matrices & constraints"| QP
    QP -->|"optimal u"| MPC
    MPC -->|"u_steer, u_throttle"| CarSim

    click Traj "https://github.com/jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking/blob/main/MPCTracking.slx"
    click MPC "https://github.com/jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking/blob/main/MY_MPCController3.m"
    click QP "https://github.com/jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking/blob/main/quadprog.m"
    click Params "https://github.com/jesonleee/mpc-based-carsim_simulink-circle-trajectory-tracking/blob/main/mpc.cpar"

    classDef sim fill:#AED6F1,stroke:#1F618D;
    classDef ctrl fill:#A9DFBF,stroke:#196F3D;
    classDef opt fill:#F5CBA7,stroke:#B03A2E;
    classDef config fill:#D5D8DC,stroke:#424949;
```
