modelTransformerWithPhaseShifterTarget
Extends from TransformerWithPhaseShifterInterval.
Information
This model implements a transformer with a phase shifter which takes a target and a dead band for an electrical quantity at portB, and tries to maintain said quantity in the acceptable dead-band next to the target value.The available electrical quantities are Current Magnitude and Active Power.
It extends the class TransformerWithPhaseShifterInterval, which implements a transformer with phase-shifter and Interval logic, redefining said interval in terms of target value and dead-band.
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 (from TransformerWithPhaseShifterInterval) | Array with angle of transformer complex ratio for each tap | |
| PowerGrids.Electrical.Branches.BaseClasses.TapChangerPhaseShifterCommon.MonitoredQuantitySelection | quantitySel (from TransformerWithPhaseShifterInterval) | monitored quantity selection | |
| Types.Current | IMax (from TransformerWithPhaseShifterInterval) | NotUsed | Maximum Current threshold for phase shifter logic |
| Types.Current | IMin (from TransformerWithPhaseShifterInterval) | NotUsed | Minimum Current threshold for phase shifter logic |
| Types.ActivePower | PMax (from TransformerWithPhaseShifterInterval) | NotUsed | Maximum Active Power threshold for phase shifter logic |
| Types.ActivePower | PMin (from TransformerWithPhaseShifterInterval) | NotUsed | Minimum Active Power threshold for phase shifter logic |
| Types.Current | targetValueI | NotUsed | Current target value |
| Types.Current | deadBandI | NotUsed | Acceptable dead-band next to the Current target value |
| Types.ActivePower | targetValueP | NotUsed | Current target value |
| Types.ActivePower | deadBandP | NotUsed | Maximum 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 |