Skip to main content

HILO-MPC is a toolbox for easy, flexible and fast development of machine-learning-supported optimal control and estimation problems

Project description

HILO-MPC

python Documentation Status tests

Language grade: Python doi Github license Github release

HILO-MPC is a Python toolbox for easy, flexible and fast realization of machine-learning-supported optimal control, and estimation problems developed mainly at the Control and Cyber-Physical Systems Laboratory, TU Darmstadt, and the Laboratory for Systems Theory and Control, Otto von Guericke University. It can be used for model predictive control, moving horizon estimation, Kalman filters, solving optimal control problems and has interfaces to embedded model predictive control tools.

HILO-MPC can interface directly to TensorFlow and PyTorch to create machine learning models and the CasADi framework to efficiently build control and estimation problems. The machine learning models can be used (almost) everywhere in the setup of these problems.

plot

Currently the following machine learning models are supported:

  • Feedforward neural networks
  • Gaussian processes

The following machine learning models are currently under development:

  • Bayesian neural network
  • Recurrent neural network

At the moment the following MPC and optimal control problems can be solved:

  • Reference tracking nonlinear MPC
  • Trajectory tracking nonlinear MPC
  • Path following nonlinear MPC
  • Economic nonlinear MPC
  • Linear MPC
  • Traditional optimal control problems

All the nonlinear MPCs support soft constraints, time-variant systems, time-varying parameters and can be used to solve minimum-time problems. They work for continuous-time and discrete-time models, in DAE or ODE form. Linear MPC is currently limited towards discrete-time models.

A rich set of examples is available, spanning:

  • NMPC for bioreactors using hybrid first principle and learned models
  • Trajectory tracking and path following model predictive control with learning and obstacle avoidance
  • Output feedback MPC of a continuous stirred tank reactor with a Gaussian process prediction model
  • Learning NMPC control using a neural network
  • Simple LQR, PID
  • Moving horizon estimation, extended Kalman filter, unscented Kalman filter, and particle filter for a continuous stirred tank reactor

Installation

You can use pip to install HILO-MPC as follows

pip install hilo-mpc

Additional Packages

If you want to make use of the complete functionality of the toolbox, you may want to install one of the following packages

Package Version Usage
TensorFlow >=2.3.0, <2.8.0 Training of neural networks
PyTorch >=1.2.0 Training of neural networks
scikit-learn >=0.19.2 Normalizing of training data
Bokeh >=2.3.0 Plotting
Matplotlib >=3.0.0 Plotting
pandas >=1.0.0 Providing data for training of neural networks

Documentation

A preliminary documentation can be found here. Note that this documentation is not complete and will be updated over time.

Citing HILO-MPC

If you use HILO-MPC for your research, please cite the following publication:

@misc{pohlodek2022hilompc,
    title = {Flexible development and evaluation of machine-learning-supported optimal control and estimation methods via {HILO-MPC}},
    author = {Pohlodek, Johannes and Morabito, Bruno and Schlauch, Christian and Zometa, Pablo and Findeisen, Rolf},
    publisher = {arXiv},
    year = {2022},
    doi = {10.48550/ARXIV.2203.13671}
}

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

HILO-MPC-1.0.0.tar.gz (207.9 kB view details)

Uploaded Source

Built Distribution

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

HILO_MPC-1.0.0-py3-none-any.whl (255.8 kB view details)

Uploaded Python 3

File details

Details for the file HILO-MPC-1.0.0.tar.gz.

File metadata

  • Download URL: HILO-MPC-1.0.0.tar.gz
  • Upload date:
  • Size: 207.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for HILO-MPC-1.0.0.tar.gz
Algorithm Hash digest
SHA256 2c4f9a7c4b0d984a4d19c6525d41f5ab782f01375efaf5295d2e917b1948375e
MD5 f6bf9f1f151b43b8bac74f4c033c082d
BLAKE2b-256 d8ecc9a8c4a06cd3568927d4ec4e27f54a187be1910bae4ccd61f4b4d46d08b8

See more details on using hashes here.

File details

Details for the file HILO_MPC-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: HILO_MPC-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 255.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for HILO_MPC-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f210258d3484c4b7dd74fd87f186f3b2e29ec84851b58086c151e4e081f7908f
MD5 12d3dc13cafdc1abda0ec7efa7c2d96b
BLAKE2b-256 b1a8855206692ffb2e31de2757cd8b39b2004be609bd3272d6912112ee7e8aaf

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