§
    ’©ºj  ã                   ó`   — d dl mZ d dlZd dlmZmZ d dlmZ ddededee         d	ed
ef
d„Z	dS )é    )ÚOptionalN)ÚTensorÚtensor)Ú"_check_retrieval_functional_inputsFÚpredsÚtargetÚtop_kÚ
adaptive_kÚreturnc                 ó~  — t          | |¦  «        \  } }t          |t          ¦  «        st          d¦  «        ‚|�|r|| j        d         k    r| j        d         }t          |t
          ¦  «        r|dk    st          d¦  «        ‚|                     ¦   «         st          d| j        ¬¦  «        S t          j
        | dk    |t          j        |¦  «        ¦  «        }||                      t          || j        d         ¦  «        d¬¦  «        d	                                       ¦   «                              ¦   «         }||z  S )
a  Compute the precision metric for information retrieval.

    Precision is the fraction of relevant documents among all the retrieved documents.

    ``preds`` and ``target`` should be of the same shape and live on the same device. If no ``target`` is ``True``,
    ``0`` is returned. ``target`` must be either `bool` or `integers` and ``preds`` must be ``float``,
    otherwise an error is raised. If you want to measure Precision@K, ``top_k`` must be a positive integer.

    Args:
        preds: estimated probabilities of each document to be relevant.
        target: ground truth about each document being relevant or not.
        top_k: consider only the top k elements (default: ``None``, which considers them all)
        adaptive_k: adjust `k` to `min(k, number of documents)` for each query

    Returns:
        A single-value tensor with the precision (at ``top_k``) of the predictions ``preds`` w.r.t. the labels
          ``target``.

    Raises:
        ValueError:
            If ``top_k`` is not `None` or an integer larger than 0.
        ValueError:
            If ``adaptive_k`` is not boolean.

    Example:
        >>> preds = tensor([0.2, 0.3, 0.5])
        >>> target = tensor([True, False, True])
        >>> retrieval_precision(preds, target, top_k=2)
        tensor(0.5000)

    z `adaptive_k` has to be a booleanNéÿÿÿÿr   z,`top_k` has to be a positive integer or Noneg        )Údevice)Údimé   )r   Ú
isinstanceÚboolÚ
ValueErrorÚshapeÚintÚsumr   r   ÚtorchÚwhereÚ
zeros_likeÚtopkÚminÚfloat)r   r   r	   r
   Útarget_filteredÚrelevants         ú{/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/torchmetrics/functional/retrieval/precision.pyÚretrieval_precisionr       s   € õ@ 7°u¸fÑEÔE�M€Eˆ6å�j¥$Ñ'Ô'ð =ÝÐ;Ñ<Ô<Ð<à€}˜€}¨°´¸B´Ò(?Ð(?Ø”˜B”ˆå�u�cÑ"Ô"ð I u¨q¢y yÝÐGÑHÔHÐHà�:Š:‰<Œ<ð 0Ý�c %¤,Ð/Ñ/Ô/Ð/å”k %¨!¢)¨VµUÔ5EÀfÑ5MÔ5MÑNÔN€OØ˜uŸzšz­#¨e°U´[À´_Ñ*EÔ*EÈ2˜zÑNÔNÈqÔQÔR×VÒVÑXÔX×^Ò^Ñ`Ô`€Hà�eÑÐó    )NF)
Útypingr   r   r   r   Útorchmetrics.utilities.checksr   r   r   r    © r!   r   ú<module>r%      s˜   ðð Ð Ð Ð Ð Ð à €€€Ø  Ð  Ð  Ð  Ð  Ð  Ð  Ð  à LÐ LÐ LÐ LÐ LÐ Lð1ð 1˜vð 1¨vð 1¸hÀs¼mð 1Ð`dð 1Ðqwð 1ð 1ð 1ð 1ð 1ð 1r!   