
    bCi                        S r SSKJr  SSKJrJrJrJr  SSKrSSKJ	r	  SSK
Jr  SSKJrJr  SS	KJr  SS
KJrJrJr  SSKJrJr  SSKJrJrJrJrJrJr  SSKJ r J!r!J"r"  \RF                  " \$5      r%S\RL                  S\RL                  4S jr'S\RL                  S\RL                  4S jr(S\RL                  S\RL                  4S jr)\\" SS9 " S S\5      5       5       r*\\" SS9 " S S\5      5       5       r+\\ " S S\5      5       5       r, " S S \	RZ                  5      r. " S! S"\	RZ                  5      r/  SJS#\	RZ                  S$\RL                  S%\RL                  S&\RL                  S'\\RL                     S(\0S)\0S*\14S+ jjr2 " S, S-\	RZ                  5      r3 " S. S/\	RZ                  5      r4 " S0 S1\5      r5\ " S2 S3\5      5       r6 " S4 S5\	RZ                  5      r7 " S6 S7\	RZ                  5      r8\" S8S9 " S9 S:\65      5       r9 " S; S<\	RZ                  5      r:\" S=S9 " S> S?\65      5       r;\ " S@ SA\65      5       r<\ " SB SC\65      5       r=\ " SD SE\65      5       r>\" SFS9 " SG SH\65      5       r?/ SIQr@g)KzPyTorch CLIP model.    )	dataclass)AnyCallableOptionalUnionN)nn   )ACT2FN) _create_4d_causal_attention_mask_prepare_4d_attention_mask)GradientCheckpointingLayer)BaseModelOutputBaseModelOutputWithPoolingImageClassifierOutput)ALL_ATTENTION_FUNCTIONSPreTrainedModel)ModelOutputauto_docstringcan_return_tuplefilter_out_non_signature_kwargslogging	torch_int   )
CLIPConfigCLIPTextConfigCLIPVisionConfiglogitsreturnc                     [         R                  R                  U [        R                  " [        U 5      U R                  S95      $ )Ndevice)r   
functionalcross_entropytorcharangelenr!   )r   s    `/home/james-whalen/.local/lib/python3.13/site-packages/transformers/models/clip/modeling_clip.pycontrastive_lossr(   %   s/    ==&&vu||CKPVP]P]/^__    
similarityc                 X    [        U 5      n[        U R                  5       5      nX-   S-  $ )Ng       @)r(   t)r*   caption_loss
image_losss      r'   	clip_lossr/   )   s*    #J/L!*,,.1J%,,r)   tensorc                     [         R                  " U S5      n[         R                  " USSS9n[         R                  " US5      nU$ )z
This method is equivalent to tensor.norm(p=2, dim=-1, keepdim=True) and used to make
model `executorch` exportable. See issue https://github.com/pytorch/executorch/issues/3566
   T)dimkeepdim      ?)r$   powsum)r0   square_tensor
sum_tensornormed_tensors       r'   _get_vector_normr<   /   s<    
 IIfa(M=b$?JIIj#.Mr)   z}
    Base class for vision model's outputs that also contains image embeddings of the pooling of the last hidden states.
    )custom_introc                       \ rS rSr% SrSr\\R                     \	S'   Sr
\\R                     \	S'   Sr\\\R                  S4      \	S'   Sr\\\R                  S4      \	S'   S	rg)
CLIPVisionModelOutput:   z
image_embeds (`torch.FloatTensor` of shape `(batch_size, output_dim)` *optional* returned when model is initialized with `with_projection=True`):
    The image embeddings obtained by applying the projection layer to the pooler_output.
Nimage_embedslast_hidden_state.hidden_states
attentions )__name__
__module____qualname____firstlineno____doc__rA   r   r$   FloatTensor__annotations__rB   rC   tuplerD   __static_attributes__rE   r)   r'   r?   r?   :   sr    
 15L(5,,-459x 1 129=AM8E%"3"3S"89:A:>Ju00#567>r)   r?   ze
    Base class for text model's outputs that also contains a pooling of the last hidden states.
    c                       \ rS rSr% SrSr\\R                     \	S'   Sr
\\R                     \	S'   Sr\\\R                  S4      \	S'   Sr\\\R                  S4      \	S'   S	rg)
CLIPTextModelOutputL   z
text_embeds (`torch.FloatTensor` of shape `(batch_size, output_dim)` *optional* returned when model is initialized with `with_projection=True`):
    The text embeddings obtained by applying the projection layer to the pooler_output.
Ntext_embedsrB   .rC   rD   rE   )rF   rG   rH   rI   rJ   rR   r   r$   rK   rL   rB   rC   rM   rD   rN   rE   r)   r'   rP   rP   L   sr    
 04K%++,359x 1 129=AM8E%"3"3S"89:A:>Ju00#567>r)   rP   c                      \ rS rSr% SrSr\\R                     \	S'   Sr
\\R                     \	S'   Sr\\R                     \	S'   Sr\\R                     \	S'   Sr\\R                     \	S'   Sr\\	S	'   Sr\\	S
'   S\\   4S jrSrg)
CLIPOutput^   ae  
loss (`torch.FloatTensor` of shape `(1,)`, *optional*, returned when `return_loss` is `True`):
    Contrastive loss for image-text similarity.
logits_per_image (`torch.FloatTensor` of shape `(image_batch_size, text_batch_size)`):
    The scaled dot product scores between `image_embeds` and `text_embeds`. This represents the image-text
    similarity scores.
logits_per_text (`torch.FloatTensor` of shape `(text_batch_size, image_batch_size)`):
    The scaled dot product scores between `text_embeds` and `image_embeds`. This represents the text-image
    similarity scores.
text_embeds (`torch.FloatTensor` of shape `(batch_size, output_dim`):
    The text embeddings obtained by applying the projection layer to the pooled output of [`CLIPTextModel`].
image_embeds (`torch.FloatTensor` of shape `(batch_size, output_dim`):
    The image embeddings obtained by applying the projection layer to the pooled output of [`CLIPVisionModel`].
text_model_output (`BaseModelOutputWithPooling`):
    The output of the [`CLIPTextModel`].
vision_model_output (`BaseModelOutputWithPooling`):
    The output of the [`CLIPVisionModel`].
Nlosslogits_per_imagelogits_per_textrR   rA   text_model_outputvision_model_outputr   c                 J   ^  [        U 4S jT R                  5        5       5      $ )Nc              3   n   >#    U  H*  nUS ;  a  TU   O[        TU5      R                  5       v   M,     g7f))rY   rZ   N)getattrto_tuple).0kselfs     r'   	<genexpr>&CLIPOutput.to_tuple.<locals>.<genexpr>}   s<      
   LLDGRYZ^`aRbRkRkRmm s   25)rM   keysra   s   `r'   r^   CLIPOutput.to_tuple|   s#     
YY[
 
 	
r)   rE   )rF   rG   rH   rI   rJ   rV   r   r$   rK   rL   rW   rX   rR   rA   rY   r   rZ   rM   r   r^   rN   rE   r)   r'   rT   rT   ^   s    & )-D(5$$
%,48hu001837OXe//07/3K%++,304L(5,,-448186:3:
%* 
r)   rT   c                      ^  \ rS rSrS\4U 4S jjrS\R                  S\S\S\R                  4S jr	SS	\R                  S\R                  4S
 jjrSrU =r$ )CLIPVisionEmbeddings   configc                   > [         TU ]  5         Xl        UR                  U l        UR
                  U l        UR                  U l        [        R                  " [        R                  " U R                  5      5      U l        [        R                  " UR                  U R                  U R                  U R                  SS9U l        U R
                  U R                  -  S-  U l        U R                  S-   U l        [        R"                  " U R                   U R                  5      U l        U R'                  S[        R(                  " U R                   5      R+                  S5      SS9  g )NF)in_channelsout_channelskernel_sizestridebiasr2   r   position_idsr   r3   
persistent)super__init__rj   hidden_size	embed_dim
image_size
patch_sizer   	Parameterr$   randnclass_embeddingConv2dnum_channelspatch_embeddingnum_patchesnum_positions	Embeddingposition_embeddingregister_bufferr%   expandra   rj   	__class__s     r'   rv   CLIPVisionEmbeddings.__init__   s   ++ ++ ++!||EKK,GH!yy++?? 
 !OOt>1D!--1"$,,t/A/A4>>"R^U\\$:L:L-M-T-TU\-]jopr)   
embeddingsheightwidthr   c                    UR                   S   S-
  nU R                  R                  R                  S5      nUR                   S   S-
  n[        R
                  R                  5       (       d%  XF:X  a   X#:X  a  U R                  U R                  5      $ USS2SS24   nUSS2SS24   nUR                   S   n	X R                  -  n
X0R                  -  n[        US-  5      nUR                  SXU	5      nUR                  SSSS5      n[        R                  R                  UX4SS	S
9nUR                  SSSS5      R                  SSU	5      n[        R                   " Xx4SS9$ )a  
This method allows to interpolate the pre-trained position encodings, to be able to use the model on higher resolution
images. This method is also adapted to support torch.jit tracing.

Adapted from:
- https://github.com/facebookresearch/dino/blob/de9ee3df6cf39fac952ab558447af1fa1365362a/vision_transformer.py#L174-L194, and
- https://github.com/facebookresearch/dinov2/blob/e1277af2ba9496fbadf7aec6eba56e8d882d1e35/dinov2/models/vision_transformer.py#L179-L211
r   r   Nr3   r6   r	   r2   bicubicF)sizemodealign_cornersr4   )shaper   weight	unsqueezer$   jit
is_tracingrq   rz   r   reshapepermuter   r"   interpolateviewcat)ra   r   r   r   r   r   r   class_pos_embedpatch_pos_embedr4   
new_height	new_widthsqrt_num_positionss                r'   interpolate_pos_encoding-CLIPVisionEmbeddings.interpolate_pos_encoding   si    !&&q)A-!44;;EEaH*003a7 yy##%%+*F6?**4+<+<==,QU3,QU3r".
__,	&}c'9:)11!5G]`a)11!Q1=--33(	 4 
 *11!Q1=BB1b#Nyy/;CCr)   pixel_valuesc                 ^   UR                   u  p4pVU(       dJ  XPR                  :w  d  X`R                  :w  a,  [        SU SU SU R                   SU R                   S3	5      eU R                  R                  R
                  nU R                  UR                  US95      nUR                  S5      R                  SS5      nU R                  R                  USS5      n	[        R                  " X/SS	9n
U(       a  XR                  XU5      -   n
U
$ XR                  U R                  5      -   n
U
$ )
NzInput image size (*z) doesn't match model ().)dtyper2   r   r3   r   )r   ry   
ValueErrorr   r   r   toflatten	transposer}   r   r$   r   r   r   rq   )ra   r   r   
batch_size_r   r   target_dtypepatch_embedsclass_embedsr   s              r'   forwardCLIPVisionEmbeddings.forward   s$   '3'9'9$
v'V-F%SbSbJb$VHAeW4KDOOK\\]^b^m^m]nnpq  ++2288++LOO,O,OP#++A.88A>++22:q"EYY;C
##&C&CJX]&^^J  $&=&=d>O>O&PPJr)   )	r}   rj   rx   ry   r   r   r   rz   r   F)rF   rG   rH   rI   r   rv   r$   Tensorintr   rK   r   rN   __classcell__r   s   @r'   rh   rh      sj    q/ q,'D5<< 'D 'DUX 'D]b]i]i 'DRE$5$5 Z_ZfZf  r)   rh   c            	          ^  \ rS rSrS\4U 4S jjr   S
S\\R                     S\\R                     S\\R                     S\R                  4S jjrS	rU =r$ )CLIPTextEmbeddings   rj   c                 N  > [         TU ]  5         UR                  n[        R                  " UR
                  U5      U l        [        R                  " UR                  U5      U l        U R                  S[        R                  " UR                  5      R                  S5      SS9  g )Nrq   rr   Frs   )ru   rv   rw   r   r   
