From 86b5c4a37ecd8a94421f1075bc4894a119cbee69 Mon Sep 17 00:00:00 2001
From: Shen Li <shenli@devfair017.maas>
Date: Sat, 11 Apr 2020 14:54:53 -0700
Subject: [PATCH] Adding distributed pipeline parallel tutorial

---
 ...ributed-Pipeline-Parallelism-Using-RPC.png | Bin 0 -> 35776 bytes
 index.rst                                     |   8 +
 .../dist_pipeline_parallel_tutorial.rst       | 370 ++++++++++++++++++
 3 files changed, 378 insertions(+)
 create mode 100644 _static/img/thumbnails/cropped/Distributed-Pipeline-Parallelism-Using-RPC.png
 create mode 100644 intermediate_source/dist_pipeline_parallel_tutorial.rst

diff --git a/_static/img/thumbnails/cropped/Distributed-Pipeline-Parallelism-Using-RPC.png b/_static/img/thumbnails/cropped/Distributed-Pipeline-Parallelism-Using-RPC.png
new file mode 100644
index 0000000000000000000000000000000000000000..426a14d98f5f7fbbf695626658ad1946fe4ef63e
GIT binary patch
literal 35776
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

literal 0
HcmV?d00001

diff --git a/index.rst b/index.rst
index 81113c919ed..22921f61b35 100644
--- a/index.rst
+++ b/index.rst
@@ -332,6 +332,13 @@ Welcome to PyTorch Tutorials
    :link: intermediate/rpc_param_server_tutorial.html
    :tags: Parallel-and-Distributed-Training
 
+.. customcarditem::
+   :header: Distributed Pipeline Parallelism Using RPC
+   :card_description: Demonstrate how to implement distributed pipeline parallelism using RPC
+   :image: _static/img/thumbnails/cropped/Distributed-Pipeline-Parallelism-Using-RPC.png
+   :link: intermediate/dist_pipeline_parallel_tutorial.html
+   :tags: Parallel-and-Distributed-Training
+
 .. End of tutorial card section
 
 .. raw:: html
@@ -497,3 +504,4 @@ Additional Resources
    intermediate/rpc_tutorial
    beginner/aws_distributed_training_tutorial
    intermediate/rpc_param_server_tutorial
