modelACACTransformerFull

AC AC transformer with detailed equivalent circuit

Extends from BuildingSystems.Electrical.Icons.RefAngleConversion (Icon that represents if the angle symble should be displayed or not), BuildingSystems.Electrical.Interfaces.PartialConversion (Model representing a generic two port system for conversion).

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 R₁, R₂, R_m and inductances L₁, L₂, and L_m.

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 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.

Parameters

Type	Name	Default	Description
Modelica.Units.SI.Voltage	VHigh		RMS voltage on side 1 of the transformer (primary side)
Modelica.Units.SI.Voltage	VLow		RMS voltage on side 2 of the transformer (secondary side)
Modelica.Units.SI.ApparentPower	VABase		Nominal power of the transformer
Modelica.Units.SI.Frequency	f		Nominal frequency
BuildingSystems.Electrical.Types.PerUnit	R1		Resistance on side 1 of the transformer (pu)
BuildingSystems.Electrical.Types.PerUnit	L1		Inductance on side 1 of the transformer (pu)
BuildingSystems.Electrical.Types.PerUnit	R2		Resistance on side 2 of the transformer (pu)
BuildingSystems.Electrical.Types.PerUnit	L2		Inductance on side 2 of the transformer (pu)
Magnetization
Boolean	magEffects	false	If true, introduce magnetization effects
BuildingSystems.Electrical.Types.PerUnit	Rm		Magnetization resistance (pu)
BuildingSystems.Electrical.Types.PerUnit	Lm		Magnetization inductance (pu)
Ground › side 1
Boolean	ground_1	false	Connect side 1 of converter to ground
Ground › side 2
Boolean	ground_2	true	Connect side 2 of converter to ground
Initialization
Modelica.Units.SI.Angle	phi_1	0	Angle of the voltage side 1 at initialization
Modelica.Units.SI.Angle	phi_2	phi_1	Angle of the voltage side 2 at initialization

Connectors

Type	Name	Default	Description
BuildingSystems.Electrical.Interfaces.BaseTerminal	terminal_n (from PartialBaseTwoPort)		Electric terminal side p
BuildingSystems.Electrical.Interfaces.BaseTerminal	terminal_p (from PartialBaseTwoPort)		Electric terminal side n

Components

Type	Name	Description
Modelica.Units.SI.Voltage	v_p (from PartialConversion)	Voltage drop between the two positive pins
Modelica.Units.SI.Voltage	v_n (from PartialConversion)	Voltage drop between the two negative pins
Modelica.Units.SI.Current	i_p (from PartialConversion)	Current flowing through the positive pins
Modelica.Units.SI.Current	i_n (from PartialConversion)	Current flowing through the negative pins
Modelica.Units.SI.Efficiency	eta	Efficiency
Modelica.Units.SI.Power[2]	PLoss	Loss power
Modelica.Units.SI.Voltage[2]	V1	Voltage at the winding - primary side
Modelica.Units.SI.Voltage[2]	V2	Voltage at the winding - secondary side

Revisions

January 30, 2019, by Michael Wetter:
Added missing replaceable for the terminal.
November 28, 2016, by Michael Wetter:
Made voltage public to allow setting a start value.
This is for #584.
May 26, 2016, by Michael Wetter:
Moved function call to PhaseSystem.thetaRef out of derivative operator as this is not yet supported by JModelica.
September 4, 2014, by Michael Wetter:
Revised model.
August 5, 2014, by Marco Bonvini:
Revised documentation.
June 17, 2014, by Marco Bonvini:
Adde parameter phi_1 and phi_2 that are used during initialization to specify the angle of the voltage phasor.
June 9, 2014, by Marco Bonvini:
Revised implementation and added stateSelect statement to use the current i[:] on the connectors as iteration variable for the initialization problem.
January 29, 2012, by Thierry S. Nouidui:
First implementation.