昇腾社区首页
中文
注册

aclnnNormalTensorTensor

产品支持情况

产品 是否支持
[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]

功能说明

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

函数原型

每个算子分为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)

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,入参):指定执行任务的Stream。

  • 返回值:

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

约束说明

无。

调用示例

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

[object Object]