mindspore.mint.distributed.get_global_rank

mindspore.mint.distributed.get_global_rank(group, group_rank)

由指定通信组中的设备序号获取通信集群中的全局设备序号。

说明

get_global_rank 方法应该在 init_process_group 方法之后使用。

参数：

• group (str) - 通信组名称，通常由 mindspore.mint.distributed.new_group 方法创建，如果为 None ， Ascend平台表示为 "hccl_world_group" 。

• group_rank (int) - 通信组内的设备序号。

返回：

int，通信集群中的全局设备序号。

异常：

• TypeError - 参数 group 不是字符串。

• TypeError - 参数 group_rank 不是数字。

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

支持平台：

Ascend

样例：

说明

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

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

>>> from mindspore import set_context
>>> from mindspore.mint.distributed import init_process_group, get_global_rank, new_group, get_rank
>>> set_context(device_target="Ascend")
>>> # Launch 8 processes.
>>> init_process_group()
>>> rank_ids = [0,4]
>>> if get_rank() in rank_ids:
...     group = new_group(rank_ids)
...     world_rank_id = get_global_rank(group, 1)
...     print("world_rank_id is: ", world_rank_id)
#rank 0 and 4:
world_rank_id is: 4