Table Of Contents

Set Submatrix (G Dataflow)

Last Modified: December 18, 2017

Adds a submatrix to matrix starting at (row 1, column 1) and ending at (row N, column N).

connector_pane_image
datatype_icon

matrix

2D array of any numeric type.

datatype_icon

row 1

First row in matrix you want to appear in the output.

Must be an integer or real numeric.

To add additional row 1 inputs, resize the node.

Default: 0

datatype_icon

row N

Last row in matrix you want to appear in the output.

Must be an integer or real numeric.

To add additional row N inputs, resize the node.

Default: The index of the last row in matrix.

datatype_icon

column 1

First column in matrix you want to appear in the output.

Must be an integer or real numeric.

To add additional column 1 inputs, resize the node.

Default: 0

datatype_icon

column N

Last column in matrix you want to appear in the output.

Must be an integer or real numeric.

To add additional column N inputs, resize the node.

Default: The index of the last column in matrix.

datatype_icon

new submatrix/fill element

2D array of any numeric type or a numeric scalar.

To add additional new submatrix/fill element inputs, resize the node.

Default: If you do not wire an input to new submatrix/fill element, the default is 0.

datatype_icon

output matrix

matrix with the new submatrix. If matrix is an empty matrix, output matrix resizes to receive the new elements.

To add additional output matrix outputs, resize the node.

Leaving Inputs Unwired

If you wire an input to matrix and you do not wire the other inputs, output matrix returns matrix with every element set to 0.

Indexing Outside Input Values

If you wire certain input values that are outside the existing elements of matrix, this node returns outputs as described in the following table.

Input Result
You wire an input to matrix and a matrix to new submatrix/fill element. matrix resizes with the new submatrix elements in output matrix. If this node needs to add rows or columns to the output matrix, this node returns 0 at each exterior location.
You wire a negative value to row or column inputs. This node ignores the rows and columns of the submatrix with negative indexes. If new submatrix/fill element is a matrix, this node also ignores the new submatrix elements that fill these rows and columns.

Wiring the New Submatrix/Fill Element Input

When you wire certain inputs to new submatrix/fill element, this node behaves as described in the following table.

Input Result
You wire a matrix to new submatrix/fill element that has a dimension larger than matrix. output matrix resizes to receive the new submatrix elements. If you increase the row or column dimensions of matrix, this node sets the new elements to an invalid operation value at each exterior location.
You wire a matrix to new submatrix/fill element when the dimensions of the row or column inputs are less than the number of rows or columns in the submatrix. This node ignores the additional row and column elements in the new submatrix.
You wire a matrix to new submatrix/fill element when the dimensions of the row or column inputs exceed the number of rows or columns in the submatrix. This node inserts an invalid operation value at each exterior location.
You wire an input to new submatrix/fill element with a different numeric type than matrix. This node converts matrix to a new numeric type if this node cannot set new submatrix elements without losing precision. If this node cannot set new submatrix elements without losing precision, the numeric type of new submatrix/fill element converts to the numeric type of matrix.

Where This Node Can Run:

Desktop OS: Windows

FPGA: This product does not support FPGA devices

Web Server: Not supported in VIs that run in a web application


Recently Viewed Topics