Description: "Package with line models for three-phase balanced AC systems"

- Home > Modelica

## 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
--- | ---
Line | Model of an electrical line
Network | Three phases balanced AC network
TwoPortInductance | Model of an inductance with two electrical ports
TwoPortRL | Model of a resistive-inductive element with two electrical ports
TwoPortRLC | Model of a RLC element with two electrical ports
TwoPortResistance | Model of a resistance with two electrical ports
Examples | Package with example models

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

Model of an electrical 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

Type | Name | Default | Description
--- | --- | --- | ---
Length | l |  | Length of the line [m]
Power | P_nominal |  | Nominal power of the line [W]
Model
Assumptions
Boolean | use_C | false | Set to true to add a capacitance in the center of the line
Load | modelMode | Buildings.Electrical.Types.L... | Select between steady state and dynamic model
Thermal
Boolean | use_T | false | If true, enables the input for the temperature of the cable
Temperature | TCable | T_ref | Fixed temperature of the cable [K]
Tech. specification
Auto/Manual mode
CableMode | mode | Buildings.Electrical.Types.C... | Select if choosing the cable automatically or between a list of commercial options
Manual mode
Generic | commercialCable | Buildings.Electrical.Transmi... | Commercial cables options

### Connectors

Type | Name | Description
--- | --- | ---
input RealInput | T | Temperature 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

Three phases balanced AC 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).

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

Model of an inductance with two electrical ports

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

Type | Name | Default | Description
--- | --- | --- | ---
Inductance | L |  | Inductance [H]
Modelling assumption
Load | mode | Buildings.Electrical.Types.L... | Type of model (e.g., steady state, dynamic, prescribed power consumption, etc.)

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

Model of a resistive-inductive element with two electrical ports

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

Type | Name | Default | Description
--- | --- | --- | ---
Boolean | useHeatPort | false | =true, if HeatPort is enabled
Temperature | T | T_ref | Fixed device temperature if useHeatPort = false [K]
Resistance | R |  | Resistance at temperature T_ref [Ohm]
Temperature | T_ref | 298.15 | Reference temperature [K]
Temperature | M | 507.65 | Temperature constant (R_actual = R*(M + T_heatPort)/(M + T_ref)) [K]
Inductance | L |  | Inductance [H]
Current | i_start[PhaseSystem_p.n] | zeros(PhaseSystem_p.n) | Initial current phasor of the line (positive if entering from terminal p) [A]
Modelling assumption
Load | mode | Buildings.Electrical.Types.L... | Type of model (e.g., steady state, dynamic, prescribed power consumption, etc.)

### Connectors

Type | Name | Description
--- | --- | ---
HeatPort_a | heatPort |

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

Model of a RLC element with two electrical ports

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

Type | Name | Default | Description
--- | --- | --- | ---
Boolean | useHeatPort | false | =true, if HeatPort is enabled
Temperature | T | T_ref | Fixed device temperature if useHeatPort = false [K]
Resistance | R |  | Resistance at temperature T_ref [Ohm]
Temperature | T_ref | 298.15 | Reference temperature [K]
Temperature | M | 507.65 | Temperature constant (R_actual = R*(M + T_heatPort)/(M + T_ref)) [K]
Capacitance | C |  | Capacity [F]
Inductance | L |  | Inductance [H]
Voltage | Vc_start[2] | {V_nominal,0} | Initial voltage phasor of the capacitance located in the middle of the line [V]
Nominal conditions
Voltage | V_nominal | V_nominal(start=110) | Nominal voltage (V_nominal >= 0) [V]
Modelling assumption
Load | mode | Buildings.Electrical.Types.L... | Type of model (e.g., steady state, dynamic, prescribed power consumption, etc.)

### Connectors

Type | Name | Description
--- | --- | ---
HeatPort_a | heatPort |

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

Model of a resistance with two electrical ports

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

Type | Name | Default | Description
--- | --- | --- | ---
Boolean | useHeatPort | false | =true, if HeatPort is enabled
Temperature | T | T_ref | Fixed device temperature if useHeatPort = false [K]
Resistance | R |  | Resistance at temperature T_ref [Ohm]
Temperature | T_ref | 298.15 | Reference temperature [K]
Temperature | M | 507.65 | Temperature constant (R_actual = R*(M + T_heatPort)/(M + T_ref)) [K]

### Connectors

Type | Name | Description
--- | --- | ---
HeatPort_a | heatPort |

### 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;