https://github.com/Aalto-Electric-Drives/motulator

Motor Drive and Grid Converter Simulator in Python
https://github.com/Aalto-Electric-Drives/motulator

control-systems converters electric-drives electric-machines electrical-engineering grid-connected induction-motors inverters power-electronics python simulations synchronous-motors

Last synced: 3 months ago
JSON representation

Motor Drive and Grid Converter Simulator in Python

• Host: GitHub
• URL: https://github.com/Aalto-Electric-Drives/motulator
• Owner: Aalto-Electric-Drives
• License: mit
• Created: 2021-06-16T06:50:03.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-24T05:20:19.000Z (4 months ago)
• Last Synced: 2024-11-13T02:36:09.139Z (3 months ago)
• Topics: control-systems, converters, electric-drives, electric-machines, electrical-engineering, grid-connected, induction-motors, inverters, power-electronics, python, simulations, synchronous-motors
• Language: Python
• Homepage: https://aalto-electric-drives.github.io/motulator/
• Size: 68.5 MB
• Stars: 139
• Watchers: 11
• Forks: 53
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-open-source-power-electronics - motulator - source motor drive simulator in Python. It contains models for induction machines, synchronous reluctance machines, and permanent-magnet synchronous machines as well as various control methods as examples. | <ul> <li> <a href="https://aalto-electric-drives.github.io/motulator/">Documentation</a></li> <li><a href="https://aalto-electric-drives.github.io/motulator/auto_examples/index.html">Examples</a></li></ul> |  | (Circuit Simulation and Calculation)

README

        
# *motulator:* Motor Drive and Grid Converter Simulator in Python

[![DOI](https://zenodo.org/badge/377399301.svg)](https://zenodo.org/doi/10.5281/zenodo.10223090)

[![Build Status](https://github.com/Aalto-Electric-Drives/motulator/actions/workflows/update_gh-pages.yml/badge.svg)](https://github.com/Aalto-Electric-Drives/motulator/actions/workflows/update_gh-pages.yml)

[![License](https://img.shields.io/github/license/mashape/apistatus)](https://github.com/Aalto-Electric-Drives/motulator/blob/main/LICENSE)

[![PyPI version shields.io](https://img.shields.io/pypi/v/motulator.svg)](https://pypi.org/project/motulator/)

[![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-)

Introduction

------------

This open-source software includes simulation models and controllers for electric machine drives and grid converter systems. The machine models include an induction machine, a synchronous reluctance machine, and a permanent-magnet synchronous machine. Various subsystem models are provided for modeling grid converter systems, such as an LCL filter connected to an inductive-resistive grid.

The system 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. Various 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:

```bash

pip install motulator

```

Alternatively, the repository can be cloned:

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

Usage

-----

The system models, controllers, 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/drive_examples/index.html

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

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

Contributing

------------

If you would like to help us develop motulator, please have a look at these [guidelines](https://aalto-electric-drives.github.io/motulator/contributing.html) 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
💻 💡 🤔

      
Mikko Sarén
💻 💡 🤔

      
Juho Määttä
💻 💡 🤔

      
rayanmour
💻 💡 🤔 👀 🧑‍🏫

      
Cosimo Bassi
🚇

    

  

This project follows the [all-contributors](https://github.com/all-contributors/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.