modelTransformerWithPhaseShifterMax

Diagram of TransformerWithPhaseShifterMax

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

Information

This model implements a transformer with a phase shifter which takes a maximum and a stop limit of an electrical quantity at portB, and tries to bring said quantity back to the stop limit when the maximum value is reached.

The available electrical quantities are Current Magnitude and Active Power.

It extends two classes:

TapChangerPhaseShifterCommon, wich implement the model of the transformer,

TapChangerPhaseShifterLogicMax, wich implement the logic that updates the position of the tap changer.

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
Real	NotUsed (from TapChangerPhaseShifterCommon)	Modelica.Constants.inf	Generic default value for not-used parameters
Types.Resistance	R (from TapChangerPhaseShifterCommon)	0	Series resistance
Types.Reactance	X (from TapChangerPhaseShifterCommon)	0	Series reactance
Types.Conductance	G (from TapChangerPhaseShifterCommon)	0	Shunt conductance
Types.Susceptance	B (from TapChangerPhaseShifterCommon)	0	Shunt susceptance
Types.Time	timeInfinity (from TapChangerPhaseShifterLogicCommon)	Modelica.Constants.inf	Default value for counters
Types.Time	t1st (from TapChangerPhaseShifterLogicCommon)		Time lag before changing the first tap
Types.Time	tNext (from TapChangerPhaseShifterLogicCommon)		Time lag before changing subsequent taps
Integer	Ntap (from TapChangerPhaseShifterLogicCommon)		Number of tap positions
Integer	tapMax (from TapChangerPhaseShifterLogicCommon)	Ntap	Max tap position
Integer	tapMin (from TapChangerPhaseShifterLogicCommon)	1	Min tap position
ActionType	actionSel (from TapChangerPhaseShifterLogicCommon)	ActionType.direct	Tap direct or reverse action selector
Boolean	directAction (from TapChangerPhaseShifterLogicCommon)	(actionSel == ActionType.direct)	= true, when direct action is selected
Boolean	reverseAction (from TapChangerPhaseShifterLogicCommon)	(actionSel == ActionType.reverse)	= true, when reverse action is selected
Types.Angle[Ntap]	kPhase		Angle of transformer complex ratio for each tap
PowerGrids.Electrical.Branches.BaseClasses.TapChangerPhaseShifterCommon.MonitoredQuantitySelection	quantitySel		monitored quantity selection
Types.Current	IMax	NotUsed	Max Current threshold for phase shifter logic
Types.Current	IStop	NotUsed	Stop Current threshold for phase shifter logic
Types.ActivePower	PMax	NotUsed	Max Active Power threshold for phase shifter logic
Types.ActivePower	PStop	NotUsed	Stop Active Power threshold for phase shifter logic
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
Boolean	lockedStart (from TapChangerPhaseShifterLogicCommon)	false	Whether the tap-changer/phase-shifter is initially locked
Boolean	runningStart (from TapChangerPhaseShifterLogicCommon)	true	Whether the tap-changer/phase-shifter is initially running
Integer	tapStart (from TapChangerPhaseShifterLogicCommon)		Initial tap
State	stateStart (from TapChangerPhaseShifterLogicCommon)	State.standard	Initial state

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 (from PiNetwork)		Series admittance
Types.ComplexAdmittance	YA (from PiNetwork)		Shunt admittance at port a
Types.ComplexAdmittance	YB (from PiNetwork)		Shunt admittance at port b
Types.ComplexPerUnit	k (from PiNetwork)		Complex ratio of ideal transformer at port A (vB/vA)
Types.ComplexVoltage	vA (from PiNetwork)	portA.v
Types.ComplexVoltage	vB (from PiNetwork)	portB.v
Types.ComplexCurrent	iA (from PiNetwork)	portA.i
Types.ComplexCurrent	iB (from PiNetwork)	portB.i
Types.ComplexVoltage	vAt (from PiNetwork)
Types.ComplexVoltage	vz (from PiNetwork)
Types.ComplexCurrent	iAt (from PiNetwork)
Types.ComplexCurrent	iAs (from PiNetwork)
Types.ComplexCurrent	iBs (from PiNetwork)
Types.ComplexCurrent	iz (from PiNetwork)
State	state (from TapChangerPhaseShifterLogicCommon)
Boolean	locked (from TapChangerPhaseShifterLogicCommon)		whether the tap-changer/phase-shifter is locked
Boolean	running (from TapChangerPhaseShifterLogicCommon)		whether the tap-changer/phase-shifter is running
Integer	tap (from TapChangerPhaseShifterLogicCommon)		Current tap