aclnnTransQuantParamV3
产品支持情况
| 产品 | 是否支持 |
|---|---|
| [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] | × |
功能说明
- 算子功能：完成量化计算参数scale数据类型的转换，将Float32的数据类型转换为硬件需要的UINT64，INT64类型。相较于aclnnTransQuantParamV2版本，增加了roundMode输入，用于选择数据类型转换过程中，数据值转换采取的转化模式。
函数原型
每个算子分为undefined，必须先调用“aclnnTransQuantParamV3GetWorkspaceSize”接口获取计算所需workspace大小以及包含了算子计算流程的执行器，再调用“aclnnTransQuantParamV3”接口执行计算。
aclnnStatus aclnnTransQuantParamV3GetWorkspaceSize(const aclTensor* scale, const aclTensor* offset, int64_t roundMode, const aclTensor* out, uint64_t* workspaceSize, aclOpExecutor** executor)aclnnStatus aclnnTransQuantParamV3(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, const aclrtStream stream)
aclnnTransQuantParamV3GetWorkspaceSize
参数说明：
- scale（aclTensor*, 计算输入）：量化参数，device侧的aclTensor，数据类型支持FLOAT32，undefined支持ND，shape是1维（t，），t = 1或n，以及2维（1，n）其中n与matmul计算中的右矩阵的shape n一致。用户需要保证scale数据中不存在nan和inf。
- offset（aclTensor*, 计算可选输入）：量化参数，device侧的aclTensor，数据类型支持FLOAT32，undefined支持ND，shape是1维（t，），以及2维（1，n），t = 1或n，其中n与matmul计算中的右矩阵的shape n一致。用户需要保证offset数据中不存在nan和inf。
- roundMode（int64_t, 计算输入）：量化计算中FP32填充到FP19的round模式，支持以下取值：0（兼容V2），1（提升计算精度）。其他值非法。
- out（aclTensor*, 计算输出）：公式中的输出out，device侧的aclTensor, 数据类型支持UINT64，INT64, 支持undefined，undefined支持ND，当输入scale的shape为1维时，out的shape也为1维，该维度的shape大小为scale与offset(若不为nullptr)单维shape大小的最大值，当输入scale的shape为2维时，out的shape与输入scale的shape维度和大小完全一致。
- workspaceSize(uint64_t*, 出参)：返回需要在Device侧申请的workspace大小。
- executor(aclOpExecutor**, 出参)：返回op执行器，包含了算子计算流程。
返回值：
aclnnStatus：返回状态码，具体参见undefined。
[object Object]
aclnnTransQuantParamV3
参数说明：
- workspace(void*, 入参)：在Device侧申请的workspace内存地址。
- workspaceSize(uint64_t, 入参)：在Device侧申请的workspace大小，由第一段接口aclnnTransQuantParamV3GetWorkspaceSize获取。
- executor(aclOpExecutor*, 入参)：op执行器，包含了算子计算流程。
- stream(aclrtStream, 入参)：指定执行任务的Stream。
返回值：
aclnnStatus：返回状态码，具体参见undefined。
约束说明
- [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：该接口支持与matmul类算子(如undefined)配套使用。
- [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：该接口不支持与grouped matmul类算子(如aclnnGroupedMatmulV4)配套使用。
- 关于scale、offset、out的shape说明如下：
- 当无offset时，out shape与scale shape一致。
- 若out作为matmul类算子输入(如undefined)，shape支持1维(1,)、(n,)或2维(1, n)，其中n与matmul计算中右矩阵(weight，对应参数x2)的shape n一致。
- 若out作为grouped matmul类算子输入(如aclnnGroupedMatmulV4)，仅在分组模式为m轴分组时使用（对应参数groupType为0），shape支持1维(g,)或2维(g, 1)、(g, n)，其中n与grouped matmul计算中右矩阵(对应参数weight)的shape n一致，g与grouped matmul计算中分组数（对应参数groupListOptional的shape大小）一致。
- 当有offset时，仅作为matmul类算子输入(如undefined)：
- offset，scale，out的shape支持1维(1,)、(n,)或2维(1, n)，其中n与matmul计算中右矩阵(weight，对应参数x2)的shape n一致。
- 当输入scale的shape为1维，out的shape也为1维，且shape大小为scale与offset单维shape大小的最大值。
- 当输入scale的shape为2维，out的shape与输入scale的shape维度和大小完全一致。
- 当无offset时，out shape与scale shape一致。
调用示例
示例代码如下，仅供参考，具体编译和执行过程请参考undefined。
[object Object]