h,B%SSKrSSKrSSKrSSKJrJr SSKJr SSKJ r SSK J r J r J r JrJr SSKrSSKrSSKJr SSKJr SS KJr SS KJrJr SS KJrJrJ r \ (a SSK!r"S S K#J$r$ Sq%\\&\'\(S'\RRS:XaSOSr*\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5\RV"S5/r,\"S S!55r-S"\&\'4S#jr.S$S%S"\/4S&jr0S$S%S"\14S'jr2S(\RfS"\14S)jr4S*\\&\'\&\1\&\Rf\&S%4S"\&\14S+jr5g),N) dataclassfield)BytesIO)Path) TYPE_CHECKINGAnyClassVarOptionalUnion)config)DownloadConfig) array_cast) is_local_pathxopen)first_non_null_valueno_op_if_value_is_nullstring_to_dict) FeatureType_IMAGE_COMPRESSION_FORMATSlittle<>z|b1|u1zu2zi2zu4zi4zf4zf8c \rSrSr%SrSr\\\S'Sr \ \S'\ "SSS9r \\\S 'S r \\\S '\R "\R""5\R$"5S .5r\\\S '\ "SSSS9r\\S'SrS\\\\\\R8S 4S\4SjrSS\SS 4SjjrS\S\\S444SjrS\\R@\RB\RD4S\RB4Sjr#SS\RBS\RB4Sjjr$Sr%g)Image.aImage [`Feature`] to read image data from an image file. Input: The Image feature accepts as input: - A `str`: Absolute path to the image file (i.e. random access is allowed). - A `pathlib.Path`: path to the image file (i.e. random access is allowed). - A `dict` with the keys: - `path`: String with relative path of the image file to the archive file. - `bytes`: Bytes of the image file. This is useful for parquet or webdataset files which embed image files. - An `np.ndarray`: NumPy array representing an image. - A `PIL.Image.Image`: PIL image object. Output: The Image features output data as `PIL.Image.Image` objects. Args: mode (`str`, *optional*): The mode to convert the image to. If `None`, the native mode of the image is used. decode (`bool`, defaults to `True`): Whether to decode the image data. If `False`, returns the underlying dictionary in the format `{"path": image_path, "bytes": image_bytes}`. Examples: ```py >>> from datasets import load_dataset, Image >>> ds = load_dataset("AI-Lab-Makerere/beans", split="train") >>> ds.features["image"] Image(decode=True, id=None) >>> ds[0]["image"] >>> ds = ds.cast_column('image', Image(decode=False)) {'bytes': None, 'path': '/root/.cache/huggingface/datasets/downloads/extracted/b0a21163f78769a2cf11f58dfc767fb458fc7cea5c05dccc0144a2c0f0bc1292/train/healthy/healthy_train.85.jpg'} ``` NmodeTdecodeF)defaultrepridPIL.Image.Imagedtypebytespathpa_type)r!initr"_typecUR$N)r))selfs Q/home/james-whalen/.local/lib/python3.13/site-packages/datasets/features/image.py__call__Image.__call___s ||valuereturncp[R(aSSKnO [S5e[ U[ 5(a[ R"U5n[ U[5(aUSS.$[ U[5(a[UR55SS.$[ U[[45(aSUS.$[ U[ R5(a [U5$[ XRR5(a [!U5$UR#S5b;[$R&R)US5(aSUR#S5S.$UR#S5cUR#S5b#UR#S5UR#S5S.$[+SUS 35e) zEncode example into a format for Arrow. Args: value (`str`, `np.ndarray`, `PIL.Image.Image` or `dict`): Data passed as input to Image feature. Returns: `dict` with "path" and "bytes" fields rN4To support encoding images, please install 'Pillow'.r(r'r(r&r'zUAn image sample should have one of 'path' or 'bytes' but they are missing or None in .)r PIL_AVAILABLE PIL.Image ImportError isinstancelistnparraystrrabsoluter' bytearrayndarrayencode_np_arrayrencode_pil_imagegetosr(isfile ValueError)r.r3PILs r/encode_exampleImage.encode_examplebsX    TU U eT " "HHUOE eS ! !!D1 1 t $ $ 01DA A y1 2 2 51 1 rzz * *"5) ) yy / /#E* * YYv  *rww~~eFm/L/L!599V+<= = YYw  +uyy/@/L"YYw/69JK Kghmgnnop r2cUR(d [S5e[R(a SSKnSSKnO [ S5eUc0nUSUSpTUGc Uc[SUS35e[U5(aURRU5nOURS 5S nUR[R5(a[RO[Rn[!Xx5n U bUR#U S 5OSn [%U S 9n ['US U S9n [)U R+55nSSS5 URRU5nO$URR[)U55nUR-5 UR/5R#URR0R2R45bUR6R9U5nUR:(a5UR:UR::waUR=UR:5nU$!,(df  GN =f)a Decode example image file into image data. Args: value (`str` or `dict`): A string with the absolute image file path, a dictionary with keys: - `path`: String with absolute or relative image file path. - `bytes`: The bytes of the image file. token_per_repo_id (`dict`, *optional*): To access and decode image files from private repositories on the Hub, you can pass a dictionary repo_id (`str`) -> token (`bool` or `str`). Returns: `PIL.Image.Image` zMDecoding is disabled for this feature. Please use Image(decode=True) instead.rNz4To support decoding images, please install 'Pillow'.r(r'zCAn image should have one of 'path' or 'bytes' but both are None in r8::repo_idtokenrbdownload_config)r RuntimeErrorr r9r: PIL.ImageOpsr;rIrropensplit startswith HF_ENDPOINTHUB_DATASETS_URLHUB_DATASETS_HFFS_URLrrFrrrreadloadgetexifExifTagsBase OrientationImageOpsexif_transposerconvert) r.r3token_per_repo_idrJr(bytes_image source_urlpatternsource_url_fieldsrRrUfs r/decode_exampleImage.decode_examples${{no o     TU U  $ " V}eGnf >| #fglfmmn!opp &&IINN40E!%D!1"!5J&001C1CDD//#99 )7z(K%O`Ol)--.? .JKrv'55&AOtT?Kq!(!2LIINN62EIINN76?3E ==?  syy1166BB C OLL//6E 99ejj0MM$)),E LKs &I IrcVSSKJn UR(aU$U"S5U"S5S.$)zfIf in the decodable state, return the feature itself, otherwise flatten the feature into a dictionary.r)Valuebinarystringr&)featuresrqr )r.rqs r/flatten Image.flattens2#{{  xh r2storagec [RRUR5(a%UR [R "55n[RRUR5(ag[R"S/[U5-[R"5S9n[RRX1/SS/UR5S9nGO[RRUR5(ag[R"S/[U5-[R "5S9n[RRX/SS/UR5S9nGO)[RR!UR5(aURR#S5S:aUR%S5nO5[R"S/[U5-[R"5S9nURR#S5S:aUR%S5nO5[R"S/[U5-[R "5S9n[RRX4/SS/UR5S9nO[RR'UR5(a[R"UR)5Vs/sH)oUb"[+[,R"U55SOSPM+ sn[R"5S9n[R"S/[U5-[R "5S9n[RRX4/SS/UR5S9n[/XR05$![R an[SU35UeSnAff=fs snf)aCast an Arrow array to the Image arrow storage type. The Arrow types that can be converted to the Image pyarrow storage type are: - `pa.string()` - it must contain the "path" data - `pa.large_string()` - it must contain the "path" data (will be cast to string if possible) - `pa.binary()` - it must contain the image bytes - `pa.struct({"bytes": pa.binary()})` - `pa.struct({"path": pa.string()})` - `pa.struct({"bytes": pa.binary(), "path": pa.string()})` - order doesn't matter - `pa.list(*)` - it must contain the image array data Args: storage (`Union[pa.StringArray, pa.StructArray, pa.ListArray]`): PyArrow array to cast. Returns: `pa.StructArray`: Array in the Image arrow storage type, that is `pa.struct({"bytes": pa.binary(), "path": pa.string()})`. zvFailed to cast large_string to string for Image feature. This can happen if string values exceed 2GB. Original error: Ntyper'r(maskr)patypesis_large_stringrzcastrs ArrowInvalidrI is_stringr?lenrr StructArray from_arraysis_null is_binary is_structget_field_indexris_list to_pylistrDr>rr))r.rwe bytes_array path_arrayarrs r/ cast_storageImage.cast_storages( 88 # #GLL 1 1 !,,ryy{3 88  gll + +((D6CL#8ryy{KKnn00+1G'SYIZahapapar0sG XX   - -4&3w<"7biikJJnn00'1FRXHY`g`o`o`q0rG XX   - -||++G49%mmG4  hhvG '<299;O ||++F3q8$]]62 XXtfs7|&;"))+N nn00+1JWV\L]dkdsdsdu0vG XX  gll + +((ahararatuatZ]O#/8QUUatuYY[K4&3w<"7biikJJnn00)GV+<;CVCVCX1G'<<00???  ''(c+  0vs$N<90O'<O$OO$c x^Tc0m[U4Sj5n[R"UR5Vs/sHnUbUSc U"US5OUSOSPM sn[R"5S9n[R"UR S5R5Vs/sH&ofb[ RRU5OSPM( sn[R"5S9n[RRXW/SS/UR5S9n[XR5$s snfs snf)aEmbed image files into the Arrow array. Args: storage (`pa.StructArray`): PyArrow array to embed. Returns: `pa.StructArray`: Array in the Image arrow storage type, that is `pa.struct({"bytes": pa.binary(), "path": pa.string()})`. Ncz>URS5SnUR[R5(a[RO[R n[ X5nUbTRUS5OSn[US9n[USUS9nUR5sSSS5 $!,(df  g=f)NrNrOrPrQrSrT) rYrZr r[r\r]rrFrrr^)r(rjrkrlrRrUrmrgs r/ path_to_bytes*Image.embed_storage..path_to_bytessD)"-J+5+@+@ASAS+T+T''Z`ZvZv !/z C K\Kh%))*;I*FGnrE,59OtT?CqvvxDCCs B,, B:r'r(ryr{)rr}r?rrrrrGr(basenamersrrrrr))r.rwrgrxrr(rs ` r/ embed_storageImage.embed_storage s*  $ "     hh!**, ,AUVTaQwZ-?qy)QwZgkk,   XXNUmm\bNcNmNmNo pNod'7RWW  d #T ANo p ..,,k-FRXHY`k`s`s`u,v'<<00  qs %D2'-D7r-)&__name__ __module__ __qualname____firstlineno____doc__rr r@__annotations__r boolrr#r%r r}structrrrsr)rr+r0r r'rBdictr>rCrKrnru StringArrayr ListArrayrr__static_attributes__rr2r/rr.s<%ND(3-FDd7B 7,E8C=,YYbiik'RSGXc]SwU?E3?'E#uirzzSd*d$e'jn'R;D;EV;z  }d3 3E.FFG  61E".."..",,*V$W61\^\j\j61p&1R^^&1PRP^P^&1&1r2rr4cb[R(aSSKnO [S5e[c~UR R 5 [[UR RR55[UR RR55-5q[$)Nrr6) r r9r:r;rrr*r=setOPENkeysSAVE)rJs r/list_image_compression_formatsr6sr PQQ") %)#ciinn.A.A.C*Ds399>>K^K^K`Ga*a%b" %%r2rir$c[5nUR[5;a URnOURS;aSOSnUR XS9 UR 5$)zmConvert a PIL Image object to bytes using native compression if possible, otherwise use PNG/TIFF compression.)1LLARGBRGBAPNGTIFF)format)rrrrsavegetvalue)ribufferrs r/image_to_bytesrCsP YF ||577**(GGV JJvJ% ?? r2c~[US5(aURS:waURSS.$S[U5S.$)Nfilenamer7)hasattrrr)ris r/rErENs9uj!!enn&:66~e'<==r2r?cJ[R(aSSKnO [S5eURnUR S:wa UR O[ nURnURnSnURSS(aQUS;a[SUSUS35e[R"S 5nX&:wa[R"S US US 35 OU[;aUnOUS :aoX4-[U5-n[R"U5[;a4[R"U5n[R"S US US 35 O US-nUS :aMoUc[SUS[35eUR R#UR%U55nS['U5S.$)Nrr6=r )uizUnsupported array dtype z for image encoding. Only z' is supported for multi-channel arrays.rzDowncasting array dtype z to z to be compatible with 'Pillow'rzCannot downcast dtype z- to a valid image dtype. Valid image dtypes: r7)r r9r:r;r% byteorder_NATIVE_BYTEORDERkinditemsizeshape TypeErrorr>warningswarn_VALID_IMAGE_ARRAY_DTPYESr@r fromarrayastyper) r?rJr%dtype_byteorder dtype_kinddtype_itemsize dest_dtype dtype_strris r/rDrDUs PQQ KKE).C)?eooEVOJ^^NJ {{12 Z '*5'1KJ7JJIxx "&??XXi0  8tJ%#8 99r2objsc[R(aSSKnO [S5eU(a[ U5up#[ U[ 5(aUVs/sH o3bUSS.OSPM sn$[ U[R5(a'[[5nUVs/sH o4"U5PM sn$[ X1RR5(a'[[5nUVs/sH o4"U5PM sn$U$U$s snfs snfs snf)zmEncode a list of objects into a format suitable for creating an extension array of type `ImageExtensionType`.rNr6r7) r r9r:r;rr<r@r>rCrrDrrE)rrJ_objobj_to_image_dict_funcs r/objects_to_list_of_image_dictsrsPQQ %d+ c3  Y]^Y]RUOS40MY]^ ^ c2:: & &%;O%L ";?@4C*3/4@ @ YY__ - -%;D&D)6rGsysr dataclassesrriorpathlibrtypingrrr r r numpyr>pyarrowr}rr download.download_configrtablerutils.file_utilsrrutils.py_utilsrrrr:rJrtrrr=r@rrrr%rrrr'rrrErCrDrrr2r/rs (@@53YY%37HT#Y/6==H4C#HHUOHHUOHHUOHHUOHHUOHHUOHHUOHHUOHHUOHHUOHHUOHHUOHHUOHHUO$ D1D1 D1N &S &+>->$>(:2::(:$(:V S 4:tBJJ'7>O9PP Q $Zr2