
    i^                         d dl mZ d dlmZmZmZ d dl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 d d	lmZmZ esd
gZ G d de      Zy)    )Sequence)AnyOptionalUnionN)Tensortensor)_r2_score_update)_relative_squared_error_compute)Metric)_MATPLOTLIB_AVAILABLE)_AX_TYPE_PLOT_OUT_TYPEzRelativeSquaredError.plotc            	            e Zd ZU dZdZdZdZeed<   eed<   eed<   eed<   	 	 dde	d	e
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 )RelativeSquaredErrora  Computes the relative squared error (RSE).

    .. math:: \text{RSE} = \frac{\sum_i^N(y_i - \hat{y_i})^2}{\sum_i^N(y_i - \overline{y})^2}

    Where :math:`y` is a tensor of target values with mean :math:`\overline{y}`, and
    :math:`\hat{y}` is a tensor of predictions.

    If num_outputs > 1, the returned value is averaged over all the outputs.

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

    - ``preds`` (:class:`~torch.Tensor`): Predictions from model in float tensor with shape ``(N,)``
      or ``(N, M)`` (multioutput)
    - ``target`` (:class:`~torch.Tensor`): Ground truth values in float tensor with shape ``(N,)``
      or ``(N, M)`` (multioutput)

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

    - ``rse`` (:class:`~torch.Tensor`): A tensor with the RSE score(s)

    Args:
        num_outputs: Number of outputs in multioutput setting
        squared: If True returns RSE value, if False returns RRSE value.
        kwargs: Additional keyword arguments, see :ref:`Metric kwargs` for more info.

    Example:
        >>> from torchmetrics.regression import RelativeSquaredError
        >>> target = torch.tensor([3, -0.5, 2, 7])
        >>> preds = torch.tensor([2.5, 0.0, 2, 8])
        >>> relative_squared_error = RelativeSquaredError()
        >>> relative_squared_error(preds, target)
        tensor(0.0514)

    TFsum_squared_error	sum_errorresidualtotalnum_outputssquaredkwargsreturnNc                    t        |   di | || _        | j                  dt	        j
                  | j                        d       | j                  dt	        j
                  | j                        d       | j                  dt	        j
                  | j                        d       | j                  dt        d      d       || _        y )	Nr   sum)defaultdist_reduce_fxr   r   r   r    )super__init__r   	add_statetorchzerosr   r   )selfr   r   r   	__class__s       p/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/torchmetrics/regression/rse.pyr   zRelativeSquaredError.__init__J   s     	"6"&*EKK@P@P4Qbgh{EKK8H8H,IZ_`z5;;t7G7G+HY^_wq	%H    predstargetc                     t        ||      \  }}}}| xj                  |z  c_        | xj                  |z  c_        | xj                  |z  c_        | xj                  |z  c_        y)z*Update state with predictions and targets.N)r	   r   r   r   r   )r#   r'   r(   r   r   r   r   s          r%   updatezRelativeSquaredError.updateZ   sU    8HPV8W59h"33)#!

e
r&   c                     t        | j                  | j                  | j                  | j                  | j
                        S )z+Computes relative squared error over state.)r   )r
   r   r   r   r   r   )r#   s    r%   computezRelativeSquaredError.computec   s3    .""DNNDMM4::W[WcWc
 	
r&   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 RelativeSquaredError
            >>> metric = RelativeSquaredError()
            >>> metric.update(randn(10,), randn(10,))
            >>> fig_, ax_ = metric.plot()

        .. plot::
            :scale: 75

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

        )_plot)r#   r-   r.   s      r%   plotzRelativeSquaredError.ploti   s    P zz#r""r&   )   T)NN)__name__
__module____qualname____doc__is_differentiablehigher_is_betterfull_state_updater   __annotations__intboolr   r   r*   r,   r   r   r   r   r   r1   __classcell__)r$   s   @r%   r   r      s    !F M   	
 
 F F t 
 
 _c(#E&(6*:":;<(#IQRZI[(#	(#r&   r   )collections.abcr   typingr   r   r   r!   r   r   %torchmetrics.functional.regression.r2r	   &torchmetrics.functional.regression.rser
   torchmetrics.metricr   torchmetrics.utilities.importsr   torchmetrics.utilities.plotr   r   __doctest_skip__r   r   r&   r%   <module>rF      s?    % ' '    B R & @ @34s#6 s#r&   