motulator: Motor Drive Simulator in Python

Introduction

This open-source software includes simulation models for an induction motor, a synchronous reluctance motor, and a permanent-magnet synchronous motor. The motor models are simulated in the continuous-time domain while the control algorithms run in discrete time. The default solver is the explicit Runge-Kutta method of order 5(4) from scipy.integrate.solve_ivp. Simple control algorithms are provided as examples. The documentation is available here:

https://aalto-electric-drives.github.io/motulator/

Installation

This software can be installed using pip:

pip install motulator

Alternatively, the repository can be cloned:

https://aalto-electric-drives.github.io/motulator/installation.html

Usage

The drive system, controller, reference sequences etc. are easy to configure. As a starting point, example scripts and Jupyter notebooks can be downloaded here:

https://aalto-electric-drives.github.io/motulator/auto_examples/index.html

New system models and controllers can be developed using the existing ones as templates.

Contributing

If you'd like to help us develop motulator, please have a look at these guidelines first.

Contributors

Thanks go to these wonderful people:

Lauri Tiitinen 💻 🤔 💡 🧑‍🏫	HannuHar 💻 🐛	Marko Hinkkanen 💻 🤔 💡	silundbe 💻 💡	JoonaKukkonen 💻 🚇	jarno-k 🤔	angelicaiaderosa 💻 💡
Luca Peretti 🤔 📣	GianmarioPellegrinoPolito 🔣	Simone Ferrari 🔣	Jialed0303 🤔	murgui 🐛	Nithin Valiyaveettil Sadanandan 🐛	saarela 🐛
Ushnish 🐛	Francesco-Lelli 💻 💡 🤔

This project follows the all-contributors specification. Contributions of any kind welcome!

Acknowledgement

This project has been sponsored by ABB Oy and by the Research Council of Finland Centre of Excellence in High-Speed Electromechanical Energy Conversion Systems. The example control methods included in this repository are based on published algorithms (available in textbooks and scientific articles). They do not present any proprietary control software.