Buildings.Electrical.AC.ThreePhasesBalanced.Lines

Package with line models for three-phase balanced AC systems

Information

This package contains models for transmission lines and electrical networks.

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

Package Content

Name Description
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Line Line Model of an electrical line
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Network Network Three phases balanced AC network
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortInductance TwoPortInductance Model of an inductance with two electrical ports
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRL TwoPortRL Model of a resistive-inductive element with two electrical ports
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRLC TwoPortRLC Model of a RLC element with two electrical ports
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortResistance TwoPortResistance Model of a resistance with two electrical ports
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Examples Examples Package with example models

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Line Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Line

Model of an electrical line

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Line

Information

This model represents a cable for three-phase balanced AC systems. The model is based on Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRLC and provides functionalities to parametrize the values of R, L and C either using commercial cables or using default values.

See model Buildings.Electrical.AC.OnePhase.Lines.Line for more information.

Extends from Buildings.Electrical.AC.OnePhase.Lines.Line (Model of an electrical line).

Parameters

TypeNameDefaultDescription
Lengthl Length of the line [m]
PowerP_nominal Nominal power of the line [W]
Model
Assumptions
Booleanuse_CfalseSet to true to add a capacitance in the center of the line
LoadmodelModeBuildings.Electrical.Types.L...Select between steady state and dynamic model
Thermal
Booleanuse_TfalseIf true, enables the input for the temperature of the cable
TemperatureTCableT_refFixed temperature of the cable [K]
Tech. specification
Auto/Manual mode
CableModemodeBuildings.Electrical.Types.C...Select if choosing the cable automatically or between a list of commercial options
Manual mode
GenericcommercialCableBuildings.Electrical.Transmi...Commercial cables options

Connectors

TypeNameDescription
Terminal_nterminal_nElectric terminal side p
Terminal_pterminal_pElectric terminal side n
input RealInputTTemperature of the cable

Modelica definition

model Line "Model of an electrical line" extends Buildings.Electrical.AC.OnePhase.Lines.Line( redeclare Interfaces.Terminal_n terminal_n, redeclare Interfaces.Terminal_p terminal_p, V_nominal(start=480), redeclare TwoPortRLC line( R=R, L=L, C=C, V_nominal=V_nominal)); end Line;

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Network Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Network

Three phases balanced AC network

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Network

Information

This model represents a generalized electrical AC three-phase balanced network.

See Buildings.Electrical.Transmission.BaseClasses.PartialNetwork for information about the network model.

See Buildings.Electrical.Transmission.Grids.PartialGrid for more information about the topology of the network, such as the number of nodes, how they are connected, and the length of each connection.

Extends from Buildings.Electrical.Transmission.BaseClasses.PartialNetwork (Partial model that represent an electric network).

Connectors

TypeNameDescription
Terminal_pterminal[grid.nNodes]Electric terminals for each node of the network

Modelica definition

model Network "Three phases balanced AC network" extends Buildings.Electrical.Transmission.BaseClasses.PartialNetwork( V_nominal(start = 480), redeclare Interfaces.Terminal_p terminal, redeclare replaceable Transmission.Grids.TestGrid2Nodes grid, redeclare Lines.Line lines( redeclare replaceable Buildings.Electrical.Transmission.LowVoltageCables.Generic commercialCable=grid.cables)); Modelica.Units.SI.Voltage VAbs[grid.nNodes] "RMS voltage of the grid nodes"; equation for i in 1:grid.nLinks loop connect(lines[i].terminal_p, terminal[grid.fromTo[i,1]]); connect(lines[i].terminal_n, terminal[grid.fromTo[i,2]]); end for; for i in 1:grid.nNodes loop VAbs[i] = Buildings.Electrical.PhaseSystems.OnePhase.systemVoltage(terminal[i].v); end for; end Network;

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortInductance Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortInductance

Model of an inductance with two electrical ports

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortInductance

Information

Inductance that connects two AC three-phase balanced interfaces. This model can be used to represent a cable in a three-phase balanced AC system.

See model Buildings.Electrical.AC.OnePhase.Lines.TwoPortInductance for more information.

Extends from Buildings.Electrical.AC.OnePhase.Lines.TwoPortInductance (Model of an inductive element with two electrical ports).

Parameters

TypeNameDefaultDescription
InductanceL Inductance [H]
Modeling assumption
LoadmodeBuildings.Electrical.Types.L...Type of model (e.g., steady state, dynamic, prescribed power consumption, etc.)

Connectors

TypeNameDescription
Terminal_nterminal_nElectric terminal side p
Terminal_pterminal_pElectric terminal side n

Modelica definition

model TwoPortInductance "Model of an inductance with two electrical ports" extends Buildings.Electrical.AC.OnePhase.Lines.TwoPortInductance( redeclare Interfaces.Terminal_n terminal_n, redeclare Interfaces.Terminal_p terminal_p); end TwoPortInductance;

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRL Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRL

