modelTransformerWithTapChangerInterval

Extends from BaseClasses.TapChangerPhaseShifterCommon (Common base class for tap-changer/phase shifter transformers), BaseClasses.TapChangerPhaseShifterLogicInterval.

Information

This model implements a transformer with a tap changer which takes a phase-to-phase voltage magnitude range, and tries to maintain the magnitude of phase-to-phase voltage at portB within that range.

It extends two classes:


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
RealNotUsed (from TapChangerPhaseShifterCommon)Modelica.Constants.infGeneric default value for not-used parameters
Types.ResistanceR (from TapChangerPhaseShifterCommon)0Series resistance
Types.ReactanceX (from TapChangerPhaseShifterCommon)0Series reactance
Types.ConductanceG (from TapChangerPhaseShifterCommon)0Shunt conductance
Types.SusceptanceB (from TapChangerPhaseShifterCommon)0Shunt susceptance
Types.TimetimeInfinity (from TapChangerPhaseShifterLogicCommon)Modelica.Constants.infDefault value for counters
Types.Timet1st (from TapChangerPhaseShifterLogicCommon)Time lag before changing the first tap
Types.TimetNext (from TapChangerPhaseShifterLogicCommon)Time lag before changing subsequent taps
IntegerNtap (from TapChangerPhaseShifterLogicCommon)Number of tap positions
IntegertapMax (from TapChangerPhaseShifterLogicCommon)NtapMax tap position
IntegertapMin (from TapChangerPhaseShifterLogicCommon)1Min tap position
ActionTypeactionSel (from TapChangerPhaseShifterLogicCommon)ActionType.directTap direct or reverse action selector
BooleandirectAction (from TapChangerPhaseShifterLogicCommon)(actionSel == ActionType.direct)= true, when direct action is selected
BooleanreverseAction (from TapChangerPhaseShifterLogicCommon)(actionSel == ActionType.reverse)= true, when reverse action is selected
Types.TimetToStandardState (from TapChangerPhaseShifterLogicInterval)0.1time lag before transition to standard state, in order to avoid chattering
Types.PerUnit[Ntap]KArray of transformer ratios for each tap
Types.VoltageUMaxMaximum phase-to-phase voltage threshold for tap changer logic
Types.VoltageUMinMinimum phase-to-phase voltage threshold for tap changer logic
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
BooleanlockedStart (from TapChangerPhaseShifterLogicCommon)falseWhether the tap-changer/phase-shifter is initially locked
BooleanrunningStart (from TapChangerPhaseShifterLogicCommon)trueWhether the tap-changer/phase-shifter is initially running
IntegertapStart (from TapChangerPhaseShifterLogicCommon)Initial tap
StatestateStart (from TapChangerPhaseShifterLogicCommon)State.standardInitial state

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)
Statestate (from TapChangerPhaseShifterLogicCommon)
Booleanlocked (from TapChangerPhaseShifterLogicCommon)whether the tap-changer/phase-shifter is locked
Booleanrunning (from TapChangerPhaseShifterLogicCommon)whether the tap-changer/phase-shifter is running
Integertap (from TapChangerPhaseShifterLogicCommon)Current tap