fTh<SrSSKJrJrJr SSKJr SSKJrJ r J r SSK J r J r JrJrJrJr SSKJrJrJr SSKJr \R0"\5rS r\"S 5Vs/sH nS US S 3PM sn\"S5Vs/sH nSUSS 3PM sn-r"SS\5r"SS\ 5r"SS\ SS9r S\!4Sjr"Sr#Sr$Sr%"SS\5r&S/r'g s snfs snf)!z Processor class for PaliGemma. )ListOptionalUnion) BatchFeature) ImageInputis_valid_imagemake_flat_list_of_images) ImagesKwargsProcessingKwargsProcessorMixin TextKwargsUnpack!_validate_images_text_input_order) AddedTokenPreTokenizedInput TextInput)loggingziz4>z3c@\rSrSr%\\\\\\\\4\ S'Sr g)PaliGemmaTextKwargs-suffixN) __name__ __module__ __qualname____firstlineno__rrrrr__annotations____static_attributes__rj/var/www/auris/envauris/lib/python3.13/site-packages/transformers/models/paligemma/processing_paligemma.pyrr-s& U9&7i$O`Jaab ccr"rc&\rSrSr%\\\S'Srg)PaliGemmaImagesKwargs1do_convert_rgbrN)rrrrrboolr r!rr"r#r%r%1s TN"r"r%c<\rSrSr%\\S'\\S'SS0SS0S.rS rg ) PaliGemmaProcessorKwargs5 text_kwargs images_kwargspaddingF data_formatchannels_first)r,r-rN) rrrrrr r% _defaultsr!rr"r#r*r*5s.$$(( u  + Ir"r*F)totalreturncR[U[5=(a URS5$)Nhttp) isinstancestr startswith)vals r#is_urlr:Cs c3  :CNN6$::r"c<[U5=(d [U5$N)r:r elems r#is_image_or_image_urlr?Hs $< />$//r"cF[U[5=(d [U5$r<)r6r7r?r=s r#_is_str_or_imagerALs dS " A&;D&AAr"cX2-U-UUS3$)a Builds a string from the input prompt and image tokens. For example, for the call: build_string_from_input( prompt="Prefix str" bos_token="", image_seq_len=3, image_token="", ) The output will be: "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.  rprompt bos_token image_seq_len image_token num_imagess r#build_string_from_inputrJPs"&)J6 7 {6(" MMr"c ^\rSrSrSrSS/rS/rSrSrSU4Sjjr SS \ S \ \ \ \\ \\ 4S \\S \4S jjrSrSr\S5rSrU=r$)PaliGemmaProcessorfa Constructs a PaliGemma processor which wraps a PaliGemma image processor and a PaliGemma tokenizer into a single processor. [`PaliGemmaProcessor`] offers all the functionalities of [`SiglipImageProcessor`] and [`GemmaTokenizerFast`]. See the [`~PaliGemmaProcessor.__call__`] and [`~PaliGemmaProcessor.decode`] for more information. Args: image_processor ([`SiglipImageProcessor`], *optional*): The image processor is a required input. tokenizer ([`GemmaTokenizerFast`], *optional*): The tokenizer is a required input. chat_template (`str`, *optional*): A Jinja template which will be used to convert lists of messages in a chat into a tokenizable string. image_processor tokenizer chat_template)SiglipImageProcessorSiglipImageProcessorFast)GemmaTokenizerGemmaTokenizerFastc >Uc [S5eUc [S5e[US5(d [S5eURUl[US5(dK[[SSS9nS U/0nUR U5 UR [5Ul[UlO"URUlURUlUR[5 SUl SUl [TU]9XUS 9 g) Nz)You need to specify an `image_processor`.z"You need to specify a `tokenizer`.image_seq_lengthz;Image processor is missing an `image_seq_length` attribute.rHFT) normalizedspecialadditional_special_tokens)rP) ValueErrorhasattrrVr IMAGE_TOKENadd_special_tokensconvert_tokens_to_idsimage_token_idrH add_tokens EXTRA_TOKENS add_bos_token add_eos_tokensuper__init__)selfrNrOrPkwargsrH tokens_to_add __class__s r#rePaliGemmaProcessor.__init__{s  "HI I  AB B(:;;Z[ [ / @ @y-00$[UDQK8;-HM  ( ( 7"+"A"A+"ND *D "+":":D (44D \*"' "'  =Qr"imagestextrgr3c <[X5upUR"[4SURR0UD6nUSR SS5nUbSOSnUc [ S5eUc[RS5 S n[U5(aU/nO)[U[5(a[US 5(aUGbgUGbc[S U55(Gd[RS 5 [U[5(aQ[U[5(a<[U5[U5:wa$[ S [U5S[U5S35e[!U5(aU//nO[U[["45(a&[!US 5(aUV s/sHo/PM nn OZ[U[["45(a4[US [["45(a[!US S 5(d [ S5e[%X!5V V s/sHTup['U URR(UR*[,[U [5(a [U 5OSS9PMV n n n [/U5nO/n UHnUR1[,[,UR*-5nUR3[,5nUS:waU[[,5-OS nUSUURR(-UUS-nU R5U5 M U Vs/sHoS3PM n nUb[U5(aU/nUb)UVs/sHnUURR6-PM nnUR8"U40USD6SnUSR SS5nUR"W 4UUS.USD6nUR;U US/S9 0UESU0EnU(a.USR=USS :HS5nUR?SU05 [AUUS9$s sn fs sn n fs snfs snf) a Main method to prepare for the model one or several sequences(s) and image(s). This method forwards the `text` and `kwargs` arguments to GemmaTokenizerFast's [`~GemmaTokenizerFast.__call__`] if `text` is not `None` to encode the text. To prepare the image(s), this method forwards the `images` and `kwrags` arguments to SiglipImageProcessor's [`~SiglipImageProcessor.__call__`] if `images` is not `None`. Please refer to the docstring of the above two methods for more information. The usage for PaliGemma fine-tuning preparation is slightly different than usual. suffix passed are suffixes to the prompt in `text`, and will be placed after the prompt. This is because attention is handled differently for the prefix and the suffix. For instance, ```python image = PIL_cow_image prompt = "answer en Where is the cow standing?" suffix = "on the beach" inputs = processor(text=prompt, images=image, suffix=suffix) ``` Here `inputs` will contain the `input_ids` and `token_type_ids` that follow ```python inputs["input_ids"][:, 256:] # tensor([[ 2, 6006, 603, 573, 13910, 9980, 235336, 108, 477, 573, 8318]]) inputs["token_type_ids"][:, 256:] tensor([[0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1]]) ``` Meaning the last three tokens are of "label" ("suffix") type while the other ones are of "prefix" type. 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. 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: - `'tf'`: Return TensorFlow `tf.constant` objects. - `'pt'`: Return PyTorch `torch.Tensor` objects. - `'np'`: Return NumPy `np.ndarray` objects. - `'jax'`: Return JAX `jnp.ndarray` objects. suffix (`str`, `List[str]`, `List[List[str]]`): The suffixes or batch of suffixes to be encoded. Only necessary for finetuning. See https://github.com/google-research/big_vision/blob/main/big_vision/configs/proj/paligemma/README.md for more information. If your prompt is " What is on the image", the suffix corresponds to the expected prediction "a cow sitting on a bench". Returns: [`BatchFeature`]: A [`BatchFeature`] with the following fields: - **input_ids** -- List of token ids to be fed to a model. Returned when `text` is not `None`. If `suffix` is provided, the `input_ids` will also contain the suffix input ids. - **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`. - **labels** -- Labels compatible with training if `suffix` is not None tokenizer_init_kwargsr,rNTFzF`images` are expected as arguments to a `PaliGemmaProcessor` instance.z]You are using PaliGemma without a text prefix. It will perform as a picture-captioning model.rc34# UHn[U;v M g7fr<)r\).0samples r# .PaliGemmaProcessor.__call__..s@4{f,4saLYou are passing both `text` and `images` to `PaliGemmaProcessor`. The processor expects special image tokens in the text, as many tokens as there are images per each text. It is recommended to add `` tokens in the very beginning of your text. For this call, we will infer how many images each text has and add special tokens.z Received z images for zK prompts. Each prompt should be associated with an image or list of images.zAimages must be an image, list of images or list of list of imagesrDrCr- pixel_valuesreturn_tensors) text_pairreturn_token_type_idsimage) modalities input_idstoken_type_idsilabels)data tensor_type)!r _merge_kwargsr*rO init_kwargspoprZlogger warning_oncerAr6listanywarningrlenr tupleziprJrFrVr\r replacerfindappend eos_tokenrN_check_special_mm_tokens masked_fillupdater)rfrkrlaudiovideosrg output_kwargsrrzr{rE image_list input_stringsexpanded_samplesrrexpanded_samplebos_rfind_index bos_indexsfxrwrxinputs return_datars r#__call__PaliGemmaProcessor.__call__s,D9F ** $ "&.."<"<  }-11(DA(.(: >ef f <   o D D ! !6D d # #(8a(A(A    2@4@@@<dD))j.F.F6{c$i/('F }LT LWX "&))%hZFu 66>&QR);T;T39:6%g6F:Fve}55"6!9tUm<<&vay|44$%hii/2$.? !/@*,%"&..":":&*&;&;$/6@T6R6R3z?XY /@ !2&9#% "F&,nn[+PTPePeBe&fO&5&;&;K&HOFUY[F[#k2B BabI' 3dnn6N6NNQ`ajakQll$%++O<#>N N=M682=M N  "26":":XF  @FGcDNN444FG++FUmO6TUVde &}599:JDQ  "7 M*   %%mV %R>>> K(44Vs ~~**D;F;;r"c:URR"U0UD6$)z This method forwards all its arguments to GemmaTokenizerFast's [`~PreTrainedTokenizer.decode`]. Please refer to the docstring of this method for more information. )rOdecoders r#rPaliGemmaProcessor.decodeFs ~~$$d5f55r"cURRnURRn[[R X-55$r<)rOmodel_input_namesrNrdictfromkeys)rftokenizer_input_namesimage_processor_input_namess r#r$PaliGemmaProcessor.model_input_namesMs>!% @ @&*&:&:&L&L#DMM"7"UVWWr")rVrHr_)NNN)NNNN)rrrr__doc__ attributes valid_kwargsimage_processor_classtokenizer_classrerrrrrrr*rrrrpropertyrr! __classcell__)ris@r#rLrLfs $[1J#$LP>O RD"^b `J`JI0$y/4HYCZZ[`J 12 `J `JF<6XXr"rLN)(rtypingrrrfeature_extraction_utilsr image_utilsrr r processing_utilsr r r rrrtokenization_utils_baserrrutilsr get_loggerrrr\rangerarr%r*r(r:r?rArJrL__all__)is0r#rs)(4OO    H % ).t5A$qgQ5RWX[R\8]R\Q4#waR\8]] d*d#L# /u ;4; 0BN,lXlX^ W 68]s C 8C