Triggered To Workspace - Write input sample to MATLAB workspace when triggered - Simulink (original) (raw)

Main Content

Write input sample to MATLAB workspace when triggered

Libraries:
DSP System Toolbox / Sinks

Description

The Triggered To Workspace block creates a matrix or array variable in the MATLAB® workspace, where it stores the acquired inputs at the end of a simulation. The block overwrites an existing variable with the same name.

To save a record of the sample time corresponding to each sample value, open the Configuration Parameters dialog box. To open the Configuration Parameters, in theModeling tab of the Simulink® model toolstrip, click Model Settings. In the left pane of the window that opens, click Data Import/Export and select the Time check box.

The nontriggered version of this block is the To Workspace (Simulink) block.

Ports

Input

expand all

Specify the data to log to the workspace when the block receives a trigger at theTrigger port. The Triggered To Workspace block supports logging real and complex data of any built-in data type or user-defined data types such as buses, enumerations, and fixed-point data.

Tips

Logging fixed-point data requires a Fixed-Point Designer™ license.

Specify the trigger signal that controls the execution of the block as a scalar, vector, or a matrix.

Parameters

expand all

The type of event that triggers the execution of the block.

The block acquires and buffers a single frame from input 1 whenever it is triggered by the control signal at input 2 (). At all other times, the block ignores input 1. You specify the triggering event at input 2 using the parameter:

Rising edge triggers execution of the block when the trigger input rises from a negative value to zero or a positive value, or from zero to a positive value.
Falling edge triggers execution of the block when the trigger input falls from a positive value to zero or a negative value, or from zero to a negative value.
Either edge triggers execution of the block for a Rising edge or aFalling edge.

The name of the workspace variable in which to store the data. By default, theTriggered To Workspace block saves logged data in a variable called yout. When a model contains multipleTriggered To Workspace blocks, you must specify a unique value in the Variable name parameter of each block.

Specify a decimation factor to reduce the effective sample rate for the logged data. For a decimation factor D the Triggered To Workspace block logs the value of every_D_th sample. For example, when you specify the Decimation value as2, the Triggered To Workspace block logs every other data point.

For more information about controlling which samples the block logs during simulation, see Specify Signal Values to Log (Simulink).

Specify the maximum number of rows (one row per time step) that the block saves (P) as a positive integer.

Specify whether the block saves 2-D signals as a 2-D or 3-D array in the MATLAB workspace.

When you select:

2-D array (concatenate along first dimension) — The block vertically concatenates each M_-by-N matrix input with the previous input to produce a 2-D output array. The block saves the data as a_P_-by-N matrix, where_P is the value of the Maximum number of rows parameter.
When the simulation progresses long enough for the block to acquire more than P samples, the block stores only the most recent P samples. TheDecimation factor D allows you to store only every_Dth_ input matrix.
3-D array (concatenate along third dimension) — The block saves an_M_-by-N input as a 3-D array in which each M_-by-N page represents a single sample from each of the_M*N channels (the most recent input matrix occupies the last page). The maximum size of this 3-D array is limited to_M_-by-N_-by-P, where P is the value of the value of theMaximum number of rows parameter.
When the simulation progresses long enough for the block to acquire more than P inputs, the block stores only the last P inputs. The Decimation factor D allows you to store only every_Dth input matrix.

Specify how to log fixed-point input data. By default, theTriggered To Workspace block logs fixed-point input data as double. When you select this parameter, theTriggered To Workspace block logs fixed-point input as a Fixed-Point Designerfi (Fixed-Point Designer) object.

Using the Triggered To Workspace block to log fixed-point data requires a license for Fixed-Point Designer.

Block Characteristics

Data Types	Boolean \| double	enumerated	fixed point	integer	single
Direct Feedthrough	no
Multidimensional Signals	no
Variable-Size Signals	no
Zero-Crossing Detection	no

Extended Capabilities

expand all

This block can be used for simulation visibility in subsystems that generate HDL code, but is not included in the hardware implementation.

Version History

Introduced before R2006a