Triggered Matrix To Workspace (DSP Blockset)

Write the input matrix to the workspace when triggered.

Library

DSP Sinks

Description

The Triggered Matrix To Workspace block writes a three-dimensional array, A, to the workspace, where A contains the acquired samples of a matrix input. At the end of the simulation the block writes every Dth input sample (a matrix) to a page (a two-dimensional slice) of the specified three-dimensional array, where D is specified by the block's Decimation factor. The block writes the first input to the first page of the array, A(:,:,1), and continues adding pages until it writes the last input matrix to the last array page, A(:,:,end).

The block acquires and buffers a single sample from input 1 whenever it is triggered by the control signal at input 2. At all other times, the block ignores input 1. The triggering event at input 2 is specified by the Trigger type pop-up menu, and can be one of the following:

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 (as described above) occurs.

To save a record of the simulation sample times corresponding to each page of the three-dimensional array, check the Time box in the Save to workspace panel of the Simulation Parameters dialog. You can access these parameters by selecting Parameters from the Simulation menu, and clicking on the Workspace I/O tab.

The nontriggered version of this block is Matrix To Workspace.

Note
The Triggered Matrix To Workspace block does not support real-time data logging when used with the Real-Time Workshop. You should not use this block if you expect to generate real-time code from your model.

Dialog Box

Trigger type: The type of event that triggers the block's execution.
Variable name: The name of the array to create in the workspace.
Maximum number of matrices: The maximum number of array pages to create in the workspace, P. If the block samples more than P times, it stores only the last P matrices.
Decimation: The factor by which to decimate the input samples, D.
Matrix size: The dimensions of the input matrix, in the form [rows columns].