aclnnUniqueDim

支持的产品型号

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

接口原型

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

• aclnnStatus aclnnUniqueDimGetWorkspaceSize(const aclTensor* self, bool sorted, bool returnInverse, int64_t dim, aclTensor* valueOut, aclTensor* inverseOut, aclTensor* countsOut, uint64_t* workspaceSize, aclOpExecutor** executor)
• aclnnStatus aclnnUniqueDim(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

• 算子功能：在某一dim轴上，对输入张量self做去重操作。
• 示例：假设self为$$\begin{bmatrix} \begin{bmatrix} 2 & 1 & 2 \end{bmatrix}\\ \begin{bmatrix} 1 & 2 & 1 \end{bmatrix}\\ \begin{bmatrix} 2 & 1 & 2 \end{bmatrix}\\ \end{bmatrix}$$ dim为0，则valueOut为：$$\begin{bmatrix} \begin{bmatrix} 2 & 1 & 2 \end{bmatrix}\\ \begin{bmatrix} 1 & 2 & 1 \end{bmatrix}\\ \end{bmatrix}$$ inverseOut为：$$\begin{bmatrix} 0 & 1 & 0 \end{bmatrix}$$ countsOut为：$$\begin{bmatrix} 1 & 2 \end{bmatrix}$$

aclnnUniqueDimGetWorkspaceSize

• 参数说明：

  • self（aclTensor*, 计算输入）：示例中的self，Device侧的aclTensor。shape支持0-8维。支持，支持ND。
    • Atlas 训练系列产品：数据类型支持FLOAT、FLOAT16、UINT8、INT8、UINT16、INT16、UINT32、INT32、UINT64、INT64、DOUBLE、BOOL。
    • Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、FLOAT16、UINT8、INT8、UINT16、INT16、UINT32、INT32、UINT64、INT64、DOUBLE、BOOL、BFLOAT16。
  • sorted（bool, 计算输入）：表示返回的输出结果valueOut是否排序。
  • returnInverse（bool, 计算输入）：表示是否返回self在dim轴上各元素在valueOut中对应元素的位置下标，True时返回，False时不返回。
  • dim（int64_t, 计算输入）：示例中的dim，Host侧的整型，指定做去重操作的维度，数据类型支持INT64，取值范围为[-self.dim(), self.dim())。
  • valueOut（aclTensor*, 计算输出）：示例中的valueOut，表示去重结果，Device侧的aclTensor。数据类型与self一致。支持，支持ND。
    • Atlas 训练系列产品：数据类型支持FLOAT、FLOAT16、UINT8、INT8、UINT16、INT16、UINT32、INT32、UINT64、INT64、DOUBLE、BOOL。
    • Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、FLOAT16、UINT8、INT8、UINT16、INT16、UINT32、INT32、UINT64、INT64、DOUBLE、BOOL、BFLOAT16。
  • inverseOut（aclTensor*, 计算输出）：示例中的inverseOut，表示self在dim轴上各元素在valueOut中对应元素的位置下标，，Device侧的aclTensor，数据类型支持INT64。
  • countsOut（aclTensor*,计算输出）：示例中的countsOut，表示valueOut中的各元素在self中出现的次数，，Device侧的aclTensor，数据类型支持INT64。
  • workspaceSize（uint64_t*, 出参）：返回需要在Device侧申请的workspace大小。
  • executor（aclOpExecutor**, 出参）：返回op执行器，包含了算子计算流程。

• 返回值：

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

  [object Object]

aclnnUniqueDim

• 参数说明：

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

• 返回值：

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

约束与限制

无

调用示例

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