Table Of Contents

Set Submatrix (G Dataflow)

Version:
    Last Modified: January 12, 2018

    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: Not supported

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


    Recently Viewed Topics