OpenIPSL.UsersGuide

The Open-Instance Power System Library - OpenIPSL contains many power system component models written in Modelica language that can be used for power system dynamic analysis, such as phasor time-domain simulations.

This is a very short User's Guide that will try to help users to get familiar with the library providing general information about the OpenIPSL.

More information about the library can be found on this openipsl.org dedicated to the OpenIPSL organization.

Extends from Modelica.Icons.Information (Icon for general information packages).

Package Content

Name	Description
Overview	Overview
Conventions	Conventions
GettingStarted	Getting Started
Testing	Testing and Verification
Publications	Publications
References	References
ReleaseNotes	Release notes
Contact	Contact

OpenIPSL.UsersGuide.Overview

The OpenIPSL has, basically, six packages: Examples, Electrical, Nonelectrical, Interfaces, Icons and Types. They are briefly described below:

Examples package for demonstration of power system examples that can be assembled using the library.
Electrical: contains many different models that represent devices that form the grid or that are part of equipment which is connected to the grid. A more detailed overview is presented below.
NonElectrical: contains elementary blocks that can be used to model a specific dynamic behavior (a lead-lag transfer function, for example). It also contains functions that are called inside models.
Interfaces: contains the connector interface and the generator mask. The connector is present in every model that is connected to the grid.
Icons: contains the basic icons that are used and extended throughout the library.
Types: contains a description of the units that are used in the library and an expected order of magnitude. This information can be used to scale differential equations and enhance code generation performance.
Tests package for small test systems which show basic behavior of some of the many components of this library.

The Electrical package has many other subpackages that are briefly described here. It also contains one model, SystemBase, which is going to be explained later in Getting Started. Within each subpackage, the user will find models grouped into software tools from which each model design was extracted.

Subpackage	Description
Controls	Models that represent controllers used in machines. Exciters, stabilizers and governors for example.
Banks	Models that represent shunt devices that compensate reactive power.
Branches	Models that represent devices that connect two or more buses. Transformers and power lines are perfect examples.
Buses	Models that represent nodes of a circuit.
Events	Models that can be used for the representation of events in a power system. Examples are faults and breakers.
FACTS	Models that represent devices used in the Flexible AC Transmission System paradigm.
Loads	Models that represent various types of loads in a power system.
Machines	Models that represent the rotating electrical machines connected to a power system such as generators and motors.
Sensors	Models that can represent sensors used in a real power system.
Solar	Models that represent photovoltaic solar cells and their interface to the grid.
ThreePhase	Models that can represent three-phase grids. More information can be found in the package's documentation.
Wind	Models that represent wind generators and their controls.
Essentials	Contains the `pfComponent` model that is extended for purposes of initialization with power flow results.

Extends from Modelica.Icons.Information (Icon for general information packages).

OpenIPSL.UsersGuide.Conventions

The team behind OpenIPSL strives to achieve a harmonized development of the library to facilitate its usability and integration into other services.

Here are some naming conventions that we try to obey:

Names of the parameters and variables should correspond to those found in the respective documentation.
Subscript should be denoted in Modelica with underscore, e.g., T_r or K_1. Note: some parameter names have first upper case letters and others lower case.
Deviation signals such as δω, should be written as domega in Modelica.
Parameters which are not to be entered by user and variables which are not to be seen by users should be protected.
Parameters and variables should be declared as their specific type such as Types.ApparentPower for variables that are declared in MVA. Note: if the proper unit is not represented in Types, units available in Modelica's SI (Systeme Internationale) should be used.

Extends from Modelica.Icons.Information (Icon for general information packages).

OpenIPSL.UsersGuide.GettingStarted

The OpenIPSL was developed to be a familiar alternative to traditional power system analysis tools. There are, however, some particularities to the nature of the library, presented in this Section.

Power flow and Initialization

All models in a Modelica library require initial guess values that should come from a solution of the steady state of the overall model. This initial guess is called power flow. However, there is no power flow solver associated to the library as of the present time. When building a use case, initialization of all variables must be performed with a power flow software. The users are free to choose their power flow software of choice.

Almost all of our models have been developed to provide the same response than a reference power system simulation tool, e.g., PSAT and PSS®E. You can use these tools to create a power flow solution for your network. If you do not have access to these tools or do not want to use them, there are several power flow solvers available on GitHub. Examples on how to generate Modelica records from open source and proprietary power flow solvers, specifically GridCal and PSS®E can be found in this paper and in this GitHub repository.

