9i7SrSSKJr SSKJrJrJrJr SSKrSSK r SSK r SSK J r JrJr SSKJrJr SSKJr S \ R(S \\\44S jr"S S \5rg)aRead/Write TIFF files using tifffile. .. note:: To use this plugin you need to have `tifffile `_ installed:: pip install tifffile This plugin wraps tifffile, a powerful library to manipulate TIFF files. It superseeds our previous tifffile plugin and aims to expose all the features of tifffile. The plugin treats individual TIFF series as ndimages. A series is a sequence of TIFF pages that, when combined describe a meaningful unit, e.g., a volumetric image (where each slice is stored on an individual page) or a multi-color staining picture (where each stain is stored on an individual page). Different TIFF flavors/variants use series in different ways and, as such, the resulting reading behavior may vary depending on the program used while creating a particular TIFF file. Methods ------- .. note:: Check the respective function for a list of supported kwargs and detailed documentation. .. autosummary:: :toctree: TifffilePlugin.read TifffilePlugin.iter TifffilePlugin.write TifffilePlugin.properties TifffilePlugin.metadata Additional methods available inside the :func:`imopen ` context: .. autosummary:: :toctree: TifffilePlugin.iter_pages )BytesIO)AnyDictOptionalcastN) URI_BYTESInitializationErrorRequest)ImagePropertiesPluginV3) ArrayLikepagereturnc0nURSRRUS'URSRnURSRnUSUS- USUS- 4US'U$![a Us$f=f![a U$[a [R "S[ 5 U$f=f) Ni(resolution_unitiir resolutionzPIgnoring resolution metadata because at least one direction has a 0 denominator.)tagsvalueKeyErrorZeroDivisionErrorwarningswarnRuntimeWarning)rmetadata resolution_x resolution_ys [/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/imageio/plugins/tifffile_v3.py_get_resolutionr :sH&*iin&:&:&@&@"#  yy~++ yy~++  Ol1o - Ol1o -"  O-     O      O s)&A8A B 8 BB B?$B?>B?c ^\rSrSrSrS\SS4U4SjjrSSS.S\S \S\R4S jjr S\R4S jr S S .S\ S\ S\\4Sjjr\SSS.S\S \S\ S\\\44SjjrSSS.S\S \S\4SjjrSU4SjjrSSjrSrU=r$)TifffilePluginXaSupport for tifffile as backend. Parameters ---------- request : iio.Request A request object that represents the users intent. It provides a standard interface for a plugin to access the various ImageResources. Check the docs for details. kwargs : Any Additional kwargs are forwarded to tifffile's constructor, i.e. to ``TiffFile`` for reading or ``TiffWriter`` for writing. requestrNc l>[TU]U5 SUlURRS:Xa,[ R "UR540UD6Ulg[ R"UR540UD6Ulg![ R Ra [S5ef=f)Nrz Tifffile can not read this file.) super__init___fhmodeio_modetifffileTiffFileget_file TiffFileErrorr TiffWriter)selfr$kwargs __class__s rr(TifffilePlugin.__init__gs ! <<  3 & N#,,W-=-=-?J6J **7+;+;+=HHDH$$22 N)*LMM Ns *B *B3)indexrr5rc SU;aX#S'OUb [S5eUbSU;a [S5eSU;aURS5nOUbOSnU[La;Uc8[R"UR "S0UD6Vs/sHoDPM sn5nU$U[LaSOUnUR R"SSU0UD6nU$s snf)a#Read a ndimage or page. The ndimage returned depends on the value of both ``index`` and ``page``. ``index`` selects the series to read and ``page`` allows selecting a single page from the selected series. If ``index=None``, ``page`` is understood as a flat index, i.e., the selection ignores individual series inside the file. If both ``index`` and ``page`` are ``None``, then all the series are read and returned as a batch. Parameters ---------- index : int If ``int``, select the ndimage (series) located at that index inside the file and return ``page`` from it. If ``None`` and ``page`` is ``int`` read the page located at that (flat) index inside the file. If ``None`` and ``page=None``, read all ndimages from the file and return them as a batch. page : int If ``None`` return the full selected ndimage. If ``int``, read the page at the selected index and return it. kwargs : Any Additional kwargs are forwarded to TiffFile's ``as_array`` method. Returns ------- ndarray : np.ndarray The decoded ndimage or page. keyNz,Can't use `page` and `key` at the same time.seriesz0Can't use `series` and `index` at the same time.r) ValueErrorpopEllipsisnpstackiterr)asarray)r1r5rr2xndimages rreadTifffilePlugin.readws<   5M  KL L  V!3OP P  JJx(E   E H hh499+>v+>?+>a+>?@G "X-D5Ehh&&>e>v>G @s< B=c+n# URRHnUR"S0UD6v M g7f)zYield ndimages from the TIFF. Parameters ---------- kwargs : Any Additional kwargs are forwarded to the TiffPageSeries' ``as_array`` method. Yields ------ ndimage : np.ndarray A decoded ndimage. Nr9)r)r8r@)r1r2sequences rr?TifffilePlugin.iters-H"",V, ,(s35F)is_batchrBrHc xU(d[R"U5SSS24nUH nURR"U40UD6 M" URR [ :XaRURR5 [[URR55nUR5$g)aSave a ndimage as TIFF. Parameters ---------- ndimage : ArrayLike The ndimage to encode and write to the ImageResource. is_batch : bool If True, the first dimension of the given ndimage is treated as a batch dimension and each element will create a new series. kwargs : Any Additional kwargs are forwarded to TiffWriter's ``write`` method. Returns ------- encoded_image : bytes If the ImageResource is ``""``, return the encoded bytes. Otherwise write returns None. Notes ----- Incremental writing is supported. Subsequent calls to ``write`` will create new series unless ``contiguous=True`` is used, in which case the call to write will append to the current series. N) r=r@r)write_request _uri_typer closerrr.getvalue)r1rBrHr2imagefiles rrJTifffilePlugin.writes:jj)$'2GE HHNN5 +F + == " "i / HHNN !7!7!9:D==? " 0T)r5rexclude_appliedrSc ^U[La*Ub'URRURUnO[U[La*Uc'URRURSnO(U[LaUbURRUnOSn0nUcURRUS'[ R RHn[URSU-5nXuSU-'U(dM,[URUS-5(dML[URUS-5n[U[5(aURUS5 MURU5 M U$URnURURV s0sHoRU R _M sn 5 URUR"UR$UR&SUR(UR*UR,S.[/U5ESUR00E5 U$s sn f)aFormat-Specific TIFF metadata. The metadata returned depends on the value of both ``index`` and ``page``. ``index`` selects a series and ``page`` allows selecting a single page from the selected series. If ``index=Ellipsis``, ``page`` is understood as a flat index, i.e., the selection ignores individual series inside the file. If ``index=Ellipsis`` and ``page=None`` then global (file-level) metadata is returned. Parameters ---------- index : int Select the series of which to extract metadata from. If Ellipsis, treat page as a flat index into the file's pages. page : int If not None, select the page of which to extract metadata from. If None, read series-level metadata or, if ``index=...`` global, file-level metadata. exclude_applied : bool For API compatibility. Currently ignored. Returns ------- metadata : dict A dictionary with information regarding the tiff flavor (file-level) or tiff tags (page-level). Nr byteorderis_ _metadata)planar_configuration compression predictor orientation description1 descriptionsoftwaredatetime)r<r)r8pagesrUr,TIFF FILE_FLAGSgetattrhasattr isinstancetupleupdatekeyframernamer planarconfigrYrZr\r]r^r r_) r1r5rrStargetrflag flag_valueflavor_metadatatags rrTifffilePlugin.metadatas>  T%5XX__U+11$7F ( "t|XX__U+11!4F h 4#3XX^^D)FF >$(HH$6$6H[ ! 00$TXXut|< )3&:'$((D;4F"G"G&-dhh{8J&KO!/599 (:; 81:#__F OOFKKHKSXXsyy0KH I OO,2,?,?#)#5#5!'!1!1#'$*$7$7#)#5#5 & &f-   Is H*c U=(d SnUS[4;aSOUnU[LaURRUnO&URRURUnU[LaaUc^[ URR5n[ U/UR Q7URUS[U5RS5S9nU$U[LagU[La^[ URR5n[ U/UR Q7URUS[U5RS5S9nU$[ UR URS[U5RS5S9nU$)aStandardized metadata. The properties returned depend on the value of both ``index`` and ``page``. ``index`` selects a series and ``page`` allows selecting a single page from the selected series. If ``index=Ellipsis``, ``page`` is understood as a flat index, i.e., the selection ignores individual series inside the file. If ``index=Ellipsis`` and ``page=None`` then global (file-level) properties are returned. If ``index=Ellipsis`` and ``page=...``, file-level properties for the flattened index are returned. Parameters ---------- index : int If ``int``, select the ndimage (series) located at that index inside the file. If ``Ellipsis`` and ``page`` is ``int`` extract the properties of the page located at that (flat) index inside the file. If ``Ellipsis`` and ``page=None``, return the properties for the batch of all ndimages in the file. page : int If ``None`` return the properties of the full ndimage. If ``...`` return the properties of the flattened index. If ``int``, return the properties of the page at the selected index only. Returns ------- image_properties : ImageProperties The standardized metadata (properties) of the selected ndimage or series. rNTr)shapedtypen_imagesrHspacingF)rrrsrHru) r<r)r`r8lenr rrrsr get)r1r5rpage_idx target_pagen_seriespropsn_pagess r propertiesTifffilePlugin.properties5s[> x 001d H ((..2K((//%066x@K H 488??+H#4+"3"34!''!' 488F E0 #h 48#3$((..)G#3!2!23!'' ' 488F E $!''!''' 488F E rRcp>URbURR5 [TU]5 g)N)r)rMr')r1r3s rrMTifffilePlugin.closexs$ 88  HHNN   rRc+# U[LaURRnOURRUnUHnUR"S0UD6v M g7f)aYield pages from a TIFF file. This generator walks over the flat index of the pages inside an ImageResource and yields them in order. Parameters ---------- index : int The index of the series to yield pages from. If Ellipsis, walk over the file's flat index (and ignore individual series). kwargs : Any Additional kwargs are passed to TiffPage's ``as_array`` method. Yields ------ page : np.ndarray A page stored inside the TIFF file. Nr9)r<r)r`r8r@)r1r5r2r`rs r iter_pagesTifffilePlugin.iter_pagessJ* H HHNNEHHOOE*ED,,(( (sAA)r))rN).)__name__ __module__ __qualname____firstlineno____doc__r r(intr=ndarrayrCr?rboolrbytesrJr<rstrrrr r}rMr__static_attributes__ __classcell__)r3s@rr"r"Xs  I Id I $(T4S4s4 4l- -&7<&# &#/3&# %&#R'DRVLL.1LKOL c3hL\*.4A3ASAOAF))rRr")riortypingrrrrrnumpyr=r, core.requestr r r core.v3_plugin_apir r rTiffPagerr r"r9rRrrsZ+Z,,BB:(++S#X