Powergui - Environment block for SimPowerSystems models

Library

powerlib

Description

The Powergui block allows you to choose one of the following methods to solve your circuit:

Continuous method, which uses a variable step Simulink solver
Ideal Switching continuous method
Discretization of the electrical system for a solution at fixed time steps
Phasor solution method

The Powergui block is necessary for simulation of any Simulink model containing SimPowerSystems blocks. It is used to store the equivalent Simulink circuit that represents the state-space equations of the model.

You must follow these rules when using this block in a model:

Place the Powergui block at the top level of diagram for optimal performance. However, you can place it anywhere inside subsystems for your convenience; its functionality will not be affected.
You can have a maximum of one Powergui block per model
You must name the block powergui

Graphical User Interface Tools

The Powergui block also gives you access to various graphical user interface (GUI) tools and functions for the steady-state analysis of SimPowerSystems models, the analysis of simulation results, and for the design of advanced block parameters.

Dialog Box and Parameters

Simulation and Configuration Options

To specify the simulation type, parameters, and preferences, select Configure parameters in the Powergui dialog. This opens another dialog box with the Powergui block parameters. This dialog box contains two tabs, Solver and Preferences. The configuration of the Solver tab depends on the option selected from the Simulation type drop-down list.

Simulation type

Select Continuous to perform a continuous solution of the model.

Select Discrete to perform a discretization of the model. The sample time is specified by the Sample time parameter.

Select Phasor to perform phasor simulation of the model, at the frequency specified by the Phasor frequency parameter.

Enable use of ideal switching devices

If selected, the switches and power electronic blocks are modeled by an alternative method allowing ideal or quazi-ideal switches. For more information, see Using the Ideal Switching Device Method. This parameter is visible only when the Simulation type parameter is set to Continuous.

Disable snubbers in switching devices

If selected, the snubber devices of the power electronic and breaker blocks in your model are disabled and not modeled. This parameter is visible only if Enable use of ideal switching devices is selected.

Disable On resistance in switching devices (Ron=0)

If selected, the internal resistance Ron of switches and power electronic devices is disabled and forced to zero ohms. This parameter is visible only if Enable use of ideal switching devices is selected.

Disable Forward voltage in switching devices (Vf=0)

If selected, the internal forward voltage Vf of power electronic devices is disabled and forced to zero volts. This parameter is visible only if Enable use of ideal switching devices is selected.

Display circuit differential equations

If selected, differential equations of the model are displayed in the command window when the simulation starts. This parameter is visible only if Enable use of ideal switching devices is selected. For more information, see Using the Ideal Switching Device Method.

Sample time (s)

Specify the sample time used to discretize the electrical circuit. This parameter is visible only when the Simulation type parameter is set to Discrete.

The Sample time parameter must be set to a value greater than 0. The icon displays the value of the sample time.

Phasor frequency (Hz)

Specify the frequency used by the software to perform the phasor simulation of the model. This parameter is visible only when the Simulation type parameter is set to Phasor.

Display SimPowerSystems warnings and messages

If selected, the command line echo messages are enabled during the analysis and simulation of the model.

Use TLC file when in Accelerator Simulation Mode and for RTW applications

If selected, TLS state-space S-function (sfun_spssw_discc.tlc) will be used in Accelerator mode and for code generation.

Clear this box if you notice a slowdown in performance when using Accelerator mode, compared to previous releases. This slowdown is observed if you have the LCC compiler installed as the default compiler for building external interface (mex).

Start simulation with initial electrical states from

If blocks is selected, initial state values defined in blocks are used for the simulation.

If steady is selected, force all initial electrical state values to steady-state values.

If zero is selected, force all initial electrical state values to zero.

Restore disabled links of SimPowerSystems blocks

If yes is selected, the Powergui block detects SimPowerSystems blocks that have a disabled link at the simulation start and restores the link automatically.

If warning is selected, the Powergui block detects SimPowerSystems blocks that have a disabled link at the simulation start and displays a warning.

If no is selected, SimPowerSystems blocks with disabled links will not be detected and relinked.

Analysis Tools

Steady-State Voltages and Currents

Open the Steady-State Voltages and Currents Tool dialog box that displays the steady-state voltages and currents of the model. For more information, see the power_steadystate reference page.

Initial States Setting

Open the Initial States Setting Tool dialog box that allows you to display and modify initial capacitor voltages and inductor currents of the model. For more information, see the power_initstates reference page.

Load Flow and Machine Initialization

Open the Machine Load Flow Tool dialog box to perform load flow and initialize three-phase networks containing three-phase machines, so that the simulation starts in steady state. For more information, see the power_loadflow reference page.

Use LTI Viewer

Open a window to generate the state-space model of your system (if you have Control System Toolbox software installed) and automatically open the LTI Viewer interface for time and frequency domain responses. For more information, see the power_ltiview reference page.

Impedance vs Frequency Measurement

Open the Impedance vs Frequency Measurement Tool dialog box to display the impedance versus frequency defined by the Impedance Measurement blocks. For more information, see the power_zmeter reference page.

FFT Analysis

Open the FFT Analysis Tool dialog box to perform Fourier analysis of signals stored in a Structure with Time format. For more information, see the power_fftscope reference page.

An example of using the FFT Analysis tool is described in Performing Harmonic Analysis Using the FFT Tool.

Generate Report

Open the Generate Report Tool dialog box that allow you to generate a report of steady state variables, initial states, and machine load flow for a model. For more information, see the power_report reference page.

Hysteresis Design Tool

Open a window to design a hysteresis characteristic for the saturable core of the Saturable Transformer block and the Three-Phase Transformer blocks (two- and three-windings). For more information, see the power_hysteresis reference page.

Compute RLC Line Parameters

Open a window to compute RLC parameters of overhead transmission line from its conductor characteristics and tower geometry. For more information, see the power_lineparam reference page.