vocab_sizetoken_embeddingmax_position_embeddingsr   r   r$   r%   r   ra   rj   rx   r   s      r'   rv   CLIPTextEmbeddings.__init__   s    &&	!||F,=,=yI"$,,v/M/My"Y 	ELL)G)GHOOPWXej 	 	
r)   	input_idsrq   inputs_embedsr   c                 <   Ub  UR                   S   OUR                   S   nU R                  R                  R                   S   nXE:  a  [        SU SU 35      eUc  U R                  S S 2S U24   nUc  U R                  U5      nU R                  U5      nX6-   nU$ )Nr3   r   zRSequence length must be less than max_position_embeddings (got `sequence length`: z and max_position_embeddings: )r   r   r   r   rq   r   )ra   r   rq   r   
seq_lengthmax_position_embeddingposition_embeddingsr   s           r'   r   CLIPTextEmbeddings.forward   s     -6,AY__R(}GZGZ[]G^
!%!8!8!?!?!E!Ea!H.d,<=S<TV 
 ,,Q^<L  00;M"55lC"8
r)   )r   r   )NNN)rF   rG   rH   rI   r   rv   r   r$   
LongTensorrK   r   r   rN   r   r   s   @r'   r   r      so    

~ 

 153759	E,,- u//0   1 12	
 
 r)   r   modulequerykeyvalueattention_maskscalingdropoutoutput_attentionsc                    [         R                  " XR                  SS5      5      U-  n	Ub  X-   n	[        R                  R                  U	S[         R                  S9R                  UR                  5      n	[        R                  R                  XU R                  S9n	[         R                  " X5      n
U
R                  SS5      R                  5       n
U(       d  S n	X4$ )Nr3   r   )r4   r   )ptrainingr   r2   )r$   matmulr   r   r"   softmaxfloat32r   r   r   r   
contiguous)r   r   r   r   r   r   r   r   kwargsattn_weightsattn_outputs              r'   eager_attention_forwardr      s     <<}}R'<=GL!#4==((2U]](SVVW\WbWbcL==((6??([L,,|3K''1-88:K$$r)   c                      ^  \ rS rSrSrS\\\4   4U 4S jjr   SS\	R                  S\\	R                     S\\	R                     S\\   S	\\	R                  \\	R                     4   4
S
 jjrSrU =r$ )CLIPAttentioni  z=Multi-headed attention from 'Attention Is All You Need' paperrj   c                    > [         TU ]  5         Xl        UR                  U l        UR
                  U l        U R                  U R                  -  U l        U R                  U R                  -  U R                  :w  a&  [        SU R                   SU R                   S35      eU R                  S-  U l	        UR                  U l        SU l        [        R                  " U R                  U R                  5      U l        [        R                  " U R                  U R                  5      U l        [        R                  " U R                  U R                  5      U l        [        R                  " U R                  U R                  5      U l        g )Nz;embed_dim must be divisible by num_heads (got `embed_dim`: z and `num_heads`: r         F)ru   rv   rj   rw   rx   num_attention_heads	num_headshead_dimr   scaleattention_dropoutr   	is_causalr   Lineark_projv_projq_projout_projr   s     r'   rv   CLIPAttention.__init__  s   ++33$..8==4>>)T^^;MdnnM] ^NN#2'  ]]D(
//ii?ii?ii?		$..$..Ar)   rC   r   causal_attention_maskr   r   c                 r   UR                   u  pVnU R                  U5      nU R                  U5      n	U R                  U5      n
UR	                  XVSU R
                  5      R                  SS5      nU	R	                  XVSU R
                  5      R                  SS5      n	U
R	                  XVSU R
                  5      R                  SS5      n
U R                  R                  S:X  a
  USLU l	        OUb  Ub  X#-   nOUb  Un[        nU R                  R                  S:w  a  [        U R                  R                     nU" U UU	U
UU R                  U R                  U R                  (       d  SOU R                  US9	u  pUR                  XVU5      R!                  5       nU R#                  U5      nU(       d  SnX4$ )	z#Input shape: Batch x Time x Channelr3   r   r2   flash_attention_2Neager        )r   r   r   r   )r   r   r   r   r   r   r   rj   _attn_implementationr   r   r   r   r   r   r   r   r   )ra   rC   r   r   r   r   r   rx   queriesrd   valuesattention_interfacer   r   s                 r'   r   CLIPAttention.forward-  s    -:,?,?)
	++m,{{=)]+,,zr4==ISSTUWXYyyT]]CMMaQRSZRGQQRSUVW ;;++/BB2$>DN).C.O!/!G&2!6(?;;++w6"9$++:Z:Z"[$7nnJJ#}}C$,,/
%
! "))*)LWWYmmK0 L((r)   )rj   r   rx   r   r   r   r   r   r   r   r   )NNF)rF   rG   rH   rI   rJ   r   r   r   rv   r$   r   r   boolrM   r   rN   r   r   s   @r'   r   r     s    GBu%5~%EF B. 268<,11)||1) !.1)  (5	1)
 $D>1) 
u||Xell33	41) 1)r)   r   c                   b   ^  \ rS rSrU 4S jrS\R                  S\R                  4S jrSrU =r	$ )CLIPMLPia  c                   > [         TU ]  5         Xl        [        UR                     U l        [        R                  " UR                  UR                  5      U l
        [        R                  " UR                  UR                  5      U l        g N)ru   rv   rj   r
   
hidden_actactivation_fnr   r   rw   intermediate_sizefc1fc2r   s     r'   rv   CLIPMLP.__init__b  sb    #F$5$5699V//1I1IJ99V55v7I7IJr)   rC   r   c                 l    U R                  U5      nU R                  U5      nU R                  U5      nU$ r   )r   r   r  )ra   rC   s     r'   r   CLIPMLP.forwardi  s4    /**=9/r)   )r   rj   r   r  )
rF   rG   rH   rI   rv   r$   r   r   rN   r   r   s   @r'   r   r   a  s)    KU\\ ell  r)   r   c                      ^  \ rS rSrS\\\4   4U 4S jjr SS\R                  S\R                  S\R                  S\
\   S\\R                     4
S	 jjrS
rU =r$ )CLIPEncoderLayerip  rj   c                 <  > [         TU ]  5         UR                  U l        [	        U5      U l        [        R                  " U R                  UR                  S9U l	        [        U5      U l        [        R                  " U R                  UR                  S9U l        g N)eps)ru   rv   rw   rx   r   	self_attnr   	LayerNormlayer_norm_epslayer_norm1r   mlplayer_norm2r   s     r'   rv   CLIPEncoderLayer.__init__q  sl    ++&v.<<F<Q<QR6?<<F<Q<QRr)   rC   r   r   r   r   c                     UnU R                  U5      nU R                  UUUUS9u  pXQ-   nUnU R                  U5      nU R                  U5      nXQ-   nU4nU(       a  Xv4-  nU$ )a  
Args:
    hidden_states (`torch.FloatTensor`): input to the layer of shape `(batch, seq_len, embed_dim)`
    attention_mask (`torch.FloatTensor`): attention mask of size
        `(batch, 1, tgt_len, src_len)` where padding elements are indicated by very large negative values.
        `(config.encoder_attention_heads,)`.
    output_attentions (`bool`, *optional*):
        Whether or not to return the attentions tensors of all attention layers. See `attentions` under
        returned tensors for more detail.
)rC   r   r   r   )r  r
  r  r  )ra   rC   r   r   r   residualr   outputss           r'   r   CLIPEncoderLayer.forwardy  s    " !((7&*nn')"7/	 '5 '
# !0 ((7/ 0 "&Gr)   )rx   r  r  r  r
  r   )rF   rG   rH   rI   r   r   r   rv   r$   r   r   r   rM   rK   r   rN   r   r   s   @r'   r  r  p  sv    Su%5~%EF S -2&||& &  %||	&
 $D>& 
u  	!& &r)   r  c                   >    \ rS rSr% \\S'   SrSrSrSr	Sr
SrS rSrg)CLIPPreTrainedModeli  rj   clipTc                 "   U R                   R                  n[        U[        5      (       ad  UR                  R
                  R                  R                  SUS-  S9  UR                  R
                  R                  R                  SUS-  S9  GOF[        U[        5      (       a  U R                   R                  n[        R                  R                  UR                  SUR                  S-  U-  S9  [        R                  R                  UR                  R
                  UR                   R                  U-  S9  [        R                  R                  UR                  R
                  UR                   R                  U-  S9  GON[        U[         5      (       Ga!  U R                   R                  nUR                  S-  SUR                   R"                  -  S-  -  U-  nUR                  S-  U-  n[        R                  R                  UR$                  R
                  US9  [        R                  R                  UR&                  R
                  US9  [        R                  R                  UR(                  R
                  US9  [        R                  R                  UR*                  R
                  US9  GO[        U[,        5      (       a  U R                   R                  nUR                   R.                  S-  SUR                   R"                  -  S-  -  U-  nSUR                   R.                  -  S-  U-  n[        R                  R                  UR0                  R
                  US9  [        R                  R                  UR2                  R
                  US9  GO.[        U[4        5      (       a  [        R                  R                  UR6                  R
                  UR8                  S-  U R                   R                  -  S9  [        R                  R                  UR:                  R
                  UR<                  S-  U R                   R                  -  S9  GOk[        U[>        5      (       aa  [        R                  R                  UR:                  R
                  U R                   R.                  S-  U R                   R                  -  S9  O[        U[@        5      (       aa  [        R                  R                  UR6                  R
                  U R                   R.                  S-  U R                   R                  -  S9  O[        U[B        5      (       aj  [        R                  R                  URD                  R
                  U R                   RF                  R.                  S-  U R                   R                  -  S9  [        U[        RH                  5      (       aI  URJ                  R                  RM                  5         UR
                  R                  RO                  S5        [        U[        RP                  5      (       a3  URJ                  b%  URJ                  R                  RM                  5         ggg)	zInitialize the weightsr   g{Gz?)meanstdr   )r  r2   g      ?N))rj   initializer_factor
isinstancer   r   r   datanormal_r   rh   r   initr}   rx   r   initializer_ranger   num_hidden_layersr   r   r   r   r   rw   r   r  	CLIPModeltext_projectiontext_embed_dimvisual_projectionvision_embed_dimCLIPVisionModelWithProjectionCLIPTextModelWithProjectionCLIPForImageClassification
classifiervision_configr  rp   zero_fill_r   )ra   r   factorin_proj_stdout_proj_stdfc_stds         r'   _init_weights!CLIPPreTrainedModel._init_weights  s   //f011""))..66CVd]6S%%,,1199sQU9V 455[[33FGGOOF22&BRBRTXBX[aBaObGGOOF2299v}}?^?^ag?gOhGGOOF55<<&--BaBadjBjOk..[[33F!++T1q6==;Z;Z7Z_c6cdgmmK",,d2f<LGGOOFMM00kOBGGOOFMM00kOBGGOOFMM00kOBGGOOFOO22OE(([[33F!==44d:FMMDcDc@chl?lmpvvK&--333<vEFGGOOFJJ--6O:GGOOFJJ--;O?	**GGOO&&--))4/$++2P2PP   GGOO((//++T1DKK4R4RR    =>>GGOO((//KK++T1DKK4R4RR    ;<<GGOO&&--KK++T1DKK4R4RR    :;;GGOO!!((KK--994?$++B`B``  
 fbll++KK""$MM$$S)fbii((V[[-DKK""$ .E(r)   rE   N)rF   rG   rH   rI   r   rL   base_model_prefixsupports_gradient_checkpointing_supports_sdpa_supports_flash_attn_supports_flex_attn_supports_attention_backendr2  rN   rE   r)   r'   r  r    s0    &*#N"&6%r)   r  c                      ^  \ rS rSrSrS\4U 4S jjr    SS\\R                     S\\R                     S\\
   S\\
   S	\4
S
 jjrSrU =r$ )CLIPEncoderi  z
Transformer encoder consisting of `config.num_hidden_layers` self attention layers. Each layer is a
[`CLIPEncoderLayer`].

Args:
    config: CLIPConfig
rj   c                    > [         TU ]  5         Xl        [        R                  " [        UR                  5       Vs/ s H  n[        U5      PM     sn5      U l        SU l	        g s  snf )NF)
ru   rv   rj   r   
ModuleListranger!  r  layersgradient_checkpointing)ra   rj   r   r   s      r'   rv   CLIPEncoder.__init__  sS    mmuVMeMeGf$gGf!%5f%=Gf$gh&+# %hs   A&r   r   r   output_hidden_statesr   c                 ^   Ub  UOU R                   R                  nUb  UOU R                   R                  nU(       a  SOSnU(       a  SOSnUn[        U R                  5       H0  u  pU(       a  Xh4-   nU
" UUUUS9nUS   nU(       d  M(  X{S   4-   nM2     U(       a  Xh4-   n[        UUUS9$ )a  
Args:
    inputs_embeds (`torch.FloatTensor` of shape `(batch_size, sequence_length, hidden_size)`):
        Optionally, instead of passing `input_ids` you can choose to directly pass an embedded representation.
        This is useful if you want more control over how to convert `input_ids` indices into associated vectors
        than the model's internal embedding lookup matrix.
    attention_mask (`torch.Tensor` of shape `(batch_size, sequence_length)`, *optional*):
        Mask to avoid performing attention on padding token indices. Mask values selected in `[0, 1]`:

        - 1 for tokens that are **not masked**,
        - 0 for tokens that are **masked**.

        [What are attention masks?](../glossary#attention-mask)
    causal_attention_mask (`torch.Tensor` of shape `(batch_size, sequence_length)`, *optional*):
        Causal mask for the text model. Mask values selected in `[0, 1]`:

        - 1 for tokens that are **not masked**,
        - 0 for tokens that are **masked**.

        [What are attention masks?](../glossary#attention-mask)
    output_attentions (`bool`, *optional*):
        Whether or not to return the attentions tensors of all attention layers. See `attentions` under
        returned tensors for more detail.
    output_hidden_states (`bool`, *optional*):
        Whether or not to return the hidden states of all layers. See `hidden_states` under returned tensors
        for more detail.
    return_dict (`bool`, *optional*):
        Whether or not to return a [`~utils.ModelOutput`] instead of a plain tuple.
NrE   )r   r   r   )rB   rC   rD   )rj   r   rB  	enumerater?  r   )ra   r   r   r   r   rB  encoder_statesall_attentionsrC   idxencoder_layerlayer_outputss               r'   r   CLIPEncoder.forward  s    J 2C1N-TXT_T_TqTq$8$D $++JjJj 	  40d%"+DKK"8C#!/2B!B)%"3	M *!,M  !/3C2E!E #9  +.>>N+(%
 	
r)   )rj   r@  r?  NNNN)rF   rG   rH   rI   rJ   r   rv   r   r$   r   r   r   r   rN   r   r   s   @r'   r;  r;    s    ,z , 268<,0/3D
 !.D
  (5	D

 $D>D
 'tnD
 
D
 D
r)   r;  c                      ^  \ rS rSrS\4U 4S jjr\     SS\\R                     S\\R                     S\\R                     S\\
   S\\
   S	\4S
 jj5       rSrU =r$ )CLIPTextTransformeri;  rj   c                    > [         TU ]  5         Xl        UR                  n[	        U5      U l        [        U5      U l        [        R                  " X!R                  S9U l        UR                  U l        g r  )ru   rv   rj   rw   r   r   r;  encoderr   r  r  final_layer_normeos_token_idr   s      r'   rv   CLIPTextTransformer.__init__<  s]    &&	,V4"6* "Y<Q<Q R #//r)   r   r   rq   r   rB  r   c                    Ub  UOU R                   R                  nUb  UOU R                   R                  nUc  [        S5      eUR	                  5       nUR                  SUS   5      nU R                  XS9n[        XgR                  UR                  S9nUb/  U R                   R                  S:w  a  [        X'R                  5      nU R                  UUUUUS9n	U	R                  n
U R                  U
5      n
U R                  S:X  ae  U
[         R"                  " U
R$                  S   U
R                  S9UR'                  [         R(                  U
R                  S	9R+                  SS
94   nOU
[         R"                  " U
R$                  S   U
R                  S9UR'                  [         R(                  U
R                  S	9U R                  :H  R)                  5       R+                  SS
94   n[-        U
UU	R.                  U	R0                  S9$ )NzYou have to specify input_idsr3   )r   rq   r    r   )r   r   r   r   rB  r2   r   )r   r!   r   rB   pooler_outputrC   rD   )rj   r   rB  r   r   r   r   r   r   r!   r   r   rO  rB   rP  rQ  r$   r%   r   r   r   argmaxr   rC   rD   )ra   r   r   rq   r   rB  input_shaperC   r   encoder_outputsrB   pooled_outputs               r'   r   CLIPTextTransformer.forwardG  s    2C1N-TXT_T_TqTq$8$D $++JjJj 	 <==nn&NN2{27	)W !A,,]5I5I!

 %$++*J*JNa*a7H[H[\N+/<<')"7/!5 ,8 ,
 ,== 112CD! ..44Q7@Q@X@XY5995F5M5MNUUZ\U]_M ..44Q7@Q@X@XY EII6G6N6NOSWSdSddB!M */')77&11	
 	
r)   )rj   r   rO  rQ  rP  NNNNN)rF   rG   rH   rI   r   rv   r   r   r$   r   r   r   r   rN   r   r   s   @r'   rM  rM  ;  s    	0~ 	0  -115/3,0/3F
ELL)F
 !.F
 u||,	F

 $D>F
 'tnF
 
