jax.experimental.mesh_utils.create_device_mesh#

jax.experimental.mesh_utils.create_device_mesh(mesh_shape, devices=None, *, contiguous_submeshes=False, allow_split_physical_axes=False)[source]#

为 jax.sharding.Mesh 创建高性能设备网格。

参数:

  • mesh_shape (Sequence[int]) – 逻辑网格的形状，按网络强度递增排序，例如 [replica, data, mdl]，其中 mdl 具有最多的网络通信需求。

  • devices (Sequence[Any] | None | None) – （可选）用于构建网格的设备。默认为 jax.devices()。

  • contiguous_submeshes (bool) – 如果为 True，此函数将尝试创建一个网格，其中每个进程的本地设备形成一个连续的子网格。如果此函数无法生成合适的网格，则会引发 ValueError。在引入 jax.Array 之前，有时需要此设置来确保非参差不齐的本地数组；如果使用 jax.Arrays，最好将其设置为 False。

  • allow_split_physical_axes (bool) – 如果为 True，我们将根据需要拆分物理轴以生成所需的设备网格。

Raises:

ValueError – 如果设备数量不等于 mesh_shape 的乘积。

Returns:

一个 np.ndarray 类型的 JAX 设备，其形状为 mesh_shape，可以馈入到 jax.sharding.Mesh 中，以获得良好的集体性能。

Return type:

np.ndarray