
    i                         d dl mZ d dl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edee   d	ee   d
efdZ	 	 	 ddedee   ded   d	ee   d
ef
dZy)    )OptionalN)Tensor)Literal)_check_input_reduce_distance_matrix)_safe_matmulxyzero_diagonalreturnc                    t        | ||      \  } }}t        j                  | dd      }| |j                  d      z  } t        j                  |dd      }||j                  d      z  }t	        | |      }|r|j                  d       |S )zCalculate the pairwise cosine similarity matrix.

    Args:
        x: tensor of shape ``[N,d]``
        y: tensor of shape ``[M,d]``
        zero_diagonal: determines if the diagonal of the distance matrix should be set to zero

          )pdimr   )r   torchnorm	unsqueezer   fill_diagonal_)r	   r
   r   r   distances        |/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/torchmetrics/functional/pairwise/cosine.py"_pairwise_cosine_similarity_updater      s     'q!];Aq-::a1!$D	DNN1A::a1!$D	DNN1AAq!H"O    	reduction)meansumnoneNc                 4    t        | ||      }t        ||      S )an  Calculate pairwise cosine similarity.

    .. math::
        s_{cos}(x,y) = \frac{<x,y>}{||x|| \cdot ||y||}
                     = \frac{\sum_{d=1}^D x_d \cdot y_d }{\sqrt{\sum_{d=1}^D x_i^2} \cdot \sqrt{\sum_{d=1}^D y_i^2}}

    If both :math:`x` and :math:`y` are passed in, the calculation will be performed pairwise
    between the rows of :math:`x` and :math:`y`.
    If only :math:`x` is passed in, the calculation will be performed between the rows of :math:`x`.

    Args:
        x: Tensor with shape ``[N, d]``
        y: Tensor with shape ``[M, d]``, optional
        reduction: reduction to apply along the last dimension. Choose between `'mean'`, `'sum'`
            (applied along column dimension) or  `'none'`, `None` for no reduction
        zero_diagonal: if the diagonal of the distance matrix should be set to 0. If only :math:`x` is given
            this defaults to ``True`` else if :math:`y` is also given it defaults to ``False``

    Returns:
        A ``[N,N]`` matrix of distances if only ``x`` is given, else a ``[N,M]`` matrix

    Example:
        >>> import torch
        >>> from torchmetrics.functional.pairwise import pairwise_cosine_similarity
        >>> x = torch.tensor([[2, 3], [3, 5], [5, 8]], dtype=torch.float32)
        >>> y = torch.tensor([[1, 0], [2, 1]], dtype=torch.float32)
        >>> pairwise_cosine_similarity(x, y)
        tensor([[0.5547, 0.8682],
                [0.5145, 0.8437],
                [0.5300, 0.8533]])
        >>> pairwise_cosine_similarity(x)
        tensor([[0.0000, 0.9989, 0.9996],
                [0.9989, 0.0000, 0.9998],
                [0.9996, 0.9998, 0.0000]])

    )r   r   )r	   r
   r   r   r   s        r   pairwise_cosine_similarityr   0   s     T 2!QFH"8Y77r   )NN)NNN)typingr   r   r   typing_extensionsr   (torchmetrics.functional.pairwise.helpersr   r   torchmetrics.utilities.computer   boolr   r    r   r   <module>r&      s       % Z 7 LP6":B4.4 6:$(	+8+8+8 23+8 D>	+8
 +8r   