Ë
    ÛÓ^j�@  ã                   óN  — d dl mZmZ ddlmZ ddlmZmZ ddlm	Z	m
Z
mZmZ ddlmZmZmZ ddlmZmZ  e«       rd dlZ G d	„ d
e
d¬«      ZdZ ed«      D � cg c]	  } d| d›d�‘Œ c}  ed«      D � cg c]	  } d| d›d�‘Œ c} z   Zd„ Ze G d„ de«      «       ZdgZyc c} w c c} w )é    )ÚOptionalÚUnioné   )ÚBatchFeature)Ú
ImageInputÚmake_flat_list_of_images)ÚMultiModalDataÚProcessingKwargsÚProcessorMixinÚUnpack)Ú
AddedTokenÚPreTokenizedInputÚ	TextInput)Úauto_docstringÚis_torch_availableNc                   ó&   — e Zd ZddidddœddidœZy	)
ÚColPaliProcessorKwargsÚpaddingÚlongestÚchannels_firstT)Údata_formatÚdo_convert_rgbÚreturn_tensorsÚpt)Útext_kwargsÚimages_kwargsÚcommon_kwargsN)Ú__name__Ú
__module__Ú__qualname__Ú	_defaults© ó    úy/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/transformers/models/colpali/processing_colpali.pyr   r   #   s,   „ ð �yð
ð ,Ø"ñ
ð +¨DÐ1ñ	�Ir#   r   F)Útotalz<image>i   z<locz0>4ú>é€   z<segz0>3c                 ó    — ||z  |z  › |› | › d�S )aZ  
    Builds a string from the input prompt and image tokens.
    For example, for the call:
    build_string_from_input(
        prompt="Prefix str"
        bos_token="<s>",
        image_seq_len=3,
        image_token="<im>",
    )
    The output will be:
    "<im><im><im><s>Initial str"
    Args:
        prompt (`list[Union[str, ImageInput]]`): The input prompt.
        bos_token (`str`): The beginning of sentence token.
        image_seq_len (`int`): The length of the image sequence.
        image_token (`str`): The image token.
        num_images (`int`): Number of images in the prompt.
    ú
r"   ©ÚpromptÚ	bos_tokenÚimage_seq_lenÚimage_tokenÚ
num_imagess        r$   Úbuild_string_from_inputr0   4   s$   € ð& ˜MÑ)¨JÑ6Ð7¸	°{À6À(È"ÐMÐMr#   c                   óV  ‡ — e Zd Z	 	 	 	 	 ddedefˆ fd„Ze	 	 ddedz  deez  e	e   z  e	e   z  de
e   defd	„«       Zdd
„Zed„ «       Zedefd„«       Z	 ddedz  de
e   defd„Zdee	e   z  de
e   defd„Z	 	 	 ddede	d   f   dede	d   f   deded   dedef   ddfd„Zˆ xZS )ÚColPaliProcessorNÚvisual_prompt_prefixÚquery_prefixc                 óÔ  •— || _         || _        t        |d«      st        d«      ‚|j                  | _        t        |d«      sNt        t        dd¬«      }d|gi}|j                  |«       |j                  t        «      | _	        t        | _
        n"|j                  | _	        |j                  | _
        |j                  t        «       d|_        d|_        t        ‰| �A  |||¬«       y	)
a!  
        visual_prompt_prefix (`str`, *optional*, defaults to `"Describe the image."`):
            A string that gets tokenized and prepended to the image tokens.
        query_prefix (`str`, *optional*, defaults to `"Question: "`):
            A prefix to be used for the query.
        Úimage_seq_lengthz;Image processor is missing an `image_seq_length` attribute.r.   FT)Ú