$F
 F
r)   rM  zI
    The text model from CLIP without any head or projection on top.
    c                     ^  \ rS rSr% \\S'   SS/rSrS\4U 4S jjrS\	R                  4S jrS	 r\\     SS
\\R"                     S\\R"                     S\\R"                     S\\   S\\   S\4S jj5       5       rSrU =r$ )CLIPTextModeli  rj   r   r  Fc                 d   > [         TU ]  U5        [        U5      U l        U R	                  5         g r   )ru   rv   rM  
text_model	post_initr   s     r'   rv   CLIPTextModel.__init__  s&     -f5r)   r   c                 B    U R                   R                  R                  $ r   r_  r   r   re   s    r'   get_input_embeddings"CLIPTextModel.get_input_embeddings      ))999r)   c                 8    XR                   R                  l        g r   rc  ra   r   s     r'   set_input_embeddings"CLIPTextModel.set_input_embeddings      5:""2r)   r   r   rq   r   rB  c                 (    U R                  UUUUUS9$ )a  
Examples:

```python
>>> from transformers import AutoTokenizer, CLIPTextModel

>>> model = CLIPTextModel.from_pretrained("openai/clip-vit-base-patch32")
>>> tokenizer = AutoTokenizer.from_pretrained("openai/clip-vit-base-patch32")

>>> inputs = tokenizer(["a photo of a cat", "a photo of a dog"], padding=True, return_tensors="pt")

>>> outputs = model(**inputs)
>>> last_hidden_state = outputs.last_hidden_state
>>> pooled_output = outputs.pooler_output  # pooled (EOS token) states
```r   r   rq   r   rB  r_  )ra   r   r   rq   r   rB  s         r'   r   CLIPTextModel.forward  s)    4 )%/!5  
 	
