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 14 hours ago
JSON representation
Repository metadata
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 (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-13T11:02:38.000Z (5 months ago)
- Last Synced: 2025-04-13T06:03:56.636Z (14 days 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.6 MB
- Stars: 154
- Watchers: 10
- Forks: 56
- Open Issues: 4
- Releases: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
README.md
motulator: Motor Drive and Grid Converter Simulator in Python
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, please have a look at 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
- Name: Aalto Electric Drives
- Login: Aalto-Electric-Drives
- Email:
- Kind: organization
- Description:
- Website:
- Location: Finland
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/76838961?v=4
- Repositories: 1
- Last ynced at: 2023-03-04T00:23:22.865Z
- Profile URL: https://github.com/Aalto-Electric-Drives
GitHub Events
Total
- Create event: 2
- Release event: 1
- Issues event: 1
- Watch event: 25
- Issue comment event: 2
- Push event: 12
- Pull request event: 10
- Fork event: 12
Last Year
- Create event: 2
- Release event: 1
- Issues event: 1
- Watch event: 25
- Issue comment event: 2
- Push event: 12
- Pull request event: 10
- Fork event: 12
Committers metadata
Last synced: 5 days ago
Total Commits: 422
Total Committers: 14
Avg Commits per committer: 30.143
Development Distribution Score (DDS): 0.445
Commits in past year: 108
Committers in past year: 9
Avg Commits per committer in past year: 12.0
Development Distribution Score (DDS) in past year: 0.333
| Name | Commits | |
|---|---|---|
| Marko Hinkkanen | 7****n | 234 |
| mhinkkan | m****n@a****i | 63 |
| Joona | k****o@g****m | 55 |
| allcontributors[bot] | 4****] | 28 |
| lauritapio | l****n@a****i | 13 |
| Lauri Tiitinen | 8****o | 12 |
| saarela | t****a@g****m | 3 |
| JoonaKukkonen | 8****n | 3 |
| Juho Määttä | 1****1 | 3 |
| silundbe | s****e@k****e | 2 |
| Cosimo Bassi | 6****a | 2 |
| Francesco-Lelli | 1****i | 2 |
| HannuHar | 9****r | 1 |
| angelicaiaderosa | 1****a | 1 |
Committer domains:
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 11
Total pull requests: 183
Average time to close issues: 22 days
Average time to close pull requests: 2 days
Total issue authors: 8
Total pull request authors: 15
Average comments per issue: 2.0
Average comments per pull request: 0.5
Merged pull request: 153
Bot issues: 0
Bot pull requests: 33
Past year issues: 4
Past year pull requests: 74
Past year average time to close issues: N/A
Past year average time to close pull requests: about 13 hours
Past year issue authors: 2
Past year pull request authors: 6
Past year average comments per issue: 0.5
Past year average comments per pull request: 0.39
Past year merged pull request: 55
Past year bot issues: 0
Past year bot pull requests: 5
Top Issue Authors
- cusma (3)
- murgui (2)
- stabler (1)
- ax-anoop (1)
- amrudesh-santhanam (1)
- jrast (1)
- jmaravin (1)
- Jialed0303 (1)
Top Pull Request Authors
- mhinkkan (100)
- allcontributors[bot] (33)
- lauritapio (13)
- JoonaKukkonen (8)
- maattaj11 (6)
- cusma (4)
- MiSaren (4)
- saarela (3)
- Francesco-Lelli (3)
- Jialed0303 (3)
- silundbe (2)
- UshnishChowdhury (1)
- angelicaiaderosa (1)
- iam-nithin-10 (1)
- HannuHar (1)
Top Issue Labels
Top Pull Request Labels
Package metadata
- Total packages: 3
-
Total downloads:
- pypi: 844 last-month
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 47
- Total maintainers: 1
proxy.golang.org: github.com/aalto-electric-drives/motulator
- Homepage:
- Documentation: https://pkg.go.dev/github.com/aalto-electric-drives/motulator#section-documentation
- Licenses: mit
- Latest release: v0.6.0 (published 2 days ago)
- Last Synced: 2025-04-25T12:09:24.983Z (1 day ago)
- Versions: 13
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.6%
- Average: 5.787%
- Dependent repos count: 5.975%
proxy.golang.org: github.com/Aalto-Electric-Drives/motulator
- Homepage:
- Documentation: https://pkg.go.dev/github.com/Aalto-Electric-Drives/motulator#section-documentation
- Licenses: mit
- Latest release: v0.6.0 (published 2 days ago)
- Last Synced: 2025-04-25T12:09:29.864Z (1 day ago)
- Versions: 13
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.6%
- Average: 5.787%
- Dependent repos count: 5.975%
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 License
- Latest release: 0.6.0 (published 2 days ago)
- Last Synced: 2025-04-24T21:31:55.374Z (2 days ago)
- Versions: 21
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 844 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)
Dependencies
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/checkout v2 composite
- ad-m/github-push-action master composite
- ammaraskar/sphinx-action master composite
- Sphinx ==5.3.0
- matplotlib *
- numpy *
- numpydoc *
- scipy *
- sphinx-autoapi *
- sphinx-copybutton *
- sphinx-gallery *
- sphinx-rtd-theme *
- matplotlib *
- numpy *
- scipy *
- ipykernel * development
- pylint * development
- toml * development
- yapf * development
Score: 14.440988989999399