modelTransformerWithPhaseShifterInterval
Extends from BaseClasses.TapChangerPhaseShifterCommon (Common base class for tap-changer/phase shifter transformers), BaseClasses.TapChangerPhaseShifterLogicInterval.
Information
This model implements a transformer with a phase shifter which takes a range for an electrical quantity at portB, and tries to maintain said quantity within it.
The available electrical quantities are Current Magnitude and Active Power.
It extends two classes:
- TapChangerPhaseShifterCommon, which implements the model of the transformer,
- TapChangerPhaseShifterLogicInterval, which implements 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.Time | tToStandardState (from TapChangerPhaseShifterLogicInterval) | 0.1 | time lag before transition to standard state, in order to avoid chattering |
| Types.Angle[Ntap] | kPhase | Array with angle of transformer complex ratio for each tap | |
| PowerGrids.Electrical.Branches.BaseClasses.TapChangerPhaseShifterCommon.MonitoredQuantitySelection | quantitySel | monitored quantity selection | |
| Types.Current | IMax | NotUsed | Maximum Current threshold for phase shifter logic |
| Types.Current | IMin | NotUsed | Minimum Current threshold for phase shifter logic |
| Types.ActivePower | PMax | NotUsed | Maximum Active Power threshold for phase shifter logic |
| Types.ActivePower | PMin | NotUsed | Minimum 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 |