normalizedÚspecialÚadditional_special_tokens)Úchat_templateN)r3   r4   ÚhasattrÚ
ValueErrorr6   r   ÚIMAGE_TOKENÚadd_special_tokensÚconvert_tokens_to_idsÚimage_token_idr.   Ú
add_tokensÚEXTRA_TOKENSÚadd_bos_tokenÚadd_eos_tokenÚsuperÚ__init__)	ÚselfÚimage_processorÚ	tokenizerr:   r3   r4   r.   Útokens_to_addÚ	__class__s	           €r$   rF   zColPaliProcessor.__init__L   sÕ   ø€ ð %9ˆÔ!Ø(ˆÔÜ�Ð(:Ô;ÜÐZÓ[Ð[à /× @Ñ @ˆÔä�y -Ô0Ü$¤[¸UÈDÔQˆKØ8¸;¸-ÐHˆMØ×(Ñ(¨Ô7Ø"+×"AÑ"AÄ+Ó"NˆDÔÜ*ˆDÕà"+×":Ñ":ˆDÔØ(×4Ñ4ˆDÔà×Ñœ\Ô*Ø"'ˆ	ÔØ"'ˆ	Ôä‰Ñ˜¨)À=ÐÕQr#   ÚimagesÚtextÚkwargsÚreturnc                 ól  —  | j                   t        fd| j                  j                  i|¤Ž}|d   j	                  dd«      }d}|€|€t        d«      ‚|�|�t        d«      ‚|��t| j                  j                  |«      }t        |«      }| j                  gt        |«      z  }|D �cg c]  }| j                  j                  |«      ‘Œ }}t        ||«      D �	�
cg c]R  \  }	}
t        |	| j                  j                  | j                  t         t#        |
t$        «      rt        |
«      nd¬	«      ‘ŒT }}	}
 | j                  |fi |d
   ¤Žd   }|d   j'                  dd«      �|d   dxx   | j                  z  cc<    | j                  |fd|i|d   ¤Ž}i |¥d|i¥}|r.|d   j)                  |d   dk(  d«      }|j+                  d|i«       t-        |¬«      S |�Ît#        |t.        «      r|g}n.t#        |t$        «      rt#        |d   t.        «      st        d«      ‚|€| j0                  dz  }g }|D ]?  }| j                  j                  | j2                  z   |z   |z   dz   }|j5                  |«       ŒA |d   j'                  dd«      |d   d<    | j                  |fd|i|d   ¤Ž}|S yc c}w c c}
}	w )a  
        Returns:
            [`BatchFeature`]: A [`BatchFeature`] with the following fields:

            - **input_ids** -- List of token ids to be fed to a model.
            - **attention_mask** -- List of indices specifying which tokens should be attended to by the model (when
              `return_attention_mask=True` or if *"attention_mask"* is in `self.model_input_names` and if `text` is not
              `None`).
            - **pixel_values** -- Pixel values to be fed to a model. Returned when `images` is not `None`.
        Útokenizer_init_kwargsr   ÚsuffixNTz&Either text or images must be providedz5Only one of text or images can be processed at a timeé   r*   r   Úpixel_valuesÚ
max_lengthÚreturn_token_type_idsÚ	input_idsÚtoken_type_idsr   iœÿÿÿÚlabels)Údataz*Text must be a string or a list of stringsé
   r)   é2   )Ú_merge_kwargsr   rI   Úinit_kwargsÚpopr<   rH   Úfetch_imagesr   r3   ÚlenÚprocess_imageÚzipr0   r,   r6   r=   Ú