+   intermediate/dist_pipeline_parallel_tutorial
diff --git a/intermediate_source/dist_pipeline_parallel_tutorial.rst b/intermediate_source/dist_pipeline_parallel_tutorial.rst
new file mode 100644
index 00000000000..ef7df000508
--- /dev/null
+++ b/intermediate_source/dist_pipeline_parallel_tutorial.rst
@@ -0,0 +1,370 @@
+Distributed Pipeline Parallelism Using RPC
+==========================================
+**Author**: `Shen Li <https://mrshenli.github.io/>`_
+
+Prerequisites:
+
+-  `Single-Machine Model Parallel Best Practices <https://pytorch.org/tutorials/intermediate/model_parallel_tutorial.html>`__
+-  `Getting started with Distributed RPC Framework <https://pytorch.org/tutorials/intermediate/rpc_tutorial.html>`__
+-  RRef helper functions:
+   `RRef.rpc_sync() <https://pytorch.org/docs/master/rpc.html#torch.distributed.rpc.RRef.rpc_sync>`__,
+   `RRef.rpc_async() <https://pytorch.org/docs/master/rpc.html#torch.distributed.rpc.RRef.rpc_async>`__, and
+   `RRef.remote() <https://pytorch.org/docs/master/rpc.html#torch.distributed.rpc.RRef.remote>`__
+
+
+
+This tutorial uses a Resnet50 model to demonstrate implementing distributed
+pipeline parallelism with `torch.distributed.rpc <https://pytorch.org/docs/master/rpc.html>`__
+APIs. This can be viewed as the distributed counterpart of the multi-GPU
+pipeline parallelism discussed in
+`Single-Machine Model Parallel Best Practices <model_parallel_tutorial.html>`_.
+
+.. note:: This tutorial requires PyTorch v1.6.0 or above.
+
+.. note:: Full source code of this tutorial can be found at
+    `pytorch/examples <https://github.com/pytorch/examples/tree/master/distributed/rpc/pipeline>`__.
+
+Basics
+------
+
+
+The previous tutorial, `Getting Started with Distributed RPC Framework <rpc_tutorial.html>`_
+shows how to use `torch.distributed.rpc <https://pytorch.org/docs/master/rpc.html>`_
+to implement distributed model parallelism for an RNN model. That tutorial uses
+one GPU to host the ``EmbeddingTable``, and the provided code works fine.
+However, if a model lives on multiple GPUs, it would require some extra steps to
+increase the amortized utilization of all GPUs. Pipeline parallelism is one type
+of paradigm that can help in this case.
+
+In this tutorial, we use ``ResNet50`` as an example model which is also used by
+the `Single-Machine Model Parallel Best Practices <model_parallel_tutorial.html>`_
+tutorial. Similarly, the ``ResNet50`` model is divided into two shards and
+the input batch is partitioned into multiple splits and fed into the two model
+shards in a pipelined fashion. The difference is that, instead of parallelizing
+the execution using CUDA streams, this tutorial invokes asynchronous RPCs. So,
+the solution presented in this tutorial also works across machine boundaries.
+The remainder of this tutorial presents the implementation in four steps.
+
+
+
+Step 1: Partition ResNet50 Model
+--------------------------------
+
+This is the preparation step which implements ``ResNet50`` in two model shards.
+The code below is borrowed from the
+`ResNet implementation in torchvision <https://github.com/pytorch/vision/blob/7c077f6a986f05383bcb86b535aedb5a63dd5c4b/torchvision/models/resnet.py#L124>`_.
+The ``ResNetBase`` module contains the common building blocks and attributes for
+the two ResNet shards.
+
+
+.. code:: python
+    import threading
+
+    import torch
+    import torch.nn as nn
+
+    from torchvision.models.resnet import Bottleneck
+
+    num_classes = 1000
+
+
+    def conv1x1(in_planes, out_planes, stride=1):
+        return nn.Conv2d(in_planes, out_planes, kernel_size=1, stride=stride, bias=False)
+
+
+    class ResNetBase(nn.Module):
+        def __init__(self, block, inplanes, num_classes=1000,
+                    groups=1, width_per_group=64, norm_layer=None):
+            super(ResNetBase, self).__init__()
+
+            self._lock = threading.Lock()
+            self._block = block
+            self._norm_layer = nn.BatchNorm2d
+            self.inplanes = inplanes
+            self.dilation = 1
+            self.groups = groups
+            self.base_width = width_per_group
+
+        def _make_layer(self, planes, blocks, stride=1):
+            norm_layer = self._norm_layer
+            downsample = None
+            previous_dilation = self.dilation
+            if stride != 1 or self.inplanes != planes * self._block.expansion:
+                downsample = nn.Sequential(
+                    conv1x1(self.inplanes, planes * self._block.expansion, stride),
+                    norm_layer(planes * self._block.expansion),
+                )
+
+            layers = []
+            layers.append(self._block(self.inplanes, planes, stride, downsample, self.groups,
+                                    self.base_width, previous_dilation, norm_layer))
+            self.inplanes = planes * self._block.expansion
+            for _ in range(1, blocks):
+                layers.append(self._block(self.inplanes, planes, groups=self.groups,
+                                        base_width=self.base_width, dilation=self.dilation,
+                                        norm_layer=norm_layer))
+
+            return nn.Sequential(*layers)
+
+        def parameter_rrefs(self):
+            return [RRef(p) for p in self.parameters()]
+
+
+Now, we are ready to define the two model shards. For the constructor, we
+simply split all ResNet50 layers into two parts and move each part into the
+provided device. The ``forward`` functions of both shards take an ``RRef`` of
+the input data, fetch the data locally, and then move it to the expected device.
+After applying all layers to the input, it moves the output to CPU and returns.
+It is because the RPC API requires tensors to reside on CPU to avoid invalid
+device errors when the numbers of devices in the caller and the callee do not
+match.
+
+
+.. code:: python
+
+    class ResNetShard1(ResNetBase):
+        def __init__(self, device, *args, **kwargs):
+            super(ResNetShard1, self).__init__(
+                Bottleneck, 64, num_classes=num_classes, *args, **kwargs)
+
+            self.device = device
+            self.seq = nn.Sequential(
+                nn.Conv2d(3, self.inplanes, kernel_size=7, stride=2, padding=3, bias=False),
+                self._norm_layer(self.inplanes),
+                nn.ReLU(inplace=True),
+                nn.MaxPool2d(kernel_size=3, stride=2, padding=1),
+                self._make_layer(64, 3),
+                self._make_layer(128, 4, stride=2)
+            ).to(self.device)
+
+            for m in self.modules():
+                if isinstance(m, nn.Conv2d):
+                    nn.init.kaiming_normal_(m.weight, mode='fan_out', nonlinearity='relu')
+                elif isinstance(m, nn.BatchNorm2d):
+                    nn.init.constant_(m.weight, 1)
+                    nn.init.constant_(m.bias, 0)
+
+        def forward(self, x_rref):
+            x = x_rref.to_here().to(self.device)
+            with self._lock:
+                out =  self.seq(x)
+            return out.cpu()
+
+
+    class ResNetShard2(ResNetBase):
+        def __init__(self, device, *args, **kwargs):
+            super(ResNetShard2, self).__init__(
+                Bottleneck, 512, num_classes=num_classes, *args, **kwargs)
+
+            self.device = device
+            self.seq = nn.Sequential(
+                self._make_layer(256, 6, stride=2),
+                self._make_layer(512, 3, stride=2),
+                nn.AdaptiveAvgPool2d((1, 1)),
+            ).to(self.device)
+
+            self.fc =  nn.Linear(512 * self._block.expansion, num_classes).to(self.device)
+
+        def forward(self, x_rref):
+            x = x_rref.to_here().to(self.device)
+            with self._lock:
+                out = self.fc(torch.flatten(self.seq(x), 1))
+            return out.cpu()
+
+
+Step 2: Stitch ResNet50 Model Shards Into One Module
+----------------------------------------------------
+
+
+Then, we create a ``DistResNet50`` module to assemble the two shards and
+implement the pipeline parallel logic. In the constructor, we use two
+``rpc.remote`` calls to put the two shards on two different RPC workers
+respectively and hold on to the ``RRef`` to the two model parts so that they
+can be referenced in the forward pass.  The ``forward`` function
+splits the input batch into multiple micro-batches, and feeds these
+micro-batches to the two model parts in a pipelined fashion. It first uses an
+``rpc.remote`` call to apply the first shard to a micro-batch and then forwards
+the returned intermediate output ``RRef`` to the second model shard. After that,
+it collects the ``Future`` of all micro-outputs, and waits for all of them after
+the loop. Note that both ``remote()`` and ``rpc_async()`` return immediately and
+run asynchronously. Therefore, the entire loop is non-blocking, and will launch
+multiple RPCs concurrently. The execution order of one micro-batch on two model
+parts are preserved by intermediate output ``y_rref``. The execution order
+across micro-batches does not matter. In the end, the forward function
+concatenates outputs of all micro-batches into one single output tensor and
+returns. The ``parameter_rrefs`` function is a helper to
+simplify distributed optimizer construction, which will be used later.
+
+
+
+.. code:: python
+
+    class DistResNet50(nn.Module):
+        def __init__(self, num_split, workers, *args, **kwargs):
+            super(DistResNet50, self).__init__()
+
+            self.num_split = num_split
+
+            # Put the first part of the ResNet50 on workers[0]
+            self.p1_rref = rpc.remote(
+                workers[0],
+                ResNetShard1,
+                args = ("cuda:0",) + args,
+                kwargs = kwargs
+            )
+
+            # Put the second part of the ResNet50 on workers[1]
+            self.p2_rref = rpc.remote(
+                workers[1],
+                ResNetShard2,
+                args = ("cuda:1",) + args,
+                kwargs = kwargs
+            )
+
+        def forward(self, xs):
+            out_futures = []
+            for x in iter(xs.split(self.split_size, dim=0)):
+                x_rref = RRef(x)
+                y_rref = self.p1_rref.remote().forward(x_rref)
+                z_fut = self.p2_rref.rpc_async().forward(y_rref)
+                out_futures.append(z_fut)
+
+            return torch.cat(torch.futures.wait_all(out_futures))
+
+        def parameter_rrefs(self):
+            remote_params = []
+            remote_params.extend(self.p1_rref.remote().parameter_rrefs().to_here())
+            remote_params.extend(self.p2_rref.remote().parameter_rrefs().to_here())
+            return remote_params
+
+
+Step 3: Define The Training Loop
+--------------------------------
+
+
+After defining the model, let us implement the training loop. We use a
+dedicated "master" worker to prepare random inputs and labels, and control the
+distributed backward pass and distributed optimizer step. It first creates an
+instance of the ``DistResNet50`` module. It specifies the number of
+micro-batches for each batch, and also provides the name of the two RPC workers
+(i.e., "worker1", and "worker2"). Then it defines the loss function and creates
+a ``DistributedOptimizer`` using the ``parameter_rrefs()`` helper to acquire a
+list of parameter ``RRefs``. Then, the main training loop is very similar to
+regular local training, except that it uses ``dist_autograd`` to launch
+backward and provides the ``context_id`` for both backward and optimizer
+``step()``.
+
+
+.. code:: python
+
+    import torch.distributed.autograd as dist_autograd
+    import torch.optim as optim
+    from torch.distributed.optim import DistributedOptimizer
+
+    num_batches = 3
+    batch_size = 120
+    image_w = 128
+    image_h = 128
+
+
+    def run_master(num_split):
+        # put the two model parts on worker1 and worker2 respectively
+        model = DistResNet50(num_split, ["worker1", "worker2"])
+        loss_fn = nn.MSELoss()
+        opt = DistributedOptimizer(
+            optim.SGD,
+            model.parameter_rrefs(),
+            lr=0.05,
+        )
+
+        one_hot_indices = torch.LongTensor(batch_size) \
+                            .random_(0, num_classes) \
+                            .view(batch_size, 1)
+
+        for i in range(num_batches):
+            print(f"Processing batch {i}")
+            # generate random inputs and labels
+            inputs = torch.randn(batch_size, 3, image_w, image_h)
+            labels = torch.zeros(batch_size, num_classes) \
+                        .scatter_(1, one_hot_indices, 1)
+
+            with dist_autograd.context() as context_id:
+                outputs = model(inputs)
+                dist_autograd.backward(context_id, [loss_fn(outputs, labels)])
+                opt.step(context_id)
+
+
+Step 4: Launch RPC Processes
+----------------------------
+
+
+Finally, the code below shows the target function for all processes. The main
+logic is defined in ``run_master``. The workers passively waiting for
+commands from the master, and hence simply runs ``init_rpc`` and ``shutdown``,
+where the ``shutdown`` by default will block until all RPC participants finish.
+
+.. code:: python
+
+    import os
+    import time
+
+    import torch.multiprocessing as mp
+
+
+    def run_worker(rank, world_size, num_split):
+        os.environ['MASTER_ADDR'] = 'localhost'
+        os.environ['MASTER_PORT'] = '29500'
+        options = rpc.ProcessGroupRpcBackendOptions(num_send_recv_threads=128)
+
+        if rank == 0:
+            rpc.init_rpc(
+                "master",
+                rank=rank,
+                world_size=world_size,
+                rpc_backend_options=options
+            )
+            run_master(num_split)
+        else:
+            rpc.init_rpc(
+                f"worker{rank}",
+                rank=rank,
+                world_size=world_size,
+                rpc_backend_options=options
+            )
+            pass
+
+        # block until all rpcs finish
+        rpc.shutdown()
+
+
+    if __name__=="__main__":
+        world_size = 3
+        for num_split in [1, 2, 4, 8]:
+            tik = time.time()
+            mp.spawn(run_worker, args=(world_size, num_split), nprocs=world_size, join=True)
+            tok = time.time()
+            print(f"number of splits = {num_split}, execution time = {tok - tik}")
+
+
+The output below shows the speedup attained by increasing the number of splits
+in each batch.
+
+::
+
+    $ python main.py
+    Processing batch 0
+    Processing batch 1
+    Processing batch 2
+    number of splits = 1, execution time = 16.45062756538391
+    Processing batch 0
+    Processing batch 1
+    Processing batch 2
+    number of splits = 2, execution time = 12.329529762268066
+    Processing batch 0
+    Processing batch 1
+    Processing batch 2
+    number of splits = 4, execution time = 10.164430618286133
+    Processing batch 0
+    Processing batch 1
+    Processing batch 2
+    number of splits = 8, execution time = 9.076049566268921
\ No newline at end of file