modelEquivalentGrid
Equivalent grid model characterized by short circuit capacity
Extends from PowerGrids.Electrical.Buses.BaseClasses.BusBase, Icons.Grid.
Information
This model describes an equivalent grid with an internal impedance driven by a constant voltage source.
The impedance is computed to provide a power flow SSC/c out of the voltage source, assuming the voltage is set to the nominal value UNom and that the grid terminal is shorted to ground.
The actual modulus and phase of the voltage source are computed to give the required voltage modulus and phase URef, UPhaseRef during initialization.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Types.Voltage | UNom (from OnePortAC) | Nominal/rated line-to-line voltage | |
| Types.ApparentPower | SNom (from OnePortAC) | Nominal/rated apparent power | |
| Boolean | portVariablesPhases (from OnePortAC) | false | Compute voltage and current phases for monitoring purposes only |
| Boolean | portVariablesPu (from OnePortAC) | true | Add per-unit variables to model |
| Boolean | generatorConvention (from OnePortAC) | false | Add currents with generator convention (i > 0 when exiting the device) to model |
| LocalInitializationOption | localInit (from OnePortAC) | LocalInitializationOption.none | Initialize the component locally in steady state from port start values |
| Types.Voltage | URef | UNom | Reference phase-to-phase voltage at connection terminal |
| Types.Angle | UPhaseRef | 0 | Voltage phase angle at connection terminal |
| Types.ApparentPower | SSC | Short-circuit capacity | |
| Types.PerUnit | c | 1.1 | c-factor for calculation of short-circuit capacity |
| Types.PerUnit | R_X | 1/10 | Ratio of resistance to reactance of the grid |
| Types.ComplexPower | Ssc | ComplexMath.fromPolar(SSC/c, atan(1/R_X)) | Short circuit active power |
| Types.ComplexImpedance | ZGrid | 1/ComplexMath.conj(Ssc/UNom^2) | Grid impedance |
| Types.ComplexVoltage | eStart | ComplexMath.fromPolar(URef, UPhaseStart) | Tentative value of voltage source |
| Types.ComplexVoltage | eSource | Constant value of voltage source | |
| Initialization | |||
| Types.Voltage | UStart (from OnePortAC) | UNom | Start value of phase-to-phase voltage phasor, absolute value |
| Types.Angle | UPhaseStart (from OnePortAC) | 0 | Start value of phase-to-phase voltage phasor, phase angle |
| Types.ActivePower | PStart (from OnePortAC) | SNom | Start value of active power flowing into the port |
| Types.ReactivePower | QStart (from OnePortAC) | 0 | Start value of reactive power flowing into the port |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| PowerGrids.Interfaces.TerminalAC | terminal (from OnePortAC) |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| PortAC | port (from OnePortAC) | AC port of node | |
| Electrical.System | systemPowerGrids (from OnePortAC) | Reference to system object | |
| Types.ComplexVoltage | e (from BusBase) | Voltage of ideal generator, phase-to-ground | |
| Types.ComplexImpedance | Z (from BusBase) | Internal impedance | |
| Types.ComplexVoltage | v (from BusBase) | port.v | Port voltage, phase-to-ground |
| Types.ComplexCurrent | i (from BusBase) | port.i | Port current |