Component Library

This page documents all the pre-built components available in the PowerDynamics.jl library.

PowerDynamics.Library Under Active Development

The PowerDynamics.Library component library is currently excluded from semantic versioning and is under heavy development.

While PowerDynamics itself follows semantic versioning, the Library submodule's API is highly unstable and variable names, function signatures, and model interfaces may change frequently without notice. If you are using specific models from PowerDynamics.Library in their current state, we strongly recommend copying them to your own source code to avoid breaking changes in future updates.

Slack Models

Algebraic and Differential Slack

Missing docstring.

Missing docstring for SlackAlgebraic. Check Documenter's build log for details.

Missing docstring.

Missing docstring for SlackDifferential. Check Documenter's build log for details.

Missing docstring.

Missing docstring for VariableFrequencySlack. Check Documenter's build log for details.

Machine Models

Synchronous Machine Models

PowerDynamics.Library.PSSE_GENCLS — Constant

PSSE_GENCLS

This model is a port of the OpenIPSL Electrical.Machines.PSSE.GENCLS model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Machines.PSSE.GENCLS. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

PowerDynamics.Library.PSSE_GENROU — Function

PSSE_GENROU

This model is a port of the OpenIPSL Electrical.Machines.PSSE.GENROU model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Machines.PSSE.GENROU. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

PowerDynamics.Library.PSSE_GENROE — Function

PSSE_GENROE

This model is a port of the OpenIPSL Electrical.Machines.PSSE.GENROE model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Machines.PSSE.GENROE. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

PowerDynamics.Library.PSSE_GENSAL — Function

PSSE_GENSAL

This model is a port of the OpenIPSL Electrical.Machines.PSSE.GENSAL model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Machines.PSSE.GENSAL. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

PowerDynamics.Library.PSSE_GENSAE — Function

PSSE_GENSAE

This model is a port of the OpenIPSL Electrical.Machines.PSSE.GENSAE model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Machines.PSSE.GENSAE. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

Missing docstring.

Missing docstring for SauerPaiMachine. Check Documenter's build log for details.

Missing docstring.

Missing docstring for Swing. Check Documenter's build log for details.

Missing docstring.

Missing docstring for ClassicalMachine. Check Documenter's build log for details.

Control Systems

Exciters & AVRs

PowerDynamics.Library.PSSE_EXST1 — Constant

PSSE_EXST1

This model is a port of the OpenIPSL Electrical.Controls.PSSE.ES.EXST1 model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.ES.EXST1. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

PowerDynamics.Library.PSSE_ESST4B — Constant

PSSE_ESST4B

This model is a port of the OpenIPSL Electrical.Controls.PSSE.ES.ESST4B model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.ES.ESST4B. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

Slight deviations from OpenIPSL behavior

There are still some slight deviations, likely due to differences in the initialization/steady state (see the current integrator state in the validation plot).

source

PowerDynamics.Library.PSSE_ESST1A — Constant

PSSE_ESST1A

This model is a port of the OpenIPSL Electrical.Controls.PSSE.ES.ESST1A model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.ES.ESST1A. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

PowerDynamics.Library.PSSE_SCRX — Constant

PSSE_SCRX

This model is a port of the OpenIPSL Electrical.Controls.PSSE.ES.SCRX model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.ES.SCRX. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

PowerDynamics.Library.PSSE_IEEET1 — Constant

PSSE_IEEET1

This model is a port of the OpenIPSL Electrical.Controls.PSSE.ES.IEEET1 model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.ES.IEEET1. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

Missing docstring.

Missing docstring for AVRFixed. Check Documenter's build log for details.

Missing docstring.

Missing docstring for AVRTypeI. Check Documenter's build log for details.

Governors and Turbines

PowerDynamics.Library.PSSE_IEEEG1 — Constant

PSSE_IEEEG1

This model is a port of the OpenIPSL Electrical.Controls.PSSE.TG.IEEEG1 model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.TG.IEEEG1. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

Slight deviations from OpenIPSL behavior

There are still some slight deviations, likely due to differences in the initialization/steady state (see P_MECH output of the validation plot).

source

PowerDynamics.Library.PSSE_HYGOV — Constant

PSSE_HYGOV

This model is a port of the OpenIPSL Electrical.Controls.PSSE.TG.HYGOV model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.TG.HYGOV. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

Missing docstring.

Missing docstring for GovFixed. Check Documenter's build log for details.

Missing docstring.

Missing docstring for TurbineGovTypeI. Check Documenter's build log for details.

Missing docstring.

Missing docstring for TGOV1. Check Documenter's build log for details.

PowerDynamics.Library.PSSE_GGOV1_EXPERIMENTAL — Constant

PSSE_GGOV1_EXPERIMENTAL

This model is a port of the OpenIPSL Electrical.Controls.PSSE.TG.GGOV1 model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Warning

This model does not support delay! It is validaded against a modified version of the OpenIPSL SMIB testcase Tests.Controls.PSSE.TG.GGOV1 without delay (see reference data generation script in /test/OpenIPSL/GGOV1 for modified version). Also, the OpenIPSL testcase does not start in a steady state, so we have some deviation in the validation still. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

Power System Stabilizers (PSS)

PowerDynamics.Library.PSSE_IEEEST — Constant

PSSE_IEEEST

This model is a port of the OpenIPSL Electrical.Controls.PSSE.PSS.IEEEST model, maintaining the same mathematical formulation while adapting to PowerDynamics/ModelingToolkit conventions.

Validation

Validated against the OpenIPSL SMIB testcase Tests.Controls.PSSE.PSS.IEEEST. See validation plot generated by automatic validation script in /test/OpenIPSL_test.

source

Load Models

Static Load Models

Missing docstring.

Missing docstring for PQLoad. Check Documenter's build log for details.

Missing docstring.

Missing docstring for VoltageDependentLoad. Check Documenter's build log for details.

Missing docstring.

Missing docstring for ConstantYLoad. Check Documenter's build log for details.

Missing docstring.

Missing docstring for ZIPLoad. Check Documenter's build log for details.

Missing docstring.

Missing docstring for PSSE_Load. Check Documenter's build log for details.

Line Models

Transmission Line Models

Missing docstring.

Missing docstring for PiLine. Check Documenter's build log for details.

Missing docstring.

Missing docstring for PiLine_fault. Check Documenter's build log for details.

Fault Models

Ground Fault Models

Missing docstring.

Missing docstring for RXGroundFault. Check Documenter's build log for details.