o
    Qe(                     @   sH   d dl mZ ddlmZ ddlmZ ddlmZ g ZG dd deZdS )	   )	Optimizer   )core)	framework)Variablec                       sV   e Zd ZdZdZdZdZ												d fd
d	Zdd Zdd Z	dd Z
  ZS )RMSPropa  
    Root Mean Squared Propagation (RMSProp) is an unpublished, adaptive learning
    rate method. The original slides proposed RMSProp: Slide 29 of
    http://www.cs.toronto.edu/~tijmen/csc321/slides/lecture_slides_lec6.pdf .

    The original equation is as follows:

    ..  math::

        r(w, t) & = \rho r(w, t-1) + (1 - \rho)(\nabla Q_{i}(w))^2

        w & = w - \frac{\eta} {\sqrt{r(w,t) + \epsilon}} \nabla Q_{i}(w)

    The first equation calculates moving average of the squared gradient for
    each weight. Then dividing the gradient by :math:`sqrt{v(w,t)}`.

    In some cases, adding a momentum term :math: `\\beta` is beneficial.
    In our implementation, Nesterov momentum is used:

    ..  math::

        r(w, t) & = \rho r(w, t-1) + (1 - \rho)(\nabla Q_{i}(w))^2

        v(w, t) & = \beta v(w, t-1) + \frac{\eta} {\sqrt{r(w,t) +
            \epsilon}} \nabla Q_{i}(w)

        w & = w - v(w, t)

    if centered is True:

    ..  math::

        r(w, t) & = \rho r(w, t-1) + (1 - \rho)(\nabla Q_{i}(w))^2

        g(w, t) & = \rho g(w, t-1) + (1 - \rho)\nabla Q_{i}(w)

        v(w, t) & = \beta v(w, t-1) + \frac{\eta} {\sqrt{r(w,t) - (g(w, t))^2 +
            \epsilon}} \nabla Q_{i}(w)

        w & = w - v(w, t)

    where, :math:`\rho` is a hyperparameter and typical values are 0.9, 0.95
    and so on. :math:`\beta` is the momentum term. :math:`\epsilon` is a
    smoothing term to avoid division by zero, usually set somewhere in range
    from 1e-4 to 1e-8.


    Parameters:
        learning_rate (float|LRScheduler): The learning rate used to update ``Parameter``.
          It can be a float value or a LRScheduler.
        rho(float, optional): rho is :math:`\rho` in equation, default is 0.95.
        epsilon(float, optional): :math:`\epsilon` in equation is smoothing term to
          avoid division by zero, default is 1e-6.
        momentum(float, optional): :math:`\beta` in equation is the momentum term,
          default is 0.0.
        centered(bool, optional): If True, gradients are normalized by the estimated variance of
          the gradient; if False, by the uncentered second moment. Setting this to
          True may help with training, but is slightly more expensive in terms of
          computation and memory. Defaults to False.
        parameters (list|tuple, optional): List/Tuple of ``Tensor`` to update to minimize ``loss``. 
          This parameter is required in dygraph mode. And you can specify different options for 
          different parameter groups such as the learning rate, weight decay, etc, 
          then the parameters are list of dict. Note that the learning_rate in paramter groups 
          represents the scale of base learning_rate. 
          The default value is None in static mode, at this time all parameters will be updated.
        weight_decay (float|WeightDecayRegularizer, optional): The strategy of regularization. 
          It canbe a float value as coeff of L2 regularization or \
          :ref:`api_fluid_regularizer_L1Decay`, :ref:`api_fluid_regularizer_L2Decay`.
          If a parameter has set regularizer using :ref:`api_fluid_ParamAttr` already, 
          the regularization setting here in optimizer will be ignored for this parameter. 
          Otherwise, the regularization setting here in optimizer will take effect. 
          Default None, meaning there is no regularization.
        grad_clip (GradientClipBase, optional): Gradient cliping strategy, it's an instance of
          some derived class of ``GradientClipBase`` . There are three cliping strategies
          ( :ref:`api_fluid_clip_GradientClipByGlobalNorm` , :ref:`api_fluid_clip_GradientClipByNorm` ,
          :ref:`api_fluid_clip_GradientClipByValue` ). Default None, meaning there is no gradient clipping.
        name (str, optional): This parameter is used by developers to print debugging information. 
          For details, please refer to :ref:`api_guide_Name`. Default is None.

    Examples:
          .. code-block:: python

            import paddle

            inp = paddle.rand([10,10], dtype="float32")
            linear = paddle.nn.Linear(10, 10)
            out = linear(inp)
            loss = paddle.mean(out)

            rmsprop = paddle.optimizer.RMSProp(learning_rate=0.1,
                             parameters=linear.parameters(),
                                       weight_decay=0.01)
            out.backward()
            rmsprop.step()
            rmsprop.clear_grad()

            #Note that the learning_rate of linear_2 is 0.01.
            linear_1 = paddle.nn.Linear(10, 10)
            linear_2 = paddle.nn.Linear(10, 10)
            inp = paddle.uniform(shape=[10, 10], min=-0.1, max=0.1)
            out = linear_1(inp)
            out = linear_2(out)
            loss = paddle.mean(out)
            rmsprop = paddle.optimizer.RMSProp(
                learning_rate=0.1,
                parameters=[{
                    'params': linear_1.parameters()
                }, {
                    'params': linear_2.parameters(),
                    'weight_decay': 0.001,
                    'learning_rate': 0.1
                }],
                weight_decay=0.01)                   
            out.backward()
            rmsprop.step()
            rmsprop.clear_grad()
    momentumZmean_squareZ	mean_gradffffff?ư>        FNc
           
         s   |d u rt d|d u rt d|d u rt d|d u r t dd|ks(t dd|ks0t dd|ks8t dtt| j|||||	d	 d
| _|| _|| _|| _|| _||||d| _	d S )Nzlearning_rate is not set.zrho is not set.zepsilon is not set.zmomentum is not set.r   z.Invalid value of epsilon, expect epsilon >= 0.z0Invalid value of momentum, expect momentum >= 0.z&Invalid value of rho, expect rho >= 0.)learning_rate
parametersweight_decay	grad_clipnameZrmsprop)rhoepsilonr   centered)

