aclnnLogSumExp

支持的产品型号

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

接口原型

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

aclnnStatus aclnnLogSumExpGetWorkspaceSize(const aclTensor* self, const aclIntArray* dim, bool keepDim, aclTensor* out, uint64_t* workspaceSize, aclOpExecutor** executor)
aclnnStatus aclnnLogSumExp(void* workspace, uint64_t workspaceSize, aclOpExecutor* executor, aclrtStream stream)

功能描述

算子功能：返回输入tensor指定维度上的指数之和的对数。
计算公式：公式中i为dim指定的维度，j为输入在指定维度上的元素索引。
$logsumexp(x)_i = log\sum_{j} exp(x_{ij} )$
示例

[object Object]

aclnnLogSumExpGetWorkspaceSize

参数说明：
- self（aclTensor*, 计算输入）：公式中的self，Device侧的aclTensor。shape支持0-8维，数据类型需要可转换成out数据类型（参见undefined）。支持undefined，undefined支持ND。
  - Atlas 推理系列产品、Atlas 训练系列产品：数据类型支持FLOAT、FLOAT16、INT32、INT64、INT16、INT8、UINT8、BOOL。
  - Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、FLOAT16、BFLOAT16、INT32、INT64、INT16、INT8、UINT8、BOOL。
- dim（aclIntArray*，计算输入）：参与计算的维度，公式中的i，Host侧的aclIntArray。取值范围为[-self.dim(), self.dim()-1]，支持的数据类型为INT32、INT64。
- keepDim（bool, 计算输入）：决定reduce轴的维度是否保留，HOST侧的BOOL常量。
- out（aclTensor*, 计算输入）：公式中的 $logsumexp(x)$ ，Device侧的aclTensor。shape支持0-8维。若keepDim为true，除dim指定维度上的size为1以外，其余维度的shape需要与self保持一致；若keepDim为false，reduce轴的维度不保留，其余维度shape需要与self一致。数据类型需要可转换成self数据类型（参见undefined）。支持undefined，undefined支持ND。
  - Atlas 推理系列产品、Atlas 训练系列产品：数据类型支持FLOAT、FLOAT16。
  - Atlas A2训练系列产品/Atlas 800I A2推理产品：数据类型支持FLOAT、FLOAT16、BFLOAT16。
- workspaceSize（uint64_t*, 出参）：返回需要在Device侧申请的workspace大小。
- executor（aclOpExecutor**, 出参）：返回op执行器，包含了算子计算流程。
返回值：

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

[object Object]

aclnnLogSumExp

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

约束与限制

无。

调用示例

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

[object Object]