scale_matrix_modT_scale_matrix_modScaleMatrixModScaleMatrixModscale_matrix_mod (算子)
名称
scale_matrix_modT_scale_matrix_modScaleMatrixModScaleMatrixModscale_matrix_mod — 缩放矩阵。
签名
def scale_matrix_mod(matrix_id: HHandle, factor: Union[int, float]) -> None
描述
The operator scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrixscale_matrix scales the Matrix by a
constant factor. The matrix is defined by the matrix handle
MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. The input matrix is overwritten with the
result.可通过算子
get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix 等方式访问该矩阵的元素。结果的计算公式为:
示例:
FactorFactorFactorFactorfactorfactor = 1.5
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
此算子修改后续输入参数的状态:
在执行此算子时,若该参数值需在多个线程间使用,则必须对其访问进行同步。
参数
MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (输入控制,状态被修改) matrix → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
输入矩阵的矩阵句柄。
FactorFactorFactorFactorfactorfactor (输入控制) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
比例系数。
默认值:
2.0
建议值:
0.1, 0.2, 0.3, 0.5, 0.7, 1.0, 1.5, 2.0, 3.0, 5.0, 10.0
结果
如果参数有效,算子 scale_matrix_modscale_matrix_modScaleMatrixModScaleMatrixModScaleMatrixModscale_matrix_mod 返回值 2 ( H_MSG_TRUE )。如有必要,则抛出异常。
可能的前趋
create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix
可能的后继
get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix,
get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrixget_value_matrix
替代
scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrixscale_matrix
另见
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
模块
基础