modelTransformerFixedRatio
Transformer with fixed voltage ratio
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.
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 | 0 | Series resistance on B side |
| Types.Reactance | X | 0 | Series reactance on B side |
| Types.Conductance | G | 0 | Shunt conductance on B side |
| Types.Susceptance | B | 0 | Shunt susceptance on B side |
| 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 |
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) |