§
    ’©ºj  ã                   óœ   — 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_precision)ÚRetrievalMetric)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEzRetrievalPrecision.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ee         dee         d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 )ÚRetrievalPrecisionaí  Compute `IR Precision`_.

    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:

    - ``p@k`` (:class:`~torch.Tensor`): A single-value tensor with the precision (at ``top_k``) 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)
        adaptive_k: Adjust ``top_k`` to ``min(k, number of documents)`` for each query
        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.
        ValueError:
            If ``adaptive_k`` is not boolean.

    Example:
        >>> from torch import tensor
        >>> from torchmetrics.retrieval import RetrievalPrecision
        >>> 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])
        >>> p2 = RetrievalPrecision(top_k=2)
        >>> p2(preds, target, indexes=indexes)
        tensor(0.5000)

    FÚis_differentiableTÚhigher_is_betterÚfull_state_updateg        Úplot_lower_boundg      ð?Úplot_upper_boundÚnegNÚmeanÚempty_target_actionÚignore_indexÚtop_kÚ
adaptive_kÚaggregation)r   ÚmedianÚminÚmaxÚkwargsÚreturnc                 óþ   •—  t          ¦   «         j        d|||dœ|¤Ž |�*t          |t          ¦  «        r|dk    st	          d¦  «        ‚t          |t
          ¦  «        st	          d¦  «        ‚|| _        || _        d S )N)r   r   r   r   z,`top_k` has to be a positive integer or Nonez `adaptive_k` has to be a boolean© )ÚsuperÚ__init__Ú
isinstanceÚintÚ
ValueErrorÚboolr   r   )Úselfr   r   r   r   r   r    Ú	__class__s          €úp/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/torchmetrics/retrieval/precision.pyr%   zRetrievalPrecision.__init__e   sŸ   ø€ ð 	�‰ŒÔð 	
Ø 3Ø%Ø#ð	
ð 	
ð ð		
ð 	
ð 	
ð Ð¥j°½Ñ&<Ô&<ÐÀÈÂÀÝÐKÑLÔLÐLÝ˜*¥dÑ+Ô+ð 	AÝÐ?Ñ@Ô@Ð@ØˆŒ
Ø$ˆŒˆˆó    ÚpredsÚtargetc                 ó<   — t          ||| j        | j        ¬¦  «        S )N)r   r   )r
   r   r   )r*   r.   r/   s      r,   Ú_metriczRetrievalPrecision._metric|   s   € Ý" 5¨&¸¼
ÈtÌÐ_Ñ_Ô_Ð_r-   ÚvalÚaxc                 ó.   — |                       ||¦  «        S )ac  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 RetrievalPrecision
            >>> # Example plotting a single value
            >>> metric = RetrievalPrecision()
            >>> 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 RetrievalPrecision
            >>> # Example plotting multiple values
            >>> metric = RetrievalPrecision()
            >>> 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*   r2   r3   s      r,   ÚplotzRetrievalPrecision.plot   s   € ðP �zŠz˜#˜rÑ"Ô"Ð"r-   )r   NNFr   )NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r)   Ú__annotations__r   r   r   Úfloatr   Ústrr   r'   r   r	   r   r   r%   r   r1   r   r   r   r6   Ú__classcell__)r+   s   @r,   r   r      s•  ø€ € € € € € ð?ð ?ðB $Ð�tÐ#Ð#Ñ#Ø!Ð�dÐ!Ð!Ñ!Ø#Ð�tÐ#Ð#Ñ#Ø!Ð�eÐ!Ð!Ñ!Ø!Ð�eÐ!Ð!Ñ!ð $)Ø&*Ø#Ø ØPVð%ð %à ð%ð ˜s”mð%ð ˜Œ}ð	%ð
 ð%ð ˜7Ð#AÔBÀHÐLÔMð%ð ð%ð 
ð%ð %ð %ð %ð %ð %ð.`˜Vð `¨Vð `¸ð `ð `ð `ð `ð _cð(#ð (#Ø˜E &¨(°6Ô*:Ð":Ô;Ô<ð(#ØIQÐRZÔI[ð(#à	ð(#ð (#ð (#ð (#ð (#ð (#ð (#ð (#r-   r   N)Úcollections.abcr   Útypingr   r   r   r   Útorchr   Útyping_extensionsr	   Ú+torchmetrics.functional.retrieval.precisionr
   Útorchmetrics.retrieval.baser   Útorchmetrics.utilities.importsr   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   r#   r-   r,   ú<module>rH      sþ   ðð %Ð $Ð $Ð $Ð $Ð $Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1à Ð Ð Ð Ð Ð Ø %Ð %Ð %Ð %Ð %Ð %à KÐ KÐ KÐ KÐ KÐ KØ 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø @Ð @Ð @Ð @Ð @Ð @Ø @Ð @Ð @Ð @Ð @Ð @Ð @Ð @àð 3Ø1Ð2ÐðJ#ð J#ð J#ð J#ð J#˜ñ J#ô J#ð J#ð J#ð J#r-   