Ë
    ýÿæiü  ã                   ó˜   — d dl mZ d dlmZmZmZ d dlZd dlmZmZ d dl	m
Z
 d dlmZmZmZ d dlmZ d dlmZmZ esd	gZ G d
„ de
«      Zy)é    )ÚSequence)ÚAnyÚOptionalÚUnionN)ÚTensorÚtensor)ÚMetric)Ú_bleu_score_computeÚ_bleu_score_updateÚ_tokenize_fn)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEzBLEUScore.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
<   eed<   eed<   eed<   eed<   	 	 	 ddededeee
      deddf
ˆ fd„Zdee   dee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 )Ú	BLEUScoreaè  Calculate `BLEU score`_ of machine translated text with one or more references.

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

    - ``preds`` (:class:`~Sequence`): An iterable of machine translated corpus
    - ``target`` (:class:`~Sequence`): An iterable of iterables of reference corpus

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

    - ``bleu`` (:class:`~torch.Tensor`): A tensor with the BLEU Score

    Args:
        n_gram: Gram value ranged from 1 to 4
        smooth: Whether or not to apply smoothing, see `Machine Translation Evolution`_
        kwargs: Additional keyword arguments, see :ref:`Metric kwargs` for more info.
        weights:
            Weights used for unigrams, bigrams, etc. to calculate BLEU score.
            If not provided, uniform weights are used.

    Raises:
        ValueError: If a length of a list of weights is not ``None`` and not equal to ``n_gram``.

    Example:
        >>> from torchmetrics.text import BLEUScore
        >>> preds = ['the cat is on the mat']
        >>> target = [['there is a cat on the mat', 'a cat is on the mat']]
        >>> bleu = BLEUScore()
        >>> bleu(preds, target)
        tensor(0.7598)

    FÚis_differentiableTÚhigher_is_betterÚfull_state_updateç        Úplot_lower_boundç      ð?Úplot_upper_boundÚ	preds_lenÚ
target_lenÚ	numeratorÚdenominatorNÚn_gramÚsmoothÚweightsÚkwargsÚreturnc                 óð  •— t        ‰| �  di |¤Ž || _        || _        |�(t	        |«      |k7  rt        dt	        |«      › d|› �«      ‚|�|nd|z  g|z  | _        | j                  dt        d«      d¬«       | j                  dt        d«      d¬«       | j                  d	t        j                  | j                  «      d¬«       | j                  d
t        j                  | j                  «      d¬«       y )Nz5List of weights has different weights than `n_gram`: z != r   r   r   Úsum)Údist_reduce_fxr   r   r   © )ÚsuperÚ__init__r   r   ÚlenÚ
ValueErrorr   Ú	add_stater   ÚtorchÚzeros)Úselfr   r   r   r    Ú	__class__s        €úk/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/torchmetrics/text/bleu.pyr'   zBLEUScore.__init__N   sÛ   ø€ ô 	‰ÑÑ"˜6Ò"ØˆŒØˆŒØÐ¤3 w£<°6Ò#9ÜÐTÔUXÐY`ÓUaÐTbÐbfÐgmÐfnÐoÓpÐpØ")Ð"5‘w¸CÀ&¹L¸>ÈFÑ;RˆŒà�‰�{¤F¨3£KÀˆÔFØ�‰�|¤V¨C£[ÀˆÔGØ�‰�{¤E§K¡K°·±Ó$<ÈUˆÔSØ�‰�}¤e§k¡k°$·+±+Ó&>ÈuˆÕUó    ÚpredsÚtargetc           
      ó®   — t        ||| j                  | j                  | j                  | j                  | j
                  t        «      \  | _        | _        y)z*Update state with predictions and targets.N)r   r   r   r   r   r   r   )r-   r1   r2   s      r/   ÚupdatezBLEUScore.updatea   sC   € ä*<ØØØ�N‰NØ×ÑØ�N‰NØ�O‰OØ�K‰KÜó	+
Ñ'ˆŒ˜�r0   c           	      ó°   — t        | j                  | j                  | j                  | j                  | j
                  | j                  | j                  «      S )zCalculate BLEU score.)r
   r   r   r   r   r   r   r   )r-   s    r/   ÚcomputezBLEUScore.computen   sB   € ä"Ø�N‰N˜DŸO™O¨T¯^©^¸T×=MÑ=MÈtÏ{É{Ð\`×\hÑ\hÐjn×juÑjuó
ð 	
r0   ÚvalÚaxc                 ó&   — | j                  ||«      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
            >>> from torchmetrics.text import BLEUScore
            >>> metric = BLEUScore()
            >>> preds = ['the cat is on the mat']
            >>> target = [['there is a cat on the mat', 'a cat is on the mat']]
            >>> metric.update(preds, target)
            >>> fig_, ax_ = metric.plot()

        .. plot::
            :scale: 75

            >>> # Example plotting multiple values
            >>> from torchmetrics.text import BLEUScore
            >>> metric = BLEUScore()
            >>> preds = ['the cat is on the mat']
            >>> target = [['there is a cat on the mat', 'a cat is on the mat']]
            >>> values = [ ]
            >>> for _ in range(10):
            ...     values.append(metric(preds, target))
            >>> fig_, ax_ = metric.plot(values)

        )Ú_plot)r-   r7   r8   s      r/   ÚplotzBLEUScore.plott   s   € ðT �z‰z˜#˜rÓ"Ð"r0   )é   FN)NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚboolÚ__annotations__r   r   r   Úfloatr   r   Úintr   r   r   r'   Ústrr4   r6   r   r   r   r;   Ú__classcell__)r.   s   @r/   r   r   "   s  ø… ñð@ $Ð�tÓ#Ø!Ð�dÓ!Ø"Ð�tÓ"Ø!Ð�eÓ!Ø!Ð�eÓ!àÓØÓØÓØÓð ØØ-1ñ	VàðVð ðVð ˜( 5™/Ñ*ð	Vð
 ðVð 
õVð&
˜H S™Mð 
°8¸HÀS¹MÑ3Jð 
Ètó 
ð
˜ó 
ð _cñ*#Ø˜E &¨(°6Ñ*:Ð":Ñ;Ñ<ð*#ØIQÐRZÑI[ð*#à	÷*#r0   r   )Úcollections.abcr   Útypingr   r   r   r+   r   r   Útorchmetricsr	   Ú!torchmetrics.functional.text.bleur
   r   r   Útorchmetrics.utilities.importsr   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   r%   r0   r/   Ú<module>rN      s?   ðõ& %ß 'Ñ 'ã ß  å ß cÑ cÝ @ß @áØ(Ð)Ðô|#�õ |#r0   