repeat_matrix — Repeat a matrix.
repeat_matrix( : : MatrixID, Rows, Columns : MatrixRepeatedID)
The operator repeat_matrix creates the new matrix
MatrixRepeated and copies all elements of the input
Matrix n times to this new matrix, where n =
Rows Columns. The new matrix has
dimensions Rows rows of the input
Matrix and Columns columns of the
input Matrix. The input Matrix is defined by
the matrix handle MatrixID. The operator returns the
matrix handle MatrixRepeatedID of the matrix
MatrixRepeated. Access to the elements of the matrix
is possible e.g., with the operator get_full_matrix.
Example:
MatrixID (input_control) matrix → (handle)
Matrix handle of the input matrix.
Rows (input_control) integer → (integer)
Number of copies of input matrix in row direction.
Default: 2
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20
Restriction:
Rows >= 1
Columns (input_control) integer → (integer)
Number of copies of input matrix in column direction.
Default: 2
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20
Restriction:
Columns >= 1
MatrixRepeatedID (output_control) matrix → (handle)
Matrix handle of the repeated copied matrix.
If the parameters are valid, the operator repeat_matrix
returns the value 2 (
H_MSG_TRUE)
. If necessary, an exception is raised.
get_full_matrix,
get_value_matrix
Foundation