Library logo

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces

Package with interfaces for three-phase unbalanced AC models

Information

This package contains connectors that are used by the models in the Buildings.Electrical.AC.ThreePhasesUnbalanced package. The connectors extends the basic connectors Buildings.Electrical.Interfaces.Terminal and define a new graphical icon in order to be distinguished by connectors of other electrical systems (e.g. DC systems).

Extends from Modelica.Icons.InterfacesPackage (Icon for packages containing interfaces).

Package Content

Name Description
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Adapter3to3 Adapter3to3 Adapter from 3 single phase connectors to a connector with 3 phases
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_n Connection3to3Ground_n Adapter between Terminal4 (3 phases and ground) and Terminal3 N
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_p Connection3to3Ground_p Adapter between Terminal4 (3 phases and ground) and Terminal3 P
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_n Connection3to4_n Adapter between Terminal4 and Terminal3 N
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_p Connection3to4_p Adapter between Terminal4 and Terminal3 P
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal4_n Terminal4_n Terminal N for AC three-phase unbalanced systems (neutral cable)
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal4_p Terminal4_p Terminal P for AC three-phase unbalanced systems (neutral cable)
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_n Terminal_n Terminal N for AC three-phase unbalanced systems (no neutral cable)
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_p Terminal_p Terminal P for AC three-phase unbalanced systems (no neutral cable)
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort TwoPort Partial model interface for a two port component without neutral cable
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort_N TwoPort_N Partial model interface for a two port component with neutral cable
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToDelta WyeToDelta This model represent a connection between wye to delta
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToWyeGround WyeToWyeGround This model represent a connection between wye to wye grounded
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Examples Examples Package with example models

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Adapter3to3 Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Adapter3to3

Adapter from 3 single phase connectors to a connector with 3 phases

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Adapter3to3

Information

Adapter that connect 3 single phase connectors with a connector that has 3 phases.

Extends from Modelica.Blocks.Icons.Block (Basic graphical layout of input/output block).

Connectors

TypeNameDescription
Terminalterminals[3]Generalized terminal
Terminal_pterminalConnector with 3 lines

Modelica definition

model Adapter3to3 "Adapter from 3 single phase connectors to a connector with 3 phases" extends Modelica.Blocks.Icons.Block; Buildings.Electrical.Interfaces.Terminal terminals[3](redeclare final package PhaseSystem = PhaseSystems.OnePhase) "Generalized terminal"; Interfaces.Terminal_p terminal "Connector with 3 lines"; equation for i in 1:3 loop terminal.phase[i].v = terminals[i].v; terminal.phase[i].i = -terminals[i].i; Connections.branch(terminal.phase[i].theta, terminals[i].theta); terminal.phase[i].theta = terminals[i].theta; end for; end Adapter3to3;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_n Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_n

Adapter between Terminal4 (3 phases and ground) and Terminal3 N

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_n

Information

Adapter between electric connectors type n for AC three-phase unbalanced systems. This adapter connects a connector without neutral cable to a connector without neutral cable.

Connectors

TypeNameDescription
Terminal_nterminal4Connector for side with neutral
Terminal_nground4Connector for neutral
Terminal_nterminal3Connector without neutral

Modelica definition

model Connection3to3Ground_n "Adapter between Terminal4 (3 phases and ground) and Terminal3 N" Terminal_n terminal4 "Connector for side with neutral"; Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n ground4 "Connector for neutral"; Terminal_n terminal3 "Connector without neutral"; equation // Connection branches required to propagate the reference angle Connections.branch(terminal4.phase[1].theta, ground4.theta); terminal4.phase[1].theta = ground4.theta; for i in 1:3 loop Connections.branch(terminal3.phase[i].theta, terminal4.phase[i].theta); terminal3.phase[i].theta = terminal4.phase[i].theta; end for; // KVL and KCL terminal3.phase[1].v[:] = terminal4.phase[1].v[:] - ground4.v[:]; terminal3.phase[2].v[:] = terminal4.phase[2].v[:] - ground4.v[:]; terminal3.phase[3].v[:] = terminal4.phase[3].v[:] - ground4.v[:]; terminal4.phase[1].i[:] + terminal4.phase[2].i[:] = -terminal4.phase[3].i[:] - ground4.i[:]; terminal4.phase[1].i[:] = -terminal3.phase[1].i[:]; terminal4.phase[2].i[:] = -terminal3.phase[2].i[:]; terminal4.phase[3].i[:] = -terminal3.phase[3].i[:]; end Connection3to3Ground_n;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_p Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_p

Adapter between Terminal4 (3 phases and ground) and Terminal3 P

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_p

Information

Adapter between electric connectors type p for AC three-phase unbalanced systems. This adapter connects a connector without neutral cable to a connector without neutral cable.

Connectors

TypeNameDescription
Terminal_pterminal4Connector with neutral
Terminal_pground4Connector for neutral
Terminal_pterminal3Connector without neutral

Modelica definition

