aclnnInplaceFillDiagonal

支持的产品型号

• Atlas 推理系列产品。
• Atlas 训练系列产品。
• Atlas A2训练系列产品/Atlas 800I A2推理产品。

接口原型

每个算子分为，必须先调用“aclnnInplaceFillDiagonalGetWorkspaceSize”接口获取入参并根据计算流程计算所需workspace大小，再调用“aclnnInplaceFillDiagonal”接口执行计算。

• aclnnStatus aclnnInplaceFillDiagonalGetWorkspaceSize(aclTensor *selfRef, const aclScalar *fillValue, bool wrap, uint64_t *workspaceSize, aclOpExecutor **executor)
• aclnnStatus aclnnInplaceFillDiagonal(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

• 算子功能：以fillValue填充tensor对角线。
• 计算公式：以二维为例，wrap为False时，填充位置为 [r, r]，其中0 <= r < m，m = min(col, row)，col为列的长度，row为行的长度。wrap为True时，填充位置为 [r + (m + 1) * i , r]，其中0 <= r < m，m = min(col, row)，col为列的长度，row为行的长度，0 <= i < col // r。

aclnnInplaceFillDiagonalGetWorkspaceSize

• 参数说明

  • selfRef(aclTensor*, 计算输入/输出)：Device侧的aclTensor，数据类型支持FLOAT16、FLOAT、DOUBLE、INT8、INT16、INT32、INT64、UINT8、BOOL。支持，支持ND。
  • fillValue(aclScalar*, 计算输入)：Host侧的aclScalar，数据类型需要是可转换为FLOAT的数据类型。
  • wrap(bool, 计算输入)：输入wrap，数据类型支持BOOL。对于高矩阵（行数row大于列数col），若为True，每经过N行形成一条新的对角线，其中N = min(col, row)。
  • workspaceSize(uint64_t*, 出参)：返回用户需要在Device侧申请的workspace大小。
  • executor(aclOpExecutor**, 出参)：返回op执行器，包含了算子计算流程。

• 返回值：

  aclnnStatus：返回状态码，具体参见。

  [object Object]

aclnnInplaceFillDiagonal

• 参数说明

  • workspace(void*, 入参)：在Device侧申请的workspace内存地址。
  • workspaceSize(uint64_t, 入参)：在Device侧申请的workspace大小，由第一段接口aclnnInplaceFillDiagonalGetWorkspaceSize获取。
  • executor(aclOpExecutor*, 入参)：op执行器，包含了算子计算流程。
  • stream(aclrtStream, 入参)：指定执行任务的 AscendCL Stream流。

• 返回值：

  aclnnStatus：返回状态码，具体参见。

约束与限制

• 无

调用示例

示例代码如下，仅供参考，具体编译和执行过程请参考。