isinstanceÚlistÚgetÚmasked_fillÚupdater   ÚstrÚquery_augmentation_tokenr4   Úappend)rG   rL   rM   rN   Úoutput_kwargsrR   rV   Ú	texts_docÚimager+   Ú
image_listÚinput_stringsrT   ÚinputsÚreturn_datarY   Útexts_queryÚqueryÚbatch_querys                      r$   Ú__call__zColPaliProcessor.__call__q   s!  € ð" +˜×*Ñ*Ü"ñ
à"&§.¡.×"<Ñ"<ð
ð ñ
ˆð
 ˜}Ñ-×1Ñ1°(¸DÓAˆà $Ðàˆ<˜F˜NÜÐEÓFÐFØÐ Ð 2ÜÐTÓUÐUàÑØ×)Ñ)×6Ñ6°vÓ>ˆFÜ-¨fÓ5ˆFØ×2Ñ2Ð3´c¸&³kÑAˆIØMSÖTÀE�d×*Ñ*×8Ñ8¸Õ?ÐTˆFÐTô +.¨i¸Ó*@÷	ñ '�F˜Jô (Ø!Ø"Ÿn™n×6Ñ6Ø"&×"7Ñ"7Ü +Ü2<¸ZÌÔ2Nœs :œÐTUöð	ˆMñ 	ð 0˜4×/Ñ/°ÑY¸-ÈÑ:XÑYÐZhÑiˆLð ˜]Ñ+×/Ñ/°¸dÓCÐOØ˜mÑ,¨\Ó:¸d×>SÑ>SÑSÓ:à#�T—^‘^Øñà&;ðð   Ñ.ñˆFð C˜VÐB ^°\ÑBˆKá$Ø Ñ,×8Ñ8¸Ð@PÑ9QÐUVÑ9VÐX\Ó]�Ø×"Ñ" H¨fÐ#5Ô6ä [Ô1Ð1àÐÜ˜$¤Ô$Ø�v‘Ü  ¤tÔ,´¸DÀ¹GÄSÔ1IÜ Ð!MÓNÐNàˆ~Ø×6Ñ6¸Ñ;�à%'ˆKØò *�ØŸ™×0Ñ0°4×3DÑ3DÑDÀuÑLÈvÑUÐX\Ñ\�Ø×"Ñ" 5Õ)ð*ð :GÀ}Ñ9U×9YÑ9YÐZfÐhjÓ9kˆM˜-Ñ(¨Ñ6à(˜$Ÿ.™.Øñà&;ðð   Ñ.ñˆKð Ðð- ùòA Uùó	s   Â)"J+ÃAJ0c                 ó˜   — i }|�<| j                   gt        |«      z  }dgt        |«      z  }|j                  ||dœ«       t        di |¤ŽS )a¸  
        Computes the number of placeholder tokens needed for multimodal inputs with the given sizes.

        Args:
            image_sizes (list[list[str]], *optional*):
                The input sizes formatted as (height, width) per each image.
        Returns:
            `MultiModalData`: A `MultiModalData` object holding number of tokens per each of the provided
            input modalities, along with other useful data.
        rS   )Únum_image_tokensÚnum_image_patchesr"   )r6   ra   rh   r	   )rG   Úimage_sizesrN   Úvision_datarx   ry   s         r$   Ú_get_num_multimodal_tokensz+ColPaliProcessor._get_num_multimodal_tokensÌ   s]   € ð ˆØÐ"Ø $× 5Ñ 5Ð6¼¸[Ó9IÑIÐØ!" ¤c¨+Ó&6Ñ 6ÐØ×ÑÐ4DÐ[lÑmÔnÜÑ, Ñ,Ð,r#   c                 ó€   — | j                   j                  ddgz   }| j                  j                  }t        ||z   «      S )NrX   rY   )rI   Úmodel_input_namesrH   re   )rG   Útokenizer_input_namesÚimage_processor_input_namess      r$   r~   z"ColPaliProcessor.model_input_namesÞ   sB   € à $§¡× @Ñ @ÐDTÐV^ÐC_Ñ _ÐØ&*×&:Ñ&:×&LÑ&LÐ#ÜÐ)Ð,GÑGÓHÐHr#   c                 ó.   — | j                   j                  S )zŠ
        Return the query augmentation token.

        Query augmentation buffers are used as reasoning buffers during inference.
        )rI   Ú	pad_token)rG   s    r$   rj   z)ColPaliProcessor.query_augmentation_tokenä   s   € ð �~‰~×'Ñ'Ð'r#   c                 ó*   —  | j                   dd|i|¤ŽS )a  
        Prepare for the model one or several image(s). This method is a wrapper around the `__call__` method of the ColPaliProcessor's
        [`ColPaliProcessor.__call__`].

        This method forwards the `images` and `kwargs` arguments to the image processor.

        Args:
            images (`PIL.Image.Image`, `np.ndarray`, `torch.Tensor`, `list[PIL.Image.Image]`, `list[np.ndarray]`, `list[torch.Tensor]`):
                The image or batch of images to be prepared. Each image can be a PIL image, NumPy array or PyTorch
                tensor. In case of a NumPy array/PyTorch tensor, each image should be of shape (C, H, W), where C is a
                number of channels, H and W are image height and width.
            return_tensors (`str` or [`~utils.TensorType`], *optional*):
                If set, will return tensors of a particular framework. Acceptable values are:

                - `'pt'`: Return PyTorch `torch.Tensor` objects.
                - `'np'`: Return NumPy `np.ndarray` objects.

        Returns:
            [`BatchFeature`]: A [`BatchFeature`] with the following fields:

            - **input_ids** -- List of token ids to be fed to a model.
            - **attention_mask** -- List of indices specifying which tokens should be attended to by the model (when
              `return_attention_mask=True` or if *"attention_mask"* is in `self.model_input_names` and if `text` is not
              `None`).
            - **pixel_values** -- Pixel values to be fed to a model. Returned when `images` is not `None`.
        rL   r"   ©rv   )rG   rL   rN   s      r$   Úprocess_imageszColPaliProcessor.process_imagesí   s   € ð> ˆt�}‰}Ñ5 FÐ5¨fÑ5Ð5r#   c                 ó*   —  | j                   dd|i|¤ŽS )ag  
        Prepare for the model one or several texts. This method is a wrapper around the `__call__` method of the ColPaliProcessor's
        [`ColPaliProcessor.__call__`].

        This method forwards the `text` and `kwargs` arguments to the tokenizer.

        Args:
            text (`str`, `list[str]`, `list[list[str]]`):
                The sequence or batch of sequences to be encoded. Each sequence can be a string or a list of strings
                (pretokenized string). If the sequences are provided as list of strings (pretokenized), you must set
                `is_split_into_words=True` (to lift the ambiguity with a batch of sequences).
            return_tensors (`str` or [`~utils.TensorType`], *optional*):
                If set, will return tensors of a particular framework. Acceptable values are:

                - `'pt'`: Return PyTorch `torch.Tensor` objects.
                - `'np'`: Return NumPy `np.ndarray` objects.

        Returns:
            [`BatchFeature`]: A [`BatchFeature`] with the following fields:

            - **input_ids** -- List of token ids to be fed to a model.
            - **attention_mask** -- List of indices specifying which tokens should be attended to by the model (when
              `return_attention_mask=True` or if *"attention_mask"* is in `self.model_input_names` and if `text` is not
              `None`).
        rM   r"   r„   )rG   rM   rN   s      r$   Úprocess_queriesz ColPaliProcessor.process_queries  s   € ð< ˆt�}‰}Ñ1 $Ð1¨&Ñ1Ð1r#   Úquery_embeddingsztorch.TensorÚpassage_embeddingsÚ
