OpenIPSL

A library of power system component models written in the Modelica language that can be used for power system dynamic analysis, such as phasor time-domain simulations.
https://github.com/openipsl/openipsl

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Keywords

energy energy-system energy-system-modeling gridcal hacktoberfest modelica power-grid power-grids power-system-dynamic-modeling power-system-dynamics power-system-simulation power-system-stability power-system-stabilizer power-systems power-systems-analysis smart-grids

Keywords from Contributors

modelica-library powersystems modeling-and-simulation modelica-models model-transformations openipsl-modelica-model openipsl powergrid powergrid-simulation powersystem-simulation

Last synced: about 4 hours ago
JSON representation

Repository metadata

A library of power system component models written in the Modelica language that can be used for power system dynamic analysis, such as phasor time-domain simulations.

Host: GitHub
URL: https://github.com/openipsl/openipsl
Owner: OpenIPSL
License: bsd-3-clause
Fork: true (itesla/ipsl)
Created: 2016-04-16T09:09:47.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2025-04-07T15:50:56.000Z (20 days ago)
Last Synced: 2025-04-17T09:56:42.790Z (10 days ago)
Topics: energy, energy-system, energy-system-modeling, gridcal, hacktoberfest, modelica, power-grid, power-grids, power-system-dynamic-modeling, power-system-dynamics, power-system-simulation, power-system-stability, power-system-stabilizer, power-systems, power-systems-analysis, smart-grids
Language: Modelica
Homepage: https://doc.openipsl.org/
Size: 57 MB
Stars: 89
Watchers: 20
Forks: 55
Open Issues: 19
Releases: 15
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Citation: CITATION.cff

README.md

OpenIPSL: Open-Instance Power System Library

The OpenIPSL or Open-Instance Power System Library is a library of power system component models written in the Modelica language that can be used for power system dynamic analysis, such as phasor time-domain simulations.

The OpenIPSL is currently developed and maintained by Prof. Luigi Vanfretti's research group ALSETLab at Rensselaer Polytechnic Institute, Troy, NY, collaborators and friends, such as Dietmar Winkler.

Scope

The OpenIPSL is developed to be used for research and education (therefore frequent release times may be available), with maximum compatibility with OpenModelica (to provide a free/libre and cost-free alternative for power system dynamic simulation), to provide as many as possible typical "test networks" for use in research and teaching, and to be developed in such way that the library can efficiently be used for power system simulation within Modelica-based workflows (i.e., helping to give reference power system models for development and testing of Modelica back-end compilers) when faced with power system simulation challenges.

Please note that the library contains only the models that can be used for dynamic studies. As such, there are no solver tools provided in this repository (no Power Flow Solvers, no Time-Domain solvers, etc.).
The user should use a Modelica-compliant tool for simulation of models in this lirbary.

History

The iPSL is a Modelica library developed during the iTesla project.
The members of this project (OpenIPSL) at SmarTS Lab (now ALSETLab) where key developers of the iPSL until March 31, 2016, when the iTesla project was completed.
Prof. Luigi Vanfretti lead the development of a large amount of the models of the library (particularly those that replicate results from PSAT and PSS/E).
iPSL is part of the iTesla Tool, and thus, it is subject to the needs of the consortium that develops the iTesla Tool.
Therefore, the SmarTS Lab / ALSETLab team decided to create the OpenIPSL fork in order to develop the library in a direction that is more suitable for researchers and teachers/professors, and in a transparent, open source software approach.

Documentation

Documentation is provided within the library and can be accessed when loading OpenIPSL in any Modelica-compliant tool. Tutorials on OpenIPSL have been given at many conferences, and are available under Release. We recommend you start from there.

Our documentation assumes that you have working knowledge of the Modelica language, are familiar with a Modelica-compliant modeling and simulation environment, that you have proeficient knowledge on power system steady state analysis (i.e., the so called "power flow"), and knowledge on power system dynamic modeling (i.e., the called "transient" and "small-signal" stability). As such, the documentation is limited, and aims to provide very consice information for people who fulfill the requirements above. If you do not fulfill these requirements, we recommend that you first get acquainted with both Modelica and Power Systems.

Citing OpenIPSL in Publications

