Line Voltage Sensor (Three-Phase)

R2026b

Ideal three-phase line voltage measurement

• 

Line Voltage Sensor (Three-Phase) block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
Simscape / Electrical / Sensors & Transducers

Description

The Line Voltage Sensor (Three-Phase) block represents an ideal three-phase line voltage sensor. The block measures the line-line voltages of a three-phase system and outputs a three-element physical signal vector. Each element of the physical signal output vector is proportional to the voltage between the phases as follows:

• Element 1: V_ab = V_a - V_b

• Element 2: V_bc = V_b - V_c

• Element 3: V_ca = V_c - V_a

where V_a, V_b, and V_c are the absolute a-, b-, and c-phase voltages.

Note

You must connect the Line Voltage Sensor (Three-Phase) block in shunt with the three-phase element. For more information on how to use this block, see Build and Simulate Composite and Expanded Three-Phase Models.

Ports

Output

V — Three-elements vector

physical signal

Three-element physical signal vector output port associated with the voltages between the phases

Conserving

~ — Composite three-phase port

electrical

Electrical conserving port representing the three phases of the three-phase block. For more information, see Three-Phase Ports.

Dependencies

To enable this port, set the Electrical connection parameter to Composite three-phase ports.

a — Phase a of three-phase system

electrical

Electrical conserving port associated with the phase a of the three-phase block.

Dependencies

To enable this port, set the Electrical connection parameter to Expanded three-phase ports.

b — Phase b of three-phase system

electrical

Electrical conserving port associated with the phase b of the three-phase block.

Dependencies

To enable this port, set the Electrical connection parameter to Expanded three-phase ports.

c — Phase c of three-phase system

electrical

Electrical conserving port associated with the phase c of the three-phase block.

Dependencies

To enable this port, set the Electrical connection parameter to Expanded three-phase ports.

Parameters

Electrical connection — Whether to model composite or expanded three-phase ports

Composite three-phase ports (default) | Expanded three-phase ports

Since R2026a

Whether to model composite or expanded three-phase ports.

Composite three-phase ports represent three individual electrical conserving ports with a single block port. You can use composite three-phase ports to build models that correspond to single-line diagrams of three-phase electrical systems.

Expanded three-phase ports represent the individual phases of a three-phase system using three separate electrical conserving ports.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

Parameter:	port_option
Values:	"ee.enum.threePhasePort.composite" (default) | "ee.enum.threePhasePort.expanded"

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"ee_lib/Sensors & Transducers/Line Voltage Sensor (Three-Phase)"

Example: add_block("ee_lib/Sensors & Transducers/Line Voltage Sensor (Three-Phase)","myModel/myBlock",MakeNameUnique="on")

For information about programmatic access to individual block parameters, see the Programmatic Use section of parameter descriptions on this page.

Extended Capabilities

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

Version History

Introduced in R2013b

R2026a: The Modeling option parameter has changed

The Modeling option parameter has been replaced with the Electrical connection parameter. You can now also set this parameter value programmatically by using the set_param function.

If you created a model containing this block in an earlier release, the software now automatically sets the value of the Electrical connection parameter to the previous value of the Modeling option parameter.