§
    ’©ºj›  ã                   ó”   — d dl mZ d dlmZmZmZ d dlmZmZ d dl	m
Z
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ÚOptionalÚUnion)ÚTensorÚtensor)Ú_perplexity_computeÚ_perplexity_update)ÚMetric)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEzPerplexity.plotc                   óÞ   ‡ — e Zd ZU dZdZdZdZeed<   eed<   	 dde	e
         deeef         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 )Ú
PerplexityaS  Perplexity measures how well a language model predicts a text sample.

    It's calculated as the average number of bits per word a model needs to represent the sample.

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

    - ``preds`` (:class:`~torch.Tensor`): Logits or a unnormalized score assigned to each token in a sequence with shape
      [batch_size, seq_len, vocab_size], which is the output of a language model. Scores will be normalized internally
      using softmax.
    - ``target`` (:class:`~torch.Tensor`): Ground truth values with a shape [batch_size, seq_len]

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

    - ``perp`` (:class:`~torch.Tensor`): A tensor with the perplexity score

    Args:
        ignore_index: Integer specifying a target class to ignore.
            If given, this class index does not contribute to the returned score.
        kwargs:
            Additional keyword arguments, see :ref:`Metric kwargs` for more info.

    Examples:
        >>> from torch import rand, randint
        >>> from torchmetrics.text import Perplexity
        >>> preds = rand(2, 8, 5)
        >>> target = randint(5, (2, 8))
        >>> target[0, 6:] = -100
        >>> perp = Perplexity(ignore_index=-100)
        >>> perp(preds, target)
        tensor(5.8540)

    TFÚtotal_log_probsÚcountNÚignore_indexÚkwargsÚreturnc                 ó.  •—  t          ¦   «         j        di |¤Ž |�'t          |t          ¦  «        st	          d|› �¦  «        ‚|| _        |                      dt          d¦  «        d¬¦  «         |                      dt          d¦  «        d¬¦  «         d S )NzIArgument `ignore_index` expected to either be `None` or an `int` but got r   g        Úsum)ÚdefaultÚdist_reduce_fxr   © )ÚsuperÚ__init__Ú
isinstanceÚintÚ
ValueErrorr   Ú	add_stater   )Úselfr   r   Ú	__class__s      €úl/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/torchmetrics/text/perplexity.pyr   zPerplexity.__init__E   sš   ø€ ð
 	�‰ŒÔÐ"Ð"˜6Ð"Ð"Ð"ØÐ#­J°|ÅSÑ,IÔ,IÐ#ÝÐwÐiuÐwÐwÑxÔxÐxØ(ˆÔØ�ŠÐ(µ&¸±+´+ÈeˆÑTÔTÐTØ�Š�w­¨s©¬ÀEˆÑJÔJÐJÐJÐJó    ÚpredsÚtargetc                 óx   — t          ||| j        ¦  «        \  }}| xj        |z  c_        | xj        |z  c_        dS )z*Update state with predictions and targets.N)r
   r   r   r   )r!   r%   r&   r   r   s        r#   ÚupdatezPerplexity.updateQ   sC   € å!3°E¸6À4ÔCTÑ!UÔ!UÑˆ˜ØÐÔ Ñ/ÐÔØˆ
Œ
�eÑˆ
Œ
ˆ
ˆ
r$   c                 ó6   — t          | j        | j        ¦  «        S )zCompute the Perplexity.)r	   r   r   )r!   s    r#   ÚcomputezPerplexity.computeW   s   € å" 4Ô#7¸¼ÑDÔDÐDr$   ÚvalÚaxc                 ó.   — |                       ||¦  «        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

            >>> # Example plotting a single value
            >>> import torch
            >>> from torchmetrics.text import Perplexity
            >>> metric = Perplexity()
            >>> metric.update(torch.rand(2, 8, 5), torch.randint(5, (2, 8)))
            >>> fig_, ax_ = metric.plot()

        .. plot::
            :scale: 75

            >>> # Example plotting multiple values
            >>> import torch
            >>> from torchmetrics.text import Perplexity
            >>> metric = Perplexity()
            >>> values = [ ]
            >>> for _ in range(10):
            ...     values.append(metric(torch.rand(2, 8, 5), torch.randint(5, (2, 8))))
            >>> fig_, ax_ = metric.plot(values)

        )Ú_plot)r!   r+   r,   s      r#   ÚplotzPerplexity.plot[   s   € ðP �zŠz˜#˜rÑ"Ô"Ð"r$   )N)NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Úis_differentiableÚhigher_is_betterÚfull_state_updater   Ú__annotations__r   r   ÚdictÚstrr   r   r(   r*   r   r   r   r   r/   Ú__classcell__)r"   s   @r#   r   r      sJ  ø€ € € € € € ðð ðB ÐØÐØÐØÐÐÑØ€M€M�Mð '+ð
Kð 
Kà˜s”mð
Kð �s˜C�x”.ð
Kð 
ð	
Kð 
Kð 
Kð 
Kð 
Kð 
Kð˜Fð ¨Fð °tð ð ð ð ðE˜ð Eð Eð Eð Eð
 _cð(#ð (#Ø˜E &¨(°6Ô*:Ð":Ô;Ô<ð(#ØIQÐRZÔI[ð(#à	ð(#ð (#ð (#ð (#ð (#ð (#ð (#ð (#r$   r   N)Úcollections.abcr   Útypingr   r   r   Útorchr   r   Ú'torchmetrics.functional.text.perplexityr	   r
   Útorchmetrics.metricr   Útorchmetrics.utilities.importsr   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   r   r$   r#   ú<module>rC      sò   ðð %Ð $Ð $Ð $Ð $Ð $Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'à  Ð  Ð  Ð  Ð  Ð  Ð  Ð  à [Ð [Ð [Ð [Ð [Ð [Ð [Ð [Ø &Ð &Ð &Ð &Ð &Ð &Ø @Ð @Ð @Ð @Ð @Ð @Ø @Ð @Ð @Ð @Ð @Ð @Ð @Ð @àð +Ø)Ð*Ððf#ð f#ð f#ð f#ð f#�ñ f#ô f#ð f#ð f#ð f#r$   