get_sub_matrix — Get a sub-matrix of a matrix.
get_sub_matrix( : : MatrixID, Row, Column, RowsSub, ColumnsSub : MatrixSubID)
该算子 get_sub_matrix generates a new matrix
MatrixSub and copies to this matrix a part of the input
Matrix defined by the matrix handle MatrixID.
The part of the Matrix is determined by the upper left
corner (Row,Column) and the sub-matrix dimensions
(RowsSub, ColumnsSub). 该算子 returns the
matrix handle MatrixSubID of the matrix
MatrixSub. Access to the elements of the matrix is
possible e.g., with 该算子 get_full_matrix.
Example:
Row = 0,
Column = 1,
RowsSub = 3,
ColumnsSub = 2
The conditions 0 Row < size of
Matrix in row direction, Row + RowsSub
size of Matrix in the row direction, 0
Column < size of Matrix in the
column direction, and Column + ColumnsSub
size of matrix Matrix in the column
direction must be satisfied.
MatrixID (input_control) matrix → (handle)
Matrix handle of the input matrix.
Row (input_control) integer → (integer)
Upper row position of the sub-matrix in the input matrix.
Default: 0
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriction:
Row >= 0
Column (input_control) integer → (integer)
Left column position of the sub-matrix in the input matrix.
Default: 0
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriction:
Column >= 0
RowsSub (input_control) integer → (integer)
Number of rows of the sub-matrix.
Default: 1
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriction:
RowsSub >= 1
ColumnsSub (input_control) integer → (integer)
Number of columns of the sub-matrix.
Default: 1
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriction:
ColumnsSub >= 1
MatrixSubID (output_control) matrix → (handle)
Matrix handle of the sub-matrix.
如果参数均有效，算子 get_sub_matrix
返回值 2 (
H_MSG_TRUE)
. 如有必要，将引发异常。
get_full_matrix,
get_value_matrix
Foundation