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。