§
    ’©ºj  ã                   óœ   — 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 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)Ú_bleu_score_update)Ú_SacreBLEUTokenizerÚ_TokenizersLiteral)Ú	BLEUScore)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEzSacreBLEUScore.plotc                   ó0  ‡ — 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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deeeee         f                  dee         defd„Zˆ xZS )ÚSacreBLEUScorea¤  Calculate `BLEU score`_ of machine translated text with one or more references.

    This implementation follows the behaviour of `SacreBLEU`_. The SacreBLEU implementation differs from the NLTK BLEU
    implementation in tokenization techniques.

    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 ``compute`` the metric returns the following output:

    - ``sacre_bleu`` (:class:`~torch.Tensor`): A tensor with the SacreBLEU Score

    .. note::
        In the original SacreBLEU, references are passed as a list of reference sets (grouped by reference index).
        In TorchMetrics, references are passed grouped per prediction (each prediction has its own list of references).

        For example::

            # Predictions
            preds = ['The dog bit the man.', "It wasn't surprising.", 'The man had just bitten him.']

            # Original SacreBLEU:
            refs = [
                ['The dog bit the man.', 'It was not unexpected.', 'The man bit him first.'], # First set
                ['The dog had bit the man.', 'No one was surprised.', 'The man had bitten the dog.'], # Second set
            ]

            # TorchMetrics SacreBLEU:
            target = [
                ['The dog bit the man.', 'The dog had bit the man.'], # References for first prediction
                ['It was not unexpected.', 'No one was surprised.'], # References for second prediction
                ['The man bit him first.', 'The man had bitten the dog.'], # References for third prediction
            ]

    Args:
        n_gram: Gram value ranged from 1 to 4
        smooth: Whether to apply smoothing, see `SacreBLEU`_
        tokenize: Tokenization technique to be used. Choose between ``'none'``, ``'13a'``, ``'zh'``, ``'intl'``,
            ``'char'``, ``'ja-mecab'``, ``'ko-mecab'``, ``'flores101'`` and ``'flores200'``.
        lowercase:  If ``True``, BLEU score over lowercased text is calculated.
        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 ``tokenize`` not one of 'none', '13a', 'zh', 'intl' or 'char'
        ValueError:
            If ``tokenize`` is set to 'intl' and `regex` is not installed
        ValueError:
            If a length of a list of weights is not ``None`` and not equal to ``n_gram``.


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

    Additional References:

        - Automatic Evaluation of Machine Translation Quality Using Longest Common Subsequence
          and Skip-Bigram Statistics by Chin-Yew Lin and Franz Josef Och `Machine Translation Evolution`_

    FÚis_differentiableTÚhigher_is_betterÚfull_state_updateg        Úplot_lower_boundg      ð?Úplot_upper_boundé   Ú13aNÚn_gramÚsmoothÚtokenizeÚ	lowercaseÚweightsÚkwargsÚreturnc                 ól   •—  t          ¦   «         j        d|||dœ|¤Ž t          ||¦  «        | _        d S )N)r   r   r   © )ÚsuperÚ__init__r	   Ú	tokenizer)Úselfr   r   r   r   r   r   Ú	__class__s          €úl/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/torchmetrics/text/sacre_bleu.pyr"   zSacreBLEUScore.__init__q   s@   ø€ ð 	�‰ŒÔÐQ ¨v¸wÐQÐQÈ&ÐQÐQÐQÝ,¨X°yÑAÔAˆŒˆˆó    ÚpredsÚtargetc           
      óˆ   — t          ||| j        | j        | j        | j        | j        | j        ¦  «        \  | _        | _        dS )z*Update state with predictions and targets.N)r   Ú	numeratorÚdenominatorÚ	preds_lenÚ
target_lenr   r#   )r$   r(   r)   s      r&   ÚupdatezSacreBLEUScore.update}   sC   € å*<ØØØŒNØÔØŒNØŒOØŒKØŒNñ	+
ô 	+
Ñ'ˆŒ˜œ˜˜r'   Ú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
            >>> from torchmetrics.text import SacreBLEUScore
            >>> metric = SacreBLEUScore()
            >>> 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 SacreBLEUScore
            >>> metric = SacreBLEUScore()
            >>> 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$   r0   r1   s      r&   ÚplotzSacreBLEUScore.plotŠ   s   € ðT �zŠz˜#˜rÑ"Ô"Ð"r'   )r   Fr   FN)NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚboolÚ__annotations__r   r   r   Úfloatr   Úintr
   r   r   r   r"   Ústrr/   r   r   r   r   r4   Ú__classcell__)r%   s   @r&   r   r   #   sœ  ø€ € € € € € ðEð EðN $Ð�tÐ#Ð#Ñ#Ø!Ð�dÐ!Ð!Ñ!Ø"Ð�tÐ"Ð"Ñ"Ø!Ð�eÐ!Ð!Ñ!Ø!Ð�eÐ!Ð!Ñ!ð ØØ',ØØ-1ð
Bð 
Bàð
Bð ð
Bð %ð	
Bð
 ð
Bð ˜( 5œ/Ô*ð
Bð ð
Bð 
ð
Bð 
Bð 
Bð 
Bð 
Bð 
Bð
˜H SœMð 
°8¸HÀS¼MÔ3Jð 
Ètð 
ð 
ð 
ð 
ð _cð*#ð *#Ø˜E &¨(°6Ô*:Ð":Ô;Ô<ð*#ØIQÐRZÔI[ð*#à	ð*#ð *#ð *#ð *#ð *#ð *#ð *#ð *#r'   r   N)Úcollections.abcr   Útypingr   r   r   Útorchr   Ú!torchmetrics.functional.text.bleur   Ú'torchmetrics.functional.text.sacre_bleur	   r
   Útorchmetrics.text.bleur   Útorchmetrics.utilities.importsr   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   r    r'   r&   ú<module>rH      sþ   ðð( %Ð $Ð $Ð $Ð $Ð $Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'à Ð Ð Ð Ð Ð à @Ð @Ð @Ð @Ð @Ð @Ø [Ð [Ð [Ð [Ð [Ð [Ð [Ð [Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,Ø @Ð @Ð @Ð @Ð @Ð @Ø @Ð @Ð @Ð @Ð @Ð @Ð @Ð @àð /Ø-Ð.ÐðQ#ð Q#ð Q#ð Q#ð Q#�Yñ Q#ô Q#ð Q#ð Q#ð Q#r'   