r)   rn  r[  )rF   rG   rH   rI   r   rL   _no_split_modulesr7  rv   r   Modulerd  ri  r   r   r   r$   r   r   r   r   rN   r   r   s   @r'   r]  r]    s     -/AB ~ :bii :;  -115/3,0/3
ELL)
 !.
 u||,	

 $D>
 'tn
 
$
  
r)   r]  c                      ^  \ rS rSrS\4U 4S jjr\    SS\\R                     S\\
   S\\
   S\\
   S\4
S	 jj5       rS
rU =r$ )CLIPVisionTransformeri  rj   c                   > [         TU ]  5         Xl        UR                  n[	        U5      U l        [        R                  " X!R                  S9U l	        [        U5      U l        [        R                  " X!R                  S9U l        g r  )ru   rv   rj   rw   rh   r   r   r  r  pre_layrnormr;  rO  post_layernormr   s      r'   rv   CLIPVisionTransformer.__init__  sd    &&	.v6LL8M8MN"6* ll9:O:OPr)   r   r   rB  r   r   c                 ~   Ub  UOU R                   R                  nUb  UOU R                   R                  nUc  [        S5      eU R	                  XS9nU R                  U5      nU R                  UUUS9nUR                  nUS S 2SS S 24   nU R                  U5      n[        UUUR                  UR                  S9$ )Nz You have to specify pixel_values)r   )r   r   rB  r   rT  )rj   r   rB  r   r   ru  rO  rB   rv  r   rC   rD   )	ra   r   r   rB  r   rC   rX  rB   rY  s	            r'   r   CLIPVisionTransformer.forward  s     2C1N-TXT_T_TqTq$8$D $++JjJj 	 ?@@h))-8+/<<'/!5 ,8 ,
 ,==)!Q'2++M:)/')77&11	
 	
