Ë
    S²j4>  ã                   óä   — d dl Z d dlZd dlmZmZ d dlmZmZ d dlm	Z	 ddl
mZ ddlmZ g d¢Z G d	„ d
e«      Z G d„ de«      Zeee   z  ez  Z G d„ de«      Z G d„ de«      Z G d„ de«      Zy)é    N)ÚSizeÚTensor)Ú
functionalÚinit)Ú	Parameteré   )ÚCrossMapLRN2d)ÚModule)ÚLocalResponseNormr	   Ú	LayerNormÚ	GroupNormÚRMSNormc                   ó„   ‡ — e Zd ZU dZg d¢Zeed<   eed<   eed<   eed<   	 ddededededdf
ˆ fd	„Zd
e	de	fd„Z
d„ Zˆ xZS )r   a‹  Applies local response normalization over an input signal.

    The input signal is composed of several input planes, where channels occupy the second dimension.
    Applies normalization across channels.

    .. math::
        b_{c} = a_{c}\left(k + \frac{\alpha}{n}
        \sum_{c'=\max(0, c-n/2)}^{\min(N-1,c+n/2)}a_{c'}^2\right)^{-\beta}

    Args:
        size: amount of neighbouring channels used for normalization
        alpha: multiplicative factor. Default: 0.0001
        beta: exponent. Default: 0.75
        k: additive factor. Default: 1

    Shape:
        - Input: :math:`(N, C, *)`
        - Output: :math:`(N, C, *)` (same shape as input)

    Examples::

        >>> lrn = nn.LocalResponseNorm(2)
        >>> signal_2d = torch.randn(32, 5, 24, 24)
        >>> signal_4d = torch.randn(16, 5, 7, 7, 7, 7)
        >>> output_2d = lrn(signal_2d)
        >>> output_4d = lrn(signal_4d)

    )ÚsizeÚalphaÚbetaÚkr   r   r   r   ÚreturnNc                 óZ   •— t         ‰| �  «        || _        || _        || _        || _        y ©N©ÚsuperÚ__init__r   r   r   r   ©Úselfr   r   r   r   Ú	__class__s        €ú]/var/www/html/ia-enhanced/venv/lib/python3.12/site-packages/torch/nn/modules/normalization.pyr   zLocalResponseNorm.__init__4   ó,   ø€ ô 	‰ÑÔØˆŒ	ØˆŒ
ØˆŒ	Øˆ�ó    Úinputc                 ó„   — t        j                  || j                  | j                  | j                  | j
                  «      S ©z(
        Runs the forward pass.
        )ÚFÚlocal_response_normr   r   r   r   ©r   r    s     r   ÚforwardzLocalResponseNorm.forward=   s-   € ô ×$Ñ$ U¨D¯I©I°t·z±zÀ4Ç9Á9ÈdÏfÉfÓUÐUr   c                 ó:   —  dj                   di | j                  ¤ŽS ©ú@
        Return the extra representation of the module.
        z){size}, alpha={alpha}, beta={beta}, k={k}© ©ÚformatÚ__dict__©r   s    r   Ú
extra_reprzLocalResponseNorm.extra_reprC   ó    € ð BÐ:×AÑAÑRÀDÇMÁMÑRÐRr   )ç-Cëâ6?ç      è?g      ð?)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú__constants__ÚintÚ__annotations__Úfloatr   r   r&   r/   Ú__classcell__©r   s   @r   r   r      ss   ø… ñò: 3€MØ
ƒIØƒLØ
ƒKØƒHð NQñØðØ %ðØ49ðØEJðà	õðV˜Vð V¨ó VöSr   r   c                   ó~   ‡ — e Zd ZU eed<   eed<   eed<   eed<   	 ddededededdf
ˆ fd„Zdedefd	„Zde	fd
„Z
ˆ xZS )r	   r   r   r   r   r   Nc                 óZ   •— t         ‰| �  «        || _        || _        || _        || _        y r   r   r   s        €r   r   zCrossMapLRN2d.__init__P   r   r   r    c                 ó„   — t        j                  || j                  | j                  | j                  | j
                  «      S r"   )Ú_cross_map_lrn2dÚapplyr   r   r   r   r%   s     r   r&   zCrossMapLRN2d.forwardY   s-   € ô  ×%Ñ% e¨T¯Y©Y¸¿
