aclnnInplacePut

支持的产品型号

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

接口原型

每个算子分为，必须先调用“aclnnInplacePutGetWorkspaceSize”接口获取计算所需workspace大小以及包含了算子计算流程的执行器，再调用“aclnnInplacePut”接口执行计算。

• aclnnStatus aclnnInplacePutGetWorkspaceSize(aclTensor *selfRef, const aclTensor *index, const aclTensor *source, bool accumulate,uint64_t *workspaceSize, aclOpExecutor **executor)
• aclnnStatus aclnnInplacePut(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

算子功能：将selfRef视为一维张量，把index张量中元素值作为索引，如果accumulate为true，把source中元素和selfRef对应的位置上元素做累加操作;如果accumulate为false，把source中元素替换掉selfRef对应位置上的元素。

aclnnInplacePutGetWorkspaceSize

• 参数说明：

  • selfRef(aclTensor*, 计算输入)：Device侧的aclTensor，数据类型支持情况如下：
    • 当accumulate为true时，FLOAT16、FLOAT、BOOL、INT8、UINT8、INT16、INT32、INT64、DOUBLE、COMPLEX64、COMPLEX128。
    • 当accumulate为false时，支持BOOL、FLOAT、FLOAT16、BFLOAT16（仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持）、DOUBLE、INT8、INT16、INT32、INT64、UINT8、COMPLEX64、COMPLEX128，支持，支持ND。
  • index(aclTensor*, 计算输入)： Device侧的aclTensor，数据类型支持INT32、INT64，元素个数要求和source保持一致。支持，支持ND。
  • source(aclTensor*, 计算输入): Device侧的aclTensor，数据类型和selfRef一致，元素个数和index一致。支持，支持ND。
  • accumulate(bool, 计算输入)：Host侧的布尔类型。
  • workspaceSize(uint64_t*, 出参)：返回用户需要在Device侧申请的workspace大小。
  • executor(aclOpExecutor**, 出参)：返回op执行器，包含了算子计算流程。

• 返回值：

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

  [object Object]

aclnnInplacePut

• 参数说明：

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

• 返回值：

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

约束与限制

无。

调用示例

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