batch_sizeÚoutput_dtypeztorch.dtypeÚoutput_deviceztorch.devicec           	      óà  — t        |«      dk(  rt        d«      ‚t        |«      dk(  rt        d«      ‚|d   j                  |d   j                  k7  rt        d«      ‚|d   j                  |d   j                  k7  rt        d«      ‚|€|d   j                  }g }t	        dt        |«      |«      D �]%  }g }t
        j                  j                  j                  j                  ||||z    dd¬«      }	t	        dt        |«      |«      D ]‡  }
t
        j                  j                  j                  j                  ||
|
|z    dd¬«      }|j                  t        j                  d|	|«      j                  d	¬
«      d   j                  d¬
«      «       Œ‰ |j                  t        j                  |d¬
«      j                  |«      j                  |«      «       �Œ( t        j                  |d¬
«      S )aZ  
        Compute the late-interaction/MaxSim score (ColBERT-like) for the given multi-vector
        query embeddings (`qs`) and passage embeddings (`ps`). For ColPali, a passage is the
        image of a document page.

        Because the embedding tensors are multi-vector and can thus have different shapes, they
        should be fed as:
        (1) a list of tensors, where the i-th tensor is of shape (sequence_length_i, embedding_dim)
        (2) a single tensor of shape (n_passages, max_sequence_length, embedding_dim) -> usually
            obtained by padding the list of tensors.

        Args:
            query_embeddings (`Union[torch.Tensor, list[torch.Tensor]`): Query embeddings.
            passage_embeddings (`Union[torch.Tensor, list[torch.Tensor]`): Passage embeddings.
            batch_size (`int`, *optional*, defaults to 128): Batch size for computing scores.
            output_dtype (`torch.dtype`, *optional*, defaults to `torch.float32`): The dtype of the output tensor.
                If `None`, the dtype of the input embeddings is used.
            output_device (`torch.device` or `str`, *optional*, defaults to "cpu"): The device of the output tensor.

        Returns:
            `torch.Tensor`: A tensor of shape `(n_queries, n_passages)` containing the scores. The score
            tensor is saved on the "cpu" device.
        r   zNo queries providedzNo passages providedz/Queries and passages must be on the same devicez-Queries and passages must have the same dtypeT)Úbatch_firstÚpadding_valuezbnd,csd->bcnsr   )Údimé   rS   )ra   r<   ÚdeviceÚdtypeÚrangeÚtorchÚnnÚutilsÚrnnÚpad_sequencerk   ÚeinsumÚmaxÚsumÚcatÚto)rG   rˆ   r‰   rŠ   r‹   rŒ   ÚscoresÚiÚbatch_scoresÚbatch_queriesÚjÚbatch_passagess               r$   Úscore_retrievalz ColPaliProcessor.score_retrieval.  sâ  € ô@ ÐÓ  AÒ%ÜÐ2Ó3Ð3ÜÐ!Ó" aÒ'ÜÐ3Ó4Ð4à˜AÑ×%Ñ%Ð);¸AÑ)>×)EÑ)EÒEÜÐNÓOÐOà˜AÑ×$Ñ$Ð(:¸1Ñ(=×(CÑ(CÒCÜÐLÓMÐMàÐØ+¨AÑ.×4Ñ4ˆLà%'ˆä�qœ#Ð.Ó/°Ó<ó 	]ˆAØ/1ˆLÜ!ŸH™HŸN™N×.Ñ.×;Ñ;Ø   Q¨¡^Ð4À$ÐVWð <ó ˆMô ˜1œcÐ"4Ó5°zÓBò �Ü!&§¡§¡×!3Ñ!3×!@Ñ!@Ø& q¨1¨z©>Ð:ÈÐ\]ð "Aó "�ð ×#Ñ#Ü—L‘L °-ÀÓP×TÑTÐYZÐTÓ[Ð\]Ñ^×bÑbÐghÐbÓiõð	ð �M‰Mœ%Ÿ)™) L°aÔ8×;Ñ;¸LÓI×LÑLÈ]Ó[Ö\ð	]ô �y‰y˜ QÔ'Ð'r#   )NNNzDescribe the image.z
