Ë
    ýÿæið  ã                   óš   — d dl mZ d dlmZmZmZ d dlmZ d dlm	Z	 d dl
mZmZ d dlmZmZ d dlmZmZ esdd	gZnesd	gZ G d
„ de	«      Zy)é    )ÚSequence)ÚAnyÚOptionalÚUnion)ÚTensor)ÚIntersectionOverUnion)Ú_ciou_computeÚ_ciou_update)Ú_MATPLOTLIB_AVAILABLEÚ_TORCHVISION_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEÚCompleteIntersectionOverUnionz"CompleteIntersectionOverUnion.plotc                   ó
  ‡ — e Zd ZU dZdZeed<   dZe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dededdfˆ fd„Zedededefd„«       Ze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 )r   a˜  Computes Complete Intersection Over Union (`CIoU`_).

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

    - ``preds`` (:class:`~List`): A list consisting of dictionaries each containing the key-values
      (each dictionary corresponds to a single image). Parameters that should be provided per dict:

        - ``boxes`` (:class:`~torch.Tensor`): float tensor of shape ``(num_boxes, 4)`` containing ``num_boxes``
          detection boxes of the format specified in the constructor.
          By default, this method expects ``(xmin, ymin, xmax, ymax)`` in absolute image coordinates.
        - ``labels`` (:class:`~torch.Tensor`): integer tensor of shape ``(num_boxes)`` containing 0-indexed detection
          classes for the boxes.

    - ``target`` (:class:`~List`): A list consisting of dictionaries each containing the key-values
      (each dictionary corresponds to a single image). Parameters that should be provided per dict:

        - ``boxes`` (:class:`~torch.Tensor`): float tensor of shape ``(num_boxes, 4)`` containing ``num_boxes`` ground
          truth boxes of the format specified in the constructor.
          By default, this method expects ``(xmin, ymin, xmax, ymax)`` in absolute image coordinates.
        - ``labels`` (:class:`~torch.Tensor`): integer tensor of shape ``(num_boxes)`` containing 0-indexed detection
          classes for the boxes.

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

    - ``ciou_dict``: A dictionary containing the following key-values:

        - ciou: (:class:`~torch.Tensor`) with overall ciou value over all classes and samples.
        - ciou/cl_{cl}: (:class:`~torch.Tensor`), if argument ``class_metrics=True``

    Args:
        box_format:
            Input format of given boxes. Supported formats are ``[`xyxy`, `xywh`, `cxcywh`]``.
        iou_thresholds:
            Optional IoU thresholds for evaluation. If set to `None` the threshold is ignored.
        class_metrics:
            Option to enable per-class metrics for IoU. Has a performance impact.
        respect_labels:
            Ignore values from boxes that do not have the same label as the ground truth box. Else will compute Iou
            between all pairs of boxes.
        kwargs:
            Additional keyword arguments, see :ref:`Metric kwargs` for more info.

    Example:
        >>> import torch
        >>> from torchmetrics.detection import CompleteIntersectionOverUnion
        >>> preds = [
        ...    {
        ...        "boxes": torch.tensor([[296.55, 93.96, 314.97, 152.79], [298.55, 98.96, 314.97, 151.79]]),
        ...        "scores": torch.tensor([0.236, 0.56]),
        ...        "labels": torch.tensor([4, 5]),
        ...    }
        ... ]
        >>> target = [
        ...    {
        ...        "boxes": torch.tensor([[300.00, 100.00, 315.00, 150.00]]),
        ...        "labels": torch.tensor([5]),
        ...    }
        ... ]
        >>> metric = CompleteIntersectionOverUnion()
        >>> metric(preds, target)
        {'ciou': tensor(0.8611)}

    Raises:
        ModuleNotFoundError:
            If torchvision is not installed with version 0.13.0 or newer.

    FÚis_differentiableTÚhigher_is_betterÚfull_state_updateÚciouÚ	_iou_typeg       ÀÚ_invalid_valNÚ
