modelPiNetwork
Generic Pi-Network base model
Extends from Electrical.BaseClasses.TwoPortAC (Base class for two-port AC components).
Information
This is the base class for branch components that can be represented as Pi-network with an ideal transformer with complex ratio at port_a. A diagram of the model is shown in the figure.
In general the impedances and transformer complex ratio are time-varying variables.
The model can be specialized to describe a transmission line with fixed or variable impedances, a transmission line with embedded circuit breakers, transformers with fixed or variable transformer ratio, transformers with tap changer/phase shifter, etc.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Types.Voltage | UNomA (from TwoPortAC) | Nominal/rated voltage, port A | |
| Types.Voltage | UNomB (from TwoPortAC) | UNomA | Nominal/rated voltage, port B |
| Types.Power | SNom (from TwoPortAC) | Nominal/rated power | |
| Boolean | portVariablesPhases (from TwoPortAC) | false | Compute voltage and current phases for monitoring purposes only |
| Boolean | portVariablesPu (from TwoPortAC) | true | Add per-unit variables to model |
| Boolean | computePowerBalance (from TwoPortAC) | true | Compute net balance of complex power entering the component |
| Initialization | |||
| Types.Voltage | UStartA (from TwoPortAC) | UNomA | Start value of phase-to-phase voltage phasor at port A, absolute value |
| Types.Angle | UPhaseStartA (from TwoPortAC) | 0 | Start value of phase-to-phase voltage phasor at port A, phase angle |
| Types.ActivePower | PStartA (from TwoPortAC) | SNom | Start value of active power flowing into port A |
| Types.ReactivePower | QStartA (from TwoPortAC) | 0 | Start value of reactive power flowing into port A |
| Types.Voltage | UStartB (from TwoPortAC) | UNomB | Start value of phase-to-phase voltage phasor at port B, absolute value |
| Types.Angle | UPhaseStartB (from TwoPortAC) | 0 | Start value of phase-to-phase voltage phasor at port B, phase angle |
| Types.ActivePower | PStartB (from TwoPortAC) | -SNom | Start value of active power flowing into port B |
| Types.ReactivePower | QStartB (from TwoPortAC) | 0 | Start value of reactive power flowing into port B |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| PowerGrids.Interfaces.TerminalAC | terminalA (from TwoPortAC) | ||
| PowerGrids.Interfaces.TerminalAC | terminalB (from TwoPortAC) |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| PortAC | portA (from TwoPortAC) | AC port - terminalA | |
| PortAC | portB (from TwoPortAC) | AC port - terminalB | |
| Types.ComplexPower | Sbal (from TwoPortAC) | portA.S + portB.S | Complex power balance |
| Electrical.System | systemPowerGrids (from TwoPortAC) | Reference to system object | |
| Types.ComplexAdmittance | Y | Series admittance | |
| Types.ComplexAdmittance | YA | Shunt admittance at port a | |
| Types.ComplexAdmittance | YB | Shunt admittance at port b | |
| Types.ComplexPerUnit | k | Complex ratio of ideal transformer at port A (vB/vA) | |
| Types.ComplexVoltage | vA | portA.v | |
| Types.ComplexVoltage | vB | portB.v | |
| Types.ComplexCurrent | iA | portA.i | |
| Types.ComplexCurrent | iB | portB.i | |
| Types.ComplexVoltage | vAt | ||
| Types.ComplexVoltage | vz | ||
| Types.ComplexCurrent | iAt | ||
| Types.ComplexCurrent | iAs | ||
| Types.ComplexCurrent | iBs | ||
| Types.ComplexCurrent | iz |