aclnnSliceV2

支持的产品型号

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

接口原型

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

aclnnStatus aclnnSliceV2GetWorkspaceSize(const aclTensor* self, const aclIntArray* starts, const aclIntArray* ends, const aclIntArray* axes, const aclIntArray* steps, aclTensor* out, uint64_t* workspaceSize, aclOpExecutor** executor)
aclnnStatus aclnnSliceV2(void* workspace, uint64_t workspaceSize, aclOpExecutor* executor, aclrtStream stream)

功能描述

算子功能：根据给定的维度 $axes$ 、范围 $[starts, ends]$ 和步长 $steps$ ，从输入张量 $self$ 中提取张量 $out$ 。 $starts[i]$ 和 $ends[i]$ 可以取 $[0, self.shape[axes[i]]]$ 以外的值，取值后根据以下公式转换为合法值，假设 $self.shape[axes[i]] = N$ ：

starts[i] = \begin{cases} &0, & if\;starts[i] < -N \\ &N, & if\;starts[i] >= N\\ &(starts[i]+N) \% N, & otherwise \end{cases}

ends[i] = \begin{cases} &N, & if\; ends[i] >= N\\ &starts, & else\;if\; (ends[i]+N)\%N < starts[i] \\ &(ends[i]+N)\%N, & otherwise\\ \end{cases}

$out.shape$ 与 $self.shape$ 在axes中的轴上不一致，其他轴一致:

out.shape[axes[i]] = ⌊\frac{ends[i] - starts[i] + steps[i] - 1}{steps[i]}⌋

aclnnSliceV2GetWorkspaceSize

参数说明：
- self(aclTensor*, 计算输入)：Device侧的aclTensor，公式中的 $self$ 。shape支持0到8维，self和out的数据类型一致，支持undefined，undefined支持ND。
  - Atlas 训练系列产品：数据类型支持FLOAT、FLOAT16、INT32、INT64、INT8、UINT8、BOOL。
  - Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、FLOAT16、INT32、INT64、INT8、UINT8、BOOL、BFLOAT16。
- starts(aclIntArray*, 计算输入)：Host侧的aclIntArray，公式中的 $starts$ ，切片位置的起始索引。starts、ends、axes、steps的元素个数相同。
- ends(aclIntArray*, 计算输入)：Host侧的aclIntArray，公式中的 $ends$ ，切片位置的终止索引。starts、ends、axes、steps的元素个数相同。
- axes(aclIntArray*, 计算输入)：Host侧的aclIntArray，公式中的 $axes$ ，切片的轴。starts、ends、axes、steps的元素个数相同，axes的元素需要在[-self.dim(), self.dim() - 1]范围内，且表示的轴不能重复。
- steps(aclIntArray*, 计算输入)：Host侧的aclIntArray，公式中的 $steps$ ，切片的步长。starts、ends、axes、steps的元素个数相同，steps的元素均为正整数。
- out(aclTensor*, 计算输出)：Device侧的aclTensor，公式中的 $out$ 。shape支持0到8维，shape满足功能描述中的推导规则，self和out的数据类型一致，支持undefined，undefined支持ND。
  - Atlas 训练系列产品：数据类型支持FLOAT、FLOAT16、INT32、INT64、INT8、UINT8、BOOL。
  - Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、FLOAT16、INT32、INT64、INT8、UINT8、BOOL、BFLOAT16。
- workspaceSize(uint64_t*, 出参)：返回需要在Device侧申请的workspace大小。
- executor(aclOpExecutor**, 出参)：返回op执行器，包含了算子计算流程。
返回值：

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

[object Object]

aclnnSliceV2

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

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

约束与限制

无

调用示例

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

[object Object]