昇腾社区首页
中文
注册

aclnnVar

支持的产品型号

  • Atlas 训练系列产品。
  • Atlas A2训练系列产品。

接口原型

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

  • aclnnStatus aclnnVarGetWorkspaceSize(const aclTensor *self, const aclIntArray *dim, bool unbiased, bool keepdim, aclTensor *out, uint64_t *workspaceSize, aclOpExecutor **executor)
  • aclnnStatus aclnnVar(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

  • 算子功能:返回输入Tensor指定维度的值求得的方差。
  • 计算公式:假设 dim 为 ii,则对该维度进行计算。NN为该维度的 shape。取 selfiself_{i},求出该维度上的平均值 xiˉ\bar{x_{i}}out=1NδNj=0N1(selfijxiˉ)2out = \frac{1}{N - \delta N}\sum_{j=0}^{N-1}(self_{ij}-\bar{x_{i}})^2 unbiased = true时,需加入无偏估计,δN=1\delta N = 1unbiased = false时,需加入无偏估计,δN=0\delta N = 0; 当keepdim = true时,reduce 后保留该维度,且输出 shape 中该维度值为 1;当 keepdim = false时,不保留该维度。

aclnnVarGetWorkspaceSize

  • 参数说明:

    • self(aclTensor*, 计算输入):公式中的输入self,数据类型支持FLOAT、FLOAT16,与out的数据类型需满足数据类型推导规则(参见),支持支持ND。
    • dim(aclIntArray*,入参):表示需要用于计算方差的维度,支持数据类型为INT64,其中的数据范围为[-self.dim(), self.dim()-1],且其中的数据不能相同。
    • unbiased(bool,入参):表示计算方差时是否进行无偏估计,数据类型为bool。
    • keepdim(bool,入参):reduce轴的维度是否保留。数据类型为bool。
    • out(aclTensor*, 计算输出):公式中的输入out,数据类型支持FLOAT、FLOAT16,与self的数据类型需满足数据类型推导规则(参见),支持支持ND。
    • workspaceSize(uint64_t*, 出参):返回用户需要在Device侧申请的workspace大小。
    • executor(aclOpExecutor**, 出参):返回op执行器,包含了算子计算流程。
  • 返回值:

    aclnnStatus: 返回状态码,具体参见

    [object Object]

aclnnVar

  • 参数说明:

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

    aclnnStatus:返回状态码,具体参见

调用示例

[object Object]