Operators |
set_value_matrix — Set one or more elements of a matrix.
The operator set_value_matrix sets the values of the elements of the input Matrix at the positions (Row,Column) to the values specified by Value. The values can be a tuple of floating point or integer numbers. Integer numbers are converted to floating point numbers automatically. The number of values of Value must match the number of elements of Row and Column. In addition, the conditions 0 <= Row < size of Matrix in the row direction and 0 <= Column < size of Matrix in the column direction must be satisfied. The Matrix is defined by the matrix handle MatrixID.
Example:
/ 3.0 0.0 -2.0 1.0 \ Matrix = | -5.0 7.0 2.0 -2.0 | \ 8.0 -4.0 1.0 -1.0 / Row = [0,2,1] Column = [1,0,3] Value = [1,-9,6] / 3.0 1.0 -2.0 1.0 \ -> Matrix = | -5.0 7.0 2.0 6.0 | \ -9.0 -4.0 1.0 -1.0 /
set_value_matrix modifies the content of an already existing matrix.
Matrix handle of the input matrix.
Row numbers of the matrix elements to be modified.
Default value: 0
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriction: Row >= 0
Column numbers of the matrix elements to be modified.
Default value: 0
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriction: Column >= 0
Values to be set in the indicated matrix elements.
Default value: 0
Suggested values: 0, 1, -1
If the parameters are valid, the operator set_value_matrix returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.
clear_matrix, clear_all_matrices
Foundation
Operators |