From these values, a Modelica tool solves the initialization problem for all algebraic and differential - state variables. All models in OpenIPSL are programmed in such way that by introducing a power flow solution (from another tool), the initial guesses are computed as parameters within each model and are provided into the initial equations that are used as an initial guess to solve the overall initialization problem. See this paper for a more detailed explanation.

As we have just mentioned, the full initialization of the components' internal variables and states is achieved by a set of internal initial equations that are to be derived by the developer of the model. In a effort to harmonized the presentation of the power flow parameters, a model should extend pfComponent that will provide all the necessary parameters for data coming from power flow solutions to be used in the initialization of the model. The pfComponent also provide the support for the common SystemBase component that provides a single instance of the system's common parameters, i.e., frequency and base power.

Running Time Domain Simulations

The time domain simulations are prepared to work with Modelica-compliant tools. Users of the OpenIPSL are free to choose their tool of choice. However, note that the development of OpenIPSL has been carried out using OpenModelica, Dymola, Modelon Impact and Wolfram SystemModeler. The library is, also, systematically checked using the two mentioned tools (see Library Testing). Nonetheless, it might be possible to face issues when using other Modelica Tools that we have not fully tested.

Extends from Modelica.Icons.Information (Icon for general information packages).

OpenIPSL.UsersGuide.Testing

Continuous Integration

The OpenIPSL repository uses GitHub Actions for Continuous Integration services to the repository. In the current implementation, Modelica syntax and HTML documentation checking for all classes in the OpenIPSL is implemented

Regression Testing

These tests are used to ensure the validation status of models that are based on PSSE implementations. The models undergo simulations with different events such as faults, reference changes and load variations. The main idea is to try to capture different responses from the model being verified. If a model has a very small error if compared to PSSE base result for that simulation, it passes a test. A model is considered to be verified if it passes all tests. Models that pass the verification procedure have a green dashed line around them.

The regression testing is done separately in different Modelica-compliant tools (OpenModelica and Dymola, for now) so models can be independently verified. A detailed view of all models that undergo the verification process can be found in the NYPA Model Transformation reports. The entire result verification procedure is done using CSV-Compare.

Automatic regression testing is not yet configured in our Travis CI routine.

Extends from Modelica.Icons.Information (Icon for general information packages).

OpenIPSL.UsersGuide.Publications

The list of publications written about OpenIPSL library and its models can be found below.

If you use OpenIPSL in your work or research, we kindly ask you to cite (preferably), our SoftwareX paper:

M. Baudette, M. Castro, T. Rabuzin, J. Lavenius, T. Bogodorova, L. Vanfretti, OpenIPSL: Open-Instance Power System Library — Update 1.5 to "iTesla Power Systems Library (iPSL): A Modelica library for phasor time-domain simulations", SoftwareX, Volume 7, January–June 2018, Pages 34-36, ISSN 2352-7110, DOI: 10.1016/j.softx.2018.01.002.

Otherwise, you cite one of the following papers, according to a specific use of OpenIPSL:

