qi=2ddlmZmZddlmZmZmZddlmZddl m Z m Z ddl m Z mZddlmZmZddlmZmZerdd lZej,eZGd d e d ZGddeZdgZy ))OptionalUnion) IMAGE_TOKENPaliGemmaProcessorbuild_string_from_input) BatchFeature) ImageInputmake_flat_list_of_images)ProcessingKwargsUnpack)PreTokenizedInput TextInput)is_torch_availableloggingNc&eZdZddidddddidZy ) ColPaliProcessorKwargspaddinglongestchannels_firstT) data_formatdo_convert_rgbreturn_tensorspt) text_kwargs images_kwargs common_kwargsN)__name__ __module__ __qualname__ _defaults]/opt/pipecat/venv/lib/python3.12/site-packages/transformers/models/colpali/modular_colpali.pyrr!s, y ," +D1 Ir#rF)totalc 4eZdZ ddedeffd ZedefdZ ddedzdee ze eze e zd e e de fd Z ddedzd e e de fd Zdee ezd e e de fd Z dd ede dfdede dfdededdedefddf dZxZS)ColPaliProcessorNvisual_prompt_prefix query_prefixcF||_||_t| |||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_processor tokenizer chat_templateN)r(r)super__init__)selfr+r,r-r(r) __class__s r$r/zColPaliProcessor.__init__/s*%9!( I]jkr#returnc.|jjS)z Return the query augmentation token. Query augmentation buffers are used as reasoning buffers during inference. )r, pad_token)r0s r$query_augmentation_tokenz)ColPaliProcessor.query_augmentation_tokenAs~~'''r#imagestextkwargsc X|jtfd|jji|}|dj dd}d}| | t d| | t d|j|j j|}t|}|jgt|z}|Dcgc]}|jd}}t||D cgc]R\} } t| |jj|jt t#| t$r t| nd T} } } |j |fi|d d } |dj'd d|dd xx|jz cc<|j| fd|i|d} i| d | i}|r.| dj)| ddk(d}|j+d|it-|S|t#|t.r|g}n.t#|t$rt#|dt.s t d||j0dz}g}|D]?}|jj|j2z|z|zdz}|j5|A|dj'd d|dd <|j|fd|i|d}|Sycc}wcc} } 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_kwargsrsuffixNTz&Either text or images must be providedz5Only one of text or images can be processed at a timeRGB)prompt bos_token image_seq_len image_token num_imagesr pixel_values max_lengthreturn_token_type_ids input_idstoken_type_idsrilabels)dataz*Text must be a string or a list of strings  2) _merge_kwargsrr, init_kwargspop ValueErrorr+ fetch_imagesr r(lenconvertziprr?image_seq_lengthr isinstancelistget masked_fillupdater strr5r)append)r0r6r7r8 output_kwargsr;rE texts_docimager> image_list input_stringsrCinputs return_datarH texts_queryquery batch_querys r$__call__zColPaliProcessor.__call__Js +** " "&.."<"<  }-11(DA $ F-f5F223c&kAI8>?uemmE*?F?+.i*@ 'FJ(!"nn66"&"7"7 +2S>SS:#T^^&; .F CVB^\BK$ ,88@P9QUV9VX\]""Hf#56[1 1  $$v t,DGS1I !MNN~66;%'K *0043D3DDuLvUX\\""5) *:G}9U9Y9YZfhj9kM- ( 6($..&; .K  -A@ s )J!AJ&c *|jdd|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`. r6r"rg)r0r6r8s r$process_imageszColPaliProcessor.process_imagess>t}}5F5f55r#c *|jdd|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`). r7r"ri)r0r7r8s r$process_queriesz ColPaliProcessor.process_queriess<t}}1$1&11r#query_embeddingsz torch.Tensorpassage_embeddings batch_size output_dtypez torch.dtype output_devicez torch.devicec t|dk(r tdt|dk(r td|dj|djk7r td|dj|djk7r td||dj}g}t dt||D]%}g}t j jjj||||zdd} t dt||D]} t j jjj|| | |zdd} |jt jd| | jd djd |jt 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. rzNo queries providedzNo 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)dimr=)rRrPdevicedtyperangetorchnnutilsrnn pad_sequencer\einsummaxsumcatto) r0rmrnrorprqscoresi batch_scores batch_queriesjbatch_passagess r$score_retrievalz ColPaliProcessor.score_retrievals@  A %23 3 ! "a '34 4 A  % %);A)>)E)E ENO O A  $ $(:1(=(C(C CLM M  +A.44L%'q#./< ]A/1L!HHNN..;; Q^4$VW<M1c"45zB !&!3!3!@!@&q1z>:\]"A"##LL-PTTYZT[\]^bbghbi   MM%))La8;;LILL][ \ ]yyQ''r#)NNNzDescribe the image.z Question: )NN)N)Ncpu)rrr r[r/propertyr5r rrrWr rr rgrjrlrintrr __classcell__)r1s@r$r'r'.s$9( l " l  l$(#((%)Z^XT!X++d9o=EV@WWX/0 X  Xx%)6T!6/06  6B2$y/)2/02  2H0449 >(^0D DE>(".$~2F"FG>( >( }- >( ^S01 >( >(r#r')typingrr2transformers.models.paligemma.processing_paligemmarrrfeature_extraction_utilsr image_utilsr r processing_utilsr r tokenization_utils_baserrr|rrrz get_loggerrloggerrr'__all__r"r#r$rsg #ww4?8C0   H % -U u()u(r r#