o
    ªôjü  ã                   @   s’   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„ de
ƒZdS )é    )ÚSequence)ÚAnyÚOptionalÚUnionN)ÚTensorÚtensor)ÚMetric)Ú_bleu_score_computeÚ_bleu_score_updateÚ_tokenize_fn)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEúBLEUScore.plotc                       s  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d„Zdee deee  ddfdd„Zdefdd„Z	d#deeeee f  dee defd d!„Z‡  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Údenominatoré   NÚn_gramÚsmoothÚweightsÚkwargsÚreturnc                    sÂ   t ƒ jdi |¤Ž || _|| _|d ur%t|ƒ|kr%tdt|ƒ› d|› �ƒ‚|d ur+|nd| g| | _| jdtdƒdd� | jdtdƒdd� | jd	t	 
| j¡dd� | jd
t	 
| j¡dd� d S )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__r$   úi/var/www/html/academy/tools/voices/clone/cosy-venv/lib/python3.10/site-packages/torchmetrics/text/bleu.pyr&   N   s   zBLEUScore.__init__ÚpredsÚtargetc              	   C   s,   t ||| j| j| j| j| jtƒ\| _| _dS )z*Update state with predictions and targets.N)r
   r   r   r   r   r   r   )r,   r0   r1   r$   r$   r/   Úupdatea   s   øzBLEUScore.updatec                 C   s"   t | j| j| j| j| j| j| jƒS )zCalculate BLEU score.)r	   r   r   r   r   r   r   r   )r,   r$   r$   r/   Úcomputen   s   ÿzBLEUScore.computeÚvalÚaxc                 C   s   |   ||¡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,   r4   r5   r$   r$   r/   Úplott   s   *r   )r   FN)NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚboolÚ__annotations__r   r   r   Úfloatr   r   Úintr   r   r   r&   Ústrr2   r3   r   r   r   r7   Ú__classcell__r$   r$   r-   r/   r   "   sF   
  üþý
üûú"ÿÿÿþ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$   r$   r$   r/   Ú<module>   s   