r)   )rj   r   rO  rv  ru  NNNF)rF   rG   rH   rI   r   rv   r   r   r$   rK   r   r   r   rN   r   r   s   @r'   rs  rs    s{    Q/ Q  59,0/338!
u001!
 $D>!
 'tn	!

 #+4.!
 
$!
 !
r)   rs  zK
    The vision model from CLIP without any head or projection on top.
    c                      ^  \ rS rSr% \\S'   SrS/rS\4U 4S jjrS\	R                  4S jr\\    SS\\R                      S\\   S	\\   S
\S\4
S jj5       5       rSrU =r$ )CLIPVisionModeli  rj   r   r  c                 d   > [         TU ]  U5        [        U5      U l        U R	                  5         g r   )ru   rv   rs  vision_modelr`  r   s     r'   rv   CLIPVisionModel.__init__  s'     1&9r)   r   c                 B    U R                   R                  R                  $ r   r~  r   r   re   s    r'   rd  $CLIPVisionModel.get_input_embeddings        ++;;;r)   r   rB  r   c                 &    U R                  UUUUS9$ )ag  
Example:

```python
>>> from PIL import Image
>>> import requests
>>> from transformers import AutoProcessor, CLIPVisionModel

>>> model = CLIPVisionModel.from_pretrained("openai/clip-vit-base-patch32")
>>> processor = AutoProcessor.from_pretrained("openai/clip-vit-base-patch32")

