aclnnEluBackward

产品支持情况

产品	是否支持
[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]	√
[object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]	√
[object Object]Atlas 200I/500 A2 推理产品[object Object]	×
[object Object]Atlas 推理系列产品 [object Object]	√
[object Object]Atlas 训练系列产品[object Object]	√

功能说明

• 算子功能：undefined激活函数的反向计算，输出ELU激活函数正向输入的梯度。

• 计算公式：$x$是selfOrResult中的某个元素。

  • 当isResult是True时：

    $$gradInput = gradOutput * \begin{cases} scale, \quad x > 0\\ inputScale \ast (x + \alpha \ast scale), \quad x \leq 0 \end{cases}$$

  • 当isResult是False时：

    $$gradInput = gradOutput * \begin{cases} scale, \quad x > 0\\ inputScale \ast \alpha \ast scale \ast exp(x \ast inputScale), \quad x \leq 0 \end{cases}$$

函数原型

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

• aclnnStatus aclnnEluBackwardGetWorkspaceSize(const aclTensor* gradOutput, const aclScalar* alpha, const aclScalar* scale, const aclScalar* inputScale, bool isResult, const aclTensor* selfOrResult, aclTensor* gradInput, uint64_t* workspaceSize, aclOpExecutor** executor)
• aclnnStatus aclnnEluBackward(void* workspace, uint64_t workspaceSize, aclOpExecutor* executor, aclrtStream stream)

aclnnEluBackwardGetWorkspaceSize

• 参数说明：

  • gradOutput（aclTensor*，计算输入）：表示ELU激活函数正向输出的梯度，公式中的$gradInput$，Device侧的aclTensor，支持undefined，undefined支持ND，数据维度支持0-8维。

    • [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]：数据类型支持FLOAT、FLOAT16。支持空Tensor。
    • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型支持FLOAT、FLOAT16、BFLOAT16。

  • alpha（aclScalar*，计算输入）：表示ELU激活函数的激活系数，公式中的 $\alpha$，如果isResult为true，$\alpha$ 必须大于等于0。Host侧的aclScalar，数据类型需要是可转换为FLOAT的数据类型（参见undefined）。

  • scale（aclScalar*，计算输入）：表示ELU激活函数的缩放系数，公式中的 $scale$，Host侧的aclScalar，数据类型需要是可转换为FLOAT的数据类型（参见undefined）。

  • inputScale（aclScalar*，计算输入）：表示ELU激活函数的输入的缩放系数，公式中的 $inputScale$，Host侧的aclScalar，数据类型需要是可转换为FLOAT的数据类型（参见undefined）。

  • isResult（bool，计算输入）：表示传给ELU反向计算的输入是否是ELU正向的输出。

  • selfOrResult（aclTensor*，计算输入）：当isResult为True时，表示ELU激活函数正向的输出，当isResult为False时，表示ELU激活函数正向的输入，Device侧的aclTensor，数据类型需要与gradOutput一致。shape需要与gradOutput的shape一致，支持undefined，undefined支持ND，数据维度支持0-8维。支持空Tensor。

    • [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]：数据类型支持FLOAT、FLOAT16。
    • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型支持FLOAT、FLOAT16、BFLOAT16。

  • gradInput（aclTensor*，计算输出）：表示ELU激活函数正向输入的梯度，即对输入进行求导后的结果，公式中的 $gradOutput$，Device侧的aclTensor，数据类型需要是gradOutput推导之后可转换的数据类型（参见undefined），shape需要和gradOutput的shape一致，支持undefined，undefined支持ND，数据维度不支持8维以上。

    • [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]：数据类型支持FLOAT、FLOAT16。
    • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型支持FLOAT、FLOAT16、BFLOAT16。

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

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

• 返回值：

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

  [object Object]

aclnnEluBackward

• 参数说明：

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

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

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

  • stream（aclrtStream，入参）：指定执行任务的Stream。

• 返回值：

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

约束说明

无。

调用示例

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