Description: "Package with converter and transformer models for three-phase unbalanced AC systems"

- Home > Modelica

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion

Package with converter and transformer models for three-phase unbalanced AC systems

### Information

This package contains models that represent different types of three phases unbalanced AC/AC transformers and AC/DC converters.

Extends from Modelica.Icons.Package (Icon for standard packages).

### Package Content

Name | Description
--- | ---
ACACConverter | AC AC converter single phase systems (YY)
ACACTransformer | AC AC transformer simplified equivalent circuit (YY)
ACACTransformerDD | AC AC transformer simplified equivalent circuit (DD)
ACACTransformerFull | AC AC transformer detailed equivalent circuit (YY)
ACACTransformerStepDownDY | AC AC transformer simplified equivalent circuit (DY step down)
ACACTransformerStepDownYD | AC AC transformer simplified equivalent circuit (YD step down)
ACACTransformerStepUpDY | AC AC transformer simplified equivalent circuit (DY step up)
ACACTransformerStepUpYD | AC AC transformer simplified equivalent circuit (YD step up)
Examples | Package with example models
BaseClasses | Package with base class models

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACConverter

AC AC converter single phase systems (YY)

### Information

This is an AC AC converter, based on a power balance between both circuit sides. The paramater conversionFactor defines the ratio between the RMS voltages

V2 = conversionFactor * V1