Question: )NN)N)r'   NÚcpu)r   r   r    ri   rF   r   r   r   r   re   r   r   r   rv   r|   Úpropertyr~   rj   r…   r‡   r   Úintr   r¥   Ú__classcell__)rK   s   @r$   r2   r2   J   s¯  ø„ ð ØØØ$9Ø(ñ#Rð
 "ð#Rð õ#RðJ ð %)ØZ^ñXà˜TÑ!ðXð Ð+Ñ+¨d°9©oÑ=ÀÐEVÑ@WÑWðXð Ð/Ñ0ð	Xð
 
òXó ðXót-ð$ ñIó ðIð
 ð(¨#ò (ó ð(ð %)ñ6à˜TÑ!ð6ð Ð/Ñ0ð6ð 
ó	6ðB2à˜$˜y™/Ñ)ð2ð Ð/Ñ0ð2ð 
ó	2ðH Ø04Ø49ñ>(à °°^Ñ0DÐ DÑEð>(ð " .°$°~Ñ2FÐ"FÑGð>(ð ð	>(ð
 ˜}Ñ-ð>(ð ˜^¨SÐ0Ñ1ð>(ð 
÷>(r#   r2   )Útypingr   r   Úfeature_extraction_utilsr   Úimage_utilsr   r   Úprocessing_utilsr	   r
   r   r   Útokenization_utils_baser   r   r   r—   r   r   r•   r   r=   r”   rB   r0   r2   Ú__all__)r    s   0r$   ú<module>r°      s·   ð÷, #å 4ß ?ß XÓ Xß OÑ Oß 7ñ ÔÛô
Ð-°Uõ 
ð €Ù).¨t«Ö5 A�$�q˜�g˜Q’Ò5ÑRWÐX[ÓR\Ö8]ÈQ¸4ÀÀ#¸wÀaºÒ8]Ñ]€òNð, ôa(�~ó a(ó ða(ðH	 Ð
�ùò}	 6ùÒ8]s   ÁBÁ3B"