model Connection3to3Ground_p "Adapter between Terminal4 (3 phases and ground) and Terminal3 P" Terminal_p terminal4 "Connector with neutral"; Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_p ground4 "Connector for neutral"; Terminal_p terminal3 "Connector without neutral"; equation // Connection branches required to propagate the reference angle Connections.branch(terminal4.phase[1].theta, ground4.theta); terminal4.phase[1].theta = ground4.theta; for i in 1:3 loop Connections.branch(terminal3.phase[i].theta, terminal4.phase[i].theta); terminal3.phase[i].theta = terminal4.phase[i].theta; end for; // KVL and KCL terminal3.phase[1].v[:] = terminal4.phase[1].v[:] - ground4.v[:]; terminal3.phase[2].v[:] = terminal4.phase[2].v[:] - ground4.v[:]; terminal3.phase[3].v[:] = terminal4.phase[3].v[:] - ground4.v[:]; terminal4.phase[1].i[:] + terminal4.phase[2].i[:] = -terminal4.phase[3].i[:] - ground4.i[:]; terminal4.phase[1].i[:] = -terminal3.phase[1].i[:]; terminal4.phase[2].i[:] = -terminal3.phase[2].i[:]; terminal4.phase[3].i[:] = -terminal3.phase[3].i[:]; end Connection3to3Ground_p;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_n Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_n

Adapter between Terminal4 and Terminal3 N

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_n

Information

Adapter between electric connectors type n for AC three-phase unbalanced systems. This adapter connects a connector without neutral cable with a one that has it

Connectors

TypeNameDescription
Terminal4_nterminal4Connector with neutral
Terminal_nterminal3Connector without neutral

Modelica definition

model Connection3to4_n "Adapter between Terminal4 and Terminal3 N" Terminal4_n terminal4 "Connector with neutral"; Terminal_n terminal3 "Connector without neutral"; equation // Connection branches required to propagate the reference angle Connections.branch(terminal4.phase[1].theta, terminal4.phase[4].theta); terminal4.phase[1].theta = terminal4.phase[4].theta; for i in 1:3 loop Connections.branch(terminal3.phase[i].theta, terminal4.phase[i].theta); terminal3.phase[i].theta = terminal4.phase[i].theta; end for; // KVL and KCL terminal3.phase[1].v[:] = terminal4.phase[1].v[:] - terminal4.phase[4].v[:]; terminal3.phase[2].v[:] = terminal4.phase[2].v[:] - terminal4.phase[4].v[:]; terminal3.phase[3].v[:] = terminal4.phase[3].v[:] - terminal4.phase[4].v[:]; terminal4.phase[1].i[:] + terminal4.phase[2].i[:] = -terminal4.phase[3].i[:] - terminal4.phase[4].i[:]; terminal4.phase[1].i[:] = -terminal3.phase[1].i[:]; terminal4.phase[2].i[:] = -terminal3.phase[2].i[:]; terminal4.phase[3].i[:] = -terminal3.phase[3].i[:]; end Connection3to4_n;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_p Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_p

Adapter between Terminal4 and Terminal3 P

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_p

Information

Adapter between electric connectors type p for AC three-phase unbalanced systems. This adapter connects two connectors without and without a neutral cable.

Connectors

TypeNameDescription
Terminal4_pterminal4Connector with neutral
Terminal_pterminal3Connector without neutral

Modelica definition

model Connection3to4_p "Adapter between Terminal4 and Terminal3 P" Terminal4_p terminal4 "Connector with neutral"; Terminal_p terminal3 "Connector without neutral"; equation // Connection branches required to propagate the reference angle Connections.branch(terminal4.phase[1].theta, terminal4.phase[4].theta); terminal4.phase[1].theta = terminal4.phase[4].theta; for i in 1:3 loop Connections.branch(terminal3.phase[i].theta, terminal4.phase[i].theta); terminal3.phase[i].theta = terminal4.phase[i].theta; end for; // KVL and KCL terminal3.phase[1].v[:] = terminal4.phase[1].v[:] - terminal4.phase[4].v[:]; terminal3.phase[2].v[:] = terminal4.phase[2].v[:] - terminal4.phase[4].v[:]; terminal3.phase[3].v[:] = terminal4.phase[3].v[:] - terminal4.phase[4].v[:]; terminal4.phase[1].i[:] + terminal4.phase[2].i[:] = -terminal4.phase[3].i[:] - terminal4.phase[4].i[:]; terminal4.phase[1].i[:] = -terminal3.phase[1].i[:]; terminal4.phase[2].i[:] = -terminal3.phase[2].i[:]; terminal4.phase[3].i[:] = -terminal3.phase[3].i[:]; end Connection3to4_p;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal4_n Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal4_n

Terminal N for AC three-phase unbalanced systems (neutral cable)

Information

Electric connector type n for AC three-phase unbalanced systems with neutral cable connection.

Contents

TypeNameDescription
Terminal_nphase[4] 

Modelica definition

