昇腾社区首页
中文
注册

aclnnDiv&aclnnInplaceDiv

支持的产品型号

  • [object Object]Atlas 训练系列产品[object Object]。
  • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品[object Object]。
  • [object Object]Atlas 200I/500 A2 推理产品[object Object]。

接口原型

  • aclnnDiv和aclnnInplaceDiv实现相同的功能,使用区别如下,请根据自身实际场景选择合适的算子。
    • aclnnDiv:需新建一个输出张量对象存储计算结果。
    • aclnnInplaceDiv:无需新建输出张量对象,直接在输入张量的内存中存储计算结果。
  • 每个算子分为,必须先调用“aclnnDivGetWorkspaceSize”或者“aclnnInplaceDivGetWorkspaceSize”接口获取计算所需workspace大小以及包含了算子计算流程的执行器,再调用“aclnnDiv”或者“aclnnInplaceDiv”接口执行计算。
    • aclnnStatus aclnnDivGetWorkspaceSize(const aclTensor *self, const aclTensor *other, aclTensor *out, uint64_t *workspaceSize, aclOpExecutor **executor)
    • aclnnStatus aclnnDiv(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)
    • aclnnStatus aclnnInplaceDivGetWorkspaceSize(aclTensor *selfRef, const aclTensor *other, uint64_t *workspaceSize, aclOpExecutor **executor)
    • aclnnStatus aclnnInplaceDiv(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

  • 算子功能:完成除法计算
  • 计算公式:outi=inputiotheriout_i = \frac{input_i}{other_i}
  • 例外说明:当涉及Complex运算时,且分母的模为0时,仍然采用通用的复数计算公式,不做特殊处理,此处表现和CPU/GPU存在差异。

aclnnDivGetWorkspaceSize

  • 参数说明:

    • self(aclTensor*, 计算输入): 公式中的输入input,Device侧的aclTensor,数据类型与other的数据类型需满足数据类型推导规则(参见),shape需要与other满足。支持支持ND。

      • [object Object]Atlas 200I/500 A2 推理产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64。
      • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16。
    • other(aclTensor*, 计算输入): 公式中的输入other,Device侧的aclTensor,数据类型与self的数据类型需满足数据类型推导规则(参见),shape需要与self满足。支持支持ND。

      • [object Object]Atlas 200I/500 A2 推理产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64。
      • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16。
    • out(aclTensor*, 计算输出): 公式中的out,Device侧的aclTensor,数据类型需要是self与other推导之后可转换的数据类型,shape需要是self与other broadcast之后的shape。支持支持ND。

      • [object Object]Atlas 200I/500 A2 推理产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64。
      • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16。
    • workspaceSize(uint64_t*, 出参): 返回需要在Device侧申请的workspace大小。

    • executor(aclOpExecutor**, 出参): 返回op执行器,包含了算子计算流程。

  • 返回值:

    aclnnStatus:返回状态码,具体参见

[object Object]

aclnnDiv

  • 参数说明:

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

    aclnnStatus:返回状态码,具体参见

aclnnInplaceDivGetWorkspaceSize

  • 参数说明:

    • selfRef(aclTensor*, 计算输入|输出): 公式中的input|out,Device侧的aclTensor,数据类型与other的数据类型需满足数据类型推导规则(参见),数据类型需要是selfRef与other推导之后可转换的数据类型(参见),shape需要与other满足。支持支持ND。

      • [object Object]Atlas 200I/500 A2 推理产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64。
      • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16。
    • other(aclTensor*, 计算输入): 公式中的输入other,Device侧的aclTensor,数据类型与selfRef的数据类型需满足数据类型推导规则(参见),shape需要与selfRef满足。支持支持ND。

      • [object Object]Atlas 200I/500 A2 推理产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64。
      • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品[object Object]:数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT16、INT8、UINT8、BOOL、COMPLEX128、COMPLEX64、BFLOAT16。
    • workspaceSize(uint64_t*, 出参): 返回需要在Device侧申请的workspace大小。

    • executor(aclOpExecutor**, 出参): 返回op执行器,包含了算子计算流程。

  • 返回值:

    aclnnStatus:返回状态码,具体参见

[object Object]

aclnnInplaceDiv

  • 参数说明:

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

    aclnnStatus:返回状态码,具体参见

约束与限制

调用示例

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

[object Object]