pyiTZ S SK r S SKrS SKrS SKJrJr S SKrS SKJ r J
r
SSK J r SSK
Jr SSKJrJr SSKJrJrJrJrJrJr SS KJr \" S
S S 9r \R: " \ 5 r " S
S\5 r " S S \5 r \" \ RB 5 \ l! \ RB RD b5 \ RB RD RG SSSS9\ RB l" gg) N)AnyTypeVar) create_repois_offline_mode )custom_object_save) BatchFeature)is_valid_image
load_image)IMAGE_PROCESSOR_NAMEPROCESSOR_NAMEPushToHubMixin copy_funcloggingsafe_load_json_file) cached_fileImageProcessorTypeImageProcessingMixin)boundc \ rS rSrSrSrg)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 _/home/mande/repo/quber/.venv/lib/python3.13/site-packages/transformers/image_processing_base.pyr r - s r r c \ rS rSrSrSrS r\ S S\\ S\
\ R - S\
\ R - S- S\
S \
S
\
\
- S- S \
S \ 4S
jj5 rS S\
\ R - S\
4S jjr\S\
\ R - S \\\
\4 \\
\4 4 4S j5 r\S\\
\4 4S j5 rS \\
\4 4S jr\S\
\ R - 4S j5 rS \
4S jrS\
\ R - 4S jrS r\S!S j5 rS \
\\
- \\\
- 4S jr S r g)"r = z|
This is an image processor mixin used to provide saving/loading functionality for sequential and image feature
extractors.
Nc
UR SS5 UR SS5 UR 5 H u p# [ XU5 M g! [ a% n[ R SU SU SU 35 UeSnAff = f)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; A66A;cls pretrained_model_name_or_path cache_dirforce_downloadlocal_files_onlytokenrevisionreturnc X'S' X7S' XGS' XgS' Ub XWS' U R " U40 UD6u pU R " U40 UD6$ )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}
```r5 r6 r7 r9 r8 )get_image_processor_dict from_dict) r3 r4 r5 r6 r7 r8 r9 r- image_processor_dicts r from_pretrained$ImageProcessingMixin.from_pretrainedT sd n ({#1 %5!" %z #7O'*'C'CDa'lek'l$ }} 1>. ) ) ?>2BBe!fg g
NT2 #ZZ(8$ ?N jjN,@,@,Mb,QRG!'CDCFCKKG # 9 9. I ' tD A ')ggll>CW&X# 56 /0K/LMN ' ' - jj)
(
,,,r c UR SS5 nUR SS5 nUR SS5 nUR SS5 nUR SS5 nUR SS5 nUR S S
5 n UR S [ 5 n
UR S S5 n UR S
S5 n SU S.n
U b XS' [ 5 ( a U( d [ R S5 Sn[ U5 n[ R R U5 n[ R R U5 ( a [ R R X5 n[ R R U5 ( a UnSnSnO-U
n [ U[ UUUUUU
UU SS9 n[ UUUUUUUU
UU SS9 nSnUb [ U5 nSU; a US nUb Uc [ U5 nUc [ SU SU SU
S35 eU( a [ R SU 35 UU4$ [ R SW SU 35 UU4$ ! [ a e [ a [ SU SU SU
S35 ef = f)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.
r5 Nr6 Fproxiesr8 r7 r9 subfolder image_processor_filename_from_pipeline
_from_autoimage processor) file_typefrom_auto_classusing_pipelinez+Offline mode: forcing local_files_only=TrueT)
filenamer5 r6 r\ r7 r8
user_agentr9 r] %_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* rT strrI rJ isdirrR rK r r
OSError Exceptionr )r3 r4 r- r5 r6 r\ r8 r7 r9 r] r_
from_pipelinerd rg is_localimage_processor_file resolved_image_processor_fileresolved_processor_filer> processor_dicts r r< -ImageProcessingMixin.get_image_processor_dict s ( JJ{D1 $4e<**Y-
7D)!::&8%@::j$/JJ{B/ #)::.HJ^#_
#3T:
**\59#4 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
*H= =*I'r> c UR 5 nUR SS5 nUR UR 5 VVs0 s H" u pEX@R R
; d M XE_M$ snn5 U " S0 UD6n/ n[
[ UR 5 5 5 H] n[ Xh5 ( d M XR R
; d M0 [ XhUR US5 5 UR U5 M_ U( a& [ R SU R SU S35 [ R SU 35 U( a Xb4$ U$ s snnf )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 rT ) r3 r> r- rv kvri
extra_keysr. s r r= ImageProcessingMixin.from_dict^ s- " 4 8 8 : %zz*@% H ##flln$nndaM]M]MmMmHmTQTn$no 5 45
D /0C,, s r from_json_file#ImageProcessingMixin.from_json_file sG )g
.&;;=D / #zz$ / *)** /
.s A
Ac U R 5 nUR 5 H8 u p#[ U[ R 5 ( d M& UR 5 X' M: [ R " USSS9S- $ )z
Serializes this instance to a JSON string.
Returns:
`str`: String containing all the attributes that make up this feature_extractor instance in JSON format.
T)indent sort_keys
)r r'
isinstancenpndarraytolistr dumps)r,
dictionaryr. r/ s r to_json_string#ImageProcessingMixin.to_json_string s\ \\^
$**,JC%,,"',,.
- zz*Q$?$FFr json_file_pathc [ USSS9 nUR U R 5 5 SSS5 g! , ( d f g= f)z
Save this instance to a JSON file.
Args:
json_file_path (`str` or `os.PathLike`):
Path to the JSON file in which this image_processor instance's parameters will be saved.
wr r N)r writer )r, r writers r rS !ImageProcessingMixin.to_json_file s3 .#
8F LL,,. / 9
8
8s 5
Ac T U R R SU R 5 3$ )N )r r r )r, s r __repr__ ImageProcessingMixin.__repr__ s( ..))*!D,?,?,A+BCCr c [ U[ 5 ( d UR nSSKJs Jn [
X!5 ( d [ U S35 eXl g)aK
Register this class with a given auto class. This should only be used for custom image processors as the ones
in the library are already mapped with `AutoImageProcessor `.
Args:
auto_class (`str` or `type`, *optional*, defaults to `"AutoImageProcessor "`):
The auto class to register this new image processor with.
r Nz is not a valid auto class.) r rj r transformers.models.automodelsautor~
ValueErrorrQ )r3
auto_class auto_modules r register_for_auto_class,ImageProcessingMixin.register_for_auto_class sE *c**#,,J66{//
|+F GH H$r image_url_or_urlsc [ U[ [ 45 ( a! U Vs/ s H o R U5 PM sn$ [ U[ 5 ( a [ U5 $ [
U5 ( a U$ [ S[ U5 35 es snf )z
Convert a single or a list of urls into the corresponding `PIL.Image` objects.
If a single url is passed, the return value will be a single object. If a list is passed a list of objects is
returned.
z=only a single or a list of entries is supported but got type=) r r| tuple fetch_imagesrj r r
TypeErrortype)r, r xs r r !ImageProcessingMixin.fetch_images s '$ 7 72CD2CQ%%a(2CD D
)3
/
/ /0 0
-
.
.$ $ [\`ar\s[t uv v
Es Br )NFFNmain)F)AutoImageProcessor) r r r r r rQ r1 classmethodr r rj rI PathLikeboolr? rY r dictr r< r= r r r rS r r r| r r r r r r r = s
K
/3 $!&#' `=
$
%`='*R[['8`= $t+`= `=
`= TzD
`= `=
`= `=D.-cBKK.? .-d .-` t,,/"++,=t, tCH~tCH~- .t, t,l &#T#s(^ &# &#P
c3h
+sR[['8 + +$
G
G 03+< 0D % %*wcDIoT#Y.O wr rb r zimage processor file)object object_class object_files)$rw r rI typingr r numpyr huggingface_hubr r dynamic_module_utilsr feature_extraction_utilsr BaseBatchFeature image_utilsr
r utilsr r
r r r r utils.hubr r
get_loggerr r* r rB r formatr r r r s 8 4 F 3 # 19OP
H %
# jw> jwZ
$--A-M-M#N ##++7/C/O/O/W/W/^/^ /CRh 0_ 0$$, 8r