S. Boersma, X. Bombois, L. Vanfretti, J.C. Gonzalez-Torres, and A. Benchaib, "Probing Signal Design for Enhanced Damping Estimation in Power Networks", International Journal of Electrical Power & Energy Systems, vol. 129, July 2021, 106640, ISSN 0142-0615. DOI:10.1016/j.ijepes.2020.106640.
M. Podlaski, L. Vanfretti, T. Bogodorova, T. Rabuzin, and M. Baudette, "RaPId - A Parameter Estimation Toolbox for Modelica/FMI-Based Models Exploiting Global Optimization Methods", SYSID 2021 - 19th IFAC Symposium on System Identification – Learning Models for Decision and Control, Padova, Italy, 14-16 July 2021, IFAC-PapersOnLine, Volume 54, Issue 7, 2021, Pages 391-396, ISSN 2405-8963, DOI: 10.1016/j.ifacol.2021.08.391. Video of paper presentation and GitHub repository.
L. Vanfretti, G. Laera, M. de Castro Fernandes, C. Wang, C. Mishra and K. D. Jones, "Initial steps in deploying and calibrating power system models on a sychrophasor data cloud platform using FMI ", User Presentation at the FMI User Meeting at the Modelica Conference 2021, 14th International Modelica Conference, Linköping, September 20-24, 2021. Presentation, and authors' copy of abstract.
B. Mukherjee, M. de Castro Fernandes, and L. Vanfretti, "A PMU-Based Control Scheme for Islanded Operation and Re-synchronization of DER ", International Journal of Electrical Power & Energy Systems, Volume 133, 2021, 107217, ISSN 0142-0615, DOI: 10.1016/j.ijepes.2021.107217
F.J. Gomez, L. Vanfretti, M. Aguilera, and Svein H. Olsen, "Software Requirements for Interoperable and Standard-Based Power System Modeling Tools ", Simulation Modelling Practice and Theory, Volume 103, 2020, 102095, ISSN 1569-190X, DOI: 10.1016/j.simpat.2020.102095
M. de Castro Fernandes, M. Navarro Catalan, M. Baudette, and L. Vanfretti, "The Open Instance Power System Library (OpenIPSL): A Modelica Library for Phasor Time-Domain Simulations ", User Presentation at the American Modelica Conference 2020, Boulder, Colorado, USA, March 23-25, 2020. Presentation Presentation PDF, video, and authors' copy of abstract.
S.A. Dorado-Rojas, M. Navarro Catalan, M. de Castro Fernandes, and L. Vanfretti, "Performance Benchmark of Modelica Time-Domain Power System Automated Simulations using Python ", Proceedings of the American Modelica Conference 2020, Boulder, Colorado, USA, March 23-25, 2020, DOI: 10.3384/ecp2016928
M. Podlaski, L. Vanfretti, M. de Castro Fernandes, and J. Pesente, "Parameter Estimation of User-Defined Control System Models for Itaipu Power Plant using Modelica and OpenIPSL ", Proceedings of the American Modelica Conference 2020, Boulder, Colorado, USA, March 23-25, 2020, DOI: 10.3384/ecp20169139
M. Podlaski, L. Vanfretti, J. Pesente and P. H. Galassi, "Automated Parameter Identification and Calibration for the Itaipu Power Generation System using Modelica, FMI, and RaPId ", 2019 7th Workshop on Modeling and Simulation of Cyber-Physical Energy Systems (MSCPES), 2019, pp. 1-5, DOI: 10.1109/MSCPES.2019.8738793.
L. Vanfretti, B. Mukherjee, K. M. Moudgalya, and F. J. Gomez, "Automatic Re-synchronization Controller Analysis within a Multi-Domain Gas Turbine and Power System Model ", 2019 7th Workshop on Modeling and Simulation of Cyber-Physical Energy Systems (MSCPES), 2019, pp. 1-5, DOI: 10.1109/MSCPES.2019.8738797.
E. Henningsson, H. Olsson, and L. Vanfretti, "DAE Solvers for Large-Scale Hybrid Models ", Proceedings of the 13th International Modelica Conference, Regensburg, Germany, March 4–6, 2019, DOI: 10.3384/ecp19157491
M. de Castro Fernandes, L. Vanfretti, Janaina G. de Oliveira, and M. Baudette, "A Fundamental Time-Domain and Linearized Eigenvalue Analysis of Coalesced Power Transmission and Unbalanced Distribution Grids using Modelica and the OpenIPSL ", Proceedings of the 13th International Modelica Conference, Regensburg, Germany, March 4–6, 2019, DOI: 10.3384/ecp19157617
B. Mukherjee, and L. Vanfretti, "Modeling of PMU-Based Automatic Re-synchronization Controls for DER Generators in Power Distribution Networks using Modelica and the OpenIPSL ", Proceedings of the 13th International Modelica Conference, Regensburg, Germany, March 4–6, 2019, DOI: 10.3384/ecp19157607
M. de Castro Fernandes, J. G. de Oliveira, L. Vanfretti, M. Baudette, and M.A. Tomim, "Modeling and simulation of a hybrid single-phase/three-phase system in Modelica ", 2018 Simposio Brasileiro de Sistemas Eletricos (SBSE), 2018, pp. 1-7, DOI: 10.1109/SBSE.2018.8395775
M. Aguilera, L. Vanfretti, and F. Gomez, "Experiences in power system multi-domain modeling and simulation with Modelica & FMI: The case of gas power turbines and power systems ", 2018 Workshop on Modeling and Simulation of Cyber-Physical Energy Systems (MSCPES), 2018, pp. 1-6, DOI: 10.1109/MSCPES.2018.8405397
M. Aguilera, L. Vanfretti, T. Bogodorova, and F. Gomez, "Coalesced Gas Turbine and Power System Modeling and Simulation using Modelica ", Proceedings of The American Modelica Conference 2018, October 9-10, Samberg Conference Center, Cambridge MA, USA, Issue 154, 2019-02-26, Pages 112-120, ISSN 1650-3740. DOI: 10.3384/ecp1815493
B. Mukherjee, and L. Vanfretti, "Modeling of PMU-Based Islanded Operation Controls for Power Distribution Networks using Modelica and OpenIPSL ", Proceedings of The American Modelica Conference 2018, October 9-10, Samberg Conference Center, Cambridge MA, USA, Issue 154, 2019-02-26, Pages 112-120, ISSN 1650-3740. DOI: 10.3384/ecp18154112
D. Winkler, "Analysing the stability of an Islanded hydro-electric power system", Proceedings of The American Modelica Conference 2018, October 9-10, Samberg Conference Center, Cambridge MA, USA, Issue 154, 2019-02-26, Pages 112-120, ISSN 1650-3740. DOI: 10.3384/ecp18154103
D. Winkler, "Electrical Power System Modelling in Modelica - Comparing Open-source Library Options", Proceedings of the 58th Conference on Simulation and Modelling (SIMS 58), September 25-27, Reykjavik, Iceland, Issue 188, 2017-09-27, Pages 263-270, ISSN 1650-3740. DOI: 10.3384/ecp17138263
T. Rabuzin, M. Baudette and L. Vanfretti, "Implementation of a continuous integration workflow for a power system Modelica library," 2017 IEEE Power & Energy Society General Meeting, 2017, pp. 1-5, DOI: 10.1109/PESGM.2017.8274618.
L. Vanfretti, T. Rabuzin, M. Baudette, and M. Murad, "iTesla Power Systems Library (iPSL): A Modelica library for phasor time-domain simulations," SoftwareX, Available online 18 May 2016, ISSN 2352-7110, DOI: 10.1016/j.softx.2016.05.001.
M. Zhang, M. Baudette, J. Lavenius, S. Løvlund, and L. Vanfretti, "Modelica Implementation and Software-to-Software Validation of Power System Component Models Commonly used by Nordic TSOs for Dynamic Simulations", In Proceedings of the 56th Conference on Simulation and Modelling (SIMS 56), 7-9 October 2015, Linköping, Sweden. DOI: 10.3384/ecp15119105
M. Sabate, G. Leon, M. Halat, J.B. Heyberger, F.J. Gomez and L. Vanfretti, "Aspects of Power System Modeling, Initialization and Simulation using the Modelica Language", 2015 IEEE Eindhoven PowerTech 2015, June 29 - July 02, 2015, Eindhoven, Netherlands. DOI: 10.1109/PTC.2015.7232504
M.A. Adib Murad, F.J. Gomez, and L. Vanfretti, "Equation-Based Modeling of FACTS using Modelica", 2015 IEEE Eindhoven PowerTech 2015, June 29 - July 02, 2015, Eindhoven, Netherlands. DOI: 10.1109/PTC.2015.7232500
M.A. Adib Murad, F.J. Gomez, and L. Vanfretti, "Equation-Based Modeling and Simulation of Three-Winding, and Regulating Transformers using Modelica", 2015 IEEE Eindhoven PowerTech 2015, June 29 - July 02, 2015, Eindhoven, Netherlands. DOI: 10.1109/PTC.2015.7232503
L. Vanfretti, T. Bogodorova, and M. Baudette, "Power System Model Identification Exploiting the Modelica Language and FMI Technologies", 2014 IEEE International Conference on Intelligent Energy and Power Systems, June 2-6, 2014, Kyiv, Ukraine. DOI: 10.1109/IEPS.2014.6874164
L. Vanfretti, T. Bogodorova, and M. Baudette, "A Modelica Power System Component Library for Model Validation and Parameter Identification", 10th International Modelica Conference, Mar. 10 – 12, 2014, Lund, Sweden. DOI: 10.3384/ecp140961195
T. Bogodorova, M. Sabate, G. León, L. Vanfretti, M. Halat, J.B. Heyberger, and P. Panciatici, "A Modelica Power System Library for Phasor Time-Domain Simulation", IEEE ISGT Europe 2013, Oct. 6 – 9, 2013, Lyngby, Denmark. DOI: 10.1109/ISGTEurope.2013.6695422
L. Vanfretti, W. Li, T. Bogodorova, and P.Panciatici, "Unambiguous Power System Modeling and Simulation using Modelica Tools", 2013 IEEE Power and Energy Society General Meeting, Jul. 21 – 25, 2013, Vancouver, Canada. DOI: 10.1109/PESMG.2013.6672476

