Ë
    þÍ:js  ã                   ó¤   — d dl mZ d dlmZmZmZmZ d dlmZ d dl	m
Z
 d dlmZmZ d dlmZ d dlmZ d dlmZ d d	lmZmZ esd
gZ G d„ de«      Zy)é    )ÚSequence)ÚAnyÚListÚOptionalÚUnion)ÚTensor)ÚLiteral)Ú_cosine_similarity_computeÚ_cosine_similarity_update)ÚMetric)Údim_zero_cat)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEzCosineSimilarity.plotc                   óö   ‡ — e Zd ZU dZdZeed<   dZeed<   dZeed<   dZ	e
ed<   d	Ze
ed
<   ee   ed<   ee   ed<   	 dded   deddfˆ fd„Zdededdfd„Zdefd„Z	 ddeeeee   f      dee   defd„Zˆ xZS )ÚCosineSimilaritya  Compute the `Cosine Similarity`_.

    .. math::
        cos_{sim}(x,y) = \frac{x \cdot y}{||x|| \cdot ||y||} =
        \frac{\sum_{i=1}^n x_i y_i}{\sqrt{\sum_{i=1}^n x_i^2}\sqrt{\sum_{i=1}^n y_i^2}}

    where :math:`y` is a tensor of target values, and :math:`x` is a tensor of predictions.

    As input to ``forward`` and ``update`` the metric accepts the following input:

    - ``preds`` (:class:`~torch.Tensor`): Predicted float tensor with shape ``(N,d)``
    - ``target`` (:class:`~torch.Tensor`): Ground truth float tensor with shape ``(N,d)``

    As output of ``forward`` and ``compute`` the metric returns the following output:

    - ``cosine_similarity`` (:class:`~torch.Tensor`): A float tensor with the cosine similarity

    Args:
        reduction: how to reduce over the batch dimension using 'sum', 'mean' or 'none' (taking the individual scores)
        kwargs: Additional keyword arguments, see :ref:`Metric kwargs` for more info.

    Example:
        >>> from torch import tensor
        >>> from torchmetrics.regression import CosineSimilarity
        >>> target = tensor([[0, 1], [1, 1]])
        >>> preds = tensor([[0, 1], [0, 1]])
        >>> cosine_similarity = CosineSimilarity(reduction = 'mean')
        >>> cosine_similarity(preds, target)
        tensor(0.8536)

    TÚis_differentiableÚhigher_is_betterFÚfull_state_updateg        Úplot_lower_boundg      ð?Úplot_upper_boundÚpredsÚtargetÚ	reduction)ÚmeanÚsumÚnoneNÚkwargsÚreturnNc                 ó°   •— t        ‰| �  di |¤Ž d}||vrt        d|› d|› �«      ‚|| _        | j	                  dg d¬«       | j	                  dg d¬«       y )	N)r   r   r   Nz+Expected argument `reduction` to be one of z	 but got r   Úcat)Údist_reduce_fxr   © )ÚsuperÚ__init__Ú
ValueErrorr   Ú	add_state)Úselfr   r   Úallowed_reductionÚ	__class__s       €ú~/home/mcse/projects/srt_converter/srt-converter-venv/lib/python3.12/site-packages/torchmetrics/regression/cosine_similarity.pyr%   zCosineSimilarity.__init__H   sm   ø€ ô
 	‰ÑÑ"˜6Ò"Ø9ÐØÐ-Ñ-ÜÐJÐK\ÐJ]Ð]fÐgpÐfqÐrÓsÐsØ"ˆŒà�‰�w °5ˆÔ9Ø�‰�x °EˆÕ:ó    c                 óŽ   — t        ||«      \  }}| j                  j                  |«       | j                  j                  |«       y)z2Update metric states with predictions and targets.N)r   r   Úappendr   ©r(   r   r   s      r+   ÚupdatezCosineSimilarity.updateV   s6   € ä1°%¸Ó@‰ˆˆvà�
‰
×Ñ˜%Ô Ø�‰×Ñ˜6Õ"r,   c                 ó„   — t        | j                  «      }t        | j                  «      }t        ||| j                  «      S )zCompute metric.)r   r   r   r
   r   r/   s      r+   ÚcomputezCosineSimilarity.compute]   s1   € ä˜TŸZ™ZÓ(ˆÜ˜dŸk™kÓ*ˆÜ)¨%°¸¿¹ÓHÐHr,   ÚvalÚaxc                 ó&   — | j                  ||«      S )a  Plot a single or multiple values from the metric.

        Args:
            val: Either a single result from calling `metric.forward` or `metric.compute` or a list of these results.
                If no value is provided, will automatically call `metric.compute` and plot that result.
            ax: An matplotlib axis object. If provided will add plot to that axis

        Returns:
            Figure and Axes object

        Raises:
            ModuleNotFoundError:
                If `matplotlib` is not installed

        .. plot::
            :scale: 75

            >>> from torch import randn
            >>> # Example plotting a single value
            >>> from torchmetrics.regression import CosineSimilarity
            >>> metric = CosineSimilarity()
            >>> metric.update(randn(10,2), randn(10,2))
            >>> fig_, ax_ = metric.plot()

        .. plot::
            :scale: 75

            >>> from torch import randn
            >>> # Example plotting multiple values
            >>> from torchmetrics.regression import CosineSimilarity
            >>> metric = CosineSimilarity()
            >>> values = []
            >>> for _ in range(10):
            ...     values.append(metric(randn(10,2), randn(10,2)))
            >>> fig, ax = metric.plot(values)

        )Ú_plot)r(   r3   r4   s      r+   ÚplotzCosineSimilarity.plotc   s   € ðP �z‰z˜#˜rÓ"Ð"r,   )r   )NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚboolÚ__annotations__r   r   r   Úfloatr   r   r   r	   r   r%   r0   r2   r   r   r   r   r   r7   Ú__classcell__)r*   s   @r+   r   r      sé   ø… ñð@ #Ð�tÓ"Ø!Ð�dÓ!Ø#Ð�tÓ#Ø!Ð�eÓ!Ø!Ð�eÓ!à�‰<ÓØ�‰LÓð ;@ñ;àÐ6Ñ7ð;ð ð;ð 
õ	;ð#˜Fð #¨Fð #°tó #ðI˜ó Ið _cñ(#Ø˜E &¨(°6Ñ*:Ð":Ñ;Ñ<ð(#ØIQÐRZÑI[ð(#à	÷(#r,   r   N)Úcollections.abcr   Útypingr   r   r   r   Útorchr   Útyping_extensionsr	   Ú4torchmetrics.functional.regression.cosine_similarityr
   r   Útorchmetrics.metricr   Útorchmetrics.utilities.datar   Útorchmetrics.utilities.importsr   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   r#   r,   r+   ú<module>rJ      s?   ðõ %ß -Ó -å Ý %ç vÝ &Ý 4Ý @ß @áØ/Ð0Ðôm#�võ m#r,   