aclnnGatherNd

产品支持情况

[object Object]undefined

功能说明

• 接口功能：对于维度为r≥1的输入张量[object Object]，和维度q≥1的输入张量[object Object]，将数据切片收集到维度为 (q-1) + (r - indices_shape[-1]) 的输出张量out中。indices是一个q维的整型张量，可视作一个q-1维的由索引对构成的特殊张量（每个索引对是一个长度为indices_shape[-1]的一维张量，每个索引对指向self中一个切片）。

• 计算逻辑：

  • 如果indices_shape[-1] > r，不合法场景。
  • 如果indices_shape[-1] = r，则输出张量out的维度为q-1，即out的shape为 [indices_shape[0:q-1]]，out中元素为self的索引对位置的元素。（见例1）
  • 如果indices_shape[-1] < r，则输出张量out的维度为 (q-1) + (r - indices_shape[-1])，设c=indices_shape[-1]，即out的shape为 [indices_shape[0:q-1],self_shape[c:r]] ，[object Object]由[object Object]的索引对位置的切片组成。（见例2、例3、例4）

  关于r、q、indices_shape[-1] 的一些限制条件如下：

  • 必须满足r≥1，q≥1。
  • indices_shape[-1]的值必须满足在1（包含）和r（包含）之间。
  • [object Object]的每个元素，必须在[-s, s-1]范围内(s为self_shape各个轴上的值)，即-self_shape[i]≤indices[...,i]≤self_shape[i]-1。

• 示例：

  [object Object]

函数原型

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

aclnnGatherNdGetWorkspaceSize

• 参数说明

  [object Object]
  • [object Object]Atlas A2 训练系列产品/Atlas A2 推理系列产品[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型不支持DOUBLE、INT16、UINT16、UINT32、UINT64。
  • [object Object]Atlas 训练系列产品[object Object]、[object Object]Atlas 推理系列产品[object Object]：数据类型不支持BFLOAT16、DOUBLE、INT16、UINT16、UINT32、UINT64。

• 返回值

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

  第一段接口完成入参校验，出现以下场景时报错：

  [object Object]

aclnnGatherNd

• 参数说明

  [object Object]

• 返回值：

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

约束说明

• 确定性计算：
  • aclnnGatherNd默认确定性实现。

调用示例

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