mpc_python_learn/README.md

53 lines
1.2 KiB
Markdown

# mpc_python
Python implementation of a mpc controller for path tracking using **[CVXPY](https://www.cvxpy.org/)**.
## About
The MPC is a model predictive path following controller which does follow a predefined reference path Xref and Yref by solving an optimization problem. The resulting optimization problem is shown in the following equation:
![](img/quicklatex1.png)
The vehicle dynamics are described by the differential drive model:
![](img/quicklatex2.png)
The state variables of the model are:
* **x** coordinate of the robot
* **y** coordinate of the robot
* **theta** heading of the robot
The inputs of the model are:
* **v** linear velocity of the robot
* **w** angular velocity of the robot
## Demo
The MPC implementation is tested using **[bullet](https://pybullet.org/wordpress/)** physics simulator. Turtlebot model is from: *https://github.com/erwincoumans/pybullet_robots*.
![](img/Turtlebot.png)
Results:
![](img/demo.gif)
To run the pybullet demo:
```bash
python3 mpc_demo/mpc_demo_pybullet.py
```
To run the simulation-less demo:
```bash
python3 mpc_demo/mpc_demo_pybullet.py
```
## Requirements
```bash
pip3 install --user --requirement requirements.txt
```