aclnnNormalTensorTensor

支持的产品型号

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

接口原型

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

• aclnnStatus aclnnNormalTensorTensorGetWorkspaceSize(const aclTensor *mean, const aclTensor *std, int64_t seed, int64_t offset, aclTensor *out, uint64_t *workspaceSize, aclOpExecutor **executor)
• aclnnStatus aclnnNormalTensorTensor(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

算子功能：返回一个随机数，该随机数是从给定的均值(tensor)和标准差(tensor)的独立正态分布中获取，mean和std的shape不需匹配，但是张量中元素总数需要相同。

aclnnNormalTensorTensorGetWorkspaceSize

• 参数说明：

  • mean(aclTensor*，计算输入)：生成随机数分布均值的张量，Device侧的aclTensor，数据类型支持FLOAT16、FLOAT和DOUBLE，且数据类型与std的数据类型需满足数据类型推导规则（参见undefined），shape需要与std满足undefined，且shape不超过8维，undefined支持ND。

  • std(aclTensor*，计算输入)：生成随机数分布标准差的张量，Device侧的aclTensor，数据类型支持FLOAT16、FLOAT和DOUBLE，且数据类型与mean的数据类型需满足数据类型推导规则（参见undefined），shape需要与mean满足undefined，且shape不超过8维，undefined支持ND。

  • seed(int64_t，计算输出)：采样伪随机数生成器的种子值，数据类型支持INT64。

  • offset(int64_t，计算输出)：采样伪随机数生成器的偏移量，数据类型支持INT64。

  • out(aclTensor*，计算输出): 输出张量，Device侧的aclTensor，数据类型支持FLOAT、FLOAT16和DOUBLE，且数据类型需要是mean与std推导之后可转换的数据类型，shape需要和mean与std broadcast之后的shape相等, undefined支持ND 。

  • workspaceSize(uint64_t*，出参)：返回用户需要在Device侧申请的 workspace 大小。

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

• 返回值：

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

  [object Object]

aclnnNormalTensorTensor

• 参数说明：

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

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

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

  • stream(aclrtStream，入参)：指定执行任务的 AscendCL Stream流。

• 返回值：

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

约束与限制

无。

调用示例

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