[Previous] [Up] [Next]

MX_DSAREF – Set reference to subarray of A into B

Block SymbolLicensing group: STANDARD
Qt SVG Document Exported by REXYGEN Studio uA i j HLD yA yB E MX_DSAREF

Function Description
The function block MX_DSAREF creates a reference yB to the subarray (submatrix) of matrix referenced by uA. This operation is very fast because no matrix element is copied.

The output reference yA is always set to the corresponding input reference uA, the output reference yB is created inside each instance of this function block. If HLD = on then no other operation is performed otherwise the reference to the matrix yB is created with the following properties:

  • Number of rows of the submatrix is set to M-i, where M is number of rows of the matrix referenced by uA.
  • Number of columns of the submatrix is set to N-j, where N is number of columns of the matrix referenced by uA.
  • The first element in position (0,0) of the submatrix is the element of the matrix referenced by uA in position (i,j), all indices are zero based.
  • The matrix referenced by yB has the same leading dimension as the matrix referenced by uA.

The error flag E is set to on if:

  • the reference uA is not defined (i.e. input uA is not connected),
  • 0 > i ≥M.
  • 0 > j ≥N.

This block does not propagate the signal quality. More information can be found in the 1.4 section.

Input

uA

Input reference to matrix A

Reference

i

Index of the subarray first row

Long (I32)

j

Index of the subarray first column

Long (I32)

HLD

Hold

Bool

Parameter

ay

Output reference of the subarray  ⊙[0 0]

Double (F64)

Output

yA

Output reference to matrix A

Reference

yB

Output reference to matrix B

Reference

E

Error indicator

Bool

[Previous] [Back to top] [Up] [Next]

2024 © REX Controls s.r.o., www.rexygen.com