Main Content

Decoupling Line

Single-phase decoupling distributed parameters line

Since R2020b

  • Decoupling Line block

Libraries:
Simscape / Electrical / Specialized Power Systems / Power Grid Elements

Description

The Decoupling Line block implements a single-phase distributed parameters line model that transmits the electrical signal entering its conserving port to an associated Decoupling Line block in your model. The two Decoupling Line blocks form a pair that represents the send and receive ends of a single-phase transmission line.

The behavior of the pair of blocks is equivalent to using one Distributed Parameters Line block:

Refer to Distributed Parameters Line for a detailed description of the equations used to represent wave propagation phenomena and line-end reflections.

Use the Decoupling Line block pairs when you want to model a transmission line with no physical electrical connections between the send and receive ends of the line. This technique is used, for example, in applications where a large network is decoupled into smaller sections that are simulated into different subsystems or models with no electrical connections between them. This decoupling technique is often used to model complex electrical networks on multi-core real-time computers, or to allow faster simulation of large networks.

The blocks in the pair can be associated by using the Pairing ID parameter, which transmits the electrical signal information travelling from one terminal to the other using internal Simulink® Goto and From blocks or connecting the blocks with Simulink signals.

The parameters of each Decoupling Line block in a pair must be identical and correspond to the parameters you would enter in an equivalent Distributed Parameters Line block. For example, to model a 100 km transmission line with the given R, L, and C values, use two Decoupling Line blocks with a length of 100 km each and the same R, L, and C values.

To model a transmission line in your model, add two Decoupling Line blocks to your model and set the block parameters to the same values. Alternatively, use the Specify Decoupling Lines App to find, select, and automatically replace existing Distributed Parameters Line blocks in your model with equivalent pairs of Decoupling Line blocks. For more information, see Specify Decoupling Lines.

Limitations

  • The Decoupling Line block can be used only in a discrete model, that is, when the Simulation type parameter of the powergui block is set to Discrete.

Ports

Input

expand all

Connect this input to the s output port of the other Decoupling Line block forming the pair.

Dependencies

To enable this port, select the Show send and receive ports parameter.

Output

expand all

Connect this output to the r input port of the other Decoupling Line block forming the pair.

Dependencies

To enable this port, select the Show send and receive ports parameter.

Conserving

expand all

Specialized electrical conserving port associated with the send terminal or the receive terminal of a transmission line (when the block is used with another Decoupling Line block).

Parameters

expand all

Parameters

Transmission line length, in km. Because the block is used in a pair with another Decoupling Line block, enter the same line length in each of the two blocks; do not split the value between each of the two blocks. For example, to model a 100 km line, specify 100 in each block, not 50 in one block and 50 in the other block.

Specify the frequency used to compute the per-unit length of the resistance (R), inductance (I), and capacitance (C) matrices of the line model.

Resistance R per unit length, in ohms/km (Ω/km).

Inductance I per unit length, in henries/km (H/km).

Capacitance C per unit length, in farads/km (F/km).

Select to show the input and output ports r and s. When selected, the Decoupling Line blocks can be paired by connecting them with Simulink signals. You connect the s port of the first block to the r port of the second block, and connect the s port of the second block to the r port of the first block.

The internal model of the Decoupling Line block is directly connected to the external r and s block ports.

To break the algebraic loop created by this type of connection, you can add a Unit Delay block at the output of each Decoupling Line block.

When Show send and receive ports is cleared, the Decoupling Line blocks are associated by using the Pairing ID parameter, which transmits the electrical signal information travelling from one terminal to the other by the use of internal Simulink Goto and From blocks. A Unit Delay block is also added to the output signal path to break the algebraic loops. The sample time parameter of this delay corresponds to the sample time delay specified in the powergui block.

When the Show send and receive ports parameter is cleared, internal Goto and From blocks are used to pair two Decoupling Line blocks in your model. In both blocks, the first part of the pairing identifier is the same, but you must append _S to the end of the identifier of one block, and _R to the end of the identifier of the other block. An error is produced if the identifier does not end in _S or _R. For example, suppose you add two Decoupling Line blocks to your model. To pair the blocks, you must set the Pairing ID parameter of one block to L001_S and the other block to L001_R.

Initial Values

Initial value of the terminal voltage, in volts.

Angle of the initial voltage, in degrees.

Initial value of the current flowing out the block, in Amperes.

Angle of the initial current, in degrees.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2020b