megengine.functional.distributed.all_gather¶
- all_gather(inp, group=WORLD, device=None, axis=0)[source]¶
Gather tensors across the specified group and concat them at first dimension.
- Parameters
inp (
Tensor) – Input tensor.group (
Optional[Group]) – The process group to work on. The default group is WORLD which means all processes available. You can use a list of process ranks to create new group to work on it, e.g. [1, 3, 5].device (
Optional[str]) – The specific device to execute this operator. None default device means the device of inp will be used. Specify “gpu0:1” to execute this operator on diffrent cuda stream, 1 is stream id, and default stream id is 0.axis – The concat axis for collective_comm result The default axis is 0
- Return type
- Returns
Result tensor.
Examples
input = Tensor([rank]) # Rank 0 # input: Tensor([0]) # Rank 1 # input: Tensor([1]) output = all_gather(input) # Rank 0 # output: Tensor([0 1]) # Rank 1 # output: Tensor([0 1]) input = Tensor([rank]) group = Group([1, 0]) output = all_gather(input, group) # Rank 0 # output: Tensor([1 0]) # Rank 1 # output: Tensor([1 0])