+
QV-jXZ ^ RI t ^ RIt^ RIt^ RIHtHt ^ RIt^ RIH t ^RI
H t ^RI H
t ^RIHtHt ^RIHtHtHtHtHtHt ^RIHtHt ]! R R
R 7 t ]P: ! ] 4 t ! R R
]4 t
! R R
]4 t ]! ] PB 4 ] n! ] PB PD e: ] PB PD PG RRRR7 ] PB n" R# R# ) N)AnyTypeVar)is_offline_mode)custom_object_save) BatchFeature)is_valid_image
load_image)IMAGE_PROCESSOR_NAMEPROCESSOR_NAMEPushToHubMixin copy_funcloggingsafe_load_json_file) cached_filehf_apiImageProcessorTypeImageProcessingMixin)boundc ] tR t^-tRtRtR# )r a
Holds the output of the image processor specific `__call__` methods.
This class is derived from a python dictionary and can be used as a dictionary.
Args:
data (`dict`):
Dictionary of lists/arrays/tensors returned by the __call__ method ('pixel_values', etc.).
tensor_type (`Union[None, str, TensorType]`, *optional*):
You can give a tensor_type here to convert the lists of integers in PyTorch/Numpy Tensors at
initialization.
N)__name__
__module__ __qualname____firstlineno____doc____static_attributes__r s/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/transformers/image_processing_base.pyr r - s r r c a ] tR t^=t o RtRtR t]RV 3R lR ll4 tRV 3R lR llt ]V 3R lR l4 t
]V 3R
lR l4 t V 3R lR
lt ]V 3R lR l4 t
V 3R lR ltV 3R lR ltR t]RR l4 tV 3R lR ltRtV tR# ) r z|
This is an image processor mixin used to provide saving/loading functionality for sequential and image feature
extractors.
Nc
VP RR4 VP RR4 VP 4 F w r# \ WV4 K R# \ d& p\ P RT RT RT 24 ThRp?ii ; i)z'Set elements of `kwargs` as attributes.feature_extractor_typeNprocessor_classz
Can't set z with value z for )popitemssetattrAttributeErrorloggererror)selfkwargskeyvalueerrs &, r __init__ ImageProcessingMixin.__init__E sy
+T2
$d+ ,,.JC
5) ) "
z#l5'tf MN
s A
A= A88A=c < V ^8 d QhRS[ S[, RS[S[P , RS[S[P , R, RS[RS[RS[S[, R, RS[R S[/# )
cls pretrained_model_name_or_path cache_dirNforce_downloadlocal_files_onlytokenrevisionreturn)typer strosPathLikebool)format
__classdict__s "r __annotate__!ImageProcessingMixin.__annotate__U s `= `=
$
%`='*R[['8`= $t+`= `=
`= TzD
`= `=
`=r c W'R& W7R& WGR& WgR& Ve WWR& V P ! V3/ VB w rV P ! V3/ VB # )a
Instantiate a type of [`~image_processing_utils.ImageProcessingMixin`] from an image processor.
Args:
pretrained_model_name_or_path (`str` or `os.PathLike`):
This can be either:
- a string, the *model id* of a pretrained image_processor hosted inside a model repo on
huggingface.co.
- a path to a *directory* containing a image processor file saved using the
[`~image_processing_utils.ImageProcessingMixin.save_pretrained`] method, e.g.,
`./my_model_directory/`.
- a path to a saved image processor JSON *file*, e.g.,
`./my_model_directory/preprocessor_config.json`.
cache_dir (`str` or `os.PathLike`, *optional*):
Path to a directory in which a downloaded pretrained model image processor should be cached if the
standard cache should not be used.
force_download (`bool`, *optional*, defaults to `False`):
Whether or not to force to (re-)download the image processor files and override the cached versions if
they exist.
proxies (`dict[str, str]`, *optional*):
A dictionary of proxy servers to use by protocol or endpoint, e.g., `{'http': 'foo.bar:3128',
'http://hostname': 'foo.bar:4012'}.` The proxies are used on each request.
token (`str` or `bool`, *optional*):
The token to use as HTTP bearer authorization for remote files. If `True`, or not specified, will use
the token generated when running `hf auth login` (stored in `~/.huggingface`).
revision (`str`, *optional*, defaults to `"main"`):
The specific model version to use. It can be a branch name, a tag name, or a commit id, since we use a
git-based system for storing models and other artifacts on huggingface.co, so `revision` can be any
identifier allowed by git.
To test a pull request you made on the Hub, you can pass `revision="refs/pr/"`.
return_unused_kwargs (`bool`, *optional*, defaults to `False`):
If `False`, then this function returns just the final image processor object. If `True`, then this
functions returns a `Tuple(image_processor, unused_kwargs)` where *unused_kwargs* is a dictionary
consisting of the key/value pairs whose keys are not image processor attributes: i.e., the part of
`kwargs` which has not been used to update `image_processor` and is otherwise ignored.
subfolder (`str`, *optional*, defaults to `""`):
In case the relevant files are located inside a subfolder of the model repo on huggingface.co, you can
specify the folder name here.
kwargs (`dict[str, Any]`, *optional*):
The values in kwargs of any keys which are image processor attributes will be used to override the
loaded values. Behavior concerning key/value pairs whose keys are *not* image processor attributes is
controlled by the `return_unused_kwargs` keyword parameter.
Returns:
A image processor of type [`~image_processing_utils.ImageProcessingMixin`].
Examples:
```python
# We can't instantiate directly the base class *ImageProcessingMixin* so let's show the examples on a
# derived class: *CLIPImageProcessor*
image_processor = CLIPImageProcessor.from_pretrained(
"openai/clip-vit-base-patch32"
) # Download image_processing_config from huggingface.co and cache.
image_processor = CLIPImageProcessor.from_pretrained(
"./test/saved_model/"
) # E.g. image processor (or model) was saved using *save_pretrained('./test/saved_model/')*
image_processor = CLIPImageProcessor.from_pretrained("./test/saved_model/preprocessor_config.json")
image_processor = CLIPImageProcessor.from_pretrained(
"openai/clip-vit-base-patch32", do_normalize=False, foo=False
)
assert image_processor.do_normalize is False
image_processor, unused_kwargs = CLIPImageProcessor.from_pretrained(
"openai/clip-vit-base-patch32", do_normalize=False, foo=False, return_unused_kwargs=True
)
assert image_processor.do_normalize is False
assert unused_kwargs == {"foo": False}
```r4 r5 r6 r8 r7 )get_image_processor_dict from_dict) r2 r3 r4 r5 r6 r7 r8 r* image_processor_dicts &&&&&&&, r from_pretrained$ImageProcessingMixin.from_pretrainedT sd n ({#1 %5!" %z #7O'*'C'CDa'lek'l$ }} 1 )r? r@ s "r rA rB s$ .- .-cBKK.? .-d .-r c \ P P V4 ' d \ RV R24 h\ P ! VRR7 V' d VP RR4 pVP RVP
\ P P 4 R
, 4 p\ 4 P ! V3RR/VB P pV P V4 pV P e \ WV R 7 \ P P V\ 4 pV P! V4 \" P% R
V 24 V' d& V P' VXXXVP) R 4 R 7 V.# )a
Save an image processor object to the directory `save_directory`, so that it can be re-loaded using the
[`~image_processing_utils.ImageProcessingMixin.from_pretrained`] class method.
Args:
save_directory (`str` or `os.PathLike`):
Directory where the image processor JSON file will be saved (will be created if it does not exist).
push_to_hub (`bool`, *optional*, defaults to `False`):
Whether or not to push your model to the Hugging Face model hub after saving it. You can specify the
repository you want to push to with `repo_id` (will default to the name of `save_directory` in your
namespace).
kwargs (`dict[str, Any]`, *optional*):
Additional key word arguments passed along to the [`~utils.PushToHubMixin.push_to_hub`] method.
zProvided path (z#) should be a directory, not a fileT)exist_okcommit_messageNrepo_idrM )configzImage processor saved in r7 )rN r7 )r< pathisfileAssertionErrormakedirsr# splitsepr create_reporO _get_files_timestamps _auto_classr joinr
to_json_filer' info_upload_modified_filesget)r) rJ rK r* rN rO files_timestampsoutput_image_processor_files &&&, r save_pretrained$ImageProcessingMixin.save_pretrained s8 77>>. ) ) ?>2BBe!fg g
NT2 #ZZ(8$ ?N jjN,@,@,Mb,QRG h**7LTLVLTTG # 9 9. I ' tD A ')ggll>CW&X# 56 /0K/LMN ' ' - jj)
(
,,,r c < V ^8 d QhRS[ S[P , RS[S[S[ S[3, S[S[ S[3, 3, /# )r1 r3 r9 )r; r< r= tupledictr )r? r@ s "r rA rB sD t, t,,/"++,=t, tCH~tCH~- .t,r c VP RR4 pVP RR4 pVP RR4 pVP RR4 pVP RR4 pVP RR4 pVP R R
4 p VP R \ 4 p
VP R R4 p VP R
R4 p RRRV /p
V e WR& \ 4 ' d V' g \ P R4 Rp\ V4 p\ P P V4 p\ P P V4 ' d \ P P W4 p\ P P V4 ' d TpRpRpM3T
p \ V\ VVVVVV
VV RR7 p\ VVVVVVVV
VV RR7 pRpVe \ V4 pRV9 d
VR, pVe Vf \ V4 pVf \ RV RV RV
R24 hV' d \ P RV 24 VV3# \ P RX RV 24 VV3# \ d h \ d \ RT RT RT
R24 hi ; i) aa
From a `pretrained_model_name_or_path`, resolve to a dictionary of parameters, to be used for instantiating a
image processor of type [`~image_processor_utils.ImageProcessingMixin`] using `from_dict`.
Parameters:
pretrained_model_name_or_path (`str` or `os.PathLike`):
The identifier of the pre-trained checkpoint from which we want the dictionary of parameters.
subfolder (`str`, *optional*, defaults to `""`):
In case the relevant files are located inside a subfolder of the model repo on huggingface.co, you can
specify the folder name here.
image_processor_filename (`str`, *optional*, defaults to `"config.json"`):
The name of the file in the model directory to use for the image processor config.
Returns:
`tuple[Dict, Dict]`: The dictionary(ies) that will be used to instantiate the image processor object.
r4 Nr5 Fproxiesr7 r6 r8 subfolder image_processor_filename_from_pipeline
_from_auto file_typeimage processorfrom_auto_classusing_pipelinez+Offline mode: forcing local_files_only=TrueT)
filenamer4 r5 rh r6 r7
user_agentr8 ri %_raise_exceptions_for_missing_entriesz Can't load image processor for 'z'. If you were trying to load it from 'https://huggingface.co/models', make sure you don't have a local directory with the same name. Otherwise, make sure 'z2' is the correct path to a directory containing a z fileimage_processorzloading configuration file z from cache at )r# r
r r' r] r; r< rR isdirr[ rS r r OSError Exceptionr )r2 r3 r* r4 r5 rh r7 r6 r8 ri rk
from_pipelinerp rs is_localimage_processor_file resolved_image_processor_fileresolved_processor_filerF processor_dicts &&, r rD -ImageProcessingMixin.get_image_processor_dict s ( JJ{D1 $4e<**Y-
7D)!::&8%@::j$/JJ{B/ #)::.HJ^#_
#3T:
**\59!#46G Y
$+8' ( %5 KKE F # (+,I(J%77==!>?
77==6 7 7#%77<<0M#h
77>>7 8 8,I )&* #H#; &
*51 + '#1 #%5 ) % ':? +' 1<1 1 '#1 #%5 ) % ':? 1-: $ " . 01H IN N2'56G'H$ ( 49M9U#67T#U '23P2Q R55R4S T++C*DEK
KK56S5TU V $V++
KK-.B-C?SpRqr
$V++Q
67T6U V99V8W X//G.HO
s 0I I?(I?c 6 < V ^8 d QhRS[ S[S[3, /# )r1 rF rf r; r )r? r@ s "r rA rB _ s &# &#T#s(^ &#r c VP 4 pVP RR4 pTP VP 4 UUu/ uF# w rEW@P P
9 g K! WEbK% upp4 V ! R/ VB p. p\
\ VP 4 4 4 F_ p\ Wh4 ' g K WP P
9 g K2 \ WhVP VR4 4 VP V4 Ka V' d' \ P RV P RV R24 \ P RV 24 V' d Wb3# V# u uppi )a
Instantiates a type of [`~image_processing_utils.ImageProcessingMixin`] from a Python dictionary of parameters.
Args:
image_processor_dict (`dict[str, Any]`):
Dictionary that will be used to instantiate the image processor object. Such a dictionary can be
retrieved from a pretrained checkpoint by leveraging the
[`~image_processing_utils.ImageProcessingMixin.to_dict`] method.
kwargs (`dict[str, Any]`):
Additional parameters from which to initialize the image processor object.
Returns:
[`~image_processing_utils.ImageProcessingMixin`]: The image processor object instantiated from those
parameters.
return_unused_kwargsFNzImage processor z : kwargs z were applied for backward compatibility. To avoid this warning, add them to valid_kwargs: create a custom TypedDict extending ImagesKwargs with these keys and set it as the `valid_kwargs` class attribute.r )copyr# updater$ valid_kwargs__annotations__reversedlistkeyshasattrr% appendr' warning_oncer r] ) r2 rF r* r kvru
extra_keysr+ s &&, r rE ImageProcessingMixin.from_dict^ s- " 4 8 8 : %zz*@% H ##flln$nndaM]M]MmMmHmTQTn$no 5 45
D /0C,,r s + 4 F 3 + 19OP
H %
# jw> jwZ
$--A-M-M#N ##++7/C/O/O/W/W/^/^ /CRh 0_ 0$$, 8r