¹
ÀDÇIÁIÈtÏvÉvÓVÐVr   c                 ó:   —  dj                   di | j                  ¤ŽS r(   r+   r.   s    r   r/   zCrossMapLRN2d.extra_repr_   r0   r   )r1   r2   r   )r3   r4   r5   r8   r9   r:   r   r   r&   Ústrr/   r;   r<   s   @r   r	   r	   J   so   ø… Ø
ƒIØƒLØ
ƒKØƒHð NOñØðØ %ðØ49ðØEJðà	õðW˜Vð W¨ó WðS˜C÷ Sr   r	   c                   óš   ‡ — e Zd ZU dZg d¢Zeedf   ed<   eed<   e	ed<   	 	 	 	 	 dde
dede	de	d	df
ˆ fd
„Zdd„Zded	efd„Zd	efd„Zˆ xZS )r   a¸  Applies Layer Normalization over a mini-batch of inputs.

    This layer implements the operation as described in
    the paper `Layer Normalization <https://arxiv.org/abs/1607.06450>`__

    .. math::
        y = \frac{x - \mathrm{E}[x]}{ \sqrt{\mathrm{Var}[x] + \epsilon}} * \gamma + \beta

    The mean and standard-deviation are calculated over the last `D` dimensions, where `D`
    is the dimension of :attr:`normalized_shape`. For example, if :attr:`normalized_shape`
    is ``(3, 5)`` (a 2-dimensional shape), the mean and standard-deviation are computed over
    the last 2 dimensions of the input (i.e. ``input.mean((-2, -1))``).
    :math:`\gamma` and :math:`\beta` are learnable affine transform parameters of
    :attr:`normalized_shape` if :attr:`elementwise_affine` is ``True``.
    The variance is calculated via the biased estimator, equivalent to
    `torch.var(input, correction=0)`.

    .. note::
        Unlike Batch Normalization and Instance Normalization, which applies
        scalar scale and bias for each entire channel/plane with the
        :attr:`affine` option, Layer Normalization applies per-element scale and
        bias with :attr:`elementwise_affine`.

    This layer uses statistics computed from input data in both training and
    evaluation modes.

    Args:
        normalized_shape (int or list or torch.Size): input shape from an expected input
            of size

            .. math::
                [* \times \text{normalized\_shape}[0] \times \text{normalized\_shape}[1]
                    \times \ldots \times \text{normalized\_shape}[-1]]

            If a single integer is used, it is treated as a singleton list, and this module will
            normalize over the last dimension which is expected to be of that specific size.
        eps: a value added to the denominator for numerical stability. Default: 1e-5
        elementwise_affine: a boolean value that when set to ``True``, this module
            has learnable per-element affine parameters initialized to ones (for weights)
            and zeros (for biases). Default: ``True``
        bias: If set to ``False``, the layer will not learn an additive bias (only relevant if
            :attr:`elementwise_affine` is ``True``). Default: ``True``

    Attributes:
        weight: the learnable weights of the module of shape
            :math:`\text{normalized\_shape}` when :attr:`elementwise_affine` is set to ``True``.
            The values are initialized to 1.
        bias:   the learnable bias of the module of shape
                :math:`\text{normalized\_shape}` when :attr:`elementwise_affine` is set to ``True``.
                The values are initialized to 0.

    Shape:
        - Input: :math:`(N, *)`
        - Output: :math:`(N, *)` (same shape as input)

    Examples::

        >>> # NLP Example
        >>> batch, sentence_length, embedding_dim = 20, 5, 10
        >>> embedding = torch.randn(batch, sentence_length, embedding_dim)
        >>> layer_norm = nn.LayerNorm(embedding_dim)
        >>> # Activate module
        >>> layer_norm(embedding)
        >>>
        >>> # Image Example
        >>> N, C, H, W = 20, 5, 10, 10
        >>> input = torch.randn(N, C, H, W)
        >>> # Normalize over the last three dimensions (i.e. the channel and spatial dimensions)
        >>> # as shown in the image below
        >>> layer_norm = nn.LayerNorm([C, H, W])
        >>> output = layer_norm(input)

    .. image:: ../_static/img/nn/layer_norm.jpg
        :scale: 50 %

    ©Únormalized_shapeÚepsÚelementwise_affine.rF   rG   rH   NÚbiasr   c                 ó  •— ||dœ}t         ‰| �  «        t        |t        j                  «      r|f}t        |«      | _        || _        || _        | j                  rrt        t        j                  | j                  fi |¤Ž«      | _        |r/t        t        j                  | j                  fi |¤Ž«      | _        n7| j                  dd «       n$| j                  dd «       | j                  dd «       | j                  «        y )N©ÚdeviceÚdtyperI   Úweight)r   r   Ú
