aclnnRepeat

支持的产品型号

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

接口原型

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

• aclnnStatus aclnnRepeatGetWorkspaceSize(const aclTensor *self, const aclIntArray *repeats, aclTensor *out, uint64_t *workspaceSize, aclOpExecutor **executor)
• aclnnStatus aclnnRepeat(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

算子功能：对输入tensor沿着repeats中对每个维度指定的复制次数进行复制。示例： 假设输入Tensor为[[a,b],[c,d],[e,f]]，即shape为[3,2]，repeats为(2,4)，则生成的Tensor的shape为[6,8]，值如下所示：

当repeats为(2,4,2)时，即repeats的元素个数大于Tensor中的维度，则输出Tensor等效为如下操作：先将输入Tensor的shape扩张到和repeats个数相同的维度：[1,3,2]，而后按照对应维度和repeats的值进行扩张，即输出Tensor的shape为[2,12,4]，结果如下：

计算时需要满足以下条件：
repeats中参数个数不能少于输入Tensor的维度。
repeats中的值必须大于等于0。

aclnnRepeatGetWorkspaceSize

• 参数说明：

  • self(const aclTensor *，计算输入)：Device侧的aclTensor。支持undefined，undefined支持ND，维度不大于8。

    • Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、DOUBLE、FLOAT16、COMPLEX64、COMPLEX128、UINT8、INT8、INT16、INT32、INT64、UINT16、UINT32、UINT64、BOOL、BFLOAT16
    • Atlas 训练系列产品、Atlas 推理系列产品：数据类型支持FLOAT、DOUBLE、FLOAT16、COMPLEX64、COMPLEX128、UINT8、INT8、INT16、INT32、INT64、UINT16、UINT32、UINT64、BOOL

  • repeats(const aclIntArray *，计算输入)：Host侧的aclIntArray，数据类型支持INT64，表示沿每个维度重复输入tensor的次数, 参数个数不大于8, 当前不支持对超过4个维度同时做repeat的场景, 详细约束请见约束与限制。

  • out(aclTensor *，计算输出)：Device侧的aclTensor。支持undefined，undefined支持ND，维度不大于8，且类型需要与self一致。

    • Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、DOUBLE、FLOAT16、COMPLEX64、COMPLEX128、UINT8、INT8、INT16、INT32、INT64、UINT16、UINT32、UINT64、BOOL、BFLOAT16
    • Atlas 训练系列产品、Atlas 推理系列产品：数据类型支持FLOAT、DOUBLE、FLOAT16、COMPLEX64、COMPLEX128、UINT8、INT8、INT16、INT32、INT64、UINT16、UINT32、UINT64、BOOL

  • workspaceSize(uint64_t *，出参)：返回需要在Device侧申请的workspace大小。

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

• 返回值：

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

  [object Object]

aclnnRepeat

• 参数说明：

  • workspace(void *，入参)：在Device侧申请的workspace内存地址。

  • workspaceSize(uint64_t，入参)：在Device侧申请的workspace大小，由第一段接口aclnnSeluGetWorkspaceSize获取。

  • executor(aclOpExecutor *，入参)：op执行器，包含了算子计算流程。

  • stream(aclrtStream，入参)：指定执行任务的 AscendCL Stream流。

• 返回值：

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

约束与限制

repeat功能内部broadcast的kernel有最大8维度的限制，暂不支持扩维度后超过8维的场景，详细如下：
限制1. 当需要对第一根轴进行repeat时，最大支持同时对4个维度进行repeat操作(即repeats的参数非1格式不超过4)。

限制2. 当不需要对第一根轴进行repeat时，最大支持同时对3个维度进行repeat操作(即repeats的参数非1格式不超过3)。

调用示例

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