算子功能: 将tensor self和tensor other进行broadcast成一致的shape后,其中的每个元素都转换为除以other的对应元素以后得到的余数。该结果与除数other同符号,并且该结果的绝对值是小于other的绝对值。 实际计算remainder(self, other) 等效于以下公式:
示例:
[object Object]
aclnnRemainderTensorTensor和aclnnInplaceRemainderTensorTensor实现相同的功能,使用区别如下,请根据自身实际场景选择合适的算子。
- aclnnRemainderTensorTensor:需新建一个输出张量对象存储计算结果。
- aclnnInplaceRemainderTensorTensor:无需新建输出张量对象,直接在输入张量的内存中存储计算结果。
每个算子分为,必须先调用“aclnnRemainderTensorTensorGetWorkspaceSize”或者”aclnnInplaceRemainderTensorTensorGetWorkspaceSize“接口获取计算所需workspace大小以及包含了算子计算流程的执行器,再调用“aclnnRemainderTensorTensor”或者”aclnnInplaceRemainderTensorTensor“接口执行计算。
[object Object][object Object][object Object][object Object]
参数说明:
- self(aclTensor*, 计算输入):公式中的
[object Object],其数据类型与other需满足,且互推导后的数据类型必须在如下范围内。shape需要与other满足。支持,支持ND,数据维度不支持8维以上。- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:互推导后的数据类型为INT32、INT64、FLOAT16、FLOAT、DOUBLE、BFLOAT16。
- [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:互推导后的数据类型为INT32、INT64、FLOAT16、FLOAT、DOUBLE。
- other(aclTensor*, 计算输入):公式中的
[object Object],其数据类型与self需满足,且互推导后的数据类型必须在如下范围内。shape需要与self满足。支持,支持ND,数据维度不支持8维以上。- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:互推导后的数据类型为INT32、INT64、FLOAT16、FLOAT、DOUBLE、BFLOAT16。
- [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:互推导后的数据类型为INT32、INT64、FLOAT16、FLOAT、DOUBLE。
- out(aclTensor*, 计算输出):公式中的输出
[object Object],数据类型需要是self与other推导之后可转换的数据类型。shape需要是self与other broadcast之后的shape。支持,支持ND,数据维度不支持8维以上。- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持UINT8、INT8、INT16、INT32、INT64、FLOAT16、FLOAT、DOUBLE、COMPLEX64、COMPLEX128、BFLOAT16。
- [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持UINT8、INT8、INT16、INT32、INT64、FLOAT16、FLOAT、DOUBLE、COMPLEX64、COMPLEX128。
- workspaceSize(uint64_t *,出参):返回需要在Device侧申请的workspace大小。
- executor(aclOpExecutor **,出参):返回op执行器,包含了算子计算流程。
- self(aclTensor*, 计算输入):公式中的
返回值:
[object Object]
参数说明:
workspace(void*,入参):在Device侧申请的workspace内存地址。
workspaceSize(uint64_t,入参):在Device侧申请的workspace大小,由第一段接口aclnnRemainderTensorTensorGetWorkspaceSize获取。
executor(aclOpExecutor*,入参):op执行器,包含了算子计算流程。
stream(aclrtStream,入参):指定执行任务的Stream。
返回值:
参数说明:
selfRef(aclTensor*, 计算输入|计算输出):输入输出tensor,selfRef的数据类型与other的数据类型需满足数据类型推导规则(参见),且需要是推导之后可转换的数据类型。shape需要与other满足,且broadcast后的shape需要与selfRef的shape一致。支持,支持ND,数据维度不支持8维以上。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持INT32、INT64、FLOAT16、FLOAT、DOUBLE、BFLOAT16。
- [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持INT32、INT64、FLOAT16、FLOAT、DOUBLE。
other(aclTensor*, 计算输入):公式中的输入
[object Object],selfRef的数据类型与other的数据类型需满足数据类型推导规则(参见)。shape需要与selfRef满足。支持,支持ND,数据维度不支持8维以上。- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持INT32、INT64、FLOAT16、FLOAT、DOUBLE、BFLOAT16。
- [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]:数据类型支持INT32、INT64、FLOAT16、FLOAT、DOUBLE。
workspaceSize(uint64_t *,出参):返回需要在Device侧申请的workspace大小。
executor(aclOpExecutor **,出参):返回op执行器,包含了算子计算流程。
-
[object Object]
参数说明:
- workspace(void*,入参):在Device侧申请的workspace内存地址。
- workspaceSize(uint64_t,入参):在Device侧申请的workspace大小,由第一段接口aclnnInplaceRemainderTensorTensorGetWorkspaceSize获取。
- executor(aclOpExecutor *,入参):op执行器,包含了算子计算流程。
- stream(aclrtStream,入参):指定执行任务的Stream。
- 当self的数据类型为INT32时,优先保障在范围[-2^24, 2^24]内的功能和精度;
- 当other为0,且self的数据类型为整型时,out的结果为self。
aclnnRemainderTensorTensor示例代码:
aclnnInplaceRemainderTensorTensor示例代码: