mindspore.ops.communication.all_to_all_v_c

查看源文件
mindspore.ops.communication.all_to_all_v_c(output, input, send_count_matrix, group=None, async_op=False)[源代码]

根据用户指定的分割大小,将输入张量分割并发送到其他设备,在接收分割块后合并为单个输出张量。

说明

当前仅支持PyNative模式,不支持Graph模式。

参数:
  • output (Tensor) - 从远程rank收集并连接的输出张量。

  • input (Tensor) - 要分散到远程rank的张量。

  • send_count_matrix (list[int]) - 所有rank的发送和接收参数,\(\text{send_count_matrix}[i*\text{rank_size}+j]\) 表示rank i发送到rank j的数据量,基本单位是第一维度大小。其中,rank_size 表示通信组的大小。

  • group (str,可选) - 通信组名称。默认值: None ,即Ascend平台表示为 "hccl_world_group"

  • async_op (bool, 可选) - 本算子是否是异步算子。默认值: False

返回:

CommHandle。若 async_opTrue ,CommHandle是一个异步工作句柄。若 async_opFalse ,CommHandle将返回 None

异常:
  • TypeError - 如果 inputoutput 不是张量,group 不是str,或 async_op 不是bool。

支持平台:

Ascend

样例:

说明

运行以下样例之前,需要配置好通信环境变量。

针对Ascend设备,推荐使用msrun启动方式,无第三方以及配置文件依赖。详见 msrun启动

该样例需要在2卡环境下运行。

>>> import numpy as np
>>> import mindspore
>>> from mindspore.ops.communication import init_process_group, get_rank
>>> from mindspore.ops.communication import all_to_all_v_c
>>> from mindspore import Tensor
>>> from mindspore.ops import zeros
>>>
>>> init_process_group()
>>> this_rank = get_rank()
>>> if this_rank == 0:
...     output = Tensor(np.zeros([3]).astype(np.float32))
...     tensor = Tensor([0, 1, 2.]) * this_rank
...     result = all_to_all_v_c(output, tensor, [0, 3, 3, 0])
...     print(output)
>>> if this_rank == 1:
...     output = Tensor(np.zeros([3]).astype(np.float32))
...     tensor = Tensor([0, 1, 2.]) * this_rank
...     result = all_to_all_v_c(output, tensor, [0, 3, 3, 0])
...     print(output)
rank 0:
[0. 1. 2]
rank 1:
[0. 0. 0]