box_formatÚiou_thresholdÚclass_metricsÚrespect_labelsÚkwargsÚreturnc                 ó†   •— t         s't        d| j                  j                  «       › d�«      ‚t	        ‰| �  ||||fi |¤Ž y )NzMetric `zf` requires that `torchvision` is installed. Please install with `pip install torchmetrics[detection]`.)r   ÚModuleNotFoundErrorr   ÚupperÚsuperÚ__init__)Úselfr   r   r   r   r   Ú	__class__s         €úp/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/torchmetrics/detection/ciou.pyr!   z&CompleteIntersectionOverUnion.__init__j   sQ   ø€ õ &Ü%Ø˜4Ÿ>™>×/Ñ/Ó1Ð2ð 3Nð Nóð ô 	‰Ñ˜ ]°MÀ>Ñ\ÐU[Ó\ó    Úargsc                  ó   — t        | i |¤ŽS ©N)r
   ©r&   r   s     r$   Ú_iou_update_fnz,CompleteIntersectionOverUnion._iou_update_fny   s   € ä˜TÐ, VÑ,Ð,r%   c                  ó   — t        | i |¤ŽS r(   )r	   r)   s     r$   Ú_iou_compute_fnz-CompleteIntersectionOverUnion._iou_compute_fn}   s   € ä˜dÐ- fÑ-Ð-r%   ÚvalÚaxc                 ó&   — | j                  ||«      S )az	  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 object and Axes object

        Raises:
            ModuleNotFoundError:
                If `matplotlib` is not installed

        .. plot::
            :scale: 75

            >>> # Example plotting single value
            >>> import torch
            >>> from torchmetrics.detection import CompleteIntersectionOverUnion
            >>> preds = [
            ...    {
            ...        "boxes": torch.tensor([[296.55, 93.96, 314.97, 152.79], [298.55, 98.96, 314.97, 151.79]]),
            ...        "scores": torch.tensor([0.236, 0.56]),
            ...        "labels": torch.tensor([4, 5]),
            ...    }
            ... ]
            >>> target = [
            ...    {
            ...        "boxes": torch.tensor([[300.00, 100.00, 315.00, 150.00]]),
            ...        "labels": torch.tensor([5]),
            ...    }
            ... ]
            >>> metric = CompleteIntersectionOverUnion()
            >>> metric.update(preds, target)
            >>> fig_, ax_ = metric.plot()

        .. plot::
            :scale: 75

            >>> # Example plotting multiple values
            >>> import torch
            >>> from torchmetrics.detection import CompleteIntersectionOverUnion
            >>> preds = [
            ...    {
            ...        "boxes": torch.tensor([[296.55, 93.96, 314.97, 152.79], [298.55, 98.96, 314.97, 151.79]]),
            ...        "scores": torch.tensor([0.236, 0.56]),
            ...        "labels": torch.tensor([4, 5]),
            ...    }
            ... ]
            >>> target = lambda : [
            ...    {
            ...        "boxes": torch.tensor([[300.00, 100.00, 315.00, 150.00]]) + torch.randint(-10, 10, (1, 4)),
            ...        "labels": torch.tensor([5]),
            ...    }
            ... ]
            >>> metric = CompleteIntersectionOverUnion()
            >>> vals = []
            >>> for _ in range(20):
            ...     vals.append(metric(preds, target()))
            >>> fig_, ax_ = metric.plot(vals)

        )Ú_plot)r"   r-   r.   s      r$   Úplotz"CompleteIntersectionOverUnion.plot�   s   € ðD �z‰z˜#˜rÓ"Ð"r%   )ÚxyxyNFT)NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚboolÚ__annotations__r   r   r   r   Ústrr   Úfloatr   r!   Ústaticmethodr   r*   r,   r   r   r   r   r1   Ú__classcell__)r#   s   @r$   r   r      s1  ø… ñBðH $Ð�tÓ#Ø'+Ð�h˜t‘nÓ+Ø"Ð�tÓ"à€IˆsÓØ€L�%Óð !Ø)-Ø#Ø#ñ]àð]ð   ‘ð]ð ð	]ð
 ð]ð ð]ð 
õ]ð ð-˜cð -¨Sð -°Vò -ó ð-ð ð.˜sð .¨cð .°fò .ó ð.ð _cñB#Ø˜E &¨(°6Ñ*:Ð":Ñ;Ñ<ðB#ØIQÐRZÑI[ðB#à	÷B#r%   N)Úcollections.abcr   Útypingr   r   r   Útorchr   Útorchmetrics.detection.iour   Ú&torchmetrics.functional.detection.ciour	   r
   Útorchmetrics.utilities.importsr   r   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   © r%   r$   Ú<module>rF      sI   ðõ %ß 'Ñ 'å å <ß Nß Xß @áØ7Ð9]Ð^ÑÙ	Ø<Ð=Ðôe#Ð$9õ e#r%   