connector Terminal4_n "Terminal N for AC three-phase unbalanced systems (neutral cable)" Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n phase[4]; end Terminal4_n;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal4_p Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal4_p

Terminal P for AC three-phase unbalanced systems (neutral cable)

Information

Electric connector type p for AC three-phase unbalanced systems with neutral cable connection.

Contents

TypeNameDescription
Terminal_pphase[4]Terminal with 3 phases and neutral cable

Modelica definition

connector Terminal4_p "Terminal P for AC three-phase unbalanced systems (neutral cable)" Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_p phase[4] "Terminal with 3 phases and neutral cable"; end Terminal4_p;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_n Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_n

Terminal N for AC three-phase unbalanced systems (no neutral cable)

Information

Electric connector type n for AC three-phase unbalanced systems.

Contents

TypeNameDescription
Terminal_nphase[3] 

Modelica definition

connector Terminal_n "Terminal N for AC three-phase unbalanced systems (no neutral cable)" Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n phase[3]; end Terminal_n;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_p Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_p

Terminal P for AC three-phase unbalanced systems (no neutral cable)

Information

Electric connector type p for AC three-phase unbalanced systems.

Contents

TypeNameDescription
Terminal_pphase[3] 

Modelica definition

connector Terminal_p "Terminal P for AC three-phase unbalanced systems (no neutral cable)" Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_p phase[3]; end Terminal_p;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort

Partial model interface for a two port component without neutral cable

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort

Information

Interface model for an AC three-phase unbalanced component with two ports and without neutral cable.

Connectors

TypeNameDescription
Terminal_pterminal_pElectric terminal side p
Terminal_nterminal_nElectric terminal side n

Modelica definition

partial model TwoPort "Partial model interface for a two port component without neutral cable" Terminal_p terminal_p "Electric terminal side p"; Terminal_n terminal_n "Electric terminal side n"; end TwoPort;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort_N Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort_N

Partial model interface for a two port component with neutral cable

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.TwoPort_N

Information

Interface model for an AC three-phase unbalanced component with two ports and with neutral cable.

Connectors

TypeNameDescription
Terminal4_pterminal_pElectric terminal side p
Terminal4_nterminal_nElectric terminal side n

Modelica definition

partial model TwoPort_N "Partial model interface for a two port component with neutral cable" Terminal4_p terminal_p "Electric terminal side p"; Terminal4_n terminal_n "Electric terminal side n"; end TwoPort_N;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToDelta Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToDelta

This model represent a connection between wye to delta

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToDelta

Information

Adapter from Wye (Y) to Delta (D) connector. A three-phase unbalanced connector has three AC single phase connectors. Each AC single phase connector contains the phase voltage, which is measured between the phase and the neutral. This model converts the phase voltage to the line voltage, measured between the phases.

The image below show how the phasors are computed when converting from Y to D.

image

Connectors

TypeNameDescription
Terminal_nwyeTerminal Y
Terminal_ndeltaTerminal D

Modelica definition

model WyeToDelta "This model represent a connection between wye to delta" Terminal_n wye "Terminal Y"; Terminal_n delta "Terminal D"; equation for i in 1:3 loop Connections.branch(wye.phase[i].theta, delta.phase[i].theta); wye.phase[i].theta = delta.phase[i].theta; end for; delta.phase[1].v[:] = wye.phase[1].v[:] - wye.phase[2].v[:]; delta.phase[2].v[:] = wye.phase[2].v[:] - wye.phase[3].v[:]; delta.phase[3].v[:] = wye.phase[3].v[:] - wye.phase[1].v[:]; -wye.phase[1].i[:] + delta.phase[3].i[:] = delta.phase[1].i[:]; -wye.phase[2].i[:] + delta.phase[1].i[:] = delta.phase[2].i[:]; -wye.phase[3].i[:] + delta.phase[2].i[:] = delta.phase[3].i[:]; end WyeToDelta;

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToWyeGround Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToWyeGround

This model represent a connection between wye to wye grounded

Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToWyeGround

Information

Adapter from wye (Y) to wye grounded (Yg) connector. A three-phase unbalanced connector has three AC single phase connectors. Each AC single phase connector contains a the phase voltage, which is measured between the phase and the neutral. This model assures that the voltage of the neutral cable is equal to zero.

Connectors

TypeNameDescription
Terminal_nwyeTerminal Y
Terminal_nwyegTerminal Y with ground connection

Modelica definition

model WyeToWyeGround "This model represent a connection between wye to wye grounded" Terminal_n wye "Terminal Y"; Terminal_n wyeg "Terminal Y with ground connection"; Connection3to3Ground_n connection3to4 "Adapter between Termina3 and Terminal4"; Buildings.Electrical.AC.OnePhase.Basics.Ground ground "Ground reference"; equation connect(wye, connection3to4.terminal3); connect(connection3to4.terminal4, wyeg); connect(connection3to4.ground4, ground.terminal); end WyeToWyeGround;