Ë
    þÍ:j^  ã                   óœ   — 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/home/mcse/projects/srt_converter/srt-converter-venv/lib/python3.12/site-packages/torchmetrics/regression/rse.pyr   zRelativeSquaredError.__init__J   s¡   ø€ ô 	‰ÑÑ"˜6Ò"à&ˆÔà�‰Ð*´E·K±KÀ×@PÑ@PÓ4QÐbgˆÔhØ�‰�{¬E¯K©K¸×8HÑ8HÓ,IÐZ_ˆÔ`Ø�‰�z¬5¯;©;°t×7GÑ7GÓ+HÐY^ˆÔ_Ø�‰�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ÈÐPVÓ8WÑ5Ð˜9 h°à×ÒÐ"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   € ä.Ø×"Ñ" D§N¡N°D·M±MÀ4Ç:Á:ÐW[×WcÑWcô
ð 	
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 �z‰z˜#˜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Ñ*:Ð":Ñ;Ñ<ð(#ØIQÐRZÑI[ð(#à	÷(#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&   