ValueErrorsuperr   __init__type_rho_epsilon	_momentum	_centered_default_dict)
selfr   r   r   r   r   r   r   r   r   	__class__ HD:\Projects\ConvertPro\env\Lib\site-packages\paddle/optimizer/rmsprop.pyr      s>   
zRMSProp.__init__c                 C   s`   t |tjs
tdt |tr|d}|D ]}| | j| | | j| | | j	| qd S )N)block is not instance of framework.Block.params)

isinstancer   Block	TypeErrordictgetZ_add_accumulator_momentum_acc_str_mean_square_acc_str_mean_grad_acc_str)r   blockr   pr    r    r!   _create_accumulators   s   

zRMSProp._create_accumulatorsc              
   C   s   t |tjs
tdt |tr| |}| | j|d }| | j|d }| | j	|d }|j
| j|d |d |||| |d|d |||d| j| j| j| jddd}|S )	Nr"       r   )ParamZGradZMomentZ
MeanSquareZMeanGradZLearningRate)ZParamOutZ	MomentOutZMeanSquareOutZMeanGradOut)r   Zdecayr   r   T)r   ZinputsZoutputsattrsZstop_gradient)r$   r   r%   r&   r'   _update_param_groupZ_get_accumulatorr)   r*   r+   Z	append_opr   Z_create_param_lrr   r   r   r   )r   r,   Zparam_and_gradZmomentum_accZmean_square_accZmean_grad_accZ
rmsprop_opr    r    r!   _append_optimize_op   sF   




	zRMSProp._append_optimize_opc                 C   s^   | d| jd | _| d| jd | _| d| jd | _| d| jd | _| d}|S )Nr   r   r   r   r#   )r(   r   r   r   r   r   )r   r   r    r    r!   r2      s   


zRMSProp._update_param_group)r	   r
   r   FNNNN)__name__
__module____qualname____doc__r)   r*   r+   r   r.   r3   r2   __classcell__r    r    r   r!   r      s"    v/+r   N)	Z	optimizerr   Zfluidr   r   Zfluid.frameworkr   __all__r   r    r    r    r!   <module>   s   