mindspore.communication.get_process_group_ranks

查看源文件
mindspore.communication.get_process_group_ranks(group=GlobalComm.WORLD_COMM_GROUP)[源代码]

获取指定通信组中的进程,并将通信组中的进程编号以列表方式返回。

参数:
  • group (str,可选) - 工作的通信组。默认值:GlobalComm.WORLD_COMM_GROUP (即Ascend平台为 "hccl_world_group" ,GPU平台为 "nccl_world_group" )。

返回:

List (List[int]) - 指定通信组中的进程编号列表。

异常:
  • TypeError - group 不是字符串。

  • RuntimeError - 如果目标设备无效,或者后端无效,或者分布式初始化失败。

支持平台:

Ascend GPU

样例:

说明

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

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

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

>>> import numpy as np
>>> from mindspore.communication import init, get_process_group_ranks
>>>
>>> init()
>>> output = get_process_group_ranks()
>>> print(output)
[0, 1, 2, 3]