函数原型
HcclResult HcclReduceScatter(void *sendBuf, void *recvBuf, uint64_t recvCount, HcclDataType dataType, HcclReduceOp op, HcclComm comm, aclrtStream stream)
功能说明
集合通信算子ReduceScatter的操作接口。将所有rank的输入相加（或其他操作）后，再把结果按照rank编号均匀分散的到各个rank的输出buffer，每个进程拿到其他进程1/ranksize份的数据进行归约操作。
如下图所示，有rank0、rank1、rank2、rank3四个rank，每个rank的输入数据切分成4份，每个进程分别取每个rank的1/4数据进行sum操作（或其他操作），将结果发送到输出buffer。
参数说明
参数名 |
输入/输出 |
描述 |
|---|---|---|
sendBuf |
输入 |
源数据buffer地址。 |
recvBuf |
输出 |
目的数据buffer地址，集合通信结果输出至此buffer中。 |
recvCount |
输入 |
参与reducescatter操作的recvBuf的数据size，sendBuf的数据size则等于recvCount * rank size。 |
dataType |
输入 |
reduce-scatter操作的数据类型。 针对Atlas 训练系列产品，支持数据类型：int8, int16, int32, int64, float16, float32。 针对Atlas A2 训练系列产品，支持数据类型：int8, int16, int32, int64, float16, float32, bfp16。 |
op |
输入 |
reduce的操作类型，目前支持的操作类型有sum、prod、max、min。 说明：
针对Atlas 训练系列产品，当前版本“prod”操作不支持int16数据类型。 针对Atlas A2 训练系列产品，当前版本“prod”操作不支持int16、bfp16数据类型。 |
comm |
输入 |
集合通信操作所在的通信域。 |
stream |
输入 |
本rank所使用的stream。 |
返回值
HcclResult：接口成功返回HCCL_SUCCESS。其他失败。
约束说明
所有rank的recvCount、dataType、op均应相同。