Copyright © 2018-2020, RTE.

PowerGrids is licensed under the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, you can obtain one here.

-------------------------------------------------------------------------------------------------------------

The PowerGrids library is a library for the modelling of power generation and transmission systems for electro-mechanical phenomena ("phasor" approximation).

The main goal of the library is to demonstrate how it is possible to exploit the power of the Modelica language to develop fully declarative electro-mechanical models of power generation and transmission systems that are self-documented, easy to understand, and easy to modify and improve. For physical component models, the code is as close as possible to the model description as found in textbooks and basic theory manuals, entirely leaving to the Modelica tool the task of solving the equations. For control systems, block diagrams are used, as they are immediately recognized by domain experts.

To achieve this goal, the following features were implemented:

- Base classes for one-port and two-port components to factor out common code as much as possible.
- Use of Complex numbers for maximum readability.
- Use of physical SI units wherever appropriate, e.g., in connectors.
- Proper scaling of the underlying differential-algebraic equations for numerical robustness achieved by using the nominal attribute of variables, rather than implementing it explicitly in the models.
- Use of initial equations to compute all strictly necessary start values in a declarative, easy-to-understand way, starting from power-flow analysis results.
- Use of initial equations for steady-state initialization of models.
- Use of homotopy to improve the convergence of initial equations where necessary.

The library was developed by RTE with help from Dynamica s.r.l.. It is part of a larger effort to promote both the use of the Modelica language for power system modeling and the advantages of open-source approaches - for more information, go to Dynawo website.

PowerGrids was developed and tested using OpenModelica 1.14.1, but is expected to run on all Modelica tools that fully support Complex numbers and the homotopy transformation. For numerical efficiency of models with more than a few buses, it is necessary that the tool does not transform the equations into ODE form, but rather directly uses a sparse DAE solver. The reason for this requirement is that while the DAE is sparse, the corresponding ODE is dense.

Note that most of the models and test cases run with this version of OpenModelica but some solver issues are still under consideration and should only be available from OpenModelica 1.16 - in case you want to benefit from the latest developments, we recommend you to download the nightly-build from OpenModelica.

For further technical information, see the User's Guide.

Name | Description |
---|---|

UsersGuide | User's Guide |

Examples | |

Electrical | Electrical components |

Controls | Control blocks |

Interfaces | Interfaces package |

Types | Domain-specific type definitions |

Functions | Custom functions |

Icons | Icons for the PowerGrids library |

Generated at 2024-03-03T19:16:20Z by OpenModelicaOpenModelica 1.22.1 using GenerateDoc.mos