§
    ’©ºjY  ã                   óœ   — 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 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dS )é    )ÚSequence)ÚAnyÚCallableÚOptionalÚUnion)ÚTensor)ÚLiteral)Úretrieval_auroc)ÚRetrievalMetric)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEzRetrievalAUROC.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
<   	 	 	 	 	 dded         dee         dee         dee
         deed         ef         deddfˆ fd„Zdededefd„Z	 ddeeeee         f                  dee         defd„Zˆ xZS ) ÚRetrievalAUROCañ  Compute area under the receiver operating characteristic curve (AUROC) for information retrieval.

    Works with binary target data. Accepts float predictions from a model output.

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

    - ``preds`` (:class:`~torch.Tensor`): A float tensor of shape ``(N, ...)``
    - ``target`` (:class:`~torch.Tensor`): A long or bool tensor of shape ``(N, ...)``
    - ``indexes`` (:class:`~torch.Tensor`): A long tensor of shape ``(N, ...)`` which indicate to which query a
      prediction belongs

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

    - ``auroc@k`` (:class:`~torch.Tensor`): A single-value tensor with the auroc value
      of the predictions ``preds`` w.r.t. the labels ``target``.

    All ``indexes``, ``preds`` and ``target`` must have the same dimension and will be flatten at the beginning,
    so that for example, a tensor of shape ``(N, M)`` is treated as ``(N * M, )``. Predictions will be first grouped by
    ``indexes`` and then will be computed as the mean of the metric over each query.

    Args:
        empty_target_action:
            Specify what to do with queries that do not have at least a positive ``target``. Choose from:

            - ``'neg'``: those queries count as ``0.0`` (default)
            - ``'pos'``: those queries count as ``1.0``
            - ``'skip'``: skip those queries; if all queries are skipped, ``0.0`` is returned
            - ``'error'``: raise a ``ValueError``

        ignore_index: Ignore predictions where the target is equal to this number.
        top_k: Consider only the top k elements for each query (default: ``None``, which considers them all)
        max_fpr: If not ``None``, calculates standardized partial AUC over the range ``[0, max_fpr]``.
        aggregation:
            Specify how to aggregate over indexes. Can either a custom callable function that takes in a single tensor
            and returns a scalar value or one of the following strings:

            - ``'mean'``: average value is returned
            - ``'median'``: median value is returned
            - ``'max'``: max value is returned
            - ``'min'``: min value is returned

        kwargs: Additional keyword arguments, see :ref:`Metric kwargs` for more info.

    Raises:
        ValueError:
            If ``empty_target_action`` is not one of ``error``, ``skip``, ``neg`` or ``pos``.
        ValueError:
            If ``ignore_index`` is not `None` or an integer.
        ValueError:
            If ``top_k`` is not ``None`` or not an integer greater than 0.

    Example:
        >>> from torch import tensor
        >>> from torchmetrics.retrieval import RetrievalAUROC
        >>> indexes = tensor([0, 0, 0, 1, 1, 1, 1])
        >>> preds = tensor([0.2, 0.3, 0.5, 0.1, 0.3, 0.5, 0.2])
        >>> target = tensor([False, False, True, False, True, False, True])
        >>> rmap = RetrievalAUROC()
        >>> rmap(preds, target, indexes=indexes)
        tensor(0.7500)

    FÚis_differentiableTÚhigher_is_betterÚfull_state_updateg        Úplot_lower_boundg      ð?Úplot_upper_boundÚnegNÚmeanÚempty_target_action)ÚerrorÚskipr   ÚposÚignore_indexÚtop_kÚmax_fprÚaggregation)r   ÚmedianÚminÚmaxÚkwargsÚreturnc                 ó(  •—  t          ¦   «         j        d|||dœ|¤Ž |�*t          |t          ¦  «        r|dk    st	          d¦  «        ‚|| _        |�7t          |t          ¦  «        s"d|cxk     rdk    rn nt	          d|› �¦  «        ‚|| _        d S )N)r   r   r   r   z,`top_k` has to be a positive integer or Noneé   z@Arguments `max_fpr` should be a float in range (0, 1], but got: © )ÚsuperÚ__init__Ú
isinstanceÚintÚ
ValueErrorr   Úfloatr   )Úselfr   r   r   r   r   r#   Ú	__class__s          €úl/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/torchmetrics/retrieval/auroc.pyr)   zRetrievalAUROC.__init__c   sÌ   ø€ ð 	�‰ŒÔð 	
Ø 3Ø%Ø#ð	
ð 	
ð ð		
ð 	
ð 	
ð Ð¥j°½Ñ&<Ô&<ÐÀÈÂÀÝÐKÑLÔLÐLØˆŒ
ØÐ¥z°'½5Ñ'AÔ'AÐÀaÈ'ÐFVÐFVÒFVÐFVÐUVÒFVÐFVÐFVÐFVÐFVÝÐiÐ`gÐiÐiÑjÔjÐjØˆŒˆˆó    ÚpredsÚtargetc                 ó<   — t          ||| j        | j        ¬¦  «        S )N)r   r   )r
   r   r   )r.   r2   r3   s      r0   Ú_metriczRetrievalAUROC._metricy   s   € Ý˜u f°D´JÈÌÐUÑUÔUÐUr1   ÚvalÚaxc                 ó.   — |                       ||¦  «        S )aS  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

            >>> import torch
            >>> from torchmetrics.retrieval import RetrievalAUROC
            >>> # Example plotting a single value
            >>> metric = RetrievalAUROC()
            >>> metric.update(torch.rand(10,), torch.randint(2, (10,)), indexes=torch.randint(2,(10,)))
            >>> fig_, ax_ = metric.plot()

        .. plot::
            :scale: 75

            >>> import torch
            >>> from torchmetrics.retrieval import RetrievalAUROC
            >>> # Example plotting multiple values
            >>> metric = RetrievalAUROC()
            >>> values = []
            >>> for _ in range(10):
            ...     values.append(metric(torch.rand(10,), torch.randint(2, (10,)), indexes=torch.randint(2,(10,))))
            >>> fig, ax = metric.plot(values)

        )Ú_plot)r.   r6   r7   s      r0   ÚplotzRetrievalAUROC.plot|   s   € ðP �zŠz˜#˜rÑ"Ô"Ð"r1   )r   NNNr   )NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚboolÚ__annotations__r   r   r   r-   r   r	   r   r+   r   r   r   r)   r   r5   r   r   r   r:   Ú__classcell__)r/   s   @r0   r   r      s¡  ø€ € € € € € ð=ð =ð~ $Ð�tÐ#Ð#Ñ#Ø!Ð�dÐ!Ð!Ñ!Ø#Ð�tÐ#Ð#Ñ#Ø!Ð�eÐ!Ð!Ñ!Ø!Ð�eÐ!Ð!Ñ!ð GLØ&*Ø#Ø#'ØPVðð à$Ð%BÔCðð ˜s”mðð ˜Œ}ð	ð
 ˜%”ðð ˜7Ð#AÔBÀHÐLÔMðð ðð 
ðð ð ð ð ð ð,V˜Vð V¨Vð V¸ð Vð Vð Vð Vð _cð(#ð (#Ø˜E &¨(°6Ô*:Ð":Ô;Ô<ð(#ØIQÐRZÔI[ð(#à	ð(#ð (#ð (#ð (#ð (#ð (#ð (#ð (#r1   r   N)Úcollections.abcr   Útypingr   r   r   r   Útorchr   Útyping_extensionsr	   Ú'torchmetrics.functional.retrieval.aurocr
   Útorchmetrics.retrieval.baser   Útorchmetrics.utilities.importsr   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   r'   r1   r0   ú<module>rK      sþ   ðð %Ð $Ð $Ð $Ð $Ð $Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1à Ð Ð Ð Ð Ð Ø %Ð %Ð %Ð %Ð %Ð %à CÐ CÐ CÐ CÐ CÐ CØ 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø @Ð @Ð @Ð @Ð @Ð @Ø @Ð @Ð @Ð @Ð @Ð @Ð @Ð @àð /Ø-Ð.ÐðG#ð G#ð G#ð G#ð G#�_ñ G#ô G#ð G#ð G#ð G#r1   