ForeachSubList

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	×
Atlas 推理系列产品	×
Atlas 训练系列产品	×
Kirin X90 处理器系列产品	√
Kirin 9030 处理器系列产品	√

功能说明

• 算子功能：对输入的两个张量列表执行逐元素相减运算，并可以通过alpha参数调整相减系数。

• 计算公式：

  $$\begin{gathered} x1=[x{1}_0,x{1}_1,...x{1}_{n-1}] \\ x2=[x{2}_0,x{2}_1,...x{2}_{n-1}] \\ y=[y_0,y_1,...y_{n-1}] \end{gathered}$$

  $$y_i=x{1}_i-x{2}_i\ast alpha(i=0,1,...n-1)$$

参数说明

参数名	输入/输出/属性	描述	数据类型	数据格式
x1	输入	表示进行相减运算的第一个输入，对应公式中的`x1`。该参数中所有Tensor的数据类型保持一致。	FLOAT32、FLOAT16、INT32、BFLOAT16	ND
x2	输入	表示进行相减运算的第二个输入，对应公式中的`x2`。该参数中所有Tensor的数据类型保持一致。数据类型、数据格式和shape与入参`x1`的数据类型、数据格式和shape一致。	FLOAT32、FLOAT16、INT32、BFLOAT16	ND
alpha	输入	表示进行相减运算的第二个输入的系数，对应公式中的`alpha`。元素个数为1。	FLOAT32、FLOAT16、INT32	ND
y	输出	表示进行相减运算的输出结果，对应公式中的`y`。该参数中所有Tensor的数据类型保持一致。数据类型和数据格式与入参`x1`的数据类型和数据格式一致，shape size大于等于入参`x1`的shape size。	FLOAT32、FLOAT16、INT32、BFLOAT16	ND

• Kirin X90/Kirin 9030处理器系列产品：不支持BFLOAT16。

约束说明

• 输出不支持非连续Tensor。

调用说明

调用方式	样例代码	说明
aclnn接口	test_aclnn_foreach_sub_list	通过aclnnForeachSubList接口方式调用ForeachSubList算子。
aclnn接口	test_aclnn_foreach_sub_list_v2	通过aclnnForeachSubListV2接口方式调用ForeachSubList算子。