In addition, you can also browse a few of the thesis of the students that carried out their MSc and PhD research under Prof. Vanfretti's group in the following links:

Extends from Modelica.Icons.References (Icon for external references).

OpenIPSL.UsersGuide.References

[IEEE1968]	IEEE: "Computer representation of excitation systems". IEEE Transactions on Power Apparatus and Systems, Vol PAS-87, 1460–1464, No 6, June 1968. DOI: 10.1109/TPAS.1968.292114
[IEEE1973]	IEEE: "Dynamic Models for Steam and Hydro Turbines in Power System Studies", in IEEE Transactions on Power Apparatus and Systems, volume PAS-92, issue 6, IEEE Report 1973, DOI: 10.1109/TPAS.1973.293570
[IEEE1981]	IEEE: "Excitation System Models for Power System Stability Studies", in IEEE Transactions on Power Apparatus and Systems, IEEE Report 1981, DOI: 10.1109/TPAS.1981.316906
[IEEE1992]	IEEE: "421.5-1992 - IEEE Recommended Practice for Excitation System Models for Power System Stability Studies", IEEE Standard 1992, DOI: 10.1109/IEEESTD.1992.106975
[IEEE2005]	IEEE: "421.5-2005 - IEEE Recommended Practice for Excitation System Models for Power System Stability Studies", IEEE Standard 2005, DOI: 10.1109/IEEESTD.2006.99499
[IEEE2013]	IEEE Power & Energy Society: "Dynamic models for turbine-governors in power system studies", Power System Dynamic Performance Committee, IEEE PES Resource Center
[IEEE2016]	IEEE: "421.5-2016 - IEEE Recommended Practice for Excitation System Models for Power System Stability Studies", IEEE Standard 2016, DOI: 10.1109/IEEESTD.2016.7553421
[Milano2010]	Federico Milano: "Power System Modelling and Scripting", Springer 2010, ISBN 978-3-642-13668-9
[Milano2013]	Federico Milano: "Power System Analysis Toolbox", Documentation for PSAT version 2.1.8, 6th January 2013, (Home page)
[PSSE-AGV1]	Siemens: "PSS®E Program Application Guide Volume 1", version 33, April 2017, (Home page)
[PSSE-AGV2]	Siemens: "PSS®E Program Application Guide Volume 2", version 33, April 2017, (Home page)
[PSSE-MODELS]	Siemens: "PSS®E Model Library", version 33, April 2017, (Home page)
[Verboomen2005]	Verboomen, J., Van Hertem, D., Schavemaker, P., Kling, W., Belmans, R.: "Phase shifting transformers: Principles and applications". In: International Conference on Future Power Systems, Amsterdam, Netherlands, November 2005, DOI: 10.1109/FPS.2005.204302

