modelTransformerFixedRatioWithBreaker
Extends from BaseClasses.PiNetwork (Generic Pi-Network base model), Icons.Transformer.
Information
Transformer with fixed voltage ratio k = rFixed*exp(j*thetaFixed). The series impedance R+jX and shunt admittance G+jB are referred to the high-voltage side B.
Step-up transformers with fixed voltage ratio can be implemented by only setting rFixed and leaving thetaFixed to zero default value. Phase shifters can be implemented by only setting thetaFixed and leaving rFixed to the default of 1.
Implemented as a child class of PiNetwork, where Ya=0 Yb=G+jB and k = rFixed*exp(j*thetaFixed), see the corresponding documentation.
One breaker is provided at port b side. The breaker has a conditional boolean input to set the logical status:
- true = breaker closed
- false = breaker open
When the breaker is open the current entering from the port b is forced to 0 (by setting to 0 both the actual values of the series impedance and of the shunt impedance of port b), and the total impedance seen to the side a (high-level voltage side) becomes equal to the line impedance + the shunt impedance.
The actual values of the series impedance and of both the shunt impedances are managed by a state-machine, which monitors the state of the breaker.
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 |
| SI.PerUnit | rFixed | 1 | Fixed transformer ratio VB/VA |
| SI.Angle | thetaFixed | 0 | Fixed phase lead of VB w.r.t. VA |
| Types.Resistance | R | Series resistance on B side | |
| Types.Reactance | X | Series reactance on B side | |
| Types.Conductance | G | 0 | Shunt conductance on B side |
| Types.Susceptance | B | 0 | Shunt susceptance on B side |
| Types.ComplexAdmittance | Yseries | Complex(1)/Complex(R, X) | Series admittance |
| Types.ComplexAdmittance | Yshunt | Complex(G, B) | Shunt admittance at port B |
| Types.ComplexAdmittance | YbreakerOpen | Yseries*Yshunt/(Yseries + Yshunt) | Total admittance when breaker is open (port B) |
| 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 | breakerStatusStart | true | Breaker start status - true means breaker closed |
| External Inputs | |||
| Boolean | useBreaker | false | Use breaker (port b) |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| PowerGrids.Interfaces.TerminalAC | terminalA (from TwoPortAC) | ||
| PowerGrids.Interfaces.TerminalAC | terminalB (from TwoPortAC) | ||
| Modelica.Blocks.Interfaces.BooleanInput | breakerStatusIn | Breaker Status (port B) - true means breaker closed |
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) | ||
| Types.ComplexAdmittance | Y_actual | Actual series admittance | |
| Types.ComplexAdmittance | YA_actual | Actual shunt admittance at port A | |
| Types.ComplexAdmittance | YB_actual | Actual shunt admittance at port B | |
| BreakersState | breakerStatus | breacker current status |
Contents
| Name | Description |
|---|---|
| BreakersState |