where V1 and V2 are the RMS voltages at the primary and secondary sides of the transformer (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 both the primary to the secondary and vice-versa. Furthermore, reactive power on both side are set to 0.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACConverter.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY (Model of a transformer with Y connection primary side and Y connection secondary side).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 | Connect side 1 of converter to ground
side 2
Boolean | ground_2 | true | Connect side 2 of converter to ground

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACConverter "AC AC converter single phase systems (YY)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACConverter conv1( conversionFactor=conversionFactor, eta=eta, ground_1=ground_1, ground_2=ground_2), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACConverter conv2( conversionFactor=conversionFactor, eta=eta, ground_1=ground_1, ground_2=ground_2), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACConverter conv3( conversionFactor=conversionFactor, eta=eta, ground_1=ground_1, ground_2=ground_2)); parameter Real conversionFactor "Ratio of QS rms voltage on side 2 / QS rms voltage on side 1"; parameter Real eta(min=0, max=1) "Converter efficiency, pLoss = (1-eta) * Ptr"; parameter Boolean ground_1 = false "Connect side 1 of converter to ground"; parameter Boolean ground_2 = true "Connect side 2 of converter to ground"; end ACACConverter;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACTransformer

AC AC transformer simplified equivalent circuit (YY)

### 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, and
- `Zperc` - the short circuit impedance.

Given the nominal conditions, the model computes the values of the resistance and inductance.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY (Model of a transformer with Y connection primary side and Y connection secondary side).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 [VA]
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 | Connect side 1 of transformer to ground
side 2
Boolean | ground_2 | true | Connect side 2 of transformer to ground

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACTransformer "AC AC transformer simplified equivalent circuit (YY)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv1( VHigh=VHigh/sqrt(3), VLow=VLow/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, phi_1=0), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv2( VHigh=VHigh/sqrt(3), VLow=VLow/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, phi_1=-2.0943951023932), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv3( VHigh=VHigh/sqrt(3), VLow=VLow/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, phi_1=2.0943951023932)); parameter Modelica.SIunits.Voltage VHigh "Rms voltage on side 1 of the transformer (primary side)"; parameter Modelica.SIunits.Voltage VLow "Rms voltage on side 2 of the transformer (secondary side)"; parameter Modelica.SIunits.ApparentPower VABase "Nominal power of the transformer"; parameter Real XoverR "Ratio between the complex and real components of the impedance (XL/R)"; parameter Real Zperc "Short circuit impedance"; parameter Boolean ground_1 = false "Connect side 1 of transformer to ground"; parameter Boolean ground_2 = true "Connect side 2 of transformer to ground"; equation end ACACTransformer;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACTransformerDD

AC AC transformer simplified equivalent circuit (DD)

### Information

This is a simplified equivalent transformer model with Delta-Delta connection. 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 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, and
- `Zperc` - the short circuit impedance.

Given the nominal conditions, the model computes the values of the resistance and inductance.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterDD for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterDD (Model of a transformer with D connection primary side and D connection secondary side).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 [VA]
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 | Connect side 1 of transformer to ground
side 2
Boolean | ground_2 | true | Connect side 2 of transformer to ground

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACTransformerDD "AC AC transformer simplified equivalent circuit (DD)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterDD ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv1( XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VHigh=VHigh, VLow=VLow, phi_1=0.5235987755983), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv2( XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VHigh=VHigh, VLow=VLow, phi_1=-1.5707963267949), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv3( XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VHigh=VHigh, VLow=VLow, phi_1=2.6179938779915)); parameter Modelica.SIunits.Voltage VHigh "Rms voltage on side 1 of the transformer (primary side)"; parameter Modelica.SIunits.Voltage VLow "Rms voltage on side 2 of the transformer (secondary side)"; parameter Modelica.SIunits.ApparentPower VABase "Nominal power of the transformer"; parameter Real XoverR "Ratio between the complex and real components of the impedance (XL/R)"; parameter Real Zperc "Short circuit impedance"; parameter Boolean ground_1 = false "Connect side 1 of transformer to ground"; parameter Boolean ground_2 = true "Connect side 2 of transformer to ground"; equation end ACACTransformerDD;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACTransformerFull

AC AC transformer detailed equivalent circuit (YY)

### Information

This is a detailed transformer model that takes into accounts the winding Joule losses, and the leakage reactances on the primary and secondary side. The model also takes into account 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), and
- `R_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 the primary and secondary side. Given these values, the per unit values are transformed into the actual values of the resistances and inductancs.

The magnetization losses can be enabled or disabled using the boolean flag `magEffects`.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformerFull.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY (Model of a transformer with Y connection primary side and Y connection secondary side).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 [VA]
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

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACTransformerFull "AC AC transformer detailed equivalent circuit (YY)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterYY ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformerFull conv1( VHigh=VHigh/sqrt(3), VLow=VLow/sqrt(3), f = f, VABase=VABase, R1=R1,L1=L1,R2=R2,L2=L2, magEffects=magEffects, Rm=Rm,Lm=Lm, ground_1=ground_1, ground_2=ground_2), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformerFull conv2( VHigh=VHigh/sqrt(3), VLow=VLow/sqrt(3), f = f, VABase=VABase, R1=R1,L1=L1,R2=R2,L2=L2, magEffects=magEffects, Rm=Rm,Lm=Lm, ground_1=ground_1, ground_2=ground_2), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformerFull conv3( VHigh=VHigh/sqrt(3), VLow=VLow/sqrt(3), f = f, VABase=VABase, R1=R1,L1=L1,R2=R2,L2=L2, magEffects=magEffects, Rm=Rm,Lm=Lm, ground_1=ground_1, ground_2=ground_2)); parameter Modelica.SIunits.Voltage VHigh "Rms voltage on side 1 of the transformer (primary side)"; parameter Modelica.SIunits.Voltage VLow "Rms voltage on side 2 of the transformer (secondary side)"; parameter Modelica.SIunits.ApparentPower VABase "Nominal power of the transformer"; parameter Modelica.SIunits.Frequency f(start=60) "Nominal frequency"; parameter Buildings.Electrical.Types.PerUnit R1(min=0) "Resistance on side 1 of the transformer (pu)"; parameter Buildings.Electrical.Types.PerUnit L1(min=0) "Inductance on side 1 of the transformer (pu)"; parameter Buildings.Electrical.Types.PerUnit R2(min=0) "Resistance on side 2 of the transformer (pu)"; parameter Buildings.Electrical.Types.PerUnit L2(min=0) "Inductance on side 2 of the transformer (pu)"; parameter Boolean magEffects = false "If =true introduce magnetization effects"; parameter Buildings.Electrical.Types.PerUnit Rm(min=0,start=0) "Magnetization resistance (pu)"; parameter Buildings.Electrical.Types.PerUnit Lm(min=0,start=0) "Magnetization inductance (pu)"; parameter Boolean ground_1 = false "Connect side 1 of converter to ground"; parameter Boolean ground_2 = true "Connect side 2 of converter to ground"; end ACACTransformerFull;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACTransformerStepDownDY

AC AC transformer simplified equivalent circuit (DY step down)

### Information

This is a simplified equivalent transformer model with Y-Delta connection (voltage step down). 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 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, and
- `Zperc` - the short circuit impedance.

Given the nominal conditions, the model computes the values of the resistance and inductance.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepDownDY for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepDownDY (Model of a transformer with D connection primary side and Y connection secondary side (Voltage step down)).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 [VA]
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 | Connect side 1 of transformer to ground
side 2
Boolean | ground_2 | true | Connect side 2 of transformer to ground

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACTransformerStepDownDY "AC AC transformer simplified equivalent circuit (DY step down)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepDownDY ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv1( VHigh=VHigh, XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=-VLow/sqrt(3), phi_1=2.6179938779915), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv2( VHigh=VHigh, XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=-VLow/sqrt(3), phi_1=0.5235987755983), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv3( VHigh=VHigh, XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=-VLow/sqrt(3), phi_1=-1.5707963267949)); parameter Modelica.SIunits.Voltage VHigh "Rms voltage on side 1 of the transformer (primary side)"; parameter Modelica.SIunits.Voltage VLow "Rms voltage on side 2 of the transformer (secondary side)"; parameter Modelica.SIunits.ApparentPower VABase "Nominal power of the transformer"; parameter Real XoverR "Ratio between the complex and real components of the impedance (XL/R)"; parameter Real Zperc "Short circuit impedance"; parameter Boolean ground_1 = false "Connect side 1 of transformer to ground"; parameter Boolean ground_2 = true "Connect side 2 of transformer to ground"; equation end ACACTransformerStepDownDY;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACTransformerStepDownYD

AC AC transformer simplified equivalent circuit (YD step down)

### Information

This is a simplified equivalent transformer model with Y-Delta connection (voltage step down). 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 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, and
- `Zperc` - the short circuit impedance.

Given the nominal conditions, the model computes the values of the resistance and inductance.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepDownYD for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepDownYD (Model of a transformer with Y connection primary side and D connection secondary side (Voltage step down)).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 [VA]
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 | Connect side 1 of transformer to ground
side 2
Boolean | ground_2 | true | Connect side 2 of transformer to ground

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACTransformerStepDownYD "AC AC transformer simplified equivalent circuit (YD step down)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepDownYD ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv1( VHigh=VHigh/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=VLow, phi_1=0), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv2( VHigh=VHigh/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=VLow, phi_1=-2.0943951023932), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv3( VHigh=VHigh/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=VLow, phi_1=2.0943951023932)); parameter Modelica.SIunits.Voltage VHigh "Rms voltage on side 1 of the transformer (primary side)"; parameter Modelica.SIunits.Voltage VLow "Rms voltage on side 2 of the transformer (secondary side)"; parameter Modelica.SIunits.ApparentPower VABase "Nominal power of the transformer"; parameter Real XoverR "Ratio between the complex and real components of the impedance (XL/R)"; parameter Real Zperc "Short circuit impedance"; parameter Boolean ground_1 = false "Connect side 1 of transformer to ground"; parameter Boolean ground_2 = true "Connect side 2 of transformer to ground"; equation end ACACTransformerStepDownYD;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACTransformerStepUpDY

AC AC transformer simplified equivalent circuit (DY step up)

### Information

This is a simplified equivalent transformer model with Delta-Y connection (voltage step up). 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 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, and
- `Zperc` - the short circuit impedance.

Given the nominal conditions, the model computes the values of the resistance and inductance.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepUpDY for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepUpDY (Model of a transformer with D connection primary side and Y connection secondary side (Voltage step up)).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 [VA]
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 | Connect side 1 of transformer to ground
side 2
Boolean | ground_2 | true | Connect side 2 of transformer to ground

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACTransformerStepUpDY "AC AC transformer simplified equivalent circuit (DY step up)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepUpDY ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv1( VHigh=VHigh, XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=VLow/sqrt(3), phi_1=0.5235987755983), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv2( VHigh=VHigh, XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=VLow/sqrt(3), phi_1=-1.5707963267949), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv3( VHigh=VHigh, XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=VLow/sqrt(3), phi_1=2.6179938779915)); parameter Modelica.SIunits.Voltage VHigh "Rms voltage on side 1 of the transformer (primary side)"; parameter Modelica.SIunits.Voltage VLow "Rms voltage on side 2 of the transformer (secondary side)"; parameter Modelica.SIunits.ApparentPower VABase "Nominal power of the transformer"; parameter Real XoverR "Ratio between the complex and real components of the impedance (XL/R)"; parameter Real Zperc "Short circuit impedance"; parameter Boolean ground_1 = false "Connect side 1 of transformer to ground"; parameter Boolean ground_2 = true "Connect side 2 of transformer to ground"; equation end ACACTransformerStepUpDY;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.ACACTransformerStepUpYD

AC AC transformer simplified equivalent circuit (YD step up)

### Information

This is a simplified equivalent transformer model with Y-Delta connection (voltage step up). 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 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, and
- `Zperc` - the short circuit impedance.

Given the nominal conditions, the model computes the values of the resistance and inductance.

#### Configuration:

The image below describes the connection of the windings.

#### Note:

This model reuses models from Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer.

See Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepUpYD for details on the connections.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepUpYD (Model of a transformer with Y connection primary side and D connection secondary side (Voltage step up)).

### Parameters

Type | Name | Default | Description
--- | --- | --- | ---
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 [VA]
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 | Connect side 1 of transformer to ground
side 2
Boolean | ground_2 | true | Connect side 2 of transformer to ground

### Connectors

Type | Name | Description
--- | --- | ---
Terminal_n | terminal_n | Electrical connector side N
Terminal_p | terminal_p | Electrical connector side P

### Modelica definition

model ACACTransformerStepUpYD "AC AC transformer simplified equivalent circuit (YD step up)" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Conversion.BaseClasses.PartialConverterStepUpYD ( redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv1( VHigh=VHigh/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=-VLow, phi_1=0), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv2( VHigh=VHigh/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=-VLow, phi_1=-2.0943951023932), redeclare Buildings.Electrical.AC.OnePhase.Conversion.ACACTransformer conv3( VHigh=VHigh/sqrt(3), XoverR=XoverR, Zperc=Zperc, ground_1=ground_1, ground_2=ground_2, VABase=VABase/3, VLow=-VLow, phi_1=2.0943951023932)); parameter Modelica.SIunits.Voltage VHigh "Rms voltage on side 1 of the transformer (primary side)"; parameter Modelica.SIunits.Voltage VLow "Rms voltage on side 2 of the transformer (secondary side)"; parameter Modelica.SIunits.ApparentPower VABase "Nominal power of the transformer"; parameter Real XoverR "Ratio between the complex and real components of the impedance (XL/R)"; parameter Real Zperc "Short circuit impedance"; parameter Boolean ground_1 = false "Connect side 1 of transformer to ground"; parameter Boolean ground_2 = true "Connect side 2 of transformer to ground"; equation end ACACTransformerStepUpYD;