Skip to main content

Python implementation of various advanced MPC algorithms

Project description

AMPyC

GitHub | PyPI | Issues | Changelog

ampyc -- Advanced Model Predictive Control in Python

General Python package for control theory research, including some reference implementations of various advanced model predictive control (MPC) algorithms.

Features:

  • Implements dynamical systems and control interfaces to allow seamless interactions
  • Provides abstract base classes to allow custom implementation of any type of dynamical system and controller
  • Reference implementations of many advanced MPC algorithms; for a full list of implemented algorithms see below
  • Global parameter management for easy experiment setup and management
  • Various utility tools for set computations, polytope manipulation, and plotting
  • Lecture-style notes and notebook tutorials explaining advanced predictive control concepts

Installation

ampyc requires Python 3.10 or higher. Just use pip for Python 3 to install ampyc and its dependencies:

    python3 -m pip install ampyc

Local (editable) installation

  1. Clone this repository using
    git clone git@github.com:IntelligentControlSystems/ampyc.git
  1. Install all dependencies (preferably in a virtual environment) using
    python3 -m pip install -r requirements.txt
  1. Install ampyc in editable mode for development. Navigate to this top-level folder and run
    pip install -e .

Getting Started

To get started with the ampyc package, run the tutorial notebook, which provides an introduction to all parts of the package.

For specific control algorithms implemented in ampyc, run the associated notebook in the notebook folder.

Implemented Control Algorithms

Year Authors Method/Paper AMPyC
- - Linear Model Predictive Control code
- - Nonlinear Model Predictive Control code
2001 Chisci et al. Systems with persistent disturbances: predictive control with restricted constraints code
2005 Mayne et al. Robust model predictive control of constrained linear systems with bounded disturbances code
2013 Bayer et al. Discrete-time incremental ISS: A framework for robust NMPC code
2017 Lorenzen et al. Constraint-Tightening and Stability in Stochastic Model Predictive Control code
2018 Hewing & Zeilinger Stochastic Model Predictive Control for Linear Systems Using Probabilistic Reachable Sets code
2020 Hewing et al. Recursively feasible stochastic model predictive control using indirect feedback code

Cite this Package & Developers

If you find this package/repository helpful, please cite our work:

@software{ampyc,
  title  = {AMPyC: Advanced Model Predictive Control in Python},
  author = {Sieber, Jerome and Didier, Alexandre and Rickenbach, Rahel and Zeilinger, Melanie},
  url    = {https://github.com/IntelligentControlSystems/ampyc},
  month  = jun,
  year   = {2025}
}

Principal Developers

  Jerome Sieber     |   Alex Didier     |   Mike Zhang     |   Rahel Rickenbach  

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ampyc-0.0.2.tar.gz (48.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ampyc-0.0.2-py3-none-any.whl (58.7 kB view details)

Uploaded Python 3

File details

Details for the file ampyc-0.0.2.tar.gz.

File metadata

  • Download URL: ampyc-0.0.2.tar.gz
  • Upload date:
  • Size: 48.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.18

File hashes

Hashes for ampyc-0.0.2.tar.gz
Algorithm Hash digest
SHA256 53501010b8a8365991b7b6bfcda2bf00a93a844efdba8fd8ef674814c4e15411
MD5 a9476d562d4818c4c6454ea1223fa937
BLAKE2b-256 c5ec12b5908d6c0962543d7031114bb022107b3fe5a272dbeca9cb6b60997510

See more details on using hashes here.

File details

Details for the file ampyc-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: ampyc-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 58.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.18

File hashes

Hashes for ampyc-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1ab67a60a56fc20f793e2be28697fbfd4b929f9da83a44c5c5dde093ab7fe14c
MD5 359c7af4619a39fa0283d2f5e5e6273f
BLAKE2b-256 c1c89d1283d4e3ea3201ad90f0849131824a25970ed6af1ef8f9a571bb9b4a4b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page