Method clone

python/paddle/base/framework.py:6549–6770

.. note::: 1. :code:`Program.clone()` method DOES NOT clone :ref:`api_paddle_io_DataLoader` . 2. Recommend you to use :code:`clone` before using :code:`Optimizer.minimize` . 3. This API has no effect in Dygraph Mode. Create a new Program with for

(self, for_test=False)

        return self.desc._version()

    def clone(self, for_test=False):
        """
        .. note:::
            1. :code:`Program.clone()` method DOES NOT clone :ref:`api_paddle_io_DataLoader` .
            2. Recommend you to use :code:`clone` before using :code:`Optimizer.minimize` .
            3. This API has no effect in Dygraph Mode.

        Create a new Program with forward content of original one when ``for_test=True``.
        Create a new Program as same as the original one when ``for_test=False``.

        Some operators, e.g., :ref:`api_paddle_base_layers_batch_norm` , behave differently between
        training and testing. They have an attribute, :code:`is_test`, to
        control this behaviour. This method will change the :code:`is_test`
        attribute of them to :code:`True` when :code:`for_test=True`.

        * Set for_test to False when you want to clone the program for training.
        * Set for_test to True when you want to clone the program for testing.
          We will prune the backward and optimize part of the program when you
          use :code:`clone` after :code:`Optimizer.minimize`, but we still
          recommend you to use :code:`clone` before using :code:`Optimizer.minimize`.

        Examples:
            .. code-block:: pycon
                :name: code-example-1

                >>> import paddle
                >>> import paddle.static as static

                >>> paddle.enable_static()

                >>> img = static.data(name='image', shape=[None, 784])
                >>> pred = static.nn.fc(x=img, size=10, activation='relu')
                >>> loss = paddle.mean(pred)
                >>> # Here we use clone before Momentum
                >>> test_program = static.default_main_program().clone(for_test=True)
                >>> optimizer = paddle.optimizer.Momentum(learning_rate=0.01, momentum=0.9)
                >>> optimizer.minimize(loss)

        Args:

            for_test (bool): True if change the :code:`is_test` attribute of operators to :code:`True`
                and prune the backward and optimize part of the program. The default value is :code:`False` .

        Returns:
            Program: A new Program with forward content of original one when ``for_test=True``.  A new Program as same as the original one when ``for_test=False``


        Examples:

            .. note::
                The Program's order maybe different after :code:`clone` and
                this will not affect your training or testing progress. In the following
                example we give you an simple method :code:`print_prog(program)` to
                print Program Descs inorder to make sure you have same print result
                after :code:`clone`:

            .. code-block:: pycon
                :name: code-example-2