If you use OpenIPSL in your work or research, all we ask you in exchange is that you cite the reference publications, according to your use. Please consult our publication list, located within the User's Guide package, in the Publications page, for browsing the reference publications. Preferrably, please cite this repository by using our preferred reference, as seen on GitHub GUI.

You are also welcome to submit your contributions as stated below.

Contributing

Contributions to the library are welcome and can be submitted in the form of pull requests to this repository. Please consult the contribution guidelines for more information on how to contribute to the development of this library. Information about our current and past contributors can be found when the library is loaded into a Modelica-compliant software. The information is located within the Users' Guide package, in the Contact page.

If you want to submit your contributions to the OpenIPSL, note that we make use of an automated assistant for dealing with Contributor's License Agreements (CLAs). Please read the CLA intructions beforehand. If you have any questions, please don't hesitate to contact us.

Copyright and License Information

OpenIPSL: Copyright April 2016 - current Luigi Vanfretti, ALSETLab, Troy, NY (Formely SmarTS Lab, Stockholm, Sweden).

The authors can be contacted by email: [email protected].

This Source Code Form is subject to the terms of the 3-Clause BSD license.

Acknowledgements

This work was supported primarily by the following grants and institutions, in reverse chronological order:

2020-2024: supported in part by the U.S. Department of Energy’s Office of Energy Efficiency and Renewable Energy (EERE) under the Advanced Manufacturing Office, Award Number DE-EE0009139.
2018-2023: Dominion Energy Virginia through sponsored research projects: (2018-2019) Flexible Alternating Current Transmission System Modeling and Performance Analysis using Measurement Data, (2020-2021) Model Validation of Generator Power Plants, and (2021-2022) Cloud-Based Integrated Model-and-Measurement Analytics for Power System Applications, at Rensselaer Polytechnic Institute.
2019-2021: New York State Energy Research and Development Authority (NYSERDA) through the Electric Power Transmission and Distribution (EPTD) PON 3770 High Performing Grid Program together with the New York Power Authority (NYPA).
2018-2020: This work was also supported in part by the ERC Program of the National Science Foundation and DOE under NSF Award Number EEC-1041877 and in part by the CURENT Industry Partnership Program.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- name: "OpenIPSL"
title: "OpenIPSL: an Open-Instance Power System Library"
version: 2.0.0
url: "https://github.com/OpenIPSL/OpenIPSL"
preferred-citation:
  type: article
  authors:
  - family-names: "de Castro"
    given-names: "Marcelo"
  - family-names: "Winkler"
    given-names: "Dietmar"
  - family-names: "Laera"
    given-names: "Giuseppe"
  - family-names: "Vanfretti"
    given-names: "Luigi"
  - family-names: "Dorado-Rojas"
    given-names: "Sergio A."
  - family-names: "Rabuzin"
    given-names: "Tin"
  - family-names: "Mukherjee"
    given-names: "Biswarup"
  - family-names: "Navarro"
    given-names: "Manuel"
  doi: "https://doi.org/10.1016/j.softx.2022.101277"
  journal: "SoftwareX"
  start:  # First page number
  end:  # Last page number
  title: "Version [OpenIPSL 2.0.0] - [iTesla Power Systems Library (iPSL): A Modelica library for phasor time-domain simulations],"
  issn: "2352-7110" 
  volume: 21
  year: 2023
  url: "https://www.sciencedirect.com/science/article/pii/S2352711022001959"

Owner metadata

Name: OpenIPSL
Login: OpenIPSL
Email: [email protected]
Kind: organization
Description: An team of collaborators developing the OpenIPSL Modelica library for power system simulations and other related oss projects in power system modeling and sim.
Website: http://openipsl.org
Location: Cyber Space and All Around the World!
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/29949865?v=4
Repositories: 1
Last ynced at: 2023-03-05T11:08:53.478Z
Profile URL: https://github.com/OpenIPSL

GitHub Events

Total

Issues event: 18
Watch event: 10
Delete event: 1
Issue comment event: 80
Push event: 16
Pull request review comment event: 21
Pull request review event: 24
Pull request event: 19
Fork event: 7
Create event: 1

Last Year

Issues event: 18
Watch event: 10
Delete event: 1
Issue comment event: 80
Push event: 16
Pull request review comment event: 21
Pull request review event: 24
Pull request event: 19
Fork event: 7
Create event: 1

Committers metadata

Last synced: 5 days ago

