aclnnBinaryCrossEntropy

支持的产品型号

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

接口原型

每个算子分为undefined，必须先调用“aclnnBinaryCrossEntropyGetWorkspaceSize”接口获取入参并根据流程计算所需workspace大小，再调用“aclnnBinaryCrossEntropy”接口执行计算。

• aclnnStatus aclnnBinaryCrossEntropyGetWorkspaceSize(const aclTensor* self, const aclTensor* target,const aclTensor* weight, int64_t reduction, aclTensor* out, uint64_t* workspaceSize, aclOpExecutor** executor)
• aclnnStatus aclnnBinaryCrossEntropy(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

• 算子功能： 计算self和target的二元交叉熵。

• 计算公式：

$$\ell(self, target)= L = \{l_{1},...,l_{n}\}^{T}, \ell_{n} = -weight_{n}[target_{n}·log(self_{n}) + (1 - target_{n}·log(1-self_{n}))]$$

当reduction不为None时

$$\ell(self, target) \begin{cases} mean(L), & if\ reduction = mean \\ sum(L), & if\ reduction = sum \\ \end{cases}$$

aclnnBinaryCrossEntropyGetWorkspaceSize

• 参数说明：

  • self(const aclTensor *, 计算输入): 公式中的输入self，表示一个概率分布。数据类型支持FLOAT16、FLOAT、BFLOAT16（仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持），undefined支持ND，取值在0~1之间。
  • target(const aclTensor *, 计算输入): 公式中的输入target，表示一个概率分布。数据类型支持FLOAT16、FLOAT、BFLOAT16（仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持），shape需要与self一致，且数据类型与self一致，undefined支持ND，取值在0~1之间。
  • weight(const aclTensor *, 计算输入): 公式中的输入weight。数据类型支持FLOAT16、FLOAT、BFLOAT16（仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持），shape需要与self一致，且数据类型与self一致,undefined支持ND，weight可以是nullptr，等价于所有权重值都是1。
  • reduction(int64_t, 计算输入): 公式中的输入reduction，输出归约的枚举值，支持三种枚举值：当取值为0，即为Reduction::None；当取值为1，即为Reduction::Mean；当取值为2，即为Reduction::Sum。
  • out(aclTensor *, 计算输出): 数据类型支持FLOAT16、FLOAT、BFLOAT16（仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持），且数据类型与self一致，如果reduction = None，shape与self一致，其他情况shape为[1],undefined支持ND。
  • workspaceSize(uint64_t *, 出参): 返回需要在Device侧申请的workspace大小。
  • executor(aclOpExecutor **, 出参): 返回op执行器，包含了算子计算流程。

• 返回值：

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

aclnnBinaryCrossEntropy

• 参数说明：

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

• 返回值：

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

约束与限制

无

调用示例

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