aclnnPowTensorScalar&aclnnInplacePowTensorScalar
支持的产品型号
- Atlas 训练系列产品。
- Atlas A2训练系列产品/Atlas 800I A2推理产品。
- Atlas 200I/500 A2推理产品。
接口原型
aclnnPowTensorScalar和aclnnInplacePowTensorScalar实现相同的功能,使用区别如下,请根据自身实际场景选择合适的算子。
- aclnnPowTensorScalar:需新建一个输出张量对象存储计算结果。
- aclnnInplacePowTensorScalar:无需新建输出张量对象,直接在输入张量的内存中存储计算结果。
每个算子分为undefined,必须先调用“aclnnPowTensorScalarGetWorkspaceSize”或者“aclnnInplacePowTensorScalarGetWorkspaceSize”接口获取计算所需workspace大小以及包含了算子计算流程的执行器,再调用“aclnnPowTensorScalar”或者“aclnnInplacePowTensorScalar”接口执行计算。
aclnnStatus aclnnPowTensorScalarGetWorkspaceSize(const aclTensor* self, const aclScalar* exponent, const aclTensor* out, uint64_t* workspaceSize, aclOpExecutor** executor)
aclnnStatus aclnnPowTensorScalar(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)
aclnnStatus aclnnInplacePowTensorScalarGetWorkspaceSize(const aclTensor* self, const aclScalar* exponent, uint64_t *workspaceSize, aclOpExecutor **executor)
aclnnStatus aclnnInplacePowTensorScalar(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)
功能描述
算子功能: exponent每个元素作为input对应元素的幂完成计算。
计算公式:
算子约束: INT32整型计算在如下范围以外的场景, 会出现超时;
shape exponent_value <=100000(十万) -200000000~200000000(两亿) <=1000000(百万) -20000000~20000000(两千万) <=10000000(千万) -2000000~2000000(两百万) <=100000000(亿) -200000~200000(二十万) <=1000000000(十亿) -20000~20000(两万)
aclnnPowTensorScalarGetWorkspaceSize
参数说明:
- self(aclTensor*,计算输入):公式中的输入
self
,Device侧的aclTensor,数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT8、UINT8、INT16、COMPLEX64、COMPLEX128、BFLOAT16(仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持)。且数据类型与exponent的数据类型需满足数据类型推导规则(参见undefined),支持undefined,且shape需要与out一致,undefined支持ND。 - exponent(aclScalar*,计算输入):公式中的输入
exponent
,Device侧的aclScalar,数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT8、UINT8、INT16、COMPLEX64、COMPLEX128、BFLOAT16(仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持),且数据类型与self的数据类型需满足数据类型推导规则(参见undefined)。 - out(aclTensor*,计算输出):公式中的输出
out
,Device侧的aclTensor,数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT8、UINT8、INT16、COMPLEX64、COMPLEX128、BFLOAT16(仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持)。支持undefined,且shape需要与self一致, 数据类型需要是self的数据类型与exponent的数据类型推导之后可转换的数据类型(参见undefined),undefined支持ND。 - workspaceSize(uint64_t*, 出参):返回需要在Device侧申请的workspace大小。
- executor(aclOpExecutor**, 出参):返回op执行器,包含了算子计算流程。
- self(aclTensor*,计算输入):公式中的输入
返回值
aclnnStatus:返回状态码,具体参见undefined。
[object Object]
aclnnPowTensorScalar
参数说明:
- workspace(void*, 入参):在Device侧申请的workspace内存地址。
- workspaceSize(uint64_t, 入参):在Device侧申请的workspace大小,由第一段接口aclnnPowTensorScalarGetWorkspaceSize获取。
- executor(aclOpExecutor*, 入参):op执行器,包含了算子计算流程。
- stream(aclrtStream, 入参):指定执行任务的 AscendCL Stream流。
返回值
aclnnStatus:返回状态码,具体参见undefined。
aclnnInplacePowTensorScalarGetWorkspaceSize
参数说明:
- selfRef(aclTensor*):公式中的输入
self/out
,Device侧的aclTensor,数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT8、UINT8、COMPLEX64、COMPLEX128、INT16、BFLOAT16(仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持),且数据类型与exponent的数据类型需满足数据类型推导规则(参见undefined),且数据类型需要是与exponent的数据类型推导之后可转换的数据类型(参见undefined),支持undefined,undefined支持ND。 - exponent(aclScalar*, 计算输入):公式中的输入
exponent
,Device侧的aclScalar,数据类型支持FLOAT、FLOAT16、DOUBLE、INT32、INT64、INT8、UINT8、COMPLEX64、COMPLEX128、INT16、BFLOAT16(仅Atlas A2训练系列产品/Atlas 800I A2推理产品支持),且数据类型与selfRef的数据类型需满足数据类型推导规则(参见undefined)。 - workspaceSize(uint64_t*, 出参):返回需要在Device侧申请的workspace大小。
- executor(aclOpExecutor**, 出参):返回op执行器,包含了算子计算流程。
- selfRef(aclTensor*):公式中的输入
返回值
aclnnStatus, 返回状态码,具体参见undefined。
[object Object]
aclnnInplacePowTensorScalar
参数说明:
- workspace(void*, 入参):在Device侧申请的workspace内存地址。
- workspaceSize(uint64_t, 入参):在Device侧申请的workspace大小,由第一段接口aclnnInplacePowTensorScalarGetWorkspaceSize获取。
- executor(aclOpExecutor*, 入参):op执行器,包含了算子计算流程。
- stream(aclrtStream, 入参):指定执行任务的 AscendCL Stream流。
返回值
aclnnStatus:返回状态码,具体参见undefined。
约束与限制
无
调用示例
示例代码如下,仅供参考,具体编译和执行过程请参考undefined。
[object Object]