o
    .wi^                     @   s   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sAd
gZG dd deZdS )    )Sequence)AnyOptionalUnionN)Tensortensor)_r2_score_update)_relative_squared_error_compute)Metric)_MATPLOTLIB_AVAILABLE)_AX_TYPE_PLOT_OUT_TYPERelativeSquaredError.plotc                	       s   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dZdededdfddZdefddZ	ddeeeee f  dee defddZ  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                    s~   t  jdi | || _| jdt| jdd | jdt| jdd | jdt| jdd | jdtddd || _d S )	Nr   sum)defaultdist_reduce_fxr   r   r   r    )super__init__r   	add_statetorchzerosr   r   )selfr   r   r   	__class__r   X/home/ubuntu/sommelier/.venv/lib/python3.10/site-packages/torchmetrics/regression/rse.pyr   J   s   
zRelativeSquaredError.__init__predstargetc                 C   sN   t ||\}}}}|  j|7  _|  j|7  _|  j|7  _|  j|7  _dS )z*Update state with predictions and targets.N)r   r   r   r   r   )r"   r&   r'   r   r   r   r   r   r   r%   updateZ   s
   zRelativeSquaredError.updatec                 C   s   t | j| j| j| j| jdS )z+Computes relative squared error over state.)r   )r	   r   r   r   r   r   )r"   r   r   r%   computec   s   zRelativeSquaredError.computevalaxc                 C   s   |  ||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+   r   r   r%   ploti   s   (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   r-   __classcell__r   r   r#   r%   r      s<   
 #	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   r%   <module>   s   