modelTapChangerPhaseShifterCommon

Common base class for tap-changer/phase shifter transformers

Extends from BaseClasses.PiNetwork (Generic Pi-Network base model), Icons.Transformer.

Information

This partial model can be used as base class in order to implement transformers with tap-changer/phase shifter with logic of different types.

It extends a Pi Network, adding the common parameters wich define the series impedance and the shunt admittance.

Moreover, this class contains the definition of the type MonitoredQuantitySelection, used to select the electrical quantity monitored by the phase shifter.

The available electrical quantities are Current Magnitude and Active Power.

Parameters

TypeNameDefaultDescription
Types.VoltageUNomA (from TwoPortAC)Nominal/rated voltage, port A
Types.VoltageUNomB (from TwoPortAC)UNomANominal/rated voltage, port B
Types.PowerSNom (from TwoPortAC)Nominal/rated power
BooleanportVariablesPhases (from TwoPortAC)falseCompute voltage and current phases for monitoring purposes only
BooleanportVariablesPu (from TwoPortAC)trueAdd per-unit variables to model
BooleancomputePowerBalance (from TwoPortAC)trueCompute net balance of complex power entering the component
RealNotUsedModelica.Constants.infGeneric default value for not-used parameters
Types.ResistanceR0Series resistance
Types.ReactanceX0Series reactance
Types.ConductanceG0Shunt conductance
Types.SusceptanceB0Shunt susceptance
Initialization
Types.VoltageUStartA (from TwoPortAC)UNomAStart value of phase-to-phase voltage phasor at port A, absolute value
Types.AngleUPhaseStartA (from TwoPortAC)0Start value of phase-to-phase voltage phasor at port A, phase angle
Types.ActivePowerPStartA (from TwoPortAC)SNomStart value of active power flowing into port A
Types.ReactivePowerQStartA (from TwoPortAC)0Start value of reactive power flowing into port A
Types.VoltageUStartB (from TwoPortAC)UNomBStart value of phase-to-phase voltage phasor at port B, absolute value
Types.AngleUPhaseStartB (from TwoPortAC)0Start value of phase-to-phase voltage phasor at port B, phase angle
Types.ActivePowerPStartB (from TwoPortAC)-SNomStart value of active power flowing into port B
Types.ReactivePowerQStartB (from TwoPortAC)0Start value of reactive power flowing into port B

Connectors

TypeNameDefaultDescription
PowerGrids.Interfaces.TerminalACterminalA (from TwoPortAC)
PowerGrids.Interfaces.TerminalACterminalB (from TwoPortAC)

Components

TypeNameDefaultDescription
PortACportA (from TwoPortAC)AC port - terminalA
PortACportB (from TwoPortAC)AC port - terminalB
Types.ComplexPowerSbal (from TwoPortAC)portA.S + portB.SComplex power balance
Electrical.SystemsystemPowerGrids (from TwoPortAC)Reference to system object
Types.ComplexAdmittanceY (from PiNetwork)Series admittance
Types.ComplexAdmittanceYA (from PiNetwork)Shunt admittance at port a
Types.ComplexAdmittanceYB (from PiNetwork)Shunt admittance at port b
Types.ComplexPerUnitk (from PiNetwork)Complex ratio of ideal transformer at port A (vB/vA)
Types.ComplexVoltagevA (from PiNetwork)portA.v
Types.ComplexVoltagevB (from PiNetwork)portB.v
Types.ComplexCurrentiA (from PiNetwork)portA.i
Types.ComplexCurrentiB (from PiNetwork)portB.i
Types.ComplexVoltagevAt (from PiNetwork)
Types.ComplexVoltagevz (from PiNetwork)
Types.ComplexCurrentiAt (from PiNetwork)
Types.ComplexCurrentiAs (from PiNetwork)
Types.ComplexCurrentiBs (from PiNetwork)
Types.ComplexCurrentiz (from PiNetwork)

Contents

NameDescription
MonitoredQuantitySelection