Ë
    ýÿæi²  ã                   óœ   — d dl mZ d dlmZmZmZ d dlZd dlmZ d dlm	Z	 d dl
mZmZ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)ÚMetric)Ú
PREDS_TYPEÚTARGETS_TYPEÚ_squad_computeÚ_squad_input_checkÚ_squad_update)Ú_MATPLOTLIB_AVAILABLE)Ú_AX_TYPEÚ_PLOT_OUT_TYPEz
SQuAD.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<   deddfˆ fd„Zdededdfd„Zdeeef   fd„Z	 ddeeeee   f      dee   defd„Zˆ xZS )ÚSQuADaÆ  Calculate `SQuAD Metric`_ which is a metric for evaluating question answering models.

    This metric corresponds to the scoring script for version 1 of the Stanford Question Answering Dataset (SQuAD).

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

    -  ``preds`` (:class:`~Dict`): A Dictionary or List of Dictionary-s that map ``id`` and ``prediction_text`` to
       the respective values

       Example ``prediction``:

                .. code-block:: python

                    {"prediction_text": "TorchMetrics is awesome", "id": "123"}


    - ``target`` (:class:`~Dict`): A Dictionary or List of Dictionary-s that contain the ``answers`` and ``id`` in
      the SQuAD Format.

        Example ``target``:

        .. code-block:: python

            {
                'answers': [{'answer_start': [1], 'text': ['This is a test answer']}],
                'id': '1',
            }

        Reference SQuAD Format:

        .. code-block:: python

            {
                'answers': {'answer_start': [1], 'text': ['This is a test text']},
                'context': 'This is a test context.',
                'id': '1',
                'question': 'Is this a test?',
                'title': 'train test'
            }

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

    -  ``squad`` (:class:`~Dict`): A dictionary containing the F1 score (key: "f1"),
        and Exact match score (key: "exact_match") for the batch.

    Args:
        kwargs: Additional keyword arguments, see :ref:`Metric kwargs` for more info.

    Example:
        >>> from torchmetrics.text import SQuAD
        >>> preds = [{"prediction_text": "1976", "id": "56e10a3be3433e1400422b22"}]
        >>> target = [{"answers": {"answer_start": [97], "text": ["1976"]}, "id": "56e10a3be3433e1400422b22"}]
        >>> squad = SQuAD()
        >>> squad(preds, target)
        {'exact_match': tensor(100.), 'f1': tensor(100.)}

    FÚis_differentiableTÚhigher_is_betterÚfull_state_updateg        Úplot_lower_boundg      Y@Úplot_upper_boundÚf1_scoreÚexact_matchÚtotalÚkwargsÚreturnNc                 ón  •— t        ‰| �  di |¤Ž | j                  dt        j                  dt        j
                  ¬«      d¬«       | j                  dt        j                  dt        j
                  ¬«      d¬«       | j                  dt        j                  dt        j                  ¬«      d¬«       y )	Nr   r   )ÚdtypeÚsum)ÚnameÚdefaultÚdist_reduce_fxr   r   © )ÚsuperÚ__init__Ú	add_stateÚtorchÚtensorÚfloatÚint)Úselfr   Ú	__class__s     €úl/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/torchmetrics/text/squad.pyr%   zSQuAD.__init__h   s{   ø€ ô 	‰ÑÑ"˜6Ò"à�‰˜J´·±¸QÄeÇkÁkÔ0RÐchˆÔiØ�‰˜M´5·<±<ÀÌÏÉÔ3UÐfkˆÔlØ�‰˜G¬U¯\©\¸!Ä5Ç9Á9Ô-MÐ^cˆÕdó    ÚpredsÚtargetc                 óÀ   — t        ||«      \  }}t        ||«      \  }}}| xj                  |z  c_        | xj                  |z  c_        | xj                  |z  c_        y)z*Update state with predictions and targets.N)r   r   r   r   r   )r+   r/   r0   Ú
preds_dictÚtarget_dictr   r   r   s           r-   ÚupdatezSQuAD.updater   sS   € ä"4°U¸FÓ"CÑˆ
�KÜ'4°ZÀÓ'MÑ$ˆ�+˜uØ�Š˜Ñ!�Ø×Ò˜KÑ'ÕØ�
Š
�eÑŽ
r.   c                 óX   — t        | j                  | j                  | j                  «      S )z5Aggregate the F1 Score and Exact match for the batch.)r   r   r   r   )r+   s    r-   ÚcomputezSQuAD.computez   s   € ä˜dŸm™m¨T×-=Ñ-=¸t¿z¹zÓJÐJr.   Ú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 SQuAD
            >>> metric = SQuAD()
            >>> preds = [{"prediction_text": "1976", "id": "56e10a3be3433e1400422b22"}]
            >>> target = [{"answers": {"answer_start": [97], "text": ["1976"]}, "id": "56e10a3be3433e1400422b22"}]
            >>> metric.update(preds, target)
            >>> fig_, ax_ = metric.plot()

        .. plot::
            :scale: 75

            >>> # Example plotting multiple values
            >>> from torchmetrics.text import SQuAD
            >>> metric = SQuAD()
            >>> preds = [{"prediction_text": "1976", "id": "56e10a3be3433e1400422b22"}]
            >>> target = [{"answers": {"answer_start": [97], "text": ["1976"]}, "id": "56e10a3be3433e1400422b22"}]
            >>> values = [ ]
            >>> for _ in range(10):
            ...     values.append(metric(preds, target))
            >>> fig_, ax_ = metric.plot(values)

        )Ú_plot)r+   r7   r8   s      r-   Úplotz
SQuAD.plot~   s   € ðT �z‰z˜#˜rÓ"Ð"r.   )NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚboolÚ__annotations__r   r   r   r)   r   r   r   r%   r	   r
   r4   ÚdictÚstrr6   r   r   r   r   r   r;   Ú__classcell__)r,   s   @r-   r   r   #   sÜ   ø… ñ8ðt $Ð�tÓ#Ø!Ð�dÓ!Ø#Ð�tÓ#Ø!Ð�eÓ!Ø#Ð�eÓ#àÓØÓØƒMðeàðeð 
õeð˜Jð °ð Àó ðK˜˜c 6˜kÑ*ó Kð
 _cñ*#Ø˜E &¨(°6Ñ*:Ð":Ñ;Ñ<ð*#ØIQÐRZÑI[ð*#à	÷*#r.   r   )Úcollections.abcr   Útypingr   r   r   r'   r   Útorchmetricsr   Ú"torchmetrics.functional.text.squadr	   r
   r   r   r   Útorchmetrics.utilities.importsr   Útorchmetrics.utilities.plotr   r   Ú__doctest_skip__r   r#   r.   r-   Ú<module>rL      sE   ðõ %ß 'Ñ 'ã Ý å ÷õ õ Aß @áØ$�~ÐôE#ˆFõ E#r.   