isinstanceÚnumbersÚIntegralÚtuplerF   rG   rH   r   ÚtorchÚemptyrN   rI   Úregister_parameterÚreset_parameters)	r   rF   rG   rH   rI   rL   rM   Úfactory_kwargsr   s	           €r   r   zLayerNorm.__init__¼   sã   ø€ ð %+°UÑ;ˆÜ‰ÑÔÜÐ&¬×(8Ñ(8Ô9à 0Ð2ÐÜ %Ð&6Ó 7ˆÔØˆŒØ"4ˆÔØ×"Ò"Ü#Ü—‘˜D×1Ñ1ÑD°^ÑDóˆDŒKñ Ü%Ü—K‘K × 5Ñ 5ÑH¸ÑHó�•	ð ×'Ñ'¨°Õ5à×#Ñ# H¨dÔ3Ø×#Ñ# F¨DÔ1à×ÑÕr   c                 ó´   — | j                   rLt        j                  | j                  «       | j                  � t        j
                  | j                  «       y y y r   )rH   r   Úones_rN   rI   Úzeros_r.   s    r   rV   zLayerNorm.reset_parametersÝ   s?   € Ø×"Ò"Ü�J‰J�t—{‘{Ô#Ø�y‰yÐ$Ü—‘˜DŸI™IÕ&ð %ð #r   r    c                 ó„   — t        j                  || j                  | j                  | j                  | j
                  «      S r   )r#   Ú
layer_normrF   rN   rI   rG   r%   s     r   r&   zLayerNorm.forwardã   s0   € Ü�|‰|Ø�4×(Ñ(¨$¯+©+°t·y±yÀ$Ç(Á(ó
ð 	
r   c                 óZ   —  dj                   di | j                  ¤d| j                  d ui¤ŽS )NzW{normalized_shape}, eps={eps}, elementwise_affine={elementwise_affine}, bias={use_bias}Úuse_biasr*   ©r,   r-   rI   r.   s    r   r/   zLayerNorm.extra_reprè   ó<   € ð%ð ß$™fñVØ'+§}¡}ñVØ?C¿y¹yÐPTÐ?TòVð	
r   )çñhãˆµøä>TTNN©r   N)r3   r4   r5   r6   r7   rR   r8   r9   r:   ÚboolÚ_shape_tr   rV   r   r&   rC   r/   r;   r<   s   @r   r   r   i   s–   ø… ñKòZ F€MØ˜C ˜H‘oÓ%Ø	ƒJØÓð
 Ø#'ØØØñ à"ð ð ð ð !ð	 ð
 ð ð 
õ óB'ð
˜Vð 
¨ó 
ð

˜C÷ 
r   r   c                   ó¢   ‡ — e Zd ZU dZg d¢Zeed<   eed<   eed<   eed<   	 	 	 	 ddd	œdedededed
eddfˆ fd„Z	dd„Z
dedefd„Zdefd„Zˆ xZS )r   aR  Applies Group Normalization over a mini-batch of inputs.

    This layer implements the operation as described in
    the paper `Group Normalization <https://arxiv.org/abs/1803.08494>`__

    .. math::
        y = \frac{x - \mathrm{E}[x]}{ \sqrt{\mathrm{Var}[x] + \epsilon}} * \gamma + \beta

    The input channels are separated into :attr:`num_groups` groups, each containing
    ``num_channels / num_groups`` channels. :attr:`num_channels` must be divisible by
    :attr:`num_groups`. The mean and standard-deviation are calculated
    separately over each group. :math:`\gamma` and :math:`\beta` are learnable
    per-channel affine transform parameter vectors of size :attr:`num_channels` if
    :attr:`affine` is ``True``.
    The variance is calculated via the biased estimator, equivalent to
    `torch.var(input, correction=0)`.

    This layer uses statistics computed from input data in both training and
    evaluation modes.

    Args:
        num_groups (int): number of groups to separate the channels into
        num_channels (int): number of channels expected in input
        eps: a value added to the denominator for numerical stability. Default: 1e-5
        affine: a boolean value that when set to ``True``, this module
            has learnable per-channel affine parameters initialized to ones (for weights)
            and zeros (for biases). Default: ``True``
        bias: If set to ``False``, the layer will not learn an additive bias (only relevant if
            :attr:`affine` is ``True``). Default: ``True``

    Shape:
        - Input: :math:`(N, C, *)` where :math:`C=\text{num\_channels}`
        - Output: :math:`(N, C, *)` (same shape as input)

    Examples::

        >>> input = torch.randn(20, 6, 10, 10)
        >>> # Separate 6 channels into 3 groups
        >>> m = nn.GroupNorm(3, 6)
        >>> # Separate 6 channels into 6 groups (equivalent with InstanceNorm)
        >>> m = nn.GroupNorm(6, 6)
        >>> # Put all 6 channels into a single group (equivalent with LayerNorm)
        >>> m = nn.GroupNorm(1, 6)
        >>> # Activating the module
        >>> output = m(input)
    )Ú
num_groupsÚnum_channelsrG   Úaffinerf   rg   rG   rh   TN)rI   rI   r   c                óÔ  •— ||dœ}t         ‰	| �  «        ||z  dk7  rt        d|› d|› d�«      ‚|| _        || _        || _        || _        | j                  r^t        t        j                  |fi |¤Ž«      | _
        |r%t        t        j                  |fi |¤Ž«      | _        n7| j                  dd «       n$| j                  dd «       | j                  dd «       | j                  «        y )NrK   r   znum_channels (z#) must be divisible by num_groups (ú)rI   rN   )r   r   Ú
ValueErrorrf   rg   rG   rh   r   rS   rT   rN   rI   rU   rV   )
r   rf   rg   rG   rh   rL   rM   rI   rW   r   s
            €r   r   zGroupNorm.__init__%  sã   ø€ ð %+°UÑ;ˆÜ‰ÑÔØ˜*Ñ$¨Ò)ÜØ   Ð.QÐR\ÐQ]Ð]^Ð_óð ð %ˆŒØ(ˆÔØˆŒØˆŒØ�;Š;Ü#¤E§K¡K°Ñ$OÀÑ$OÓPˆDŒKÙÜ%¤e§k¡k°,Ñ&QÀ.Ñ&QÓR�•	à×'Ñ'¨°Õ5à×#Ñ# H¨dÔ3Ø×#Ñ# F¨DÔ1à×ÑÕr   c                 ó´   — | j                   rLt        j                  | j                  «       | j                  � t        j
                  | j                  «       y y y r   )rh   r   rY   rN   rI   rZ   r.   s    r   rV   zGroupNorm.reset_parametersG  s=   € Ø�;Š;Ü�J‰J�t—{‘{Ô#Ø�y‰yÐ$Ü—‘˜DŸI™IÕ&ð %ð r   r    c                 ó„   — t        j                  || j                  | j                  | j                  | j
                  «      S r   )r#   Ú
group_normrf   rN   rI   rG   r%   s     r   r&   zGroupNorm.forwardM  s)   € Ü�|‰|˜E 4§?¡?°D·K±KÀÇÁÈDÏHÉHÓUÐUr   c                 óZ   —  dj                   di | j                  ¤d| j                  d ui¤ŽS )NzI{num_groups}, {num_channels}, eps={eps}, affine={affine}, bias={use_bias}r^   r*   r_   r.   s    r   r/   zGroupNorm.extra_reprP  r`   r   )ra   TNNrb   )r3   r4   r5   r6   r7   r8   r9   r:   rc   r   rV   r   r&   rC   r/   r;   r<   s   @r   r   r   ï   s¥   ø… ñ-ò^ D€MØƒOØÓØ	ƒJØƒLð ØØØð  ð ò  àð  ð ð  ð ð	  ð
 ð  ð ð  ð 
õ  óD'ðV˜Vð V¨ó Vð
˜C÷ 
r   r   c            	       óÈ   ‡ — e Zd ZU dZg d¢Zeedf   ed<   edz  ed<   e	ed<   	 	 	 	 dde
dedz  de	ddfˆ fd	„Zdd
„Zdej                  dej                  fd„Zdefd„Zˆ xZS )r   a‚  Applies Root Mean Square Layer Normalization over a mini-batch of inputs.

    This layer implements the operation as described in
    the paper `Root Mean Square Layer Normalization <https://arxiv.org/pdf/1910.07467.pdf>`__

    .. math::
        y_i = \frac{x_i}{\mathrm{RMS}(x)} * \gamma_i, \quad
        \text{where} \quad \text{RMS}(x) = \sqrt{\epsilon + \frac{1}{n} \sum_{i=1}^{n} x_i^2}

    The RMS is taken over the last ``D`` dimensions, where ``D``
    is the dimension of :attr:`normalized_shape`. For example, if :attr:`normalized_shape`
    is ``(3, 5)`` (a 2-dimensional shape), the RMS is computed over
    the last 2 dimensions of the input.

    Args:
        normalized_shape (int or list or torch.Size): input shape from an expected input
            of size

            .. math::
                [* \times \text{normalized\_shape}[0] \times \text{normalized\_shape}[1]
                    \times \ldots \times \text{normalized\_shape}[-1]]

            If a single integer is used, it is treated as a singleton list, and this module will
            normalize over the last dimension which is expected to be of that specific size.
        eps (float, optional): a value added to the denominator for numerical stability.
            If not specified, uses the machine epsilon of the computation (opmath) type:
            fp16/bf16 and fp32 inputs use ``torch.finfo(torch.float32).eps``, while fp64
            inputs use ``torch.finfo(torch.float64).eps``. Default: ``None``
        elementwise_affine: a boolean value that when set to ``True``, this module
            has learnable per-element affine parameters initialized to ones (for weights). Default: ``True``.

    Shape:
        - Input: :math:`(N, *)`
        - Output: :math:`(N, *)` (same shape as input)

    Examples::

        >>> rms_norm = nn.RMSNorm([2, 3])
        >>> input = torch.randn(2, 2, 3)
        >>> rms_norm(input)

    rE   .rF   NrG   rH   r   c                 ó\  •— ||dœ}t         ‰| �  «        t        |t        j                  «      r|f}t        |«      | _        || _        || _        | j                  r/t        t        j                  | j                  fi |¤Ž«      | _        n| j                  dd «       | j                  «        y )NrK   rN   )r   r   rO   rP   rQ   rR   rF   rG   rH   r   rS   rT   rN   rU   rV   )r   rF   rG   rH   rL   rM   rW   r   s          €r   r   zRMSNorm.__init__ˆ  s›   ø€ ð %+°UÑ;ˆÜ‰ÑÔÜÐ&¬×(8Ñ(8Ô9à 0Ð2ÐÜ %Ð&6Ó 7ˆÔØˆŒØ"4ˆÔØ×"Ò"Ü#Ü—‘˜D×1Ñ1ÑD°^ÑDóˆD�Kð ×#Ñ# H¨dÔ3Ø×ÑÕr   c                 ó\   — | j                   r t        j                  | j                  «       yy)zS
        Resets parameters based on their initialization used in __init__.
        N)rH   r   rY   rN   r.   s    r   rV   zRMSNorm.reset_parameters   s"   € ð ×"Ò"Ü�J‰J�t—{‘{Õ#ð #r   Úxc                 ón   — t        j                  || j                  | j                  | j                  «      S r"   )r#   Úrms_normrF   rN   rG   )r   rs   s     r   r&   zRMSNorm.forward§  s'   € ô �z‰z˜!˜T×2Ñ2°D·K±KÀÇÁÓJÐJr   c                 ó:   —  dj                   di | j                  ¤ŽS )r)   zF{normalized_shape}, eps={eps}, elementwise_affine={elementwise_affine}r*   r+   r.   s    r   r/   zRMSNorm.extra_repr­  s)   € ð
=ð 6ß6<±fñNØ?C¿}¹}ñNð	
r   )NTNNrb   )r3   r4   r5   r6   r7   rR   r8   r9   r:   rc   rd   r   rV   rS   r   r&   rC   r/   r;   r<   s   @r   r   r   W  s›   ø… ñ)òV F€MØ˜C ˜H‘oÓ%Ø	�‰ÓØÓð
 !Ø#'ØØñ à"ð ð �T‰\ð ð !ð	 ð 
õ ó0$ðK˜Ÿ™ð K¨%¯,©,ó Kð
˜C÷ 
r   r   )rP   rS   r   r   Útorch.nnr   r#   r   Útorch.nn.parameterr   Ú
_functionsr	   r@   Úmoduler
   Ú__all__r   r8   Úlistrd   r   r   r   r*   r   r   ú<module>r}      s   ðã ã ß ß *Ý (å 9Ý ò V€ô7S˜ô 7SôtS�Fô Sð8 ��c‘‰?˜TÑ!€ôC
�ô C
ôLe
�ô e
ôP]
ˆfõ ]
r   