Model of a resistive-inductive element with two electrical ports

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRL

Information

Resistive-inductive impedance that connects two AC three-phase balanced interfaces. This model can be used to represent a cable in a three-phase balanced AC system.

See model Buildings.Electrical.AC.OnePhase.Lines.TwoPortRL for more information.

Extends from Buildings.Electrical.AC.OnePhase.Lines.TwoPortRL (Model of a resistive-inductive element with two electrical ports).

Parameters

TypeNameDefaultDescription
BooleanuseHeatPortfalse= true, if heatPort is enabled
TemperatureTT_refFixed device temperature if useHeatPort = false [K]
ResistanceR Resistance at temperature T_ref [Ohm]
TemperatureT_ref298.15Reference temperature [K]
TemperatureM507.65Temperature constant (R_actual = R*(M + T_heatPort)/(M + T_ref)) [K]
InductanceL Inductance [H]
Currenti_start[PhaseSystem_p.n]zeros(PhaseSystem_p.n)Initial current phasor of the line (positive if entering from terminal p) [A]
Modeling assumption
LoadmodeBuildings.Electrical.Types.L...Type of model (e.g., steady state, dynamic, prescribed power consumption, etc.)

Connectors

TypeNameDescription
Terminal_nterminal_nElectric terminal side p
Terminal_pterminal_pElectric terminal side n
HeatPort_aheatPortConditional heat port

Modelica definition

model TwoPortRL "Model of a resistive-inductive element with two electrical ports" extends Buildings.Electrical.AC.OnePhase.Lines.TwoPortRL( redeclare Interfaces.Terminal_n terminal_n, redeclare Interfaces.Terminal_p terminal_p); end TwoPortRL;

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRLC Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRLC

Model of a RLC element with two electrical ports

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortRLC

Information

RLC impedance that connects two AC three-phase balanced interfaces. This model can be used to represent a cable in a three-phase balanced AC system.

See model Buildings.Electrical.AC.OnePhase.Lines.TwoPortRLC for more information.

Extends from Buildings.Electrical.AC.OnePhase.Lines.TwoPortRLC (Model of an RLC element with two electrical ports).

Parameters

TypeNameDefaultDescription
BooleanuseHeatPortfalse= true, if heatPort is enabled
TemperatureTT_refFixed device temperature if useHeatPort = false [K]
ResistanceR Resistance at temperature T_ref [Ohm]
TemperatureT_ref298.15Reference temperature [K]
TemperatureM507.65Temperature constant (R_actual = R*(M + T_heatPort)/(M + T_ref)) [K]
CapacitanceC Capacity [F]
InductanceL Inductance [H]
VoltageVc_start[2]{V_nominal,0}Initial voltage phasor of the capacitance located in the middle of the line [V]
Nominal conditions
VoltageV_nominalV_nominal(start=110)Nominal voltage (V_nominal >= 0) [V]
Modeling assumption
LoadmodeBuildings.Electrical.Types.L...Type of model (e.g., steady state, dynamic, prescribed power consumption, etc.)

Connectors

TypeNameDescription
Terminal_nterminal_nElectric terminal side p
Terminal_pterminal_pElectric terminal side n
HeatPort_aheatPortConditional heat port

Modelica definition

model TwoPortRLC "Model of a RLC element with two electrical ports" extends Buildings.Electrical.AC.OnePhase.Lines.TwoPortRLC( redeclare Interfaces.Terminal_n terminal_n, redeclare Interfaces.Terminal_p terminal_p); end TwoPortRLC;

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortResistance Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortResistance

Model of a resistance with two electrical ports

Buildings.Electrical.AC.ThreePhasesBalanced.Lines.TwoPortResistance

Information

Resistance that connects two AC three-phase balanced interfaces. This model can be used to represent a cable in a three-phase balanced AC system.

See model Buildings.Electrical.AC.OnePhase.Lines.TwoPortResistance for more information.

Extends from Buildings.Electrical.AC.OnePhase.Lines.TwoPortResistance (Model of a resistance with two electrical ports).

Parameters

TypeNameDefaultDescription
BooleanuseHeatPortfalse= true, if heatPort is enabled
TemperatureTT_refFixed device temperature if useHeatPort = false [K]
ResistanceR Resistance at temperature T_ref [Ohm]
TemperatureT_ref298.15Reference temperature [K]
TemperatureM507.65Temperature constant (R_actual = R*(M + T_heatPort)/(M + T_ref)) [K]

Connectors

TypeNameDescription
Terminal_nterminal_nElectric terminal side p
Terminal_pterminal_pElectric terminal side n
HeatPort_aheatPortConditional heat port

Modelica definition

model TwoPortResistance "Model of a resistance with two electrical ports" extends Buildings.Electrical.AC.OnePhase.Lines.TwoPortResistance( redeclare Interfaces.Terminal_n terminal_n, redeclare Interfaces.Terminal_p terminal_p); end TwoPortResistance;