Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

motulator

Simulation models for an induction motor, a synchronous reluctance motor, and a permanent-magnet synchronous motor.
https://github.com/aalto-electric-drives/motulator

Category: Consumption
Sub Category: Mobility and Transportation

Keywords

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

Keywords from Contributors

machine control electric inverter motor power

Last synced: about 18 hours ago
JSON representation

Repository metadata

Motor Drive and Grid Converter Simulator in Python

README.md

motulator: Motor Drive and Grid Converter Simulator in Python

DOI
Build Status
License
PyPI version shields.io
All 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:

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, see these guidelines first.

Contributors

Thanks go to these wonderful people:

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.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 13 days ago

Total Commits: 467
Total Committers: 13
Avg Commits per committer: 35.923
Development Distribution Score (DDS): 0.285

Commits in past year: 23
Committers in past year: 5
Avg Commits per committer in past year: 4.6
Development Distribution Score (DDS) in past year: 0.348

Name Email Commits
Marko Hinkkanen 7****n 334
Joona k****o@g****m 58
allcontributors[bot] 4****] 30
lauritapio l****n@a****i 25
Juho Määttä 1****1 5
saarela t****a@g****m 3
silundbe s****e@k****e 2
Mikko Sarén 1****n 2
Junyi Li 1****r 2
Francesco-Lelli 1****i 2
Cosimo Bassi 6****a 2
angelicaiaderosa 1****a 1
HannuHar 9****r 1

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 9
Total pull requests: 257
Average time to close issues: 27 days
Average time to close pull requests: 1 day
Total issue authors: 7
Total pull request authors: 16
Average comments per issue: 1.89
Average comments per pull request: 0.33
Merged pull request: 217
Bot issues: 0
Bot pull requests: 43

Past year issues: 0
Past year pull requests: 22
Past year average time to close issues: N/A
Past year average time to close pull requests: about 14 hours
Past year issue authors: 0
Past year pull request authors: 5
Past year average comments per issue: 0
Past year average comments per pull request: 0.18
Past year merged pull request: 21
Past year bot issues: 0
Past year bot pull requests: 2

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/aalto-electric-drives/motulator

Top Issue Authors

  • cusma (3)
  • ax-anoop (1)
  • amrudesh-santhanam (1)
  • jrast (1)
  • murgui (1)
  • jmaravin (1)
  • Jialed0303 (1)

Top Pull Request Authors

  • mhinkkan (152)
  • allcontributors[bot] (43)
  • lauritapio (14)
  • maattaj11 (10)
  • JoonaKukkonen (8)
  • cusma (5)
  • MiSaren (5)
  • Francesco-Lelli (4)
  • Exiaolibur (3)
  • saarela (3)
  • Jialed0303 (3)
  • UshnishChowdhury (2)
  • silundbe (2)
  • angelicaiaderosa (1)
  • iam-nithin-10 (1)

Top Issue Labels

Top Pull Request Labels

Package metadata

proxy.golang.org: github.com/Aalto-Electric-Drives/motulator

proxy.golang.org: github.com/aalto-electric-drives/motulator

pypi.org: motulator

Motor Drive and Grid Converter Simulator in Python

  • Homepage: https://github.com/Aalto-Electric-Drives/motulator
  • Documentation: https://Aalto-Electric-Drives.github.io/motulator/
  • Licenses: MIT
  • Latest release: 0.7.5 (published about 1 month ago)
  • Last Synced: 2026-09-01T02:14:55.122Z (2 days ago)
  • Versions: 29
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 429 Last month
  • Rankings:
    • Dependent packages count: 6.633%
    • Forks count: 7.127%
    • Stargazers count: 7.676%
    • Average: 14.677%
    • Downloads: 21.337%
    • Dependent repos count: 30.611%
  • Maintainers (1)
guix: python-motulator

Motor Drive Simulator in Python

Dependencies

.github/workflows/python-publish.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/update_gh-pages.yml actions
  • actions/checkout v2 composite
  • ad-m/github-push-action master composite
  • ammaraskar/sphinx-action master composite
pyproject.toml pypi
  • matplotlib *
  • numpy *
  • scipy *
  • torch *
  • tqdm *
.github/workflows/pre-commit.yml actions
  • actions/checkout v4 composite
  • pre-commit/action v3.0.1 composite
.github/workflows/pull_request.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • actions/upload-artifact v4 composite

Score: 14.06681387507234