Triggered Signal From Workspace

R2026b

Import signal samples from MATLAB workspace when triggered

• 

Triggered Signal From Workspace 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:
DSP System Toolbox / Signal Operations

Description

The Triggered Signal From Workspace block imports signal samples from the MATLAB^® workspace into the Simulink^® model when triggered by the control signal at the input port (). The Signal parameter specifies the name of a MATLAB workspace variable containing the signal to import, or any valid MATLAB expression defining a matrix or 3-D array.

Examples

Queues

Push and pop elements from a queue using a Queue block with a system of selection switches.

• Open Model

Ports

Input

trigger — Trigger signal

scalar | vector | matrix

Triggering input signal, specified as a scalar, vector, or matrix. This port is labelled with .

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point

Output

Port_1 — Signal imported from workspace

scalar | vector | matrix | 3-D array

The block outputs the signal imported from the workspace when triggered by the control signal at the input port.

When the Signal parameter specifies an M-by-N matrix (M≠1), each of the N columns is treated as a distinct channel. You specify the frame size in the Samples per frame parameter, M_o. When triggered, the block outputs an M_o-by-N matrix containing M_o consecutive samples from each signal channel. For convenience, an imported row vector (M=1) is treated as a single channel, so the output dimension is M_o-by-1.

When the Signal parameter specifies an M-by-N-by-P array, the block generates a single page of the array (an M-by-N matrix) at each trigger time. The Samples per frame parameter must be set to 1.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point

Parameters

Signal — Signal to import

1:10 (default) | MATLAB workspace variable | MATLAB expression

The name of the MATLAB workspace variable from which to import the signal, or a valid MATLAB expression specifying the signal.

When the Signal parameter specifies an M-by-N matrix (M≠1), each of the N columns is treated as a distinct channel. You specify the frame size in the Samples per frame parameter, M_o. When triggered, the block outputs an M_o-by-N matrix containing M_o consecutive samples from each signal channel. For convenience, an imported row vector (M=1) is treated as a single channel, so the output dimension is M_o-by-1.

When the Signal parameter specifies an M-by-N-by-P array, the block generates a single page of the array (an M-by-N matrix) at each trigger time. The Samples per frame parameter must be set to 1.

Trigger type — Type of triggering event

Rising edge (default) | Falling edge | Either edge

The type of event that triggers the block to execute.

• 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 when either a rising or falling edge occurs.

Initial output — Initial output value

0 (default) | scalar | vector | matrix

The value to output until the first trigger event is received. Between trigger events, the block holds the output value constant at its most recent value (that is, no linear interpolation takes place). For single-channel signals, the Initial output can be a vector of length M_o or a scalar to repeat across the M_o elements of the initial output frames. For matrix outputs (M_o-by-N or M-by-N), the Initial output parameter value can be a matrix of the same size or a scalar to be repeated across all elements of the initial output.

Samples per frame — Samples per frame

1 (default) | positive integer

The number of samples, M_o, to buffer into each output frame specified as a positive integer scalar. This value must be 1 when you specify a 3-D array in the Signal parameter.

Form output after final data value by — Values to output after final imported signal value

Setting to zero (default) | Holding final value | Cyclic repetition

Specifies the output after all of the specified signal samples have been generated.

• When you specify Setting To Zero, the block generates zero-valued outputs for the duration of the simulation after generating the last frame of the signal.

• When you specify Holding Final Value, the block repeats the final sample for the duration of the simulation after generating the last frame of the signal.

• When you specify Cyclic Repetition, the block repeats the signal from the beginning after generating the last frame. When there are not enough samples at the end of the signal to fill the final frame, the block zero-pads the final frame as necessary to ensure that the output for each cycle is identical. For example, the ith frame of one cycle contains the same samples as the ith frame of any other cycle.

The block does not extrapolate the imported signal beyond the last sample.

Block Characteristics

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

Programmatic Use: Add Block

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

"dspsigops/Triggered Signal From Workspace"

Example: add_block("dspsigops/Triggered Signal From Workspace","myModel/myBlock",MakeNameUnique="on")

Extended Capabilities

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

Version History

Introduced before R2006a