函数原型
HcclResult HcclReduce(void *sendBuf, void *recvBuf, uint64_t count, HcclDataType dataType, HcclReduceOp op, uint32_t root, HcclComm comm, aclrtStream stream)
功能说明
集合通信算子Reduce的操作接口，将所有rank的input相加（或其他操作）后，再把结果发送到root节点的输出buffer。
参数说明
|
参数名 |
输入/输出 |
描述 |
|---|---|---|
|
sendBuf |
输入 |
源数据buffer地址。 |
|
recvBuf |
输出 |
目的数据buffer地址，集合通信结果输出至此buffer中。 |
|
count |
输入 |
参与reduce操作的数据个数，比如只有一个int32数据参与，则count=1。 |
|
dataType |
输入 |
reduce操作的数据类型。 针对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数据类型。 |
|
root |
输入 |
作为reduce root的rankid |
|
comm |
输入 |
集合通信操作所在的通信域。 |
|
stream |
输入 |
本rank所使用的stream。 |
返回值
HcclResult：接口成功返回HCCL_SUCCESS。其他失败。
约束说明
所有rank的count、dataType、op均应相同。