Total Commits: 1,549
Total Committers: 33
Avg Commits per committer: 46.939
Development Distribution Score (DDS): 0.644

Commits in past year: 75
Committers in past year: 9
Avg Commits per committer in past year: 8.333
Development Distribution Score (DDS) in past year: 0.28

Name	Email	Commits
Dietmar Winkler	d**r@d**o	551
marcelofcastro	d**3@r**u	258
Tin Rabuzin	r**n@k**e	195
Maxime Baudette	b**e@k**e	195
maguilerac	m**1@g**m	96
Marcelo de Castro Fernandes	m**s@M**l	50
Luigi Vanfretti	l**i@g**m	47
Jan Lavenius	j**v@k**e	36
Fernando Fachini	6****f	25
Aplicaciones en Informática Avanzada	m**a@a**s	15
marcelofcastro	m**o@M**l	12
Tin Rabuzin	t**n@g**m	8
GiuseppeLaera	g**a@g**m	7
ManuelNvro	m**o@g**m	7
ceraolo	m**o@u**t	6
marcelofcastro	m**o@r**u	6
tbeu	t****u	5
Glen Halley	3****y	5
biswarupm	p**7@g**m	4
Tin Rabuzin	t**r@n**o	3
Mohammed Ahsan Adib Murad	m**d@k**e	2
IPSL Admin	i**l@r**m	2
Sergio A. Dorado-Rojas	s**s@g**m	2
Francisco Gómez	f**o@h**m	2
Krokkodilli	k**i@h**m	2
Sergio A. Dorado-Rojas	s**o@o**e	1
SmarTSLab-Bot	s**t@g**m	1
Maxime Baudette	b**e@U**E	1
Pierre Haessig	p**g@c**g	1
Malte Lenz	m**z@g**m	1
and 3 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 126
Total pull requests: 239
Average time to close issues: about 1 year
Average time to close pull requests: about 1 month
Total issue authors: 23
Total pull request authors: 23
Average comments per issue: 3.81
Average comments per pull request: 2.33
Merged pull request: 202
Bot issues: 0
Bot pull requests: 0

Past year issues: 13
Past year pull requests: 13
Past year average time to close issues: 6 days
Past year average time to close pull requests: 11 days
Past year issue authors: 7
Past year pull request authors: 8
Past year average comments per issue: 1.92
Past year average comments per pull request: 3.46
Past year merged pull request: 9
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/openipsl/openipsl

Top Issue Authors

dietmarw (38)
MaximeBaudette (19)
lvanfretti (14)
tinrabuzin (12)
maltelenz (11)
marcelofcastro (6)
janlav (3)
dgusain1 (3)
gkhalley (2)
qlambert-pro (2)
maguilerac (2)
sorrento (2)
syedyasserali (2)
junjie-zh (1)
meliaa4 (1)

Top Pull Request Authors

dietmarw (71)
tinrabuzin (38)
MaximeBaudette (37)
lvanfretti (28)
marcelofcastro (12)
janlav (9)
fachif (7)
tbeu (7)
gkhalley (5)
maguilerac (4)
ManuelNvro (3)
fran-jo (3)
Krokkodilli (2)
GiuseppeLaera (2)
sergio-dorado (2)

Top Issue Labels

enhancement (31)
bug (29)
OMrelated (10)
question (8)
DOC (8)
systemmodeler (7)
Cleanup (5)
Tool specific (5)
CI (5)
tool-issue (4)
PSAT (4)
task (3)
help wanted (3)
WorksForMe (3)
duplicate (2)
conversion (2)
invalid (2)
wontfix (2)
specifiation-compliance (2)
PSSE (2)
v3.0.0 (1)
BLOCKER (1)
PR Rulez (1)

Top Pull Request Labels

enhancement (41)
bug (22)
Cleanup (22)
DOC (15)
hacktoberfest-accepted (13)
specifiation-compliance (5)
OMrelated (5)
CI (4)
task (3)
invalid (2)
octcompliance (1)
v3.0.0 (1)
help wanted (1)
PSSE (1)
Tool specific (1)

Dependencies

.github/workflows/checkCI.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/checkCron.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/cla.yml actions

cla-assistant/github-action v2.2.1 composite

.CI/old-travis/Dockerfile docker

phusion/baseimage focal-1.0.0-alpha1-amd64 build

Score: 8.1786387885907

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology