motulator

Motor Drive and Grid Converter Simulator in Python

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

Science Score: 59.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 1 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    1 of 14 committers (7.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (18.6%) to scientific vocabulary

Keywords

control-systems converters electric-drives electric-machines electrical-engineering grid-connected induction-motors inverters power-electronics python simulations synchronous-motors
Last synced: 5 months ago · JSON representation

Repository

Motor Drive and Grid Converter Simulator in Python

Basic Info
Statistics
  • Stars: 181
  • Watchers: 13
  • Forks: 60
  • Open Issues: 4
  • Releases: 17
Topics
control-systems converters electric-drives electric-machines electrical-engineering grid-connected induction-motors inverters power-electronics python simulations synchronous-motors
Created over 4 years ago · Last pushed 6 months ago
Metadata Files
Readme License

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:

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

Contributors

Thanks go to these wonderful people:

Lauri Tiitinen
Lauri Tiitinen

💻 🤔 💡 🧑‍🏫
HannuHar
HannuHar

💻 🐛
Marko Hinkkanen
Marko Hinkkanen

💻 🤔 💡 🧑‍🏫
silundbe
silundbe

💻 💡
JoonaKukkonen
JoonaKukkonen

💻 🚇
jarno-k
jarno-k

🤔 👀 🧑‍🏫
angelicaiaderosa
angelicaiaderosa

💻 💡
Luca Peretti
Luca Peretti

🤔 📣
GianmarioPellegrinoPolito
GianmarioPellegrinoPolito

🔣
Simone Ferrari
Simone Ferrari

🔣
Jialed0303
Jialed0303

🤔
murgui
murgui

🐛
Nithin Valiyaveettil Sadanandan
Nithin Valiyaveettil Sadanandan

🐛
saarela
saarela

🐛
Ushnish
Ushnish

🐛
Francesco-Lelli
Francesco-Lelli

💻 💡 🤔
Mikko Sarén
Mikko Sarén

💻 💡 🤔
Juho Määttä
Juho Määttä

💻 💡 🤔
rayanmour
rayanmour

💻 💡 🤔 👀 🧑‍🏫
Cosimo Bassi
Cosimo Bassi

🚇

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

  • Name: Aalto Electric Drives
  • Login: Aalto-Electric-Drives
  • Kind: organization
  • Location: Finland

GitHub Events

Total
  • Create event: 6
  • Release event: 5
  • Issues event: 1
  • Watch event: 36
  • Issue comment event: 2
  • Push event: 36
  • Pull request event: 29
  • Fork event: 14
Last Year
  • Create event: 6
  • Release event: 5
  • Issues event: 1
  • Watch event: 36
  • Issue comment event: 2
  • Push event: 36
  • Pull request event: 29
  • Fork event: 14

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 445
  • Total Committers: 14
  • Avg Commits per committer: 31.786
  • Development Distribution Score (DDS): 0.422
Past Year
  • Commits: 28
  • Committers: 2
  • Avg Commits per committer: 14.0
  • Development Distribution Score (DDS): 0.036
Top Committers
Name Email Commits
Marko Hinkkanen 7****n@u****m 257
mhinkkan m****n@a****i 63
Joona k****o@g****m 55
allcontributors[bot] 4****]@u****m 28
lauritapio l****n@a****i 13
Lauri Tiitinen 8****o@u****m 12
JoonaKukkonen 8****n@u****m 3
Juho Määttä 1****1@u****m 3
saarela t****a@g****m 3
Cosimo Bassi 6****a@u****m 2
Francesco-Lelli 1****i@u****m 2
silundbe s****e@k****e 2
HannuHar 9****r@u****m 1
angelicaiaderosa 1****a@u****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 9
  • Total pull requests: 237
  • Average time to close issues: 27 days
  • Average time to close pull requests: 1 day
  • Total issue authors: 7
  • Total pull request authors: 15
  • Average comments per issue: 1.89
  • Average comments per pull request: 0.35
  • Merged pull requests: 198
  • Bot issues: 0
  • Bot pull requests: 41
Past Year
  • Issues: 3
  • Pull requests: 38
  • Average time to close issues: N/A
  • Average time to close pull requests: 38 minutes
  • Issue authors: 2
  • Pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.03
  • Merged pull requests: 37
  • Bot issues: 0
  • Bot pull requests: 2
Top Authors
Issue Authors
  • cusma (3)
  • ax-anoop (1)
  • amrudesh-santhanam (1)
  • jrast (1)
  • murgui (1)
  • jmaravin (1)
  • Jialed0303 (1)
Pull Request Authors
  • mhinkkan (141)
  • allcontributors[bot] (41)
  • lauritapio (14)
  • maattaj11 (8)
  • JoonaKukkonen (8)
  • cusma (5)
  • Francesco-Lelli (4)
  • MiSaren (3)
  • saarela (3)
  • Jialed0303 (3)
  • UshnishChowdhury (2)
  • silundbe (2)
  • angelicaiaderosa (1)
  • iam-nithin-10 (1)
  • HannuHar (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 643 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 0
    (may contain duplicates)
  • Total versions: 62
  • Total maintainers: 1
proxy.golang.org: github.com/aalto-electric-drives/motulator
  • Versions: 18
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.6%
Average: 5.8%
Dependent repos count: 6.0%
Last synced: 6 months ago
proxy.golang.org: github.com/Aalto-Electric-Drives/motulator
  • Versions: 18
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.6%
Average: 5.8%
Dependent repos count: 6.0%
Last synced: 6 months ago
pypi.org: motulator

Motor Drive and Grid Converter Simulator in Python

  • Versions: 26
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 643 Last month
Rankings
Dependent packages count: 6.6%
Forks count: 7.1%
Stargazers count: 7.7%
Average: 14.7%
Downloads: 21.3%
Dependent repos count: 30.6%
Maintainers (1)
Last synced: 6 months ago

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
docs/requirements.txt pypi
  • Sphinx ==5.3.0
  • matplotlib *
  • numpy *
  • numpydoc *
  • scipy *
  • sphinx-autoapi *
  • sphinx-copybutton *
  • sphinx-gallery *
  • sphinx-rtd-theme *
requirements.txt pypi
  • matplotlib *
  • numpy *
  • scipy *
pyproject.toml pypi
requirements-dev.txt pypi
  • ipykernel * development
  • pylint * development
  • toml * development
  • yapf * development