Cal

产品支持情况

功能说明

接口功能：

• asdBlasMakeCalPlan：初始化该句柄对应的Cal算子配置。
• asdBlasSscal：对一个实数向量进行缩放，即将向量中的每个元素乘以一个实数alpha。
• asdBlasCsscal：对一个复数向量进行缩放，即将向量中的每个元素乘以一个实数alpha。
• asdBlasCscal：对一个复数向量进行缩放，即将向量中的每个元素乘以一个复数alpha。

计算公式

• asdBlasSscal的计算公式：
  • 示例：

    输入“x”为：

    [3.0, 4.0]

    输入“alpha”为2.0

    调用“Sscal”算子后，

    输出“x”为：

    [6.0, 8.0]

• asdBlasCsscal的计算公式：
  • 示例：

    输入“x”为：

    [3.0 + 4.0j, 4.0 + 4.0j]

    输入“alpha”为：2.0

    调用“Csscal”算子后，

    输出“x”为：

    [6.0 + 8.0j, 8.0 + 8.0j]

• asdBlasCscal的计算公式：
  • 示例：

    输入“x”为：

    [3.0 + 4.0j, 4.0 + 4.0j]

    输入“alpha”为：

    (3.0 + 4.0j)

    调用“Cscal”算子后，

    输出“x”为：

    [-7.0 + 24.0j, -4.0 + 28.0j]

函数原型

• AspbStatus asdBlasMakeCalPlan(asdBlasHandle handle)
• AspbStatus asdBlasSscal(asdBlasHandle handle, const int64_t n, const float *alpha, aclTensor *x, const int64_t incx)
• AspbStatus asdBlasCsscal(asdBlasHandle handle, const int64_t n, const float *alpha, aclTensor *x, const int64_t incx)
• AspbStatus asdBlasCscal(asdBlasHandle handle, const int64_t n, const std::complex<float> *alpha, aclTensor *x,const int64_t incx)

参数说明

• asdBlasMakeCalPlan

  参数名称	Input/Output	类型	描述
  handle	Input	asdBlasHandle	cal算子的句柄。

• asdBlasSscal & asdBlasCsscal & asdBlasCscal

  参数名称	Input/Output	类型	描述
  handle	Input	asdBlasHandle	sscal算子的句柄。
  n	Input	const int64_t	总的元素个数。
  alpha	Input	const float *	公式中的alpha，向量的缩放因子。
  x	Input/Output	aclTensor *	公式中的x，Device侧的Tensor，数据类型支持FLOAT32，数据格式支持ND，shape为[n]。
  incx	Input	const int64_t	相邻元素间的内存地址偏移量（当前约束为1）。

返回值说明

返回值相关说明参见返回值。

约束说明

• asdBlasMakeCalPlan：无。
• asdBlasSscal
  • 输入的元素个数当前覆盖支持[1，6.71e+06]；
  • 算子输入shape为[n]，输出shape为[n]；
  • 算子实际计算时，不支持ND高维度运算（不支持维度≥3的运算）。
• asdBlasCsscal
  • 输入的元素个数当前覆盖支持[1，6.71e+06]；
  • 算子输入shape为[n]，输出shape为[n]；
  • 算子实际计算时，不支持ND高维度运算（不支持维度≥3的运算）。
• asdBlasCscal
  • 输入的元素个数当前覆盖支持[1，6.71e+06]；
  • 算子输入shape为[n]，输出shape为[n]；
  • 算子实际计算时，不支持ND高维度运算（不支持维度≥3的运算）

调用示例

算子的调用示例参见Cal。