Phase Permute
Permute phases of three-phase system
Libraries:
Simscape /
Electrical /
Connectors & References
Description
The Phase Permute block cyclically permutes (changes the order of) the phases of a three-phase system.
The block has two three-phase connections associated with its terminals. If you consider the side of the block labeled ~123 (a1,b1, c1 in expanded view) as side 1 and the side of the block labeled ~231 (a2,b2, c2) as side 2, then the block connects phases as shown in the table.
| Side 1 Phase | Connects to Side 2 Phase |
|---|---|
| a1 | c2 |
| b1 | a2 |
| c1 | b2 |
Examples
Three-Phase Asynchronous Machine Starting
Model a wye-delta starting circuit for an induction machine. After one second, the Controller subsystem closes the switch labeled S1. Closing this switch connects the supply to the machine. Initially, the machine connects to the supply in a wye configuration because the switch labeled S2 connects each phase of the ~1 port to the corresponding phase of the ~2 port and leaves the ~3 port unconnected. Once the machine is at 80% of the synchronous speed, S2 reconnects the machine in a delta configuration by disconnecting each phase of ~2 and connecting each phase of ~1 to the corresponding phase of ~3. The motor then operates in a delta configuration regardless of rotor speed. The supply sees a higher impedance when the motor is in wye configuration, reducing the starting current and causing less disruption to other connected loads.
Three-Phase Asynchronous Wind Turbine Generator
Model an induction machine used as a wind turbine generator.
Marine Full Electric Propulsion Power System
A representative marine half-ship electrical power system with base load, hotel load, bow thrusters and electric propulsion.
AC Cable with Bonded Sheaths
A three-phase cable model comprised of multiple pi-sections. Each phase is enclosed in a conductive sheath. The conductive sheath is connected to ground at either end of the cable through a simple resistance. A high-voltage source provides power to an unbalanced resistive load through the power cable. You can configure the sheath to be either series-bonded or cross-bonded. You can also configure the number of pi-sections. Increasing the number of pi-sections improves the accuracy but slows down the simulation. To facilitate convergence, the voltage source includes an internal impedance.
Ports
Conserving
Electrical conserving port representing the three phases of the side 1. For more information, see Three-Phase Ports.
Dependencies
To enable this port, set the Electrical
connection parameter to Composite
three-phase ports.
Electrical conserving port representing the three phases of the side 2. For more information, see Three-Phase Ports.
Dependencies
To enable this port, set the Electrical
connection parameter to Composite
three-phase ports.
Electrical conserving port associated with the phase a of side 1.
Dependencies
To enable this port, set the Electrical connection parameter to Expanded three-phase ports.
Electrical conserving port associated with the phase b of side 1.
Dependencies
To enable this port, set the Electrical connection parameter to Expanded three-phase ports.
Electrical conserving port associated with the phase c of side 1.
Dependencies
To enable this port, set the Electrical connection parameter to Expanded three-phase ports.
Electrical conserving port associated with the phase a of side 2.
Dependencies
To enable this port, set the Electrical connection parameter to Expanded three-phase ports.
Electrical conserving port associated with the phase b of side 2.
Dependencies
To enable this port, set the Electrical connection parameter to Expanded three-phase ports.
Electrical conserving port associated with the phase c of side 2.
Dependencies
To enable this port, set the Electrical connection parameter to Expanded three-phase ports.
Parameters
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" |
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Version History
Introduced in R2013bThe 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.
See Also
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)




