aclnnTriu&aclnnInplaceTriu

产品支持情况

[object Object]undefined

功能说明

• 算子功能：将输入的self张量的最后二维（按shape从左向右数）沿对角线的左下部分置零。参数diagonal可正可负，默认为零，正数表示主对角线向右上方向移动，负数表示主对角线向左下方向移动。

• 计算公式：下面用i表示遍历倒数第二维元素的序号（i是行索引），用j表示遍历最后一维元素的序号（j是列索引），用d表示diagonal，在(i, j)对应的二维坐标图中，i+d==j表示在对角线上。

  $$对角线及其右上方，即i+d<=j，保留原值： out_{i, j} = self_{i, j}\\ 而位于对角线左下方的情况，即i+d>j，置零（不含对角线）：out_{i, j} = 0$$

• 示例：

  $self = \begin{bmatrix} [9&6&3] \\ [1&2&3] \\ [3&4&1] \end{bmatrix}$， triu(self, diagonal=0)的结果为： $\begin{bmatrix} [9&6&3] \\ [0&2&3] \\ [0&0&1] \end{bmatrix}$； 调整diagonal的值，triu(self, diagonal=1)结果为： $\begin{bmatrix} [0&6&3] \\ [0&0&3] \\ [0&0&0] \end{bmatrix}$； 调整diagonal为-1，triu(self, diagonal=-1)结果为： $\begin{bmatrix} [9&6&3] \\ [1&2&3] \\ [0&4&1] \end{bmatrix}$。

函数原型

• aclnnTriu和aclnnInplaceTriu实现相同的功能，使用区别如下，请根据自身实际场景选择合适的算子。
  • aclnnTriu：需新建一个输出张量对象存储计算结果。
  • aclnnInplaceTriu：无需新建输出张量对象，直接在输入张量的内存中存储计算结果。
• 每个算子分为，必须先调用 “aclnnTriuGetWorkspaceSize” 或者 “aclnnInplaceTriuGetWorkspaceSize” 接口获取入参并根据计算流程计算所需workspace大小，再调用 “aclnnTriu” 或者 “aclnnInplaceTriu” 接口执行计算。

aclnnTriuGetWorkspaceSize

• 参数说明：

[object Object]

• 返回值：

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

第一段接口完成入参校验，出现以下场景时报错： [object Object][object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]返回值[object Object] [object Object]错误码[object Object] [object Object]描述[object Object] [object Object][object Object] [object Object] [object Object] [object Object]ACLNN_ERR_PARAM_NULLPTR[object Object] [object Object]161001[object Object] [object Object]参数self、out是空指针。[object Object] [object Object] [object Object] [object Object]ACLNN_ERR_PARAM_INVALID[object Object] [object Object]161002[object Object] [object Object]参数self、out的数据类型不在支持范围内。[object Object] [object Object] [object Object] [object Object]参数self、out的数据格式是私有格式。[object Object] [object Object] [object Object] [object Object]self、out的数据类型不一致。[object Object] [object Object] [object Object] [object Object]self、out的shape不一致。[object Object] [object Object] [object Object] [object Object]self、out的数据格式不一致。[object Object] [object Object] [object Object] [object Object]self维度大于8，或小于2。[object Object] [object Object] [object Object] [object Object]

aclnnTriu

• 参数说明：

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

[object Object]

• 返回值：

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

aclnnInplaceTriuGetWorkspaceSize

• 参数说明：

[object Object]

• 返回值：

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

第一段接口完成入参校验，出现以下场景时报错： [object Object][object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]返回值[object Object] [object Object]错误码[object Object] [object Object]描述[object Object] [object Object][object Object] [object Object] [object Object] [object Object]ACLNN_ERR_PARAM_NULLPTR[object Object] [object Object]161001[object Object] [object Object]参数selfRef是空指针。[object Object] [object Object] [object Object] [object Object]ACLNN_ERR_PARAM_INVALID[object Object] [object Object]161002[object Object] [object Object]参数selfRef数据类型不在支持范围内。[object Object] [object Object] [object Object] [object Object]参数selfRef的数据格式是私有格式。[object Object] [object Object] [object Object] [object Object]selfRef维度大于8，或小于2。[object Object] [object Object] [object Object] [object Object]

aclnnInplaceTriu

• 参数说明：

[object Object]

• 返回值：

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

约束说明

• 确定性计算：
  • aclnnTriu&aclnnInplaceTriu默认确定性实现。

调用示例

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