Extends from Modelica.Icons.References (Icon for external references).

OpenIPSL.UsersGuide.Contact

The OpenIPSL is developed by many people from a few different organizations. This page shows the active members and contributors.

The development of the library is organized by:

Luigi Vanfretti: Associate Professor; Department of Electrical, Computer, and Systems Engineering; Rensselaer Polytechnic Institute; 110 8th St, Troy, NY 12180; United States; email: luigi.vanfretti@gmail.com

Version 2.0.0 is organized by:

Dietmar Winkler: Assistant Professor; Department of Electrical Engineering, Information Technology and Cybernetics; University of South-Eastern Norway; Campus Porsgrunn; Norway; email: dietmar.winkler@usn.no

and

Marcelo de Castro: PhD Student and Research Assistant; Department of Electrical, Computer, and Systems Engineering; Rensselaer Polytechnic Institute; 110 8th St, Troy, NY 12180; United States; email: decasm3@rpi.edu

Other contributors:

In addition to that, the library currently has the following team of developers and active contributors:

Contributor	Organization	Contact
Biswarup Mukherjee	MINES ParisTech	biswarup.mukherjee@mines-paristech.fr
Giuseppe Laera	Rensselaer Polytechnic Institute	laerag@rpi.edu
Manuel Navarro Catalan	Rensselaer Polytechnic Institute	navarm2@rpi.edu
Maxime Baudette	Lawrence Berkeley National Laboratory	baudette@lbl.gov
Meaghan Podlaski	Rensselaer Polytechnic Institute	podlam@rpi.edu
Sergio Dorado-Rojas	Rensselaer Polytechnic Institute	dorads@rpi.edu
Tin Rabuzin	KTH Royal Institute of Technology	rabuzin@kth.se

Extends from Modelica.Icons.Contact (Icon for contact information).

Automatically generated Mon Oct 10 14:35:38 2022.