scale_matrixT_scale_matrixScaleMatrixScaleMatrixscale_matrix (算子名称)
名称
scale_matrixT_scale_matrixScaleMatrixScaleMatrixscale_matrix — Scale a matrix.
参数签名
描述
该算子 scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrixscale_matrix scales the Matrix by a
constant factor. The matrix is defined by the matrix handle
MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. A new matrix MatrixScaled is generated
with the result. 该算子 returns the matrix handle
MatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledIDmatrix_scaled_id. Access to the elements of the matrix is
possible e.g., with 该算子 get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix. The
formula for the calculation of the result is:
Example:
FactorFactorFactorFactorfactorfactor = 1.5
运行信息
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- 未经并行化处理。
参数表
MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control) matrix → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Matrix handle of the input matrix.
FactorFactorFactorFactorfactorfactor (input_control) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Scale factor.
Default:
2.0
Suggested values:
0.1, 0.2, 0.3, 0.5, 0.7, 1.0, 1.5, 2.0, 3.0, 5.0, 10.0
MatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledIDmatrix_scaled_id (output_control) matrix → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Matrix handle with the scaled elements.
结果
如果参数均有效，算子 scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrixscale_matrix
返回值 2 (
H_MSG_TRUE)
. 如有必要，将引发异常。
可能的前置算子
create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix
可能的后置算子
get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix,
get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrixget_value_matrix
可替代算子
scale_matrix_modscale_matrix_modScaleMatrixModScaleMatrixModScaleMatrixModscale_matrix_mod
参考其它
mult_element_matrixmult_element_matrixMultElementMatrixMultElementMatrixMultElementMatrixmult_element_matrix,
mult_element_matrix_modmult_element_matrix_modMultElementMatrixModMultElementMatrixModMultElementMatrixModmult_element_matrix_mod,
div_element_matrixdiv_element_matrixDivElementMatrixDivElementMatrixDivElementMatrixdiv_element_matrix,
div_element_matrix_moddiv_element_matrix_modDivElementMatrixModDivElementMatrixModDivElementMatrixModdiv_element_matrix_mod
模块
Foundation