>>> url = "http://images.cocodataset.org/val2017/000000039769.jpg"
>>> image = Image.open(requests.get(url, stream=True).raw)

>>> inputs = processor(images=image, return_tensors="pt")

>>> outputs = model(**inputs)
>>> last_hidden_state = outputs.last_hidden_state
>>> pooled_output = outputs.pooler_output  # pooled CLS states
```r   r   rB  r   r~  )ra   r   r   rB  r   s        r'   r   CLIPVisionModel.forward  s(    <   %/!5%=	 ! 
 	
r)   r  rz  )rF   rG   rH   rI   r   rL   main_input_namerp  rv   r   rq  rd  r   r   r   r$   rK   r   r   r   rN   r   r   s   @r'   r|  r|    s     $O+,/ <bii <  59,0/3).!
u001!
 $D>!
 'tn	!

 #'!
 
$!
  !
r)   r|  c                     ^  \ rS rSr% \\S'   / SQrSrS\4U 4S jjr\	" 5       \
  SS\R                  S\\R                     S\\R                     S	\R                  4S
 jj5       5       r\	" 5       \
 SS\R                  S\S	\R                  4S jj5       5       r\\
        SS\\R&                     S\\R                     S\\R                     S\\R&                     S\\   S\\   S\\   S\S	\4S jj5       5       rSrU =r$ )r"  i4  rj   )r   r  rh   Fc                   > [         TU ]  U5        [        UR                  [        5      (       d"  [        S[        UR                  5       S35      e[        UR                  [        5      (       d"  [        S[        UR                  5       S35      eUR                  nUR                  nUR                  U l	        UR                  U l        UR                  U l        [        R                  U5      nUR                  U l        [         R                  U5      nUR"                  U l        [$        R&                  " U R                  U R                  SS9U l        [$        R&                  " U R                  U R                  SS9U l        [$        R,                  " [.        R0                  " U R2                  R4                  5      5      U l        U R9                  5         g )NzKconfig.text_config is expected to be of type CLIPTextConfig but is of type .zOconfig.vision_config is expected to be of type CLIPVisionConfig but is of type Frp   )ru   rv   r  text_configr   	TypeErrortyper+  r   projection_dimrw   r$  r&  r]  _from_configr_  r|  r~  r   r   r%  r#  r{   r$   r0   rj   logit_scale_init_valuelogit_scaler`  )ra   rj   r  r+  r_  r~  r   s         r'   rv   CLIPModel.__init__:  s~    &,,n==++,-Q0 
 &..0@AA--./q2 
 ((,,$33)55 - 9 9"//<
$//&33MB(55!#4+@+@$BUBU\a!b!yy)<)<d>Q>QX]^<<T[[5W5W(XY 	r)   r   r   rq   r   c                 b    U R                  UUUS9nUR                  nU R                  U5      nU$ )ay  
Returns:
    text_features (`torch.FloatTensor` of shape `(batch_size, output_dim`): The text embeddings obtained by
    applying the projection layer to the pooled output of [`CLIPTextModel`].

Examples:

```python
>>> import torch
>>> from transformers import AutoTokenizer, CLIPModel

>>> model = CLIPModel.from_pretrained("openai/clip-vit-base-patch32")
>>> tokenizer = AutoTokenizer.from_pretrained("openai/clip-vit-base-patch32")

>>> inputs = tokenizer(["a photo of a cat", "a photo of a dog"], padding=True, return_tensors="pt")

>>> with torch.inference_mode():
...     text_features = model.get_text_features(**inputs)
```)r   r   rq   )r_  rU  r#  )ra   r   r   rq   text_outputsrY  text_featuress          r'   get_text_featuresCLIPModel.get_text_features]  sD    6 48??)% 4C 4

 %22,,];r)   r   r   c                 `    U R                  UUS9nUR                  nU R                  U5      nU$ )a  
Returns:
    image_features (`torch.FloatTensor` of shape `(batch_size, output_dim`): The image embeddings obtained by
    applying the projection layer to the pooled output of [`CLIPVisionModel`].

Examples:

```python
>>> import torch
>>> from transformers import AutoProcessor, CLIPModel
>>> from transformers.image_utils import load_image

>>> model = CLIPModel.from_pretrained("openai/clip-vit-base-patch32")
>>> processor = AutoProcessor.from_pretrained("openai/clip-vit-base-patch32")

>>> url = "http://images.cocodataset.org/val2017/000000039769.jpg"
>>> image = load_image(url)

>>> inputs = processor(images=image, return_tensors="pt")

>>> with torch.inference_mode():
...     image_features = model.get_image_features(**inputs)
```)r   r   )r~  rU  r%  )ra   r   r   vision_outputsrY  image_featuress         r'   get_image_featuresCLIPModel.get_image_features  sC    < 6:5F5F%%= 6G 6
 '44//>r)   return_lossr   rB  c	           
         Ub  UOU R                   R                  nUb  UOU R                   R                  nU R                  UUUUS9n	U R	                  UUUUUS9n
U	R
                  nU R                  U5      nU
R
                  nU R                  U5      nU[        U5      -  nU[        U5      -  n[        R                  " XR                  5       R                  UR                  5      5      nXR                  R                  5       R                  UR                  5      -  nUR                  5       nSnU(       a  [!        U5      n[#        UUUUUU
U	S9$ )aj  
return_loss (`bool`, *optional*):
    Whether or not to return the contrastive loss.

Examples:

```python
>>> import torch
>>> from transformers import AutoProcessor, CLIPModel
>>> from transformers.image_utils import load_image

>>> model = CLIPModel.from_pretrained("openai/clip-vit-base-patch32")
>>> processor = AutoProcessor.from_pretrained("openai/clip-vit-base-patch32")

>>> url = "http://images.cocodataset.org/val2017/000000039769.jpg"
>>> image = load_image(url)

>>> inputs = processor(
...     text=["a photo of a cat", "a photo of a dog"], images=image, return_tensors="pt", padding=True
... )

>>> with torch.inference_mode():
...     outputs = model(**inputs)
>>> logits_per_image = outputs.logits_per_image  # this is the image-text similarity score
>>> probs = logits_per_image.softmax(dim=1)  # we can take the softmax to get the label probabilities
```Nr  rm  )rV   rW   rX   rR   rA   rY   rZ   )rj   r   rB  r~  r_  rU  r%  r#  r<   r$   r   r,   r   r!   r  expr/   rT   )ra   r   r   r   rq   r  r   rB  r   r  r  rA   rR   rX   rW   rV   s                   r'   r   CLIPModel.forward  sq   P 2C1N-TXT_T_TqTq$8$D $++JjJj 	 6:5F5F%/!5%=	 6G 6
 48??)%/!5 4C 4
 &33--l;"00**;7 $&6|&DD!$4[$AA  ,,{NN4D4G4GHZHZ4[\),<,<,@,@,B,E,EkFXFX,YY*,,._-D-+#%* .
 	
r)   )r  r  r$  r_  r#  r&  r~  r%  )NNr   )NNNNNNNF)rF   rG   rH   rI   r   rL   rp  r7  rv   r   r   r$   r   r   rK   r  r   r  r   r   rT   r   rN   r   r   s   @r'   r"  r"  4  s   Z !z !F %& 26/3	!<<! !.! u||,	!
 
		!  '!F %& */#''# #'# 
			#  '#J  15481537&*,0/3).V
E,,-V
 u001V
 !.	V

 u//0V
 d^V
 $D>V
 'tnV
 #'V
 
V
  V
r)   r"  c                     ^  \ rS rSr% \\S'   SrSS/rS\4U 4S jjrS\	R                  4S jrS	 r\\     SS
\\R"                     S\\R"                     S\\R"                     S\\   S\\   S\4S jj5       5       rSrU =r$ )r(  i  rj   Fr   r  c                    > [         TU ]  U5        [        R                  U5      nUR                  U l        [
        R                  " UR                  UR                  SS9U l	        U R                  5         g NFr  )ru   rv   r]  r  r_  r   r   rw   r  r#  r`  )ra   rj   r_  r   s      r'   rv   $CLIPTextModelWithProjection.__init__  s[     "//7
