+ ?i7Rt^RIHt^RIHtHtHtHt^RIt^RI t ^RI t ^RI H t HtHt^RIHtHt^RIHtRRlt!R R ]4tR#) 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) ArrayLikecfV^8dQhR\PR\\\3,/#)pagereturn)tifffileTiffPagerstrr)formats"Y/var/www/html/photoedit/myenv/lib/python3.14/site-packages/imageio/plugins/tifffile_v3.py __annotate__r:s((++S#Xc/pVPR,PPVR&TPR,PpTPR,PpT^,T^,, T^,T^,, 3TR&T# \dTu#i;i \dT#\d \P !R\ 4T#i;i)i(resolution_unitii resolutionzPIgnoring resolution metadata because at least one direction has a 0 denominator.)tagsvalueKeyErrorZeroDivisionErrorwarningswarnRuntimeWarning)rmetadata resolution_x resolution_ys& r_get_resolutionr%:sH&*iin&:&:&@&@"#  yy~++ yy~++  Ol1o - Ol1o -"  O-     O      O s/*BA+B/ B,+B,/ C&=C&C&%C&caa]tRt^XtoRtV3RlV3RlltRRRR/V3RlRlltV3R lR ltR R /V3R lRlltR] RRRR/V3RlRllt RRRR/V3RlRllt V3RlV3Rllt RRlt RtVtV;t#)TifffilePluginaSupport 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. c$<V^8dQhRS[RR/#)rrequestrN)r )r __classdict__s"rrTifffilePlugin.__annotate__gs I I Id Irc t<\SV`V4RVnVPPR8Xd.\ P !VP43/VBVnR#\ P!VP43/VBVnR# \ P Pd \R4hi;i)Nrz Tifffile can not read this file.) super__init___fhmodeio_moderTiffFileget_file TiffFileErrorr TiffWriter)selfr)kwargs __class__s&&,rr/TifffilePlugin.__init__gs ! <<  3 & N#,,W-=-=-?J6J **7+;+;+=HHDH$$22 N)*LMM Ns *B +B7indexNrc@<V^8dQhRS[RS[RS[P/#rr;rr)intnpndarray)rr*s"rrr+ws&44S4s4 4rc RV9dW#R&MVe \R4hVeRV9d \R4hRV9dVPR4pMVeM^pV\Jd<Vf8\P!VP !R/VBUu.uFqDNK up4pV#V\JdRMTpVP P!RRV/VBpV#uupi)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.) ValueErrorpopEllipsisr?stackiterr0asarray)r7r;rr8xndimages&$$, rreadTifffilePlugin.readws<   5M  KL L  V!3OP P  JJx(E   E H hh499+>v+>?+>a+>?@G "X-D5Ehh&&>e>v>G @s Cc4<V^8dQhRS[P/#)rr)r?r@)rr*s"rrr+s-- -rc+ p"VPPFpVP!R/VBxK R#5i)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. NrD)r0rCrJ)r7r8sequences&, rrITifffilePlugin.iters-H"",V, ,(s46is_batchFc<<V^8dQhRS[RS[RS[S[,/#)rrLrSr)r boolrbytes)rr*s"rrr+s)&#&# &#/3&# %&#rc ~V'g\P!V4R,pVF pVPP!V3/VBK" VPP \ 8XdSVPP4\\VPP44pVP4#R#)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)N:NNN) r?rJr0write_request _uri_typercloserrr4getvalue)r7rLrSr8imagefiles&&$, rrXTifffilePlugin.writes:jj)'2GE HHNN5 +F + == " "i / HHNN !7!7!9:D==? " 0rexclude_appliedTc H<V^8dQhRS[RS[RS[RS[S[S[3,/#)rr;rr`r)r>rUrrr)rr*s"rrr+s;LLL.1LKOL c3hLrc V\Jd4Ve0VPPV,PV,pMkV\Jd4Vf0VPPV,P^,pM.V\Jd#VeVPPV,pMRp/pVfVPPVR&\ P PFp\VPRV,4pWuRV,&V'gK5\VPVR,4'gKZ\VPVR,4p\V\4'dVPV^,4KVPV4K V#VPpTPVPU u/uFqPV P bK up 4VPRVP"RVP$RVP&RRR VP(R VP*R VP,/\/V4CR VP0/C4V#uup i) 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). N byteorderis_ _metadataplanar_configuration compression predictor orientation description1 descriptionsoftwaredatetime)rGr0rCpagesrcrTIFF FILE_FLAGSgetattrhasattr isinstancetupleupdatekeyframernamer planarconfigrgrhrjrkrlr%rm) r7r;rr`targetr"flag flag_valueflavor_metadatatags &$$$ rr"TifffilePlugin.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*F,?,?!6#5#5!1!1!4"F$7$7!6#5#5 &f-   IsI!c,<V^8dQhRS[RS[RS[/#r=)r>r )rr*s"rrr+5s'AA3ASAOArc  *T;'g^pVR\39d^MTpV\JdVPPV,pM.VPPV,PV,pV\JdfVfb\ VPP4p\ V.VP O5VPVR\V4PR4R7pV#V\JdlV\Jdb\ VPP4p\ V.VP O5VPVR\V4PR4R7pV#\ VP VPR\V4PR4R7pV#)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. NTr)shapedtypen_imagesrSspacingF)rrrSr) rGr0rnrClenr rrr%get)r7r;rpage_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 rc<V^8dQhRR/#)rrNrD)rr*s"rrr+xstrct<VPeVPP4\SV`4R#)N)r0r[r.)r7r9s&rr[TifffilePlugin.closexs$ 88  HHNN   rc+ "V\JdVPPpMVPPV,pVFpVP!R/VBxK R#5i)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. NrD)rGr0rnrCrJ)r7r;r8rnrs&&, r iter_pagesTifffilePlugin.iter_pagessJ* H HHNNEHHOOE*ED,,(( (sAA )r0).)__name__ __module__ __qualname____firstlineno____doc__r/rMrIrXrGr"rr[r__static_attributes____classdictcell__ __classcell__)r9r*s@@rr'r'Xs  I I 444T44l--$&#6;&#&#PL&L48LRVLL\AA4AAF))rr')riortypingrrrrrnumpyr?r core.requestrrr core.v3_plugin_apir r r r%r'rDrrrs>+Z,,BB: