aclnnGroupedMatmulV5
产品支持情况
产品 | 是否支持 |
---|---|
[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] | × |
功能说明
算子功能:实现分组矩阵乘计算。如,其中g为分组个数。当前支持m轴和k轴分组,对应的功能为:
- m轴分组:、各组相同,可以不相同。
- k轴分组:、各组相同,可以不相同。
相较于undefined接口,此接口新增:
- 可选参数tuningConfigOptional,调优参数。数组中第一个值表示各个专家处理的token数的预期值,算子tiling时会按照该预期值进行最优tiling。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]: 支持此参数。
- [object Object]Atlas 推理系列产品[object Object]: 不支持此参数。
计算公式:
非量化场景:
量化场景(无perTokenScaleOptional):
- x为INT8,bias为INT32
量化场景(有perTokenScaleOptional):
- x为INT8,bias为INT32
反量化场景:
伪量化场景:
- x为INT8,weight为INT4(仅支持x、weight、y均为单tensor的场景)。其中为必选参数,是离线计算的辅助结果,且 ,并沿k轴规约。
函数原型
每个算子分为undefined,必须先调用“aclnnGroupedMatmulV5GetWorkspaceSize”接口获取入参并根据计算流程计算所需workspace大小,再调用“aclnnGroupedMatmulV5”接口执行计算。
aclnnStatus aclnnGroupedMatmulV5GetWorkspaceSize(const aclTensorList *x, const aclTensorList *weight, const aclTensorList *biasOptional, const aclTensorList *scaleOptional, const aclTensorList *offsetOptional, const aclTensorList *antiquantScaleOptional, const aclTensorList *antiquantOffsetOptional, const aclTensorList *perTokenScaleOptional, const aclTensor *groupListOptional, const aclTensorList *activationInputOptional, const aclTensorList *activationQuantScaleOptional, const aclTensorList *activationQuantOffsetOptional, int64_t splitItem, int64_t groupType, int64_t groupListType, int64_t actType, aclIntArray *tuningConfigOptional, aclTensorList *out, aclTensorList *activationFeatureOutOptional, aclTensorList *dynQuantScaleOutOptional, uint64_t *workspaceSize, aclOpExecutor **executor)
aclnnStatus aclnnGroupedMatmulV5(void* workspace, uint64_t workspaceSize, aclOpExecutor* executor, aclrtStream stream)
aclnnGroupedMatmulV5GetWorkspaceSize
参数说明:
- x(aclTensorList *,计算输入):Device侧的aclTensorList,公式中的输入x,undefined支持ND,支持的最大长度为128个。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持FLOAT16、BFLOAT16、FLOAT32、INT8、INT4、INT32。当传入INT32时,会将每个INT32转换为8个INT4。
- [object Object]Atlas 推理系列产品[object Object]:数据类型支持FLOAT16。
- weight(aclTensorList *,计算输入):Device侧的aclTensorList,公式中的weight,支持的最大长度为128个。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持FLOAT16、BFLOAT16、FLOAT32、INT8、INT4、INT32,undefined支持ND和FRACTAL_NZ格式。当传入INT32时,会将每个INT32转换为8个INT4。
- [object Object]Atlas 推理系列产品[object Object]:数据类型支持FLOAT16,undefined仅支持FRACTAL_NZ格式。
- biasOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList,公式中的bias,undefined支持ND,长度与weight相同。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持FLOAT16、FLOAT32、INT32。
- [object Object]Atlas 推理系列产品[object Object]:数据类型支持FLOAT16。
- scaleOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList,代表量化参数中的缩放因子,undefined支持ND,一般情况下,长度与weight相同。综合约束请参见undefined。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持UINT64、BFLOAT16、FLOAT32。
- [object Object]Atlas 推理系列产品[object Object]:功能暂不支持,需传空指针。
- offsetOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList,代表量化参数中的偏移量,数据类型支持FLOAT32,undefined支持ND,长度与weight相同。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:功能暂不支持,需传空指针。
- antiquantScaleOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList,代表伪量化参数中的缩放因子,undefined支持ND,长度与weight相同。综合约束请参见undefined。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持FLOAT16、BFLOAT16。
- [object Object]Atlas 推理系列产品[object Object]:功能暂不支持,需传空指针。
- antiquantOffsetOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList,代表伪量化参数中的偏移量,undefined支持ND,长度与weight相同。综合约束请参见undefined。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持FLOAT16、BFLOAT16。
- [object Object]Atlas 推理系列产品[object Object]:功能暂不支持,需传空指针。
- perTokenScaleOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList,代表量化参数中的由x量化引入的缩放因子,undefined支持ND,一般情况下,只支持1维且长度与x的M相同。仅支持x、weight、out均为单tensor(TensorList长度为1)场景。综合约束请参见undefined。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持FLOAT32。
- [object Object]Atlas 推理系列产品[object Object]:功能不支持,需传空指针。
- groupListOptional(aclTensor *,计算输入):可选参数,Device侧的aclTensor类型,代表输入和输出分组轴方向的matmul大小分布,数据类型支持INT64,undefined支持ND。需注意:当输出中TensorList的长度为1时,groupListOptional中的最后一个值约束了输出数据的有效部分,groupListOptional中未指定的部分将不会参与更新。
- activationInputOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList类型,代表激活函数的反向输入,当前只支持传入nullptr。
- activationQuantScaleOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList类型,当前只支持传入nullptr。
- activationQuantOffsetOptional(aclTensorList *,计算输入):可选参数,Device侧的aclTensorList类型,当前只支持传入nullptr。
- splitItem(int64_t,计算输入):整数型参数,代表输出是否要做tensor切分,0/1代表输出为多tensor;2/3代表输出为单tensor。
- groupType(int64_t,计算输入):整数型参数,代表需要分组的轴,如矩阵乘为C[m,n]=A[m,k]xB[k,n],则groupType取值-1:不分组,0:m轴分组,1:n轴分组,2:k轴分组。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:当前不支持n轴分组,详细参考[object Object]groupType支持场景[object Object]约束。
- [object Object]Atlas 推理系列产品[object Object]:当前只支持m轴分组。
- groupListType(int64_t,计算输入):整数型参数,取值0: groupListOptional中数值为非负单调非递减数列,表示分组轴大小的cumsum结果(累积和),1: groupListOptional中数值为非负数列,表示分组轴上每组大小,2: groupListOptional中数值为非负数列,shape为[e, 2],e表示Group大小,数据排布为[[groupIdx0, groupSize0], [groupIdx1, groupSize1]...],其中groupSize为分组轴上每组大小。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:支持取值0、1、2。仅当x和weight参数输入类型为INT8,并且groupType取0(m轴分组)时,支持取2。
- [object Object]Atlas 推理系列产品[object Object]:支持取值0、1。
- actType(int64_t,计算输入):整数型参数,代表激活函数类型。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:取值范围为0-5,支持的枚举值如下:
- 0:GMMActType::GMM_ACT_TYPE_NONE;
- 1:GMMActType::GMM_ACT_TYPE_RELU;
- 2:GMMActType::GMM_ACT_TYPE_GELU_TANH;
- 3:GMMActType::GMM_ACT_TYPE_GELU_ERR_FUNC(不支持);
- 4:GMMActType::GMM_ACT_TYPE_FAST_GELU;
- 5:GMMActType::GMM_ACT_TYPE_SILU;
- [object Object]Atlas 推理系列产品[object Object]:当前只支持传入0,表示GMMActType::GMM_ACT_TYPE_NONE。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:取值范围为0-5,支持的枚举值如下:
- tuningConfigOptional(aclIntArray*,计算输入):可选参数,Host侧的aclIntArray,数组里面存储INT64的元素, 要求是非负数且不大于x矩阵的行数。数组中第一个元素表示各个专家处理的token数的预期值,算子tiling时会按照数组中第一个元素进行最优tiling,性能更优。从第二个元素开始预留,用户无须填写,未来会进行扩展。兼容历史版本,用户如不使用该参数,不传(即为nullptr)即可。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:
- 1: 适用于量化场景(x和weight为INT8类型,输出为INT8/FLOAT16/BFLOAT16/INT32类型),且为单tensor单专家的场景。
- 2: 伪量化场景(x为INT8类型,weight为INT4类型,输出为FLOAT16/BFLOAT16类型),且为x、weight、y均为单tensor的场景。
- [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]:
- out(aclTensorList *,计算输出):Device侧的aclTensorList,公式中的输出y,undefined支持ND,支持的最大长度为128个。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:数据类型支持FLOAT16、BFLOAT16、INT8、FLOAT32、INT32。
- [object Object]Atlas 推理系列产品[object Object]:数据类型支持FLOAT16。
- activationFeatureOutOptional(aclTensorList *,计算输出):Device侧的aclTensorList,激活函数的输入数据,当前只支持传入nullptr。
- dynQuantScaleOutOptional(aclTensorList *,计算输出):Device侧的aclTensorList,当前只支持传入nullptr。
- workspaceSize(uint64_t *,出参):返回需要在Device侧申请的workspace大小。
- executor(aclOpExecutor **,出参):返回op执行器,包含了算子计算流程。
- x(aclTensorList *,计算输入):Device侧的aclTensorList,公式中的输入x,undefined支持ND,支持的最大长度为128个。
返回值:
返回aclnnStatus状态码,具体参见undefined。
[object Object]
aclnnGroupedMatmulV5
参数说明:
- workspace(void*,入参):在Device侧申请的workspace内存地址。
- workspaceSize(uint64_t,入参):在Device侧申请的workspace大小,由第一段接口aclnnGroupedMatmulV5GetWorkspaceSize获取。
- executor(aclOpExecutor*,入参):op执行器,包含了算子计算流程。
- stream(aclrtStream,入参):指定执行任务的Stream
返回值:
返回aclnnStatus状态码,具体参见undefined。
约束说明
[object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]:
输入数据类型和格式如下说明(1.除weight外,其余格式都为ND;2.groupList是否传值与使用场景有关,具体请参考[object Object]groupType支持场景[object Object]约束):
类型 x weight bias scale offset antiquantScale antiquantOffset perTokenScale groupList activationInput activationQuantScale activationQuantOffset out 非量化 FLOAT FLOAT (ND) FLOAT/null null null null null null INT64 null null null FLOAT 非量化 FLOAT16 FLOAT16 (ND/NZ) FLOAT16/null null null null null null INT64 null null null FLOAT16 非量化 BFLOAT16 BFLOAT16(ND/NZ) FLOAT/null null null null null null INT64 null null null BFLOAT16 伪量化 FLOAT16 INT8 (ND) FLOAT16/null null null FLOAT16 FLOAT16 null INT64 null null null FLOAT16 伪量化 BFLOAT16 INT8 (ND) FLOAT/null null null BFLOAT16 BFLOAT16 null INT64 null null null BFLOAT16 伪量化 FLOAT16 INT4 (ND) FLOAT16/null null null FLOAT16 FLOAT16 null INT64 null null null FLOAT16 伪量化 BFLOAT16 INT4 (ND) FLOAT/null null null BFLOAT16 BFLOAT16 null INT64 null null null BFLOAT16 伪量化 INT8 INT4 (ND/NZ) FLOAT UINT64 null null null FLOAT INT64 null null null BFLOAT16 伪量化 INT8 INT4 (ND/NZ) FLOAT UINT64 FLOAT/null null null FLOAT INT64 null null null FLOAT16 量化 INT8 INT8 (ND) INT32/null UINT64 null null null null INT64 null null null INT8 量化 INT8 INT8 (ND) INT32/null BFLOAT16 null null null FLOAT/null INT64 null null null BFLOAT16 量化 INT8 INT8 (ND) INT32/null FLOAT null null null FLOAT/null INT64 null null null FLOAT16 量化 INT8 INT8 (ND/NZ) INT32/null null null null null null INT64 null null null INT32 量化 INT8 INT8 (NZ) INT32/null BFLOAT16 null null null FLOAT/null INT64 null null null BFLOAT16 量化 INT8 INT8 (NZ) INT32/null FLOAT null null null FLOAT/null INT64 null null null FLOAT16 量化 INT4 INT4 (ND/NZ) null UINT64 null null null FLOAT/null INT64 null null null FLOAT16/BFLOAT16 x和weight中每一组tensor的最后一维大小都应小于65536。的最后一维指当x不转置时的K轴或当x转置时的M轴。的最后一维指当weight不转置时的N轴或当weight转置时的K轴。
x和weight若需要转置,转置对应的tensor必须undefined。
伪量化场景shape约束:
- 伪量化场景下,若weight的类型为INT8,仅支持perchannel模式;若weight的类型为INT4,对称量化支持perchannel和pergroup两种模式。若为pergroup,pergroup数G或必须要能整除对应的。若weight为多tensor,定义pergroup长度,要求所有都相等。非对称量化支持perchannel模式。
- 伪量化场景下若weight的类型为INT4,则weight中每一组tensor的最后一维大小都应是偶数。的最后一维指weight不转置时的N轴或当weight转置时的K轴。并且在pergroup场景下,当weight转置时,要求pergroup长度是偶数。
- 伪量化参数antiquantScaleOptional和antiquantOffsetOptional的shape要满足下表(其中g为matmul组数,G为pergroup数,为第i个tensor的pergroup数):
使用场景 子场景 shape限制 伪量化perchannel weight单 伪量化perchannel weight多 伪量化pergroup weight单 伪量化pergroup weight多 - x为INT8、weight为INT4场景支持对称量化和非对称量化:
- 对称量化场景:
- 该场景下输出out的dtype为BFLOAT16或FLOAT16
- 该场景下offsetOptional为空
- 该场景下仅支持count模式(算子不会检查groupListType的值),k要求为quantGroupSize的整数倍,且要求k <= 18432。其中quantGroupSize为k方向上pergroup量化长度,当前支持quantGroupSize=256。
- 该场景下scale为pergroup与perchannel离线融合后的结果,shape要求为,其中。
- Bias为计算过程中离线计算的辅助结果,值要求为,并在第1维累加,shape要求为。
- 该场景下要求n为8的整数倍。
- 非对称量化场景:
- 该场景下输出out的dtype为FLOAT16
- 该场景下仅支持count模式(算子不会检查groupListType的值)。
- 该场景下{k, n}要求为{7168, 4096}或者{2048, 7168}。
- scale为pergroup与perchannel离线融合后的结果,shape要求为。
- 该场景下offsetOptional不为空。非对称量化offsetOptional为计算过程中离线计算辅助结果,即,shape要求为,dtype为FLOAT32。
- Bias为计算过程中离线计算的辅助结果,值要求为,并在第1维累加,shape要求为。
- 该场景下要求n为8的整数倍。
- 对称量化场景:
量化场景下,若weight的类型为INT4,需满足以下约束(其中g为matmul组数,G为k轴被pergroup划分后的组数):
- weight的数据格式为ND时,要求n为8的整数倍。
- 支持perchannel和pergroup量化。perchannel场景的scale的shape需为,pergroup场景需为。
- pergroup场景下,必须要能整除,且需为偶数。
- 该场景仅支持groupType=0(x,weight,y均为单tensor),actType=0,groupListType=0/1。
- 该场景不支持weight转置。
仅量化场景 (per-token)、反量化场景支持激活函数计算。
[object Object]不同groupType支持场景[object Object]:
- 伪量化仅支持groupType为-1和0场景。
- 量化仅支持groupType为0场景。
- x、weight、y的输入类型为aclTensorList,表示一个aclTensor类型的数组对象。下面表格支持场景用"单"表示由一个aclTensor组成的aclTensorList,"多"表示由多个aclTensor组成的aclTensorList。例如"单多单",分别表示x为单tensor、weight为多tensor、y为单tensor。
groupType 支持场景 splitItem groupListOptional 转置 其余场景限制 -1 多多多 0/1 groupListOptional必须传空 1)x不支持转置[object Object]2)支持weight转置,但weight的tensorList中每个tensor是否转置需保持统一 1)x中tensor要求维度一致,支持2-6维,weight中tensor需为2维,y中tensor维度和x保持一致 0 单单单 2/3 1)必须传groupListOptional[object Object]2)当groupListType为0时,最后一个值应小于等于x中tensor的第一维;当groupListType为1时,数值的总和应小于等于x中tensor的第一维;当groupListType为2时,第二列数值的总和应小于等于x中tensor的第一维[object Object]3)groupListOptional第1维最大支持1024,即最多支持1024个group 1)x不支持转置[object Object]2)支持weight转置,A8W4与A4W4场景不支持weight转置 1)weight中tensor需为3维,x,y中tensor需为2维 0 单多单 2/3 1)必须传groupListOptional[object Object]2)当groupListType为0时,最后一个值应小于等于x中tensor的第一维;当groupListType为1时,数值的总和应小于等于x中tensor的第一维;当groupListType为2时,第二列数值的总和应小于等于x中tensor的第一维[object Object]3)groupListOptional第1维最大支持128,即最多支持128个group 1)x不支持转置[object Object]2)支持weight转置,但weight的tensorList中每个tensor是否转置需保持统一 1)x,weight,y中tensor需为2维[object Object]2)weight中每个tensor的N轴必须相等 0 多多单 2/3 1)groupListOptional可选[object Object]2)若传入groupListOptional,当groupListType为0时,groupListOptional的差值需与x中tensor的第一维一一对应;当groupListType为1时,groupListOptional的数值需与x中tensor的第一维一一对应;当groupListType为2时,groupListOptional第二列的数值需与x中tensor的第一维一一对应[object Object]3)groupListOptional第1维最大支持128,即最多支持128个group 1)x不支持转置[object Object] 2)支持weight转置,但weight的tensorList中每个tensor是否转置需保持统一 1)x,weight,y中tensor需为2维[object Object]2)weight中每个tensor的N轴必须相等 2 单单单 2/3 1)必须传groupListOptional[object Object]2)当groupListType为0时,最后一个值应小于等于x中tensor的第二维;当groupListType为1时,数值的总和与x应小于等于tensor的第二维;当groupListType为2时,第二列数值的总和应小于等于x中tensor的第二维[object Object]3)groupListOptional第1维最大支持1024, 即最多支持1024个group 1)x必须转置[object Object]2)weight不能转置 1)x,weight中tensor需为2维,y中tensor需为3维[object Object]2)bias必须传空 2 单多多 0/1 groupListOptional必须传空 1)x必须转置[object Object]2)weight不能转置[object Object] 1)x,weight,y中tensor需为2维[object Object]2)weight长度最大支持128,即最多支持128个group[object Object]3)原始shape中weight每个tensor的第一维之和不应超过x第一维[object Object]4)bias必须传空
[object Object]Atlas 推理系列产品[object Object]:
- 输入输出只支持float16的数据类型,输出y的n轴大小需要是16的倍数。
groupType 支持场景 场景限制 0 单单单 1)仅支持splitItem为2/3[object Object]2)weight中tensor需为3维,x,y中tensor需为2维[object Object]3)必须传groupListOptional,且当groupListType为0时,最后一个值与x中tensor的第一维相等,当groupListType为1时,数值的总和与x中tensor的第一维相等[object Object]4)groupListOptional第1维最大支持1024,即最多支持1024个group[object Object]5)支持weight转置,不支持x转置
- 输入输出只支持float16的数据类型,输出y的n轴大小需要是16的倍数。
调用示例
示例代码如下,仅供参考,具体编译和执行过程请参考undefined。