$//!yy););V=R=RY^_ 	r)   r   c                 B    U R                   R                  R                  $ r   rc  re   s    r'   rd  0CLIPTextModelWithProjection.get_input_embeddings  rf  r)   c                 8    XR                   R                  l        g r   rc  rh  s     r'   ri  0CLIPTextModelWithProjection.set_input_embeddings  rk  r)   r   r   rq   r   rB  c                     U R                  UUUUUS9nUR                  nU R                  U5      n[        UUR                  UR
                  UR                  S9$ )a  
Examples:

```python
>>> import torch
>>> from transformers import AutoTokenizer, CLIPTextModelWithProjection

>>> model = CLIPTextModelWithProjection.from_pretrained("openai/clip-vit-base-patch32")
>>> tokenizer = AutoTokenizer.from_pretrained("openai/clip-vit-base-patch32")

>>> inputs = tokenizer(["a photo of a cat", "a photo of a dog"], padding=True, return_tensors="pt")

>>> with torch.inference_mode():
...     outputs = model(**inputs)
>>> text_embeds = outputs.text_embeds
```rm  )rR   rB   rC   rD   )r_  rU  r#  rP   rB   rC   rD   )	ra   r   r   rq   r   rB  r  rY  rR   s	            r'   r   #CLIPTextModelWithProjection.forward  so    6 48??)%/!5 4C 4
 %22**=9"#*<<&44#..	
 	
