Buildings.Electrical.AC.OnePhase.Conversion
Package with models for AC/AC and AC/DC conversion
Information
This package contains models for AC/AC and AC/DC conversion.
Extends from Modelica.Icons.Package (Icon for standard packages).
Package Content
Name | Description |
---|---|
ACACConverter | AC AC converter single phase systems |
ACACTransformer | AC AC transformer simplified equivalent circuit |
ACACTransformerFull | AC AC transformer with detailed equivalent circuit |
ACDCConverter | AC DC converter |
Examples | Package with example models |
Buildings.Electrical.AC.OnePhase.Conversion.ACACConverter
AC AC converter single phase systems
Information
This is an AC/AC converter, based on a power balance between both circuit sides. The parameter conversionFactor defines the ratio between the RMS voltages as
V2 = conversionFactor V1
where V1 and V2 are the RMS voltages at the primary and secondary sides of the transformer, i.e., the connector N and P, respectively.
The loss of the converter is proportional to the power transmitted.
The parameter eta
is the efficiency of the transfer.
The loss is computed as
Ploss = (1-η) Ptr,
where Ptr is the power transmitted. The model is bi-directional and the power can flow from the primary to the secondary side and vice-versa. Furthermore, reactive power on both side are set to zero.
Note:
This model is derived from Modelica.Electrical.QuasiStatic.SinglePhase.Utilities.IdealACDCConverter.
Extends from Buildings.Electrical.Icons.RefAngleConversion (Icon that represents if the angle symble should be displayed or not), Buildings.Electrical.Interfaces.PartialConversion (Model representing a generic two port system for conversion).
Parameters
Type | Name | Default | Description |
---|---|---|---|
replaceable package PhaseSystem_p | PartialPhaseSystem | Phase system of terminal p | |
replaceable package PhaseSystem_n | PartialPhaseSystem | Phase system of terminal n | |
Real | conversionFactor | Ratio of QS rms voltage on side 2 / QS rms voltage on side 1 | |
Real | eta | Converter efficiency, pLoss = (1-eta) * Ptr | |
Ground | |||
side 1 | |||
Boolean | ground_1 | false | If true, connect side 1 of converter to ground |
side 2 | |||
Boolean | ground_2 | true | If true, connect side 2 of converter to ground |
Connectors
Type | Name | Description |
---|---|---|
replaceable package PhaseSystem_p | Phase system of terminal p | |
replaceable package PhaseSystem_n | Phase system of terminal n | |
Terminal_n | terminal_n | Electric terminal side p |
Terminal_p | terminal_p | Electric terminal side n |
Modelica definition
Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer
AC AC transformer simplified equivalent circuit
Information
This is a simplified equivalent transformer model. The model accounts for winding Joule losses and leakage reactances that are represented by a series of a resistance R and an inductance L. The resistance and the inductance represent both the effects of the secondary and primary side of the transformer.
The model is parameterized using the following parameters
VHigh
- RMS voltage at primary side,VLow
- RMS voltage at secondary side,VABase
- apparent nominal power of the transformer,XoverR
- ratio between reactance and resistance, andZperc
- the short circuit impedance.
Given the nominal conditions,the model computes the values of the resistance and the inductance.
Extends from Buildings.Electrical.Icons.RefAngleConversion (Icon that represents if the angle symble should be displayed or not), Buildings.Electrical.Interfaces.PartialConversion (Model representing a generic two port system for conversion).
Parameters
Type | Name | Default | Description |
---|---|---|---|
replaceable package PhaseSystem_p | PartialPhaseSystem | Phase system of terminal p | |
replaceable package PhaseSystem_n | PartialPhaseSystem | Phase system of terminal n | |
Voltage | VHigh | Rms voltage on side 1 of the transformer (primary side) [V] | |
Voltage | VLow | Rms voltage on side 2 of the transformer (secondary side) [V] | |
ApparentPower | VABase | Nominal power of the transformer [V.A] | |
Real | XoverR | Ratio between the complex and real components of the impedance (XL/R) | |
Real | Zperc | Short circuit impedance | |
Ground | |||
side 1 | |||
Boolean | ground_1 | false | If true, connect side 1 of converter to ground |
side 2 | |||
Boolean | ground_2 | true | If true, connect side 2 of converter to ground |
Initialization | |||
Angle | phi_1 | 0 | Angle of the voltage side 1 at initialization [rad] |
Angle | phi_2 | phi_1 | Angle of the voltage side 2 at initialization [rad] |
Connectors
Type | Name | Description |
---|---|---|
replaceable package PhaseSystem_p | Phase system of terminal p | |
replaceable package PhaseSystem_n | Phase system of terminal n | |
Terminal_n | terminal_n | Electric terminal side p |
Terminal_p | terminal_p | Electric terminal side n |
Modelica definition
Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformerFull
AC AC transformer with detailed equivalent circuit
Information
This is a detailed transformer model that takes into account the winding Joule losses and the leakage reactances on both primary and secondary side. The model also describes the core or iron losses and the losses due to magnetization effects.
The losses are represented by a series of resistances R1, R2, Rm and inductances L1, L2, and Lm.
The model is parameterized using the following parameters
VHigh
- RMS voltage at primary side,VLow
- RMS voltage at secondary side,VABase
- apparent nominal power of the transformer,f
- frequency,R_1, L_1
- resistance and inductance at primary side (per unit),R_2, L_2
- resistance and inductance at secondary side (per unit), andR_m, L_m
- resistance and inductance for magnetization effects (per unit).
Given the nominal conditions, the model computes the values of the nominal impedances at both primary and secondary side. Given these values, the per unit values are transformed into the actual values of the resistances and inductances.
The magnetization losses can be enabled or disabled using the boolean flag magEffects
.
Extends from Buildings.Electrical.Icons.RefAngleConversion (Icon that represents if the angle symble should be displayed or not), Buildings.Electrical.Interfaces.PartialConversion (Model representing a generic two port system for conversion).
Parameters
Type | Name | Default | Description |
---|---|---|---|
replaceable package PhaseSystem_p | PartialPhaseSystem | Phase system of terminal p | |
replaceable package PhaseSystem_n | PartialPhaseSystem | Phase system of terminal n | |
Voltage | VHigh | RMS voltage on side 1 of the transformer (primary side) [V] | |
Voltage | VLow | RMS voltage on side 2 of the transformer (secondary side) [V] | |
ApparentPower | VABase | Nominal power of the transformer [V.A] | |
Frequency | f | Nominal frequency [Hz] | |
PerUnit | R1 | Resistance on side 1 of the transformer (pu) [1] | |
PerUnit | L1 | Inductance on side 1 of the transformer (pu) [1] | |
PerUnit | R2 | Resistance on side 2 of the transformer (pu) [1] | |
PerUnit | L2 | Inductance on side 2 of the transformer (pu) [1] | |
Magnetization | |||
Boolean | magEffects | false | If true, introduce magnetization effects |
PerUnit | Rm | Magnetization resistance (pu) [1] | |
PerUnit | Lm | Magnetization inductance (pu) [1] | |
Ground | |||
side 1 | |||
Boolean | ground_1 | false | Connect side 1 of converter to ground |
side 2 | |||
Boolean | ground_2 | true | Connect side 2 of converter to ground |
Initialization | |||
Angle | phi_1 | 0 | Angle of the voltage side 1 at initialization [rad] |
Angle | phi_2 | phi_1 | Angle of the voltage side 2 at initialization [rad] |
Connectors
Type | Name | Description |
---|---|---|
replaceable package PhaseSystem_p | Phase system of terminal p | |
replaceable package PhaseSystem_n | Phase system of terminal n | |
Terminal_n | terminal_n | Electric terminal side p |
Terminal_p | terminal_p | Electric terminal side n |
Modelica definition
Buildings.Electrical.AC.OnePhase.Conversion.ACDCConverter
AC DC converter
Information
This is an AC/DC converter, based on a power balance between both circuit sides.
The parameter conversionFactor
defines the ratio between the RMS voltages
as
VDC = conversionFactor VAC,
where VDC is the voltage of the DC circuit and VAC is the RMS voltage at the primary side of the transformer.
The loss of the converter is proportional to the power transmitted.
The parameter eta
is the efficiency of the transfer.
The loss is computed as
Ploss = (1-η) Ptr
where Ptr is the power transmitted. The model is bi-directional and the power can flow from both the primary to the secondary side and vice-versa. Furthermore, reactive power on both side are set to 0.
Note:
This model is derived from Modelica.Electrical.QuasiStatic.SinglePhase.Utilities.IdealACDCConverter.
Extends from Buildings.Electrical.Interfaces.PartialConversion (Model representing a generic two port system for conversion).
Parameters
Type | Name | Default | Description |
---|---|---|---|
replaceable package PhaseSystem_p | PartialPhaseSystem | Phase system of terminal p | |
replaceable package PhaseSystem_n | PartialPhaseSystem | Phase system of terminal n | |
Real | conversionFactor | Ratio of DC voltage / AC RMS voltage | |
Real | eta | Converter efficiency, pLoss = (1-eta) * Ptr | |
Ground | |||
AC side | |||
Boolean | ground_AC | false | Connect AC side of converter to ground |
DC side | |||
Boolean | ground_DC | true | Connect DC side of converter to ground |
Connectors
Type | Name | Description |
---|---|---|
replaceable package PhaseSystem_p | Phase system of terminal p | |
replaceable package PhaseSystem_n | Phase system of terminal n | |
Terminal_n | terminal_n | Electric terminal side p |
Terminal_p | terminal_p | Electric terminal side n |