Package with example models
Information
This package contains examples for the use of models that can be found in
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.
Extends from Modelica.Icons.ExamplesPackage (Icon for packages containing runnable examples).
Package Content
| Name |
Description |
 ACLine
|
Test model for single phase lines that use commercial cables |
| ACLineMedium
|
Test model for a single phase line that uses medium voltage commercial cable information |
| ACLine_L
|
Test model for single phase inductive lines |
| ACLine_R
|
Test model for single phase resistive lines |
| ACLine_RL
|
Test model for single phase inductive-resistive lines |
| ACSimpleGrid
|
Test model for a network model |
| ACSimpleGridMedium
|
Test model for a network model with medium voltage |
Test model for single phase lines that use commercial cables
Information
This example demonstrates how to use a line model to connect
a source to a load that uses commercial cables.
The model has four different loads. The load sc_load represents
a short circuit R=0. The current that flows through the load depends
on the impedance of the line.
The remaining three loads R1, R2, and R3
are resistive loads. Each load is connected to the source with different configurations.
However, the equivalent impedance between each load and the source is the same.
Since the equivalent impedances are the same, each load draws the same current.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Modelica definition
model ACLine
extends Modelica.Icons.Example;
ThreePhasesBalanced.Sources.FixedVoltage E(
definiteReference=true,
f=60,
V=480) ;
ThreePhasesBalanced.Loads.Impedance R1(R=10) ;
ThreePhasesBalanced.Lines.Line line_1(
P_nominal=5000,
l=2000,
mode=Types.CableMode.commercial,
commercialCable=
Transmission.LowVoltageCables.Cu50(),
V_nominal=480) ;
ThreePhasesBalanced.Lines.Line line_2a(
P_nominal=5000,
mode=Types.CableMode.commercial,
commercialCable=
Transmission.LowVoltageCables.Cu50(),
l=1000,
V_nominal=480) ;
ThreePhasesBalanced.Loads.Impedance R2(R=10) ;
ThreePhasesBalanced.Lines.Line line_2b(
P_nominal=5000,
mode=Types.CableMode.commercial,
commercialCable=
Transmission.LowVoltageCables.Cu50(),
l=1000,
V_nominal=480) ;
ThreePhasesBalanced.Lines.Line line_3a(
P_nominal=5000,
mode=Types.CableMode.commercial,
commercialCable=
Transmission.LowVoltageCables.Cu50(),
l=4000,
V_nominal=480) ;
ThreePhasesBalanced.Lines.Line line_3b(
P_nominal=5000,
mode=Types.CableMode.commercial,
commercialCable=
Transmission.LowVoltageCables.Cu50(),
l=4000,
V_nominal=480) ;
ThreePhasesBalanced.Loads.Impedance R3(R=10) ;
ThreePhasesBalanced.Lines.Line line_sc(
P_nominal=5000,
l=2000,
mode=Types.CableMode.commercial,
commercialCable=
Transmission.LowVoltageCables.Cu50(),
V_nominal=480) ;
ThreePhasesBalanced.Loads.Impedance load_sc(R=0) ;
equation
connect(line_1.terminal_p, R1.terminal);
connect(E.terminal, line_1.terminal_n);
connect(E.terminal, line_2a.terminal_n);
connect(line_2a.terminal_p, line_2b.terminal_n);
connect(line_2b.terminal_p, R2.terminal);
connect(line_3a.terminal_p, R3.terminal);
connect(line_3b.terminal_p, R3.terminal);
connect(E.terminal, line_3a.terminal_n);
connect(E.terminal, line_3b.terminal_n);
connect(line_sc.terminal_p, load_sc.terminal);
connect(E.terminal, line_sc.terminal_n);
end ACLine;
Test model for a single phase line that uses medium voltage commercial cable information
Information
This example demonstrates how to use a line model to connect
a source to a load that uses medium voltage commercial cable information.
The model has four different loads. The load sc_load represents
a short circuit R=0. The current that flows through the load depends
on the impedance of the line.
The remaining three loads R1, R2, and R3
are resistive loads. Each load is connected to the source with different configurations,
however the equivalent impedance between each load and the source is the same.
Since the equivalent impedances are the same, each load draws the same current.
Note:
ThreePhasesBalanced.Lines.Line
line_1(
V_nominal=220,
P_nominal=5000,
l=2000,
redeclare
Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable =
Buildings.Electrical.Transmission.MediumVoltageCables.Annealed_Al_10
())
"Resistive line that connects to load 1"
The code snippet shows how a line model line_1 redeclared its
record type in order to be Buildings.Electrical.Transmission.MediumVoltageCables.Generic.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Modelica definition
model ACLineMedium
extends Modelica.Icons.Example;
ThreePhasesBalanced.Sources.FixedVoltage E(
definiteReference=true,
V=15000,
f=60) ;
ThreePhasesBalanced.Loads.Impedance R1(R=10) ;
ThreePhasesBalanced.Lines.Line line_1(
P_nominal=5000,
l=2000,
redeclare Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable=
Buildings.Electrical.Transmission.MediumVoltageCables.Annealed_Al_10(),
V_nominal=15000) ;
ThreePhasesBalanced.Lines.Line line_2a(
P_nominal=5000,
l=1000,
redeclare Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable=
Buildings.Electrical.Transmission.MediumVoltageCables.Annealed_Al_10(),
V_nominal=15000) ;
ThreePhasesBalanced.Loads.Impedance R2(R=10) ;
ThreePhasesBalanced.Lines.Line line_2b(
P_nominal=5000,
l=1000,
redeclare Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable=
Buildings.Electrical.Transmission.MediumVoltageCables.Annealed_Al_10(),
V_nominal=15000) ;
ThreePhasesBalanced.Lines.Line line_3a(
P_nominal=5000,
l=4000,
redeclare Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable=
Buildings.Electrical.Transmission.MediumVoltageCables.Annealed_Al_10(),
V_nominal=15000) ;
ThreePhasesBalanced.Lines.Line line_3b(
P_nominal=5000,
l=4000,
redeclare Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable=
Buildings.Electrical.Transmission.MediumVoltageCables.Annealed_Al_10(),
V_nominal=15000) ;
ThreePhasesBalanced.Loads.Impedance R3(R=10) ;
ThreePhasesBalanced.Lines.Line line_sc(
P_nominal=5000,
l=2000,
redeclare Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable=
Buildings.Electrical.Transmission.MediumVoltageCables.Annealed_Al_10(),
V_nominal=15000) ;
ThreePhasesBalanced.Loads.Impedance load_sc(R=0) ;
equation
connect(line_1.terminal_p, R1.terminal);
connect(E.terminal, line_1.terminal_n);
connect(E.terminal, line_2a.terminal_n);
connect(line_2a.terminal_p, line_2b.terminal_n);
connect(line_2b.terminal_p, R2.terminal);
connect(line_3a.terminal_p, R3.terminal);
connect(line_3b.terminal_p, R3.terminal);
connect(E.terminal, line_3a.terminal_n);
connect(E.terminal, line_3b.terminal_n);
connect(line_sc.terminal_p, load_sc.terminal);
connect(E.terminal, line_sc.terminal_n);
end ACLineMedium;
Test model for single phase inductive lines
Information
This example demonstrates how to use a purely inductive line model to connect
a source to a load.
The model has four different loads. The load sc_load represents
a short circuit R=0. The current that flows through the load depends
on the inductance of the line.
The remaining three loads R1, R2, and R3
are resistive loads. Each load is connected to the source with different configurations.
However, the equivalent impedance between each load and the source is the same.
Since the equivalent impedances are the same, each load draws the same current.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Parameters
| Type | Name | Default | Description |
|---|
| Inductance | Lbase | 10/2/Modelica.Constants.pi/60 | Base value for the line inductances [H] |
Modelica definition
model ACLine_L
extends Modelica.Icons.Example;
parameter Modelica.SIunits.Inductance Lbase=10/2/Modelica.Constants.pi/60 ;
ThreePhasesBalanced.Sources.FixedVoltage E(
definiteReference=true,
f=60,
V=480) ;
ThreePhasesBalanced.Loads.Impedance R1(R=10) ;
ThreePhasesBalanced.Loads.Impedance R2(R=10) ;
ThreePhasesBalanced.Loads.Impedance R3(R=10) ;
ThreePhasesBalanced.Loads.Impedance load_sc(R=0) ;
ThreePhasesBalanced.Lines.TwoPortInductance Lline_sc(L=Lbase) ;
ThreePhasesBalanced.Lines.TwoPortInductance Lline_1(L=Lbase) ;
ThreePhasesBalanced.Lines.TwoPortInductance Lline_2a(L=0.5*Lbase) ;
ThreePhasesBalanced.Lines.TwoPortInductance Lline_2b(L=0.5*Lbase) ;
ThreePhasesBalanced.Lines.TwoPortInductance Lline_3(L=2*Lbase) ;
ThreePhasesBalanced.Lines.TwoPortInductance Lline_3b(L=2*Lbase) ;
equation
connect(E.terminal, Lline_sc.terminal_n);
connect(Lline_sc.terminal_p, load_sc.terminal);
connect(E.terminal, Lline_1.terminal_n);
connect(Lline_1.terminal_p, R1.terminal);
connect(E.terminal, Lline_2a.terminal_n);
connect(Lline_2a.terminal_p, Lline_2b.terminal_n);
connect(Lline_2b.terminal_p, R2.terminal);
connect(E.terminal, Lline_3.terminal_n);
connect(E.terminal, Lline_3b.terminal_n);
connect(Lline_3.terminal_p, R3.terminal);
connect(Lline_3b.terminal_p, R3.terminal);
end ACLine_L;
Test model for single phase resistive lines
Information
This example demonstrates how to use a resistive line model to connect
a source to a load.
The model has four different loads. The load sc_load represents
a short circuit R=0. The current that flows through the load depends
on the resistance of the line.
The remaining three loads R1, R2, and R3
are resistive loads. Each load is connected to the source with different configurations.
However, the equivalent resistance between each load and the source is the same.
Since the equivalent resistances are the same, each load draws the same current.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Modelica definition
model ACLine_R
extends Modelica.Icons.Example;
ThreePhasesBalanced.Sources.FixedVoltage E(
definiteReference=true,
f=60,
V=480) ;
ThreePhasesBalanced.Loads.Impedance R1(R=10) ;
ThreePhasesBalanced.Loads.Impedance R2(R=10) ;
ThreePhasesBalanced.Loads.Impedance R3(R=10) ;
ThreePhasesBalanced.Loads.Impedance sc_load(R=0) ;
ThreePhasesBalanced.Lines.TwoPortResistance Rline_sc(R=10, useHeatPort=false)
;
ThreePhasesBalanced.Lines.TwoPortResistance Rline_1(R=10) ;
ThreePhasesBalanced.Lines.TwoPortResistance Rline_2a(R=5) ;
ThreePhasesBalanced.Lines.TwoPortResistance Rline_2b(R=5) ;
ThreePhasesBalanced.Lines.TwoPortResistance Rline_3a(R=20) ;
ThreePhasesBalanced.Lines.TwoPortResistance Rline_3b(R=20) ;
equation
connect(E.terminal, Rline_sc.terminal_n);
connect(Rline_sc.terminal_p, sc_load.terminal);
connect(E.terminal, Rline_1.terminal_n);
connect(Rline_1.terminal_p, R1.terminal);
connect(E.terminal, Rline_2a.terminal_n);
connect(Rline_2a.terminal_p, Rline_2b.terminal_n);
connect(Rline_2b.terminal_p, R2.terminal);
connect(E.terminal, Rline_3a.terminal_n);
connect(E.terminal, Rline_3b.terminal_n);
connect(Rline_3a.terminal_p, R3.terminal);
connect(Rline_3b.terminal_p, R3.terminal);
end ACLine_R;
Test model for single phase inductive-resistive lines
Information
This example demonstrates how to use a resistive-inductive line model to connect
a source to a load.
The model has three loads load_sc_1, load_sc_2,
and load_sc_3 representing short circuits R=0.
The current that flows through the load depends on the impedance of the line.
Each load is connected to the source with different configurations.
However, the equivalent impedance between each load and the source is the same.
Since the equivalent impedances are the same, each load draws the same current.
Note:
The line model RL_3 is the same as RL_2 but it uses
dynamic phasors.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Parameters
| Type | Name | Default | Description |
|---|
| Resistance | Rbase | 10 | Base value for the line resistance [Ohm] |
| Inductance | Lbase | Rbase/2/Modelica.Constants.p... | Base value for the line inductance [H] |
Modelica definition
model ACLine_RL
extends Modelica.Icons.Example;
parameter Modelica.SIunits.Resistance Rbase=10 ;
parameter Modelica.SIunits.Inductance Lbase=Rbase/2/Modelica.Constants.pi/60 ;
ThreePhasesBalanced.Sources.FixedVoltage E(
definiteReference=true,
f=60,
V=480) ;
ThreePhasesBalanced.Loads.Impedance load_sc_1(R=0) ;
ThreePhasesBalanced.Loads.Impedance load_sc_2(R=0) ;
ThreePhasesBalanced.Lines.TwoPortRL RL_2(R=Rbase, L=Lbase) ;
ThreePhasesBalanced.Lines.TwoPortResistance R_1(R=Rbase) ;
ThreePhasesBalanced.Lines.TwoPortInductance L_1(L=Lbase) ;
ThreePhasesBalanced.Lines.TwoPortRL RL_3(
R=Rbase,
L=Lbase,
mode=Buildings.Electrical.Types.Load.FixedZ_dynamic) ;
ThreePhasesBalanced.Loads.Impedance load_sc_3(R=0) ;
equation
connect(E.terminal, R_1.terminal_n);
connect(R_1.terminal_p, L_1.terminal_n);
connect(L_1.terminal_p, load_sc_1.terminal);
connect(E.terminal, RL_2.terminal_n);
connect(RL_2.terminal_p, load_sc_2.terminal);
connect(E.terminal, RL_3.terminal_n);
connect(RL_3.terminal_p, load_sc_3.terminal);
end ACLine_RL;
Test model for a network model
Information
This example demonstrates how to use a network model to connect
a source to a load. In this simple case the network has two nodes
that are connected by a commercial line cable.
At the beginning of the simulation the load consumes power while at the
and it produces power. The voltage at the load at the beginning is lower
than the nominal RMS voltage (480 V) while at the end of the simulation it is higher.
The voltage drop and increase are due to the presence of the cable between
the source and the load.
The network uses cables of the type LowVoltageCable.Cu35 with
a length of 200 m.
The picture below describes the grid topology.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Modelica definition
model ACSimpleGrid
extends Modelica.Icons.Example;
ThreePhasesBalanced.Lines.Network network(
redeclare Buildings.Electrical.Transmission.Grids.TestGrid2Nodes
grid, V_nominal=480) ;
ThreePhasesBalanced.Loads.Inductive load(
P_nominal=2500,
mode=Types.Load.VariableZ_P_input,
V_nominal=480) ;
ThreePhasesBalanced.Sources.FixedVoltage E(f=60, V=480) ;
Modelica.Blocks.Sources.Ramp load_inputs(
height=5000,
duration=2,
offset=-2000,
startTime=0.5) ;
equation
connect(load.terminal, network.terminal[2]);
connect(E.terminal, network.terminal[1]);
connect(load_inputs.y, load.Pow);
end ACSimpleGrid;
Test model for a network model with medium voltage
Information
This example demonstrates how to use a network model to connect
a source to a load (using a medium voltage cable). In this simple case the network has two nodes
that are connected by a commercial line cable.
At the beginning of the simulation the load consumes power while at the
end it produces power. The voltage at the load at the beginning is lower
than the nominal RMS voltage (15 kV) while at the end of the simulation it is higher.
The voltage drop and increase are due to the presence of the cable between
the source and the load.
The network uses cables of the type MediumVoltageCables.Annealed_Al_30 with
a length of 200 m.
The picture below describes the grid topology.
Note:
The cables are usually defined using the LowVoltageCable.Generic type. In order to use a
medium voltage cable it is necessary to redeclare the type of the record commercialCable.
ThreePhasesBalanced.Lines.Network
network(
redeclare
Buildings.Electrical.Transmission.Grids.TestGrid2NodesMedium
grid,
lines(
redeclare
Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable = network.grid.cables,
each
V_nominal = network.V_nominal),
V_nominal=15000)
The code snippet shows how each line that is part of the vector lines is
redeclared in order to have as type the record
Buildings.Electrical.Transmission.MediumVoltageCables.Generic. The lines are initialized
using the cables of the grid network.grid.cables. All the lines have the same
nominal voltage each V_nominal = network.V_nominal.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Modelica definition
model ACSimpleGridMedium
extends Modelica.Icons.Example;
ThreePhasesBalanced.Lines.Network network(
redeclare Buildings.Electrical.Transmission.Grids.TestGrid2NodesMedium grid,
lines(
redeclare Buildings.Electrical.Transmission.MediumVoltageCables.Generic
commercialCable=network.grid.cables,
each V_nominal=network.V_nominal),
V_nominal=15000) ;
ThreePhasesBalanced.Loads.Inductive load(
mode=Types.Load.VariableZ_P_input,
P_nominal=250000,
V_nominal=15000) ;
ThreePhasesBalanced.Sources.FixedVoltage E(V=15000, f=60) ;
Modelica.Blocks.Sources.Ramp load_inputs(
height=5000,
duration=2,
offset=-2000,
startTime=0.5) ;
equation
connect(load.terminal, network.terminal[2]);
connect(E.terminal, network.terminal[1]);
connect(load_inputs.y, load.Pow);
end ACSimpleGridMedium;
Buildings.Electrical.AC.ThreePhasesBalanced.Lines.Examples.ACLine