r)   )r_  r#  r[  )rF   rG   rH   rI   r   rL   r7  rp  rv   r   rq  rd  ri  r   r   r   r$   r   r   rP   r   rN   r   r   s   @r'   r(  r(    s     -/AB	~ 	:bii :;  -115/3,0/3(
ELL)(
 !.(
 u||,	(

 $D>(
 'tn(
 
(
  (
r)   r(  c                      ^  \ rS rSr% \\S'   SrS\4U 4S jjrS\R                  4S jr
\\    SS\\R                     S\\   S\\   S	\S\4
S
 jj5       5       rSrU =r$ )r'  iI  rj   r   c                    > [         TU ]  U5        [        R                  U5      nUR                  U l        [
        R                  " UR                  UR                  SS9U l	        U R                  5         g r  )ru   rv   r|  r  r~  r   r   rw   r  r%  r`  ra   rj   r~  r   s      r'   rv   &CLIPVisionModelWithProjection.__init__N  s\     &33F;(55!#6+=+=v?T?T[`!a 	r)   r   c                 B    U R                   R                  R                  $ r   r  re   s    r'   rd  2CLIPVisionModelWithProjection.get_input_embeddingsY  r  r)   r   rB  r   c                     U R                  UUUUS9nUR                  nU R                  U5      n[        UUR                  UR
                  UR                  S9$ )aX  
Examples:

```python
>>> import torch
>>> from transformers import AutoProcessor, CLIPVisionModelWithProjection
>>> from transformers.image_utils import load_image

>>> model = CLIPVisionModelWithProjection.from_pretrained("openai/clip-vit-base-patch32")
>>> processor = AutoProcessor.from_pretrained("openai/clip-vit-base-patch32")

>>> url = "http://images.cocodataset.org/val2017/000000039769.jpg"
>>> image = load_image(url)

>>> inputs = processor(images=image, return_tensors="pt")

>>> with torch.inference_mode():
...     outputs = model(**inputs)
>>> image_embeds = outputs.image_embeds
```r  )rA   rB   rC   rD   )r~  rU  r%  r?   rB   rC   rD   )ra   r   r   rB  r   r  rY  rA   s           r'   r   %CLIPVisionModelWithProjection.forward\  sn    < 6:5F5F%/!5%=	 6G 6
 '44--m<$%,>>(66%00	
 	
r)   )r~  r%  rz  )rF   rG   rH   rI   r   rL   r  rv   r   rq  rd  r   r   r   r$   rK   r   r?   r   rN   r   r   s   @r'   r'  r'  I  s    $O	/ 	<bii <  59,0/3).*
u001*
 $D>*
 'tn	*

 #'*
 
*
  *
r)   r'  z
    CLIP vision encoder with an image classification head on top (a linear layer on top of the pooled final hidden states of
    the patch tokens) e.g. for ImageNet.
    c                      ^  \ rS rSrSrS\SS4U 4S jjr\\    SS\	\
R                     S\	\
R                     S\	\   S	\	\   S\4
S
 jj5       5       rSrU =r$ )r)  i  r   rj   r   Nc                   > [         TU ]  U5        UR                  U l        [        R	                  UR
                  5      nUR                  U l        UR                  S:  a5  [        R                  " UR
                  R                  UR                  5      O[        R                  " 5       U l        U R                  5         g )Nr   )ru   rv   
num_labelsr|  r  r+  r~  r   r   rw   Identityr*  r`  r  s      r'   rv   #CLIPForImageClassification.__init__  s      ++&33F4H4HI(55 OUN_N_bcNcBIIf**668I8IJikititiv 	
 	r)   labelsr   rB  c                    Ub  UOU R                   R                  nUb  UOU R                   R                  nU R                  UUUS9nUR                  n[
        R                  " USS2SS2SS24   SS9nU R                  U5      nSnUb  U R                  X'U R                   5      n[        UUUR                  UR                  S9$ )ab  
labels (`torch.LongTensor` of shape `(batch_size,)`, *optional*):
    Labels for computing the image classification/regression loss. Indices should be in `[0, ...,
    config.num_labels - 1]`. If `config.num_labels == 1` a regression loss is computed (Mean-Square loss), If
    `config.num_labels > 1` a classification loss is computed (Cross-Entropy).
N)r   rB  r   r   )rV   r   rC   rD   )rj   r   rB  r~  rB   r$   r  r*  loss_functionr   rC   rD   )	ra   r   r  r   rB  r  sequence_outputr   rV   s	            r'   r   "CLIPForImageClassification.forward  s     2C1N-TXT_T_TqTq$8$D $++JjJj 	 /3.?.?/!5 /@ /
 "33  **_QAX%>AF1%%fdkkBD$!//))	
 	
r)   )r*  r  r~  rK  )rF   rG   rH   rI   r  r   rv   r   r   r   r$   r   r   r   r   rN   r   r   s   @r'   r)  r)    s     %Oz d   04)-,0/3(
u||,(
 &(
 $D>	(

 'tn(
 
(
  (
r)   r)  )r"  r  r]  r(  r|  r'  r)  )r   T)ArJ   dataclassesr   typingr   r   r   r   r$   r   activationsr
   modeling_attn_mask_utilsr   r   modeling_layersr   modeling_outputsr   r   r   modeling_utilsr   r   utilsr   r   r   r   r   r   configuration_clipr   r   r   
get_loggerrF   loggerr   r(   r/   r<   r?   rP   rT   rq  rh   r   floatr   r   r   r   r  r  r;  rM  r]  rs  r|  r"  r(  r'  r)  __all__rE   r)   r'   <module>r     s    ! 1 1   ! d 9 b b F w w L L 
		H	%
`U\\ `ell `-%,, -5<< -U\\ ell  
	?K 	? 	? 
	?+ 	? 	?  
  
   
FP299 Pf% %^ "%II%<<% 
% <<	%
 U\\*% % % %0H)BII H)Vbii /1 /d ?%/ ?% ?%DS
")) S
lS
")) S
l 
2
' 2

2
j-
BII -
` 
1
) 1

1
h L
# L
 L
^ A
"5 A
 A
H >
$7 >
 >
B <
!4 <
<
~r)   