<j(%SrSSKJr Sr/SQrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK r SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJrJrJrJr SSKJr SSKJr SS KJr SS K J!r! SS K"J#r# SSK$r$SSK%r%SSK)J*r*J+r+J,r,J-r-J.r.J/r/J0r0 \+(a*SSKJ1r1J2r2J3r3 SSK4J5r5 SSK)J6r6J7r7J8r8 SSK9J:r:J;r;Jr> SSS47 r?SSS47 r@SSS47 rASSS47 rB0rCS\DS'\/GSKSSSSSSSSSSSSSSSSSSSSSSS SSSSSSSSSSS.!GSLSjjj5rE\/GSKSSSSSSSSSSSSSSSSSSSSSSS SSSSSSSSSSS.!GSMS jjj5rE\/GSKSSSSSSSSSSSSSSSSSSSSSSSS SSSSSSSSSSS!."GSNS"jjj5rEGSKSSS#SSSSSSSSSSSSSSSSSSSSSS SSSSSSSSSSS$.#GSOS%jjjrEGSKSSSSS#SSS#SSSSSS#SSSSSSSSSSSSSSSS\CSS#S#SSSS#S&.&GSPS'jjjrFSSSSSSSS(S).GSQS*jjrG"S+S,\H5rI\."S-S.55rJ\."S/S055rK\."S1S255rL\."S3S455rM\."S5S655rN\."S7S8\\M\N-55rO\."S9S:55rP\."S;S<55rQ\."S=S>55rR"S?S@\\M\N-S-5rS\."SASB\\S55rT"SCSD\\U5rV\."SESF\V55rW\."SGSH55rX\."SISJ55rY\."SKSL55rZ\."SMSN\\[55r\\."SOSP55r]\."SQSR55r^"SSST\_5r`\."SUSV55ra\."SWSX\\[\SY\b4455rc\."SZS[\\[\SY\b4455rd"S\S]\R5rf"S^S_\R5rg"S`Sa\R5rh"SbSc\R5ri"SdSe\R5rk"SfSg\R5rl"ShSi\R5rm"SjSk\R5rn"SlSm\R5ro"SnSo\R5rp"SpSq\R5rq"SrSs\R5rr"StSu\R5rs"SvSw5rt\t"5ru0SxSy_SzSy_S{Sy_S|S}_S~S}_SS}_SS}_SS}_SS}_SS_SS_SS_SS_SS_SS_SS_SS_SS0ErvS\DS'GSRSjrwGSRSjrxGSRSjryGSRSjrzGSRSjr{GSRSjr|GSRSjr}GSRSjr~GSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrGSRSjrSSS.GSSSjjrGSTSjrGSTSjrGSTSjrGSUSjrGSVSjrGSWSjrGSWSjrGSXSjrGSTSjrGSWSjrGSYGSZSjjrGS[SjrGS[SjrGS[SjrGS\SjrGS]SjrGSTSjrGS^SjrGS^SjrGS^SjrGS^SjrGS_SjrGS]SjrGS]SjrGS]SjrGSTSjrGSTSjrGSTSjrGSTSjrGSTSjrGSTSjrGS`SjrGSKGSaSjjrGSbSjrGScSjrGSdSjrGSeSjrGSfSjrGSgSjrGSKSS#S.GShSjjjrSSS.GSiSjjrGSjSjrGSkSjrGSlSjrGSmSjrGSgSjrGSKGSnSjjrGSgSjrGSgSjrGSoSjrGSgSjrGSpSjrGSqSjrGSrSjrGSsGStSjjrGSuSjrGSvSjrGSwSS.GSxSjjjrSS.GSySjjrGSzSS.GS{SjjjrGS|SjrGS}SjrGS~SjrGSSjrGSSjrGSSjr\/GSSj5r\/GSSj5rGSSjr\/GSKGSSjj5r\/GSKGSSjj5rGSKGSSjjrGSKGSSjjr\/GSKGSSjj5r\/GSKGSSjj5rGSKGSSjjrS#S.GSSjjrGSGSjr\/GSGSGSjj5r\/GSGSGSjj5rGSGSGSjjrS#SGS.GSGSjjrSSSSGS.GSGSjjrGS SSGS .GSGS jjrGSGS jrGSKGSGS jjr\/GSwGSGSjj5r\/GSwGSGSjj5rGSwGSGSjjrGSKGSGSjjrGSGSjrGSGSjrGSGSGSjjrGSGSjrGSGSjrGSGSjrGSGSjrGSGSjrGSGSjrGSGSGSjjrGSYGSGSjjr\GRGS:XaGSOGSrS\DGS 'GSGS!jrGSGS"jrGSGSGS#jjrGSGS$jrSSGS%GS&.GSGS'jjrGS(GS)GS*GSSGS+.GSGS,jjrGSGS-jrS#GS..GSGS/jjrGSGS0jrGSGS1jrGS)GS2GS3SGS4.GSGS5jjrGSSSGS6.GSGS7jjjrGSGS8jrGSGS9jrGSGS:jrGSGS;jrGSGS<jrGSGS=jrGSwGSGS>jjrGSzGSGS?jjGrSSSSSSSSSSSGS@. GSGSAjjGrGSKSSGSB.GSGSCjjjGrSSSSSSSSSSSSGSDSSS#GSE.GSGSFjjGrGSGSGjGrGSKGSGSHjjGr\KGr\+(aS GSIGKGJGrGJ Gr GJ Gr G\ GSJ:Xa\GR"G\"55 gg!\&a S S K'J(r% GN6!\&a SSK(r%GNDf=ff=f(uqRead and write TIFF files. Tifffile is a comprehensive Python library to (1) store NumPy arrays in TIFF (Tagged Image File Format) files, and (2) read image and metadata from TIFF-like files used in bioimaging. Image and metadata can be read from TIFF, BigTIFF, OME-TIFF, GeoTIFF, Adobe DNG, ZIF (Zoomable Image File Format), MetaMorph STK, Zeiss LSM, ImageJ hyperstack, Micro-Manager MMStack and NDTiff, SGI, NIHImage, Olympus FluoView and SIS, ScanImage, Molecular Dynamics GEL, Aperio SVS, Leica SCN, Roche BIF, PerkinElmer QPTIFF (QPI, PKI), Hamamatsu NDPI, Argos AVS, Philips DP, and ThermoFisher EER formatted files. Image data can be read as NumPy arrays or Zarr arrays/groups from strips, tiles, pages (IFDs), SubIFDs, higher-order series, and pyramidal levels. Image data can be written to TIFF, BigTIFF, OME-TIFF, and ImageJ hyperstack compatible files in multi-page, volumetric, pyramidal, memory-mappable, tiled, predicted, or compressed form. Many compression schemes, predictors, and data types are supported via the imagecodecs library, including LZW, PackBits, Deflate, CCITT, PIXTIFF, LZMA, LERC, Zstd, JPEG (8 and 12-bit, lossless), JPEG 2000, JPEG XR, JPEG XL, WebP, PNG, EER, Jetraw, 24-bit floating-point, packed integers, and horizontal differencing. Tifffile can also be used to inspect TIFF structures, read image data from multi-dimensional file sequences, write fsspec ReferenceFileSystem for TIFF files and image file sequences, patch TIFF tag values, and parse many proprietary metadata formats. :Author: `Christoph Gohlke `_ :License: BSD-3-Clause :Version: 2026.5.2 :DOI: `10.5281/zenodo.6795860 `_ Quickstart ---------- Install the tifffile package and all dependencies from the `Python Package Index `_:: python -m pip install -U tifffile[all] Tifffile is also available in other package repositories such as Anaconda, Debian, and MSYS2. The tifffile library is type annotated and documented via docstrings:: python -c "import tifffile; help(tifffile)" Tifffile can be used as a console script to inspect and preview TIFF files:: python -m tifffile --help See `Examples`_ for using the programming interface. Source code and support are available on `GitHub `_. Support is also provided on the `image.sc `_ forum. Requirements ------------ This revision was tested with the following requirements and dependencies (other versions may work): - `CPython `_ 3.12.10, 3.13.13, 3.14.4 64-bit - `NumPy `_ 2.4.4 - `Imagecodecs `_ 2026.3.6 (required for encoding or decoding LZW, JPEG, etc. compressed segments) - `Xarray `_ 2026.4.0 (required only for reading xarray DataArrays) - `Matplotlib `_ 3.10.9 (required for plotting) - `Lxml `_ 6.1.0 (required only for validating and printing XML) - `Zarr `_ 3.2.0 (required only for using Zarr stores) - `Kerchunk `_ 0.2.10 (required only for opening ReferenceFileSystem files) Revisions --------- 2026.5.2 - Change TiffFile.series from list to callable TiffSeries sequence (breaking). - Remove TiffPageSeries squeeze dual-state (breaking). - Remove TiffPageSeries.get_shape, get_axes, and get_coords (breaking). - Remove ZarrTiffStore squeeze parameter (breaking). - Update ZarrTiffStore to zarr format 3 and multiscales to NGFF 0.5 (breaking). - Update multiscales zarr format 2 fsspec files to NGFF 0.4 (breaking). - Remove generic TiffPage coords (breaking). - Change dims and sizes to use single-char axis codes (breaking). - Add zarr format 3 compatible Tiff codec. - Add asxarray methods to TiffFile, TiffPage, TiffPageSeries (requires xarray). - Add geotiff kind of TiffPageSeries. - Add mpp and coord_offsets/scales/units properties to TiffPageSeries. - Add attrs property to TiffPage and TiffPageSeries. - Add kind and squeeze parameters to memmap. - Add kind parameter to imwrite and TiffFile; deprecate ome, imagej, shaped. - Add return_as parameter to imread; deprecate aszarr. - Fix writing TIFF trees (#326). - Fix wrong TiffTagRegistry entries (#323). - Implement TiffPageSeries.coords property. - Deprecate kwargs to FileSequence.asarray; use imreadargs. - Require zarr>=3.2.0 for zarr support. - Drop support for numpy 2.0 (SPEC0, #324). 2026.4.11 - Add option to write zarr format 3 fsspec reference file system. - Support reading TIFF with embedded C2PA manifest. - Sync API of imagecodecs fallback implementations (#320). - Do not use defusedxml. - Drop support for Python 3.11. 2026.3.3 - Do not convert TVIPS pixel sizes to m (#319). - Support writing packed integers with imagecodecs > 2026.1.14. - Support reading ccitt compressed images with imagecodecs > 2026.1.14. 2026.2.24 - Remove deprecated TiffPages.pages and FileSequence.files (breaking). - Remove stripnull, stripascii, and bytestr functions (breaking). - Rewrite command line interfaces (breaking). - Support Experimenter and Project elements in OmeXml. - Refactor TiffPages. - Fix code review issues. 2026.2.20 - Fix rounding of high resolutions (#318). - Fix code review issues. 2026.2.16 - Optimize reading multi-file pyramidal OME TIFF files. 2026.2.15 - Support reading multi-file pyramidal OME TIFF files (image.sc/t/119259). 2026.1.28 - Deprecate colormaped parameter in imagej_description (use colormapped). - Fix code review issues. 2026.1.14 - … Refer to the CHANGES file for older revisions. Notes ----- TIFF, the Tagged Image File Format, was created by the Aldus Corporation and Adobe Systems Incorporated. Tifffile supports a large subset of the TIFF6 specification, mainly 1-32, and 64-bit integer, 16, 32, and 64-bit float, grayscale and multi-sample images. Specifically, OJPEG compression, chroma subsampling without JPEG compression, color space transformations, samples with differing types, or IPTC, ICC, and XMP metadata are not implemented. Besides classic TIFF, tifffile supports several TIFF-like formats that do not strictly adhere to the TIFF6 specification. Some formats extend TIFF capabilities in various ways, including exceeding the 4 GB limit, handling multi-dimensional data, or working around format constraints: - **BigTIFF** is identified by version number 43 and uses different file header, IFD, and tag structures with 64-bit offsets. The format also adds 64-bit data types. Tifffile can read and write BigTIFF files. - **ImageJ hyperstacks** store all image data, which may exceed 4 GB, contiguously after the first IFD. Files > 4 GB contain one IFD only. The size and shape of the up to 6-dimensional image data can be determined from the ImageDescription tag of the first IFD, which is Latin-1 encoded. Tifffile can read and write ImageJ hyperstacks. - **OME-TIFF** files store up to 8-dimensional image data in one or multiple TIFF or BigTIFF files. The UTF-8 encoded OME-XML metadata found in the ImageDescription tag of the first IFD defines the position of TIFF IFDs in the high-dimensional image data. Tifffile can read OME-TIFF files and write NumPy arrays to single-file OME-TIFF. - **Micro-Manager NDTiff** stores multi-dimensional image data in one or more classic TIFF files. Metadata contained in a separate NDTiff.index binary file defines the position of the TIFF IFDs in the image array. Each TIFF file also contains metadata in a non-TIFF binary structure at offset 8. Downsampled image data of pyramidal datasets are stored in separate folders. Tifffile can read NDTiff files. Version 0 and 1 series, tiling, stitching, and multi-resolution pyramids are not supported. - **Micro-Manager MMStack** stores 6-dimensional image data in one or more classic TIFF files. Metadata contained in non-TIFF binary structures and JSON strings define the image stack dimensions and the position of the image frame data in the file and the image stack. The TIFF structures and metadata are often corrupted or wrong. Tifffile can read MMStack files. - **Carl Zeiss LSM** files store all IFDs below 4 GB and wrap around 32-bit StripOffsets pointing to image data above 4 GB. The StripOffsets of each series and position require separate unwrapping. The StripByteCounts tag contains the number of bytes for the uncompressed data. Tifffile can read LSM files of any size. - **MetaMorph STK** files contain additional image planes stored contiguously after the image data of the first page. The total number of planes is equal to the count of the UIC2 tag. Tifffile can read STK files. - **ZIF**, the Zoomable Image File format, is a subspecification of BigTIFF with SGI's ImageDepth extension and additional compression schemes. Only little-endian, tiled, interleaved, 8-bit per sample images with JPEG, PNG, JPEG XR, and JPEG 2000 compression are allowed. Tifffile can read and write ZIF files. - **Hamamatsu NDPI** files use some 64-bit offsets in the file header, IFD, and tag structures. Single, LONG typed tag values can exceed 32-bit. The high bytes of 64-bit tag values and offsets are stored after IFD structures. Tifffile can read NDPI files > 4 GB. JPEG compressed segments with dimensions >65530 or missing restart markers cannot be decoded with common JPEG libraries. Tifffile works around this limitation by separately decoding the MCUs between restart markers, which performs poorly. BitsPerSample, SamplesPerPixel, and PhotometricInterpretation tags may contain wrong values, which can be corrected using the value of tag 65441. - **Philips TIFF** slides store padded ImageWidth and ImageLength tag values for tiled pages. The values can be corrected using the DICOM_PIXEL_SPACING attributes of the XML formatted description of the first page. Tile offsets and byte counts may be 0. Tifffile can read Philips slides. - **Ventana/Roche BIF** slides store tiles and metadata in a BigTIFF container. Tiles may overlap and require stitching based on the TileJointInfo elements in the XMP tag. Volumetric scans are stored using the ImageDepth extension. Tifffile can read BIF and decode individual tiles but does not perform stitching. - **ScanImage** optionally allows corrupted non-BigTIFF files > 2 GB. The values of StripOffsets and StripByteCounts can be recovered using the constant differences of the offsets of IFD and tag values throughout the file. Tifffile can read such files if the image data are stored contiguously in each page. - **GeoTIFF sparse** files allow strip or tile offsets and byte counts to be 0. Such segments are implicitly set to 0 or the NODATA value on reading. Tifffile can read GeoTIFF sparse files. - **Tifffile shaped** files store the array shape and user-provided metadata of multi-dimensional image series in JSON format in the ImageDescription tag of the first page of the series. The format allows multiple series, SubIFDs, sparse segments with zero offset and byte count, and truncated series, where only the first page of a series is present, and the image data are stored contiguously. No other software besides Tifffile supports the truncated format. Other libraries for reading, writing, inspecting, or manipulating scientific TIFF files from Python are `bioio `_, `aicsimageio `_, `apeer-ometiff-library `_, `bigtiff `_, `fabio.TiffIO `_, `GDAL `_, `imread `_, `large_image `_, `openslide-python `_, `opentile `_, `pylibtiff `_, `pylsm `_, `pymimage `_, `python-bioformats `_, `pytiff `_, `scanimagetiffreader-python `_, `SimpleITK `_, `slideio `_, `tiffslide `_, `tifftools `_, `tyf `_, `xtiff `_, and `ndtiff `_. References ---------- - TIFF 6.0 Specification and Supplements. Adobe Systems Incorporated. https://www.adobe.io/open/standards/TIFF.html https://download.osgeo.org/libtiff/doc/ - TIFF File Format FAQ. https://www.awaresystems.be/imaging/tiff/faq.html - The BigTIFF File Format. https://www.awaresystems.be/imaging/tiff/bigtiff.html - MetaMorph Stack (STK) Image File Format. http://mdc.custhelp.com/app/answers/detail/a_id/18862 - Image File Format Description LSM 5/7 Release 6.0 (ZEN 2010). Carl Zeiss MicroImaging GmbH. BioSciences. May 10, 2011 - The OME-TIFF format. https://docs.openmicroscopy.org/ome-model/latest/ - UltraQuant(r) Version 6.0 for Windows Start-Up Guide. http://www.ultralum.com/images%20ultralum/pdf/UQStart%20Up%20Guide.pdf - Micro-Manager File Formats. https://micro-manager.org/wiki/Micro-Manager_File_Formats - ScanImage BigTiff Specification. https://docs.scanimage.org/Appendix/ScanImage+BigTiff+Specification.html - ZIF, the Zoomable Image File format. https://zif.photo/ - GeoTIFF File Format. https://gdal.org/drivers/raster/gtiff.html - Cloud optimized GeoTIFF. https://github.com/cogeotiff/cog-spec/blob/master/spec.md - Tags for TIFF and Related Specifications. Digital Preservation. https://www.loc.gov/preservation/digital/formats/content/tiff_tags.shtml - CIPA DC-008-2016: Exchangeable image file format for digital still cameras: Exif Version 2.31. http://www.cipa.jp/std/documents/e/DC-008-Translation-2016-E.pdf - The EER (Electron Event Representation) file format. https://github.com/fei-company/EerReaderLib - Digital Negative (DNG) Specification. Version 1.7.1.0, September 2023. https://helpx.adobe.com/content/dam/help/en/photoshop/pdf/DNG_Spec_1_7_1_0.pdf - Roche Digital Pathology. BIF image file format for digital pathology. https://diagnostics.roche.com/content/dam/diagnostics/Blueprint/en/pdf/rmd/Roche-Digital-Pathology-BIF-Whitepaper.pdf - Astro-TIFF specification. https://astro-tiff.sourceforge.io/ - Aperio Technologies, Inc. Digital Slides and Third-Party Data Interchange. Aperio_Digital_Slides_and_Third-party_data_interchange.pdf - PerkinElmer image format. https://downloads.openmicroscopy.org/images/Vectra-QPTIFF/perkinelmer/PKI_Image%20Format.docx - NDTiffStorage. https://github.com/micro-manager/NDTiffStorage - Argos AVS File Format. https://github.com/user-attachments/files/15580286/ARGOS.AVS.File.Format.pdf Examples -------- Write a NumPy array to a single-page RGB TIFF file: >>> import numpy >>> data = numpy.random.randint(0, 255, (256, 256, 3), 'uint8') >>> imwrite('temp.tif', data, photometric='rgb') Read the image from the TIFF file as NumPy array: >>> image = imread('temp.tif') >>> image.shape (256, 256, 3) Use the ``photometric`` and ``planarconfig`` arguments to write a 3x3x3 NumPy array to an interleaved RGB, a planar RGB, or a 3-page grayscale TIFF: >>> data = numpy.random.randint(0, 255, (3, 3, 3), 'uint8') >>> imwrite('temp.tif', data, photometric='rgb') >>> imwrite('temp.tif', data, photometric='rgb', planarconfig='separate') >>> imwrite('temp.tif', data, photometric='minisblack') Use the ``extrasamples`` argument to specify how extra components are interpreted, for example, for an RGBA image with unassociated alpha channel: >>> data = numpy.random.randint(0, 255, (256, 256, 4), 'uint8') >>> imwrite('temp.tif', data, photometric='rgb', extrasamples=['unassalpha']) Write a 3-dimensional NumPy array to a multi-page, 16-bit grayscale TIFF file: >>> data = numpy.random.randint(0, 2**12, (64, 301, 219), 'uint16') >>> imwrite('temp.tif', data, photometric='minisblack') Read the whole image stack from the multi-page TIFF file as NumPy array: >>> image_stack = imread('temp.tif') >>> image_stack.shape (64, 301, 219) >>> image_stack.dtype dtype('uint16') Read the image from the first page in the TIFF file as NumPy array: >>> image = imread('temp.tif', key=0) >>> image.shape (301, 219) Read images from a selected range of pages: >>> images = imread('temp.tif', key=range(4, 40, 2)) >>> images.shape (18, 301, 219) Iterate over all pages in the TIFF file and successively read images: >>> with TiffFile('temp.tif') as tif: ... for page in tif.pages: ... image = page.asarray() ... Get information about the image stack in the TIFF file without reading any image data: >>> tif = TiffFile('temp.tif') >>> len(tif.pages) # number of pages in the file 64 >>> page = tif.pages[0] # get shape and dtype of image in first page >>> page.shape (301, 219) >>> page.dtype dtype('uint16') >>> page.axes 'YX' >>> series = tif.series[0] # get shape and dtype of first image series >>> series.shape (64, 301, 219) >>> series.dtype dtype('uint16') >>> series.axes 'QYX' >>> tif.close() Inspect the "XResolution" tag from the first page in the TIFF file: >>> with TiffFile('temp.tif') as tif: ... tag = tif.pages[0].tags['XResolution'] ... >>> tag.value (1, 1) >>> tag.name 'XResolution' >>> tag.code 282 >>> tag.count 1 >>> tag.dtype Iterate over all tags in the TIFF file: >>> with TiffFile('temp.tif') as tif: ... for page in tif.pages: ... for tag in page.tags: ... tag_name, tag_value = tag.name, tag.value ... Overwrite the value of an existing tag, for example, XResolution: >>> with TiffFile('temp.tif', mode='r+') as tif: ... _ = tif.pages[0].tags['XResolution'].overwrite((96000, 1000)) ... Write a 5-dimensional floating-point array using BigTIFF format, separate color components, tiling, Zlib compression level 8, horizontal differencing predictor, and additional metadata: >>> data = numpy.random.rand(2, 5, 3, 301, 219).astype('float32') >>> imwrite( ... 'temp.tif', ... data, ... bigtiff=True, ... photometric='rgb', ... planarconfig='separate', ... tile=(32, 32), ... compression='zlib', ... compressionargs={'level': 8}, ... predictor=True, ... metadata={'axes': 'TZCYX'}, ... ) Write a 10 fps time series of volumes with xyz voxel size 2.6755x2.6755x3.9474 micron^3 to an ImageJ hyperstack formatted TIFF file: >>> volume = numpy.random.randn(6, 57, 256, 256).astype('float32') >>> image_labels = [f'{i}' for i in range(volume.shape[0] * volume.shape[1])] >>> imwrite( ... 'temp.tif', ... volume, ... kind='imagej', ... resolution=(1.0 / 2.6755, 1.0 / 2.6755), ... metadata={ ... 'spacing': 3.947368, ... 'unit': 'um', ... 'finterval': 1 / 10, ... 'fps': 10.0, ... 'axes': 'TZYX', ... 'Labels': image_labels, ... }, ... ) Read the volume and metadata from the ImageJ hyperstack file as xarray DataArray: >>> with TiffFile('temp.tif') as tif: ... volume = tif.asxarray() ... imagej_metadata = tif.imagej_metadata ... >>> volume Size: 90MB array([[[[...]]]], shape=(6, 57, 256, 256), dtype=float32) Coordinates: * T (T) float64 48B 0.0 0.1 0.2 0.3 0.4 0.5 * Z (Z) float64 456B 0.0 3.947 ... 221.1 * Y (Y) float32 1kB 0.0 2.675 ... 682.3 * X (X) float32 1kB 0.0 2.675 ... 682.3 Attributes: photometric: minisblack mode: grayscale ... >>> imagej_metadata['slices'] 57 >>> imagej_metadata['frames'] 6 Memory-map the contiguous image data in the ImageJ hyperstack file: >>> memmap_volume = memmap('temp.tif') >>> memmap_volume.shape (6, 57, 256, 256) >>> del memmap_volume Create a TIFF file containing an empty image and write to the memory-mapped NumPy array (note: this does not work with compression or tiling): >>> memmap_image = memmap( ... 'temp.tif', shape=(256, 256, 3), dtype='float32', photometric='rgb' ... ) >>> type(memmap_image) >>> memmap_image[255, 255, 1] = 1.0 >>> memmap_image.flush() >>> del memmap_image Write two NumPy arrays to a multi-series TIFF file (note: other TIFF readers will not recognize the two series; use the OME-TIFF format for better interoperability): >>> series0 = numpy.random.randint(0, 255, (32, 32, 3), 'uint8') >>> series1 = numpy.random.randint(0, 255, (4, 256, 256), 'uint16') >>> with TiffWriter('temp.tif') as tif: ... tif.write(series0, photometric='rgb') ... tif.write(series1, photometric='minisblack') ... Read the second image series from the TIFF file: >>> series1 = imread('temp.tif', series=1) >>> series1.shape (4, 256, 256) Successively write the frames of one contiguous series to a TIFF file: >>> data = numpy.random.randint(0, 255, (30, 301, 219), 'uint8') >>> with TiffWriter('temp.tif') as tif: ... for frame in data: ... tif.write(frame, contiguous=True) ... Append an image series to the existing TIFF file (note: this does not work with ImageJ hyperstack or OME-TIFF files): >>> data = numpy.random.randint(0, 255, (301, 219, 3), 'uint8') >>> imwrite('temp.tif', data, photometric='rgb', append=True) Create a TIFF file from a generator of tiles: >>> data = numpy.random.randint(0, 2**12, (31, 33, 3), 'uint16') >>> def tiles(data, tileshape): ... for y in range(0, data.shape[0], tileshape[0]): ... for x in range(0, data.shape[1], tileshape[1]): ... yield data[y : y + tileshape[0], x : x + tileshape[1]] ... >>> imwrite( ... 'temp.tif', ... tiles(data, (16, 16)), ... tile=(16, 16), ... shape=data.shape, ... dtype=data.dtype, ... photometric='rgb', ... ) Write a multi-dimensional, multi-resolution (pyramidal), multi-series OME-TIFF file with optional metadata. Sub-resolution images are written to SubIFDs. Limit parallel encoding to 2 threads. Write a thumbnail image as a separate image series: >>> data = numpy.random.randint(0, 255, (8, 2, 512, 512, 3), 'uint8') >>> subresolutions = 2 >>> pixelsize = 0.29 # micrometer >>> with TiffWriter('temp.ome.tif', bigtiff=True) as tif: ... metadata = { ... 'axes': 'TCYXS', ... 'SignificantBits': 8, ... 'TimeIncrement': 0.1, ... 'TimeIncrementUnit': 's', ... 'PhysicalSizeX': pixelsize, ... 'PhysicalSizeXUnit': 'µm', ... 'PhysicalSizeY': pixelsize, ... 'PhysicalSizeYUnit': 'µm', ... 'Channel': {'Name': ['Channel 1', 'Channel 2']}, ... 'Plane': {'PositionX': [0.0] * 16, 'PositionXUnit': ['µm'] * 16}, ... 'Description': 'A multi-dimensional, multi-resolution image', ... 'MapAnnotation': { # for OMERO ... 'Namespace': 'openmicroscopy.org/PyramidResolution', ... '1': '256 256', ... '2': '128 128', ... }, ... } ... options = dict( ... photometric='rgb', ... tile=(128, 128), ... compression='jpeg', ... resolutionunit='CENTIMETER', ... maxworkers=2, ... ) ... tif.write( ... data, ... subifds=subresolutions, ... resolution=(1e4 / pixelsize, 1e4 / pixelsize), ... metadata=metadata, ... **options, ... ) ... # write pyramid levels to the two subifds ... # in production use resampling to generate sub-resolution images ... for level in range(subresolutions): ... mag = 2 ** (level + 1) ... tif.write( ... data[..., ::mag, ::mag, :], ... subfiletype=1, # FILETYPE.REDUCEDIMAGE ... resolution=(1e4 / mag / pixelsize, 1e4 / mag / pixelsize), ... **options, ... ) ... # add a thumbnail image as a separate series ... # it is recognized by QuPath as an associated image ... thumbnail = (data[0, 0, ::8, ::8] >> 2).astype('uint8') ... tif.write(thumbnail, metadata={'Name': 'thumbnail'}) ... Access image levels in the pyramidal OME-TIFF file: >>> baseimage = imread('temp.ome.tif') >>> second_level = imread('temp.ome.tif', series=0, level=1) >>> with TiffFile('temp.ome.tif') as tif: ... series = tif.series[0] ... assert series.kind == 'ome' ... assert series.sizes == {'T': 8, 'C': 2, 'Y': 512, 'X': 512, 'S': 3} ... baseimage = series.asarray() ... second_level = series.levels[1].asarray() ... number_levels = len(series.levels) # includes base level ... Read image data from a generic kind of series, ignoring OME metadata: >>> with TiffFile('temp.ome.tif') as tif: ... series = tif.series(kind='generic')[0] ... assert series.kind == 'generic' ... assert series.sizes == {'I': 16, 'Y': 512, 'X': 512, 'S': 3} ... image = series.asarray() ... Iterate over and decode single JPEG compressed tiles in the TIFF file: >>> with TiffFile('temp.ome.tif') as tif: ... fh = tif.filehandle ... for page in tif.pages: ... for index, (offset, bytecount) in enumerate( ... zip(page.dataoffsets, page.databytecounts) ... ): ... _ = fh.seek(offset) ... data = fh.read(bytecount) ... tile, indices, shape = page.decode( ... data, index, jpegtables=page.jpegtables ... ) ... Use Zarr to read parts of the tiled, pyramidal images in the TIFF file: >>> import zarr >>> store = imread('temp.ome.tif', return_as='zarr') >>> z = zarr.open(store, mode='r') >>> z >>> z['0'] # base layer >>> z['0'][2, 0, 128:384, 256:].shape # read a tile from the base layer (256, 256, 3) >>> store.close() Load the base layer from the Zarr store as a dask array: >>> import dask.array >>> store = imread('temp.ome.tif', return_as='zarr') >>> dask.array.from_zarr(store, '0') dask.array<...shape=(8, 2, 512, 512, 3)...chunksize=(1, 1, 128, 128, 3)... >>> store.close() Write the Zarr store to a fsspec ReferenceFileSystem in JSON format: >>> store = imread('temp.ome.tif', return_as='zarr') >>> store.write_fsspec('temp.ome.tif.json', url='file://', zarr_format=2) >>> store.close() Open the fsspec ReferenceFileSystem as a Zarr group and read the first layer: >>> from kerchunk.utils import refs_as_store >>> import imagecodecs.numcodecs >>> imagecodecs.numcodecs.register_codecs(verbose=False) >>> z = zarr.open(refs_as_store('temp.ome.tif.json'), mode='r') >>> z['1'] # first layer /1 shape=(8, 2, 256, 256, 3) ...> Create an OME-TIFF file containing an empty, tiled image series and write to it via the Zarr interface (note: this does not work with compression): >>> imwrite( ... 'temp2.ome.tif', ... shape=(8, 800, 600), ... dtype='uint16', ... photometric='minisblack', ... tile=(128, 128), ... metadata={'axes': 'CYX'}, ... ) >>> store = imread('temp2.ome.tif', mode='r+', return_as='zarr') >>> z = zarr.open(store, mode='r+') >>> z >>> z[3, 100:200, 200:300:2] = 1024 >>> store.close() Read images from a sequence of TIFF files as NumPy array using two I/O worker threads: >>> imwrite('temp_C001T001.tif', numpy.random.rand(64, 64)) >>> imwrite('temp_C001T002.tif', numpy.random.rand(64, 64)) >>> image_sequence = imread( ... ['temp_C001T001.tif', 'temp_C001T002.tif'], ioworkers=2, maxworkers=1 ... ) >>> image_sequence.shape (2, 64, 64) >>> image_sequence.dtype dtype('float64') Read an image stack from a series of TIFF files with a file name pattern as NumPy or Zarr arrays: >>> image_sequence = TiffSequence('temp_C0*.tif', pattern=r'_(C)(\d+)(T)(\d+)') >>> image_sequence.shape (1, 2) >>> image_sequence.axes 'CT' >>> data = image_sequence.asarray() >>> data.shape (1, 2, 64, 64) >>> store = image_sequence.aszarr() >>> zarr.open(store, mode='r', ioworkers=2, maxworkers=1) >>> image_sequence.close() Write the Zarr store to a fsspec ReferenceFileSystem in JSON format: >>> store = image_sequence.aszarr() >>> store.write_fsspec('temp.json', url='file://') Open the fsspec ReferenceFileSystem as a Zarr array: >>> from kerchunk.utils import refs_as_store >>> import tifffile.numcodecs >>> tifffile.numcodecs.register_codec() >>> zarr.open(refs_as_store('temp.json'), mode='r') shape=(1, 2, 64, 64) ...> Inspect the TIFF file from the command line:: $ python -m tifffile temp.ome.tif ) annotationsz2026.5.2)L CHUNKMODE COMPRESSIONDATATYPE EXTRASAMPLEFILETYPE FILLORDER OFILETYPE ORIENTATION PHOTOMETRIC PLANARCONFIG PREDICTORRESUNIT SAMPLEFORMATTIFF_TIFF FileCache FileHandle FileSequence NullContextOmeXml OmeXmlError StoredShapeTiffFile TiffFileError TiffFormat TiffFrameTiffPageTiffPageSeries TiffPages TiffReader TiffSequence TiffSeriesTiffTagTiffTagRegistryTiffTags TiffWriter TiledSequenceTimer __version__askopenfilenameastype create_outputenumargenumstr format_sizehexdumpimagej_descriptionimagej_metadata_tagimreadimshowimwriteloggerlsm2bin matlabstr2pymemmapnatural_sortednullfuncparse_filenames parse_kwargspformatproductrationalread_gdal_structural_metadataread_micromanager_metadataread_ndtiff_indexread_scanimage_metadata repeat_nd reshape_axes reshape_ndstrptime tiff2fsspec tiffcommenttranspose_axes update_kwargsvalidate_jhovexml2dictN)CallableIterableMappingSequence)ThreadPoolExecutor)datetime) timedelta)Fraction)cached_property _imagecodecs)IO TYPE_CHECKINGClassVarcastfinaloverloadoverride) Collection ContainerIterator) TracebackType)AnyLiteralSelf) ArrayLike DTypeLikeNDArray DataArray ByteOrderc[S$)N><)rhb/root/GenerationalWealth/GenerationalWealth/venv/lib/python3.13/site-packages/tifffile/tifffile.pyroros ""ru OutputTypecL[[[-[[-S-$N)strr\bytesrlrgrtrurvrwrws#5 /GCL0477ruTagTuplech[[[-[[-[S-[[4$ry)tupleintrzrgboolrtrurvr|r|s#cCisC$JTABBru DecodeResultc[[[S-[[[[[[4[[[[[44$ry)r~rlrgrrtrurvrrsCE CL4 #sCc !" #sC rudict[str, Any]METADATA_DEFAULT)! selectionkeyserieskindlevelsqueeze maxworkers buffersizemodenameoffsetsizepattern axesorder categoriesr4 imreadargssort container chunkshape chunkdtype axestiled ioworkers chunkmode fillvaluezattrs multiscalesomexmlsuperresout out_inplace _multifile _useframesc" gryrt$filesr return_asrrrrrrrrrrrrrrr4rrrrrrrrrrrrrrrrrkwargss$ rvr4r4s\ruc" gryrtrs$ rvr4r4s\-0ru)"rrrrrrrrrrrrrrrrr4rrrrrrrrrrrrrrrrrc" gryrtrs$ rvr4r4s\ruF)#rraszarrrrrrrrrrrrrrrrr4rrrrrrrrrrrrrrrrrc# PUS:XaSnUS:Hn%U%(aUb Sn&[U&5eU=(d USLnU%(aU(a Sn&[U&5e[U$/SU$5Q76n'Uc-U$(a&SS RS U$55-n&[ U&5eSn(UGc[ U[ 5(a$S U;dS U;aUn([R"U5nU(d S n&[U&5e[ U[5(a)[ U[ 5(d[U5S:XaUSn[ U[ 5(d[ U[5(d[U4U U U UUUU"U#S.U'D6n)U%(aCUb"[ U[5(d Sn&[U&5eU)RUUUUUU U S9sSSS5 $U(acUb"[ U[5(d Sn&[U&5eU)RUUUUUU U UUUUS9 n*Uc U*sSSS5 $SSKJn+ U+"U*UU S9sSSS5 $U)R!UUUUUU U U S9sSSS5 $O[#US5(a Sn&[U&5e[%S UUUUUU U UU"U#S. U'DU$D6n,U(bU(nU%(a Sn&[U&5e['U4UUUUUS.[%US9D6n-U(a?U-R"S UUUUUUUS.U,D6n*Uc U*sSSS5 $SSKJn+ U+"U*UU S9sSSS5 $U-R "S UUUUU!U S.U,D6sSSS5 $!,(df  N=f!,(df  g=f)!a Return image from TIFF file(s) as NumPy array or Zarr store. The first image series in the file(s) is returned by default. Parameters: files: File name, seekable binary stream, glob pattern, or sequence of file names. May be ``None`` if ``container`` is specified. selection: Subset of image to be extracted. If not ``None``, a Zarr array is created internally, indexed with the ``selection`` value, and returned as a NumPy array (not a store). Only segments that are part of the selection will be read from file. Refer to the Zarr documentation for valid selections. Depending on selection size, image size, and storage properties, it may be more efficient to read the whole image from file and then index it. return_as: Return type of image data. If ``'xarray'``, return as :py:class:`xarray.DataArray`. Cannot be combined with ``selection``. Not supported for file sequences. If ``'zarr'``, return as Zarr store. When ``selection`` is not ``None``, a Zarr store is used internally regardless of this value, but a NumPy array is returned. If ``'numpy'`` or ``None`` (default), return as NumPy array. aszarr: Deprecated: use ``return_as='zarr'``. mode, name, offset, size, superres, omexml, _multifile, _useframes: Passed to :py:class:`TiffFile`. key, series, kind, level, squeeze, maxworkers, buffersize: Passed to :py:meth:`TiffFile.asarray`, :py:meth:`TiffFile.asxarray`, or :py:meth:`TiffFile.aszarr`. When ``return_as='zarr'`` or ``return_as='xarray'`` and reading a single file, ``key`` must be ``None`` or an integer. imread, container, sort, pattern, axesorder, axestiled, categories: Passed to :py:class:`FileSequence`. chunkmode, fillvalue, zattrs, multiscales: Passed to :py:class:`ZarrTiffStore` or :py:class:`ZarrFileSequenceStore`. chunkshape, chunkdtype, ioworkers: Passed to :py:meth:`FileSequence.asarray` or :py:class:`ZarrFileSequenceStore`. out_inplace: Passed to :py:meth:`FileSequence.asarray`. out: Passed to :py:meth:`TiffFile.asarray`, :py:meth:`FileSequence.asarray`, or :py:func:`zarr_selection`. imreadargs: Additional arguments passed to :py:attr:`FileSequence.imread`. **kwargs: Additional arguments passed to :py:class:`TiffFile` or :py:attr:`FileSequence.imread`. Returns: Images from specified files, series, or pages. Zarr store instances must be closed after use. See :py:meth:`TiffPage.asarray` for operations that are applied (or not) to the image data stored in the file. Raises: ValueError: No files matching the pattern were found. Binary IO streams are not supported with ``container``. ``key`` is not ``None`` or an integer when ``return_as='zarr'`` or ``return_as='xarray'``. ``return_as='xarray'`` and ``aszarr`` are both set. NotImplementedError: ``return_as='xarray'`` and a file sequence is used. ``return_as='xarray'`` and ``selection`` are both specified. TypeError: Unexpected keyword arguments were passed. zarrTxarrayNz*asxarray with selection is not implementedz*asxarray and aszarr are mutually exclusivec3:# UHoSSS:XdM Uv M g7f)Nis_rt).0ks rv imread..s%JARa5E>aas  z*imread() got unexpected keyword arguments , c3.# UH nSUS3v M g7f)'Nrt)rrs rvrrsG "(3auAJ&*?no files foundrYr)rrrrrrrrz.asxarray requires key to be None or an integerrrrrrrz,aszarr requires key to be None or an integer) rrrrrrrrrrr)zarr_selectionr)rrrrrrrrreadzBinaryIO not supported) rrrrrrrrrrz,asxarray is not supported for file sequences)rrrrrr4)rrrrrrr)rrrrrrrt)NotImplementedError ValueErrorr>join TypeError isinstancerzglobrSlenrrasxarrayrrrasarrayhasattrkwargs_notnoner").rrrrrrrrrrrrrrrrrrr4rrrrrrrrrrrrrrrrrrrmsgis_flags glob_patterntifstorer imread_kwargsimseqs. rvr4r49sxFH$HI):!#&&  . -FF:oFK%J%JKH ~&:TYYG "(G >  n#L eS ! !se|se| LIIe$E"CS/ ! uh ' 'uc**E a!HE eS ! !E8)D)D !%%  z#s/C/CN(o-<<%!# '#-#-(!  2z#s/C/CL(o-JJ%!# '#-#-"+"+%$/' E!($W  Z5)%D_  b{{!#))# c  *Ez   &o"        M<!#&&        '   LL ##%%##   E +  . -!%<3  4}} !!#   5  o  n  s8 AL+A L> LL&L L$L L L%)&rbigtiff byteorderrimagejomeshapedappendshapedtype photometric planarconfig extrasamples volumetrictile rowsperstrip bitspersample compressioncompressionargs predictor subsampling jpegtables iccprofilecolormap descriptionrU resolutionresolutionunit subfiletypesoftwaremetadata extratags contiguoustruncatealignrr returnoffsetc& Uc\U bU c Sn([U(5e[R"U 5n [U 5n [ U 5U R -n)Uc U R nO&URn)UcURR nUc9U)S:=(a- US:H=(d U(+=(a U#(+=(a US;n[UUUUU UUUUS9 n*U*R"U40SU _S U _S U _S U _S U_S U_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU _SU!_S U"_S!U#_S"U$_S#U%_S$U&_S%U'_6sSSS5 $![a Sn)Nf=f!,(df  g=f)&a/Write array or image data to TIFF file. A BigTIFF file is written if the data size is larger than 4 GB less 32 MB for metadata, and ``bigtiff`` is not ``False``, and ``imagej``, ``truncate`` and ``compression`` are not enabled. Unless ``byteorder`` is specified, the TIFF file byte order is determined from the dtype of ``data`` or the ``dtype`` argument. Parameters: file: Passed to :py:class:`TiffWriter`. data: Image data to write. May be a NumPy array, an iterator of arrays, an iterator of encoded bytes, an iterator of ``(bytes, bytecount)`` tuples, or ``None`` to write an empty file. If ``None``, ``shape`` and ``dtype`` are required. shape: Shape of empty array when ``data`` is ``None``. Otherwise passed to :py:meth:`TiffWriter.write`. dtype: Data type of empty array when ``data`` is ``None``. Otherwise passed to :py:meth:`TiffWriter.write`. mode, append, byteorder, bigtiff, kind, imagej, ome, shaped: Passed to :py:class:`TiffWriter`. photometric, planarconfig, extrasamples, volumetric, tile, rowsperstrip, bitspersample, compression, compressionargs, predictor, subsampling, jpegtables, iccprofile, colormap, description, datetime, resolution, resolutionunit, subfiletype, software, metadata, extratags, maxworkers, buffersize, contiguous, truncate, align: Passed to :py:meth:`TiffWriter.write`. returnoffset: Return offset and number of bytes of memory-mappable image data in file. Returns: If ``returnoffset`` is ``True`` and the image data in the file are memory-mappable, a tuple of ``(offset, bytecount)``. Otherwise ``None``. Raises: ValueError: ``data`` is ``None`` and ``shape`` or ``dtype`` is not provided. Nz,missing required 'shape' or 'dtype' argumentrl|r>NNONENonenonerrYrrrrrrrrrrrrrrrrrrrrrrrrrrUrrrrrrrrrrrr) rnumpyrr~r@itemsizernbytesAttributeErrorr'write)+filedatarrrrrrrrrrrrrrrrrrrrrrrrrrUrrrrrrrrrrrrrdatasizers+ rvr6r6TsRF | =EM@CS/ ! E"e 5>ENN2  I {{H  JJ00  } $ DX%/0 D  DCC       yy       $  &  &  "    &  (  $  ,     $  "  "!  "#  $$%  &'  (")  **+  ,$-  ./  01  2 3  4"5  67  89  :";  <"=  >&?     H   s!%EA+E EE E(r+)rrpagerrrrrc p[R"U5nUb [U5nUbzUbw[R"U5nSU ;aUR U S5nU R SUUU[RSS9 [U40U D6n U c Sn [U 5eU Sn SnGOX[U40U D6n UcUcSnUcSnU RU5UnU(dUc#URS:waU RUSS 9UnURUnURc Sn [U 5eUR nURnURn OzU R"UnUR$(d Sn [U 5eUR&Sn UbU(a UR O UR(nURnUc Sn [U 5e[R"U R*UR,-5nSSS5 UbUc Sn [U 5e[R."XUW US 5$!,(df  N;=f) aReturn memory-mapped NumPy array of image data stored in TIFF file. Memory-mapping requires the image data to be stored in native byte order, without tiling, compression, predictors, etc. If both ``shape`` and ``dtype`` are provided, a new TIFF file is created (overwriting or appending depending on the ``append`` keyword argument) and the image data region is memory-mapped read-write. Otherwise, the image data of a specified page or series in an existing file are memory-mapped. Call ``flush`` to write any changes in the array back to the file. Parameters: filename: Name of TIFF file to create or memory-map. shape: Shape of array to create. Requires ``dtype``. If provided together with ``dtype``, a new TIFF file is written. dtype: Data type of array to create. Requires ``shape``. page: Index of page whose image data to memory-map. If provided, ``series``, ``kind``, and ``level`` are ignored. series: Index of page series to memory-map (default is 0). Ignored if ``page`` is set. kind: Series format kind, such as ``'ome'`` or ``'imagej'``. By default, the format is auto-detected. Ignored if ``page`` is set. level: Index of pyramid level to memory-map (default is 0). Ignored if ``page`` is set. squeeze: Remove length-1 dimensions from the memory-mapped array shape, except X and Y. If ``False``, preserve all dimensions. If ``None`` (default), remove length-1 dimensions except for ``'shaped'`` series. For single pages, ``None`` is treated as ``True``. mode: Memory-map file open mode for existing files. The default is 'r+' (read-write). Use 'r' for read-only or 'c' for copy-on-write. When creating a new file (``shape`` and ``dtype`` provided), this argument is ignored and the file is always opened read-write. **kwargs: Additional arguments passed to :py:func:`imwrite` when creating a new file, or to :py:class:`TiffFile` when reading an existing file. Returns: Image data in TIFF file as memory-mapped NumPy array. Raises: ValueError: Image data in TIFF file are not memory-mappable. NrT)rrrrrrz"image data are not memory-mappablerrrrC)osfspathr~rr newbyteorderupdaterALLOCATIONGRANULARITYr6rr _get_seriesrlevels dataoffsetrpagesis_memmappable dataoffsetsrrcharr:)filenamerrrrrrrrrresultrrrs tiffseriestiffpages rvr:r:s1Nyy"H e  U. E" & &&vk':;E ,,  ,V, >6CS/ !h )& )S|>F=EOOD)&1w166X3Ed;FCAXXe_ ((0>C$S/)"(("((#..99T?..>C$S/)!--a0 7NN! !=>C$S/)KK  :;E?*@ } 2o <<vuc BBG* )s .EH'' H5c\rSrSrSrSrg)riz-Exception to indicate invalid TIFF structure.rtN__name__ __module__ __qualname____firstlineno____doc____static_attributes__rtrurvrrs7rurc!\rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S \S 'S \S'S\S'S\S'S\S'S\S'S\S'S\S'S\S'S\S'S\S'S \S!'S \S"'S \S#'S \S$'S%\S&'S%\S''S \S('S)\S*'S+S,S+S,S+S,S+S+S-.S>S.jjrS?S+S+S+S+S+S,S+S+S+S+S+S+S+S+S+S+S+S+S+S+S+S+S+\S+S,S,S+S+S+S,S/.S@S0jjjrSAS1jr SBS2jr \ SCS3j5r SBS4jr SBS5jrSDSES6jjrSFS7jrSGS8jr\SHS9j5rSIS:jrSJS;jrSKS<jrS=rg+)Lr'iaWrite arrays and image data to TIFF file. TiffWriter's main purpose is to save multi-dimensional NumPy arrays in TIFF containers, not to create any possible TIFF format. Specifically, ExifIFD and GPSIFD tags are not supported. TiffWriter instances must be closed with :py:meth:`TiffWriter.close`, which is automatically called when using the 'with' context manager. TiffWriter instances are not thread-safe. All attributes are read-only. Parameters: file: Specifies file to write. mode: Binary file open mode if ``file`` is a file name. The default is 'w', which opens files for writing, truncating existing files. 'x' opens files for exclusive creation, failing on existing files. 'r+' opens files for updating, enabling ``append``. bigtiff: Write 64-bit BigTIFF formatted file, which can exceed 4 GB. By default, a classic 32-bit TIFF file is written, which is limited to 4 GB. If ``append`` is ``True``, the format of the existing file is used. Using BigTIFF with ``kind='imagej'`` produces a non-conformant file and raises a UserWarning. byteorder: Endianness of TIFF format. One of '<', '>', '=', or '|'. The default is the system's native byte order. append: If ``file`` is an existing standard TIFF file, append image data and tags to the file. Pass ``'force'`` to append to files containing metadata (such as OME-TIFF), which may corrupt the existing metadata. Parameters ``bigtiff`` and ``byteorder`` are set from the existing file. Appending does not scale well with the number of pages already in the file and may corrupt specifically formatted TIFF files such as OME-TIFF, LSM, STK, ImageJ, or FluoView. kind: Kind of TIFF file to write. If ``'ome'``, write OME-TIFF compatible file. By default, the OME-TIFF format is used if the file name extension contains '.ome.' and ``description`` is not specified in the first call to :py:meth:`TiffWriter.write`. The format supports multiple image series up to 9 dimensions. The default axes order is TZC(S)YX(S). Refer to the OME model for restrictions of this format. If ``'imagej'``, write ImageJ hyperstack compatible file. This format handles data types uint8, uint16, or float32 and shapes up to 6 dimensions in TZCYXS order. RGB images (S=3 or S=4) must be ``uint8``. ImageJ hyperstacks do not support BigTIFF or compression. The ImageJ file format is undocumented. If ``'shaped'``, write tifffile "shaped" TIFF file. The image shape is stored in JSON format in an ImageDescription tag of the first page of a series. Suppresses auto-detection of OME-TIFF format from the file name extension. This is the default format used by tifffile if the file name extension does not contain '.ome.' and ``metadata=None`` is not passed to :py:meth:`TiffWriter.write`. If ``'generic'``, write generic TIFF file without extra metadata. Image series written to generic TIFF may not be recoverable. If ``None`` (default), ``'shaped'`` is used unless the file name extension contains '.ome.', in which case ``'ome'`` is used. imagej: Deprecated. Use ``kind='imagej'`` instead. ome: Deprecated. Use ``kind='ome'`` instead. shaped: Deprecated. Use ``kind='shaped'`` or ``kind='generic'`` instead. Raises: ValueError: The file contains metadata and cannot be appended to without ``append='force'``. ``mode`` is not 'r+' when ``append`` is ``True``. ``byteorder`` is not a valid byte order character. rtiffr_fhz OmeXml | None_omexml bool | None_omer_imagej _tifffile _truncatedict[str, Any] | None _metadataNDArray[numpy.uint16] | None _colormapz)list[tuple[int, bytes, Any, bool]] | None_tagstuple[int, ...] | None _datashapenumpy.dtype[Any] | None _datadtype int | None _dataoffsetlist[int] | None_databytecounts_dataoffsetstagTiffTag | None_descriptiontagr _ifdoffset_subifds _subifds_tree _subifdslevel list[int]_subifdsoffsets_nextifdoffsets _ifdindexzStoredShape | None _storedshapeNFrcn US;d%[U[5(aURS:XaSnSnU(a[USSS9n U R5n [ U 5n US:waU R (d S n [ U 5eU RnU Rn[[U RR5Ul SSS5 U RU 5 SnSSS5 U(aUS ;a S n [ U 5eSnOUcS nUbUS;a["RS:XaSOSnOUS;aSU<3n [ U 5eUS:Xa-U(a[$R&O[$R(UlO,U(a[$R,O[$R.UlS UlSUlSUlSUlSUlSUlSUlSUlSUl SUl!SUl"SUl#SUl$/Ul%/Ul&SUl'SUl(SUl)[XSS9Ul*U(a+URTRS[VRX5 OURTR[US:XaSOS5 U(a6URTR[[\R^"US-SSS55 O3URTR[[\R^"US-S55 URTR5Ul URTR[[\R^"UR*R`S55 U=S:Xa SnS nS n O?=S:Xa SnS nS n O1=S:Xa S nS nSn O#=S:Xa S nS nS n OcOS U<3n [ U 5eUcSO [cU5Ul2URd(aS O [cU5Ul3URf(aS Ul2URd(dURf(aS Ul4OU cSO [cU 5Ul4U(a'U(a[jRl"U<S!3[nS"S#9 ggg!,(df  GN=f!U RU 5 f=f!,(df  GN=f![[ 4a S nGNf=f)$N>rr+brDrTrbr)rrforcez)cannot append to file containing metadataF>NrrDzappend mode must be 'r+'w>=|littlersrr>rsrrzinvalid byteorder=IIMMHHH+H*rrrgenericz invalid kind=z% writing nonconformant BigTIFF ImageJ stacklevel)8rr_modetellr is_appendablerr is_bigtiffr_rrnext_page_offsetr:seekOSErrorFileNotFoundErrorsysrBIG_LE CLASSIC_LEr"BIG_BE CLASSIC_BEr)r+r-r.r0r2r4r6r7r9r;r<r=r?r@rAr$rBr#rSEEK_ENDrstructpack offsetformatrr&r'r(warningswarn UserWarning)selfrrrrrrrrrfhposrrs rv__init__TiffWriter.__init__s = tZ ( (TZZ5-@DF  4a8B'')C %%b\S%09J9J$O!$'1o 5(+ I&)nnG.2 #SYY%?%?/DO* !F!9( ..0 o%D \D   Z 7"}}8cI j ('YL)CS/ !  '. DOODI'. DOODI ### !!!  dA6  HHMM!R[[ ) HHNNI$45% @v{{9u+S:aUR@ceURBceUR<RD"SPUR2UR0SS:wa UR0OUR0SSUR@R"S.URBD6 O3Ub0URG5 U+RIS[JRL5 URN(aURP(dU(a Sn-[ U-5eU=R>S- slUR>URN:Xa+/Ul)/Ul*SUlSUl'SUl+SUl,OU(a Sn-[ U-5eSUlSUlOU (dU4(dU(a Sn-[ U-5eUR0SS-/U.Q7UlU+R[5n5U"cU+R]U25 OU+R_U"U/5 U (aU5U24$gUR`cUcSU+Rb;Ul0OSUl0URd(dUR:(a[/U5Ul(OU(a S n-[ U-5eSUl(URP(a"U (dU4(dU(a S!n-[ U-5eU2S:Xa S"n.[fRh"U<S#3[jS$S%9 URRln6URRnn7URRpn8URRrn9[tRvn:[tRxn;[tRzn<[tR|n=[tR~n>[Rn?[Rn@Ub[[tU5nU(a[[U5nUb0[ S&[-U[ [45(aUOU455nU (ab[-U [5(aU R5n U S':XaSn O[-U [.5(aSn [[U 5RnASn OSnASn U c0n WAS:Xa0n O6WAS(;aSU S)'O*WAS*:Xa$U RS+S5 U RS,S5 U ceU (Ga U (d S-n-[ U-5eWA[R;aS.[WA5<3n-[ U-5e[-U [.5(aGU/RS/:XaS0nBOU/RS1;aU/R*S2::aS$nBOS.U/<3n-[ U-5e[[U 5n U/RS1;a U RS3;aU/R*S2::d U/RS/:Xa%U RS4;aS5U <S6U/<3n-[ U-5eU RnBOSnBA [RWBn)UR`(aUb [fRh"U<S73[jS$S%9 SnUR<c#Uc[5UlO[SP0UD6UlU(dU(a[U5S$:a S8n-[ U-5eSnGO1UR:(GaUb [fRh"U<S93[jS$S%9 SnU/R&S:;aS;U/R&<3n-[ U-5eU(dU(a[U5S$:a S3n-[ U-5eSnCUbSnCUcSOURS?5nD[U.WCUDS@9nEUW@:Xa SAn-[ U-5eWESSB;aUnOU:nSnWC(aU?OSnUGb[R"UU,S-S9nUUlUR:(aUR"SC:wa SDn-[ U-5eU/R&S=:Xa UU:U;1;aU>nGOU/R&S=:XaUU>:Xd>U/R&SE;aUU:U;1;d&[fRh"U<SFU/SGU<3[jS$S%9 SnOUcDU/R&SH;a4U>nSnUR"S0S$U/R*S--4:wa SIn-[ U-5eO{UU>:XaOSnU/R&SH;a SJn-[ U-5eUR"S0S$U/R*S--4:wa SIn-[ U-5eO&[fRh"U<SKU/SGU<3[jS$S%9 SnU(aS[U5s=:aS2:a4O O1USSL-(d$USSL-(d[%SMU55(aSNU3n-[ U-5e[ SOU55nU(a[U5S$:XaS/UQ7n[U5S0:HnO SPn[/U5n[-U[ 5(de[U.[RRUS$55n[U5nFU(aWFS0:aSnUGcSnGU:nU0(aU;nOUU?:Xa!WFS$:aUSSB;aU:Xa3U!RS:wdU!RS:aSnU!<So3n-[ U-5eO1U!RWI:a!SpU<SqWISrU!R3n-[ U-5eUb$U!RU:waU<SsU!<3n-[ U-5eAU"bU"RU!R"5n"/nLU(aStnMSunNOSvnMSwnNWNUleURnOURnPUcSPnUb WP"WLSxS$SUS5 U(d0OUR5Ul!UR<b+[UR<R5S:XaSynGOS:aURN(a URNnO([US5(a [U5nO [U5nUS:a U*nSUl+UUl'WP"WLSU8S2:aSOSURV(aUOSS/URV(aUOS-5 U0(dHU/RSk:wa8SS$S0SS.U/RnTWP"WLSS0U!RUT4U!R-5 UbWP"WLSS0URU5 UbWP"WLSS[U5U5 WP"WLSS0SU!R5 U0(a'U!RS:aWP"WLSS0SU!R5 OWU!RS:a;WP"WLSS0SU!R5 UP"ULSS0U!RU 4U!R-5 O WP"WLSS0SU 5 U!RS:aUbUU!R[U5:wa&SU!RS[U53n-[ U-5eWP"WLSS0[U5U5 OFUU<:XaU!RS:Xa WP"WLSS0SS$5 O#WP"WLSS0U!RSU!R-5 UbWP"WLSS[U5U5 WAS:XGaU!RS:XGaUUU (aWlU 4SSjjn*O&WAS:aWln*OSn*OU4(aU We4SSjjn*OSn*A U(dWf(dU*bSnfU(aq/UQU!RP7nm[)Um5U/R*-nnG[GRUWXU!R-UnWA5nG[!UXU!R-U#U*UmU/UUS5n#OxG[GRUW]U!R-W`WA5nG[#U#U!GR$U/U 5n#G[!U]U!R-U#U*U U!RU!R4U/UUS5n#U+R[5noSnpG[ U(aSO U!R5G H+nqWonrUrS$-(aU+GR'S5 WrS- nrUR>S:a5U+RIUGR(5 U+GR'WO"U7Wr55 U+RIWr5 WqS$:Ga Sn'G[*GR,"5nsUsGR'WO"U6[WL555 UsR[5ntUsGR'SGR/SUL555 UsR[5nuUsGR'UO"U7S55 G[1UL5GH*unvnwWtUvU9--S2-U8-n5UwSnxUwS$nyUy(Ga<WsR[5n(U(S$-(aWsGR'S5 U(S- n(WsRIU55 UsGR'WO"U7WrU(-55 UsRIU(5 UsGR'Wy5 WxWN:XaU5U(4n%MWxWM:XaU5U(4n&MWxSx:XaURb}URGR2S:Xa_WyGR5URR5(a1WrWt-WvU9--URlUrU(-URlGMJGMMGMPGMSWxS:XaU5U(4n'GM`GMcWxWN:XaU5S4n%GMpWxWM:XaU5S4n&GM}WxSx:XaURbURGR2S:XalURRWwSSQS;aIWrWt-WvU9--URlURGR2U8-S2-URlGMGMGMGMWxS:XdGM&U5S4n'GM- WsR[5nzUzS$-(aWsGR'S5 WzS- nzU+RIWz[JGR85 U+R[5npUcSLnUWpU-- U-n{U+RIU{[JGR85 UpU{- npU(aU#bSn|Wf(a U#HnhW|U+GR'Uh5- n|AhM OPU!RU/R*-n}U#H1nhUhcW|U+R]W}5- n|OW|U+R_WhU/5- n|AhM3 W|U2:waSW|SU23n-[ U-5eGO"U"cU+R]U25 GO U+R_U"U/5 GOWg(aU#ceS/U(aWXOW]-n$Wpn5G[ U(aWXOW]5HXn~[[ [[4G[;U#55unhniUiWYU~'U5U$U~'U5[Uh5- n5U+GR'Uh5 AhMZ GOhWf(a^U#ceG[ U(aWXOW]5H>n~[[G[;U#55nh[Uh5WYU~'U+GR'Uh5 AhM@ GOU(aU#ce/UQU!RP7nm[)Um5U/R*-nnG[ WX5HnG[;U#5nhUhcSWYW'M[GR<"WhU/5nhUhGR>Wn:wa\WhGR>Wn:a Sn-[ U-5e[ SG[AWmWhR"SS955n[GRB"UhU5nhU+R_Wh5 AhM O Sn-[U-5eU%ceU%un5n(WsRIU55 U(bWsGR'WO"U7WrU(-55 UsRIU(5 U$c2Wpn5WYH)nWsGR'WO"U7US:aU5OS55 U5W- n5M+ OS:a WrWu-UlGO,U+RIURTURXUR>U8--5 U+GR'WO"U7Wr55 URV(dUR>S:Xa URRGREWrWu-5 O]U+RIURRURX5 U+GR'WO"U7Wr55 UrWu-URRURX'U=RXS- sl,U=RX[URT5-sl,U+RIWo5 WqS:XdG M WLVws/sHnwUwS(aMWwPM nLnwG M. WpS:deS/U3Q7UlU/UlWpUlWYUlU!Ul U(aWLUlU (aWpG[QWY54$g![ a G0Nf=fs snRfs snwf)a8Write multi-dimensional image to series of TIFF pages. Metadata in JSON, ImageJ, or OME-XML format are written to the ImageDescription tag of the first page of a series by default, such that the image can later be read back as an array of the same shape. The values of the ImageWidth, ImageLength, ImageDepth, and SamplesPerPixel tags are inferred from the last dimensions of the data's shape. The value of the SampleFormat tag is inferred from the data's dtype. Image data are written uncompressed in one strip per plane by default. Dimensions higher than 2 to 4 (depending on photometric mode, planar configuration, and volumetric mode) are flattened and written as separate pages. If the data size is zero, write a single page with shape (0, 0). Parameters: data: Image data to write. If ``None``, an empty image is written, which size and type must be specified using ``shape`` and ``dtype`` arguments. This option cannot be used with compression, predictors, packed integers, or bilevel images. A copy of array-like data is made if it is not a C-contiguous NumPy or dask array with the same byteorder as the TIFF file. Iterators must yield ndarrays or bytes compatible with the file's byteorder as well as the ``shape`` and ``dtype`` arguments. Iterator bytes must be compatible with the ``compression``, ``predictor``, ``subsampling``, and ``jpegtables`` arguments. If ``tile`` is specified, iterator items must match the tile shape. Incomplete tiles are zero-padded. Iterators of non-tiled images must yield ndarrays of ``shape[1:]`` or strips as bytes. Iterators of strip ndarrays are not supported. Writing dask arrays might be excruciatingly slow for arrays with many chunks or files with many segments. (https://github.com/dask/dask/issues/8570). shape: Shape of image to write. The default is inferred from the ``data`` argument if possible. A ValueError is raised if the value is incompatible with the ``data`` or other arguments. dtype: NumPy data type of image to write. The default is inferred from the ``data`` argument if possible. A ValueError is raised if the value is incompatible with the ``data`` argument. photometric: Color space of image. The default is inferred from the data shape, dtype, and the ``colormap`` argument. A UserWarning is logged if RGB color space is auto-detected. Specify this parameter to silence the warning and to avoid ambiguities. *MINISBLACK*: for bilevel and grayscale images, 0 is black. *MINISWHITE*: for bilevel and grayscale images, 0 is white. *RGB*: the image contains red, green and blue samples. *SEPARATED*: the image contains CMYK samples. *PALETTE*: the image is used as an index into a colormap. *CFA*: the image is a Color Filter Array. The CFARepeatPatternDim, CFAPattern, and other DNG or TIFF/EP tags must be specified in ``extratags`` to produce a valid file. The value is written to the PhotometricInterpretation tag. planarconfig: Interleaved or planar sample storage. *CONTIG*: the last dimension contains samples. *SEPARATE*: the 3rd or 4th last dimension contains samples. The default is inferred from the data shape and ``photometric`` mode. If this parameter is set, extra samples are used to store grayscale images. The value is written to the PlanarConfiguration tag. extrasamples: Interpretation of extra components in pixels. *UNSPECIFIED*: no transparency information (default). *ASSOCALPHA*: true transparency with premultiplied color. *UNASSALPHA*: independent transparency masks. The values are written to the ExtraSamples tag. volumetric: Volumetric image stored on single page via SGI ImageDepth tag. The volumetric format is not part of the TIFF specification, and few software can read it. OME and ImageJ formats are not compatible with volumetric storage. tile: Shape ([depth,] length, width) of image tiles to write. By default, image data are written in strips. The tile length and width must be a multiple of 16. If a tile depth is provided, the SGI ImageDepth and TileDepth tags are used to write volumetric data. Tiles cannot be used to write contiguous series, except if the tile shape matches the data shape. The values are written to the TileWidth, TileLength, and TileDepth tags. rowsperstrip: Number of rows per strip. By default, strips are about 256 KB if ``compression`` is enabled, else rowsperstrip is set to the image length. The value is written to the RowsPerStrip tag. bitspersample: Number of bits per sample. The default is the number of bits of the data's dtype. Different values per samples are not supported. Unsigned integer data are packed into bytes as tightly as possible. Valid values are 1-8 for uint8, 9-16 for uint16, and 17-32 for uint32. This setting cannot be used with compression, contiguous series, or empty files. The value is written to the BitsPerSample tag. compression: Compression scheme used on image data. By default, image data are written uncompressed. Compression cannot be used to write contiguous series. Compressors may require certain data shapes, types or value ranges. For example, JPEG compression requires grayscale or RGB(A), uint8 or 12-bit uint16. JPEG compression is experimental. JPEG markers and TIFF tags may not match. Only a limited set of compression schemes are implemented. 'ZLIB' is short for ADOBE_DEFLATE. The value is written to the Compression tag. compressionargs: Extra keyword arguments for compression codec. Refer to the Imagecodecs implementation for supported arguments. predictor: Differencing predictor applied before compression. By default, no operator is applied. Predictors can only be used with certain compression schemes and data types. The value is written to the Predictor tag. subsampling: Chroma subsampling factors for JPEG-compressed RGB images. Values: (1, 1), (2, 1), (2, 2), or (4, 1). The default is *(2, 2)*. Currently applies to JPEG compression of RGB images only. Images are stored in YCbCr color space, the value of the PhotometricInterpretation tag is *YCBCR*. Segment widths must be a multiple of 8 times the horizontal factor. Segment lengths and rowsperstrip must be a multiple of 8 times the vertical factor. The values are written to the YCbCrSubSampling tag. jpegtables: JPEG quantization and Huffman tables. Use for copying pre-compressed JPEG segments. The value is written to the JPEGTables tag. iccprofile: ICC device profile characterizing image color space. The value is written verbatim to the InterColorProfile tag. colormap: RGB color values for corresponding data value. The colormap array must be of shape ``(3, 2\*\*(data.itemsize*8))`` (or ``(3, 256)`` for ImageJ) and dtype uint16. The image's data type must be uint8 or uint16 (or float32 for ImageJ) and the values are indices into the last dimension of the colormap. The value is written to the ColorMap tag. description: Subject of image. Must be 7-bit ASCII. Cannot be used with the ImageJ or OME formats. The value is written to the ImageDescription tag of the first page of a series. datetime: Date and time of image creation. String in ``%Y:%m:%d %H:%M:%S`` format, ``datetime.datetime`` object, or ``True`` for now. The value is written to the DateTime tag of the first page of a series. resolution: Number of pixels per ``resolutionunit`` in X and Y directions. Values are float or rational numbers. The default is (1.0, 1.0). The values are written to the YResolution and XResolution tags. resolutionunit: Unit of measurement for ``resolution`` values. The default is *NONE* if ``resolution`` is not specified and for ImageJ format, else *INCH*. The value is written to the ResolutionUnit tags. subfiletype: Bitfield to indicate kind of image. Set bit 0 if the image is a reduced-resolution version of another image. Set bit 1 if the image is part of a multi-page image. Set bit 2 if the image is transparency mask for another image (photometric must be MASK, SamplesPerPixel and bitspersample must be 1). software: Name of software used to create file. Must be 7-bit ASCII. The default is 'tifffile.py'. Unless ``False``, the value is written to the Software tag of the first page of a series. subifds: Number of child IFDs to write per page (int or sequence). If a sequence is given, its length is used (for example, a ``TiffPage.subifds`` tuple). If greater than 0, the following ``subifds`` number of series are written as child IFDs of the current series as a SubIFD tree: all SubIFD offsets are stored directly in the parent's SubIFDs tag and all SubIFD NextIFD fields are zero, as required by DNG and TIFF-EP. If less than 0, ``abs(subifds)`` SubIFD levels are written as a SubIFD chain: only the first SubIFD offset is stored in the parent's SubIFDs tag, and subsequent SubIFDs are linked via their NextIFD fields. The number of IFDs written for each SubIFD level must match the number of IFDs written for the current series. All pages written to a certain SubIFD level of the current series must have the same hash. SubIFDs cannot be used with truncated or ImageJ files. SubIFDs in OME-TIFF files must be sub-resolutions of the main IFDs. metadata: Additional metadata for ImageDescription or IJMetadata tags. Metadata do not determine, but must match, how image data is written to the file. By default, the image shape and dtype are written in shaped format with no additional metadata keys. If ``None``, or the ``shaped`` argument to :py:class:`TiffWriter` is ``False``, no information in JSON format is written to the ImageDescription tag. The 'axes' item defines the character codes for dimensions in ``data`` or ``shape``. Refer to :py:class:`OmeXml` for supported keys when writing OME-TIFF. Refer to :py:func:`imagej_description` and :py:func:`imagej_metadata_tag` for items supported by the ImageJ format. Items 'Info', 'Labels', 'Ranges', 'LUTs', 'Plot', 'ROI', and 'Overlays' are written to the IJMetadata and IJMetadataByteCounts tags. Strings must be 7-bit ASCII. Written with the first page of a series only. extratags: Additional tags to write. A list of tuples with 5 items: 0. code (int): Tag Id. 1. dtype (:py:class:`DATATYPE`): Data type of items in ``value``. 2. count (int): Number of data values. Not used for string or bytes values. 3. value (Sequence[Any]): ``count`` values compatible with ``dtype``. Bytes must contain count values of dtype packed as binary data. 4. writeonce (bool): Write tag to first page of a series only. Duplicate and select tags in TIFF.TAG_FILTERED are not written if the extratag is specified by integer code. Extratags cannot be used to write IFD type tags. contiguous: Write data contiguously after the previous series. If ``False`` (default), write data to a new series. If ``True`` and the data and arguments are compatible with previous written ones (same shape, no compression, etc.), the image data are stored contiguously after the previous one. In that case, ``photometric``, ``planarconfig``, and ``rowsperstrip`` are ignored. Metadata such as ``description``, ``metadata``, ``datetime``, and ``extratags`` are written to the first page of a contiguous series only. Contiguous mode cannot be used with the OME or ImageJ formats. truncate: Write only first page of contiguous series if possible. If ``True``, only write first page of contiguous series if possible (uncompressed, contiguous, not tiled). Other TIFF readers will only be able to read part of the data. Cannot be used with the OME format. align: Byte boundary on which to align image data in file. The default is 16. Use mmap.ALLOCATIONGRANULARITY for memory-mapped data. Following contiguous writes are not aligned. maxworkers: Maximum number of threads for compressing tiles or strips. If ``None`` or *0*, use up to :py:attr:`_TIFF.MAXWORKERS` CPU cores for compressing large segments. Using multiple threads can significantly speed up this function if the bottleneck is encoding the data, for example, in case of large JPEG compressed tiles. If the bottleneck is I/O or pure Python code, using multiple threads might be detrimental. buffersize: Approximate number of bytes to compress in one pass. The default is :py:attr:`_TIFF.BUFFERSIZE` * 2. returnoffset: Return offset and byte count of memory-mappable image data. Returns: If ``returnoffset`` is ``True`` and the image data in the file are memory-mappable, return the offset and number of bytes of the image data in the file. rK)framesNz-missing required 'shape' or 'dtype' arguments__next__rreshaperzdtype argument z does not match data dtype zshape argument z does not match data shape c3*# UH oS:v M g7f)Nrt)rrs rvr#TiffWriter.write..G s8idz!izinvalid data shaperrYrPrFT)rrrrY>rrrrYrQrz8the ImageJ format does not support non-contiguous seriesrr storedshapez,SubIFDs cannot be used with truncated seriesz$SubIFDs in SubIFDs are not supportedz8contiguous mode cannot be used with compression or tilesz.ome.z7truncate can only be used with imagej or shaped formatsz阇 codecformatB usecontainerlosslessz(cannot use predictor without compressionzcannot use predictor with friu>rTLMrNOz cannot use z with z$ not writing description to OME-TIFFz$OME-TIFF does not support ImageDepthz' not writing description to ImageJ fileBHhfz-the ImageJ format does not support data type z-the ImageJ format does not support ImageDepthBz for RGBaxesrgbrz1the ImageJ format does not support planar samplesrr)rz!invalid colormap shape for ImageJHfz1 not writing colormap to ImageJ image with dtype=z and photometric=BHzinvalid colormap shapez$invalid data dtype for palette-imagez* not writing colormap with image of dtype=c3*# UH oS:v M g7frYNrtris rvrrw s+d1udrxzinvalid tile shape c38# UHn[U5v M g7fryrrs rvrrw s.AQrt)zcontiguous samplesz parameter is)zseparate component planesz!and 'planarconfig' parameters arez, data with shape z and dtype 'z' are stored as RGB with zl. Future versions will store such data as MINISBLACK in separate pages by default, unless the 'photometric' z specified.znot a z imagezinvalid CFA imagez cannot write z using volumetric tiles >rrYrzinvalid SubfileType MASKzbitspersample=z must be 1 for bilevelrruint16 z invalid for JPEG compressionrRrrrr)rYrTrz out of range of datadtype=uz does not match datadtype=z cannot be used with compressionzinvalid storedshape=z for palette modeznot enough samples for z : expected z, got z does not match storedshape=EDzInfoLabelsRangesLUTsPlotROIOverlays Propertiesinfolabelsrangeslutsplotroioverlayspropr colormappedz@) truncatedzasciiz tifffile.py1:zinvalid datetime string%Y:%m:%d %H:%M:%S2Grdeflatezstdzinvalid LERC compression=rBC__len__J r)rrrcS@srzwrong number of extrasamples  != Rr[rTrT>rYrYrrTrYrrYzinvalid subsampling factors ztile shape not a multiple of z'JPEG subsampling requires RGB(A) images outcolorspacer colorspacec30# UH oSS:gv M g7frNrtrets rvrrw s.'01 yr) rrYrYrYrrYrrYrrY>Nrz cannot apply subsampling rc30# UH oSS:gv M g7frrtrs rvrrw s8i!u|ir(c3N# [U5n[U5HnUv M g7fry)r{range)numtiles bytecountchunk_s rv dataiter_#TiffWriter.write..dataiter_ s$ !&i 0!&xA"'K"1s#%iz&cannot write non-contiguous empty filez not writing extratag c US$Nrrtrs rv"TiffWriter.write.. s!A$rurztype(iteritem)=z != byteszdtype of iterator z does not match dtype axiscF[R"XS9R5$Nr rpackbitstobytes)rr s rvcompressionfunc1*TiffWriter.write..compressionfunc1 s!>>$:BBDDru>rrPP]m鲀cX[R"XS9R5nU"U40UD6$r r)r compressorr rs rvcompressionfunc2*TiffWriter.write..compressionfunc2 s+ !>>$:BBDD%d5f55ruzcannot compress bilevel imagercU"U40UD6$ryrtrrrs rvcompressionfunc)TiffWriter.write..compressionfunc  &d5f55ruc U"XS9nU"U40UD6$r rt)r predictorfuncrr rs rvrr  s)9D%d5f55rucU"U40UD6$ryrtrs rvrr  r!rucxURSnUS:XaX0RS-n[R"XUS9$)NrKryrunlen)r imagecodecspackints_encode)rbpsr r's rvrr  s@ B2:jjn,F"22fruruc3*# UH oSv M g7frrtrts rvrrwfs"6AQ4rxz(iterator contains wrong number of bytes ztile is too largec32# UH upSX- 4v M g7frNrtrrjs rvrrws#$)J)strictzunreachable code)rrrrreturnIterator[bytes])rrgr rr6r{) rrgrrgr rrrgr6r{)rrgrrgrrgr6r{) rrgr#rgrrgr rrrgr6r{)rrgr*rgr rr6r{)rrr#r"rrr~rrr rr_ndarrayrflags f_contiguousrranyrr@rrrr0r2r- array_equal_write_remaining_pagesr'r$r=rBr+addimage_write_image_descriptionr\rrdr;r)r@r?r<rArX write_empty write_arrayr& extensionr(rhrirj tagnoformatrg offsetsizetagsizer MINISBLACK MINISWHITERGBYCBCRPALETTEr CONTIGSEPARATEr.listrzupperrvalue setdefaultrIMAGE_COMPRESSIONSrr PREDICTORSrrget imagej_shaperHPHOTOMETRIC_SAMPLESDeprecationWarningcontig_sampleswidthlengthdepthseparate_samplessamplesrCFAMASKrr page_sizeis_valid RuntimeErrorrrtr7_pack_addtagcopyimagesr>r3r2r shaped_descriptionr{encoder$r9DateTimestrftimenowrrmaxrallr7warningrrINCHrAmathceil_bytecount_format iter_tilesr iter_images TAG_FILTEREDsorted peek_iteratortyper COMPRESSORSrr' _maxworkers encode_chunks iter_strips page_shaperr:ioBytesIOr enumerater startswith valueoffsetSEEK_CURnextascontiguousarrayrzippadr getbufferflushr4r6r.sum)rkrrrrrrrrrrrrrrrrrrrUrrrrrprrrrrrrrr| dataarraydataiterrdataoffsetsoffsetdatabytecountsoffsetsubifdsoffsetsrmr#rrlrr datashape datadtypebilevelindexr inputshapepackintsrrCrgrDrErFrGrHrIrJrKrLcompressiontag predictortagijrgbrijshapendim deprecatemsgsphotometricsamples samples_sets0tags tagbytecounts tagoffsetsrfaddtag ijmetadatar.lerc_compression sampleformat maxsamplingrtilesrdatabytecountsbytecountformatrcount numstripsrowsize numstrips1 stripsize laststripsizertagsetextratagcompressionaxis bytesiter tupleiteriteritemrrrr tileshapetilesizefhposr pageindexifdposifd tagoffset ifdoffsettagindextagcoderOifdsizeskip byteswrittenpagesize chunkindex tileindexrrs rvrTiffWriter.writes3j ' 'H$/b#9 *. AE(, ;?>B8< 37 59 XXII'' <} E o%IHe I E*77 BI T: & &} E o%He I E*77 BI T7 # # t,DI DJJ/<,>>H q=IK M#;--::K9d++88I   % 8!3!3a!77  ?? &4??+F# ==SI??12&)3??i/$)CNN*x/C((4>>BB++-<<0%S/)<<+))A-#00<<<#~~999 -- "&//$(??1#5#:!%%)__QR%8(,(9(9(?(? #nn )113GGAr{{+==~~L(o-&&!+&))T]]:/1,/1,-/*() -1*)* D(o-"&!%DN!o% $(??1#5#9"FI"F$NN8,NN9i8!8++ 99 "#r||3 ! >>T\\!(^DN KCS/ !"DN >>{h$N S/ ! q=I MM(HI ii++ yy-- YY)) ))## ++  ++ oo!!%%$$((  "!+{;K "<>L  # !", >>!&)!L +s++)//1 &("#KK.. $[+>DDNKNK  " O Q  O ; ;-.OM * u $  & &~u =  & &z4 8*** @ o%!8!881">257!o%)T**>>S(#$L^^t+ 0B0Ba0G#$L6ymDC$S/)#Iy9 NNd*!/@@!**a/NNc)!/@@' }F9-HC$S/)( L  5 99& hBC  # ||###)8DL#)#5H#5DLds4y1}< o%J \\\ & hEF  # ~~V+C ~~(*!o%ds4y1}E o%J*5K3&4E~~$#%%%.M;%S/)##+4f1ED"9%dCGx'I o%r{f$! $'INNc,A")K",K# %*6L  }}XY_EH%DN||>>X-=C$S/)>>S([=.#*K^^s*{g/E!$.'J +CCMM(#!!* +=@##$  $H$4)?% # >>ay/A/AA/E)F%GG2C$S/)H'# >>-@C$S/)>>ay/A/AA/E)F%GG2C$S/)H h&K'9[N<    D %A%8b=8b=+d++++D62 o%...Dc$i1nzDzTaJDj)J$&&&& t//33KC 5z $(J  I$K( '!8b V 3"%K )d :I)4!8b V0C1Hrf!4"%K $IeBi61! % %NN$6 ( # eBi6.AqU2Y&0! '  6)?DD B9+N""+,Ed1gYKAwi{ , '  &&&!55kB CJ 1BL!A%(  !5zA~{oV4 o%5zA~" ##%#5q"9K#5"6K9 +#)L24 C#+L2YZrR!@@#+L#)Lv%-22Y *$)"I !%*2Y "(-b K%$)"I !%*2Y "(-b K%389K0389K0""%77''*<<(KOO +5zQ) o%JL %b K !&rK c%jACv%'3|+K $ L~~8x2~%j1nra!#2JE%j1nra#e*q.U2Y!^cr 5zA~" $)"I !%*2Y "(-b K%-22Y *$)"I !%*2Y "(-b K%+6+>+>+B (ds4yA~$q'A+!+0HOCS/ !  "{U':''1,9,0 o%%**K (]a-?'((>? o%M 3 3$ / 3 3#9+@Ra!  ++'((EF o%,I I$ / 3 3#Y%7%7!%;! A! 3I4F4F GG!Y%7%7!%;;'((D)F o%< "%..2M NNc !Y%7%7!%;y11A55#]$$?YLACS/ ! aB/ 0B0BC C!3!3a!77#]$$@i\BCS/ !  2 2Q 66'((HI o%7i0014 4H    #&&B&(Ag7:3F"3LK  a< 4 4)[,-Cs# # ' !""a';+C+Ca+G- 00AB o%,H #5 5)+9./vk6I6I5JL S/ !  $((L8!$$A[4DECS/ !   !))+*;*;>JK ; &K $k511)009 #*aa[!1;$D K  "DN%,,W5K 4aK 6#*aa[!1;$D    $H  4aHd 3 (C((x=B&(2,#*=3C$S/)+>Hh//#,,-@A#<<>223FG 4aHd 3tS!Q/ U """=19#$  /9<#$  /69#$ /&}58:!o% 41q*:&; < 1  4aL 1tS!Q 1 12tS!Q 2 23  4aDH - 4aDH -  41k&7&7 8tUAq$q'2  " 4aK 0 t}}$*<*>S0!";INNKL ##+"5"55     4a 9  ! 43z?J ?tS!Q 3 34 ""Q&tS!Q (@(@A  1 $ 4aK$<$< = ## ;#6#66   4aM 2  # #a ''++s,>>)M:>9jA$1q!B"44O m_i  4\9qcIo N- 9O$Z&y1  J:CS/ !!%%1!A$% d''(!H{f$  h4Xa[MBt'h' "   d/ "    !.x!8 Hh(E** &.#)!(E22,T(^-Y7C#C.("8U3I ==2#22a7 r*a/')O>>&&)..8,X^^,>?009}>%S/)H ",;EE%(EE #3#LL'+&6&6~&F /"1 66 #66 6  6#36)#.. )).9J&*9''1"166 #6 6 6!*7&0 /"1 66#&6!$6 6  6  6!'1"166 #6 6 6 !#",#' )+     #O )0KI?d?K$>$>? "9- 0B0BB'33{111"  ){111# (33 2 22"  '** ) 2 22#$#))#22    JqK4F4FGIFz!! !!A%(lF34 GGFO1}!%jjl ${CI67HHJ  #(("6"667HHJ  $|Q/0%.t_MHc&G);;a?*LFq6DFE!hhj7IIg.1HC( $|Vc\"BC  %(:-06 -!]2393;0!S[ $ 4 4 @$($8$8$?$?1$D$)$4$4$($8$8$>$>%"%" %+Y$6G9K$K!% 4 4 ;DJC< 4 4 @%"%E!A"S[-3S[N)+,2DL)./5t|, 00< $ 4 4 ; ;q @ $ 4 4 : :c!fRSk I!' 2X5G G!007!% 4 4 ; ;j H1 L!00< !J!A=)/c&5d((*Q;IIg&qLG GGGR[[ )J}Z%/0E9D GGD"++ & $ J'#$L (0H(BHHX,>>L ()1 $/#8#89;M;M#M(0H'/ ,x0H H !-$,$-1"!" !))1$x/F+nD <)o- 0 &NN8,NN9i8+++ cX9E #"'Di"HJ*.eSj)4>+'Hi2;N:..4K +c(m+FHHX& #I+++"'Di"HJ#E4>:H14XN:.HHX& #I+++?d?K$>$>? "9- 0B0BB!&xI#H~H'45y1 $66xKH(2$??X5"5C",S/1#$(+ )8>>%)$ $)99Xs#;NN8, /"14)"3''%0 00+KFC HHV  $|Vc\:; &'F .  vqI$ !/ #. $|V"<=#. $|Z89*t 8I+7772  ?IId<#>?HHSM $@@A), ?HHV$IId<#>?((// =((//@GGIE GGFO HHS]]_ % HHJ!!A%"(9"4((8((:56lF34))))Q.,,33FY4FG 4 4T^^ DElF!;<"Y.,,T^^<!##d&:&:";; GGENA~'+;t3r7t;}H@A~~*z*#%-' DJ!3~#666k1&Z"&p>++-  ) ) +$$Y/ 0//$$Y/ 0//s/1B A11 A?CC8 C C CcUR$)z'File handle of TIFF file being written.r#rs rv filehandleTiffWriter.filehandlez xxruc`UR(aUR(d URcgURceURceUR ceURR URS-S- nUS:aSUlSUlSUlgURnUR5nUS-(aURS5 US- n[RnURRnURRnURRnURR nUR n [#UR5n Sn [$R&"5n U RU"U[)UR555 U R5n U RSR+SUR555 U R5nU RU"US55 [-UR5HunnXU--U-S-nUSnUSnU(aU R5nUS-(aU RS5 US- nU R/U5 U RU"XSU-55 U R/U5 U RU5 UUR<:XaUU4nMUS :XaUU4n MMUUR<:XaUS4nMUS :XdMUS4n M U R5nUS-(aU RS5 US- nUS:aPUUU--S:aDUR2(a&[4R6"U<S 3[8SS 9 S UlgS n[;U5e[$R&"[?UU-55nUn[AU5GHnX- n WunnU R/U5 Ub_U RU"UUU-55 U R/U5 U nURH nU RU"UU55 UU- nM" OU RU"XY55 U b(U unnURBREUUbUOU-5 URFS:agU b4U unnUb,U R/U5 U RU"UUU-55 UU- nU R/U5 U RU"UU55 GO.UR/URBURHURFU--5 URU"UU55 URJ(dURFS:XaURLREUU-5 O\UR/URLURH5 URU"UU55 UU-URLURH'U=RHS- sl$U=RH[)URB5-sl$UU- nURU RO55 GM UUUS- -- nUR/U5 URU"US55 UR/U5 URURO55 URFS:alUR5nUR/URP5 URU"XS55 URS5 UR/U5 X>-Ul(SUlSUlSUlg![R0aOnUR2(a+[4R6"U<S 3[8SS 9 S UlSnA gS n[;U5UeSnAff=f)z(Write outstanding IFDs and tags to file.NrrYrTr+ruc3*# UH oSv M g7frrtr-s rvr4TiffWriter._write_remaining_pages..s4AQ4rxrz truncating ImageJ filerUTz#data too large for non-BigTIFF filerrPl)*r.r)r0rBr6r4rrr#rXrrerfr"rgrDrCrErr}r~rrrr\errorr'rhrirjrr7r{rr?rr=rAr<r@rr:r)rkpagenorlrrfrgrDrCrEr pagedatasizerrrrrrrrrOrmexcrrrifdsrrdataptrrs rvr=!TiffWriter._write_remaining_pagesszzT^^t/F   ,,,##///+++''..1CCaG A:DJ#D #'D  XXWWY 19 HHW  QJE{{ II22 )).. 9900 yy((**  4 45 8<jjl ${C O45HHJ  #((4445HHJ  $|Q'(&tzz2MHcG!33j@1DFq6DFEhhj7IIg&1HC  3IId<=>  % 4///(. %S[%+S[N!---$*DL!!'G3J((* Q; IIg  qLG >eg&66C|| h56  "&7CS/ !zz%& 012vA  &J+KFC HHV  $|Vc\:; $ 00DIId<9:tOG1 $|89), $$++S_c&A!!A%!-"0KFC( $|Vc\"BC'!# $|V45((8((:56lF34))))Q.,,33FY4FG 4 4T^^ DElF!;<"Y.,,T^^<!##d&:&:";;'! JJs}} 'sx W ++  ) 4 a()  !"    !'')C GGDOO $ HHT,. / HHJ GGCL#/DO #w|| 3|| #h&=>''( *.?C$S/s2 3s]  ^-6^(^((^-cURb URcSUlgURceURceURbUR S:aUR ceURR"S URURSS:wa UROURSSURRS.UR D6 URRSS9nOURSS:XaSUlgUR(aZUR ceURSLnURRS;n[UR4UUS.UR D6nOHUR(dSUlgUR ce[UR40UR D6nURR!UR#5S S 9 SUlg) z'Write metadata to ImageDescription tag.NrrYr{T declarationrrFrrt)r0r9rBr2r$r=r+r>rtostringr'r-r\r2r(rfrrg)rkrrisrgbs rvr?#TiffWriter._write_image_description5s ?? "d&:&:&B#'D   ,,,*** << #!!A%~~111 %% // ??1-2!__QR0 $ 1 1 7 7 nn ,,//D/AK __Q 1 $#'D \\>>- --..4K%%--7E,'.. K #'D >>- --,T__OOK &&{'9'9';5&I#ruc  URn[U[5(d[RUn[ [U5n[R USn AUn US:Xa[U[5(aURS5nO"[U[5(d S n [U 5e[U5S:Xd USSS :waUS - n[U5nUS :XaU[UR!S 55n U S:aUn O4[#UR$R&S-U S-5n [)XK5n OUn U4nOw[U[5(aG[*R,"U 5n [U5U -(a Sn [U 5e[U5U -nUn OUc Sn [U 5e[U5nUS;a[U[[.R045(de[3US5(aTUS:aN[5[7U5S5n[U[8[:45(a/nUHnUR=U5 M UnUS-nU Sn U"SX(5U"UR$R>U 5/nSn[*R,"U 5U-UR$R&::aUR$R&S3n[U[5(aURAU"UU55 GObUS:XaO[U[8[:[.R045(aUSnURAU"UU"X555 GO URAU"UU"UU 3/UQ7655 OURAU"UR$R>S55 [U[5(aUnO[U[.R05(aUURBU:wa Sn [EU 5eURFRHU :wa Sn [EU 5eURK5nO1[U[8[:45(aU"UU 3/UQ76nOU"X5nURAUSRMU5UU45 g![a\ [ [U5n U SS;aU SSn [RU nGNT![[4a SU<3n [U 5Sef=ff=f![an S n [U 5U eSn A ff=f)zAppend (code, ifdentry, ifdvalue, writeonce) to tags list. Compute ifdentry and ifdvalue bytes from code, dtype, count, value. rKr<>rYNzunknown dtype=rTr TIFF strings must be 7-bit ASCIIz&TIFF string value must be str or bytesr+rsinvalid packed binary dataz invalid countr __iter__HHrzvalue.size != countzvalue.dtype.char != dtyperu)'rbrrrTAGSr_ DATA_FORMATSKeyErrorrz DATA_DTYPESrrrgUnicodeEncodeErrorr{rfindrkr"rDminrecalcsizerr8rriterr~rMextendrgrrrarrrr)rkrrrrrO writeoncerfdatatype dataformatrrawcountrrfirstflatpairifdentryifdvalue valueformats rvrcTiffWriter._addtaggsszz$$$99T?D 0C'H**84R8J  q=%%%3!LL1E u--> o%5zQ%*"7 JEs{uzz+67a<$H #499#7#7!#;X\JH"53H HE u % %z2H5zH$2 o%J(*EH ]!CS/ !JE w uuemm&<==E:..AIT%[$/eeT]33&(D % D)!& E QJE#BJ t & '' 2   ??: & .$))2F2F F!YY112!4K%''[% 89!eeT5==%ABB!!HE[$z2I JKdeWZL+A&JE&JK OOD!7!7; <%'' E5==11::&/C&s++;;##z15C&s++ ==?EE4=115'* 6?? 2 T388H-xCDY 0 0!#u- a=D(!+ABJ++J7i( 0') o4/ 0  0$*3rrrrri>rrPrrri >RXuvr>Qrrr)rr MAXWORKERS)r numchunks chunksizers rvryTiffWriter._maxworkerss  !jAo  1 1}4e# v +2 #  u 1 "  t  0 !  t  0 !  t  0 !  % y!$ $9doo..rucU$ryrtrs rv __enter__TiffWriter.__enter__< ruc$UR5 gryrrkexc_type exc_value tracebacks rv__exit__TiffWriter.__exit__? rucLS[URRS5<S3$)Nztuple[float | tuple[int, int], float | tuple[int, int]] | NonerRESUNIT | int | str | NonerFILETYPE | int | Nonerstr | bytes | bool | Nonerpzint | Sequence[int] | Nonerr*rSequence[TagTuple] | Nonerrrrrr3rr3rr3rrr6r8)rrzr6rr6rr6r)F)rz+list[tuple[int, bytes, bytes | None, bool]]r int | strrrDrr3rOrgrrr6r)rrzr rgr6r{)r Sequence[int]rrr6rz) rr3rrrrrrr6rr6rir"type[BaseException] | Noner#BaseException | Noner$TracebackType | Noner6rr6rz)rrrrr__annotations__rnrrrrpropertyrr=r?rcrbrq staticmethodryrr%r+r rtrurvr'r'sBVp , O   MOO$$++ 44&&''%%##OMN$$04&*"EI"V=V - V  V$VVCVVVV V@ J'+"&6:83?J@+AJB,CJD,EJF(GJH-IJJKJLMJNOJPQJRSJTUJV WJX> $!s$l0$r BE9BEBE BE  BE  BEBE BEH& )' )69 )  )9/9/9/9/ 9/ 9/9/v,((   Nrur'c \rSrSr%SrS\S'S\S'S\S'S \S 'S\S 'S \S 'S\S'S\S'S\S'S\S'SSSSSSSSSS. S^Sjjr\S_Sj5r\S`Sj5r \SaSj5r \SbSj5r \ ScSj5r SdSjrSeSSSSSSSS.SfS jjjrSeSSSSSSS!.SgS"jjjrSeSSSSS#.ShS$jjjr\SiS%j5rSeS&S'.SjS(jjjrSdS)jrSdS*jrSdS+jrSdS,jrSkS-jrSlS.jrSmS/jrSaS0jrSaS1jrSnSoS2jjr\ SpS3j5r\ SqS4j5r\SqS5j5r \SqS6j5r!\ SqS7j5r"\ SqS8j5r#\ SqS9j5r$\ SqS:j5r%\SqS;j5r&\ SqS<j5r'\ SrS=j5r(\SsS>j5r)\SsS?j5r*\SsS@j5r+\SsSAj5r,\SsSBj5r-\SsSCj5r.\SsSDj5r/\StSEj5r0\ StSFj5r1\ StSGj5r2\ StSHj5r3\StSIj5r4\StSJj5r5\StSKj5r6\ StSLj5r7\ StSMj5r8\StSNj5r9\StSOj5r:\StSPj5r;\StSQj5r<\StSRj5r=\ StSSj5r>\ StSTj5r?\ StSUj5r@\ StSVj5rA\StSWj5rB\StSXj5rC\ StSYj5rD\ StSZj5rE\ StS[j5rF\ SuS\j5rGS]rHg)vriKahRead image and metadata from TIFF file. TiffFile instances must be closed with :py:meth:`TiffFile.close`, which is automatically called when using the 'with' context manager. TiffFile instances are not thread-safe. All attributes are read-only. Parameters: file: Specifies TIFF file to read. File objects must be open in binary mode and positioned at the TIFF header. mode: File open mode if ``file`` is file name. The default is 'rb'. name: Name of file if ``file`` is file handle. offset: Start position of embedded file. The default is the current file position. size: Size of embedded file. The default is the number of bytes from the ``offset`` to the end of the file. omexml: OME metadata in XML format, for example, from external companion file or sanitized XML overriding XML in file. superres: EER super-resolution level to decode. The default is 0 (no super-resolution). _multifile, _useframes, _root: Internal use. **is_flags: Override ``TiffFile.is_`` flags, for example: ``is_ome=False``: disable processing of OME-XML metadata. ``is_lsm=False``: disable special handling of LSM files. ``is_ndpi=True``: force file to be NDPI format. Raises: TiffFileError: Invalid TIFF structure. rr"r rrr#rr_root str | Noner$r _superreszdict[str | None, TiffFile]_filesz3dict[tuple[str | None, bool], list[TiffPageSeries]]_seriesz&dict[int, Callable[..., DecodeResult]] _decodersN) rrrrrrrrrPc   U R5HOupU SSS:Xa3U SS[R;aU b[X [ U 55 M?MASU 3n[ U5e US;aSU<3n[ U5eSUlU(a1UR5SSS:wa Sn[ U5eX`lS Ul [XX4US 9nXl UcS O [ U5Ul URU0Ul0Ul0UlU cUOU UlUcS O[%S ['U55UlUR+S 5 UR-S 5nS SS S.USSn[2R4"US-USS 5S nUS:Xa~[2R4"US-UR-S 55unnUS :wdUS:waSUU43n[1U5eUS:Xa[R6UlGO[R:UlGOUS:XaUS:Xa[R<UlGOmU R?SUR@S:H5(aEU R?SS 5(a[RBUlGO[RDUlGO[RDUlOUS:Xa2US:Xa[R<UlO[RDUlOUS:XaFUS:Xa Sn[1U5e[G5RIU<S35 [RDUlOjUS;aS[G5RIU<SUS S!35 US:Xa[R<UlO'[RDUlOS"U<3n[1U5e[KU5Ul&URN(aeURPRRS#:d:URLS RTS$:wdURLS$RTS$:waURW5 gURX(a-URZ(dURLR]5 gUR`(aURc5 gU (aS URLl2gg![.a SU<3n[1U5Sef=f![^a+n[G5RIU<S%U<S&35 SnAgSnAff=f![^a+n[G5RIU<S'U<S&35 SnAgSnAff=f![^a URg5 ef=f)(Nrrzunexpected keyword argument: >NrrErrDz invalid mode=rOME>zinvalid OME-XMLT)rrrrrrrsrr)rLrMsEPrTznot a TIFF file: header=rQrOrrPzinvalid BigTIFF offset size rRis_ndpiz.ndpiiRCi1Nzinvalid NIFF filez NIFF format not supported>RORSUz RAW format 0x04X not supportedzinvalid TIFF version=rvrYz) raised .128z <_ndpi_load_pages> raised )4itemsr FILE_FLAGSsetattrrrrr$stripis_omerr#rrrSrUrTrPrkrrRr\rrrreunpackrbr"r`rcrSrBNDPI_LErar7rr ris_lsmrrr_lsm_load_pages is_scanimagerZ_load_virtual_framesrrY_ndpi_load_pages useframesr)rkrrrrrrrrrrPrrrOrrlheaderrversionrDzerors rvrnTiffFile.__init__s #..*JC2Aw%CGt$>$DtE{3%6cU;n$ + 5 5"TG$CS/ ! ||~bc"f,' o%!LDK d M","4$$z:Jwwo  "]T &.C3x=4I[  GGAJWWQZF 3$'C@L mmIOVAa[A!DG"}#)==T1A2771:#N D19 a8*d9K8LMC',,# $ DI $ DIB# $DI\\)R\\W-DEE||It44$(LL $(OO $DIF"# $DI $DIF"#-C',,$)CDE OO 22hnWSMH# $DI $DI.gZ0#C((#4DJ{{$$-::a=,,1::a=,,1$$&""4??JJ335))+ '+ $c 31&5#C(d2 3F!HNN(#""%/!HNN("=c\D\J  HHJ  s-"T! RJ9T!"T!9R1T!&S)7T!R..T!1 S&;!S!T!!S&&T!) T3!TT!TT!!T=c.URR$)zByteorder of TIFF file.)r"rrs rvrTiffFile.byteordersyy"""rucUR$)zFile handle of TIFF file.rrs rvrTiffFile.filehandlerruc.URR$)zName of TIFF file.)r#rrs rvrTiffFile.filenamesxx}}rucUR$)zRoot TiffFile for OME multi-file series, else self. In an OME-TIFF dataset that spans multiple files, all secondary files hold a reference to the first-opened (root) file. For single-file TIFFs this property returns the instance itself. rPrs rvroot TiffFile.root"szzruc[R"URR55$![a gf=f)zUR"US9nO?[U 5S:Xa&U SnUc S n [!U 5eURAXgUS 9nO [CXXxS 9nUceUcbUceU(dUc4UR*S:wa$[-UR.UR05Sn O UR.n UREU S S 9nU$[U 5S:XaJUcSnU SnUc S n [!U 5eUREU(a UR.O URJ5nU$UcSn[MSU 55nUceUREU(aS/UR.Q7OS/URJQ75nU$s sn f![ an[G5RIU<S UR.SU SU<S35 URES/U Q7S S 9nSnAU$![ a0 URES/UR2R.Q7S S 9nSnAU$f=fSnAff=f![NanSn [!U 5UeSnAff=f)aW Return images from select pages as NumPy array. By default, the image array from the first level of the first series is returned. Parameters: key: Specifies which pages to return as array. By default, the image of the specified ``series`` and ``level`` is returned. If not ``None``, the images from the specified pages in the whole file (if ``series`` is ``None``) or a specified series are returned as a stacked array. Requesting an array from multiple pages that are not compatible with respect to shape, dtype, compression etc. is undefined, that is, it may crash or return incorrect values. series: Specifies which series of pages to return as array. The default is 0. kind: Series format kind, such as ``'ome'`` or ``'imagej'``. By default, the format is auto-detected. level: Specifies which level of multi-resolution series to return as array. The default is 0. squeeze: Remove length-1 dimensions from image array, except X and Y. If ``False``, preserve all dimensions. Single pages are returned as 5D array of shape :py:attr:`TiffPage.shaped`. For series, the shape of the returned array also includes singlet dimensions specified in some file formats. For example, ImageJ series and most commonly also OME series, are returned in TZCYXS order. If ``None`` (default), remove length-1 dimensions except for ``'shaped'`` series. out: Output array, *'memmap'*, or file for image data. By default, a new NumPy array is created. If a *numpy.ndarray*, a writable array to which the image is copied. If *'memmap'*, directly memory-map the image data in the file if possible; else create a memory-mapped array in a temporary file. If a *string* or *open file*, the file used to create a memory-mapped array. maxworkers: Maximum number of threads to concurrently decode data from multiple pages or compressed segments. If ``None`` or *0*, use up to :py:attr:`_TIFF.MAXWORKERS` threads. Reading data from file is limited to the main thread. Using multiple threads can significantly speed up this function if the bottleneck is decoding compressed data, for example, in case of large LZW compressed LSM files or JPEG compressed tiled slides. If the bottleneck is I/O or pure Python code, using multiple threads might be detrimental. buffersize: Approximate number of bytes to read from file in one pass. The default is :py:attr:`_TIFF.BUFFERSIZE`. Returns: Images from specified pages. See ``TiffPage.asarray`` for operations that are applied (or not) to the image data stored in the file. Nrz0key must be an integer, slice, or sequence, not zno pages selectedrr:rrYz page is None)rrrFrd failed to reshape  to , raised r_rKTc3.# UH ocMUv M g7fryrtrps rvr#TiffFile.asarray..s?1QQ pages are all None)(rrarrayrrr r_getlistrintegerslicerSrzrwrrrrrrrr squeeze_axesrrkeyframerr memmap_arrayr- read_arrayrr stack_pagesrtr7rmrr StopIteration)rkrrrrrrrrrrrtypecoderrpage0rs rvrTiffFile.asarray:s|^zz;;r? " ;6>F >JJEfn55))$/7 u-E ;  ^NN3'E c5==1 2 23s8_%E U # #JE X & &z#s/C/C'*+s!1XsE+EC49+N C. =CJ!O%CS/ ! K"!!-~~ (9(99H7?v{{h/F$V\\6;;?B ..sC((8O55V%6%6 ?'FLLAC33KK%% 4 Z1_!HE}$ o%]]:#F!:F!!! ;% %%7?v{{h/F$V\\6;;?B  E:D )Z1_!HE}$ o%^^7EKK MF  /???$ $$^^&-"ekk"B3F3FF A,~  H$$("?!<<.UG9SL4LJ $^^RL%Lu^EF4 3"#^^4foo3345,F. 3 4! /* o3. /sOOO"Q=" Q:-AP882Q2*Q51Q22Q55Q:= RRRrcUR(d Sn[U5eUcVUcSURU5Sn U(dUc#U RS:waURUSS9Sn U R UUUUS9$Uc URn O[ U[ 5(dCURU5Un U(dUc#U RS:waURUSS9Un U nUcUR UUUUS9$UbURUnUn [ U[[R45(aU [U5n U R XgS9$Sn[U5e) aReturn images from select pages as xarray DataArray. By default, the image array from the first level of the first series is returned. Parameters: key: Specifies which page to return as DataArray. By default, the image of the specified ``series`` and ``level`` is returned. If not ``None`` and an integer, the image from the specified page is returned. Requesting a DataArray from multiple pages (slice or sequence) is not supported. series: Specifies which series of pages to return as DataArray. The default is 0. kind: Series format kind, such as ``'ome'`` or ``'imagej'``. By default, the format is auto-detected. level: Specifies which level of multi-resolution series to return as DataArray. The default is 0. squeeze: Remove length-1 dimensions from image array, except X and Y. If ``False``, preserve all dimensions. If ``None`` (default), remove length-1 dimensions except for ``'shaped'`` series. maxworkers: Maximum number of threads to concurrently decode data. See :py:meth:`TiffFile.asarray` for details. buffersize: Approximate number of bytes to read from file in one pass. The default is :py:attr:`_TIFF.BUFFERSIZE`. Returns: :py:class:`xarray.DataArray` Image data with coordinates, dimensions, and attributes. z%empty xarray DataArrays not supportedrrTr)rrrr)rrz$key must be None or an integer index) rrr rrrrrrrr) rkrrrrrrrrrrrs rvrTiffFile.asxarraysqfzz9C%c* * ;6>  &q)A7?qvv/A$$T4$8;::%%   >JJEfn55$$T*62w166X3E((t(  &q)A7?qvv/A$$T4$8;882%262 2 >JJEfn55$$T*62w166X3E((t(.~s4#3a6#3rxz" LSM file incompletely written at )rrrrrrrrarangertdivmodrar@moveaxisrrrrlr7rmrr~)rkrnpagesrr positionsrindicesntimesdivmodrrwrappreviousoffsetnpirr currentoffsets rvrTiffFile._lsm_fix_strip_offsetsNs ??  % '  UQ{{ Aw$\\!_,  ,,v&..w7 q=F7c>#\\!_F!&!i-&*@A!8$C&s++"C3,,wu~6>>uE..!Q7 8   "U1X%9%9!%< <c4R4i(G<1EMD""=4#78!. "2 %[1D  ruc @URRRS:Xag[URSS9n[ U5S- n[ U5Hup4UR S-(aMURnURnX2:aXS-RSnO,[USSUS--URR5n[[[ U5S- 5Vs/sHoUS-XX- PM snXuS- /-5UlM gs snf)zSet databytecounts to size of compressed data. The StripByteCounts tag in LSM files contains the number of bytes for the uncompressed data. rYNc URS$r)rrs rvr4TiffFile._lsm_fix_strip_bytecounts..s q1Arur rTrrK)rrrrurrrrrrr#rr~r) rkrrrroffsetsr lastoffsetr2s rvr"TiffFile._lsm_fix_strip_bytecountss ::   ' '1 , tzz'ABUa 'GAzzA~&&G,,Jz"q5\55a8 !BK!jn"44dhhmm #(6;CL1 6. If the value of the CaptureMode tag is greater than 6, change the attributes of TiffPage instances that are part of the pyramid to match 16-bit grayscale data. TiffTag values are not corrected. NrTFrrYrrK)rrrvalueofrrlrrrr rFrrUINTrsamplesperpixelrrrr_dtyperrr)rkr capturemodermags rvrkTiffFile._ndpi_load_pagess kk&&..u5  +/   DdH-- --))##E*C{cAg#.#9#9 $0$5$5!'($%'"+0;;u||+DD T[;;r?Q& $ #2DI!%CRDJ"8DKK$4"8a"8DKruc>URS5(a`USS[R;aIUR(dg[ [ URR U55n[XU5 U$URR<SU<3n[U5e)z.Return ``is_flag`` attributes from first page.rrNFz object has no attribute ) rr PAGE_FLAGSrrrrrb __class__rr)rkrrOrs rv __getattr__TiffFile.__getattr__s} ??5 ! !d12h$//&A::!1!1489E D &L((++DTHMS!!rucU$ryrtrs rvrTiffFile.__enter__rruc$UR5 gryr r!s rvr%TiffFile.__exit__r'rucLS[URRS5<S3$)Nz.s!C]''))] rrTr c38# UHn[U5v M g7fryrzrrs rvrr  s(EAQrrTdetailrXrr...rc3D># UHnURTTS9v M g7frNr)rsubifdrrXs rvrr "s%+*4#KKvUKC*4s c3># UHPnURRRR(aM4URR TTS9v MR g7fr)rparentrclosedr)rrrrXs rvrr +sD$Azz((33::< vU;$s 3A!Ar+z _METADATA rXheightzSeries z coordsz attrs )%r0r#rbyteorder_isnativerrrZrrrrSr9discardrruformatr*rrksetrr _keyframehashaddrrrrrrNr?rindentrr_attrs)rkrrX info_listr9r detail_list frame_block seen_hashesrhis_framermrs `` rvr TiffFile._strs   & "$..11   %L9$..I  ??   Y ' tzz?Q    DJJ07 8 t{{ a    DKK 019 : t{{ a    DKK 018 9   #djj/Q"6 MM) $!CVE]!CCDyy#{{ DHHMM3r519s4y+@#A B  Q;Kf ;;   tyy(E(EE F Q;%'K$'EK dI..~~1 II#*#H A /HOOA&&&tyyy'GH"!A:#k*:R*?16K"-#**499[+AB&( &&tyyey'LMzz-#**+*.**+)#0A:#k"2R"7).K"%""499[#9: [[     ZZ      %%V5%A  Q;tzz*4 !344[&89Aq#**#zz|nK&qfrkJKM + A:$++[[99&&%ahhZw7#AHHE&2+N 888&&%ahhZv6#AHHE&2+N!{{;''ruc[RVs1sH)n[USU-5(dMUR5iM+ sn$s snf)z2Set of file flags. May be expensive to compute. r)rrarrrkrs rvr9TiffFile.flagsOsC 'tUT\* DJJL'   AAcURnURnUR(agUR(dUR (agSnUR nSUlURnSH+nXR5RU:wdM% XAlg XAlg![a gf=f![a US:HsXAl$f=f!XAlf=f)z&File contains uniform series of pages.FTr)rYrrKrY) rr IndexErrorrpriis_nihrlr#aspage)rkrrrrlr+s rv is_uniformTiffFile.is_uniform\s  ;;D <<     OO  (#EO A8??$))Q. (O  (O%   6M'O (OsA B*6B:B: B:* B76B7:C CCCCcUR=(dX UR=(dE UR=(d2 UR=(d UR=(d UR (+$)z1Pages can be appended to file without corrupting.)rdrgis_stkr is_fluoviewis_micromanagerrs rvrYTiffFile.is_appendablezs[ KK ${{ ${{ $~~ $  $ ##   ruc.URR$)zFile has BigTIFF format.)r"rZrs rvrZTiffFile.is_bigtiffsyy###rucHURnUbURSS5S:agURR(dg[R R [R RURRS55nU(aSUl U$)zFile has NDTiff format. MajorVersionrrTF NDTiff.indexT) micromanager_metadatarSris_filerpathexistsrdirnamer7)rkmetaisndtiffs rv is_ndtiffTiffFile.is_ndtiffsx)) <488NA6:&&77>> GGLL00. A  "DOrucvURnUb*SU;a$SU;aURSS5S:XaSUlgg)z$File has Micro-Manager stack format.SummaryIndexMaprArYrTF)rCrSr7)rkrHs rv is_mmstackTiffFile.is_mmstacksG))  T!d"+q0#DOrucURRRnURR SSS9RnU=(d UnU(aSUlU$![a gf=f![a SnN9f=f)zFile has MD Gel format.FrYTr)rris_mdgelr4rSr7)rkpage0_is_mdgelpage1_is_mdgelismdgels rvrSTiffFile.is_mdgels  !ZZ--66N #!ZZ^^AT^:CCN!2N #DO   #"N #s" A"$A2" A/.A/2 BBcURRR=(a. URR 5R S5(+nU(aSUlU$![ a gf=f)zFile is Olympus SIS format.z.vsiFT)rris_sisrrendswithr4r7)rkississ rvrYTiffFile.is_sissg    ''? ++-66v>>  "DO   sAA'' A43A4cURRnUR=(a UR$![a gf=f)zFile is Aperio SVS format.F)rrr4is_tiledis_svs)rkrs rvr_TiffFile.is_svss? JJ$$E~~.%,,.  s7 AAc[UR5S:XdUR(agURRSSS9R 5R $![ a gf=f)zRFile contains embedded C2PA manifest in last page. A potential expensive check. rYFrKrR)rrrirSr6is_c2parrs rvrbTiffFile.is_c2pas\ tzz?a 4#4#4 ::>>"E>299;CC C  s1A A,+A,c*UR(dg/nURH\nURS:waMURRcM.UR [ URR55 M^ [U5=(d S$)z "./4{{'* ' 5 ' 5'+'',R0'/ 0F:+,/$ !/3F:+,H$$(-uHSL4LIs*<)F%F 7 F F G,G  GcrUR(dgURRnURcg[ UR5nUR R S5nUbURU5 U$U$![a,n[5RU<SU<S35 SnAU$SnAff=f)z:ImageJ metadata from ImageDescription and IJMetadata tags.Nz raised r_) rrrr2imagej_description_metadatarrr rr7rm)rkrrrOrs rvimagej_metadataTiffFile.imagej_metadata_s~~zz  " " *,T-D-DE !!%(    e$  v    h8 t E  s+B B6 !B11B6cnUR(dg0nURRnURR S5nUbUR U5 URR S5nUbX1S'U$![ a+n[5RU<SU<S35 SnANTSnAff=f)z3FluoView metadata from MM_Header and MM_Stamp tags.N9z raised r_:Stamp) r;rrrrr rr7rm)rkrrrOrs rvfluoview_metadataTiffFile.fluoview_metadatarszz !!%(    e$  !!%(  #7O %   h:3,,G s A?? B4 !B//B4cUR(dgURRRR S5$)z*NIHImage metadata from NIHImageHeader tag.N2)r5rrrrrs rv nih_metadataTiffFile.nih_metadatarrucUR(dgURRRn0n[R "[ 5 URURS55 SSS5 [R "[ 5 URURS55 SSS5 U$!,(df  NS=f!,(df  U$=f)z&FEI metadata from SFEG or HELIOS tags.Nxz) is_feirrrrrrr r)rkrrs rv fei_metadataTiffFile.fei_metadatas{{zz$$   + MM$,,u- .,   + MM$,,u- ., , + + + s!B=!C= C  CcUR(dgURRRR S5$)zSEM metadata from CZ_SEM tag.NF)is_semrrrrrs rv sem_metadataTiffFile.sem_metadatarrucUR(d&URRR(dgURRRn0nUR S5nUbUR U5 UR S5n[ U[5(aUR U5 U=(d S$)z9Olympus SIS metadata from OlympusSIS and OlympusINI tags.N鿂)rYrrrrr rdict)rkrrrOs rv sis_metadataTiffFile.sis_metadatas{{4::#3#3#:#:zz$$ U#   MM%  U# eT " " MM% ~rucUR(dgSURRR;a!URRRnO<[ [ URS5nSUR;a URnOg0n[SS5H3nXA;aM [RUnURU5X5SS'M5 U$![ a gf=f)z$MD-GEL metadata from MDFileTag tags.N饂rYirT) rSrrrr_rr4rrrr)rkrrrrrs rvmdgel_metadataTiffFile.mdgel_metadatas}} DJJ$$)) )::##((D Hdjjm4 !yy%'D99T?D#||D1F8  (    sC C('C(cfUR(dgURRR$)z#EER metadata from tags 65001-65009.N)is_eerrreer_tagsrs rv eer_metadataTiffFile.eer_metadatas${{zz(((rucfUR(dgURRR$)z!Nuvu metadata from tags >= 65000.N)is_nuvurr nuvu_tagsrs rv nuvu_metadataTiffFile.nuvu_metadatas$||zz)))rucBURRR$)zAndor metadata from Andor tags.)rr andor_tagsrs rvandor_metadataTiffFile.andor_metadatazz***rucBURRR$)z&EPICS metadata from areaDetector tags.)rr epics_tagsrs rvepics_metadataTiffFile.epics_metadatarrucUR(dgURRRR S5$)zTVIPS metadata from tag.NJ)is_tvipsrrrrrs rvtvips_metadataTiffFile.tvips_metadatas/}}zz$$,,U33rucxUR(dg[URRR5$)z.>.J.JKKrucUR(dg[URRRUR 5$)z4Hamamatsu streak metadata from ImageDescription tag.N) is_streakstreak_description_metadatarrrrrs rvstreak_metadataTiffFile.streak_metadata:s4~~* JJ   ( ($//  rucUR(dgURRS5R5RR S5$)z6C2PA manifest from C2PAManifestStore tag of last page.NrKA)rbrrSr6rrrs rv c2pa_metadataTiffFile.c2pa_metadataCs;||zz~~b!((*//77>>ru) rUr#rSrr$rPrTrRrdr7rr")rr-rLiteral['r', 'r+'] | NonerrQrr3rr3rrQrr3rr%rr%rPTiffFile | Nonerr%r6r)r6Literal['>', '<']rCrK)r6rr6rgrBry)r"int | slice | Sequence[int] | Nonerint | TiffPageSeries | NonerrQrr3rr%rrwrr3rr3r6 NDArray[Any])rrrrrrQrr3rr%rr3rr3r6rn)rr3rrrrQrr3rr%rrgr6 ZarrTiffStore)r6r#)rrQrrr6list[TiffPageSeries])rrzr6rgrFrGrOrrrXrr6rzr6set[str]r6r)r6z!tuple[dict[str, Any], ...] | Noner6rQr6r*r6r9)IrrrrrrLrnrMrrrryrXr|rrrrrr rhrrrkrrr%r+rrr9r7rYrZrJrOrSrYr_rbrgrjrnrsrwr{rrrrrrrrrrrrrrrrrrrCrrrrrr rr rtrurvrrKs(T ) ) O O N && @@55+/!!#"&"&!%H=H ( H  HHHHH H HH H HT###37I/3 #!%!%I /I, I  I  IIIII IZ37Y'/3 #!%!%Y' /Y', Y'  Y'  Y'Y'Y'Y' Y'zB/3 #B B, B  B  BBB BH  &       B%.:2x:9> ",((   Ek(Z    :    $$    "  //   % %,,,, ,, ,, ,, 44 44 ,,\$<44   44  .)) ** ++++44 MMJJ 44 *-- 44 77LL   ??rurc2\rSrSr%SrSrS\S'S\S'S\S'S \S 'S\S 'S \S 'S\S 'S \S'S \S'S \S'S\S'S\S'SSjr\SSj5r \SSj5r SSjr SSjr SSjr SSjrSrg) riKzTIFF format properties.) _hashrrgrD tagformat1 tagformat2tagheaderformatrC tagnosizetagoffsetthresholdrErnrrnrrrDrzrgr'rCrEr$r%r&r(r#c XlX lX0lX@lXPlX`lXplXlXlXSS-Ul Xl [XU45Ul gNrY) rnrrDrgr'rCrEr$r%r&r(r#r#) rkrnrrDrgr'rCrEr$r%r(s rvrnTiffFormat.__init__s[ "$("& $$)qrN:"47z:; ruc URS:H$)zFormat is 64-bit BigTIFF.rO)rnrs rvrZTiffFormat.is_bigtiffs||r!!rucLURS:H=(a URS:H$)z7Format is 32-bit TIFF with 64-bit offsets used by NDPI.rRrP)rnrDrs rvrYTiffFormat.is_ndpis!||r!:doo&::ruc[U[5(d[$URURUR 4URURUR 4:H$ry)rrNotImplementedrnrrDrkothers rv__eq__TiffFormat.__eq__sR%,,! ! dnndoo> MM OO   C   rucUR$ry)r#rs rv__hash__TiffFormat.__hash__s zzrucURS:XaSOSnURS:XaSOSnUR(aSOSnS US US US 3$) NrR3264rsrJbigz with 64-bit offsetsz# UH/nURS5(aMUS[TU5<3v M1 g7f)r: N)rr)rrrks rvr%TiffFormat.__str__..s90Ds+34&74.120s::)r%reprr __slots__rs`rvrTiffFormat.__str__s/ J &00  ruN)rnrrrrDrrgrzr'rrCrzrErr$rzr%rzr(rr6rrr3objectr6rr6rrK)rrrrrrGrLrnrMrZrYr4r7r+rr rtrurvrrKs! IL!  #O%*N+0 L%O7O8FE J<<%< <  <  <<<<< < <4"";; I  rurc \rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S \S'S\S'S \S'S \S'S \S'S \S'SrS\S'SrS\S'SrS\S'Sr S\S'Sr S\S'Sr S\S'Sr S\S'Sr S\S'SrS\S'SrS\S 'S!rS\S"'SrS\S#'SrS\S$'SrS\S%'SrS\S&'SrS\S''S(rS \S)'S*rS+\S,'S*rS-\S.'S*rS/\S0'S*rS/\S1'S2rS\S3'S2rS\S4'S2rS\S5'SrS6\S7'S*S8.SS9jjrSS:jr \!SS;j5r"\#Sjj5r$\#S\+SS_j5r?\!SS`j5r@\!SSaj5rA\!SSbj5rB\!SScj5rC\!SSdj5rD\!SSej5rE\!SSfj5rF\!SSgj5rGSShjrHSSijrISSSjjjrJSSkjrK\!SSlj5rL\!SSmj5rM\!SSnj5rN\!SSoj5rO\!SSpj5rP\!SSqj5rQ\!SSrj5rR\!SSsj5rS\!SStj5rT\!SSuj5rU\+SSvj5rV\+SSwj5rW\+SSxj5rX\+SSyj5rY\+SSzj5rZ\+SS{j5r[\+SS|j5r\\+SS}j5r]\+SS~j5r^\+SSj5r_\+SSj5r`\+SSj5ra\+SSj5rb\+SSj5rc\+SSj5rd\+SSj5re\+SSj5rf\+SSj5rg\+SSj5rh\+SSj5ri\+SSj5rj\+SSj5rk\+SSj5rl\+SSj5rm\+SSj5rn\+SSj5ro\+SSj5rp\+SSj5rq\+SSj5rr\+SSj5rs\+SSj5rt\+SSj5ru\+SSj5rv\+SSj5rw\+SSj5rx\+SSj5ry\+SSj5rz\+SSj5r{\+SSj5r|\+SSj5r}\+SSj5r~\+SSj5r\+SSj5r\+SSj5r\+SSj5r\+SSj5r\+SSj5r\+SSj5rSrg*)riaTIFF image file directory (IFD). TiffPage instances are not thread-safe. All attributes are read-only. Parameters: parent: TiffFile instance to read page from. The file handle position must be at an offset to an IFD structure. index: Index of page in IFD tree. keyframe: Not used. For API compatibility with TiffFrame. Raises: TiffFileError: Invalid TIFF structure. r&rrrrrtuple[int, ...]rr1rtuple[int, int, int, int, int]rrzrrrrrrr imagewidth imagelengthrY imagedepth tilewidth tilelength tiledepthrrrrrr fillorderrrrtrNr8rr/rpr9r jpegheaderr=rr description1floatnodatarc $^&^'^(URnXlSUlSUlS=UlUlSUl[5=UlnSUl SUl [U[5(a U4Ul O[U5Ul URnUR!5Ul[$R&"UR(UR+UR,55SnUS:aSU3n [5U 5eUR"UR,-n UR6=pUR+X-5m&[9T&5X-:wa Sn [5U 5eUR:(a[S n UR=S [>R@5 UR+S U-5m'S RCU&U'4S j[EU555m&U *n [EU5H9nX- n T&XU -n[FRIXX--US9nURMU5 M; U(dg[9U5S:XaSU;ag[NRPRS5HFunnURUU5m(T(cMUS;a[T([V5(dM9[YUUT(5 MH URUSSS9m([T([V5(aT(Ul-UR\S:Xa-URUS5m(T(S:XaSUl.O^T(S:XaSUl.OP[UR\[5(d1[K5R_U<SUR\<35 SUl.URUS5nUcGURUS5nUc3URUS5nUcSn[K5R/U<S35 UUl AURUS5nUcGURUS5nUc3URUS 5nUcSn[K5R/U<S!35 UUl AUR`S";a[9UR5S:XaURSS:aUR(aURSS:XadURSnURc5nUU:a UU- 4Ul OURfU- 4Ul [K5R_U<S#35 URhS:XaURjS:XaUR(aUR(aUR=URS5 [mUR+[oURSS555unnnnUUl5UUl4UUl8S$U;aUS ::aS OS Ul9S%U;aUS:Xa[tRvUl<S&U;a[zR|Ul0S'U;aUUl?GO-UR`S(:XamS%U;a[tRvUl<O%URxS:Xa[tRvUl<S$U;aS Ul9S)U;aURxS*;aSUl8GOUR(d+URS:waeURR(aJUS$R5 UR`S:Xa%URS:wa[RUlCGO*UR(d+URS:wa$URR(a SUlGGOUR(d+URS:wa+URR(aSUlGSUlIGOUR(aURS+5nUceUR=UR5 URS,5n[UURURURSUb UROSS-9UlPGOUR(aUR`S/;aS=nnUR`S0:XaJ[URRUS1S55n[URRUS2S55nU=RhS[oUUR5--sl4U=RjS[oUUR5--sl5U=R~S[oUUR5--sl?URS35nUb4[URUS4RUR5UlPURUS$5m(T(byURrS:waOhUS$RS:Xa[T(5Ul9ODT(SURpm([U(4S6jT(55(aT(Ul9O[T(S5Ul9URUS75m(T(buUS7RS:Xa[T(5UlUOT(SURpm([U(4S8jT(55(a[T(5UlUOv[T(S5UlUOaURrS9:XaQUR(d+URS:wa0URR(a[RUlUS:U;aSUl?OUS;U;aOS'U;dUS'RS:aURjUl?[oUR~URj5Ul?[NRRURURr4S5nUb[R"U5OSnU=UlUlURjnURhnURn URpnURxS:XdUS:a~URS:Xa7SU UUU4UlU S:XaUUU4UlSUlOGUU UU4UlS?UlO4SU UUS4UlU S:XaUU4UlS@UlOU UU4UlSAUlUR(dX[UR5URrS --4Ul UR`S:wa[K5R/U<SB35 U(Ga9UR~(Ga'UR(Gd[R"UUR~- 5UR-n!URS:XaU!URp-n!U![9UR5:waJ[K5R/U<SC[9UR5SDU!SE35 URSU!Ul U![9UR5:waJ[K5R/U<SF[9UR5SDU!SE35 URSU!Ul URUSG5m(T(bUb[URS5R55n"T(RSHSI5m(U""T(5Ula[R"[R"UR5U5(d4[K5R_U<SJUR<SKU35 SUlaURUSM5n#U#GbNUR:(Ga;U#R[R5n#URUSN5n$U$bFU$R[R5n$U$S9-n$U#U$R[R5- n#UR=URS5 UR+U#S5n%[U%5uUljUlkUll[R"U#URSSO9n[UR55Ul U#URS- n#[U#R55Ul ggg![$R.[0[24a nSUR"3n [5U 5UeSnAff=f![4a*n[K5R/SU<S35 SnAGMSnAff=f![da SnG NYf=f![da GNf=f![da,n[K5R_U<S.U<S35 SnAGN"SnAff=f![da,n[K5R_U<S5U<S35 SnAGNSnAff=f![2a [T(5UlUGNf=f![2a [T(5UlUGNf=f![2a [T(S5UlUGNf=f![2[[4a3n[K5R_U<SLU<S35 SUlaSnAGNSnAff=f![2a+n[K5R_U<SPU<S35 SnAgSnAff=f)QNrt)rrrrrr=rcorrupted tag list @suspicious number of tags zcorrupted IFD structurerrPrruc3^># UH"nTUS-US-S-TUS-US-S--v M$ g7f)rrNrt)rrrexts rvr$TiffPage.__init__..sC%AQVa"frk*SQQ-CC%s*-rrmz raised r_rYr >rrrrrrTrz invalid self.subfiletype=rrz missing data offset tagrrz missing data ByteCounts tagrTrrz1 estimating ByteCounts for CCITT compressed striprrrrrr>rrYrTrrr) planecountz raised rrkrz# raised c32># UH oTS- v M g7fr0rtrrrOs rvrrba3U58|Urc32># UH oTS- v M g7fr0rtrps rvrrbprqrrr)rrYXSZYXSSYXSZYXYXZYXz missing ByteCounts tagz" incorrect StripByteCounts count (r)z incorrect StripOffsets count (遤,.z, parsing GDAL_NODATA tag raised ValueError: z is not castable to z parsing GDAL_NODATA tag raised )rz" raised )or"rrrrrrr&rrrrrrr~rrXrrererCrr'rr]rrrErrYr\rrrrr$fromfiler7r$rTAG_ATTRIBUTESr`rrzrbrXrrmr_nextifdrrrOrP jpeg_shaperrrr rIrrOJPEGrrgr_fix_lsm_bitspersamplerrris_vistarQrrrTr:rSr read_uic1tagrrrOrRrr;rrrvIEEEFP SAMPLE_DTYPESrrr@rorprwitemreplacerZcan_castmin_scalar_typerrr,int64uint64ndpi_jpeg_tilerSrRrWdifftolist))rkrrrr"rrltagnorrrrEtagsize_rrtagdatarrrrrrnextifd precisionrPrOrrhorzbitsvertbitsdtypestrrrQ maxstripspytype mcustartshighrWrrarOs) @@@rvrnTiffPage.__init__MsO{{  % #'' T[ #:% D  eS ! ! (DK,DK  ggi  .  "''$.."9E 4<.ug6C$ $KK$..0 !\\)www' t9 '+C$ $ <<G GGAr{{ #''!e)$C88uD 8uA  H8&89G &&q|#;G' HHSM  t9>etm --335JD$LL&E}z!*UC*@*@ D$ &6 S * eS ! ! %D    q LL%Ez#& !#' D,,c22 H  x'B1A1A0CD E D ll3'  ,,s+K""ll3/ &"$KHNNdX-E#FG& c*  !!\\#.N%!%c!2!)%'NHNNdX-I#JK,     )D$$%*  #a'((D,?,?,Ba,G ))!,J --/#'.';&=#')ww';&=# H  (KL  OOq   A%  ## 4((+, rwws4+>+>q+A4'HIJ # $/ ",'6$d?.71n"D&d?!';'2'8'8D$d?'2'8'8D$d?(3D%    "$#.#4#4 !!Q&#.#4#4 $%&"$4#3#3|#C'($ [[TZZ1_1C1C I , , .1$1)?#D 1$$)@AB 4,,,T[[[ +(9(99:T__L   A%T111 C 3 344hD//01i[C'+&9&9*9&E#C 0 011hD,,-.d9+Q@$(#3#3JY#?  U#  !2 $ejjm0023 c3/$Um ~~))$++6H$$("N;;/)=eWF#$DKLL'  T\\\!((5I<<&D{{5<<0 T[[55 GGD$$Q' (1.J = #:. ONO"'d&9&9!&<"',N,A,A,C&D#T--a00 #()9)9);#< 9&2 Y  gz2 .( 6C$# - .B! !;C<$<HI n  4  z   h>slTlK .   hA#N 4"3(+E D%3&7,/J)7 &:,/aM):` >:   h>slTlK   B   h@ t M s0(=AAAB!>ACAAC+AAC< 3AD5AE.AFAF0AAGAHAABA>ABBABB! ACB+ACCACC AC(C'AC(C+ AC9C8AC9C< AD2D!AD-D-AD2D5 AE+D?!AE&E&AE+E.AF F AF FAF-F,AF-F0AGGAGGAHG)(AHHAHH AIH)!AIIAIcUR g)a8Initialize decode function from the main thread. :py:meth:`decode` is a :py:func:`functools.cached_property` and is not thread-safe on first access. Call this method from the main thread before decoding segments concurrently to avoid a race condition where multiple threads compute the decoder simultaneously. Nrrs rv init_decodeTiffPage.init_decodes  ruc ^^^^^^^^^^^^^^^^ ^!^"^#^$^%^&^'^(^)^*^+^,^-^.^/^0^1^2^3^4^5^6^7^8TRTRRR;a-TRRRTR$U4SjnTRb TR c,STR STRS3nUS.SjnU"U5$STR;a S nU"U5$TRS ;aKTRR(d0[[TR55S S nUS.S jnU"U5$TRS :XaSmO[RTRmTRS :XaSm4O[R TRm4TR(R+S5bQTR(Sm2T2R,S :wa2[/U24SjT2R055(aU24SjnU"U5$TR2(a+TRS;dTR4S:Xa Sn U"U 5$TRS:XaTR6S:XaSOSjn U mTR8(aATR:TR<TR>TR4S :Xa TR6OS 4m.O6S TR@TRBTR4S :Xa TR6OS 4m.T.um,m-m/m*TRun mmm m*TRDm$TRmTR8(a[FRH"T T/- 5m8[FRH"TT-- 5m#[FRH"TT,- 5mT8T#-mTT-m7SPUUU#U,U-U.U/U7U84 Sjjm!SQUUU U*4Sjjm(SRU$4Sjjm&SSSjm'OS[FRH"TT-- 5m#SPUUU#U*U,U-U/4Sjjm!SQSjm(SRU$U-4S jjm&SSU-4S!jjm'TRS;aTRJS:Xa[%5RMT<S"35 T4(a[%5RMT<S#35 S$TR(;a[%5R'T<S%35 [OTRPTR4TRRTRT5umm%SSS&S'.STUUU!U%U&U'U(4S(jjjn U"U 5$TRS ;aS=mm6TRS):Xap[WTR(RYS*S+55m+[WTR(RYS,S55m[WTR(RYS-S55m6OTRS.:XaS+m+OS/m+TRRZm0SSS&S'.STUU!U'U+U0U64S0jjjn U"U 5$TRS1:Xa(TceSSS&S'.STUU!U'4S2jjjnU"U5$TRS3;aTRJS:Hm5TRS:Xa[\R^mOPTRS4:Xa0[WTR(RYS5S55m1SS6.U14S7jjmO[\R`mSSS&S'.STUU!U&U'U(U/U54S8jjjnU"U5$TR[R";aTRJS:Xa)[%5RMT<S9TR35 T4(a)[%5RMT<S:TR35 TceSSS&S'.STUU!U&U'U(4S;jjjnU"U5$[bR"TRRdTR Rf-5mTR S<:XaT4b S=n[iU5e[bR"TRRdS>TRS?-35m"[bR"TRRdS@TRjS-35mSUUUU"4SAjjm3OTRSB;apTRT/-T*-S/-(a SCn[mU5eTRSD;a*[bR"TR Rf5mTS/-mSUUU4SEjjm3Oq[oTR[p5(a SUUU4SFjjm3OHTRSG:Xa)TRfS@:XaT4b SHn[iU5eSUU4SIjjm3OT/T*-m)SUUUU)4SJjjm3TRfmTRjmTRJS:Hm5Tc#T4c SSS&S'.STUU!U&U'U(U3U54SKjjjnOvTb%T4c"SSS&S'.STUUUU!U&U'U(U3U54 SLjjjnONTc$T4b!SSS&S'.STUU!U&U'U(U3U4U54SMjjjnO'TceSSS&S'.STUUUU!U&U'U(U3U4U54 SNjjjnU"U5$![a'n[U5S S nUS.SjnU"U5sSnA$SnAff=f![avnTR[R";a1[%5R'T<STR35 Sm4SnAG N![U5S S nUS.SjnU"U5sSnA$SnAff=f)VavReturn decoded segment, its shape, and indices in image. The decode function is implemented as a closure and has the following signature: Parameters: data (Union[bytes, None]): Encoded bytes of segment or ``None`` for empty segments. index (int): Index of segment in Offsets and Bytecount tag values. jpegtables (Optional[bytes]): For JPEG compressed segments only, value of JPEGTables tag if any. Returns: - Decoded segment or ``None`` for empty segments. - Position of segment in image array of normalized shape (separate sample, depth, length, width, contig sample). - Shape of segment (depth, length, width, contig samples). The shape of strips depends on their linear index. Raises: ValueError or NotImplementedError: Decoding is not supported. TiffFileError: Invalid TIFF structure. cb>UTRRRTR'U$ry)rryrUr#)rrks rvrTiffPage.decode..cacheDs&4:DKK   & &tyy 1MruNz&data type not supported (SampleFormat rz-bit))rc[U5eryrrargsrs rvdecode_raise_dtype+TiffPage.decode..decode_raise_dtypeO  o%rurcSn[U5e)Nz empty imagerrrrs rvdecode_raise_empty+TiffPage.decode..decode_raise_emptyVs# o%rurirYrKc[U5eryrrs rvdecode_raise_compression1TiffPage.decode..decode_raise_compressioncrruc[U5eryrrs rvrrprruz ignoring predictor c[U5eryrrs rvdecode_raise_predictor/TiffPage.decode..decode_raise_predictors $S/)rurc3F># UHoTRS- v M g7fr0rO)rrrs rvr"TiffPage.decode..s%J 1#))A,&6 !c8>STR3n[U5e)Nzsample formats do not match )rOr)rrrrs rvdecode_raise_sampleformat2TiffPage.decode..decode_raise_sampleformats8 DC$S/)rurrTcSn[U5e)Nz9chroma subsampling not supported without JPEG compressionrrs rvdecode_raise_subsampling1TiffPage.decode..decode_raise_subsamplingsO*#..rurrc.[R"USUS9$)NT)hasalphar)r( webp_decode)rrrs rvdecompress_webp_rgba-TiffPage.decode..decompress_webp_rgbas"..tdLLrucL> UT-UT-T-T-UT -T-T-UT -T-S4T4$rrt) segmentindexarearZrYstdepthstlengthstshapestwidthvolumerXs rvr TiffPage.decode..indicessU%.%-6@%.&88C$u,w6   ruc Z>USUS-US-US-nURS:XaURU:aUSUnURU:XaURU5$UR[TUS- US5[TUS- US5[TUS- US5T45$![a Of=fUR[TUS- US5[TUS- US5UST45$![a Of=fSUSUR SU3n[ U5e)NrrYrTrzcorrupted tile @ z cannot be reshaped from r)rrrtrrrr) rrrrrimdepthimlengthimwidthr\s rvrt TiffPage.decode..reshapes{Qx%(*U1X5a@99>dii$&6;D99$ <<..  <<'!* 4eAh?71: 5uQx@'!* 4eAh?# "  <<'!* 4eAh?71: 5uQx@!!H# "(y0Izzl$ug/$C((s% A B.. B;:B;?=C== D  D c>URU:XaX4$[XRSS9VVs/sH up#SX#- 4PM nnn[R"XTS9nX4$s snnf)NTr4rconstant_values)rrrr)rrrr2padwidthrZs rvrTiffPage.decode..padsh::&;&+.ujj+N+N41QJ+NyyH{" sAcU$ryrtrs rvpad_none!TiffPage.decode..pad_nones  rucn>UTT--UT-T-T-UT-T-SS4nT[TTUS- 5T T4nX4$)NrrT)r) r segindicesrrrrYr\rrrs rvrrsn!Vg%56!V+w6@ 6)H4  (Z]":;  "((rucUSUS-US-US-nURS:XaURU:aUSUnURU:XaURU5$URnURUSSUSUS4SS9nUSS2SUS24nURUSS9nU$![a Of=fSUS U3n[ U5e) NrrYrTrrKFrz(corrupted strip cannot be reshaped from r)rrrtrrr)rrrrrrs rvrtr.s Qx%(*U1X5a@99>dii$&6;D99$<<.. JJ   <<q2uQxq:(D :U1X: .D<<E<:D K" ? keW.$C((s+;B(( B54B5c>USTUSUS4nURU:XaX4$SSTURS- 4SS/n[R"XTS9nX4$)NrrTrr}rYr)rrr)rrrrZrs rvrrNsrq8U1XuQx@::&;&4::a=01  yyH{"ruc">USTUSUS4$)NrrTrrt)rrs rvrr^s a(E!HeAh??ruz disabling LSB2MSB for JPEGz disabling predictor for JPEGpz@ SonyRawFileType might need additional unpacking (see issue #95)F)rrW _fullsizec >T "U5upVUcU(aT "U5nXU4$[R"UTUUT T USSS9nT"XuU5nU(a T "Xv5upvXuU4$)NrYr)rtablesrmrrr)r( jpeg_decode)rrrrWrrr data_arrayrrrrrrrts rv decode_jpeg$TiffPage.decode..decode_jpeg|s'.en# < (u44+6+B+B"/%%)"/!*, %ZuE (+J(>%J!66rurkrrlrmrjrPc >T "U5upVUcU(aT "U5nXU4$[R"UUSST TT T S9nURU5XV4$)NrYr)r)r( eer_decodert)rrrrWrrrrrrrskipbitsrrs rv decode_eer#TiffPage.decode..decode_eersm'.en# < (u44(33!AJ%  "))%0,EErurc>T "U5upVUcU(aT "U5nXU4$[R"U[R5nT"XS9 URU5XV4$)Nr)rzerosrrt) rrrrWrrrr decompressrrs rv decode_jetraw&TiffPage.decode..decode_jetraws_'.en# < (u44"[[ = 40!))%0,EErurgr$rc2>[R"XUTUS9$)N) t4optionsr)r(ccittfax3_decode)rrrXrrs rvccitt_decompress)TiffPage.decode..ccitt_decompresss!'77eycruc>T "U5upVUcU(aT "U5nXU4$T(a[R"U5nT"XST 5nT "XuU5nU(a T "Xv5upvXuU4$r*)r(bitorder_decode)rrrrWrrrrrrrrrtr use_bitorders rv decode_ccitt%TiffPage.decode..decode_ccitts|'.en# < (u44&66t%J!66ruz# disabling LSB2MSB for compression z% disabling predictor for compression c>T "U5upVUcU(aT "U5nXU4$T"U5nT "XuU5nU(a T "Xv5upvXuU4$ryrt) rrrrWrrrrrrrrrts rv decode_image%TiffPage.decode..decode_images^'.en# < (u44'- $ZuE (+J(>%J!66rurz+unpredicting complex integers not supportedrrrcn>[R"UT5RT5RT5$ry)r frombufferr,view)rrftypeitypes rvreTiffPage.decode..unpack@s,''e4;;EBGGNNru>rPrr)@rzdata and sample size mismatchrc>[R"UT5$![a. [U5T-T-n[R"USUT5s$f=fry)rrrr)rrr*rs rvrer QsY@ ++D%88!@I,3D ++D$K??@s5AAc2>[UTTR5$ry) unpack_rgbr)rrrks rvrer ^s!$t/A/ABBrurz"unpredicting float24 not supportedcV>[R"UTRRS9$)Nr)r(float24_decoderr)rrks rvrer is%"11DKK$9$9ruc2>[R"UTTTS9$)Nr&)r(packints_decode)rrrr's rvrer ss"22%vruc>T "U5upVUcU(aT "U5nXU4$T(a[R"U5nT "U5nT "XuU5nURST-SS9nU(a T "Xv5upvXuU4$)NrHFrr(rr,)rrrrWrrrr dtypecharrrrrtrers rv decode_other%TiffPage.decode..decode_others'.en# < (u44&66t%J!66ruc0> T "U5upVUcU(aT"U5nXU4$T(a[R"U5nUSUS-US-US-nT "XT -S9nT"U5nT"XU5nURST -SS9nU(a T "X5upXU4$) NrrYrTrrrHFrr)rrrrWrrrrrrr dtypeitemsizerrrrtrers rvrrs'.en# < (u44&66t%J!66ruc>T "U5upVUcU(aT "U5nXU4$T(a[R"U5nT "U5nT "XuU5nURST-SS9nT"USUS9nU(a T "Xv5upvXuU4$)NrHFrryr rr)rrrrWrrrrrrrrrtre unpredictrs rvrrs'.en# < (u44&66t%J!66ruc@> T "U5upVUcU(aT"U5nXU4$T(a[R"U5nUSUS-US-US-nT "XT -S9nT"U5nT"XU5nURST -SS9nT"US US 9nU(a T "X5upXU4$) NrrYrTrrrHFrryrr)rrrrWrrrrrrrrrrrrtrerrs rvrrs'.en# < (u44&66t%J!66rury)rrr6z@tuple[tuple[int, int, int, int, int], tuple[int, int, int, int]])rrrrNrtuple[int, int, int, int]r6r)rrrr r6z.tuple[NDArray[Any], tuple[int, int, int, int]])rr r6r ) rzbytes | bytearray | Nonerrrr9rWr9rrr6r)rzbytes | bytearrayr6r)9r#rryrUrrrrrrrrzrr DECOMPRESSORSr UNPREDICTORSrQr7rmrrSrr;rO is_subsampledrrr^rTrSrRrrOrZrorprVdebugjpeg_decode_colorspacerris_jfifrrrRr(ccittrle_decodeccittfax4_decoderrrrrrrr~)9rkrrrrrrrrrrrrrrrrrrrr*rrrrZrrrr rrrrrr rYrZrrrrtr'r\rrrrrrrrrerrrrrXs9` @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@rvrTiffPage.decode!s_ @ 99 ((22 2;;##--dii8 8  :: !4!!%!2!2 32%%&e-  /2 &+, ,   &+, ,    5 5KK&&ht//01!B7C47 &12 2 31$! !//0@0@A  5~~"  --dnn= 99==  )))C.CyyA~#%J %J"J"J*677      $8 8  A% / 12 2   u $)=)=)B M.J ==(,(9(9Q(>$$A G!!(,(9(9Q(>$$A G/6+7G15.7Hgw** ==IIg/0EYYx(23FIIg/0E6>DE\F !   "- )"- )7- )1- )  - )- )^ #" #+D #? # 0 * YYx(23F )! ) ) )* )" )7 )1 )   )@ #" #+D #? # #  @0 @* @   3 3~~"$)DEF$)FGH !  h00)?  !!!! ) %J ,0+/"' 7. 7 7 )  7 )  7  7 7 7:% %   4 4"# #Hx5(tyy00:;tyy00:;tyy00:;!!U*{{,,H,0+/"' F. F F )  F )  F  F F F2$ $   u $) )),0+/"' F. F F )  F )  F  F F F&' '   y ( >>Q.L1$#.#>#> !!Q& 1 1#q 9: 48$/#?#? ,0+/"' 7. 7 7 )  7 )  7  7 7 72& &   t66 6~~"h99=9I9I8JLh;;?;K;K:LN) )),0+/"' 7. 7 7 )  7 )  7  7 7 7.& & DKK11DKK4D4DDE    !$C)#..KK;;(()4+=+=+C*DEEKK;;(()5>>Q+>*?@E O O  #7 7""W,w6!;5 o%~~!22 DKK$4$451$C @ @**E 2 2 C C  2 %%***;$:)#..  w&F   JJ  ~~*  )"3,0+/"' 7. 7 7 )  7 )  7  7 7 70 # (9,0+/"' 7. 7 7 )  7 )  7  7 7 7 76 I$9,0+/"' 7. 7 7 )  7 )  7  7 7 7 76) )),0+/"' 7. 7 7 )  7 )  7  7 7 7 7:\""G 3c(1R.C47 &12 2  3 54#:#::  h24>>2BC! #hqn69*344 5sOh>h>9i2 i2> i/i*$i/*i/2 k2.decode?s"D7J77rucU"U"U0UD65$ryrt)rr2r3rs rvrr4Ds K<<==rurYrTT)rYr*rrrF)rrrr*r^rrrWrr@chunkedr read_segmentsrrrTmap)rkr*rrrrrrrlr2r3rnumber_segmentssegmentexecutorrs rvr-r. sJ== [[ # # <77D   ))I&19%=   #7 7'+J| $'/':':J| $oo <(2 8&'  >"$,,/  a!,,J >++  ##&%,Wo%$J/8--$$''*).E (||F:::0/;0/s1DE/ AE E E E/E E,(E/T)rrr*rrc  URnSUR;d URcB[R"SURbUR5$[R 5$[ UR5S:Xa Sn[U5eURRnUc URnSn [U[5(aUS:XaUR(aU URn U (a.[ R""U<S3[$SS 9 UR'5 UR)URR*URR,-URURSS 9n SSS5 GOTUR.(GasUR0(a S n[3U5eUb [5XRUR5nU URn U (a.[ R""U<S3[$SS 9 UR'5 UR7URS5 UR9URR*URR,-[;UR5US 9n SSS5 UR<S:Xa[>R@"W U S 9n URBS :waB[DRFURBn URBS:Xa U "W SU S9n GOU "W SU S9U SS&GOURHGbX`LGaSURJ;GaURL(aURNS::aURPS::aU URn U (a.[ R""U<S3[$SS 9 UR'5 UR7URJSRRS5 URUURJSRRS5n SSS5 [DRVURXn U "W URZUS9n A OU URn U (a.[ R""U<S3[$SS 9 UR'5 UR]5 SSS5 [5XRUR5n UU 4SSjjnUR_UUUUSSS9HnM W RaURSS9n U(aU RaURbSS9n U (aURk5 U $!,(df  Nc=f!,(df  GN=f!,(df  GN_=f!,(df  N=f![daEn[g5RiU<SU RbSURbSU<S35 SnANSnAff=f)aReturn image from page as NumPy array. Parameters: out: Output array, *'memmap'*, or file for image data. By default, a new NumPy array is created. If a *numpy.ndarray*, a writable array to which the image is copied. If *'memmap'*, directly memory-map the image data in the file if possible; else create a memory-mapped array in a temporary file. If a *string* or *open file*, the file used to create a memory-mapped array. squeeze: Remove length-1 dimensions from image array, except X and Y. If ``False``, return the image array with normalized 5-dimensional shape :py:attr:`TiffPage.shaped`. lock: Reentrant lock to synchronize seeks and reads from file. The default is the lock of the parent's file handle. maxworkers: Maximum number of threads to concurrently decode segments. If ``None`` or *0*, use up to :py:attr:`_TIFF.MAXWORKERS` threads. See remarks in :py:meth:`TiffFile.asarray`. buffersize: Approximate number of bytes to read from file in one pass. The default is :py:attr:`_TIFF.BUFFERSIZE`. Returns: NumPy array of decompressed, unpredicted, and unpacked image data read from Strip/Tile Offsets/ByteCounts, formatted according to shape and dtype metadata found in tags and keyword arguments. Photometric conversion, premultiplied alpha, orientation, and colorimetry corrections are not applied. Specifically, CMYK images are not converted to RGB, MinIsWhite images are not inverted, color palettes are not applied, gamma is not corrected, and CFA images are not demosaiced. Exceptions are YCbCr JPEG compressed images, which are converted to RGB. Return an empty, two-dimensional array if the page contains no image or is missing required tags. Raises: TiffFileError: Missing data offset or invalid TIFF structure. ValueError: Format of image in file is not supported and cannot be decoded. rNr}zmissing data offsetFr:z reading array from closed filerTrUrz chroma subsampling not supportedrrYryrrr)rrc  UunupEpgpUc(URUXEXYS-2XfU S-2XwU S-24'gUSURU- 2SURU- 2SURU- 24UXEXYS-2XfU S-2XwU S-24'g)NrrYrT)rZrQrPrO) decoderesultrrr:rrr+rGrrs rvrTiffPage.asarray..funcs 3?/!a?!q8|+QU1X-=quQx>)>>&&d2- o%<<>C''1}H#??5;;7hmm#'/'<'<'AtF|tAw!$1D6 3 ! ![__ 4$$='E'(=(=>FAk)#00A5#'aAq1u-=(=#>D#'Aq!QU+;(;#[[UR55$z-Character codes of dimensions in image array.r~unique_stringsrrs rvr TiffPage.dims^DII.//rucR[[URURSS95$z4Ordered map of dimension character codes to lengths.Tr4rrrrrs rvrTiffPage.sizes C 4::d;< " E*  Qt#OO$788D D #'-  ruc,[UR5$z"Number of elements in image array.r@rrs rvr TiffPage.size*tzz""rucdURcgURURR-$)Number of bytes in image array.r)rrrrs rvrTiffPage.nbytes/s* :: yy4::....ruc8URRS5$)zValue of Colormap tag.rrrrs rvrTiffPage.colormap6yy  %%ruc8URRS5$)zValue of InterColorProfile tag.rrrs rvrTiffPage.iccprofile;syy  ''ruc8URRS5$)zValue of TransferFunction tag.-rrs rvtransferfunctionTiffPage.transferfunction@rruc:SSSSSS.nUbH[[U5nUcURRSS S 9nX4nX1nX%-S :XaX%-nO X%-nOUcSn/nSHTnURRUSS 9upU S :XaX-n OX-S :XaX-U-n OX- U-n URU 5 MV [US 5[US54$![a-n[ 5R U<S U<S 35 SnSnANSnAff=f![a Sn Nyf=f)a5Return number of pixels per unit in X and Y dimensions. By default, the raw XResolution and YResolution rational tag values are returned without any unit conversion. Missing tag values are set to 1. Parameters: unit: Unit of measurement of returned values. If specified, values are converted using the ResolutionUnit tag (default INCH) as the stored unit. Accepts a :py:class:`RESUNIT` member, its integer value, or a case-insensitive name string such as ``'inch'``. scale: Multiplier applied to raw rational tag values. If ``unit`` is also given, ``scale`` overrides reading the ResolutionUnit tag and is used as the source scale (pixels per meter for the stored unit), which is then divided by the scale for ``unit``. If only ``scale`` is given (``unit=None``), it is applied directly to the raw tag values. The default, when neither ``unit`` nor ``scale`` is given, is 1 (no conversion). Returns: Number of pixels per unit in X and Y dimensions. rYgz^C@di@B)rYrTrrrNrrTdefaultrz raised r_)rrr?) r.rrrrr7rmrrY) rkunitscalescalesrscale2rrrnrrOs rvrTiffPage.get_resolutionEsbD    7D)D =%)YY%6%6sA%6%FN"2E>Q&$EOE ]E"$ D yy((v(>6IEUaZFUNEEEME   e $Z]#U:a=%999+   h7|d|D  $  s;1CC!&D D D  D#DD DDc"UR5$z:Number of pixels per resolutionunit in X and Y directions.)rrs rvrTiffPage.resolutions ""$$ruc6URRSSS9$),Unit of measurement for X and Y resolutions.rrTrrrs rvrTiffPage.resolutionunitsyy  a 00rucURRS5nUcg[U5$![[4a gf=f) Date and time of image creation.rN)rrrIrrrs rvrUTiffPage.datetimesI !!#& = E? ":&   s ,??cUR(dgURS:a#URURUR4$URUR4$)ATile length and width, or depth, length, and width if volumetric.NrY)r^rTrSrRrs rvr TiffPage.tilesF}} >>A NNDOOT^^D D00ruc/nURS:aURUR5 UR(a(URURUR 45 O'URUR UR45 URS:Xa+URS:aURUR5 [U5$)Shape of single tile or strip.rY) rTrr^rrSrRrrOrrr~rkrs rvchunksTiffPage.chunkss >>A  LL ( == LL$//4>>: ; LL$++T__= >    !d&:&:Q&> LL-- .U|ruc/nURS:Xa+URS:aURUR5 UR(aURS:a<UR[ R "URUR- 55 UR[ R "URUR- 55 UR[ R "URUR- 55 OURS:aSUR<S3n[U5eURS:aURUR5 UR[ R "URUR- 55 URS5 URS:Xa!URS:aURS5 [U5$)1Number of tiles or strips per dimension in image.rTrYzself.rowsperstrip= < 1)rrrr^rQrorprTrPrSrOrRrrr~)rkrrs rvr6TiffPage.chunkeds\    !d&:&:Q&> LL-- . ==" TYYt'GHI LL4#3#3doo#EF G LL4??T^^#CD E  1$+**,D1#C((" T__- LL4#3#3d6G6G#GH I LLO    !d&:&:Q&> LLOU|rucf[/URQURRPURPUR PUR PURPURPURPURPURPURPURPURP75$)a?Checksum to identify pages in same series. Pages with the same hash can use the same decode function. The hash is calculated from the following properties: :py:attr:`TiffFile.tiff`, :py:attr:`TiffPage.shaped`, :py:attr:`TiffPage.rowsperstrip`, :py:attr:`TiffPage.tilewidth`, :py:attr:`TiffPage.tilelength`, :py:attr:`TiffPage.tiledepth`, :py:attr:`TiffPage.sampleformat`, :py:attr:`TiffPage.bitspersample`, :py:attr:`TiffPage.fillorder`, :py:attr:`TiffPage.predictor`, :py:attr:`TiffPage.compression`, :py:attr:`TiffPage.extrasamples`, and :py:attr:`TiffPage.photometric`. )r#rrr"rrRrSrTrrrVrrrrrs rvr# TiffPage.hashs*      !!         !! ""      !!      rucJSUR;ag[XRS9$)zSequence of sub-pages, SubIFDs.rNrd)rr rrs rvrTiffPage.pagess" dii ZZ00ruchUR(d URcgUR[R;a-[ [R [UR55$[UR5URR-nUS:agURS:XaUS:ag[UR5S:ag[b]URS:wd URS:wdURS:wa-[ [R [UR55$g)zsMaximum number of threads for decoding segments. A value of 0 disables multi-threading also when stacking pages. rrri8rrYrT)rErrrrQrrrrr@rrr(rVr)rkrs rvrTiffPage.maxworkers s   !3   t66 6tD,<,<(=> >DKK(4::+>+>> t    q Y%6 t 1 $  "    !T^^q%8DNNa >ruc<^^URS:Xd URS:wdURS;agSUR;aURUR :wdFUR UR-(d(UR S-(dURS-(agSUR;aISUR;a9UR UR:wdURUR-(agURmURm[T5S :Xag[T5S:Xag UR(dUR(ag [T5UR :wag[#UU4S j[%[T5S- 555$) zImage data is stored contiguously. Contiguous image data can be read from ``offset=TiffPage.dataoffsets[0]`` with ``size=TiffPage.nbytes``. Excludes prediction and fillorder. rrY>rPrr)r FrrrrrTc3j># UH(nTUS:g=(a TUTU-TUS-:Hv M* g7f)rrYNrt)rrrrs rvr)TiffPage.is_contiguous..I sC , qMQ  O71: 1 #=Q#O O,s03)rrrrrOrRrPrSrQrTrrrr:rgrrrlr)rkrrs @@rvrETiffPage.is_contiguous s9    "1$!!8 $)) 4>>1##doo5>>B&??R'"TYY&$$77""(( w<1  w<1  ;;$++ z?dkk ) 3w URSL=(a) UR SURR -S:H$)7Image data in file can be memory-mapped to NumPy array.Nr)rrrDrrrrrs rvrTiffPage.is_memmappableX sd KK " " * * ?  ? $&  ?   #djj&9&99Q>  ruc[UR5S:a UROURSnSUSURS3$)NrYrz"4;;/!3 Q$UG2dkk]!<[TU5nX!:Xag[US5(dg[UR5$)Nr=r)rrrzr)rrobjrks rvtostrTiffPage._str..tostru s5$%C{3''sxx= rur c3T# UHnU(dM UR5v M g7fryrrs rvr TiffPage._str..} s* (+ AGGIIs ((rc38# UHn[U5v M g7fryrrs rvrr 4AQr c38# UHnU(dM Uv M g7fryrtrs rvrr s" A   REDUCEDr^TILEDrrrrVrIc3@# UHoR5v M g7fry)rNrs rvrr s?,>q,>r rrkrrX) ndpi_tagsr rPrrz DATA rrY)rrrrzr6rz)rrrrrNrrrrrrr r is_reducedis_maskr^rur9rrrrrr?rr) rkrrXrrrrrr'rOrs ` rvr TiffPage._strk st ==D >>$6 6:DtUT\**zz|;  ! !yy 444 1 127789K9K8LM$D$4$45::%)__ ""&,,B#'==bm,n-k*k* ?F4::,>??%  0 #4;;/!3 Q5'DKK=4&9 Q;K499>>&1*E>BC A:&dB/5$$::<."5fqjIJL' A: ||~  wgt!DEG {{9%%  s 2J JJcSUR;agURURRS5n[UR5nUS:dUS:agUR =S:Xa S/nOD=S:Xa S/nO9=S:Xa /SQnO-=S :Xa /S QnO!S :XaUR S ;a/SQnO/S QnOgUS:a9U[[URS5RR5/- nUS:a9U[[URS5RR5/- n[U5U:wagU$)zReturn names of samples.rSNrYrTr WhiteIsZero BlackIsZero)RedGreenBluer)CyanMagentaYellowBlackrr)LumaCbCr) rrrrrrrr.rrtitle)rkr\rrs rvrTiffPage._sample_names s dii **TYY^^C014,,- Q;,*&&0>##';;4E0E !  gk4+<+z! eer_xml_metadata failed for tag r_) rrrrrr{rr eer_xml_metadatarrr7rm)rkrrrOrs rvrTiffPage.eer_tags s{{%'DII%%d+E !%//'' 66  .u||~>?(    h?vlTl$ s0(B C(#CCc"UR(dg0n[5nURHnURS:d URU;dURS:waM5UR SSS:waMKUR R S5nUSn[US5nURRU5X'URU5 M U$![a,n[5RU<S U<S 35 SnAMSnAff=f) z%Consolidated metadata from Nuvu tags.NrrTrzField 'rrrYz raised r_) rr!rrrrOrrrr7rmrr$)rkrusedrpartsrrrs rvrTiffPage.nuvu_tags s||!#99Cxx%388t#3syyA~ 99Ra=I- ,Qx58} 99,,T2FL HHTN    D8+?|d|!LM s!C6.C D"!D  DcUR(dgSURSR0nURHJnURnSUs=:aS:dO M URR S5nURX'ML U$![ a,n[5RU<SU<S35 SnAMSnAff=f)z&Consolidated metadata from Andor tags.NIdiAndorz raised r_) is_andorrrOrr removeprefixrr7rm)rkrrrrrs rvrTiffPage.andor_tags!s}} $--.99C88D$%% Oxx,,W5"yy   O  D8+@ t !MNN Os)B  C!B;;CcUR(dg0nURHnURnSUs=::aS:dO M URnU=S:Xa [ U5US'ME=S:Xa [ U5US'M\=S:Xa [ U5US'MsS :Xa[ U5US 'MUR S S 5upV[U5X'M U$![a,n[5RU<S U<S35 SnAMSnAff=f)zConsolidated metadata from EPICS areaDetector tags. Use the :py:func:`epics_datetime` function to get a datetime object from the epicsTSSec and epicsTSNsec tags. Nrr> timeStamprjuniqueIDrk epicsTSSeci epicsTSNsecrrYz raised r_) is_epicsrrrOrYrrr,rr7rm)rkrrrrOrr rs rvrTiffPage.epics_tags!s}}99C88DD(5(IIE O.3El{+-0Zz*/25z|,03E }-#(;;sA#6&,Sk #*  O  D8+@ t !MNN Os0C&C=CC)"C D!DDc,UR(dgURn0nSHnXRX#'M [ RR5HupSXQ;dM XRX#'M SU;a\USnSU;aMUSR[R5nUS-nUR[R5nXg- nUS XbS'U$![a,n[ 5R U<SU<S35 SnAMSnAff=f)z/Consolidated metadata from Hamamatsu NDPI tags.N)MakeModelSoftwarez raised r_ McuStartsMcuStartsHighBytesr)) rYrrOrr7rmr NDPI_TAGSr`r,rr)rkrrrrrrrs rvrTiffPage.ndpi_tags;!s||yy1D N#z// 2 ....0JD|#z// 1 & {+I#v-23::5<<H %,,U\\: ! /0"+;   N  D8+?|d|!LMM NsC D'!DDc UR(dgURnURS5nUb[U5S:d USS:wa[ 5R U<S35 gUSUSUSS.n[ Rn[ Rn[US5HnUS US --US -S -upxpUS:XaU n O;XRXU -n US:XaU S:aU SS:XaU SSn U S:aU OU Sn Xu;a-[R"[ 5 XW"U 5n SSS5 U"U5R"n XU 'M URS5n U bI[$R&"U 5n U R(S:XaU R+S5R-5n XS'URS5n U b'[$R&"U 5R-5US'URS5n U bE[$R&"U 5R+S5R/5R-5n XS'URS5n U b7[$R&"U 5R+S5R-5n XS'URS5nUbe0S US_S!US_S"US_S#US_S$US _S%US&_S'US(_S)US*_S+US _S,US-_S.US/_S0US1_S2US3S4_S5US4S6_S7US6S8_S9US8S_US:'U$![a-n [ 5R U<S U <S 35 Sn A GMSn A ff=f![a0n [ 5R U<S USU <S 35 Sn A GMSn A f[a0n [ 5R U<SUSU <S 35 Sn A GMSn A ff=f!,(df  GN=f![ a Un GNf=f);z(Consolidated metadata from GeoTIFF tags.N鯇rTrrYz invalid GeoKeyDirectoryTag)KeyDirectoryVersion KeyRevisionKeyRevisionMinorrrrPz% corrupted GeoKeyDirectoryTag raised r_z corrupted GeoKeyDirectoryTag rz GeoKeyDirectoryTag z not found, raised 鱇rKrI逄rrrIntergraphMatrixModelPixelScale還)rKr ModelTiepoint؅ModelTransformationERR_BIASERR_RANDLINE_OFFSAMP_OFFLAT_OFFLONG_OFFr HEIGHT_OFFr LINE_SCALEr SAMP_SCALE LAT_SCALE LONG_SCALEr HEIGHT_SCALE LINE_NUM_COEFFr!LINE_DEN_COEFF5SAMP_NUM_COEFFISAMP_DEN_COEFFRPCCoefficient)rrrrr7rmrGEO_KEYS GEO_CODESrrrOrrrrrrrrrrtrr)rkrgkdrgeokeysgeocodesrkeyidtagidrrrrOrrpccs rvrTiffPage.geotiff_tagsW!syyll5! ;#c(Q,#a&A+ H  x'BC D$'q6q6 #A -->>3q6]E .1 MEAIM/+ez  K--f~FEE>eaiE"I4D!#2JE!&a ((4$OE2E5 en)) 3KM#P U#  KK&EzzR f-446).% & U#  (- E(:(A(A(CF$ % U#  KK&..w7??AHHJE&+? # U#  KK&..v6==?E,1( )(||E"  (DG(DG(DG(DG ( 47 ( DG (d1g(d1g(d1g(T!W(d2h(R(!$r"+(!$r"+(!$r"+( !$rs)!(F# $$ }   h!\D\+  %H$$("@H""%/H$$("6ug>""%/ 54  sZ*LM! N55O L=!L88L= N2 $M55 N2$N--N25 O  OOcURUR4H2nU(aSU;aMUSSS:Xa SU;aUs $USSS:XdM0Us $ g)z3Shaped array description string, or None if absent.z"mibi.NrY{z"shape":rshape=rrXrkrs rvrfTiffPage.shaped_description!sa!,,d.?.?@K(k"92A#%* *C""2A(*"" ArucURUR4H"nU(dM USSS:Xd USSS:XdM Us $ g)z-ImageJ description string, or None if absent.NrImageJ=zSCIFIO=rSrTs rvr2TiffPage.imagej_description!sL!,,d.?.?@K2A)+{2A)/K"" A rucpURS;dHUR(a7URSS:Xd$UR(aURSS:agURRnUR URSS-5 UR S5nUS:H$![a gf=f)z/JPEG compressed segments contain JFIF metadata.rrr>FrrsJFIF)rrrrrr\rr])rkrlrs rvr&TiffPage.is_jfif!s   $8 8##"a'&&""1%* ''B GGD$$Q'!+ ,771:Dw  sAB(( B54B5cg))Object is :py:class:`TiffFrame` instance.Frtrs rvr,TiffPage.is_frame!rucg)z)Page does not have IFD structure in file.Frtrs rv is_virtualTiffPage.is_virtual!r^ruc2[UR5S:$)zPage is SubIFD of another page.rYrlrs rv is_subifdTiffPage.is_subifd"4;;!##ruc2[URS-5$)z'Page is reduced image of another image.rYrrrs rvrTiffPage.is_reduced "sD$$s*++ruc2[URS-5$)z!Page is part of multi-page image.rTrgrs rv is_multipageTiffPage.is_multipage"sD$$t+,,ruc2[URS-5$)z,Page is transparency mask for another image.rrgrs rvrTiffPage.is_mask"sD$$u,--ruc2[URS-5$)z%Page is part of Mixed Raster Content.rPrgrs rvis_mrcTiffPage.is_mrc"sD$$v-..ruc URS:$)zPage contains tiled image.r)rRrs rvr^TiffPage.is_tiled"s~~!!rucXURbURS:g$URS:H$)z&Page contains chroma subsampled image.rr)rrrs rvr#TiffPage.is_subsampled""s2    '##v- -1$$rucURSL$)z*Page contains ImageJ description metadata.N)r2rs rvrTiffPage.is_imagej-"&&d22rucURSL$)z%Page contains Tifffile JSON metadata.N)rfrs rvreTiffPage.is_shaped2"rwrucLSUR;=(a SUR;$)zPage contains MDFileTag.Errrs rvrSTiffPage.is_mdgel7"s&  " #" rucLSUR;=(a SUR;$)z(Page contains Agilent Technologies tags.r{r|rs rv is_agilentTiffPage.is_agilent?"s!dii6ETYY$66rucURRS5nUSL=(a URSSS:H$![a gf=f)z'Page contains Media Cybernetics Id tag.pNrsMC TIFFF)rrSrOr)rkrs rv is_mediacyTiffPage.is_mediacyE"sKiimmE" d?Bsyy!} 'B B  s: AAc SUR;$)zPage contains UIC1Tag.rr|rs rvr:TiffPage.is_stkN" !!ruc SUR;$)zPage contains CZ_LSMINFO tag.rr|rs rvrgTiffPage.is_lsmS"rruc SUR;$)z$Page contains FluoView MM_STAMP tag.rr|rs rvr;TiffPage.is_fluoviewX"rruc SUR;$)z!Page contains NIHImageHeader tag.rr|rs rvr5TiffPage.is_nih]"rruc URS:$)z0Page contains SGI ImageDepth tag with value > 1.rY)rQrs rv is_volumetricTiffPage.is_volumetricb"s""ruc URS:H$)zSoftware tag is 'ISS Vista'.z ISS Vistarrs rvrTiffPage.is_vistag"s}} ++rucURS:wdURS:wagURnURS5=(a UR S5$)z>Page contains MDS MetaSeries metadata in ImageDescription tag.r MetaSeriesF z )rrrrrZ)rkrs rvrTiffPage.is_metaseriesl"sE ::?dmm|;   ||L)Gajj.GGrucURS:wdUR(dgURSSR5RS5$)z.Page contains OME-XML in ImageDescription tag.rFNrXrrrcrZrs rvrdTiffPage.is_omet"sA ::?$"2"2%++-66v>>rucURS:wdUR(dgURSSR5RS5$)z4Page contains Leica SCN XML in ImageDescription tag.rFrNzrrs rvrmTiffPage.is_scn{"sA ::?$"2"2%++-66x@@ruc SUR;$)z'Page contains MicroManagerMetadata tag.r|rs rvr<TiffPage.is_micromanager"rruc SUR;$)z.Page contains Andor Technology tags 4864-5030.r r|rs rvrTiffPage.is_andor"styy  rucSUR;=(aa SUR;=(aK URSRS:H=(a( URSRRS5$)z)Page contains Nuvu cameras tags >= 65000.rrjrTzField '65001' is )rrrOrrs rvrTiffPage.is_nuvu"sj TYY  G" G % &&!+ G % &&112EF  rucXURSSS:H=(a URSSS:H$)zPage contains Pilatus tags.NrPzTVX TIFFrT# rrrs rvrTiffPage.is_pilatus"s1}}Ra J.O43C3CBQ3G43OOrucLURS:H=(d URS:H$)z&Page contains EPICS areaDetector tags.zEPICS areaDetector)rrrs rvrTiffPage.is_epics"s*    4 4 5}} 44 ruc SUR;$)zPage contains TVIPS metadata.rr|rs rvrTiffPage.is_tvips"rrucLSUR;=(d SUR;$)z*Page contains FEI_SFEG or FEI_HELIOS tags.rrr|rs rvrTiffPage.is_fei"! !7Udii%77ruc SUR;$)zPage contains CZ_SEM tag.rr|rs rvrTiffPage.is_sem"rruc&URSSS:H$)zPage contains Aperio metadata.NrAperio rrs rvr_TiffPage.is_svs"s#y00rucSUR;=(a> SUR;=(d( URSSS:H=(d URS;$![a gf=f)zPage contains Ventana metadata.r~VentanaNScanOutputManager> Label_ImageProbability_Image Label ImageF)rrrrrs rvrTiffPage.is_bif"sq $))#T]]*G=="%)<<G##FG    sAA A#"A#cURSSS:H=(d+ URSSS:H=(d SURSS;$)z!Page contains ScanImage metadata.NrzSI.rzstate.z scanimage.SIirrs rvriTiffPage.is_scanimage"sP MM"1  & 9#x/ 9!1!1$%!88 ruc&URSSS:H$)z"Page contains IndicaLabs metadata.NIndicaLabsImageWriterrrs rvrvTiffPage.is_indica"s}}Sb!%<<)rrrcrZrs rvrrTiffPage.is_philips#sC}}Sb!\1,d6F6F D7 %'((?+ ,rucURR=(aX SUR;=(aB URSRS:H=(a URSRSSS:H$)z'Page contains EER acquisition metadata.rjrNrr)rrZrrrOrs rvrTiffPage.is_eer#sj KK " " =" = % &&!+ = % &&s+}<  ruc^[UR5S:H=(a SUR;$)z%Page contains embedded C2PA manifest.rYr )rrrs rvrbTiffPage.is_c2pa'#s%499~"9u '99ru)rrrrrrrrXrrQrPrOrWrZrrrrrrrrrrrrTrSrR)rint | Sequence[int]rrrTiffPage | Noner6rrBr6zCallable[..., DecodeResult])r*$threading.RLock | NullContext | Nonerr3rrrrrr3rr%r6zIterator[DecodeResult])r*rrr3rzCallable[[DecodeResult], Any]rrrr3rr%r6 Iterator[Any])r*rrr3rz$Callable[[DecodeResult], Any] | Nonerrrr3rr%r6&Iterator[DecodeResult] | Iterator[Any]) rrwrrr*rrr3rr3r6rrrgr6rnrrgr6r)rPrrQzContainer[int] | Nonerrgr6rrKr6rr6rM)rrr6rrKr6tuple[str, ...]r6zdict[str, int]r6dict[str, NDArray[Any]]r6r)r6r,r!NNrr>r float | Noner6tuple[float, float]r6rr6zDateTime | Noner6r/)r6TiffPages | Nonerrr)r6list[str] | Nonerr r)rrrrrrLrrOrPrQrRrSrTrrrrrrrVrrrrrprrWrrrXrZrnrrXrrar-rrrrWrr6rMrrcrsetterrrrrrrrrrrrrrrrUrrr6r#rrrErrr+rrrr9rrrrrrrfr2r&r,r`rcrrjrror^r#rrerSrrr:rgr;r5rrrrdrmr<rrrrrrrr_rrirvrrzrrrrrrrYrYrrrrbr rtrurvrrs ( N! , K# ' ""+ ** I! /##1 ## K-J6K"J&Is)J&Is*OS)M3-L#<!L#!#K<L#JIs:K7IsI$&L/&N*.K'.>&*G #*'#J #/#J #6Hc(K(L#/FEK%) G=# G=G= " G= G=R N # $N #N #`69!$!$!$ %3 % %  %  % % %  % %69!$!$!$ 3   ,        6:!%59!%!%_;3_; _; 3 _;  _;_;_; 0_;H59!%!%__ _ 3 _  __ _B * -'+ <<% <  <  <| "__## 00==##J8##// &&((&& ,0"H:(H:H:  H:T%% 11  11  ,& & P11 2, , \      =@&DB  ,,"!!F6wwr  $$$,,--..//""%%3333  77 """"""""##,,HH?? AA ""!!  PP  ""88""11    ==77 """"     """"8877,,   ::rurc\rSrSr%SrSrSrS\S'SrS\S 'S \S 'S \S 'S\S'S\S'S\S'S\S'S\S'S\S'SSSSS.SDSjjr SESjr SFSjr SGSjr SHSjr SISjrSJSjrSKS jr\SES!j5r\SLS"j5r\SMS#j5r\R*SNS$j5r\SOS%j5r\SOS&j5r\SOS'j5r\SOS(j5r\SOS)j5r\SOS*j5r\SES+j5r\SLS,j5r\SPS-j5r\SLS.j5r\SLS/j5r \SQS0j5r!\SRS1j5r"\SES2j5r#\SSS3j5r$\STS4j5r%\SUS5j5r&\SES6j5r'\SES7j5r(\SVS8j5r)\SRS9j5r*SWSXS:jjr+\SYS;j5r,\SES<j5r-\SZS=j5r.\SES>j5r/\S[S?j5r0SRS@jr1SRSAjr2S\S]SBjjr3SCr4g)^ri-#aKLightweight TIFF image file directory (IFD). The purpose of TiffFrame is to reduce resource usage and speed up reading image data from file compared to TiffPage. Properties other than ``offset``, ``index``, ``dataoffsets``, ``databytecounts``, ``subifds``, and ``jpegtables`` are assumed to be identical with a specified TiffPage instance, the keyframe. TiffFrame instances have no ``tags`` property. Virtual frames just reference the image data in the file. They may not have an IFD structure in the file. TiffFrame instances are not thread-safe. All attributes are read-only. Parameters: parent: TiffFile instance to read frame from. The file handle position must be at an offset to an IFD structure. Only a limited number of tag values are read from file. index: Index of frame in IFD tree. offset: Position of frame in file, or zero for virtual frame. keyframe: TiffPage instance with same hash as frame. dataoffsets: Data offsets of "virtual frame". databytecounts: Data bytecounts of "virtual frame". )rr"rrrrrrpFrrSNrrrrrrrMrrr/rpr9rrr"rrrrrc  XlSUlSUl[U[5(a U4UlO[ U5UlUb+Ub(UcSO [ U5UlXPlX`l X@l gSUl SUlSUl URnUcUR5UlO![ U5UlURU5 Uc1SknO+UR(a1SknURUl O1SknURn [ R"n U "U R$UR'U R(55Sn U S:aSU 3n [1U 5eURU R(-nU R2nU*nU R4SS nUR'X-5n[7U 5HnUU- nU "UUUUS -5SnUU;aM"[8R;UUU-UUUU-S 9nUS ;aUR>UlMZUS;aUR>Ul MsUS:XaUR>UlMUS:XaUR>UlMUb1US:XdMUR@SR>UR>:wdMSn [CU 5e UR(d[=5REU<S35 Orrrrrr>rrrr>rrrrrrrr]r^r_rTrcz raised r_>rr>rrrrrincompatible keyframez is missing required tags)%rrprrrrr~rrrr"rrXr\rEr"rererCrr'rr]rrrEr$rr$rr7rOrrarmrr)rkrrrrrrrlcodesr"rerrrrrEr codeformattagbytesrrrs rvrnTiffFrame.__init__s#sS   eS ! ! (DK,DK  "~'A%~!3v;DK* "0 %N      >'')DKf+DK GGFO  $BE  # #(E"*"9"9D 7E{{ .4++RWWT^^-DEaHE 4<.ug6C$ $KK$..0 ,,8__Ra( 777?+uA  H*hx(Q,&GHKD5  &&$x/#Hx'/AB'z!#&99 #&)ii#"yy "%))!  c 2 8 8CII E-"3''9< H  x'@A B  !c$*:*:&;s  @ ' *Cs# #  $M i gz2 .( 6C$# - .2! h9#F  s0/LMM3MM N  !NN c,[RU5$)rZ)rrrs rvrTiffFrame._nextifd#s  &&rucUR(a Sn[U5eURRnURnU(a.[ R "U<S3[SS9 UR5 URUR5 [URURS9nU(aUR5 U$!U(aUR5 ff=f)zCReturn TiffPage from file. Raise ValueError if frame is virtual. z#cannot return virtual frame as pagez" reading TiffPage from closed filerTrUrd)r`rrrrrhrirjrDr\rrrr)rkrrlrrs rvr6TiffFrame.aspage#s ??7CS/ ! [[ # #  MM(<=  GGI  GGDKK DKKtzz:D   s 79C C#c 0[R"U40UD6$)zuReturn image from frame as NumPy array. Parameters: **kwargs: Arguments passed to :py:meth:`TiffPage.asarray`. )rrrkrs rvrTiffFrame.asarray#s///ruc 0[R"U40UD6$)zReturn image data from frame as xarray DataArray. Parameters: **kwargs: Arguments passed to :py:meth:`TiffPage.asarray`. )rrrs rvrTiffFrame.asxarray$s  000ruc  SSKJn U"U40UD6$)zrReturn image from frame as Zarr store. Parameters: **kwargs: Arguments passed to :py:class:`ZarrTiffStore`. rYrKrLrMs rvrTiffFrame.aszarr$rOruc6[R"U/UQ70UD6$)zRReturn image from frame as RGB(A). Work in progress. Do not use. :meta private: )rrWrkrrs rvrWTiffFrame.asrgb$s ~~d4T4V44ruc6[R"U/UQ70UD6$)zReturn iterator over decoded tiles or strips. Parameters: **kwargs: Arguments passed to :py:meth:`TiffPage.segments`. :meta private: )rr-rs rvr-TiffFrame.segments"$s  7777ruc URS$)zIndex of frame in IFD chain.rKr_rs rvrTiffFrame.index/$rarucUR$)zIndex of frame in IFD tree.r_rs rvrcTiffFrame.treeindex4$rerucUR$)z&TiffPage with same hash as this frame.r"rs rvrTiffFrame.keyframe9$~~rucURULagURb Sn[U5e[UR5[UR5:wa Sn[U5eUR(aUR UlXlg)Nzcannot reset keyframer)r"rarrrEr)rkrrs rvrr >$su >>X %  >> %)Cs# # t C(<(<$= =)Cs# #  ! !"*"9"9D !rucg)r\Trtrs rvr,TiffFrame.is_frameL$sruc URS:*$)z*Frame does not have IFD structure in file.rr=rs rvr`TiffFrame.is_virtualQ$s{{aruc2[UR5S:$)z Frame is SubIFD of another page.rYrlrs rvrcTiffFrame.is_subifdV$rerucLURceURR$)r)r"rrs rvrTiffFrame.is_final[$s$~~)))~~&&&rucLURceURR$)zLImage data is stored contiguously. See :py:attr:`TiffPage.is_contiguous`. )r"rErs rvrETiffFrame.is_contiguousa$s$~~)))~~+++rucLURceURR$)r)r"rrs rvrTiffFrame.is_memmappablek$$~~)))~~,,,rucLURceURR$)zKChecksum to identify pages in same series. See :py:attr:`TiffPage.hash`. )r"r#rs rvr#TiffFrame.hashq$$~~)))~~"""rucLURceURR$)zShape of image array in page.)r"rrs rvrTiffFrame.shape{$$~~)))~~###rucLURceURR$)zYNormalized 5-dimensional shape of image array in page. See :py:attr:`TiffPage.shaped`. )r"rrs rvrTiffFrame.shaped$s$~~)))~~$$$rucLURceURR$)r)r"rrs rvrTiffFrame.chunks$$~~)))~~$$$rucLURceURR$)r)r"r6rs rvr6TiffFrame.chunked$s$~~)))~~%%%rucLURceURR$)r)r"rrs rvrTiffFrame.tile$$~~)))~~"""ruct[UR5S:a UROURSnSU3$)rjrYr TiffFrame rlrms rvrTiffFrame.name$s4 #4;;/!3 QE7##rucLURceURR$rp)r"rrs rvrTiffFrame.ndim$r?rucLURceURR$)z#Names of dimensions in image array.)r"rrs rvrTiffFrame.dims$r?rucLURceURR$)z*Ordered map of dimension names to lengths.)r"rrs rvrTiffFrame.sizes$r5rucLURceURR$)z4Ordered map of dimension names to coordinate arrays.)r"rrs rvrTiffFrame.coords$r:rucLURceURR$r)r"rrs rvrTiffFrame.size$r?rucLURceURR$r)r"rrs rvrTiffFrame.nbytes$r:rucLURceURR$)z!Data type of image array in page.)r"rrs rvrTiffFrame.dtype$r5rucLURceURR$)zOCharacter codes for dimensions in image array. See :py:attr:`TiffPage.axes`. )r"rrs rvrTiffFrame.axes$r2rucVURceURRX5$)zbReturn number of pixels per unit in X and Y dimensions. See :py:attr:`TiffPage.get_resolution`. )r"r)rkrrs rvrTiffFrame.get_resolution$s)~~)))~~,,T99rucLURceURR$r)r"rrs rvrTiffFrame.resolution$s$~~)))~~(((rucLURceURR$)r)r"rrs rvrTiffFrame.resolutionunit$r/rucLURceURR$)r)r"rUrs rvrUTiffFrame.datetime$s$~~)))~~&&&rucLURceURR$)z2:py:class:`COMPRESSION` scheme used on image data.)r"rrs rvrTiffFrame.compression$s$~~)))~~)))rucLURceURR$)z[Return decoded segment, its shape, and indices in image. See :py:attr:`TiffPage.decode`. )r"rrs rvrTiffFrame.decode$s$~~)))~~$$$ruc[UR5S:a UROURSnSUSURS3$)NrYrz"4;;/!3 Q%eWBt{{m1==ruc"UR5$ryrrs rvrTiffFrame.__str__ %rruc[UR5S:a UROURSnUS:aURbURRUS- S9OSn[ UR US- US- S9n[ UR US - US- S9n/nUbURS U35 US U3S U3/- nS S RU5-nOVURbGSRSRSUR55[UR545nOSnSUSURSU3$)z5Return string containing information about TiffFrame.rYrrNr>rr;rrz Keyframe z Offsets z Bytecounts r r rc38# UHn[U5v M g7fryrrs rvr!TiffFrame._str..%%s8ZSVVZrr=rAr) rrr"rr?rrrrrrzrr) rkrrXrkfofbc info_partsrs rvrTiffFrame._str%sK"4;;/!3 Q A:>>-##%"*#5  ))6A:NB##52:fqjBJ~!!Jrd"34 Yrd+|B4-@A AJ$))J//D ^^ '99HH8TZZ88 ODDE7"T[[MD6::ru) rr"rrrrrrrp)rrrrrr3rrrr/rr/r6rrKr)rrgr6rrr)rrgrrgr6r)rrgrrgr6rrr6r)rrr6rrr6rNrrKrrr)r6r1rrrrrrr)5rrrrrrGrSrLrrnrr6rrrrWr-rMrrcrrr,r`rcrrErr#rrrr6rrrrrrrrrrrrrrUrrr+rrr rtrurvrr-#s@ IHd"E " - K$  /##1 ##'/ "$(.215h%# h%h%  h%"h%,h%/h% h%T'801 -5 8 8$' 8 / 8__ " "  $$'' ,,-- ##$$ %%%% && ## $$ ## ## $$ %% ## %% $$ ##,0" :( : :  :)) -- '' **  % $ % %>;;rurc4\rSrSr%SrSrS\S'S\S'S\S 'S \S 'S \S 'S\S'S\S'S\S'S\S'S\S'S\S'SS.S;Sjjr\SSj5r \S=Sj5r \ RS>Sj5r \S?S j5rS@S!jr\SAS"j5r\SBS#S#S#S$.SCS%jjj5r\S#S#S#S$.SDS&jj5rSES'S(S)S$.SFS*jjjrSGSHS+jjrSIS,jrS)S-.SJS.jjrSKS/jrSES)S)S0.SLS1jjjrS'S(S(S$.SMS2jjr\SNS3j5r\SOS4j5r\SPS5j5r\SQS6j5rS=S7jr\SRS8j5rSSS9jrS:rg)Tr i.%aSequence of TIFF image file directories (IFD chain). TiffPages instances have a state, such as a cache and keyframe, and are not thread-safe. All attributes are read-only. Parameters: arg: If a *TiffFile*, the file position must be at offset to offset to TiffPage. If a *TiffPage* or *TiffFrame*, page offsets are read from the SubIFDs tag. Only the first page is initially read from the file. index: Position of IFD chain in IFD tree. Nrrr>_offsetszdict[int, TiffPage | TiffFrame]_loadedrr"ztype[TiffPage | TiffFrame] _tiffpager_indexed_cached_cacher_offsetr3_nextpageoffsetr/rrdcSUl/Ul0UlSUlSUl[ UlSUlSUlSUl SUl UcSUl OG[U[[R45(a[U54Ul O[!U5Ul [U["5(aXlURR$nUR'5Ul [(R*"URR,R.UR1URR,R255SnUS:Xa%[55R7U<S35 SUlgOUR8bvUR8nURUlURR$n[;U5S:Xd USS:Xa%[55R7U<S35 SUlgUSnOSUlgX@l XCR<:a([55R7U<SU<35 SUlgURcSO/URQSP7nUR?U5 [ URUS9nURRAU5 XpRS'XplURc-URRCWSS5 SUlSUlgg) NFrz contains no pagesTz contains invalid SubIFDsz invalid offset to first page rdrY)"rrorprrrsrrqr"rtrurvrrrrrr~rrrXrerer"rgrrDr7rmrprrr\rr)rkargrrlrrrrs rvrnTiffPages.__init__O%sy     !  # =DK U]]3 4 4u:-DK,DK c8 $ $K''B#%779D ]]   -- ((334F{  C7* $ [[ $kkG**DK''B7|q GAJ!O  C7*C!DE $ QZF DM  WW  H  (8 C !DM $A*;DKK*;*;   95 V$ Q    ' MM  - DMDL (rucr[[URS5$![a [ S5Sef=f)z6First page as TiffPage, or raise IndexError if absent.rN)r_rrprr4rs rvrTiffPages.first%s7 *$,,q/2 2 *Q-T ) *s6cHURS5 g![a gf=f)z&IFD chain contains more than one page.rYFT)_seekr4rs rvrjTiffPages.is_multipage%s+  JJqM  s  !!cUR$)zRPages and frames are being cached. When set to ``False``, the cache is cleared. )rtrs rvrTiffPages.cache%s{{rucv[U5nUR(aU(dUR5 Xlgry)rrtrrs rvrr%s"U  ;;u KKM ruc(UR[:H$)z)Use TiffFrame (True) or TiffPage (False).)rqrrs rvrlTiffPages.useframes%s~~**ruc@U(a [Ulg[Ulgry)rrrqrs rvrlr%s&+rucUR$)z-TiffPage used as keyframe for new TiffFrames.rrs rvrTiffPages.keyframe%r!ruc[U[[R45(dS[ U53n[ U5e[U5nUS:aU[ U5-nURbURRU:XagUS:Xa#[[URS5UlgUR(dU[ UR5:aGXR;a8URUn[U[5(aX0lgURU URn[Ul[[URU55UlX@lURURU'g!X@lf=f)zSet keyframe to TiffPage specified by ``index``. If not found in the cache, the TiffPage at ``index`` is loaded from file and added to the cache. zindices must be integers, not rN)rrrrrwrrr"rr_rrprrrorq_getitem)rkrrrrs rvrTiffPages.set_keyframe%s,%#u}}!56624;-@CC. E  19 SY E >> %$..*>*>%*G  A:!(DLLO>! &!(DMM%,@ADN%N"nn U&Ns 8$E<<Fc^UR(dURS5 UR$)z2File position where next IFD offset can be stored.rK)rrr}rvrs rvr[TiffPages.next_page_offset%s"}} JJrN###ru.validaterr6cgryrtrkrrrrr6s rvrS TiffPages.get% #rucgryrtrs rvrSr&rrurFTcNURXXES9$![a UceU$f=f)a5Return specified page from cache or file. The specified TiffPage or TiffFrame is read from file if it is not found in the cache. Parameters: key: Index of requested page in IFD chain. default: Page or frame to return if key is out of bounds. By default, an IndexError is raised if key is out of bounds. validate: If non-zero, raise RuntimeError if value does not match hash of TiffPage or TiffFrame. cache: Store returned page in cache for future use. aspage: Return TiffPage instance. r)rr4rs rvrSr&sE< ==e!   s $$cLURceUR(agUR(dgUR(dUR S5 UR (dgURR nUSLa URnOUSLaSn[UR5Hnup4X0R;dMURcUO/URQUP7nURU5 URURXQS9URU'Mp SUlg)z#Read all remaining pages from file.NrKTFrr) rrsrorrr}rtrr"rrprr\rq)rkrrlrrrs rvrTiffPages._load6&s {{&&& << }} }} JJrN{{  [[ # # t ~~H  H"4==1IA $,A2CDKK2C2C"&..KKy#1# Q 2 ruc r^URce[UR5S:a Sn[U5e[ [ UR S5nUR(d Sn[U5eURS5 URSURS- nURSURS- U:wd#URSURS- U:wa S n[U5eURSURS 9nURSUR- nUS:dXS:a S n[U5eURUR/nX$S .nURRRU- n[[!URU-X5SS 9HupX-m[#U4S jUR55n U S:aU OSn UR%U =(d S5 ['URUR(cU O/UR(QU P7U U UR*US9Xy'M X`lXplSUlSUlSUlg![2aTn URRRS:a&[55R7U<SU <S35 Sn A gSn A gSn A ff=f)zCalculate virtual TiffFrames.NrYzpages already loadedrzdata not contiguousrrTrzpage offsets not equidistantrr)startc3,># UH oT-v M g7fryrt)rrrs rvr1TiffPages._load_virtual_frames..v&s#D3CaE3CrrrrrTz <_load_virtual_frames> raised r_)rrrorr_rrprEr}rr#rrrrrrr~rrrrrtrsrrrr7rm)rkrrdeltapage1 offsetoffset new_offsets new_loadedfilesizerrroffset_or_nonerrs @rvrjTiffPages._load_virtual_framesU&sv{{&&&4 4==!A%, o%$,,q/2D%%+ o% JJqMMM!$t}}Q'77E a 4==#33u<==#dmmA&66%?4 o%MM!diiM8E ,,Q/%,,>La<#74 o%&*kk5<<%@K>B:MJ{{--22U:H!*ellU*H#6Q7$-KK!%!4:ODKK:O:O) +#'#6#6! % !""(M%LDKDL DM {{%%**j8  h=c\D\J9 sII J6"AJ11J6fullycXUR(dg[[URS5UlU(aSURS0UlOKURR 5VVs0sHup#[ U[5(aMX#_M snnUlSUlgs snnf)zADelete all but first page from cache. Set keyframe to first page.NrF) ror_rrpr"r`rrrs)rkrrrs rvrTiffPages._clear&s}} h Q8 t||A/DL !LL..00DA!!Y/0DL  s 0B&B&c URceURn[U5nUS:Xa Sn[U5eURRnUR (a Sn[ U5eUR(dSUs=::aU:aO OUS:agURX!5$URRnURnURnURn URn URn [R n USn US:GaURU 5 SnSnU "XR#U 55SnUS:aS US 3nU(aS[+5R%U<S US U S US35 US US-nUR,R/US5 SUlGOQX-X--UlUR#X-U-5n[3U "UUU*S5S5n U S:Xa SUlGOXR4:a([+5R%U<SU <35 SUlOUR7U 5 US- nSUs=::aU:aO OOUS:Xa[9USS5HunnU U:XdMUnUSUS-UlUR,R;5VVs0sHunnUU::dMUU_M snnUlSUl[+5R%U<SUSU <35 O US:aGMUS:agX:a Sn[U5eURX!5$![R$[&4an[)U5nSnAGNSnAff=f![R$[&4aFn[+5R%U<SUS-S UR0S U<S35 SUlSnAMSnAff=fs snnf)zASeek file to offset of page specified by index and return offset.Nrzindex out of rangezseek of closed filerKrvr=r^r_z > 4096z corrupted tag list of page rrr_rYTz invalid offset to page z invalid page offset rz# invalid circular reference to IFD z at offset=)rrorr4rrrrrr\r"rgrDrCr'rErererrr]rFr7rprrvrrrrr`)rkrr lenoffsetsrrlr"rgrDrCr'rErerre next_datarrorrs rvr}TiffPages._seek&s{{&&&--\ ?&CS/ ! [[ # # 99'CS/ ! ==A33qy777>* *{{(( __ && NN ,,5 GGFOEC {GGI,>?Bt|25'Ah:!l"VHHSJ@BKa    T2 $ #)#5#GD  GGEOj$@A VL)ZKL2IJ1MN{ $  $)>vjIJ $  NN6 " !OJE&J&S %gcrl3DAq{ !(/!a%(8 -1\\-?-?-A(-ATQQ!VDAqD-A( )- #h&I cfY04g5 B 19  &CS/ !www~&&LL'* 1g (LL'* h6!A~&b)=)=(>?!\D\+ !%  6(s<-L*%/N!$Y!7Q}}T)9C > IE % +3DNN'' !DN ,=@ASWQ3SEA LLDNN +&N!+ C&0N& I B&N!+s<H H$H;H6&H;H!$ H32H36H;;IcURce[U5nURnUS:aU[U5-nO=UR(a,U[U5:aSUS[U5S3n[ U5eU(a[ O URnXR;aURUnUR(a,U(d%U(aX(R:wa Sn[U5eU$[U[ U45(a%U(aX(R:wa Sn[U5eU$URcUO/URQUP7n URU5 U"URXRS9n[U[ [ 45(deU(aX(R:wa Sn[U5eUR(dU(aXRU'U$)z)Return specified page from cache or file.rzindex z out of range(rzzpage hash mismatchr)rrrorrrr4rrqrprtr#rarrr}r"r) rkrrrr6rrrrrs rvrTiffPages._getitemF's{{&&&#h-- 7 3t9 C ]]sc'l23%~c'l^1=CS/ !%84>> ,, <<$D{{6II 5.C&s++ $8 455II 5.C&s++ ;;&C,?dkk,?3,?  3 9~~N$9 56666 II-&Cs# # ;;% $LL  rucgryrtrkrs rv __getitem__TiffPages.__getitem__v's@Crucgryrtrs rvrry's&)rucURnURn[U[[R 45(aU"[U55$[U[ 5(aURS5upEnUR(d)[XT5[U5:aURS5 [UR[U556Vs/sH os"U5PM sn$[U[5(a-[U[5(dUVs/sH o"U5PM sn$Sn [U 5es snfs snf)NrrK*key must be an integer, slice, or sequence)rorrrrrrrrrrkrr}rrSrzr) rkrrrrrrrrrs rvrr~'s---- cC/ 0 03s8$ $ c5 ! ! [[3NE==S%5G %D 2(-s{{3w7r*."e'R37>  > />  >  > $>J. .  .  .. .`CC )() #)). :*  &"" 7rur c\rSrSr%SrSrS\S'S\S'S\S'S\S 'S\S 'S\S 'S \S 'S#Sjr\SSSS.S$Sjj5r \ S%Sj5r \ S&Sj5r \ S'Sj5r\RS(Sj5r\ S)Sj5r\ S)Sj5r\ S)Sj5r\ S*Sj5rS+SjrSSS.S,SjjrS-SjrS)SjrS)S jrS.S/S!jjrS"rg)0r$i'aTIFF tag structure. TiffTag instances are not thread-safe. All attributes are read-only. Parameters: parent: TIFF file tag belongs to. offset: Position of tag structure in file. code: Decimal code of tag. dtype: Data type of tag value item. count: Number of items in tag value. valueoffset: Position of tag value in file. )_valuerrrrrrTiffFile | TiffWriterrrrrrrrrgrcXl[U5Ul[U5Ul[U5UlX`lXpl[U5Ulg![a [U5Ulgf=fry) rrrrrrrrrr)rkrrrrrrOrs rvrnTiffTag.__init__'s_ &k I Z  & $!%DJ $UDJ $sAA21A2NT)rrmrc NURnURnUcAUcUR5nOURU5 UR UR 5nOUcUR5nX%R -UR - n[R"URU5upp[RU n U [R "U 5-nXR :dU[R";a[R"UR$U 5SnUS:dX-UR&:a9SUSUSU3nU(a [U5e[5R)U5 Sn OU[R*;a[,R/XXX5n OSn OU S;aU SUn O|UR0(a-U S :Xa'U S ;a!U S SS :wa[R"S U 5n O>UR2U [5U S5-U S 3n[R"UU SU5n [,R7XX5n U"XXXU5$![aNn SUSUSU <3nU(a [U5U e[5RU5 U"XXU SS5sSn A $Sn A ff=f)aReturn TiffTag instance from file. Parameters: parent: TiffFile instance tag is read from. offset: Position of tag structure in file. The default is the position of the file handle. header: Tag structure as bytes. The default is read from the file. validate: Raise TiffFileError if data type or value offset are invalid. Raises: TiffFileError: Data type or value offset are invalid and ``validate`` is ``True``. N invalid data type rrPz> invalid value offset rYrTrrY>rr;rrs~WWT\\*F ^WWYF||+d.E.EE $*MM$2F2F$O!U D++E2KFOOK88 // /t''' --(9(95A!DKQ+"9BGG"C(b9,,7=:',,  %&++D i *9%E LL #ab 00MM$.E>>"3{1~../q>"$  MM#uZi'89E&&uEB64kJJi D$TF"VH5%%*I/ #C(c1 HNN3 vtE4C C Ds0I J$AJJ$J$c [RUnURn UR R n UR Rn U[R"U5-n US:dX\-U R:aSUSUSU<3n[U5eU RU5 U[R;a [RUn U "XX4U 5nU$US ;aBU R!U 5n[#U5U :wa [5RSUSUS 35 U$U[R$;aUS :a['XX4U 5nU$[R("U U[+US 5-US3U R!U 55nU$![anSUSUSU<3n[U5UeSnAff=f![a@n[5RSUSUSU<S 35 U RU5 SnAGN SnAff=f)zRead tag value from file.z invalid dtype=NrPz> invalid valueoffset=r > raised r_rz> could not read all valuesrrrY)rrrrrr"rrDrerrr\rrr7rmrr TAG_TUPLE read_numpyrer)rrrrrrrrrrlrrDrreadfuncrOs rvrTiffTag._read_value](s .++E2K   KK)) [[++ FOOK88 ?k5?dV2fX-D ~FC$ $   4## #''-H  jI I GGI&E5zY&  (b900  'EDLreJGE  MM+ec+a.&99:;q>:JK "E ] .dV2fX->zBC$# - .. %  (b #N $$  %s/F  F5 F2F--F25 G??5G::G?c ^Ub5US;d/U[R;d[U[[45(dU$US:Xa3UR S5nUR S5R5nU$U[R;a)[RUm[ U4S jU55n[U5S:XaU[R;aUSnU$![aa UR S5R5nU$![a0n[5RSUSUS U<S 35 SnAU$SnAff=ff=f![a4nUS ;a$[5RSUSUS U<S 35 SnANSnAff=f)zProcess tag value.N>rYrrTr+utf-8cp1252rrz*> coercing invalid ASCII to bytes, due to r_c34># UH nT"U5v M g7fryrtrrr.s rvr)TiffTag._process_value..(s2EqaddErrrrYr)rrrr{r~rrrcUnicodeDecodeErrorr7rmTAG_ENUMrrr)rOrrrrr.s @rvrTiffTag._process_value(s Mt'''eeU^44L A:LL)E  W-335L 4==  d#A 2E22 u:?t4>>9!HE 5& !LL288:E L *H$$,TF"VH=CCF,,PL   z)H$$,TF"VH=""%/  sHCE  E'D  E$D>7E>EE F*FFc URGcURRnUR URnU(a.[ R "U<S3[SS9 UR5 [RURURURURURUR5nU(aUR!5 SSS5 [R#WURURUR5UlUR$!U(aUR!5 ff=f!,(df  Nr=f)z2Value of tag, delay-loaded from file if necessary.Nz reading value from closed filerTrU)rrrr*rrhrirjrDr$rrrrrrrr)rkrlrrOs rvrO TiffTag.value(s ;;  ''BMM("AB##$ GGI ##//     (( E -."00   DK {{ +s%AE 4AD0 E 0E  E  EcXlgry)rrs rvrOr(s rucnURR$![a SUR3s$f=f)zName of data type of tag value.TYPE)rrrrs rv dtype_nameTiffTag.dtype_name(s5 '::?? " '$**& & 's 44c|[RRUR[ UR55$)z0Name of tag from :py:attr:`_TIFF.TAGS` registry.)rrrSrrzrs rvr TiffTag.name(s%yy}}TYYDII77ruc<[RUR$)z$Data type as ``struct.pack`` format.)rrrrs rvrTiffTag.dataformat)s  ,,ruc~UR[R"[RUR 5-$)z%Number of bytes of tag value in file.)rrerrrrrs rvvaluebytecountTiffTag.valuebytecount)s+zzFOOD,=,=djj,IJJJruch[UR[5(aURnGOURRn[ R URnUR[US5-nURUUS3nSnURS:Xa>[R"XPRRS55n[U5U:gnOhUS:Xa@[UR[5(d![R"XPR5nO"[R"U/URQ76nU(awURR&n U R)5n U R+UR,5 U R/[R0"U55nU R+U 5 UR2[UR5URWS4$![ a1nUR"(aUS:XaSn[%U5UeSnSnANSnAff=f) zfReturn tag code, dtype, count, and encoded value. The encoded value is read from file if necessary. rrYFrTrz-cannot pack 64-bit NDPI value to 32-bit dtypeTN)rrOr{rr"rrrrrrrerfrgrr~rrYrrrXr\rrrr) rkrOr"rrr use_fallbackrrrlrms rvastupleTiffTag.astuple )s djj% ( (JJE;;##D**4::6JJJZ]!33E^^$UGJqM?;C L $::?"KKZZ->->w-GHE#&u:#6LaZ 4::u(E(E"KKZZ8E"KK9djj9E [[++ggi(() 45 yy#djj/4::udBB $< 4 GB is only supported if single integer values and new offsets do not exceed the 32-bit range. Parameters: value: New tag value to write. Must be compatible with the ``struct.pack`` formats corresponding to the tag's data type. dtype: New tag data type. By default, the data type is not changed. erase: Overwrite previous tag value in file with zeros. Raises: struct.error: Value is not compatible with dtype or new offset exceeds TIFF size limit. ValueError: Invalid value or dtype, or old integer value in NDPI files exceeds 32-bit range. rPzcannot rewrite tag at offset z < 8rzGTiffTag.overwrite got an unexpected TiffFile instance as first argumentrY>rrrrUzcannot patch NDPI > 4 GB filesNruz<>|=zunknown data type rTrrrKr+rrzinvalid RATIONAL valuerQr)*rrrrrrrr"rYrrrrOr~rrarzrrrr.rrrgrr{rerrfrrrXr\rr(r%rrdrgrr$r)rkrOrrrrlr"r packedvaluerrrdtsizenewsizeoldsizerrms rvrTiffTag.overwrite0)sL ;;?d..21$++dCCS/ ! 5, ' '$ C. [[ # #{{ <<zzQ4::#8djj%00 1 A Az>:C$S/)??D =E =JJE s # #5zA~%(f"4ab  0((/ He,E$(  ,**51J A:%%%3!LL1E u--8 o%5zQ%*"7 JEHE u % %__Z0F5zF"2 o%J&(EKHE E 19 2C$S/)!    ++>>"53z!}+=#=">z!}oNKk"**vt/@/@/LMM&& ggiK  " a(T^^c%95AB111555GGDKK!O,HHV[[%MNGGAr{{+"$'')K"Q)#q( GGDKK!O,HH  OO!"KK(9(9;GGGK(HH[)333KK!Ofoodoobq6I&JJ a(T__eIJGGD,,-HHWw./#t'7'7''ARWW'L a(T__Ra%8%@A(()%W.2HHW(9:;2;;' ggi ?HHW%1$K a(KK D$5$5{C $%GGD,,-HHWw./ GGCL KK KK II      Y 0*5)4 o4/ 0 ,&ui0CS/t + ,*3rrrrrrYrrPr]rIrrzTiffTag c38# UHn[U5v M g7fry)r/rrs rvrTiffTag._str..F*s)De'!**erNrririr CORRUPTEDz= r )rrrrrrr rrrOr/r?r~rrrMrr) rkrrX is_strip_tilerrrlinerOs rvr TiffTag._str+*s %99 Q;F aZFaZF ::> q A& &Exx ((B78 ii[$r$++7Dii[4;;-0D$qr$*:*:);1= CJJE C::?#ENE#E)De)D$DEE Q; D5L DEUd* %et uUV} <6B C E s++ G8EEBGG G'&G')rrrrrrrOr)rrrrrrrzDATATYPE | intrrrOrgrrr6r) rrrr3rmr9rrr6r$)rrrrrrrrrrrrr6rg) rOrgrrrrrrr6rgr)rOrgr6rrKrK)r6r|)rOrgrzDATATYPE | int | str | Nonerrr6r$rBrr)rrrrrrGrLrn classmethodrrNrrrMrOrrrrrr rrr+rrr rtrurvr$r$'se(I "!# K, I J1 J'( K$%$$ $  $  $$$ $, "#bKbK  bK  bKbK bKbKH:%::: :  :  : ::x,,,&),36, ,,\%%N \\''88--KK"CR.2 ^ ^ + ^  ^  ^ @:$F --rur$c0\rSrSr%SrSrS\S'S\S'S\S 'S \S 'SS jrSS jrS Sjr S!Sjr S"Sjr S#S$Sjjr S#S%Sjjr S&S'SjjrS(SjrS)SjrS*SjrS+SjrS,SjrS-SjrS.SjrS.SjrS/S0SjjrSrg)1r&i[*a8Multidict-like interface to TiffTag instances in TiffPage. Differences to a regular dict: - values are instances of :py:class:`TiffTag`. - keys are :py:attr:`TiffTag.code` (int). - multiple values can be stored per key. - can be indexed by :py:attr:`TiffTag.name`` (``str``), slower than by key. - ``iter()`` returns values instead of keys. - ``values()`` and ``items()`` contain all values sorted by offset. - ``len()`` returns number of all values. - ``get()`` takes optional index argument. - some functions are not implemented, such as, ``update`` and ``pop``. )_count_dict_list_sortedrr zdict[int, TiffTag]r zlist[dict[int, TiffTag]]r! list[TiffTag] | Noner" cR0UlUR/UlSUlSUlgr)r r! r r" rs rvrnTiffTags.__init__x*s$ jj\  -1 rucURnURHnX#;dM XU' O URRX!05 U=RS- slSUlg)Add tag.rYN)rr! rr r" )rkrrrs rvr$ TiffTags.add~*sSxxA}$ JJ  tk * q  rucH[URR55$)zReturn codes of all tags.)rMr keysrs rvr* TiffTags.keys*sDJJOO%&&rucURcC[URVVs/sHoR5Ho"PM M snnSS9UlUR$s snnf)z1Return all tags in order they are stored in file.cUR$ryr=)r.s rvr!TiffTags.values..*sahhrur )r" rur! r)rkrr.s rvrTiffTags.values*sN << ! JJ;Jq 1 J;&DL||Return all (code, tag) pairs in order tags are stored in file.)rr)rkr.s rvr`TiffTags.items*s&%)[[]3] ]333s-NclURUSUS9nUcU$UR$![a Us$f=f)aQReturn value of tag by code or name if exists, else default. Parameters: key: Code or name of tag to return. default: Another value to return if specified tag is corrupted or not found. index: Specifies tag in case of multiple tags with identical code. The default is the first tag. N)rr)rSrOr)rkrrrrs rvrTiffTags.valueof*sE(hhsDh6 ;N 99  N s $ 33cTUc7XR;aURU$[U[5(dU$SnURUnX;aXA$[U[5(dU$UR 5HnUR U:XdMUs $ U$![a Us$f=f)aFReturn tag by code or name if exists, else default. Parameters: key: Code or name of tag to return. default: Another tag to return if specified tag is corrupted or not found. index: Specifies tag in case of multiple tags with identical code. The default is the first tag. r)r rrzr! r4rr)rkrrrrrs rvrS TiffTags.get*s( =jj zz#&c3''E ::e$D ;9 #s##N;;=Cxx3 ! N sB B'&B'cb/nURHnX;aURXA5 M O U(aU$[U[5(dU$URHFnUR 5H&nUR U:XdMURU5 O U(aMF O U=(d U$)zReturn list of all tags by code or name if exists, else default. Parameters: key: Code or name of tags to return. default: Value to return if no tags are found. )r! rrrzrr)rkrrrrrs rvr TiffTags.getall*s!#JJD{ di(  M#s##NJJD{{}88s?MM#&%6   rucXR;aURU$[U[5(d [U5eURR 5HnUR U:XdMUs $ [U5e)z>Return first tag by code or name. Raise KeyError if not found.)r rrzrrr)rkrrs rvrTiffTags.__getitem__+sd ** ::c? "#s##3- ::$$&Cxx3 'smrucJURU:XdeURU5 g)r' N)rr$)rkrrs rv __setitem__TiffTags.__setitem__ +sxx4  rucSnURH#nX;aSnX1 U=RS-slM# O U(aSUlg[U[5(d [ U5eURHPnUR 5H9nURU:XdMX4R U=RS-slSn MN O U(d [ U5eSUlg)z Delete all tags by code or name.FTrYN) r! r r" rrzrrrr)rkrfoundrrs rv __delitem__TiffTags.__delitem__+sJJD{I q   DL #s##3- JJD{{}88s?XXKK1$K E %3-  ruc^TUR;ag[T[5(dg[U4SjURR 555$)zReturn if tag is in map.TFc3@># UHoRT:Hv M g7fry)r)rrrs rvr(TiffTags.__contains__..3+sC/B88t#/B)r rrzr;rrkrs `rv __contains__TiffTags.__contains__-+s@ 4:: $$$Ctzz/@/@/BCCCruc4[UR55$)zReturn iterator over all tags.)rrrs rvrTiffTags.__iter__5+sDKKM""rucUR$)zReturn number of tags.)r rs rvrTiffTags.__len__9+s {{ruc"S[U5SS3$)Nz)r6z list[TiffTag])r6zlist[tuple[int, TiffTag]]r)rrgrr3rrDr6rg)rr8rr3rrDr6r8ry)rrgrrDr6r# )rrDr6r$)rrrr$r6rrrDr6r)rrJr6r)r6zIterator[TiffTag]rKrKrr)rrrrrrGrLrnr$r* rr`rrSr rr; r? rF rrr+rrr rtrurvr&r&[*s 8I K  ## !!2 '4      @#' % %  % %  %V ! !  !  !D  :D#9  rur&c\rSrSr%SrSrS\S'S\S'S SjrS S jrS!S jr S"S jr \ S#S j5r \ S$S j5r \ S%Sj5r \ S&Sj5r S'S(Sjjr \ S)Sj5r \ S*Sj5r \ S+Sj5r \ S,Sj5r S'S-Sjjr \ S.Sj5r\ S/Sj5rS0SjrS1SjrS2SjrS3SjrS4SjrS5SjrS5SjrSrg)6r%iS+aRegistry of TIFF tag codes and names. Map tag codes and names to names and codes respectively. One tag code may be registered with several names, for example, 34853 is used for GPSTag or OlympusSIS2. Different tag codes may be registered with the same name, for example, 37387 and 41483 are both named FlashEnergy. Parameters: arg: Mapping of codes to names. Examples: >>> tags = TiffTagRegistry([(34853, 'GPSTag'), (34853, 'OlympusSIS2')]) >>> tags.add(37387, 'FlashEnergy') >>> tags.add(41483, 'FlashEnergy') >>> tags['GPSTag'] 34853 >>> tags[34853] 'GPSTag' >>> tags.getall(34853) ['GPSTag', 'OlympusSIS2'] >>> tags.getall('FlashEnergy') [37387, 41483] >>> len(tags) 4 )r r! zdict[int | str, str | int]r z list[dict[int | str, str | int]]r! cX0UlUR/UlURU5 gry)r r! r )rkrxs rvrnTiffTagRegistry.__init__v+s$  jj\  Cruc[U[5(a+UR5Hup#URX#5 M g[U[5(a[ UR55nUHup#URX#5 M g)z]Add mapping of codes to names to registry. Parameters: arg: Mapping of codes to names. N)rr%r`r$rrM)rkrxrrs rvr TiffTagRegistry.update+sg c? + +!iik $*  c4 syy{#CJD HHT rucURH(nX;a X1U:Xa gX;dMX#;dM X#U'XU' g URRXX!05 g)zAdd code and name to registry.N)r! r)rkrrrs rvr$TiffTagRegistry.add+sSAyQW_}$$ JJ  t46 7ruc>SUR5n[USS9$)z*Return all registry items as (code, name).c3# UH8oR5H!n[US[5(dMUv M# M: g7fr0)r`rr)rrrs rvr(TiffTagRegistry.items..+s. !!779a 1Q48MAA9Azs /A Ac US$rrt)rs rvr'TiffTagRegistry.items..+s1Q4rur )r! ru)rkr`s rvr`TiffTagRegistry.items+s$ zz e00rucgryrtrkrrs rvrSTiffTagRegistry.get+=@rucgryrtrg s rvrSrh +ri rucgryrtrg s rvrSrh +58rucgryrtrg s rvrSrh +rl ruNcBURHnX;dM X1s $ U$)zReturn first code or name if exists, else default. Parameters: key: tag code or name to lookup. default: value to return if key is not found. r! )rkrrrs rvrSrh +s%Axv rucgryrtrg s rvr TiffTagRegistry.getall+FIrucgryrtrg s rvr rq +rr rucgryrtrg s rvr rq +DGrucgryrtrg s rvr rq +ru ruclURVs/sHo1U;dM X1PM nnU=(d U$s snf)zReturn list of all codes or names if exists, else default. Parameters: key: tag code or name to lookup. default: value to return if key is not found. ro )rkrrrrs rvr rq +s4#'**9*Qq&!&*9  :s 11cgryrtrs rvrTiffTagRegistry.__getitem__+/2rucgryrtrs rvrry +rz rucTURHnX;dM X!s $ [U5e)z7Return first code or name. Raise KeyError if not found.)r! r)rkrrs rvrry +s(Axv smrucSnURHnX;dM SnX1nX1 X4 M U(d [U5eUR/URSSVs/sH o3(dM UPM sn-Ulgs snf)z Delete all tags of code or name.FTrYN)r! rr )rkrr> rrOs rvr? TiffTagRegistry.__delitem__+soAxFH  3- jj\ 12$D1!Q$DD $Ds  A5$A5cB^[U4SjUR55$)z&Return if code or name is in registry.c3.># UH nTU;v M g7fryrt)rrrs rvr/TiffTagRegistry.__contains__..+s1j419j)r;r! rE s `rvrF TiffTagRegistry.__contains__+s1djj111ruc4[UR55$)z+Return iterator over all items in registry.)rr`rs rvrTiffTagRegistry.__iter__+sDJJL!!rucRSnURHnU[U5- nM US-$)z!Return number of registered tags.rrT)r! r)rkrrs rvrTiffTagRegistry.__len__,s,A CFNDqyruc"S[U5SS3$)Nz.,s!N:41TF"THA.s)r rr`rs rvrTiffTagRegistry.__str__ ,s-,33 LLNN N  ru)rxzrrzr6r>)rlist[str] | list[int] | NonerrDr6r rrr6rz)rrzr6r)rrDr6rDrX )rrDr6r)r6zIterator[tuple[int, str]]rKrK)rrrrrrGrLrnr r$r`rarSr rr? rF rrr+rr rtrurvr%r%S+sP8#I %% ++ I  ! I!  !*8 1@@ @@ 88 88>B *:    II II GG GGJN !*F ! ! % !22 22 E2"@ rur%c \rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S \S 'S\S'S\S'S\S'S\S'S\S'S\S'S \S'S\S'S\S'S\S'S\S'S \S!'SDS"S"S"S"S"S"S"S#S#S"S$. SES%jjjr\SFS&j5r\ SGS'j5r \SHS(j5r \SIS)j5r \SJS*j5r \ SKS+j5r\ SLS,j5r\ SJS-j5r\ SJS.j5r\ SMS/j5r\ SNS0j5r\ SOS1j5r\ SOS2j5r\ SPS3j5r\ SQS4j5rS"S5.SRS6jjrS"S"S7.SSS8jjrS"S"S7.STS9jjr\SUS:j5rSVS;jr\SWS<j5r\SXS=j5r\SYS>j5r\SZS?j5r \SJS@j5r!SHSAjr"SHSBjr#SCr$g")[ri,aSequence of TIFF pages making up multi-dimensional image. Many TIFF based formats, such as OME-TIFF, use series of TIFF pages to store chunks of larger, multi-dimensional images. The image shape and position of chunks in the multi-dimensional image is defined in format-specific metadata. All pages in a series must have the same :py:meth:`TiffPage.hash`, that is, the same shape, data type, and storage properties. Items of a series may be ``None`` (missing) or instances of :py:class:`TiffPage` or :py:class:`TiffFrame`, possibly belonging to different files. Parameters: pages: List of TiffPage, TiffFrame, or ``None``. The file handles of TiffPages or TiffFrames may not be open. shape: Shape of image array in series. dtype: Data type of image array in series. axes: Character codes for dimensions in shape. Length must match shape. attrs: Arbitrary metadata associated with series. coords: Ordered map of dimension character codes to coordinate arrays. units: Map of dimension character codes to unit strings. index: Index of series in multi-series files. parent: TiffFile instance series belongs to. name: Name of series. kind: Nature of series, such as, 'ome' or 'imagej'. truncated: Series is truncated, for example, ImageJ hyperstack > 4 GB. multifile: Series contains pages from multiple files. transform: Function to transform image data after decoding. rrrrrrnumpy.dtype[Any]rrzrr-Callable[[NDArray[Any]], NDArray[Any]] | None transformr is_multifile is_truncated!list[TiffPage | TiffFrame | None]_pagesrr_lenrrMrrr&dict[str, str]_unitsrr_explicit_coordsNF) rrunitsrrrrr multifiler c SUlSUlUc0O [U5UlUc0O [U5UlUc0O [U5Ul[ UR 5UlUcSO [U5Ul [U5Ul U/Ul [UR5n[SUR55nUc UR"nUc UR$nUc UR&n[(R&"U5UlU =(d SUlU =(d SUlXlUUl[3U 5Ul[3U 5UlU bXlO4UR(aUR0R8UlOSUl[;U5UlX@lU (dOUS:XaI[=UR"5nUS:a'[[=UR5U-5UlgXlgXlg![a= [SUR55nGNp![a Sn[!U5Sef=ff=f)Nr=rtrc3# UHVnUcMURcMURRRR(aMHURv MX g7fry)rrrrrs rvr*TiffPageSeries.__init__..,sN$AJJ ))44;;  $sA  A -A  A c3b# UH%nUcMURcMURv M' g7fryr[rs rvrr ,s, ()*AJJ(s / //z no valid keyframe found in pagesrY) rrrr&r rr!r rrrMr rrrrrrrrrrrr rrr r rr~r@r )rkrrrrrrr rrrrrr r rrrrs rvrnTiffPageSeries.__init__i,s&  !MbtE{ !MbtE{ #^rf #DLL 1 =ac%j 5k f T[[! 0H$ =NNE <==D =NNE[[' JB JB "   O O   K [[--..DKDKEl  Vq['A1u 4 9: " IW 0 0 ![[  ! 08 o4/ 0 0s+H IH77IIc2[UR5S:$)z%Series contains multiple resolutions.rY)rrrs rv is_pyramidalTiffPageSeries.is_pyramidal,rerucUR(dgSnURH{nUb[UR5S:Xa gUR(d gU(dURSUR-nMYXRS:wa gXR- nM} URSnUb[UR5S:XagURSn[UR5S:XaJ[ U[ 5(a5UR(d"UR(dUR(aU$X[UR5URR--:XaU$g)z(Offset to contiguous image data in file.NrrY)r rrrrrrrrer:r@rrr)rkrmrrs rvrTiffPageSeries.dataoffset,s {{KKD|s4#3#349==&&q)DKK7&&q)) ;; C {{1~ <3t//0A5!!!$   !4**4>>T[[M 74;;/$**2E2EEE EMrucUR$)z.Character codes for dimensions in image array.)rrs rvrTiffPageSeries.axes,zzrucUR$)zShape of image array in series.rrs rvrTiffPageSeries.shape,reruc,[UR5$rprqrs rvrTiffPageSeries.ndim,rsruc>[[UR55$rurvrs rvrTiffPageSeries.dims,ryrucR[[URURSS95$r{r|rs rvrTiffPageSeries.sizes,r~ruc,[UR5$rrrs rvrTiffPageSeries.size,rrucHURURR-$rN)rrrrs rvrTiffPageSeries.nbytes-syy4::....rucURnURnURS5S:Xa+URS5S:XaSU;aSU;a USUS4$g)z>Pixel spacing in micrometer as (x, y), or None if unavailable.r micrometerrN)rrrS)rkrr s rvrTiffPageSeries.mpp-s^""   IIcNl * #,.v v 3K- -ruc*^ 0m URR5Hfup[U[5(aGUup4URUR R U5n[R"X4USS9T U'MaUT U'Mh [U 4SjUR 55(dgURRn[UR URSS9H.upxUT ;dM Xv;dMXgn [U 5U:XdM)U T U'M0 T $)z>Ordered map of dimension character codes to coordinate arrays.Frc3,># UH oT;v M g7fryrtrrrs rvr(TiffPageSeries.coords..!-5*B<*rTr4)rr`rr~rrrrrrlrrrr) rkrrOrrnum kf_coordsrrkcrs @rvrTiffPageSeries.coords-s+-,,,,.JC%''# kk$**"2"23"78#nnU#Ns #s /5$**555 ,,I DKKEV#"B2w$%'r F  rucB^ 0m URR5GHup[U[5(aO[ U5S:Xa@Uup4UR UR RU5nUS:a XC- U- T U'MhMj[U[R5(dMURRS:XdM[ U5S:dMUSUS- [ U5S- - n[R"U5n[R"XvSSS9(dGM[U5T U'GM [U 4SjUR 55(dUR R"nUR Hn U T ;dM X;dMXn U RRS:XdM2[ U 5S:dMCU SU S- [ U 5S- - n[R"U 5n[R"XvS SS9(dM[U5T U 'M T $) aECoordinate step sizes per axis. Map dimension character codes to the spacing between consecutive coordinate values. Only axes with numeric, approximately uniformly spaced coordinates are included. The scale is the average step size ``(last - first) / (n - 1)``, provided all individual steps are within 5% of that average. rTrrrYrK皙?)rtolatolc3,># UH oT;v M g7fryrtr s rvr.TiffPageSeries.coord_scales..H-r r皙?)rr`rr~rrrrrr8rrrallcloserYrlrr) rkrrOrrr avgdiffsr rr rs @rvrTiffPageSeries.coord_scales*-s$&,,,,.JC%''CJ!O$ kk$**"2"23"787#'<3"6F3KE5==11ekk6F6F#6Mu:> 9uQx/CJNCC!JJu-E~~et!DD&+Cjs !/$5$**555 ,,IjjV#"Bxx}}+B! !"v1~#b'A+> % 2 >>%3QGG).sF2J! ruc^0mURR5Hup[U[5(a[ U5S:XdN[U[ R 5(dMJURRS:XdMf[ U5S:dMw[US5TU'M [U4SjUR55(dzURRnURHTnUT;dM XC;dMX4nURRS:XdM2[ U5S:dMC[US5TU'MV T$)zCoordinate offsets (first pixel position) per axis. Map dimension character codes to the coordinate value of the first pixel. Only axes with numeric coordinates are included. rTrrc3,># UH oT;v M g7fryrtr s rvr/TiffPageSeries.coord_offsets..h-r r)rr`rr~rrr8rrrYrlrrr)rkrrOr rr rs @rvrTiffPageSeries.coord_offsetsT-s$&,,,,.JC5%((SZ1_5%--00KK$$+JN#E!Hos /5$**555 ,,IjjV#"Bxx}}+B! %*2a5\r !  ruc^[UR5m[U4SjUR55(dURR R S5n[U[5(a[US;aUURRnSH9nX0R;dMUT;dMX0R;dM-X2;dM4UTU'M; T$)zXCoordinate unit strings per axis. Map dimension character codes to their unit string. c3<># UHoS;dM UT;v M g7f)XYZNrtr s rvr-TiffPageSeries.coord_units..{-sD*Be <2<*s  r>r undefinedrrZ) rr rlrrrrSrrzrr )rkrr rrs @rvrTiffPageSeries.coord_unitsq-sdkk"D$**DDDmm))--.>?G'3''G<-!MM00 )Bjj(f,&;&;;O%,r * ruc\URRR5VVs0sHupUS:wdM X_M nnnURUR5 SU;aUR nUbXCS'SH+nX;dM [ X5nU(dM[U5X1'M- U$s snnf)zMetadata dictionary for series.rr)rrr)rrr`r r&rrr)rkrrOrrs rvrTiffPageSeries.attrs-s #mm11779" 9 && CJ9 "  dkk"  ((C #u CC *5"&u+FK D  " s B(B()rc URc Sn[U5eUbURUR"S0UD6$URR"SSU0UD6nURbUR U5nU$)zReturn images from series of pages as NumPy array. Parameters: level: Pyramid level to return. By default, the base level is returned. **kwargs: Additional arguments passed to :py:meth:`TiffFile.asarray`. no parentrrt)rrrrr )rkrrrrs rvrTiffPageSeries.asarray-sy ;; CS/ !  ;;u%--77 7$$;D;F; >> %^^F+F ru)rrc SSKJn URc Sn[U5eUnU(dUcPURS:wa@URR SS9nUR [U5:aXpR nUbURUnUSLaUR"S SS0UD6nOUR"S 0UD6nU"UURURURURS 9$) a!Return image data from series of pages as xarray DataArray. Parameters: level: Pyramid level to return. By default, the base level is returned. squeeze: Remove length-1 dimensions from image array, except X and Y. If ``False``, preserve all dimensions. If ``None`` (default), remove length-1 dimensions except for ``'shaped'`` series. **kwargs: Passed to :py:meth:`asarray`. Returns: :py:class:`xarray.DataArray` Image data with coordinates, dimensions, and attributes. rrmr rTrFrrHrt)rrnrrrr rrrrrrrr) rkrrrrnrrrrs rvrTiffPageSeries.asxarray-s2 % ;; CS/ !!% w499+@{{..t.>:%:6:D>>+F+D ==,,   ruc URc Sn[U5eSSKJn UnU(a@URR SS9nUR [ U5:aXpR nU"U4SU0UD6$)aReturn images from series of pages as Zarr store. Parameters: level: Pyramid level to return. By default, a multi-resolution store is returned. squeeze: Remove length-1 dimensions from image array, except X and Y. If ``False``, preserve all dimensions. If ``None`` (default), remove length-1 dimensions except for ``'shaped'`` series. **kwargs: Additional arguments passed to :py:class:`ZarrTiffStore`. r rYrKTrr)rrrrr rr)rkrrrrrrrs rvrTiffPageSeries.aszarr-sp, ;; CS/ !'!% {{..t.D|t{{2: o%;;$$--djj3.>? ?{{3rucgryrtrs rvrTiffPageSeries.__getitem__/.s'*rucgryrtrs rvrr 4.s-0ruc[U[[R45(aUR [U55$[U[ 5(a@[ URUR56Vs/sHo R U5PM sn$[U[5(a6[U[5(d!UVs/sHo0R U5PM sn$Sn[U5es snfs snf)zReturn specified page(s).r) rrrrrrrrr rSrzr)rkrrrrs rvrr 9.s cC/ 0 0==S* * c5 ! !.3S[[5K.LM.LMM!$.LM M c8 $ $ZS-A-A.12cMM!$c2 2:n N2s 8C-C2c#|# [UR5UR:XaURShvN gURbURSc Sn[ U5eURR nURSR n[UR5H nX#U-v M gN7f)z%Return iterator over pages in series.Nrr )rr r rrrrr)rkrrrrs rvrTiffPageSeries.__iter__G.s t{{ tyy ({{ " "{{"dkk!n&<: o%KK%%EKKN((E499%AI&&& #s3B<B:BB<cUR$)z!Return number of pages in series.)r rs rvrTiffPageSeries.__len__U.yyruc<SURSURS3$)Nz.^.s"   A rr=rc38# UHn[U5v M g7fryrrs rvrr b.rrz Levelsr@zTiffPageSeries ) rrr*rrzrrrr rrrr)rkrs rvrTiffPageSeries.__str__].s II 26499-"-444DJJ  262C2CC $%W-t9+V$+/??1T__%&   ! Rs33ru)r&rrr rr r rr rr r rrrrrr NNN)rr2rr3rrQr%Sequence[TiffPage | TiffFrame | None]rzMapping[str, Any] | Nonerz7Mapping[str, NDArray[Any] | tuple[float, float]] | Noner zMapping[str, str] | Nonerr3rrrrQrrQrrr rr r r6rrrrKrrKrr)r6ztuple[float, float] | Noner)r6dict[str, float]r6r r)rr3rrgr6r)rr3rr%rrgr6rn)rr3rr%rrgr6r)r6r)rrr6r)rint | numpy.integer[Any]r6r)rrr6r )r0int | numpy.integer[Any] | slice | Sequence[int]r6z?TiffPage | TiffFrame | list[TiffPage | TiffFrame | None] | None)r6z%Iterator[TiffPage | TiffFrame | None])%rrrrrrLrnrMr rXrrrrrrrrrrrrrrrrrrrrarrbrrr+rr rtrurvrr,s,\ ! D ., A I I-<<:4I .- K I J     '+"& R+/JN*. "&CG#R$ R  R  R4R(RHR(RR RRRR !R"A#R$ %Rh$$B00==##//  &''R84(&*"58 4!# 4 4  4  4  4 r!# "<"< "<  "<  ">> with TiffFile('temp.ome.tif') as tif: ... series = tif.series ... series[0].shape ... series(squeeze=False)[0].shape ... series(kind='generic')[0].shape ... (8, 2, 512, 512, 3) (8, 2, 1, 512, 512, 3) (16, 512, 512, 3) r_parentr_squeezerQ_kindNT)rrc(XlX lX0lgry)r r r )rkrrrs rvrnTiffSeries.__init__.s   ruc*[URX!S9$)aXReturn new TiffSeries with specified kind and squeeze settings. Parameters: kind: Filter series by kind, such as 'ome' or 'imagej'. If ``None``, the default series are returned. squeeze: Remove length-1 dimensions from series shapes, except X and Y. If ``False``, series shapes include all dimensions. )rr)r#r )rkrrs rv__call__TiffSeries.__call__.s"$,,CCruc^URRURURS9$)z6Return list of TiffPageSeries, computing if necessary.r)r r r r rs rvrTTiffSeries._series.s&||'' DMM'JJrucgryrtrs rvrTiffSeries.__getitem__.srucgryrtrs rvrr .s #rucTURn[U[[R45(aU[U5$[U[ 5(aX!$[U[ 5(a*[U[5(dUVs/sHo2UPM sn$Sn[U5es snf)zReturn specified series.r) rTrrrrrrSrzr)rkrrrrs rvrr .s  cC/ 0 0#c(# # c5 ! !;  c8 $ $ZS-A-A'*+s!1Is+ +:n,sB%c,[UR5$)zReturn number of series.rrTrs rvrTiffSeries.__len__.s4<<  ruc,[UR5$)zReturn iterator over series.)rrTrs rvrTiffSeries.__iter__.sDLL!!ruc2[UR5S:$)z Return True if any series exist.rr rs rvrTiffSeries.__bool__.s4<< 1$$ruc S[U5S3$)Nzrrs rvr+TiffSeries.__repr__.s'D {"55ruc2SRSU55$)Nr c3,# UH nSU3v M g7fr Nrtrs rvr%TiffSeries.__str__...s04a2aS4rrs rvrTiffSeries.__str__.syy04000ru)r r r )rrrrQrrr6r)rrQrrr6r#)r6r)rr r6r)rrr6r)rr r6z%TiffPageSeries | list[TiffPageSeries]rK)r6zIterator[TiffPageSeries]rrK)rrrrrrLrnr rMrTrarrbrrrr+rr rtrurvr#r#p.s5>N               DD D  D&KK+ #(# ## C  .  !!""%61rur#c\rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S \S'S\S'SSSS.S%SjjrSSSSSSSS.S&SjjrS'SjrS(Sjr S)Sjr \ S*Sj5r \ S+Sj5r\ S*Sj5r\S,Sj5r\S-Sj5r\ S.Sj5rS/S jrS0S!jrS)S"jrS)S#jrS$rg)1ri.adSequence of files containing compatible array data. Parameters: imread: Function to read image array from single file. files: Glob file name pattern or sequence of file names. If ``None``, use '\*'. All files must contain array data of same shape and dtype. Binary streams are not supported. container: Name or open instance of ZIP file in which files are stored. sort: Function to sort file names if ``files`` is a pattern. The default is :py:func:`natural_sorted`. If ``False``, disable sorting. parse: Function to parse sequence of sorted file names to dims, shape, chunk indices, and filtered file names. The default is :py:func:`parse_filenames`` if ``kwargs` contains ``'pattern'``. **kwargs: Additional arguments passed to ``parse`` function. Examples: >>> filenames = ['temp_C001T002.tif', 'temp_C001T001.tif'] >>> ims = TiffSequence(filenames, pattern=r'_(C)(\d+)(T)(\d+)') >>> ims[0] 'temp_C001T002.tif' >>> ims.shape (1, 2) >>> ims.axes 'CT' Callable[..., NDArray[Any]]r4rMrrzrrrztuple[tuple[int, ...]]rr rSrg _containerN)rrparsec ^^SnUcSnUc[nO [U5(aUnO U(a[nUTlUbSSKn[ U[ [ R45(aSSKn U RU5TlO([TRS5(d Sn [U 5e[ U[ 5(a5URTRR5U5nUbU"U5nO[ U[ R5(a[ R"U5/nOL[ U[ 5(a"[R"U5nUbU"U5nOUbUbU"SU55nUV s/sHn [ R"U 5PM nn U(d Sn [U 5e[U5(d Sn [!U 5eU(aU4SU4Sjjjn U nUcUR#S 5(a[$nU(aU"U40UD6uppO2S n ['U54n[)S [+['U5555n[ U[,5(de[ US[ 5(de[.R0mS R3U4SjU 55nUTlUTlUTl[)U 5Tl[)U5TlUTlgs sn f![anS n [U 5UeSnAff=f)NrrrDzinvalid containerc3$# UHov M g7fryrtrs rvr(FileSequence.__init__..N/s/Aarzinvalid imread functionc>TRRU5n[R"UR 55nU"U40UD6sSSS5 sSSS5 $!,(df  O=fSSS5 g!,(df  g=fry)r' rDr}r~r)r_imreadrhandle1handle2rks rvimread_&FileSequence.__init__..imread_[/s`OO((2gJJw||~.'"75f5/.32...322s#%A9 A A9 A, (A99 Brzfailed to parse file names)sequencec3&# UHo4v M g7fryrtrs rvrr+ r/s<*;QD*;sr=c3># UH6nTRUR5USR55v M8 g7fr0)rSrrN)rdimrs rvrr+ w/s/N#uyyc!flln==s>A)rrzr. rgrrgr6r) r;callabler' fnmatchrrzrPathLikezipfileZipFilerrfilternamelistr rrrSr=rr~rrMr AXES_CODESrrSr4rrrr)rkr4rrrr( r sort_funcr8 r: rrr1 rrrrrrs` @rvrnFileSequence.__init__/s6: =E <&I d^^I &I$  )c2;;%788")//)"<T__f55) o%%%%t'?'?'A5I(%e,E r{{ + +YYu%&E s # #IIe$E$!%(  )"7///E',-u!1u-"CS/ !+CC. /5 6 6(+ 6@C 6 6 6F =VZZ 22#E  /.3E.DV.D+We !DZME<%E *;<T(aTR"U4STU0TD6 gTR"U40TD6nUTU'AgNrr)rrimrrrrks rvr"FileSequence.asarray..func/sAKKFfUmFvFX88B$&F5MrurTr4rKc>[[R"UTR55nT(aTR"U4STU0TD6 gTR"U40TD6nUTU'AgrC )rrravel_multi_indexrr4)rrindex_rD rrrrks rvrrE /sa++E4::>KKGfVnGGX88B%'F6NruFr)rztuple[int | slice, ...]rrzr6r)rSr MAXIOWORKERSrrrrr4rrrrr(r-rslicesrrTr8rt)rkrrrrrrrrrrD tiledrrrr;rrrs` ` ` @rvrFileSequence.asarray/sH@  ! j F    A ))IE I. )S))))  4;;K{+K  !3U1X00BJJ[[, %%% !$**jNE"3 Z@F  1}'*LL.d(OE)(N E( 2h%\\ll4<<8%3D 9JJ+E"3z:F^^R$5*$56F  1}'*4<<t'LOE)(M( 2h%\\$ eDE3^^E^6F E32D 32s3I%I I I'c  SSKJn U"U40UD6$)z{Return images from files as Zarr store. Parameters: **kwargs: Arguments passed to :py:class:`ZarrFileSequenceStore`. rY)ZarrFileSequenceStore)rrN )rkrrN s rvrFileSequence.aszarr0s 0$T4V44ruc`URbURR5 SUlg)zClose open files.N)r' rrs rvrFileSequence.close0s# ?? & OO ! ! #ruc[UR5S:Xa.[RR URS5nU$[RR UR5nU$)z8Return longest common sub-path of each file in sequence.rYr)rrSrrErG commonpath)rkrS s rvrS FileSequence.commonpath 0sU t{{ q Q8J++DKK8JrucX[UR5[UR5- $)z$Number of missing files in sequence.)r@rrrSrs rv files_missingFileSequence.files_missing(0s!tzz"S%555ruc,[UR5$)z$Return iterator over all file names.)rrSrs rvrFileSequence.__iter__-0sDKK  ruc,[UR5$ry)rrSrs rvrFileSequence.__len__20s4;;rucgryrtrs rvrFileSequence.__getitem__60rz rucgryrtrs rvrr] 90s7:ruc URU$ry)rSrs rvrr] <0s{{3rucU$ryrtrs rvrFileSequence.__enter__@0rruc$UR5 gryr r!s rvr%FileSequence.__exit__C0r'ruc"S[U5SS3$)Nz.V0s,HZSVVZrzdims: {}c3$# UHov M g7fryrtrs rvrri W0s+Ay!Ayr, )r' rzrSrrErrrrrrV r rr)rkrs rvrFileSequence.__str__N0s'+s4??#DKKNww}}T"2&zz''#dkk*+2d.@.@-AK""499,HTZZ,H#HI!!$))+Atyy+A"AB    ru)r' rSrrr4rr)r4r& r@str | os.PathLike[Any] | Sequence[str | os.PathLike[Any]] | Nonerstr | os.PathLike[Any] | Noner Callable[..., Any] | bool | Noner( zCallable[..., Any] | Nonerrgr6r)rr*rr/rr3r1dict[int, int] | Sequence[tuple[int, int]] | Nonerr3rr%rrwrrgr6r)rrgr6rN rBrKrK)r6 Iterator[str]r )rrr6r )r int | slicer6zstr | list[str]rFrG)rrrrrrLrnrrrrS rMrV rbrrrarrr%r+rr rtrurvrr.s"H ('8 B I2 ' ##$ O4815+/`+` M `1`/`)`` `J-1-1'+GK !#'M*M+ M % M E MM!MMM M^ 5 66!!  22 ::   ,((   =  rurcj^\rSrSrSr\S\S.SU4Sjjjj5r\S Sj5rSr U=r $) r"i]0zSequence of TIFF files containing compatible array data. Same as :py:class:`FileSequence` with the :py:func:`imread` function, ``'\*.tif'`` glob pattern, and ``out_inplace`` enabled by default. rc 2>[TU]"X!cSOU40UD6 g)Nz*.tif)superrn)rkrr4rrs rvrnTiffSequence.__init__f0s MuOOruc"S[U5SS3$)Nz>> ts = TiledSequence((1, 2), (3, 4), axestiled={1: 0}, axes='ABYX') >>> ts.shape (1, 6, 4) >>> ts.chunks (1, 3, 4) >>> ts.axes 'AYX' ) _axestiled _chunkdims_shape_untiled _stackdimsr axes_squeezedrrshape_squeezedrMrrzstr | tuple[str, ...] | Nonerr r~ rr} r{ r| ztuple[tuple[int, int], ...]rz N)rrc .^^[U5Tl[U5Tl[U5[U5-TlUb/[U5[TR5:wa Sn[ U5eU(Gal[[ U4Sj[U5R55SS95Tl Uc/O [U5n[TR5nS/TR-[U5-n[5n TRHLupX;dX;a Sn[ U5eU RU 5 U RU 5 X{==X-ss'MN TRHupXz X U(dMXj M [U5Tl [U5TlUcSTlO[!U["5(aSR%U5TlO[U5TlOpSTl TRTl S TR-[U5-TlUcSTlO-[!U["5(aUTlO[U5Tl[TR5[TR5:XdeTRb.[TR5[TR5:XdeTRc)[S TR55TlSTlgS m[U4S j[+TRTRSS 955Tl[U4Sj[+TRTRSS 955n [!TR["5(aSR%U 5OU Tlg)Nz2axes length does not match stackshape + chunkshapec3H># UHupXTR-4v M g7fry)r} )rax0ax1rks rvr)TiledSequence.__init__..0s&(?HCDOO34(?s"T)reverserYzduplicate axisr=rtrc34# UHoS:dM Uv M g7frrtrs rvrr 1s'G:aQ:s  )rrrXrYrc3H># UHupUS:dUT;dMUv M g7frrtrrrkeeps rvrr 1s)(DEAq5B$JD" "r4c3H># UHupUS:dUT;dMUv M g7frrtr s rvrr 1s)DEAq5B$JDr )rr} r{ r~r| rrurr`rz rMr!r$rrrrrzrr r~ r)rk stackshaperrrr axes_listrrrr r _ax1rr s` @rvrnTiledSequence.__init__0sj/j/#J/% 2CC  D S1D1D-E EFCS/ ! $(,Y(=(=(?! DO#lT I,,-ES4??*T*-==F5D OO;#+*C$S/)   jo- ,"__ JK9! - uDJ-DK|  D#&&GGI. !),  DO,,DJ053DDDK|  D#&&  !$K 4::#dkk"2222 99 tzz?c$))n4 44 99 "''G4::'G"GD !%D :D"'( TYYtD(#D   TYYtDH &0 3%?%?!X  ruc#H# S/UR-nUHn[U5UR:wa'S[U5<SUR3n[U5e/UQUQnURH upgXVXW'M URHuphXV M [ U5v M g7f)zxReturn iterator over chunk indices of tiled sequence. Parameters: indices: Indices of chunks in stacked sequence. r len(index)=rN)r{ rr} rrz r~) rkrrrr index_listr r r s rvrTiledSequence.indices1sS4??* E5zT__,$U T$//):; o%.5.:.J OO",/ ,!__ O- # #sB B"c## [S5/UR-nUc-[R"URSUR 5nUHn[ U5UR :wa'S[ U5<SUR 3n[U5e/UQUQnURH9upgURUn[[XV5U-n [XU-5XW'M; URHupjXV M [U5v M g7f)zReturn iterator over slices of chunks in tiled sequence. Parameters: indices: Indices of chunks in stacked sequence. By default, iterate over all chunks in stacked sequence. Nr r) rr{ rndindexr| r} rrrz r_rr~) rkr chunkslicerr wholeslicer r r2rr s rvrJ TiledSequence.slices,1s*/t (G ?mmD$7$78I$//$JKGE5zT__,$U T$//):; o%.5.:.J OO'',jo.2"'q5/ ,"__ O- # #sDD c,[UR5$)z'Number of dimensions in tiled sequence.rqrs rvrTiledSequence.ndimM1rsruc,[UR5$)zSequence is tiled.)rrz rs rvr^TiledSequence.is_tiledR1sDOO$$ruc<SURSURS3$)Nz++0HL+/W!W"W E W)W Wr$.$ "$29=$5$ *$B%% rur(c&\rSrSr%SrSrS\S'S\S'S\S 'S\S 'S\S 'S \S 'S \S'S\S'S\S'S=SSSS.S>SjjjrS?SjrS?Sjr S@Sjr SASjr SASjr S@Sjr SBSCSjjrSDSESjjrSFSjrSGSjrS?S jrSBS!S"S#.SHS$jjjrSISS%.SJS&jjjrSKSS'.SLS(jjjrSMS)jrS=SNS*jjrSOS+SSS+S,.SPS-jjjrSQS.jrSRS/jrSSS0jrSSS1jr\SSS2j5r\SSS3j5r\SSS4j5r \SSS5j5r!\S@S6j5r"\SAS7j5r#\STS8j5r$\$RJSUS9j5r$SVS:jr&\SAS;j5r'\SAS<j5r(Sr)g)Wri]1aBinary file handle. A limited, special purpose binary file handle that can: - handle embedded files (for example, LSM within LSM files). - re-open closed files (for multi-file formats, such as OME-TIFF). - read and write NumPy arrays and records from file-like objects. When initialized from another file handle, do not use the other handle unless this FileHandle is closed. FileHandle instances are not thread-safe. Parameters: file: File name or seekable binary stream, such as open file, BytesIO, or fsspec OpenFile. mode: File open mode if ``file`` is file name. The default is 'rb'. Files are always opened in binary mode. name: Name of file if ``file`` is binary stream. offset: Start position of embedded file. The default is the current file position. size: Size of embedded file. The default is the number of bytes from ``offset`` to the end of the file. ) _close_dirr#_file_lockrW_nameru_sizez6str | os.PathLike[Any] | FileHandle | IO[bytes] | Noner zIO[bytes] | Noner#rzrWr r rrur rr threading.RLock | NullContextr N)rrrcUcSOUUlSUlXlU=(d SUlSUlUcSOUUlUcSOUUlSUl[5Ul UR5 URceg)NrEr=rKT) rWr#r r r rur r rr rD)rkrrrrrs rvrnFileHandle.__init__1sr"\Tt  ZR  #^r R@"[<5 URRBUlSSS5 GOD[)URS5(GaURn[1[2[4UR55UlURR75 UR"S:aURR75UlSUlUR(d7[RRUR5uUl Ul [>R@"[<5 URBUlSSS5 O$S[GUR5<3n[U5eURceUR"(a%URRIUR"5 URJS:aURR75nURRIUR"[RL5 URR75Ul%URRIU5 gg![8a S n[U5Sef=f![<a^ [RRURR5uUl Ul GN![<a SUl GNf=ff=f!,(df  GNu=f![8a^ [>R@"[85 URRE5 SSS5 O!,(df  O=fSn[U5Sef=f![<a SUl GNPf=f!,(df  GN =f)zOpen or re-open file.NrKb>rEwbxbrDz invalid mode )encodingTrFr r\z is not open in binary modezbinary stream is not seekablezUnnamed binary streamrDzOpenFile is not seekablezLthe first parameter must be a file name or seekable binary file object, not )'r#rr rr9 r rzrWrrErealpathrr r rDr rkrursplitextrr} TextIOBaserr_r\r{rXrrrrrrrrwr\r rd)rkrrrar rms rvrDFileHandle.open1s 88   djj"++ . .4::.DJ djj# & &zz"##% c! zz!::%djj\2 o%))$**5DJ$&GGMM$**$= !DItz DJJDHDKq$,,/DL  J / /zz~~DHq$,,/DL LLDJJ.. .LDK::<< " 0 01A1A BID$(64<<.!>DJ!%!1!1DJ))DJ DI TZZ ( ($**bmm44&ABn$BuItzz2DH 0  ||a#xx}} DK::=,.GGMM$((--,H)DItz $$^4!XX]] 54 TZZ ( (EBuIuzz|4DH 0 ||a#xx}} DK::9,.GGMM%**,E)DItz$$^4"ZZ 54 DJJ'*,  S/ !xx### << HHMM$,, ' ::>((--/C HHMM$,, 4DJ HHMM#  k 05 o4/ 0&==02 dhhmm0L- 4:)=%< == 54 0((3HHNN$4330 o4/  0&9!8DJ944s Y,AY+[?[(!6]1]+Y(+ [6AZ99[ [[[ [%($] \0' ]0 \> :]]('](+ ]:cUR(aSURbE[R"[5 URR 5 SSS5 SUlggg!,(df  N=f)zClose file handle.N)r r#rrrrrs rvrFileHandle.close2sH ;;488/$$Y/ 0DH0;//s A&& A4cURceURR5$![[4a)n[ UR5S3n[U5UeSnAff=f)z@Return underlying file descriptor if exists, else raise OSError.Nz does not have a file descriptor)r#r}r]rrw)rkrrs rvr}FileHandle.fileno2s_xx### (88??$ $( ($((^$$DEC#,C ' (s+A$$AA$cURce[URS5(aURR5$g)z'Return True if stream supports writing.writableF)r#rr rs rvr FileHandle.writable'2s9xx### 488Z ( (88$$& &rucg)z-Return True if stream supports random access.Trtrs rvseekableFileHandle.seekable.2srucnURceURR5UR- $)zReturn file's current position.)r#rXrurs rvrXFileHandle.tell22s+xx###xx}}--rucURceUR(aUS:Xa6URRURU-U5UR- $US:XaSURS:aCURRURUR-U-S5UR- $URRX5$)aRSet file's current position. Parameters: offset: Position of file handle relative to position indicated by ``whence``. whence: Relative position of ``offset``. 0 (``os.SEEK_SET``) beginning of file (default). 1 (``os.SEEK_CUR``) current position. 2 (``os.SEEK_END``) end of file. rrT)r#rur\r )rkrwhences rvr\FileHandle.seek72sxx### <<{HHMM$,,"7@4<<O{tzzA~HHMM$,,";f"DaHll#xx}}V,,rucUS:aUR(a URnURceURRU5$)zReturn bytes read from file. Parameters: size: Number of bytes to read from file. By default, read until the end of the file. r)rur r#rrkrs rvrFileHandle.readR2s= !8 ::Dxx###xx}}T""rucVURceURRU5$)zqRead bytes from file into buffer and return number of bytes read. Parameters: buffer: Buffer to read into. )r#readintorkbuffers rvr FileHandle.readinto`2s)xx###xx  ((rucVURceURRU5$)zjWrite bytes to file and return number of bytes written. Parameters: buffer: Bytes to write to file. )r#rr s rvrFileHandle.writej2s'xx###xx~~f%%rucURce[URS5(aURR5 gg)z,Flush write buffers of stream if applicable.Nr)r#rrrs rvrFileHandle.flusht2s6xx### 488W % % HHNN  &rurWr)rorderc UR(d Sn[U5eURce[R"URUUUR U-UUS9$)ahReturn ``numpy.memmap`` of array data stored in file. Parameters: dtype: Data type of array in file. shape: Shape of array in file. offset: Start position of array-data in file. mode: File is opened in this mode. The default is read-only. order: Order of ndarray memory layout. The default is 'C'. z%cannot memory-map file without fileno)rrrrr )rDrr#rr:ru)rkrrrrr rs rvrFileHandle.memmap_arrayz2sZ0||9CS/ !xx###|| HH<<&(   rurc@[R"U5nUS:a*Uc URO URnXQR-nOX!R-nUc[R "X!5OUnURU:wa Sn[ U5eURceU(a(URRURU-5 URRU5nX:waSUSU3n[ U5eURR (dLUR (dUR#S5 UR%URR'55nO5URR UR :waUR#S5 Ub![)US5(aUR+5 U$![aR [R"URRU5U5RUR5USS&UnGN5f=f)aEReturn NumPy array from file in native byte order. Parameters: dtype: Data type of array to read. count: Number of items to read. By default, all items are read. offset: Start position of array-data in file. out: NumPy array to read into. By default, a new array is created. rNz size mismatchzfailed to read bytes, got Tr)rrr rrrBrr#r\rur rrrrtrisnativebyteswaprr rr) rkrrrrrrrrs rvrFileHandle.read_array2s* E" 19#&;TZZCJJFnn,E^^+F.1kU*s ==F "!CS/ !xx###  HHMM$,,/ 0 !!&)A ;#F8<s;CS/ !||$$>>%[[!:!:!<=F \\ " "enn 4 OOD ! ?wsG44 IIK ) ((v)>FNN F1IA  s GAHHrcXURce[R"U5nUbURU5n[RR URX5nUS:XaUS$U$![ [R4a UcURUR-n[U[[45(a[U5UR-nOX!R-nURRU5n[RR!UUU5nNf=f)zReturn NumPy record from file. Parameters: dtype: Data type of record array to read. shape: Shape of record array to read. byteorder: Byte order of record array to read. rYr)r#rrr recrr]r}UnsupportedOperationr rrr~rMr@r fromstring)rkrrrrecordrrs rv read_recordFileHandle.read_record2s$xx### E"  &&y1E YY''%?F("QJvay2F2'001 } enn4%%//u~6~~- 88==&DYY))F s*A22B4D)(D)cUS:agURceURRUS- [R5 URR S5 U$)zAppend null-bytes to file. The file position must be at the end of the file. Parameters: size: Number of null-bytes to write to file. rYrr+)r#r\rrrr s rvr@FileHandle.write_empty3sM !8xx###  dQh , w rucxURceURR5n[R"X5nUR UR5 URR5U- $![ R a, URRUR55 N\f=f)zaWrite NumPy array to file in C contiguous order. Parameters: data: Array to write to file. ) r#rXrrtofiler}r rr)rkrrrms rvrAFileHandle.write_array3sxx###hhmmo&&t3 + KK !xx}}$$&& + HHNN4<<> * +sA99=B98B9T)rr*rrc #^# URceUc [U5nUS:agUS:Xa~USS:aVUSS:aMUc URnU URUS5 URR US5n SSS5 OSn TcSOTSn U(aW U 4OW U 4/v gUc URnUc[ R nTc[[U55m[[U[U5[U555V s/sHn TU XX+4PM n n [U 5U:aV[5RSUS[U 535 U RU4Sj[[U 5U555 U(a [U SS9n S n [US- 5H5n XupnXS-SnUS:Xd US:XdUS:XaM(UU-U:wdM3S n O URnURRnU (aSn X:aU nS nSnUU::a8X:a3XunnnUS:aUS:a US:aUnUU- nU S- n UU::aX:aM3US:aSn OU U"U5 U"U5n SSS5 SnSn/nUU :aRU UupnUS:a$US:aUU- nURW UUU 45 UnOURSU 45 US- nUU :aMRU(a UShvN OUv X:aMgSn X:a/nSnU UU::adX:a_XupnUS:a-US:a'U"U5 URU"U5U 45 UU- nOURSU 45 U S- n UU::aX:aM_SSS5 U(a UShvN OUv X:aMgg!,(df  GN=fs sn f!,(df  GNA=fN!,(df  NX=fNN7f) aReturn iterator over segments read from file and their indices. The purpose of this function is to - reduce small or random reads. - reduce acquiring reentrant locks. - synchronize seeks and reads. - limit size of segments read into memory at once. (ThreadPoolExecutor.map is not collecting iterables lazily). Parameters: offsets: Offsets of segments to read from file. bytecounts: Byte counts of segments to read from file. indices: Indices of segments in image. The default is ``range(length)``. length: Number of segments to read from file. By default, ``len(offsets)``. sort: Read segments from file in order of their offsets. lock: Reentrant lock to synchronize seeks and reads. buffersize: Approximate number of bytes to read from file in one pass. The default is :py:attr:`_TIFF.BUFFERSIZE`. flat: Return iterator over individual (segment, index) tuples. If ``False``, return an iterator over a list of (segment, index) tuples that are acquired in one pass. Yields: Individual or lists of ``(segment, index)`` tuples. NrYrz!tifffile.read_segments: expected z segments, got c34># UH nTUSS4v M g7fr0rt)rrrs rvr+FileHandle.read_segments..3s ,HqQ",Hrc US$r*rtrs rvr*FileHandle.read_segments..3sadrur TFrK)r#rr r\rr BUFFERSIZEr~rrr7rmrrur)rkrrrrYrr*rrrrrr-iscontigrrr nextoffsetr\rr2rr rrrrs ` rvr7FileHandle.read_segments53slxx### >\F A:  Q;!}q WQZ!^<::DIIgaj)88==A7DT AgajE#'4-tUm_ <  <::D  J ?E&M*G 3vs7|S_EF FQZZ] 3F   x=6 ! H  "8?3x=/C  OO,1#h-,H  hN;Hvz"A#+; Ay!a%+J{i1n a !Z/ #yyxx}} A* :-!*&kGAq!1uQ!A:%&F!Q FA  :-!*A:DV #I!e/7{,E9zi!m ) tE$'7&?@ $ tUm4FA!e%%% LC*D  jFDj(QZ/7{,E9zi!mV  tI&>? ) tUm4FAj(QZ!!! 'jqT$ ` &"sAO3NB ON,%B8O!A8O O&N17A$O O)O*O:OA)O3OOOO N)$ O1 O; O OOcU$ryrtrs rvrFileHandle.__enter__3rruc$UR5 gryr r!s rvr%FileHandle.__exit__3r'ruc8S[URS5<S3$)Nz&ACCrucSRSURURURS3URcS45$S45$)Nrg rz bytesrrD)rr r r r#rs rvrFileHandle.__str__3sWzz  ::,f% HH,    39    rucUR$)zName of file or stream.)r rs rvrFileHandle.name4r rucUR$)z"Directory in which file is stored.)r rs rvrGFileHandle.dirname 4r rucj[RRURUR5$)zAbsolute path of file.)rrErr r rs rvrEFileHandle.path4s!ww||DIItzz22ruc[RRURR 55upU(aUR S5(aSU-nU$)z&File name extension of file or stream.z.ome)rrEr r rrZ)rkrras rvrBFileHandle.extension4sFGG$$TZZ%5%5%78  4==((3,C rucUR$)zSize of file in bytes.)r rs rvrFileHandle.size4r rucURSL$)zFile is closed.Nrrs rvrFileHandle.closed"4sxx4rucUR$)z/Reentrant lock to synchronize reads and writes.)r rs rvr*FileHandle.lock'4r ruc&URU5 gry)set_lockrs rvr*r ,4s eruc[U5[UR[5:Xa,U(a[R "5O [5Ulgg)z3Set reentrant lock to synchronize reads and writes.N)rrr r threadingRLock)rkr*s rvr FileHandle.set_lock04s2 :DJJ < <.2* DJ =ruc@[UR[5(+$)z9File uses reentrant lock to synchronize reads and writes.)rr rrs rvhas_lockFileHandle.has_lock54sdjj+666rucfURR5 g![[4a gf=f)z)File has fileno and can be memory-mapped.FT)r#r}r]rrs rvrDFileHandle.is_file:4s3  HHOO (  s 00ry) rz', '=', '|'] | Noner6numpy.recarray[Any, Any])rrr6r)rrrr3r6rr)rr2rYr3rrErrErrr*rrr3rrr6zMIterator[tuple[bytes | None, int]] | Iterator[list[tuple[bytes | None, int]]]rFrGrK)r6r r)r*rr6r)*rrrrrrGrLrnrDrr}r r rXr\rr rrrrr r@rAr7rr%r+rrMrrGrErBrrr*rr r rDr rtrurvrr]1sbD I BA  J J I L J L ((  $ !$ I $=$$$$ $0fP(. -6 #)& # # # #  #  # #  # P > $( >>> > ! > >F/0-3 >B -3-3,-3 ; -3 " -3^&#'%% % %8)-! j59!%j & j  jj"jj3jjj 3jX,((   (D  33   [[F 77rurc\rSrSr%SrSrS\S'S\S'S\S 'S \S 'S \S 'SSS.SSjjjrSSjrSSjr SSjr SSSjjr SSSjjr SSjr S SjrS!SjrSrg)"riD4zKeep FileHandles open. Parameters: size: Maximum number of files to keep open. The default is 8. lock: Reentrant lock to synchronize reads and writes. )rr r*pastrrrzdict[FileHandle, int]rzset[FileHandle]r zlist[FileHandle]r r r*N)r*c/Ul0Ul[5UlUcSO [ U5UlUc[ 5UlgUUlg)NrP)r rr!r rrrr*)rkrr*s rvrnFileCache.__init___4s?   E A3t9 %)\KM t rucUR XR;aURU==S- ss'OUR(a;UR5 SURU'URR U5 OESURU'UR RU5 URR U5 SSS5 g!,(df  g=f)z Open file, re-open if necessary.rYrTN)r*rrrDr rr r$rkrls rvrDFileCache.openk4s YYZZ 2!# !" 2   $!" 2 b!   $YYs B9C CcUR XR;aURU==S-ss'UR5 SSS5 g!,(df  g=f)z8Decrement reference count of file handle and trim cache.rYN)r*r_trimr s rvrFileCache.closey4s8 YYZZ 2!# JJLYYs 7A  AcUR URVs/sHoUR;dMUPM snH nUR5 URU M" URVs/sHoUR;dMUPM snUlU=RURR 5-slSSS5 gs snfs snf!,(df  g=f)z'Close all file handles opened by cache.N)r*rr rr r* r s rvclearFileCache.clear4s YY$(JJFJbDII2ErJF JJrNG'+iiDi3CiDDI II* *I YFE Ys2CC C 5C.CC 5C C C!cUR XR;nU(avUR(a UR5 SURU'O*SURU'URR U5 UR RU5 URX$5 URU5nU(aUR5 SSS5 U$!,(df  W$=f)aReturn bytes read from binary file. Parameters: fh: File handle to read from. offset: Position in file to start reading from relative to the position indicated by ``whence``. bytecount: Number of bytes to read. whence: Relative position of offset. 0 (``os.SEEK_SET``) beginning of file (default). 1 (``os.SEEK_CUR``) current position. 2 (``os.SEEK_END``) end of file. rrYN) r*rrrDr r$r rr\rr )rkrlrrr transientrs rvrFileCache.read4s>YY**,I99GGI%&DJJrN%&DJJrNIIMM"%   $ GGF #779%D  Y CC C+cUR XR;nU(avUR(a UR5 SURU'O*SURU'URR U5 UR RU5 URX$5 URU5nU(aUR5 SSS5 U$!,(df  W$=f)aWrite bytes to binary file and return number of bytes written. Parameters: fh: File handle to write to. offset: Position in file to start writing from relative to the position indicated by ``whence``. data: Bytes to write. whence: Relative position of offset. 0 (``os.SEEK_SET``) beginning of file (default). 1 (``os.SEEK_CUR``) current position. 2 (``os.SEEK_END``) end of file. rrYN) r*rrrDr r$r rr\rr )rkrlrrr r writtens rvrFileCache.write4s2YY**,I99GGI%&DJJrN%&DJJrNIIMM"%   $ GGF #hhtnG Yr cfSn[UR5nXs=:aUR:aO gURUnX0R;aCURUS::a0UR 5 URU URU US-nOUS- nXs=:aUR:aM~g gg)zTrim file cache.rrYN)rr rr rr)rkrrrls rvr FileCache._trim4s499~&TYY&5!B"tzz"~': JJrNIIe$  &TYY&&ruc,[UR5$)z&Return number of tracked file handles.)rrrs rvrFileCache.__len__4s4::ruc"S[U5SS3$)Nz LLDJJ '  1 $ LLD11 2  1 $ LL,, - ;;? LLDKK (U|ructURS:=(a URS:=(a URS:=(aw URS:=(aa URS:H=(d UR S:H=(a5 UR S:a UR O URUR :$)zShape is valid.rY)rrrZrYrXr[rWrrs rvr`StoredShape.is_valid5s KK1   a  q   a &&!+Gt/B/Ba/G &&*##**  ruc URS:$)zShape contains planar samples.rY)r[rs rv is_planarStoredShape.is_planar5s$$q((rucHURS:agURS:agg)z!Value of PlanarConfiguration tag.rYrTNr0 rs rvrStoredShape.planarconfig5s)  1 $    "rucg)Nrrtrs rvrStoredShape.__len__5srucgryrtrs rvrStoredShape.__getitem__5rz rucgryrtrs rvrrH 5ri ruc URU$ryrrs rvrrH 5szz#ruc,[UR5$ry)r#rrs rvr7StoredShape.__hash__5sDJJrucb[U[5=(a URUR:H$ry)rrrr2s rvr4StoredShape.__eq__5s!%-K$** 2KKrucSURSURSURSURSURSUR SUR S3$) Nz)rrr[rZrYrXrWrrs rvr+StoredShape.__repr__5sz kk]# $ 5 567ZZL!kk]#ZZL!"1123 --.   ruN)rYrYrYrYrYrYr)rrrr[rrZrrYrrXrrWrrrr6rrK)r6z#tuple[int, int, int, int, int, int]rmrrr)rrr6r)rrr6rM)rrq r6zint | tuple[int, ...]rIrK)rrrrrrGrLrnrMrr\r3 rr|r_rr`rA rrbrrarr7r4r+r rtrurvrr4s(I K% J4 K: J/'B !... .  .  ... .,      00            ))22 @@  L  rurcz\rSrSrSrSrS SjrS SjrS SSjjrSSjr SSjr SS jr Sr g )ri5zNull context manager and dummy reentrant lock. Can replace :py:class:`threading.RLock` where no synchronization is needed. Implements both the context manager and lock interfaces. >>> with NullContext(): ... pass ... rtcU$ryrtrs rvrNullContext.__enter__5rrucg)NFrtr!s rvr%NullContext.__exit__5s rucg)z)Acquire lock immediately and return True.Trt)rkblockingtimeouts rvacquireNullContext.acquire5s rucg)zRelease lock (no-op).Nrtrs rvreleaseNullContext.release5srucg)z!Return False; lock is never held.Frtrs rvlockedNullContext.locked5srucg)Nz NullContext()rtrs rvr+NullContext.__repr__5sruNrF)r"rHr#rIr$rJr6zLiteral[False])TrK)rW rrX rYr6rrBrrK) rrrrrrGrr%rY r\ r_ r+r rtrurvrr5sv I,((     $rurc\rSrSr%SrSrS\S'S\S'S\S'SS SS .SS jjjrSS S .SS jjjrSS S .SSjjjr SSS .SSjjjr \ SSj5r SSjr SSjrSSjrSSjrSrg)r)i5ajStopwatch for timing execution speed. Parameters: message: Message to print. end: End of print statement. started: Value of performance counter when started. The default is the current performance counter. Examples: >>> import time >>> with Timer('sleep:'): ... time.sleep(1.05) sleep: 1.0... s )durationstartedstoppedrYre rf rd Nr)endre cxUb [XSS9 SUlUc[R"5nU=UlUlg)NTrg rprintrd time perf_counterre rf )rkmessagerg re s rvrnTimer.__init__6s<   '$ / ?'')G&-- t|rurg cUb [XSS9 SUl[R"5=UlUlUR$)z$Start timer and return current time.Tri rj rk rkro rg s rvr Timer.start(6s:   '$ / &*&7&7&99 t|||ruc[R"5UlUb [XSS9 URUR- UlUR $)ztReturn duration of timer since start. Parameters: message: Message to print. end: End of print statement. Tri )rm rn rf rl re rd rs s rvr Timer.stop06sB((*   '$ / t||3 }}rucH[U5nUb [USS9 [X2SS9 g)zPrint duration from timer start till last stop or now. Parameters: message: Message to print. end: End of print statement. Nrrq Tri )rzrl )rkro rg rs rvrl Timer.print>6s'$i   's # c$'ruc,[R"5$)z$Return value of performance counter.)rm rn rtrurvclock Timer.clockM6s  ""rucLURS::a#[R"5UR- nO URn[ [ US95nSnU[ U5:a,X#US-S;a!US- nU[ U5:a X#US-S;aM!X#US-S:XaUS- nX#SS 3$) z7Return duration from timer start till last stop or now.rj )secondsrrTz0:0010203040506070809rYrNz s)rd rm rn re rz TimeDeltar)rkrd rrs rvr Timer.__str__R6s ==C ((*T\\9H}}H  (+ , #a&jQ1q5\-DD FA#a&jQ1q5\-DD Q<3  FAB%|ruc"SURS3$)NzTimer(started=rz)re rs rvr+Timer.__repr__a6s ~Q//rucU$ryrtrs rvrTimer.__enter__d6rruc$UR5 gry)rl r!s rvr%Timer.__exit__g6r'rury)ro rQrg rzre rr6r)ro rQrg rzr6rY)ro rQrg rQr6r)r6rYrKrFrG)rrrrrrGrLrnrrrl rNrz rr+rr%r rtrurvr)r)5s&3I N4 N4OB# . $ . . .  .  .c S  %) (?C (! (2< (  (## 0,((   rur)c\rSrSrSrSrg)rip6z;Exception to indicate invalid OME-XML or unsupported cases.rtNrrtrurvrrp6sErurcp\rSrSr%SrSrS\S'S\S'S\S'S\S'S\S 'S \S 'S \S '/rS\S'S)SjrSS.S*Sjjr SS.S+Sjjr S,Sjr S,Sjr \ S-Sj5r\ S.S/Sjj5r\ S0Sj5r\ S1S2Sjj5r\ S3Sj5r\ S4Sj5rS5Sjr\ S6S j5r\ S7S!j5rS8S"jrS9S#jrS)S$jrS:S%jr\ S.S&S'.S;S(jjj5rSrg)>> omexml = OmeXml() >>> omexml.addimage( ... dtype='uint16', ... shape=(32, 256, 256), ... storedshape=(32, 1, 1, 256, 256, 1), ... axes='CYX', ... Name='First Image', ... PhysicalSizeX=2.0, ... MapAnnotation={'key': 'value'}, ... Dataset={'Name': 'FirstDataset'}, ... ) >>> xml = omexml.tostring() >>> xml '......' >>> OmeXml.validate(xml) True )_ifd_xmlrdatasets experimentersreprojectsr rerr r r rzr rr zClassVar[list[Any]]_schemac URSU5nSUl/Ul/Ul/Ul/Ul/UlSU;aUSRS5SnOSSKJ n [U"55n[RUSS[3S 9nS nS US US USUSUS3 UlURURS055 UR!URS055 g)NOMErUUIDrrK)uuid1Creatorz tifffile.py rz1http://www.openmicroscopy.org/Schemas/OME/2016-06z{declaration}{projects}{datasets}{experimenters}{images}{annotations} ExperimenterProject)rSr rerr r r ruuidr rzr _attributer*r _experimenter_project)rkrr r creatorschemas rvrnOmeXml.__init__6s<<x0     X F#))#.r2D "uwS?S@SASBSCSD5 nU S:dUS:aU S:aSEOSFn SGU SH3n OS+n UR;URSI05SJUSK35 UR=URSLU5U5 S+R-U5n!UR?URSM55n"URR+SNUSHUSOUU"USPUSQT#SRUSHUU USOUSSUR@STU SKUSUU!SV35 U=R@U - sl g![a SU<S3n [U 5Sef=f)WaAdd image to OME-XML. The OME model can handle up to 9 dimensional images for selected axes orders. Refer to the OME-XML specification for details. Non-TZCYXS (modulo) dimensions must be after a TZC dimension or require an unused TZC dimension. Parameters: dtype: Data type of image array. shape: Shape of image array. storedshape: Normalized shape describing how image array is stored in TIFF file as (pages, separate_samples, depth, length, width, contig_samples). axes: Character codes for dimensions in ``shape``. By default, ``axes`` is determined from the DimensionOrder metadata attribute or matched to the ``shape`` in reverse order of TZC(S)YX(S) based on ``storedshape``. The following codes are supported: 'S' sample, 'X' width, 'Y' length, 'Z' depth, 'C' channel, 'T' time, 'A' angle, 'P' phase, 'R' tile, 'H' lifetime, 'E' lambda, 'Q' other. **metadata: Additional OME-XML attributes or elements to be stored. Image/Pixels: Name, Description, DimensionOrder, TypeDescription, PhysicalSizeX, PhysicalSizeXUnit, PhysicalSizeY, PhysicalSizeYUnit, PhysicalSizeZ, PhysicalSizeZUnit, TimeIncrement, TimeIncrementUnit, StructuredAnnotations, BooleanAnnotation, DoubleAnnotation, LongAnnotation, CommentAnnotation, MapAnnotation, Dataset, Experimenter Per Plane: DeltaT, DeltaTUnit, ExposureTime, ExposureTimeUnit, PositionX, PositionXUnit, PositionY, PositionYUnit, PositionZ, PositionZUnit. Per Channel: Name, AcquisitionMode, Color, ContrastMethod, EmissionWavelength, EmissionWavelengthUnit, ExcitationWavelength, ExcitationWavelengthUnit, Fluor, IlluminationType, NDFilter, PinholeSize, PinholeSizeUnit, PockelCellSetting. Raises: OmeXmlError: Image format not supported. r ImagePixelsrNIDint8int16int32rPruint32rYdoublecomplexzdouble-complexbit) r r r rPrr rfloat64 complex64 complex128rz data type r^Typezmetadata Pixels Type z does not match array dtype rYzImageDepth not supportedzinvalid stored shapec38# UHn[U5v M g7fryrrs rvr"OmeXml.addimage..[7s,ec!fferzempty arrays not supportedrSrrKDimensionOrderXYCZTXYZCTXYZTCXYCTZXYTCZXYTZCzdimension order z not supported (dim_search=rzrr=c38# UHupSUSUS3v M g7f)z Size="r Nrt)rrrs rvrr 7s( @B4r$q !@rTr4c3\># UH!nTTRU5S:dMUv M# g7frrd)rrdimorderdimsizess rvrr 7s+"(rHX^^B5G,H1,L[s, ,z'metadata DimensionOrder does not match Sizez metadata Sizez does not match rT!shape does not match stored shapePlaneChannelAcquisitionDate DescriptionNamerSignificantBits PhysicalSizeXPhysicalSizeXUnit PhysicalSizeYPhysicalSizeYUnit PhysicalSizeZPhysicalSizeZUnit TimeIncrementTimeIncrementUnitfalsetruez Interleaved="r DatasetzStructuredAnnotationsr zWU^q0.Cc" " UH g $;AC 3CABF+DJJsO,F#'<< E_$   &dd+ LL)7 3       HX% %TH,HZMKCc" "BSy,.$J5B(ADSyV|r 1 % OOD ! (4@   x '"#34K''"("K,?xH!#&&Hht   6U5'? K''              a<6A:%-\'vK*;-q9KK LLB '+?wc)J   LL0( ;_ 0 ,,X\\.-IJ wavQm!%)'j)G1gml!jdii[zl#h o   $ Z m -ui~6Cc" , -s 1TT6Frc ~SRUR5nSRUR5nSRUR5nSRUR5nSRUR 5nU(aSUS3nU(aSnOSnUR RUUUUUUS9$)zOReturn OME-XML string. Parameters: declaration: Include XML declaration. r=zzz&)rr r r rer)rr r r rerr r )rkrr r r rerdeclaration_strs rvrOmeXml.tostring7s774==)774==) 2 23 %ggd../ )+6NO  FO Oyy''#    ruc"S[U5SS3$)Nz rDrTrUN) rlxmlr XMLParserr r ImportErrorrrhrirrrj)rkxmlr parsertreers rvrOmeXml.__str__8smmo  "__t_# UHn[RTU5v M g7fry)rr rrrs rvr#OmeXml._elements...8sFFOOHd33#&c36# UHo(dM Uv M g7fryrt)rrs rvrr /8s0(Qaqq(  r# )rrelementss` rv _elementsOmeXml._elements)8s*FFww0(000rucHURX5nUcgUbK[U[[45(aXBnO*US:a$[ U5R <S3n[U5eSUS[RU5S3$![anSU<3n[ U5UeSnAff=f) z3Return XML formatted attribute if name in metadata.Nr=z&list index out of range for attribute rz is not a list or tuplerr r ) rSrrMr~r4rwrrrr )rrrrrOrrs rvr OmeXml._attribute18s T+ =  %$//3!LEe--00GHn$4&6>>%0133 "3B4(KC$S/s23sB B! BB!c^^T(dgTc U4SjU5nOQ[T[[45(aTTmU4SjU5nO$[T[5(aUU4SjU5nOgSR SU55$)z Return XML formatted attributes.r=c3P># UHn[RTU5v M g7fryrr r s rvr%OmeXml._attributes..T8!N&++Hd;;r c3P># UHn[RTU5v M g7fryr r s rvrr W8r r c3R># UHn[RTUT5v M g7fryr )rrrH rs rvrr Y8s&FKd!!(D&99e$'c36# UHo(dM Uv M g7fryrt)ras rvrr ^8s2*Qqq*r )rrMr~rr)rrH rrs`` rvr OmeXml._attributesI8su >NNJ 4- 0 0'HNNJ $ ' 'FKJww2*222rucUupEpgp[U5n Sn UcU S:wd USSXxS4:XaSnU n OUS:wdU S:XaUSSSXx4:XaSnUn OSn[U5U s=::aSU;aSOS ::dO U S 3n [U 5eURS S 5SSS 2n U SU;aSOS U - SU-n[U5U :wa'S[U5<S[U5<3n [U 5eGOUR 5n[U5U :wa Sn [U 5eUR S5(d)UR S5(aSU;d Sn [U 5e/nUHCnUS;aSU<S3n [U 5eX;aSU<S3n [U 5eUR U5 ME U SU;aSOS:a Sn [U 5eU S:wazU n U S:a Sn [U 5eUS S:Xa&SU;a Sn [U 5eURSS5nOUS S:wa S n [U 5eUS U :wd US!U:wa S"n [U 5eOUS:wayUn U S:a Sn [U 5eUSS:Xa&SU;a Sn [U 5eURSS5nOUSS:wa S n [U 5eUSU:wd US U:wa S"n [U 5eXRS#5U:wdXRS$5U:wa S"n [U 5eX+4$)%zReturn resolved axes string and samples count. Raises: OmeXmlError: Axes are not supported. ValueError: Axes do not match shape or stored shape. rYNrrtrrvrxrSrz dimensions not supportedr r rK len(axes)= != len(shape)=zaxes do not match shape)rxrtYXCz"dimensions must end with YX or YXS TZCYXSAPRHEQz dimension r^z multiple z dimensionsr;rPz$more than 8 dimensions not supportedrz$dimensions do not match stored shaperz invalid axeszaxes do not match stored shaperyr rr) rrrSrrNrZrrr)rr|rr _planecountr _depthrYrXr rr\r dim_prefixuniquers rvr OmeXml._axes`8sZ@K< vu5z <{eBCjVA,>> Q eBCjQ,>>"t9AcTkqA78!#&&&ll+;WEeqeLJC4KqQ$>@ADHD4yD #T $4U 6 o%! ::=C$S/) C !U *eJJsO.D.N5CS/ !}ruc[SU55(d0U4$0nSnSSSSSSS .nURS 05n[U5H{upU S ;alX;a S XS 3n OSn XS- U n U (aU S;a XzX)U 4X\'M<SH(n X;dM X;dMX;dMXzX)U 4X\'Xl- n Mh Sn [U 5eXj- nM} SR SUR 555nUR S[UR5S35 URR S[UR5SUS35 XV4$)zReturn modulo dict and non-modulo hiaxes string. Appends a modulo XMLAnnotation to self.annotations when modulo axes are present. Raises: OmeXmlError: More than 3 modulo dimensions. c3*# UH oS;v M g7f)APRHEQNrt)rrs rvr!OmeXml._modulo..8s3Fb>Frxr=anglephaserlifetimelambdar3)APRrQEQTypeDescriptionr% zTypeDescription="" rYTZCzmore than 3 modulo dimensionsc 3R# UHunup#nSUSUSUSUS- S3 v M g7f)z z!) r;rSrrrr`rrr)rkr rrr r r axestype axestypedescrrrr5 rr moduloalongs rvr OmeXml._modulo8s 3F333v: !#  ! %6; v&EAX~&"3M4E3Fb II "Iq51%e ( eh AFI#- ! !(0 eh (IFI$MH!#>)#..5':gg 28  ,S1A1A-B,C3 G  ,S1A1A-B,CDI m    rucT^^ U(dg[U4SjS55n/n[U5Hhn[RUUSSSSSS S S S S 5 n[R "XcSSSS9m U 4SjU5upn UR SUSU SU SUS3 5 Mj SRU5$)zReturn Plane XML elements.r=c3L># UHnTSSRU5v M g7frTNrd)rrr s rvr!OmeXml._planes..!9s%@%B!"++B//%s!$CZTDeltaT DeltaTUnit ExposureTimeExposureTimeUnit PositionX PositionXUnit PositionY PositionYUnit PositionZ PositionZUnitrTNF)r c3@># UHn[TU5v M g7fryr)rr unraveleds rvrr> 39s;(Qs9Q<(((rD z r AcquisitionModeColorContrastMethodEmissionWavelengthEmissionWavelengthUnitExcitationWavelengthExcitationWavelengthUnitFluorIlluminationTypeNDFilter PinholeSizePinholeSizeUnitPockelCellSettingr=zr r= Name="r r zz") rrMr~r rrr rSrr r rr)rkrr-rrrr r s rvr OmeXml._project9s  hu . . a  (D)) DMM"||FB' V^^D12!4Dll="5 { ;[ U[ [ 45(dU/nUGHnSn Sn [ U[5(aUR5nURSS5n U (aS [RU 5S 3n URS S5n U (aS [RU 5S 3n URSU5nUS:Xat[ U[5(d Sn [U 5eUR5V V s/sH4upS[RU 5S[RU 5S3PM6 nn n OyUS:Xa[U5R5/nOWUS:Xa[[!U55/nO;US:Xa[[#U55/nO[R[U55/nUR%S['UR(5S35 UR(R%SR+SUS['UR(5S U S3U SSR+U5SSUS3455 GM! GM gs sn n f) z8Add annotations to self.annotations and annotation_refs.> MapAnnotationLongAnnotationDoubleAnnotationBooleanAnnotationCommentAnnotation> TagAnnotationFileAnnotationListAnnotationTermAnnotationTimestampAnnotationz z is not supportedrrUr=r rg rh Namespacez Namespace="r Valuerw zMapAnnotation is not a dictzzrz rx ry r6 r rsz ID="Annotation:rrzzr N)r`rhrirjrrMr~rrdrrr rrrrzrrYrrrr)rkrr _supported _unsupportedrrannotation_valuesrO namespacerrrrrs rvr OmeXml._annotations9s  NN$D&* #D$# (0AB  %/$??%6$7!*  eT**!JJLE"'))M2">K"+%~~k:;,-$ !& +r :I &26>>)3L2MQ$O !IIgu5E?*%eT22;(o-%*KKM$1DA!!2 32fnnQ6G5HM$1F00!%e 4467F--!#e*o.F//!%,/0F$nnSZ89F&&4S9I9I5J4K3O  ''GGv&..1$2B2B.C-DA(k,(%GGFO& aL   G+#%Js;J T)assert_cSSKJn Ub\URS5(aURSS5SnUR UR UR 555nGOW[RnU(Gd,[RR[RR[5S5n[RRU5(a&[!US 5nUR#5nSSS5 O8SSKnUR&R)S 5nUR#5nSSS5 URS5(aURSS5SnUR+UR UR UR 5555 U(aUScgUSnURS 5(aURS S5SnUR U5n U(aUR-U 5 g [/UR1U 55$![a gf=f!,(df  GN =f!,(df  GN=f![a UR+S5 Nf=f)a=Return if OME-XML is valid according to XMLSchema. Parameters: omexml: OME-XML string to validate. omexsd: Content of OME-XSD schema to validate against. By default, the 2016-06 OME XMLSchema is downloaded on first run. assert\_: Raise AssertionError if validation fails. Returns: ``True`` if validation passed. ``False`` if validation failed and ``assert\_`` is ``False``. ``None`` if the XMLSchema could not be loaded. Raises: AssertionError: Validation failed and ``assert\_`` is ``True``. rr NrYrKzome.xsdrEz:https://www.openmicroscopy.org/Schemas/OME/2016-06/ome.xsd>+..k40B!#10*//6!#  $$X..#\\$226F)NN(8(8(IJ gaj0QZF   W % %\\#q)"-F'  NN4 FOOD)**Q  10 !)NN4()s;.H,/H<(I-=I , H98H9< I  I I>=I>)rrgr6r) rr3rrEr|1tuple[int, int, int, int, int, int] | StoredShaperrQrrgr6r)rrr6rzrK)rOrJr6rzry)rrrrzrrQr6rz)rrrrzr6rzr) rr3rrgrrrrzr6rz)rrrH r3rrzr6rz) rrMr|r rrQrrr6tuple[str, int]) r rzrrMrrr r r6ztuple[dict[str, Any], str]) rN rgrhrr rzr r>r6rz) ra rgr rr\rrrr6rz)rr*ri rzr6r)rrgr6rz)rrr r r6r)r r9rrzr rr6r%)rrrrrrGrLr rnr>rr+rrNr r r r r rr r r r r r r rr rtrurvrrt6s*'RI !&#(# I I#%G %)3b w w w G w  w w  w r/4 :7*,,CG; ;(+;6@; ;;11 ! 4 4  4 44 44.3 33 3 33,ddFdd! d  ddLN N N ! N # N $ N ` # # # # # # #D,%,%,%,% ,% ,%,%\+ Z"?H :T&T9BT Tl $M+  M+M+M+  M+  M+M+rurc\rSrSr%SrS\S'S\S'SSjr\SSj5r\SS j5r \SS j5r \SS j5r S r g )CompressionCodeci~:zMap :py:class:`COMPRESSION` value to encode or decode function. Parameters: encode: Return encode functions if ``True``, else decode functions. dict[int, Callable[..., Any]]_codecsr_encodec>S[0Ul[U5Ulgr* identityfuncr rr rkrgs rvrnCompressionCodec.__init__:<( F| rucXXR;aURU$U=S:Xa* UR(a[e[RnGO=S:Xa* UR(a[e[R nGO=S:Xa* UR(a[e[R nGO=S:Xa6 UR(a[RnGO[RnGO==S:XaO=S:XaO =S:XaO OC UR(aUS;a[e[RnGO7[RnGO%==S :XaO=S :XaO =S :XaO GO [[S 5(aT[RR(a5UR(a[RnGO[RnGO[[S 5(aT[R R(a5UR(a[R"nGOJ[R$nGO8SSKJn UR(aUR"nGOUR$nGO=S:Xa6 UR(a[R,nGO[R.nGO==S:XaO=S:XaO=S:XaO =S:XaO O7 UR(a[R0nGO[R2nGOr=S:Xa6 UR(a[R4nGOH[R6nGO6=S:Xa6 UR(a[R8nGO [R:nGO=S:Xa [[S5(aT[R<R(a5UR(a[R>nGO[R@nGOSSKJn UR(aUR>nGOdUR@nGOV=S:Xa6 UR(a[RBnGO,[RDnGO==S:XaO =S:XaO O7 UR(a[RFnGO[RHnGO=S:Xa6 UR(a[RJnGO[RLnGO==S:XaO =S :XaO O [[S!5(aT[RNR(a5UR(a[RPnGO,[RRnGOSSKJn UR(a URPnOURRnO==S":XaO =S#:XaO O5 UR(a[RTnO[RVnO==S$:XaO=S%:XaO =S&:XaO O* UR(a[e[RXnO`=S':XaO =S(:XaO O4 UR(a[RZnO-[R\nO[_U5<S)3n[cU5eX RU'U$![*a SSKnGNRf=f![*a SSKnGNf=f![*a SSKnGN^f=f![`a US*3nNkf=f![d[*4a n[_U5<S+3n[cU5UeSnAf[a n[_U5<S,3n[cU5UeSnAff=f)-zReturn encode or decode function for COMPRESSION value. Raises: KeyError: COMPRESSION value is not supported or requires missing 'imagecodecs' package. rTrrrrrr>rrrPrrDEFLATErrYrZrNrrrrrrrrLZMArrrrrnZSTDrorrjrkrrr^z is not a known COMPRESSION# requires the 'imagecodecs' package not implemented)3r r rr(r'rr( lzw_encode lzw_decode jpeg_encoderrr availabledeflate_encodedeflate_decoder zlib_encode zlib_decoder=r[r packbits_encodepackbits_decode jpeg2k_encode jpeg2k_decode lerc_encode lerc_decode jpeg8_encode jpeg8_decoder lzma_encode lzma_decode png_encode png_decode jpegxr_encode jpegxr_decode jetraw_encode jetraw_decoder zstd_encode zstd_decode webp_encoderr jpegxl_encode jpegxl_decoderrrr)rkrcodecr[rrs rvrCompressionCodec.__getitem__:s ,, <<$ $T )||11'77E||11'88E||11'88E|| + 6 6 + 6 6"QU]||*,"55 + 7 7 + 7 7&Q& Y77'//99<<$/$>$>E$/$>$>E V44',,66<<$/$;$;E$/$;$;E06 <<$0$<$S[0Ul[U5Ulgr*r r s rvrnPredictorCodec.__init__P;r ruc2XR;aURU$U=S:Xa4 UR(a[RnO[RnO=S:Xa4 UR(a[R nO[R nO=S:Xa UR(aSSjnOSSjnO{=S:Xa UR(aSSjnO]SS jnOW=S :Xa UR(aSS jnO9SS jnO3S :XaUR(aSSjnOSSjnOUS3n[U5eX RU'U$![a n[U5<S3n[U5UeSnAf[a n[U5<S3n[U5UeSnAff=f)zReturn encode or decode function for PREDICTOR value. Raises: KeyError: PREDICTOR value is not supported or requires missing 'imagecodecs' package. rTrrNc.[R"XUSS9$NrTr rdistr( delta_encoderr rs rvr )PredictorCodec.__getitem__..codeco;#.#;#; $Sq$ruc.[R"XUSS9$r r( delta_decoder s rvr r v;r rurc.[R"XUSS9$Nrr r r s rvr r ~;r ruc.[R"XUSS9$r r r s rvr r ;r rurc.[R"XUSS9$r r(floatpred_encoder s rvr r ;#.#?#? $Sq$ruc.[R"XUSS9$r r(floatpred_decoder s rvr r ;r rurc.[R"XUSS9$r r r s rvr r ;r ruc.[R"XUSS9$r r r s rvr r ;r ruz is not a known PREDICTORr r )rKN) r r r(r r r r rrrr)rkrr rrs rvrPredictorCodec.__getitem__T;sB ,, <<$ $P )|| + 8 8 + 8 8|| + < < + < <|| || || ||  E!:;C"3-'" S  )s^&&IJC3-S (" )s^&&67C3-S ( )sk)E E(EEE3E9EEE;EEE#E FE)) F6FFc.X g![a gf=fr r rs rvrF PredictorCodec.__contains__;r r c,[UR5$ryr rs rvrPredictorCodec.__iter__;r ruc,[UR5$ryr rs rvrPredictorCodec.__len__;r rur Nr r r r rKr rtrurvr r D;sl+* M$]]~""!!rur c\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrg)ri;zTIFF tag data types.rYrTrrrrrrPr;rr>rrrrrrrtN)rrrrrBYTEASCIISHORTLONGRATIONALSBYTE UNDEFINEDSSHORTSLONG SRATIONALFLOATDOUBLEIFDUNICODECOMPLEXLONG8SLONG8IFD8r rtrurvrr;s D! EF E" D"HN EI/ F E IL E0 F0 C%G)G3 E, F* D/rurcD\rSrSrSrSrSrSrSrSr Sr Sr Sr S r S rS rS rS rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSr Sr!Sr"Sr#S r$S!r%S"r&S#r'S$r(S%r)S&r*S'r+S(r,S)r-S*r.S+r/S,r0S-r1S.r2S/r3S0r4S1r5S2r6S3r7S4r8S5r9S6r:S7r;S8r<S9r=S:r>S;r?SrBSBS?jrCS@rDgA)Cri;zDValues of Compression tag. Compression scheme used on image data. rYrTrrrrrrPr;rcgrriiiiiiri)iiiiiirirrrrieitiuiriiiiirrrr r rrrrrrrrrrjrkc US:$r*rtrs rvrCOMPRESSION.__bool__P< axrurtNr)ErrrrrrCCITTRLE CCITTFAX3CCITT_T4 CCITTFAX4CCITT_T6LZWrJPEG ADOBE_DEFLATEJBIG_BW JBIG_COLORJPEG_99IMPACJ KODAK_262 JPEGXR_NDPINEXTSONY_ARW PACKED_RAW SAMSUNG_SRWCCIRLEW SAMSUNG_SRW2PACKBITS THUNDERSCANIT8CTPADIT8LWIT8MPIT8BL PIXARFILMPIXARLOGr DCSAPERIO_JP2000_YCBCJPEG_2000_LOSSYAPERIO_JP2000_RGBALT_JPEGJBIGSGILOGSGILOG24LURADOCJPEG2000 NIKON_NEFJBIG2 MDI_BINARYMDI_PROGRESSIVE MDI_VECTORLERC JPEG_LOSSYr ZSTD_DEPRECATEDWEBP_DEPRECATEDPNGJPEGXRJETRAWr WEBPJPEGXLPIXTIFF JPEGXL_DNGEER_V0EER_V1EER_V2rr rtrurvrr;s D#HIHIH C E DMGJG FIK" DHJKGLH&KH E E EIHG C)O('H D FHGHI EJOJ D0J D,OO CA F/ F D D FGJ F F FrurcD\rSrSrSrSrSrSrSrSr Sr S r S S jr S r g )riT<ziValues of Predictor tag. A mathematical operator that is applied to the image data before compression. rYrTrrrrrc US:$r*rtrs rvrPREDICTOR.__bool__g<r rurtNr)rrrrrr HORIZONTAL FLOATINGPOINT HORIZONTALX2 HORIZONTALX4FLOATINGPOINTX2FLOATINGPOINTX4rr rtrurvrrT<s: D.J"M1LLOOrurcf\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrg)r ik<zIValues of PhotometricInterpretation tag. The color space of the image. rrYrTrrrrrPr;r#LMr/rtN)rrrrrrGrFrHrJr^ SEPARATEDrICIELABICCLABITULABr]LOGLLOGLUV LINEAR_RAW DEPTH_MAP SEMANTIC_MASKr rtrurvr r k<sn JAJA C1G9 DIG EJ F F F C D FJIMrur c@\rSrSrSrSrSrSrSrSr Sr S r S r g ) ri<zOValues of NewSubfileType tag. A general indication of the kind of the image. rrYrTrrPrr rtN) rrrrrr REDUCEDIMAGEPAGEr^MACROENHANCEDDNGr rtrurvrr<s> I-L? D3 D7 EJH. Crurc(\rSrSrSrSrSrSrSrSr g) r i<z%Values of deprecated SubfileType tag.rrYrTrrtN) rrrrrr IMAGErn ro r rtrurvr r <s/I EL Drur c"\rSrSrSrSrSrSrg)r i<zDValues of FillOrder tag. The logical order of bits within a byte. rYrTrtN)rrrrrMSB2LSBLSB2MSBr rtrurvr r <s GIG?rur c8\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) r i<z`Values of Orientation tag. The orientation of the image with respect to the rows and columns. rYrTrrrrrrPrtN)rrrrrTOPLEFTTOPRIGHTBOTRIGHTBOTLEFTLEFTTOPRIGHTTOPRIGHTBOTLEFTBOTr rtrurvr r <s1 GHHGGHHGrur c"\rSrSrSrSrSrSrg)r i<zXValues of PlanarConfiguration tag. Specifies how components of each pixel are stored. rYrTrtN)rrrrrrKrLr rtrurvr r <s FEHArur c@\rSrSrSrSrSrSrSrSr S Sjr S r g ) ri<zYValues of ResolutionUnit tag. The unit of measurement for XResolution and YResolution. rYrTrrrc US:$r*rtrs rvrRESUNIT.__bool__<r rurtNr) rrrrrrrn CENTIMETER MILLIMETER MICROMETERrr rtrurvrr<s6 D* DJJJrurc(\rSrSrSrSrSrSrSrg)ri<zMValues of ExtraSamples tag. Interpretation of extra components in a pixel. rrYrTrtN) rrrrr UNSPECIFIED ASSOCALPHA UNASSALPHAr rtrurvrr<s! KJ9J"rurc:\rSrSrSrSrSrSrSrSr Sr S r g ) ri<z?Values of SampleFormat tag. Data type of samples in a pixel. rYrTrrrrrtN) rrrrrrINTrVOID COMPLEXINT COMPLEXIEEEFPr rtrurvrr<s9 D C F DJM!rurc.\rSrSrSrSrSrSrSrSr g) ri=zEZarrStore chunk modes. Specifies how to chunk data in Zarr stores. rrYrTrrtN) rrrrrSTRILEPLANEro FILEr rtrurvrr=s) F! E D! D!rurc\rSrSr%Sr\SDSj5r\SDSj5r\SDSj5r\SDSj5r \SDSj5r \SESj5r \SFS j5r \SGS j5r \SGS j5r\SGS j5r\SHS j5r\SISj5r\SESj5r\SESj5r\SESj5r\SESj5r\SJSj5r\SHSj5r\SKSj5r\SLSj5r\SMSj5r\SMSj5r\SMSj5r\SMSj5r\SNSj5r\SOSj5r\SPSj5r \SPSj5r!\SQSj5r"\SRS j5r#\SSS!j5r$\SSS"j5r%\&SPS#j5r'\&STS$j5r(\&SUS%j5r)\&SUS&j5r*\&SVS'j5r+\&SHS(j5r,\&SPS)j5r-\&SHS*j5r.\&SHS+j5r/\&SHS,j5r0\&SHS-j5r1\&SHS.j5r2\S/5r3\S05r4\&S15r5\&STS2j5r6\&STS3j5r7\&STS4j5r8\&STS5j5r9\&SUS6j5r:\&SUS7j5r;\&SWS8j5r<\&SPS9j5r=\&SXS:j5r>\&SYS;j5r?\SZS=j5r@\SZS>j5rA\SZS?j5rBS@rCS<\DSA'SBrEgC)[ri7=z@Delay-loaded constants, accessible via :py:attr:`TIFF` instance.c &[SSSSSSSSS SS 9 $) z!32-bit little-endian TIFF format.rRrsrr rTIrT>Hr>HHz>I4sr r rs rvrc_TIFF.CLASSIC_BEJ=r ruc &[SSSSSSSSSSS9 $) z!64-bit little-endian TIFF format.rOrsrPrr r zQr r z>Q8sr r rs rvrb _TIFF.BIG_BEj=r ruc &[SSSSSSSSS S S 9 $) z532-bit little-endian TIFF format with 64-bit offsets.rRrsrPrrTr rr zProcessingSoftware)rNewSubfileType)r SubfileType)r ImageWidth)r ImageLength)r BitsPerSample)r Compression)rPhotometricInterpretation)i Thresholding)i CellWidth)i  CellLength)  FillOrder)i  DocumentName)rImageDescription)rr)ir)r StripOffsets) Orientation)rSamplesPerPixel)r RowsPerStrip)rStripByteCounts)iMinSampleValue)iMaxSampleValue)r XResolution)r YResolution)rPlanarConfiguration)rPageName)i XPosition)i YPosition)  FreeOffsets)i!FreeByteCounts)i"GrayResponseUnit)i#GrayResponseCurve)r T4Options)i% T6Options)rResolutionUnit)i) PageNumber)i,ColorResponseUnit)rTransferFunction)rr)rrh)i;Artist)i< HostComputer)r Predictor)i> WhitePoint)i?PrimaryChromaticities)rColorMap)iA HalftoneHints)r TileWidth)r TileLength)r TileOffsets)rTileByteCounts)iF BadFaxLines)iG CleanFaxData)iHConsecutiveBadFaxLines)rSubIFDs)iLInkSet)iMInkNames)iN NumberOfInks)iPDotRange)iQ TargetPrinter)r ExtraSamples)r SampleFormat)iTSMinSampleValue)iUSMaxSampleValue)iV TransferRange)iWClipPath)iXXClipPathUnits)iYYClipPathUnits)iZIndexed)r JPEGTables)i_OPIProxy)GlobalParametersIFD)i ProfileType)i FaxProfile)i CodingMethods)i VersionYear)i ModeNumber)iDecode)iDefaultImageColor)i T82Options)ir )r JPEGProc)reJPEGInterchangeFormat)rfJPEGInterchangeFormatLength)iJPEGRestartInterval)iJPEGLosslessPredictors)iJPEGPointTransforms)i JPEGQTables)i JPEGDCTables)i  JPEGACTables)iYCbCrCoefficients)rYCbCrSubSampling)YCbCrPositioning)rReferenceBlackWhite)i/StripRowCounts)r~XMP)iGDIGamma)iICCProfileDescriptor)iSRGBRenderingIntent)i  ImageTitle)i SiffCompress)iUSPTO_Miscellaneous)r AndorId)iAndorTemperature)i AndorExposureTime)iAndorKineticCycleTime)iAndorAccumulations)iAndorAcquisitionCycleTime)iAndorReadoutTime)iAndorPhotonCounting)iAndorEmDacLevel)i AndorFrames)i AndorHorizontalFlip)i!AndorVerticalFlip)i"AndorClockwise)i#AndorCounterClockwise)i(AndorVerticalClockVoltage)i)AndorVerticalShiftSpeed)i+AndorPreAmpSetting)i,AndorCameraSerial)i/AndorActualTemperature)i0AndorBaselineClamp)i1 AndorPrescans)i2 AndorModel)i3AndorChipSizeX)i4AndorChipSizeY)iPAndorBaselineOffset)ifAndorSoftwareVersion)iFGRating)iGG XP_DIP_XML)iHG StitchInfo)iIG RatingPercent)iPResolutionXUnit)iPResolutionYUnit)iPResolutionXLengthUnit)iPResolutionYLengthUnit)iP PrintFlags)iPPrintFlagsVersion)iPPrintFlagsCrop)iPPrintFlagsBleedWidth)i PPrintFlagsBleedWidthScale)i P HalftoneLPI)i PHalftoneLPIUnit)i PHalftoneDegree)i P HalftoneShape)iP HalftoneMisc)iPHalftoneScreen)iP JPEGQuality)iPGridSize)iPThumbnailFormat)iPThumbnailWidth)iPThumbnailHeight)iPThumbnailColorDepth)iPThumbnailPlanes)iPThumbnailRawBytes)iP ThumbnailSize)iPThumbnailCompressedSize)iPColorTransferFunction)iP ThumbnailData)i PThumbnailImageWidth)i!PThumbnailImageHeight)i"PThumbnailBitsPerSample)i#PThumbnailCompression)i$PThumbnailPhotometricInterp)i%PThumbnailImageDescription)i&PThumbnailEquipMake)i'PThumbnailEquipModel)i(PThumbnailStripOffsets)i)PThumbnailOrientation)i*PThumbnailSamplesPerPixel)i+PThumbnailRowsPerStrip)i,PThumbnailStripBytesCount)i-PThumbnailResolutionX)i.PThumbnailResolutionY)i/PThumbnailPlanarConfig)i0PThumbnailResolutionUnit)i1PThumbnailTransferFunction)i2PThumbnailSoftwareUsed)i3PThumbnailDateTime)i4PThumbnailArtist)i5PThumbnailWhitePoint)i6PThumbnailPrimaryChromaticities)i7PThumbnailYCbCrCoefficients)i8PThumbnailYCbCrSubsampling)i9PThumbnailYCbCrPositioning)i:PThumbnailRefBlackWhite)i;PThumbnailCopyRight)iAPInteroperabilityIndex)iBPInteroperabilityVersion)iPLuminanceTable)iPChrominanceTable)iQ FrameDelay)iQ LoopCount)iQ GlobalPalette)iQIndexBackground)iQIndexTransparent)iQ PixelUnit)iQ PixelPerUnitX)iQ PixelPerUnitY)iQPaletteHistogram)rSonyRawFileType)i2pVignettingCorrParams)i5pChromaticAberrationCorrParams)i7pDistortionCorrParams)i ImageID)iWangTag1)iWangAnnotation)iWangTag3)iWangTag4)iImageReferencePoints)iRegionXformTackPoint)iWarpQuadrilateral)iAffineTransformMat)iMatteing)iDataType)r ImageDepth)r TileDepth)iImageFullWidth)iImageFullLength)i TextureFormat)iTextureWrapModes)iFieldOfViewCotangent)iMatrixWorldToScreen)iMatrixWorldToCamera)i}Model2)iCFARepeatPatternDim)i CFAPattern)i BatteryLevel)iKodakIFD)irB )iFNumber)i Copyright)r MDFileTag)i MDScalePixel)i MDColorTable)i MDLabName)i MDSampleInfo)i MDPrepDate)i MDPrepTime)i MDFileUnits)i NiffRotation)iNiffNavyCompression)i NiffTileIndex)r OlympusINI)r*ModelPixelScaleTag)r OlympusSIS)i5 AdventScale)i6AdventRevision)rUIC1tag)rUIC2tag)rUIC3tag)rUIC4tag)黃IPTCNAA)iBExtendedTagsOffset)i~IntergraphPacketData)iIntergraphFlagRegisters)r'IntergraphMatrixTag)i INGRReserved)r,ModelTiepointTag)郄 LeicaMagic)iSite)i ColorSequence)i IT8Header)i RasterPadding)iBitsPerRunLength)iBitsPerExtendedRunLength)i ColorTable)iImageColorIndicator)iBackgroundColorIndicator)iImageColorValue)iBackgroundColorValue)iPixelIntensityRange)iTransparencyIndicator)iColorCharacterization)iHCUsage)i TrapIndicator)iCMYKEquivalent)rCZ_SEM)ih AFCP_IPTC)iPixelMagicJBIGOptions)iׅ JPLCartoIFD)iJIPLAB)r.ModelTransformationTag)i WB_GRGBLevels)iLeafData)r MM_Header)rMM_Stamp); MM_Unknown)iIImageResources)R MM_UserBlock)r CZ_LSMINFO)iExifTag)rInterColorProfile)rFEI_SFEG)r FEI_HELIOS)i{ FEI_TITAN)i FXExtensions)i MultiProfiles)i SharedData)i T88Options)iMarCCD)i ImageLayer)r"GeoKeyDirectoryTag)鰇GeoDoubleParamsTag)r&GeoAsciiParamsTag)i JBIGOptions)irP )i"ExposureProgram)i$SpectralSensitivity)%GPSTag)r OlympusSIS2)'ISOSpeedRatings)rPhotographicSensitivity)i(OECF)i) Interlace)i*TimeZoneOffset)i+ SelfTimerMode)i0SensitivityType)i1StandardOutputSensitivity)i2RecommendedExposureIndex)i3ISOSpeed)i4ISOSpeedLatitudeyyy)i5ISOSpeedLatitudezzz)i\HylaFAXFaxRecvParams)i]HylaFAXFaxSubAddress)i^HylaFAXFaxRecvTime)i_FaxDcs)iqFedexEDR)i LeafSubIFD)i Aphelion1)i Aphelion2)iAphelionInternal) ExifVersion)DateTimeOriginal)DateTimeDigitized) GooglePlusUploadCode) OffsetTime)iOffsetTimeOriginal)iOffsetTimeDigitized)r TVX_Unknown)iTVX_NumExposure)iTVX_NumBackground)rTVX_ExposureTime)rTVX_BackgroundTime)ir)r TVX_SubBpp)i TVX_SubWide)i TVX_SubHigh)i TVX_BlackLevel)i TVX_DarkCurrent)i TVX_ReadNoise)iTVX_DarkCurrentNoise)rTVX_BeamMonitor)iTVX_UserVariables)iComponentsConfiguration)iCompressedBitsPerPixel)iShutterSpeedValue)i ApertureValue)iBrightnessValue)iExposureBiasValue)iMaxApertureValue)iSubjectDistance)i MeteringMode)i LightSource)i Flash)i FocalLength)i FlashEnergy)i SpatialFrequencyResponse)i Noise)iFocalPlaneXResolution)iFocalPlaneYResolution)iFocalPlaneResolutionUnit)i ImageNumber)iSecurityClassification)i ImageHistory)iSubjectLocation)i ExposureIndex)rTIFFEPStandardID)i SensingMethod)i: CIP3DataFile)i; CIP3Sheet)i<CIP3Side)i?StoNits)i| MakerNote)i UserComment)i SubsecTime)iSubsecTimeOriginal)iSubsecTimeDigitized)i/MODIText)i0MODIOLEPropertySetStorage)i1MODIPositioning)r{ AgilentBinary)iF AgilentString)rTVIPS)iKTVIPS1)iLTVIPS2)\ImageSourceData)i Temperature)iHumidity)iPressure)i WaterDepth)i Acceleration)iCameraElevationAngle)i@XPos)AYPos)BZPos)rG MC_IpWinScal)rG RecipName)rI RecipNumber)iC SenderName)iDRouting)iECallerId)iFTSID)iGCSID)iHFaxTime)餜MC_IdOld)i MC_Unknown)InteroperabilityTag)iXPTitle)i XPComment)iXPAuthor)i XPKeywords)i XPSubject)iFlashpixVersion)i ColorSpace)iPixelXDimension)iPixelYDimension)iRelatedSoundFile)iSamsungRawPointersOffset)iSamsungRawPointersLength)iSamsungRawByteOrder)iSamsungRawUnknown)i r )i r!)i r")ir#)ir$)ir%)ir&)ir')ir()ir))ir*)izTIFF-EPStandardID)ir,)i FileSource)i SceneType)ir)iCustomRendered)i ExposureMode)i WhiteBalance)iDigitalZoomRatio)iFocalLengthIn35mmFilm)iSceneCaptureType)i GainControl)iContrast)i Saturation)i Sharpness)i DeviceSettingDescription)i SubjectDistanceRange)i ImageUniqueID)i0CameraOwnerName)i1BodySerialNumber)i2LensSpecification)i3LensMake)i4 LensModel)i5LensSerialNumber)i`CompositeImage)iaSourceImageNumberCompositeImage)ib!SourceExposureTimesCompositeImage)r GDAL_METADATA)r{ GDAL_NODATA)iGamma)rNIHImageHeader)iExpandSoftware)i ExpandLens)i¯ ExpandFilm)iïExpandFilterLens)iį ExpandScanner)iůExpandFlashLamp)i PixelFormat)iTransformation)i Uncompressed)i ImageType)ir )i ImageHeight)iWidthResolution)iHeightResolution)i ImageOffset)iImageByteCount)i¼ AlphaOffset)iüAlphaByteCount)iļImageDataDiscard)iżAlphaDataDiscard)iS KodakAPP3)i'OceScanjobDescription)i(OceApplicationSelector)i)OceIdentificationNumber)i*OceImageLogicCharacteristics)iO Annotations)rMC_Id)iq MC_XYPosition)ir MC_ZPosition)isMC_XYCalibration)itMC_LensCharacteristics)iuMC_ChannelName)ivMC_ExcitationWavelength)iw MC_TimeStamp)xMC_FrameProperties)iPrintImageMatching)i?PCO_RAW)isOriginalFileName)iUSPTO_OriginalContentType)iUSPTO_RotationCode)i CR2Unknown1)i CR2Unknown2)i CR2CFAPattern)rLercParameters)r DNGVersion)iDNGBackwardVersion)iUniqueCameraModel)iLocalizedCameraModel)i CFAPlaneColor)i CFALayout)iLinearizationTable)iBlackLevelRepeatDim)i BlackLevel)iBlackLevelDeltaH)iBlackLevelDeltaV)i WhiteLevel)i DefaultScale)iDefaultCropOrigin)i DefaultCropSize)i! ColorMatrix1)i" ColorMatrix2)i#CameraCalibration1)i$CameraCalibration2)i%ReductionMatrix1)i&ReductionMatrix2)i' AnalogBalance)i( AsShotNeutral)i) AsShotWhiteXY)i*BaselineExposure)i+ BaselineNoise)i,BaselineSharpness)i-BayerGreenSplit)i.LinearResponseLimit)i/CameraSerialNumber)i0LensInfo)i1ChromaBlurRadius)i2AntiAliasStrength)i3 ShadowScale)i4DNGPrivateData)i5MakerNoteSafety)i@RawImageSegmentation)iZCalibrationIlluminant1)i[CalibrationIlluminant2)i\BestQualityScale)i]RawDataUniqueID)i`AliasLayerMetadata)iOriginalRawFileName)iOriginalRawFileData)i ActiveArea)i MaskedAreas)iAsShotICCProfile)iAsShotPreProfileMatrix)iCurrentICCProfile)iCurrentPreProfileMatrix)rnIJMetadataByteCounts)r IJMetadata)r0RPCCoefficientTag)iColorimetricReference)iSRawType)iPanasonicTitle)iPanasonicTitle2)iRSID)i GEO_METADATA)iCameraCalibrationSignature)iProfileCalibrationSignature)iExtraCameraProfiles)iAsShotProfileName)iNoiseReductionApplied)i ProfileName)iProfileHueSatMapDims)iProfileHueSatMapData1)iProfileHueSatMapData2)iProfileToneCurve)iProfileEmbedPolicy)iProfileCopyright)iForwardMatrix1)iForwardMatrix2)iPreviewApplicationName)iPreviewApplicationVersion)iPreviewSettingsName)iPreviewSettingsDigest)iPreviewColorSpace)iPreviewDateTime)iRawImageDigest)iOriginalRawFileDigest)iSubTileBlockSize)iRowInterleaveFactor)i%ProfileLookTableDims)i&ProfileLookTableData)i@ OpcodeList1)iA OpcodeList2)iN OpcodeList3)iO FibicsXML)ia NoiseProfile)ic TimeCodes)id FrameRate)irTStop)iReelName)iOriginalDefaultFinalSize)iOriginalBestQualitySize)iOriginalDefaultCropSize)i CameraLabel)iProfileHueSatMapEncoding)iProfileLookTableEncoding)iBaselineExposureOffset)iDefaultBlackRender)iNewRawImageDigest)iRawToPreviewGain)i CacheBlob)i CacheVersion)rMicroManagerMetadata)iDefaultUserCrop)i ZIFmetadata)iZIFannotations)rb DepthFormat)i DepthNear)iDepthFar)i DepthUnits)iDepthMeasureType)i EnhanceParams)i-ProfileGainTableMap)i. SemanticName)i0SemanticInstanceID)i1CalibrationIlluminant3)i2CameraCalibration3)i3 ColorMatrix3)i4ForwardMatrix3)i5IlluminantData1)i6IlluminantData2)i7IlluminantData3)i8 MaskSubArea)i9ProfileHueSatMapData3)i:ReductionMatrix3)i? RGBTables)i@ProfileGainTableMap2)r C2PAManifestStore)iCColumnInterleaveFactor)iDImageSequenceInfo)iF ImageStats)iGProfileDynamicRange)iHProfileGroupName)iI JXLDistance)iJ JXLEffort)iKJXLDecodeSpeed)iAperioUnknown55000)iAperioMagnification)i AperioMPP)iAperioScanScopeID)i AperioDate)iPadding)i OffsetSchema)i JEOL_Header)iFlexXMLr%rs rvr _TIFF.TAGS=sC E  E ruc0S[_S[_S[_S[_S[_S[_S[ _S[ _S [_S [_S [_S [_S [_S[_S[_S[_S[_0S[_S[_S[_S[_S[_S[_S[_S[_S[ _S["_S[$_S[&_S[_S[_S [_S![_E$)"Nrrrrrrrrrrrrrrrrr>rrrTrrrrrrrrrWr~ri) read_colormap read_bytesr read_uic2tag read_uic3tag read_uic4tag read_cz_semread_mm_header read_mm_stamprread_cz_lsminforead_fei_metadataread_tvips_headerread_nih_image_header read_json read_sis_iniread_sis read_exif_ifd read_gps_ifdread_interoperability_ifdrs rvr_TIFF.TAG_READERSU@s & & & : &  <&  <&  <&  <&  ;&  >&  =&  :&  :& ?!& " $#& $ $%& & $'& ( :)& * :+& , (-& 0 :1& 2 :3& 4 :5& 6 :7& 8 99& : <;& < 8=& > =?& @ Registry of EXIF tags, including private Photoshop Camera RAW.))r OwnerName)rj SerialNumber)rkLens)iLRawFile)iM Converter)iNrk)iQExposure)iRShadows)iS Brightness)iTrp)iUrq)iVrr)iW Smoothness)iX MoireFilter)r%r rr)rkrs rv EXIF_TAGS_TIFF.EXIF_TAGSAs*  $ DII ruc[S5$)z?Registry of private TIFF tags for Hamamatsu NDPI (65420-65458).)*)i,OffsetHighBytes)i-ByteCountHighBytes)r FileFormat)r Magnification)iXOffsetFromSlideCenter)iYOffsetFromSlideCenter)ZOffsetFromSlideCenter)i TissueIndex)r~r) SlideLabel)iAuthCode)i65429)i65430)i65431)rr)i65433)i Fluorescence)i ExposureRatio)i RedMultiplier)iGreenMultiplier)iBlueMultiplier)rG FocusPoints)iFocusPointRegions)r CaptureMode)iScannerSerialNumber)i65443)i JpegQuality)iRefocusInterval)i FocusOffset)i BlankLines)iFirmwareVersion)iComments)i LabelObscured)i Wavelength)i65452)iLampAge)irB )i FocusTime)iScanTime)i WriteTime)iFullyAutoFocus)r> DefaultGammarDrs rvr_TIFF.NDPI_TAGS(As+ - - ruc[S5$)zRegistry of GPS IFD tags.) )r GPSVersionID)rYGPSLatitudeRef)rT GPSLatitude)rGPSLongitudeRef)r GPSLongitude)rGPSAltitudeRef)r GPSAltitude)r GPSTimeStamp)rP GPSSatellites)r; GPSStatus)rGPSMeasureMode)r>GPSDOP)r GPSSpeedRef)rGPSSpeed)r GPSTrackRef)rGPSTrack)rGPSImgDirectionRef)rGPSImgDirection)r GPSMapDatum)rGPSDestLatitudeRef)r GPSDestLatitude)rGPSDestLongitudeRef)GPSDestLongitude)GPSDestBearingRef)rGPSDestBearing)GPSDestDistanceRef)GPSDestDistance)GPSProcessingMethod)GPSAreaInformation) GPSDateStamp)GPSDifferential)GPSHPositioningErrorrDrs rvGPS_TAGS_TIFF.GPS_TAGS[As! # # ruc[S5$)z&Registry of Interoperability IFD tags.))rYrc)rTrd)r^RelatedImageFileFormat)iRelatedImageWidth)iRelatedImageLengthrDrs rvIOP_TAGS_TIFF.IOP_TAGSAs   rucf0SS_SS_SS_SS_SS_SS_SS_SS_S S_S S_S S_S S_S S_SS_SS_SS_$)z=Map :py:class:`PHOTOMETRIC` to number of photometric samples.rrYrTrrrrrPr;rr_ r` ra rrb rc rtrs rvrU_TIFF.PHOTOMETRIC_SAMPLESAs q q  q  q  q  q   q  q  q    1  1  1  1  1 1!  rucf0SS_SS_SS_SS_S S _S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS_$)z2Map :py:class:`DATATYPE` to Python struct formats.rY1BrT1sr1Hr1Ir2Ir1brrP1hr;1ir2ir>1fr1drr1Qr1qrrtrs rvr_TIFF.DATA_FORMATSAs t t  t  t  t  t   t  t  t         ! " # $ %  ruc"SSSSSSSSS S S S S S. $)z(Map NumPy dtype to :py:class:`DATATYPE`.rYrTrrrrrPr;rr>rrr) rrrQr rr r+rrrrr/ qrtrs rvr_TIFF.DATA_DTYPESAs5  ruc0SS_SS_SS_SS_SS_SS_S S_S S_S S _S S _SS _SS _SS _SS _SS _SS _SS_0SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_S S_S!S_S"S_S#S_S$S_S%S&_S'S_E0S(S_S)S_S*S_S+S_S,S_S-S_S.S_S/S _S0S _S1S _S2S _S3S _S4S _S5S _S6S _S7S_S8S_E0S9S_S:S_S;S_SS_S?S_S@S_SAS_SBS_SCS_SDS_SES_SFS_SGS&_SHSI_SJSK_ESLSMSNSOSOSPSQSRSSSSQSRST. E$)Uz>Map :py:class:`SAMPLEFORMAT` and BitsPerSample to NumPy dtype.rrrr)rYr)rYr)rYr)rYr)rYr)rYrP)rYr;rQ)rYr)rYr>)rYr)rYr)rYr )rYr)rYr)rYrr )rYr)rYr)rYr )rYr)rYr)rYr)rYr)rYr)rYr)rYr)rYr)rYr)rYr)rYr)rYr))rYr r/ r)rrT)rrr()rr)rr)rr)rrP)rr;)rr)rr>)rr)rr)rr )rr)rr)rr)rr)rr)rr )rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr))rr )rTrPr rTrr+rrrrrrJ Dr. ) )rTr))rTr )rr)rrrr))rr )rr )rr)rYrrr)rr)rr))rr rtrs rvr_TIFF.SAMPLE_DTYPESAsX CX  CX  C X C X C X  CX  CX  CX  CX  SX  SX  SX  SX  SX S!X " S#X $ S%X & S'X ( S)X * S+X , S-X . S/X 0 S1X 2 S3X 4 S5X 6 S7X 8 S9X : S;X < S=X > S?X @ SAX B SCX D SEX H CIX J CKX L CMX N COX P CQX R CSX T CUX V CWX X CYX Z S[X \ S]X ^ S_X ` SaX b ScX d SeX f SgX h SiX j SkX l SmX n SoX p SqX r SsX t SuX v SwX x SyX z S{X | S}X ~ SX @ SAX B SCX D SEX F SGX H SIX L CMX N SOX PoX X ruc[SS9$)z3Map :py:class:`PREDICTOR` value to encode function.Trgr rs rvrR_TIFF.PREDICTORS.BsT**ruc[SS9$)z3Map :py:class:`PREDICTOR` value to decode function.Frrrs rvr"_TIFF.UNPREDICTORS3BsU++ruc[SS9$)z7Map :py:class:`COMPRESSION` value to compress function.Trr rs rvrx_TIFF.COMPRESSORS8Bs t,,ruc[SS9$)z9Map :py:class:`COMPRESSION` value to decompress function.Frrrs rvr!_TIFF.DECOMPRESSORS=Bs u--ruc 1Sk$)N>rrrrrrrrrrrrjrkrrrrrrtrs rvrQ_TIFF.IMAGE_COMPRESSIONSBBs   ruc @0S[_S[_S[_S[_S[_S[ _S[ _S[_S [_S [_S [_S [_S [_S[_S[_S[_S[ _["[$[&[([*[,[.S.E$)zxMap series kind to series parser function. The order determines dispatch priority in :py:meth:`TiffFile._get_series`. rlsmrrrndtifffluoviewstksissvsscnqpir@bifavseerphilips) scanimageindicanihmdgelgeotiffrrS) series_shaped series_lsmseries_mmstack series_ome series_imagej series_ndtiffseries_fluoview series_stk series_sis series_svs series_scn series_qpi series_ndpi series_bif series_avs series_eerseries_philipsseries_scanimage series_indica series_nih series_mdgelseries_geotiffseries_uniformrrs rvr _TIFF.SERIES\Bs m :  ~  :  m  m     :  :  :  :  :  K  :  : :! " ~# $*#!%%%1  ruct0SS_SS_SS_SS_S S _S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS _S!S"_S#S$0E$)%aZMap axes character codes to dimension names. - **X : width** (image width) - **Y : height** (image length) - **Z : depth** (image depth) - **S : sample** (color space and extra samples) - **I : sequence** (generic sequence of images, frames, planes, pages) - **T : time** (time series) - **C : channel** (acquisition path or emission wavelength) - **A : angle** (OME) - **P : phase** (OME. In LSM, **P** maps to **position**) - **R : tile** (OME. Region, position, or mosaic) - **H : lifetime** (OME. Histogram) - **E : lambda** (OME. Excitation wavelength) - **Q : other** (OME) - **L : exposure** (FluoView) - **V : event** (FluoView) - **M : mosaic** (LSM 6) - **J : column** (NDTiff) - **K : row** (NDTiff) There is no universal standard for dimension codes or names. This mapping mainly follows TIFF, OME-TIFF, ImageJ, LSM, and FluoView conventions. rrXrrr rZrSsampler r3 rrm rchannelr+ r' r, r( r- rrQr) r. r* LexposureVeventMmosaicr/ r3JcolumnKrowrtrs rv AXES_NAMES_TIFF.AXES_NAMESBs8                            ! " # $ % & '  ruc[RR5VVs0sHupX!_M nnnSUS'SUS'U$s snnf)zYMap dimension names to axes character codes. Reverse mapping of :py:attr:`AXES_NAMES`. r rQ r- position)rr/r`)rkrrrs rvr> _TIFF.AXES_CODESBsI/3oo.C.C.EF.E .EFc j Gs?chSSKJn U$![a "SS[R5nU$f=f)z:py:class:`geodb.GeoKeys`.rY)GeoKeysc\rSrSrSrg)_TIFF.GEO_KEYS..GeoKeysiBrtN)rrrrr rtrurvr5r7Bsrur5)geodbr5r enumIntEnum)rkr5s rvrG_TIFF.GEO_KEYSBs9  &    $,,   s  #11c:SSKJn U$![a 0nU$f=f)z/Map :py:class:`geodb.GeoKeys` to GeoTIFF codes.rY)rH)r8rHr )rkrHs rvrH_TIFF.GEO_CODESBs.  ( I s  c1Skn[[5Vs1sHnUSSS:XdMUSSU;dMUSSiM sn$s snf)N>jfifmaskr`rK reducedr subsampledrrr)dirrrkexcluder s rvr_TIFF.PAGE_FLAGSBs\  ] "!u~ "#AB%w"6 AabE"   s >> >cSS1n[[5Vs1sHnUSSS:XdMUSSU;dMUSSiM snR[R5$s snf)Nr appendablerr)rCrunionrrrDs rvra_TIFF.FILE_FLAGSBsql+] "!u~ "#AB%w"6 AabE"  %  ! s AA Ac SS0$)Nra(?ix) # matches Olympus OIF and Leica TIFF series _?(?:(q|l|p|a|c|t|x|y|z|ch|tp)(\d{1,4})) _?(?:(q|l|p|a|c|t|x|y|z|ch|tp)(\d{1,4}))? _?(?:(q|l|p|a|c|t|x|y|z|ch|tp)(\d{1,4}))? _?(?:(q|l|p|a|c|t|x|y|z|ch|tp)(\d{1,4}))? _?(?:(q|l|p|a|c|t|x|y|z|ch|tp)(\d{1,4}))? _?(?:(q|l|p|a|c|t|x|y|z|ch|tp)(\d{1,4}))? _?(?:(q|l|p|a|c|t|x|y|z|ch|tp)(\d{1,4}))? rtrs rv FILE_PATTERNS_TIFF.FILE_PATTERNSBs   rucg)zKnown TIFF file extensions.)rr"zome.tifrrrpcorawqptiffptiffptifgelseqrrrzifr@rtf8tf2btfrrtrs rvFILE_EXTENSIONS_TIFF.FILE_EXTENSIONSBs ruc[RVs/sHnUR5S3SU34PM snS/-$s snf)N filesz*.)z All filesr)rrYrN)rkras rvFILEOPEN_FILTER_TIFF.FILEOPEN_FILTERCsT ++ + }F #r#Z 0+  ! ! s"<c /SQ$)N):) MagicNumberu4) StructureSizei4) DimensionXrc) DimensionYrc) DimensionZrc)DimensionChannelsrc) DimensionTimerc)r~rc) ThumbnailXrc) ThumbnailYrc) VoxelSizeXf8) VoxelSizeYrl) VoxelSizeZrl)OriginXrl)OriginYrl)OriginZrl)ScanTypeu2) SpectralScanrs) TypeOfDatara)OffsetVectorOverlayra)OffsetInputLutra)OffsetOutputLutra)OffsetChannelColorsra) TimeIntervallrl)OffsetChannelDataTypesra)OffsetScanInformationra) OffsetKsDatara)OffsetTimeStampsra)OffsetEventListra) OffsetRoira)OffsetBleachRoira)OffsetNextRecordingra)DisplayAspectXrl)DisplayAspectYrl)DisplayAspectZrl)DisplayAspectTimerl)OffsetMeanOfRoisOverlayra)OffsetTopoIsolineOverlayra)OffsetTopoProfileOverlayra)OffsetLinescanOverlayra) ToolbarFlagsra)OffsetChannelWavelengthra)OffsetChannelFactorsra)ObjectiveSphereCorrectionrl)OffsetUnmixParametersra)OffsetAcquisitionParametersra)OffsetCharacteristicsra) OffsetPalettera)TimeDifferenceXrl)TimeDifferenceYrl)TimeDifferenceZrl) InternalUse1ra) DimensionPrc) DimensionMrc)DimensionsReserved16i4)OffsetTilePositionsra)r=9u4)OffsetPositionsrartrs rvr_TIFF.CZ_LSMINFO#Cs > > ruc 0S[_S[_S[_S[_S[_S[_SS_S[ _S [ _S S_S [ _S S_S S_SS_SS_SS_SS_S[SSSSSS.E$)NScanInformation TimeStamps EventList ChannelColors Positions TilePositions VectorOverlayInputLut OutputLutrzChannelDataTypesKsDataRoi BleachRoi NextRecordingMeanOfRoisOverlayTopoIsolineOverlay)TopoProfileOverlayChannelWavelengthSphereCorrectionChannelFactorsUnmixParametersAcquisitionParametersCharacteristics)read_lsm_scaninforead_lsm_timestampsread_lsm_eventlistread_lsm_channelcolorsread_lsm_positionsread_lsm_lookuptableread_lsm_channeldatatypesread_lsm_channelwavelengthrs rvCZ_LSMINFO_READERS_TIFF.CZ_LSMINFO_READERSfCs  0 -  +  3  +  /   T  ,  -  T   9  d  4    T ! " !$# $#'!; $"#%)#1  ruc SSSSSSSSSSSS. $)NZCYXCZXCTXTCYXTCZXTZCYX) rrYrTrrrrrrPr;rrtrs rvCZ_LSMINFO_SCANTYPE_TIFF.CZ_LSMINFO_SCANTYPECs/  rucSSSSSSSS.$) Nrdrerfrgrhrr)rrr rrr, r)rtrs rvCZ_LSMINFO_DIMENSIONS_TIFF.CZ_LSMINFO_DIMENSIONSCs#$   rucSSSSS.$)Nzvarying data typesz8 bit unsigned integerz12 bit unsigned integerz 32 bit float)rrYrTrrtrs rvCZ_LSMINFO_DATATYPES_TIFF.CZ_LSMINFO_DATATYPESCs$'(   rucSSSSS.$)NzOriginal scan datazCalculated dataz3D reconstructionzTopography height map)rrYrTrrtrs rvCZ_LSMINFO_TYPEOFDATA_TIFF.CZ_LSMINFO_TYPEOFDATACs$ "&   ruc SSSSSSSSS .$) NTracksLasersDetectionChannelsIlluminationChannels BeamSplitters DataChannelsTimersMarkers)i i0i`rl@liirtrs rvCZ_LSMINFO_SCANINFO_ARRAYS _TIFF.CZ_LSMINFO_SCANINFO_ARRAYSCs&! +.'& !  ruc SSSSSSSSS .$) NTrackLaserDetectionChannelIlluminationChannel BeamSplitter DataChannelr)Marker)i@iPipl l`l iirtrs rvCZ_LSMINFO_SCANINFO_STRUCTS!_TIFF.CZ_LSMINFO_SCANINFO_STRUCTSCs& *-&%   rucZ0SS_SS_SS_SS_S S _S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS _S!S"_0S#S$_S%S&_S'S(_S)S*_S+S,_S-S._S/S0_S1S2_S3S4_S5S6_S7S8_S9S:_S;S<_S=S>_S?S@_SASB_SCSD_E0SESF_SGSH_SISJ_SKSL_SMSN_SOSP_SQSR_SSST_SUSV_SWSX_SYSZ_S[S\_S]S^_S_S`_SaSb_ScSd_SeSf_E0SgSh_SiSj_SkSl_SmSn_SoSp_SqSr_SsSt_SuSv_SwSx_SySz_S{S|_S}S~_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SGS_GSGS_GSGS_GSGS_GSGS_GS GS _GS GS _E0GS GS_GSGS_GSGS_GSGS_GSGS_GSGS_GSGS_GSGS_GSS_GSS_GSGS _GS!GS"_GS#GS$_GS%GS&_GS'GS(_GS)GS*_GS+GS,_E0GS-S_GS.S_GS/S_GS0GS1_GS2GS3_GS4GS5_GS6GS7_GS8GS9_GS:GS;_GSGS?_GS@GSA_GSBGSC_GSDGSE_GSFGSG_GSHGSI_GSJGSK_E0GSLGSM_GSNGSO_GSPGS_GSQGS_GSRGSS_GSTS_GSUS_GSVS_GSWGSX_GSYS_GSZS_GS[GS\_GS]GS^_GS_S_GS`S_GSaS_GSbS_E$(cNir ir iNotesi ObjectiveiProcessingSummaryiSpecialScanModeirriScanModei NumberOfStacksi  LinesPerPlanei SamplesPerLinei PlanesPerVolumei  ImagesWidthi ImagesHeightiImagesNumberPlanesiImagesNumberStacksiImagesNumberChannelsi LinscanXySizei ScanDirectioni TimeSeriesiOriginalScanDataiZoomXiZoomYiZoomZiSample0XiSample0YiSample0Zi SampleSpacingi LineSpacingi PlaneSpacingi PlaneWidthi  PlaneHeighti! VolumeDepthi#Nutationi4Rotationi5 Precessioni6 Sample0timei7StartScanTriggerIni8StartScanTriggerOuti9StartScanEventi@ StartScanTimeiAStopScanTriggerIniBStopScanTriggerOutiC StopScanEventiD StopScanTimeiEUseRoisiFUseReducedMemoryRoisiGUseriHUseBcCorrectioniIPositionBcCorrection1iPPositionBcCorrection2iQInterpolationYiR CameraBinningiSCameraSupersamplingiTCameraFrameWidthiUCameraFrameHeightiV CameraOffsetXiW CameraOffsetYiY RtBinningiZ RtFrameWidthi[ RtFrameHeighti\ RtRegionWidthi]RtRegionHeighti^ RtOffsetXi_ RtOffsetYi`RtZoomia RtLinePeriodibPrescanicScanDirectionZi@ MultiplexTypei@MultiplexOrderi@ SamplingModei@SamplingMethodi@SamplingNumberi@Acquirei@SampleObservationTimei @TimeBetweenStacksi @i @Collimator1Namei@Collimator1Positioni@Collimator2Namei@Collimator2Positioni@ IsBleachTracki@IsBleachAfterScanNumberi@BleachScanNumberi@ TriggerIni@ TriggerOuti@ IsRatioTracki@ BleachCounti@SpiCenterWavelengthi@ PixelTimei!@CondensorFrontlensi#@FieldStopValuei$@IdCondensorAperturei%@CondensorAperturei&@IdCondensorRevolveri'@CondensorFilteri(@IdTransmissionFilter1i)@IdTransmission1i0@IdTransmissionFilter2i1@IdTransmission2i2@ RepeatBleachi3@EnableSpotBleachPosi4@SpotBleachPosxi5@SpotBleachPosyi6@SpotBleachPoszi7@ IdTubelensi8@IdTubelensPositioni9@TransmittedLighti:@ReflectedLighti;@SimultanGrabAndBleachi<@BleachPixelTimeiPiPiPPoweripIntegrationModeip SpecialModeipDetectorGainFirstipDetectorGainLastipAmplifierGainFirstipAmplifierGainLastipAmplifierOffsFirstipAmplifierOffsLasti pPinholeDiameteri pCountingTriggeri pi pPointDetectorNamei p AmplifierNameip PinholeNameip FilterSetNameip FilterNameipIntegratorNameip ChannelNameipDetectorGainBc1ipDetectorGainBc2ipAmplifierGainBc1ipAmplifierGainBc2ipAmplifierOffsetBc1i pAmplifierOffsetBc2i!pSpectralScanChannelsi"pSpiWavelengthStarti#pSpiWavelengthStopi&pDyeNamei'p DyeFolderl l l rl Aquirel DetchannelNamel PowerBc1l PowerBc2l` FilterSetl`Filterl`l l l rU l  SampleTypel r l  RatioTypel  RatioTrack1l  RatioTrack2l  RatioChannel1l  RatioChannel2l  RatioConst1l  RatioConst2l  RatioConst3l  RatioConst4l  RatioConst5l  RatioConst6l RatioFirstImages1l RatioFirstImages2l l l Spectruml iiiIntervaliiiActivationTimeiActivationNumberiiiirtrs rvCZ_LSMINFO_SCANINFO_ATTRIBUTES$_TIFF.CZ_LSMINFO_SCANINFO_ATTRIBUTESCs E E   E   E  E + E  )E   E   E  (E  E  (E  )E   E  E ,!E " ,#E $ .%E & 'E ( )E *  +E , *-E . /E 0 1E 2 3E 4  5E 6  7E 8  9E : ;E <  =E > ?E @  AE B  CE D  EE F  GE H  IE J  KE L  ME N ,OE P -QE R (SE T UE V +WE X ,YE Z [E \ ]E ^  _E ` .aE b cE d )eE f /gE h /iE j (kE l mE n -oE p *qE r +sE t uE v wE x  yE z {E | }E ~ E @ (AE B  CE D  EE F GE H IE J  KE L (ME P QE R (SE T UE V (WE X (YE Z  [E \ /]E ^ +_E ` aE b )cE d -eE f )gE h -iE j kE l 1mE n *oE p  qE r  sE t uE v  wE x -yE z  {E | ,}E ~ (E @ -AE B +CE D -EE F )GE H /IE J )KE L /ME N )OE P QE R -SE T (UE V (WE X (YE Z  [E \ ,]E ^ *_E ` (aE b /cE d )eE h iE j  kE l mE p )qE r  sE t +uE v *wE x ,yE z +{E | ,}E ~ +E @ )AE B )CE D  EE F +GE H IE J  KE L ME N  OE P (QE R  SE T )UE V )WE X *YE Z *[E \ ,]E ^ ,_E ` .aE b ,cE d +eE f  gE h  iE l mE n oE p  qE r sE t (uE v  wE x  yE |  }E ~ E @ AE D EE F  GE H IE J  KE L ME N  OE P  QE R  SE T UE V WE X  YE Z  [E \  ]E ^  _E `  aE b  cE d +eE f +gE h  iE j  kE l  mE n  oE r sE t  uE v  wE x  yE z  {E | (}E ~ *E B CE D  EE F  GE H  IE E ruc8"SS[R5nU$)Nc,\rSrSrSrSrSrSrSrSr Sr g ) ,_TIFF.CZ_LSM_LUTTYPE..CZ_LSM_LUTTYPEiDrrYrTrrrrtN) rrrrNORMALORIGINALRAMPPOLYLINESPLINEGAMMAr rtrurvCZ_LSM_LUTTYPErDs FHDHFErurr9r:)rkrs rvr_TIFF.CZ_LSM_LUTTYPEDs T\\ ruc8"SS[R5nU$)Nc0\rSrSrSrSrSrSrSrSr Sr S r g ) 8_TIFF.CZ_LSM_SUBBLOCK_TYPE..CZ_LSM_SUBBLOCK_TYPEiDrrYrTrrrrrtN) rrrrrr BRIGHTNESSCONTRASTrKNOTSPALETTE_12_TO_12r rtrurvCZ_LSM_SUBBLOCK_TYPErDs&CEJHDE rurr)rkrs rvr_TIFF.CZ_LSM_SUBBLOCK_TYPEDs !4<< !$#ruc/SPSPSPSPSPSPSPSPS PS PS PS PS PSPSPSPSPSSS/4PSSS/4PSPSPSPSPSPSPSPSPSPSPS PS!PS"PS#PS$PS%PS&PS'PS(PS)PS*PS+PS,PS-PS.PS/PS0P$)1N)FileIDS8)nLinesi2) PixelsPerLiner)Versionr) OldLutModer) OldnColorsr)Colorsu1r) OldColorStartr) ColorWidthr) ExtraColorsrs)rr) nExtraColorsr)ForegroundIndexr)BackgroundIndexr)XScalerl)Unused2r)Unused3r)UnitsIDrp1)rr)yrp2) CurveFitTyper) nCoefficientsr)Coeffrlr)UMsizer)UMS15) UnusedBooleanr) BinaryPicb1) SliceStartr)SliceEndr)ScaleMagnificationf4)nSlicesr) SliceSpacingr) CurrentSlicer) FrameIntervalr)PixelAspectRatior) ColorStartr)ColorEndr)nColorsr)Fill13u2)Fill2r)Tabler)LutModer) InvertedTabler)ZeroClipr) XUnitSizer)XUnitS11) StackTyperrtrs rvNIH_IMAGE_HEADER_TIFF.NIH_IMAGE_HEADERDs0 0 0  $0   0 ! 0 ! 0  &0  $0  !0  *0  #0  &0  &0  0  0 !0 " #0 $K- .%0 &K- .'0 ( #)0 * $+0 , -0 . /0 0 10 2 $30 4 50 6 !70 8 90 : );0 < =0 > #?0 @ #A0 B $C0 D 'E0 F !G0 H I0 J K0 L M0 N O0 P Q0 R S0 T $U0 V W0 X Y0 Z [0 \ ]0 0 rucg)N) CustomTable AppleDefaultPseudo20Pseudo32RainbowFire1Fire2IceGraysrrtrs rvNIH_COLORTABLE_TYPE_TIFF.NIH_COLORTABLE_TYPEDs  rucg)N) PseudoColorOldAppleDefault OldSpectrum GrayScaleColorLutCustomGrayscalertrs rvNIH_LUTMODE_TYPE_TIFF.NIH_LUTMODE_TYPEDs rucg)N) StraightLinePoly2Poly3Poly4Poly5ExpoFitPowerFitLogFit RodbardFit SpareFit1 UncalibratedUncalibratedODrtrs rvNIH_CURVEFIT_TYPE_TIFF.NIH_CURVEFIT_TYPEEs  rucg)N) Nanometers Micrometers Millimeters CentimetersMeters KilometersInchesFeetMilesr OtherUnitsrtrs rvNIH_UNITS_TYPE_TIFF.NIH_UNITS_TYPEEs  ruc /SQ$)N)*)rrc) CommentV1S80) HighTensionrc)SphericalAberrationrc)IlluminationAperturerc)rxrc)PostMagnificationrc)rrc)Defocusrc) Astigmatismrc)AstigmatismDirectionrc)BiprismVoltagerc)SpecimenTiltAnglerc)SpecimenTiltDirectionrc)IlluminationTiltDirectionrc)IlluminationTiltAnglerc) ImageModerc) EnergySpreadrc)ChromaticAberrationrc) ShutterTyperc) DefocusSpreadrc) CcdNumberrc)CcdSizerc) OffsetXV1rc) OffsetYV1rc)PhysicalPixelSizerc)Binningrc) ReadoutSpeedrc)GainV1rc) SensitivityV1rc)ExposureTimeV1rc) FlatCorrectedrc)DeadPxCorrectedrc) ImageMeanrc)ImageStdrc) DisplacementXrc) DisplacementYrc)DateV1rc)TimeV1rc)ImageMinrc)ImageMaxrc)ImageStatisticsQualityrcrtrs rvTVIPS_HEADER_V1_TIFF.TVIPS_HEADER_V1%Es + + ruc /SQ$)N)6) ImageNameV160) ImageFolderr9) ImageSizeXrc) ImageSizeYrc) ImageSizeZrc) ImageSizeErc) ImageDataTyperc)rrc)rrc)CommentV1024)r(rA)Scaling16f4)ImageStatistics16c16)rrc)ImageDisplayTyperc) PixelSizeXr) PixelSizeYr)ImageDistanceZr)ImageDistanceEr) ImageMisc32f4)TemTyper9)TemHighTensionr)TemAberrationsrL) TemEnergyrL)TemModerc)TemMagnificationr)TemMagnificationCorrectionr)rr) TemStageTyperc)TemStagePosition5f4) TemImageShift2f4) TemBeamShiftrX) TemBeamTiltrX)TilingParameters7f4)TemIllumination3f4) TemShutterrc)TemMiscrL) CameraTyper9)PhysicalPixelSizeXr)PhysicalPixelSizeYr)OffsetXrc)OffsetYrc)BinningXrc)BinningYrc)rB r)Gainr) ReadoutRater)FlatfieldDescriptionr9) Sensitivityr)Doser)CamMiscrL)FeiMicroscopeInformationrA)FeiSpecimenInformationrA)Magicrartrs rvTVIPS_HEADER_V2_TIFF.TVIPS_HEADER_V2UEs 8 8 rucF/SQnSSSSSSSS S S US 4S SSSSSSSSSU4SSS/$)N))r S16)r rc)Originrl) Resolutionrl)UnitS64) HeaderFlagr)rr)r8S257) OffsetDatara) PaletteSizerc)OffsetPalette0ra)OffsetPalette1ra) CommentSizerc) OffsetCommentra Dimensionsr)OffsetPositionra)MapTyper)MapMinrl)MapMaxrl)MinValuerl)MaxValuerl) OffsetMapra)rrl)Offsetrl GrayChannel)OffsetThumbnailra) VoiceFieldrc)OffsetVoiceFieldrart)rk MM_DIMENSIONs rv MM_HEADER_TIFF.MM_HEADEREsf  !  ! ! $ $ ! # < , $         L ) % &/  ruc SSSSSSSSSSS . $) Nrrr rrr- r'r%) rrr rCH WAVELENGTHTIMEXYEVENTEXPOSURErtrs rv MM_DIMENSIONS_TIFF.MM_DIMENSIONSEs,  ruc*/S[4PS[4PS[4PS[4PS[4PS[4PS[4PS[4PS [4PS [4PS PS [4PS [4PS[4PS[4PS[4PS[4PS[4PS[4PSPSPS[4PS[4PS[4PS[4PS[4PS[4PS[4PSPSPSPS PS!PS"PS#PS$PS%[4PS&PS'[4PS([4PS)PS*PS+PS,PS-PS.PS/PS0[4PS1PS2[4PS3PS4[4PS5[4PS6[4PS7[4PS8[4PS9[4PS:[4PS;[4PS<[4PS=[4PS>[4PS?[4PS@[4PSA[4PSB[4P$)CN AutoScaleMinScaleMaxScaleSpatialCalibration XCalibration YCalibrationCalibrationUnitsr ThreshStateThreshStateRed)tagid_10NThreshStateGreenThreshStateBlue ThreshStateLo ThreshStateHiZoom CreateTime LastSavedTime currentBuffer)grayFitN)grayPointCountNgrayXgrayYgrayMingrayMax grayUnitName StandardLUT wavelength) StagePosition (%i,2,2)u4)CameraChipOffsetr) OverlayMaskN)OverlayCompressN)OverlayN)SpecialOverlayMaskN)SpecialOverlayCompressN)SpecialOverlayN ImageProperty) StageLabel%ipAutoScaleLoInfoAutoScaleHiInfo) AbsoluteZz(%i,2)u4)AbsoluteZValidz(%i,)u4)rr )GammaRedr ) GammaGreenr ) GammaBluer ) CameraBinrNewLUT)ImagePropertyExN PlaneProperty) UserLutTablez (256,3)u1RedAutoScaleInfoRedAutoScaleLoInfoRedAutoScaleHiInfoRedMinScaleInfoRedMaxScaleInfoGreenAutoScaleInfoGreenAutoScaleLoInfoGreenAutoScaleHiInfoGreenMinScaleInfoGreenMaxScaleInfoBlueAutoScaleInfoBlueAutoScaleLoInfoBlueAutoScaleHiInfoBlueMinScaleInfoBlueMaxScaleInfo)rrWrzrread_uic_propertyrs rvUIC_TAGS_TIFF.UIC_TAGSEsD # D  D  D "3 ' D X & D X & D   %D SMD C D s #D  D   %D  $D c "D c "D SM!D "? +#D $o .%D &c "'D ( )D * %+D ,h -D .h /D 0 !1D 2 !3D 4S !5D 6C 7D 83 9D : ,;D < /=D > "?D @ &AD B CD D )ED F -GD H %ID J/ 0KD L "MD N )OD P )QD R &SD T *UD V WD X YD Z [D \ ]D ^ _D `sOaD b &cD dc "eD f *gD h  %iD j"8 ,kD l"8 ,mD n $oD p $qD r"3 'sD t$X .uD v$X .wD x!# &yD z!# &{D |!# &}D ~#H -D @#H -AD B  %CD D  %ED D ruc(0S[SS5/[4_SSS/[4_SS/[4_SS/[4_SS/[4_S S/[4_S S/[4_S S/[4_S SS /[4_SS/[4_SS/[4_SS/[4_SS/[4_SS/[4_SS/[4_SSS /[4_SS/[4_0SS/[4_SSS /[4_SS/[4_SS/[4_SS/[4_SS/[4_SS/[4_SS/[4_SS/[4_SS/[4_S S/[4_S!S/[4_S"S/[4_S#S/[4_S$[SS5/[4_S%S/[4_S&S/[4_ES/[4S/[4S/[4S/[4S'.E$)(NDetectorrY Pixel_sizerSiliconr Exposure_timeExposure_periodTau Count_cutoffThreshold_setting Gain_settingrTN_excluded_pixelsExcluded_pixels Flat_field Trim_file Image_pathr Energy_rangeDetector_distanceDetector_VoffsetBeam_xyFluxFilter_transmission Start_angleAngle_incrementDetector_2theta PolarizationAlphaKappaPhi Phi_incrementChi Chi_incrementOscillation_axisN_oscillationsStart_position)Position_increment Shutter_timeOmegaOmega_increment)rrzrYrrs rvPILATUS_HEADER_TIFF.PILATUS_HEADERFs( %4.)3/( Aq65/(  U|(  qc5\ ( U| ( QC< (  aS#J(  1#u(  aVSM(  1#s(  Sz(  A3*(  1#s(  A3*( A3,!( " aVUO#( $ 1#u%( & !e '( ( A)( * aS#J+( , "QC<-( . QC QC=A>%B)(B)r rtN)r6r)r6r%)r6z@dict[int, Callable[[FileHandle, ByteOrder, int, int, int], Any]])r6zfrozenset[int])r6zdict[int, str])r6zdict[int, type[enum.Enum]])r6zdict[int, int]r)r6z,dict[tuple[int, int | tuple[int, ...]], str])r6z Mapping[int, Callable[..., Any]])r6zset[int])r6z rGrHrrarMrLrYr]rrrrrrrrrrrrrrrr r5rqrrrrr rrI r rLr rtrurvrr7=sJ                    H  H  T* I* * X  >  @  *  :  .00 0 d% % N      *  .  $Z Z x++,,--..  2" E" " H/ / b      $!!    6!!@ @ D 6  @                  F F P   $ $1 1 f            - - ^9 9 v! ! F    G G R+ + Z** //*&&* JIrurnmMbP? nanometer nanometersµmrummicronmicronsr micrometersmmg@@ millimeter millimeterscm@ centimeter centimetersr-g.Ametermetersr SU2UMcSURlURRS5 URRnUR=(d UR (+nURR US9n[U5S:XaURnURnO([U5/URQ7nSUR-n[X4URUSS9/$)z0Return all images in TIFF file as single series.TrrrYr rr) rrlrrrir5rrrrrr)rrrrrrs rvr r FsCIIII1 99??D%%45H II    1E 5zQ yyU)djj)TYY 5T J KKruc ~^ URnURSS9 SUlUR(aUR 5 /n0m SU 4SjjnUH{nU"U5 UR cM[ UR 5HHupVUS:aM URRU5 [XRU45nU"U5 MJ M} T R5Hen U Sn[U 5/UR Q7n S UR"-n S U ;a U S - n U S - n UR%['XUR(U S S 95 Mg [U5S:HUlUR,(d [/U5 U=(d S$![a-n[5RU<SU<S35 SnAGM5SnAff=f)z)Return image series grouped by page hash.Frc>UR(dgURnUT;a=TUHnURUR:XdM g TURU5 gU/TU'gryrr#rrrrr seriesdicts rvaddpageseries_generic..addpageF^zz ii * _88t{{*%3&&t,#fJsOruNrPz generic series raised r_rr rSrrSr,rYrrr6r)rrrlrrrprr#r\rrrr7rmrrrrrrrr7rpyramidize_series) rrrr2rrrrrpagelistrrr1s @rvrrFs IIE LLuLEO {{ #%F8:J % << #&t||4 A:$GGLL(%cJJ?;F FO5 %%'{X,,TYY d? TME CKD 8DJJ9 M ([A%CN >>&! >T+!H$$'!8 t Es2F F<!F77F<c^^^SSU4SjjjmS UUU4SjjmSTRlT"TR/5nUcg[U5S:HTl[ USS9 U$) z8Return image series in tifffile 'shaped' formatted file.Nc>[US[5(deUSn[URU5(+n U (a5[ 5R T<SURS[ U535 U (dUbUcDURnURn[U5S:a[U5/UQ7nSU-nU (aUn[U5n [U5n UR(aX:aX-S:XaUcSnSU-nX-/UQ7n[X#U5nUnSn U(a,UR5VVs0sHupUS ;dM X_M n nnUR[!UUUR"UU US [%U5S 95 g![a+n [ 5RT<SU <S35 Sn A NSn A ff=fs snnf) Nrz2 shaped series metadata does not match page shape rrYr/ Tz) shaped series failed to reshape, raised r_>rrrrr)rrrr)rr check_shaperr7rmr~rrr@rErGrrr`rrrr)rrrrrtrrrrfailedrresizerrrrrs rvrseries_shaped..appendFs%(H----Qx W55  H  '"jj\eGn-=?  T\U]JJE99D5zA~U,e,Tzu~!   &-FMQ4F  :D^,e,E W5DE (, %NN,,DABB,    y/    HNN''   s$F: F> F> F;!F66F;c ">/n[U5nSnXC:Ga[U[5(a,URU5 [ [ UR 5nO[ [ US5nURc[5RT<S35 gSnSn[UR5nURSS5n USn URcSOSn URSU 5n S U;aM[ [US 5n[U5[U 5:XaU nOSn[5RT<S 35 U/n [U 5n U S:a"[!U [UR"55upOS nSnU(a[5RT<S 35 gS Us=:aX4- ::aO OUR$ceXR$R&-n U (aS nOXS -nUR((a0Ub-UR*U -UR*:aURcSn O.detect_seriesGs68 u:%++""5)%..9 %(3**2gGGDE 6//<<+Dw'G ( 0 0 8eI [)>+BC gKL6-X--222000F +D )) ,$OOd2T[[@$,,4$) %* !&uqy%.!AA#(8D#'#33#3,4DM"MM$/ "B   OE"8#3#34 !*8+;+;!#'!'E"=w| Q gHI  x )("HNN#&'***-!7$( (s1N*BOO*'OO P!!P  PTrYrAry)rrrr rrQrr/rtrMrrzrr%rr*r6r)rz-TiffPages | list[TiffPage | TiffFrame | None]rrr6list[TiffPageSeries] | None)rrlrr7r6)rrrrCs` @@rvr r Fs+/< $< 0< < & < ! <  < < (<  < < |O<O$O % OObCII 399b )F ~[A%CNfd+ Mruc ^/URRnURnUcgURnURSS9 SUlUR (aUR 5 /n0m/S)U/4SjjnUH{nU"U5 URcM[UR5HHupxUS:aM URRU5 [XRU45n U"U 5 MJ M} UR!S5n UR!S 5n UR!S 5n S nS nS nS nSnU bU b[#U S 5n[#U S 5n[%U S [&5(aU S OU n[#US5[#US 5U-- n[#US5[#US 5U--nUUS US U*4nOU b[)[#U S S 55n[)[#U S S 55n[#U S S5n[#U S S5n[#U S S5[#U S S 5[#U S S 5[#U S S5[#U S S 5[#U S S 54nS nUR!S5nUb [+U5OS nUS :Xa UR!S5nUb [+U5nOUR!S5nUb [+U5n0nSn0nUR!S5nUb[+U5US'UR!S5nUb[+U5US'UR!S5nUb[-U5US'UR!S5nUb[+U5US'UbUUS'UR.nUbUUS'USL=(a UR!S5S:Hn US :acUS :a]UR0n!UR2n"U!S :a UUU!U--4US'U"S :a UUU"U-- 4US 'S S!KJn# U#R!U5n$U$bU$U$S".nT/R95H~n%U%S n[;U%5/UR<Q7n&S#UR>-n'S$U';a U&S%- n&U'S$- n'URA[CU%U&URDU'S&Xa:XaUOSXa:XaUOSXa:XaUOSS'95 M [;U5S :HUl#[IUU S(9 U(aU(aUS n(UR0n)UR2n*U(RJS SHn+U+RLn,U)S :dMU*S :dMU)U,R0- n-U*U,R2- n.Ub[OU5U+l(UUU,R0U-U---4U+RRS'UUU,R2U-U.-- 4U+RRS 'U+RTRWU+RR5 M U=(d S$![a-n [5RU<SU <S35 Sn A GMTSn A ff=f)*z?Return image series in GeoTIFF or Cloud Optimized GeoTIFF file.NFrc>UR(dgURnUT;a=TUHnURUR:XdM g TURU5 gU/TU'gryr/r0s rvr2series_geotiff..addpageGr4rurPz GeoTIFF series raised r_r+r-r/rj rrYrrGTModelTypeGeoKeyProjLinearUnitsGeoKeyGeogLinearUnitsGeoKeyProjectedCSTypeGeoKeyProjectedCSTypeGeographicTypeGeoKeyGeographicTypeGTCitationGeoKeycitationGTRasterTypeGeoKey RasterType geotransformrLAYOUTIFDS_BEFORE_DATArr)LINEAR_UNIT_NAMESrrr rSrr )rrrr rEr5),rrrrrlrrrprr#r\rrrr7rmrSrYrrMr- rrzrrOrPr8rXrrrrrrrr7r6rrrr rr r )0rrgeorrr2rrrrr pixel_scaletiepointtransformationsxsyorigin_xorigin_yrUtp linear_unit model_typemodel_type_vallurr repsggeogrR raster_type gdal_metais_cogsizexsizeyrX unit_namer7rrbaseline base_width base_lengthrlevel_kfrxryr1s0 @rvrrGsF IIOOE   C { IIE LLuLEO {{ #%F8:J % << #&t||4 A:$GGLL(%cJJ?;F FO5"''+,Kww'HWW23N B BHH-1L8#7 ;q> " ;q> "&x{D99Xa[xA<%1,"33A<%1,"33 "c8S2#>  # ~a(+, - ~a(+, -*1-.*1-. .#A& ' .#A& ' .#A& ' .#A& ' .#A& ' .#A& '  K,-J(2(>S_AN WW, - >b'K WW, - >b'K F#'EE 77* +D #&t9 77) *D "%d)ww)*HMj''./K!+.l ,n,,I,5()O)--"9=O"O  Av"q&  !! 19#X %:;F3K 19#X %:;F3K,%))+6  #)4E%%'{X,,TYY d? TME CKD  !%vD#}e$#}e$  (([A%CNff-&!9%% '' __QR(E~~HA~+/("5"55 8#7#77$#';ELx22R7"<<& c" x33b82==& c"&&--emm<)" >Ta!H$$'!8 t Es62W  X!W<<Xc7^uSSKJn URnUcgURU5nSnStSjnU"U5 URRS5nXp0Ul URRnSn S n /n 0n /n 0nUHnURRS 5(dM%UHnURRS 5(dM%URRS 5nURRS 5nU(dMdUcMi[R"[ ["5 [%U5UU'SSS5 M M UGHNnURRS5(a [ 5R'U<S35 GOURRS5(GaUGHnURRSS5RS5(dM60=U URS 'nUGHLnUGHAnUGH6nURSSRS5(dM)URSnURRSS5n[(R*UnSUR;az[%URRSS55n[%URS5n[%URS5U-n[-[.R0"UUU55nO>[-UVs/sH'nURRS5(dM%UPM) sn5nUU4UU'GM9 GMD GMO GM URRS5(dGM,UH4nURRS5(dM%URS n O SnSn UHRn!U!RRS5(dM%U!RRS 5n"U"(a U"U;aUU"n O URn#U#RS5n$UGHhn%U%RRS 5(dM&U%Rn#U#n&SR3[5U#S!55n'U'V(s/sHn([7U#S"U(-5PM n)n(/n*Sn+S#n,/n-/n./n/0muU%GHzn0U0RRS$5(GaU0Rn#U,(aUS n,[7U#RS%U+55n+U+S:a1[9U'5V1V(s/sHun1n(U(S&:XaU)U1U+-OU)U1PM n)n1n(O,[7U#RS%S55U+:wa S'n2[!U25eU#RS5=(d U#RS 5n3U3(aU-R;U35 U#RS(5n4U4bB[R"[ ["5 U/R;[%U455 SSS5 U#RS)5n5U5bB[R"[ ["5 U.R;[%U555 SSS5 GMU0RRS*5(azU0Rn#U#RS+5n6U6bW[7U#RS,S55n7U7Tu;a6[R"[ ["5 [%U65TuU7'SSS5 GMCU0RRS-5(dGMfU0Rn#[7U#RS.S55n8[7U#RS/S.U#;aSOS55n9[7U#RS0U955n9U'SS1V(s/sH!n([7U#RS2U(-S55PM# n:n([7[.R<"U:U)SS155n;U0GHnU"U>5 U>URURY5 URU[-U*535 U*SUn*O\U[-U*5:aM[ 5R?U<S?U[-U*5- S@35 U*RWS/U[-U*5- -5 [}U)U'5SnDWAR~[UD[-UAR~5*S5:waQ[ 5R?U<SAWAR~SB[WD[-UAR~5*S5SC35 A*G M1WARdRHRUA0nE[9U*5GHun1nFUFcM WFRdRHnGUGRWE;aWFRbUF:waWGRfnBUB(aWGRi5 WFRdRZRkUFRl5 UFRdRZUFRlnFUFU*U1'WB(aWGRY5 [o[pWF5WEWGR'WFRbUF:wdGMWEWGRWFl1GM 0nHSDU';aU)U'RmSD5OSnISEU';aU)U'RmSE5OSnJS&U';aU)U'RmS&5OSnKU&RSF5nLULb"WIS:a[%WL5nMUMS:a SGWIWM-4WHSD'WJS:ai[-Tu5WJ:XaZ[aUu4SHj[]WJ555(a7[.R"[]WJ5VNs/sHnNTuUNPM snN5WHSE'O6U&RSI5nOUOb"WJS:a[%WO5nPUPS:a SGWJWP-4WHSE'[-U/5WK:Xa2[-[U/55WK:Xa[.R"U/5WHS&'Oi[-U.5WK:Xa2[-[U.55WK:Xa[.R"U.5WHS&'O([-U-5WK:Xa[.R"U-5WHS&'U&RSJ5nQUQb6[%WQ5nRU)U'RmSK5nSURS:aWSS:a SGWSWR-4WHSK'U&RSL5nTUTb6[%WT5nUU)U'RmSM5nVUUS:aWVS:a SGWVWU-4WHSM'0nWU&RSN5nXUXbiWARb\[R"[ ["5 [7WX5WARRSO-:wa[7WX5WWSP'SSS5 U b U S:aU WWSQ'SnYU&RSJ5nZU&RSL5n[UZbW[b[%WZ5nR[%W[5nU[RU&RSRSS5RC5ST5n\[RU&RSUSS5RC5ST5n]WRU\-n^WUU]-n_U^S:aUW_S:aOSVSVSW.nYW\ST:waSKWH;aSG[%WHSKS5W\-4UHSK'W]ST:waSMWH;aSG[%WHSMS5W]-4UHSM'U&RSXSS5n`SDWH;aM[RW`RC5ST5naWYc0nYSVWYSD'WaST:waSG[%WHSDS5Wa-4UHSD'U&RSYSZ5nbSEWH;a)Wb(a"WYc0nYSZS[S\S]S^S_S`Sa.RWbUb5WYSE'U R;U5 U R;[U*U)WARU'UU$WCSbWHWWWYSc9 5 A*GMk GMQ U S:a [ 5R?U<S6U Sd35 [XS#Se9GHuncnUU ;aM[WcR~5n)UcRn'U UR5HununnU'RmU5n1U)U1U:XaU'RUUS5n'M8U)U1U-S:Xa:U)U1==U-ss'U)RU1S-U5 U'RUUU-S5n'M~[ 5R?U<SfUSgUShU)U135 M [U)5WclNU'UclOGM U (Ga[SiSj9ndU GHncUcRbnAUARr(dM#[-WARr5ne[]Ue5Vfs/sHnf/PM ngnfS/We-nhWcGHmnFUFcWgHniUiR;S5 M M#WFRrcWgHniUiR;S5 M MLWFRdRHnGWdRiUG5 []We5HnjWFRrUjSO:aWgWjR;S5 M,WGRWFRrWj5 UFRbUF:Xa1WhWjc+[qWFRdUFRlWjS-45n@U@WhUj'O:WhWjc Skn2[U25e[WFRdUFRlWjS-4WhUjSl9n@WgWjR;W@5 M WdRYWG5 GMp WcRnkUcRbRnlUcRbRnm[9Wg5GHunjn*[aSmU*55(a&[ 5R?U<SnWjS-So35 GOlWhWjnnUncSpWjS-3n2[U25e[WcR~5n)UcRn'[9U'5H4un1n(U(SK:XaWnRU)U1'MU(SM:XdM%WnRU)U1'M6 0noSnp0nqWkbWlS:aWmS:a}WlWnR- nrWmUnR- nsSVSVSW.npSGUnRWkS-Ur-4WqSK'SGUnRUkS-Us-4UqSM'WcRRSQ5ntUtbWtWr- WoSQ'WcRR;[U*[U)5WnRU'USqWjS-3SbWo=(d SWq=(d SWpSr9 5 GM WcR(aGMSsWclAGM WdR5 [-U 5S:H=(a U (+UlZU $!URa+n[ 5R U<SU<S35 SnAgSnAff=f!,(df  GM=fs snfs sn(fs sn(n1f!,(df  GNo=f!,(df  GN+=f!,(df  GN=fs sn(f![ a-n[ 5R?U<S3U<S35 SnAGMSnAff=f![R[T[ 4anU S:Xa&[ 5R?U<S6U=<S7U<SS835 U S- n U9(aU9nOUS:XaS9n2[!U25UeU*RWS/UU;-[-U*5- -5 SnA GMSnAff=f![^a,n[ 5R?U<S:U<S35 SnAGNSnAff=f![^a-n[ 5R?U<S:U<S35 SnAGM(SnAff=f![ ["4a G Nf=fs snNf![ ["4a G N6f=f![ ["4a G NYf=f![ ["4a G N&f=f!,(df  G N=f![ ["4a SG=nRnUG Nf=fs snff!WdRYWG5 f=f)uz(Return image series in OME-TIFF file(s).r ElementTreeNz OME series raised r_rKcSURlSURlURRS5 URR S5 g)NTr)rrrlrr)atifs rv load_pagesseries_ome..load_pages~Hs> #  " rur F Instrumentrr NominalMagnification BinaryOnlyz4 OME series is BinaryOnly, not an OME-TIFF root filer r r=r Alongr r3StartSteprYEndLabelr AnnotationRefObjectiveSettingsr r r r Tr r rz2OME series cannot handle differing SamplesPerPixelrW rY r r@ TheTTiffDatar NumPlanes PlaneCountryFirstz4 OME series contains invalid TiffData index, raised FileNamerxz OME series failed to read rz. Missing data are zeroedz*OME series missing NumPlanes or PlaneCountz0 OME series contains index out of range, raised c3(# UHoSLv M g7fryrtrs rvrseries_ome..nIs7$QDy$rSz OME series expected z frames, got z OME series is missing z frames. Missing data are zeroedz1 OME series cannot handle discontiguous storage (rrzr rr rj c3,># UH oT;v M g7fryrt)rr. plane_deltass rvrrIs@ rrrrreversedrrrrG rmtextrrrrrDrrrEr]r^rrrrr4rlrrrrDrrr_rrprrkr@rrrr~rrr!rrr*rrrMrr`rrrrrr\rarrrOrPr&rr r7)vrrwrryrrrz root_uuidrGrV r modulorefr r objectiveselementrobj_idrannotrrO modulo_nsalongr newaxisrrrrlabelr image_magnificationchildobj_refrrpixels pixels_attribrrrrsppr channel_namesexcitation_wavelengthsemission_wavelengthsrrrch_nameewxwdelta_tthe_t ifd_indexr idxsidxr rftifrrrisclosedr r keyframesrrlrsizezsizetr pszpsz_fr.titi_fpsxpsx_frlpsypsy_frmrsbitsr psx_valpsy_valxuyumpp_xmpp_ypsz_unitzuti_unitaseries filecache num_levelsr levels_pageslevels_keyframes level_pagesrbase_mpprprqlevel_keyframe level_attrs level_units level_coordsr^r_base_magrsv @rvr r kHs&   F ~%%f-D sO 'I!CJggooGMLI46F#%F#%J ;;   - -77##K00 ZZ^^D1F**..)?@Cv#/'00YG16sJv.HG  ;;   - - HNN'MN   ;;   7 8 8 ||'' R8AA(KK355u||D)*S"E%* %.E#(99Sb>#:#:7#C#C (#(99R=D&+ll&6&6vw&GG&*oog&>G&%,,6',U\\-=-=fa-H'I(-ell7.C(D',U\\%-@'AD'H),U\\%t-L)M),6;%&5:E+099+=+=g+F).5:%&*"*1&(9CI'&/&+# !6{{##G,, Eyy!!/22 % T 2  !M-1Eyy!!"566,,**40w*4*4W*=' ~~xxF::&&x00==D M778D)9$:;>#9#9&0 0#+ " Wh ?&)$D't,215 499- JJtyy177E "0c%j TFdSj3t9.D$EF!&tA,1)a-,@DqM"-G!L IIE "0c%j TFdSj3t9.D$EF!&tA,1)a-,@DqM"-IX37$777?scll':"H (oFAs#&::#8#8#?#?#JJ11668 ((55cii@#'$JJ,,SYY7$#+Q#$OO66<<>. # I33::8 $I Qw((A-LL%CKD;eCRj;#;bc ;E9s?T"#Y6D$ Q wu~6:Dc$i  g24&9t9+'ET{D !  g4c$i'((HJ TFdSY&678#E403H~~xX^^1D0D0F'G!HH  g 'tXs8>>':&:&<=>?qB **//.I%T?4<[[++77)+}},#%99#GGI ))66tzzB#{{00<"&Q#HHJ)-h)=Ibgg&==D($-bgg$6DM#+(&(F.1TkE$**S/*qE.1TkE$**S/*qE.1TkE$**S/*qE##O4C519!#JEqy'*EEM&:s   %.@5<@@@#kk.3El;l\!_l;s #&&7>eai$Ry!8+. *=F3K()U2012e;#kk*>?s *+u4234=#kk*@As ]#u,#kk-8s ##O4C!#JE!$**S/2EqyUQY'*EEM&:s  ##O4C!#JE!$**S/2EqyUQY'*EEM&:s %'E!%%&78E X^^%?((Y?5zX^^%<%&Cu '#F,2& G''H##X--.J!*-E-q- E8%>!" *Q.M #'*!%%>!$'1o3 > KK$*s4y2H(IJ!/"@&(("g&&&)\D\3&(("g&&&)\D\3d#I.<' 2*#I.#I.@?,#I.($''EE(xEhOOB'sAd/Ae $Ae1AeAe Ae Ae# 6Ae5 Af (Af 0#Af AAg*AAi0AAj)Ak# Ak: Ak?B5AlC%5Al-E5AmGAmT4 Am1V>C(Am6dAd=d!Ad8d8Ad=e Ae e# Ae2 e5 Af f Af f Ag f(!Ag gAg gAi- g-A3Ai( i(Ai- i0 Aj& i:!Aj! j!Aj& j) Ak j3!Ak kAk k#Ak7k6Ak7k?AllAllAl*l)Al*l-AmmAmm Am mAm.m-Am.m6An c URnUcgURnSUlURS5 URRnUR SS5R 5nUR SS5nUR SS5nUR S S5nUR S S5nUS:dUS:d US:dUS:a[5RU<S 35 gUS:Xd&URSS:aURSU:XaXV-nO%XU-:XaURS U:XaSnOXV-U-nUS:XaUR(a [U5nXR-n UR(dS n OURSU -URR :a[5R#U<S 35 gUS::aSn O9UR(a&URSU -USR$:aS n OSn U (aU/OUSSn U==S:XaO =S:XaO O Sn XVU4n Ok=S:Xa Sn XeU4n O]=S:Xa Sn XWU4n OO=S:Xa Sn XuU4n OA=S:Xa Sn XgU4n O3S:XaSn XvU4n O'Sn XVU4n [5RU<SU<35 U['U 5-nUS:a([5R)U<S35 U/U Q7n SU -n URSS:a/U SS:XdeU SSUR*-n XR,SS- n OXR*- n XR,- n SU ;a U S - n U S- n U =(a' UR(+=(a URU :gn0nUR S!S5nUR S"S5nUR S#S5nUR S$5n[/U[0[245(aEUS:a?US:a9[/U[0[245(a[3U5*U-OS%nUUUU--4US&'UR S'5n[/U[0[245(aUS::a7UR S(5n[/U[0[245(a US:aS)U- n[/U[0[245(aUS:aUS:a S%UU-4US*'UR S+5n[/U[45(a([U5U:Xa[6R8"U5US'[/U[0[245(aU(d"[/U[0[245(aU(aS,UR:;aUR=5unnU(aUUS:aOUR*UR,R?S-5nUS:a!S)U- n[3U5*U-nUUUU--4US-'U(aUUS:aOUR*UR,R?S.5nUS:a!S)U- n[3U5*U-n U U UU--4US.'0n!Sn"UR S/S05n#[/U#[@5(aU#(a[BR U#R 55n$U$bS1OU#n%U$bzU$S):watS2Hnn&UR U&5n'U'cM[/U'[D5(a$[U'5S3:XaU'SU$-U'SU$-4UU&'MR[6RF"U'5U$-UU&'Mp U%U%S4.n"S&U;aU%U"S&'UR S55n([/U([@5(a U((aU(U!S5'SUl$[KU U URLU S6UUU!U"S79 /$)8z#Return image series in ImageJ file.NTrr cztrrrYrJ r rez1 ImageJ series metadata invalid or corrupted filerFrr2 ctzZTCzctTCZztcCTZtczZCTtzcr? z ImageJ series of unknown order z. ImageJ series contains unidentified dimensionr rKrrSrxoriginyoriginzoriginspacingrj r fintervalfpsrrrrrrrpixelr r rTrYrr)rrrrr )'rrrlrrrSrr7rmrrjrrrrrrrrr@r$rrrrrYrMrrrrrrzr*r~rr7rr))rrHrrr rrrJ r rer isvirtual page_listrrremainrrrrrrz0rfps_valrxresyresrX pixel_widthx0r pixel_heighty0rr rrunit_outrr rs) rvrrJs    D | IIEEO q 99??D HHWe $ * * ,E XXh "F XXh "Fxx A&H XXh "F zVaZ6A:AgF G 1}Q!+ A(0J F? "t{{1~'A8+ {u))U kk !F ==  ! v %(;(; ;gF G  1    0 0 3f s E#'E 88FG $D$ $**,'#(#4<$  #%jjn?!#u--#c(a-&)!func!fun%Er %*]]3%7%%?r &X. &=!E#J 88F D$f CN   JJ    ruc [U5nUcgURnUcU$URRn0n0n0nSSSSSSSS S S . n[ UR S S 55n[ UR SS55n U S:Xa*UR SS5R5=(d Sn OUR U 5n U(aU (a[ UR SS55=(d Sn [R U R55n U bSOU n [R"SURU- U =(d S-URSS9US'[R"SURU -U- U =(d S-URSS9US'XS'XS'[ UR SS 55nU(aSU(aHU (aA[R U R55n X- U =(d S-US'U bSOU US'OXS'[ UR SS 55nU(a XS'SUS 'U(aUSRRU5 S!USlUSR"RU5 USR$RU5 USR&RU5 U$)"z&Return image series in NIH Image file.Nrr r"r&r( kilometerinchfootmile) rrYrTrrrrrrPrrj rr;rrr=rrrFr rrr slice_spacingr rframe_intervalrrr)r rrrrYrSrrcr*rrrrOrPr r rrr r&)rrrHrrrr nih_unitsxscaleunits_idunit_straspectrrrrs rvrrKs C F ~   D | 99??DFEE          !I488Hc* +F488Iq)*H2~#xx4::<D==* (txx 2C89@S (..*+#(#4<(nn OOf $  5 OO  s nn   v % .%,3 ?     s c c $((>378M hIIhnn./E%2%;u|%LE/ ").):E#J%2/ "488OS9:N"0c  q &F1IN 1IV$ 1I%%f- 1IE" Mruc URnUcgURRSS9nUSSSS2nSRSU55n[ SU55n0n0nUGH:nUuppn [ R RU R5S 5nUS ;dM@U S :dMHX;dMO[U [5(aU (a[RU R55n[U 5U=(d S -[U 5[U 5[U 5--U=(d S -4Xn'UbS X~'MUS:XaSSSSSSSS.RX5X~'GMXU'GM [U 5[U 5[U 5[U 5--4Xn'GM= 0nSUl[UUUS R UU=(d SU=(d SU=(d SUSSS9 /$)z%Return image series in FluoView file.NFrrrKr=c3# UH6n[RRUSR5S5v M8 g7f)rr/ N)rrrSrNrs rvr"series_fluoview..Ls0Kd4%%))!A$**,<Ac3># UHn[US5v M g7frrrs rvrrLs*T#ad))Tsr/ >rrrr rrr rrrrrrrrrTr8r)rrr rr)rrrrr~rrrSrNrrzr*rrYr7rr)rrHrmmhdrrrr r6 rroriginrrr rrs rvrrLs  D | II    .E  dd #D 77KdK KD *T* *E FE),&F$!!%%djjlC8 ' 'D1H$$$ $**,/&MU\c26]U4[5;%>>|%  $".EKS[%+,*'#"#c$oK#'$K&M&ME$K%+$==  5<ECN   !HNN >T-4-4k"   ruc  URnUcgURRnUSnURSS5nU/URQ7n0n0n0nURS5n US:GaHU GbD[ R "U S:g5(Ga%SUR-n URS 5n [U [5(aU R5S ;a[RU R55n [ R"S /[ R"U SS 5/5R[ R5U =(d S -US'U bSOU US'GO[ R"S /[ R"U SS 5/5R[ R5US'OUS:a[ R "[ R "US5S:g5(ahSUR-n URS5n U bDXS- [ R""SS5- R[ R5US'SUS'OSUR-n URS5nUb[%U5U:Xa[ R&"U[ RS9nUSS :wa2[ R "XS:H5(a[)US5US'O"[ R "US :H5(dXS'URS 5n [U [5=(a U R5S ;nU(a#[RU R55OSn URS5nURS5nURSS5(amU(af[)U5S:waW[ R*"S[)U5UR,-U =(d S -UR,SS9US'U(a U bSOU US'URSS5(amU(af[)U5S:waW[ R*"S[)U5UR.-U =(d S -UR.SS9US'U(a U bSOU US'S Ul[3U/UUR4U U=(d SU=(d SU=(d SUUS:S!S"9 /$)#z Return image series in STK file.Nrr r=rrYrr r>r=rrrj rKrr rrDatetimeCreatedrrr  Wavelengthsrzr wavelengthsrrrFr rrTr)rrr rrr)rrrrSrrrlrrrzrr* concatenatecumsumr,r r timedelta64rrrYrrOrPr7rr)rrHrr rrrrr zdistr cal_unitsrdatetime_createdrwl is_physicalxcalycals rvrrKLs#   D | 99??D . !F 88FB D  !djj !EFEE HH[ !E ze'EIIeqj,A,ATYYHH/0 i % %)//*;D + IIioo/0E++ U3BZ01fU]]#u|5F3K*/): E#J++ U3BZ01fU]]# 3K ! %**T--@"AQ"FGGTYY88$56  '!Q$77##As+,fU]]# 3K"E#JTYY((=)K3{#3v#= ]];emm < a5CT-4-4qj   ruc :^URnUcgSURlURRS5 URRnUSS;aP[ R "[ R5nUSSUSS- mUSS:Xa SU4S jjnO&SU4S jjnOUR ceUR nSn0nURS 5nU(aXeS 'SUl [U/URUURU=(d SUS S9/$)z#Return image series in MD Gel file.NFrFileTag>rTr ScalePixelrYrTcN>UR[R5S-T-$)NrTr,rrr rs rvr series_mdgel..transformLs xx .!3e;;rucH>UR[R5T-$ryr%r&s rvr r'Lsxx .66ru FileUnits file_unitsr)rr r)r rr6r) rrrlrrrrrrSr7rrr)rrHrrr rr*rs @rvrrLs   D |CIIII1 99??D I(" EMM*\"1%\(:1(==  ?a  < <  7 7zz%%%  E+&J(lCN F JJ  II-4   ruc /nURRnURS:Xaz[UR5S:agUR [ U/UR URURSSS95 SUl URSR5nURS;a+[5RU<S UR35 U$S URl URRUR5 URR![#URS5SS 9n[U5S:XaUR nURnO([U5/UR Q7nS UR-nU(dS Ul 0nUR$nUb5S H/nX;dM ['Xx[([*45(dM)XxXh'M1 [ UUURUSSU=(d SS9n U /UQ$)z Return image series in EER file.rYrTN integratedrrrFriz) EER series with unsupported compression Trr ) exposureTime meanDoseRate totalDoserr)rrr)rrrrrrrrrr7r6r7rmrlrrrrrrrrY) rrrrrrrrHrrrs rvrrLs#%F 99??D 1 syy>A     !   yy|""$ 44g77;7G7G6H J  CIIII4::& II  uTZZ6  GE 5zQ yyU)djj)TYY E   D @C{z$)c5\BB!Y A     mtF  V ruc URRSS9nURRnSnURnUc0OUR S05nSU;a`USn[ U5nSn[US5nUc[[ U5X--S5nXxU/URQ7nS UR-n Uc([ U5/URQ7nS UR-n 0n 0n U(GaUR S S5nUS:a"SW ;aX;R#S5nSX-4U S'UR S5n[%U[[&45(aUS::aUR SS5nUS:a#SW ;aX;R#S5nSUU-4U S'UR S5n[%U[[&45(a US:aUU S'UR S5n[%U[(5(a[ U5S:Xar[+SU55(a[[-USSUSS- 5n[-USSUSS- 5nUS:a SW ;aSU4U S'US:a SW ;aSU4U S'SUl[3UUUR4W SU =(d SU =(d SS9/$![ a SnGNLf=f![[[4a<n Sn[ U5U-(aSn [U 5U e[ U5U-nSn A GNSn A ff=f![a,n [5R!U<S U <S 35 Sn A GNSn A ff=f![ [.4a Nf=f)z&Return image series in ScanImage file.FrNrzSI.hChannels.channelSaverYzSI.hStackManager.framesPerSlicez"unable to determine framesPerSlicerz ScanImage series raised r_r zSI.hRoiManager.scanFramePeriodrj rrz%SI.hStackManager.actualStackZStepSizezSI.hStackManager.stackZStepSizer zSI.objectiveResolutionobjectiveResolutionzSI.hRoiManager.imagingFovUmrc3l# UH*n[U[5=(a [U5S:Hv M, g7fr= )rrMr)rrs rvr#series_scanimage..NMs'EAJq$'7CFaK7s24rrrTr)rrr)rrrrrSrrrr OverflowErrorrrkrrrr7rmrrrYrMrlr- r4r7rr)rrrrrHrr rJ rrrrrrrperiodrzsteproresfovx_extenty_extents rvrrMsu II    .E 99??D E  ! !Dlb(AI!Y. N !;BX; ;E499$D }U)djj)TYY FE?E A:#+**S/*E/F3K EF%#u..%1*MM"CSIE 19**S/*E .F3K}}56 dS%L ) )dQh+/E' (mm9: sD ! !CA EEEE s1vay3q6!945s1vay3q6!945aT-4   y   mZ8 0u:(>C$S/s2Ux/  0 N H  w&?|d|L M M NRz*  syL" J*-L0J=>=LAM * J:6L9J::L=L1L L LL M!MM MMc  ^URmTcg[RRTS5nUc$[ 5R U<STS<35 gUR RnURS:Xa#URSS5RSS5nO3URS :XaO"URS:XaURSS5nTRS S 5S :aS U-nTRS S 5S :aSU-n[U4SjU55nTRSS5nUR R[S SS 5SS9nUS Rn0n0n0n TRSS5n TRSS5n TRSS5n U S :a4XS'SU;a*SX1RS5U -[ S-4US'SU S'U S :a4XS'SU;a*SX1RS5U -[ S-4US'SU S'U S :a;XS'SU;a1X1RS5n U S:aSX-[ S-4US'SU S'SU;aX1RS5nTRS5n[#U[$R&5(a [)U5U:XaUS:a XS - US'O(TRSS5nUS :aUS:a SUU-4US'TRS5nSU;GaX1RS5nTRS5nTRS 5(ai[#U[$R&5(aJUR*US 4:Xa8[$R,"US :5(aUSS2S 4USS2S4-S!- US'OlUbiURS"5n[#U[.5(aC[)U5U:Xa4[$R0"UVs/sHn[3U5PM sn5US'[9UUUUUS#UUU =(d SS$9 /n[;[<UR S5nUR>(aUR R[SSS 5SS9nURnSnS nU[)U5:aBU[)U5S - :a0UUU-nUS- nU[)U5:aU[)U5S - :aM0USUUR*-nUSUUR@-nURC[9XSXaUS#S%95 SUl"U$s snf![4[64a [$R0"U5US'GNHf=f)&z Return image series in LSM file.Nrrz LSM unknown ScanType rYrr=rXCrTrrr, rr)c3b># UH$n[T[RU5v M& g7fry)rrr)rrlsmis rvrseries_lsm..}Ms)IDq#d455a89::Ds,/r Frrkrj rmrnr-r rr rrrzrrrtg@ ColorNamesrrrrrr r-)#rrrrSr7rmrrrrrr~rrrrr*rrr8rrrlrMrrYrrrr_rrrrr7)rrrrrrrrrr vsxvsyvszrr timestampsrccr cwrrrrcprr?s @rvr r hMs)   D |  # # ' 'Z(8 9D |C7"8j9I8LMN IIOOE Q||C$,,S$7   q    ! #||C$ xx a 1$Tz xx a 1$Tz IDI IE 88FB D II  uQa05  AE !HNNE FEE ((< %C ((< %C ((< %C Qw!l $;jjo 6 5"'++.GAuQx.G"HF3K     -4  F #))A, 'D  ""5D!#4u"E   3u:o!c%j1n"4 %(NB FA3u:o!c%j1n"4bq DJJ&BQx$))# 54e L CN ME/H"I.5"'++e"4F3K5s$T-2T( T-(T--)UUc . ^^ ^!^"^#^$^%URnUb SU;dSU;agUSm%USnX"SS2S4R5nST%;dST%;ag[R"USS2SS24SS9S -R 5m!SS S S S .mT%R S S5(aSOSnUT%R SS5(aSOS- nSSSSS.m"[ UU!U"U%4SjU55m$[T$5n[ U4SjU55m S6U U#U$4SjjnXBRS:nU(aURR(d7[5RU<SURR<35 SnOSUR;a [5RU<S35 SnOiST%;aET%SnURRU5(d[5RU<S35 SnOURR!S5SnU(a["R$R'URR(WS -5n[*R*"U5n [-U 5S :XaSnOS/U-m#U"X5n U Hn UR["R$R/U 5:XaM2[1U 5n [3U RS15SnX"SS2S4R5nX"X5- n SSS5 M U(aGO XBRS:aT$n [R4"USS2SS24SS9n[R"USS2SS24SS9nUR75nUSS2SS24==U-ss'[ S![9UR 5UR 5SS"955m$[ U$4S#jT 55m$[T$5nS/U-m#U"X5n [5RU<S$T$<S%U <35 OS/U-m#U"X5n W U:wa"[5RU<S&XJ- S'35 UR:R<nUUR>-nT$UR-n0n0nSnT%R S(S)5nUS:aRUUS('S*S*S+.nS,U;aUURAS,5nS)UU-4US,'S-U;aUURAS-5nS)UU-4US-'S.U;a?T%R S/S)5nUS:wa'UURAS.5nS)U[CU5-4US.'S0U;a6T%R S1S)5nUS:aUURAS05nS)UU-4US0'S2U;abT%R S35nUURAS25n[EU[F5(a([-U5U:Xa[RH"U5US2'[KT#UURLUUS4U=(d SU=(d SUUS59 /$!,(df  GM=f)7z3Return image series in Micro-Manager stack file(s).NrMrNrMicroManagerVersionFramesrrrYrTr)rr rr- TimeFirstTTRRT SlicesFirstZCCZChannelsSlicesr)rr r- rc 3># UH3n[TTU[TRTUS555v M5 g7fr)rkrrS)rrindexmap_indexindexmap_shaper* summarys rvr!series_mmstack..NsJ B >"- .  DHa( )  s;>c3.># UH nTUv M g7fryrt)rrrVs rvrrY Ns=">"-r c >SnUSS2S4R5n[R"USS2T 4RT5R5nURR nUR RURS- S- n[XCSS9H`nUupXR:Xa UT U'US- nM"SU s=:aU::aO OU S-4n URn US- nOS=pSn [UUU U U US9T U'Mb U$) NrrTr4rYrr) rrrG rrrrrrrrr)ryindexmap page_countrrrrrrrrrindexmap_orderrrs rvadd_file series_mmstack..add_file Ns 1a4.''))) Q& ' ) )5 &( ::##??''(*A*A!*DDsJ6D ME('e a 6%X%%|o !)!8!8a 043 $'-! E%L7,ruz/ MMStack multi-file series cannot be read from F_MMStackz MMStack file name is invalidPrefixz _MMStack*.tifc34# UHupX!- S-v M g7frrtr1s rvrrYbNs#  EAIr4c3.># UH nTUv M g7fryrtrrrs rvrrYhNs71eAhr z3 MMStack series is missing files. Returning subset z of z MMStack is missing z pages. Missing data are zeroed PixelSize_umrj r rYrrr z-step_umr Interval_msrChNamesr) rrrrrrrr r )ryrr]rr6r)'rCargsortrrkrrSr~r@rrrDr7rmr#rrrrrErrGrrbasenamerrCrrdrrrrrr- rrMrrr)&rsettingsr]rrr`r prefixr filenamesr^rr old_shape min_index max_indexr full_axes full_shaperrr pxsizerlrmr7rintervalrch_namesr rVr_rWr* rrrXs& @@@@@@@rvr r Ms ((H H $ X % y!G #HA..01HG+xw/FiiBQBa81<DDFN1115N;;{D114tDGKK t44D$>D     D    E 5>D===N""H~~a((I~~%% H  'H>>%%(* I s|| + H  w&CD EI  X&F<<**622  C7*G!HI! \\'' 3A6F'',, NN " "F_$< IIg& y>Q IFTME!#0J%<<277#3#3H#==h'49*   "H (A(>(>(@AH(4"::J ('& q! ! IIhq"1"uoA6 IIhq"1"uoA6 ==?BQB9$   "I$4$4$6t   777u~ c, g %yYM ;  c, Tg)$*;)<=' ' yyHx}}$I'J FE#'E [[ -F z &n"6 ) ys34E/F3K ) ys34E/F3K i K- A:ys34EE 23F3K i;;}c2 a<ys34E 01F3K i;;y)9??3/0 h % %#h-5*@++h/F3K  ..>T-4   _('s >X X c^^7^8^9^:URR(d5[5RU<SURR<35 g[ R RURRS5n[ R RU5(d[5RU<S35 g0nSnSSSSS S S S .n0n0nS n[U5GHu m7nn n n n n nnnX;aUS- nX(n[URUSUU 4URS9nURSSX4:wa!SURSSSX43n[U5eU S:waSU <S3n[U5eUR S:waSUR <3n[U5eX;aSU 3n[U5eXLunnUR"U:waSUR"SU3n[U5eOSnXR$:XaUR&R(nO\[+[ R RURRU55nUR&R(nSSS5 WX('U(aYT7R-5H)unn[/U[05(dMUS0UU'ST7U'M+ Sn[3T7R555m8OjU(acUR-5HOunnT7Un[/U[05(deUU;a[7UR955S-UU'UUT7U'MQ [3T7R555T8:waV[3T7R555n[5RU<SUST835 [;U5[;T85:waGMUU[3U74SjT855'GM [<R>"[AUR555[<RBS9n[<RD"USS9RG5m9[<R6"USS9RG5n[3S[IT9US S955m:[KUSS9n[3U:4S jU55m:[3U84S!jU55m8UR-5V^Vs0sHumn[3UU94S"jU55U_M nnn[<RL"T:5Vs/sHnUROU5PM n nU(d[5RQU<S#35 g[S[UUR9555nT:UR- m:S$RS%T855n!U!URV- n!U!S[YT85n"0n#[IT8U"S S9Hmun$n%U$U;dMUU$n&[7U&R955S-n'S$/U'-n(U&R-5H un)mU)U(T'M [<R>"U(5U#U%'Mo 0n*Sn+URZn,U,GbbU,ROS&05n-U-ROS'S(5n.U.S:aRU.U*S''S)S)S*.n+S+U!;aT:U!R]S+5n/S(U/U.-4U#S+'S,U!;aT:U!R]S,5n0S(U0U.-4U#S,'S-U!;a6U-ROS.S(5n1U1S:aT:U!R]S-5n2S(U2U1-4U#S-'S/U!;a6U-ROS0S(5n3U3S:aT:U!R]S/5n4S(U4U3-4U#S/'S1U!;ahS1U#;abU-ROS25n5T:U!R]S15n6[/U5[@5(a([YU55U6:Xa[<R>"U55U#S1'S Ul/[aU T:UR"U!U#=(d SU*=(d SU+US3[YU5S:S49 /$!,(df  GNm=fs snnfs snf)5z,Return image series in NDTiff v2/v3 file(s).z NDTiff.index not found for NrBz NDTiff.index not foundr)rPrP)rr)rr)rr)rr )rr>)rrYrTrrrrTrYrrTz'NDTiff.index does not match TIFF shape rzNDTiff.index compression=r^z2NDTiff.index does not match TIFF page.compression=z NDTiff.index unknown pixel type z1NDTiff.index pixeltype does not match TIFF dtype Fz NDTiff.index axes_dict.keys=c3@># UHn[TU5v M g7fryr)rr6 axes_dicts rvr series_ndtiff..%Os:Tcc)C.))TrD rzrc34# UHupX!- S-v M g7frrtr1s rvrr|+OsO(N!%!)(Nrer4rc3.># UH nTUv M g7fryrtrgs rvrr|/Os*Eq%(Er c3.># UH nTUv M g7fryrtrrrs rvrr|0Os(%Qa%r c3:># UHnTUTU- v M g7fryrt)rrrrrs rvrr|2Os 3Uc!fy|#Usz NDTiff.index has no keyframesr=c3~# UH3n[RRUR5S5v M5 g7f)r/ N)rr> rSrrs rvrr|?Os*E14??&&qwwy#66s;=rMrhrj r rYrrr rirrjrrkr) rrrrrr rrr )1rrDr7rmr#rrErrGrFrDrrrrrrrrrrrr`rrzr~r* rkrr!rrrMr rrr order_axesr rSrrrrrrCrr7r);r indexfilerr pixel_typesrrrrrrXr pixeltyper _metaoffset_metabytecount_metacompressionrrrrrrr rrdims_ indices_arrayrsr rrOrrdim_axesrr6 rmappingrrrrr r!summrvrlrmr7rrwrrxr r{rrrrs; ` @@@@rvrrNs >> ! !g1#..2D2D1G H  S^^33^DI 77>>) $ $C7"9:;%'II       K<>G,.J E 9 %    NI *H!'M'66 Dzz"1~&0=zz"1~&dF?*;=!o%a2k^>B o%1$K$:J:J9NO o%+8 D o%"-HE1zzU"Gzzl$ug/!o% #I<<'yyGGLL!7!7B::++D#'I  (0 eeS))(-qzJt$&'IdO 1E)*D  * 0 0 2 f!$!%----&$' $81$B:T::;Q &VKKW\\^ 4EKKHM -a0779I -a0779I OIy(NO OE }e 4E *E* *E (%( (D"--/)JC  3U 33U:)  %*MM%$80$8S C$8 0 # >?@D))+,-H X^^E 77EE EDHMMDKc$i HFtXd3R *  oGw~~'(1,D!#t F%mmo s#s .V,F2J4E#'E " "B ~vvi$.#. A:$*E. !&\:Ed{djjo."EFN3s d{djjo."EFN3s  $;HH[#.Eqydjjo."EEM2s  $;xx s3H!|djjo."EH$45s  $;3f,xx *H$**S/*E(D))c(mu.D#kk(3s CN ..>T-4)nq(   eV 0s_2$_!1_' _ c URnUcgURRSS9nURRnSU;a+SU;a%USUR-nUSUR -nO([ U5/URQ7nSUR -nSUl0n0n0n[URSS 55n [URS S 55n U (a+S U;a%U [S -n S URU -4US 'S US 'U (a+SU;a%U [S -n S URU -4US'S US'SU;aURS05n U RSS5nURS05RS5nXERS5nUb3[ U5U:Xa$UR[5US'U(aXS'Og[U RSS 55n[U RSS 55nU(a*U[R "U5U--US'U(aXS'SU;acURS05RS5nXERS5nUb,[ U5U:XaUR[5US'SUS'SU;aURS5nXERS5nU(aZ[ U5U:XaKUVs/sHnURSS5PM nn[#U5(a[R$"U5US'URS5nU(a[U5US'URS5nUbUR'5US'URSS5=(d Sn[)UUUR*UUS U=(d SU=(d SU=(d SS!9 /$s snf)"z(Return image series in Olympus SIS file.NFrrrr T pixelsizexrj pixelsizeyrr-r rr rUnitZr=rJStepZ StartPosZrrTimePosrrBandBandNamerrUrrrB)rrrrrrrr7rYrSr*rOrPrr,rrr;rrrr)rrHrrrrrrr rrmppxmppyrunit_zz_posnzstep_zstart_ztime_posntbandsncr band_namesrrrs rvrrOs   D | II    .E 99??D$6T>W  *F|dii'U)djj)TYYCNFEEtxx c23Jtxx c23JcTkE#J&DOOd23s !c cTkE#J&D,,t34s !c  d{xx#'2&b!%%f- ::c? #  Ur!1,,u-F3K#c 488GS12FDHH[#67G% R(86(AAs !'#J d{88FB'++I6 ::c? #  CMR$7"//%0F3K&E#J d{  ::c? # SZ2%9>?A!%% B/J?:#kk*5s HH_-M!&}!5o * B ~LLNj 88FB  '4D    JJ >T-4-4   @s(Oc [U5nU(dgUGHnSUlURSS:XaSURSS-UlUR(GaOUR R RS5=(d SUlSUR;aURSn/nURSUHon[U[5(dMUR RS 5n[U[[45(dMRUR[U5S -5 Mq [!U5U:XaV[![#U55S:a>[$R&"U5UR(S'UR*R-S5 UR.GHnUR nUR RS 5n [U [[45(aU S:aXR0S 'UR3S S9upU S:dMsU S:dM{SU - n SU - n SUR4U -4UR(S'SUR6U -4UR(S'S S S.nSUR(;a XrLaS US'XlUR*R;S5 GM GMUR R RS 5n U cGMU S:Xa SUlGMU S:XdGMSUlGM SUlU$)z+Return pyramidal image series in NDPI file.Nr@rr r rYr~rr{rrrr rrrj rrrYgMacrogMapF)rrrrr rrrrrr rrrrYrrr!rrrr r$rr&rrOrPr r r7)rrrz_sizez_valspgz_vrrrrsrtrrr s rvrrOsv C F   66!9 AGGABK'AG >>>ZZ__,,U3AzAFagg~((7F+B!"h// ggooe4%cC<88"MM%*t*;< , v;&(SV-=-A%*[[%8AIIcN&&**3/~~ii''.cC<00S1W47LL1,,,,?6b1f"HE"HE*-t/F)GEMM#&*-t/?/?%/G)HEMM#&".\BEaii'EJ%1c #(L**11*=" jjoo%%e, ?d{ UXCN Mruc [U5nU(dg[U5S:wa([5RU<S[U535 USnSUlUR SS:XaSUR SS-UlUR(aS Ul[U5S:Xa$[USSS S S 9Hup4XClSUlM URnU(GaSS K J n SnSnSn [R"[5 UR!U5n U R#S5n U b<[R"[$5 ['U 5nXrR(S'SSS5 U R#S5n U R#S5n U (aaU (aZ[R"[$5 [*R,"U SU 3S5R/5UR(S'SSS5 UR0R3SS9upUS:aUS:aSU- nSU- n SSS.UlU R#S5nU(aSUR ;a[R"[$5 ['U5nUR6UR R9S5nUS:a/US:a)SUU-US- - 4UR:S'SUR4S'SSS5 SSS5 UbpU ceSUR0R<U-4UR:S'SUR0R>U -4UR:S'UR@RCS5 UR(GaUcUGbUR0R<nUR0R>nURDSSHnUUR0R<- nUUR0R>- nUbU ceUU-nU U-nSSS.UlSUR0R<U-4UR:S'SUR0R>U-4UR:S'UR@RCS5 UcMUU- UR(S'M SUl#U$!,(df  GN6=f!,(df  GN=f!,(df  GN=f!,(df  GN=f)z*Return pyramidal image series in AVS file.Nrz# AVS series expected 3 series, got rrr r rYr)rrTr4rvObjectiveMagnificationrr AcquisitionTimerz%m.%d.%Y %H:%M:%SrUr&rr%r rYZRangerj rrF)$rrr7rmrrrr rrrrrwrrrr findtextrrYr&rhrIrrrr rrrrOrPr r rr7)rrrs2rr rwrmpp_valrrymag_textdate_strtime_strrr zrange_textzrangerrprqrratio_xratio_y level_mpp_x level_mpp_ys rvrrPs7 C F  6{ag8V F  q A AFvvayC #~~ 6{aF12J(8FHBGBGG   C )!% $"   +))#.D}}%=>H#((4$XH08HH_-5}}%67H}}%67HH((4+3+<+<#*AhZ02E,ikHHZ(522 2EJDaxD1H*d !-LA--1Ksaff}((4";/Fc!23Bzb1f+.v{b1f/E)F #(4 5-,B  $ $$!1::#8#87#BCAIIcN!1::#9#9E#ABAIIcN   % %j 1 >>>w2h6J..J**00K!"$u~~'@'@@%(B(BB& ,,,")G"3K"''/K)5L#IEL11K?*EMM#& 22[@*EMM#&**11*='4U S:a8[U 5nSSS.nSURU-4US 'SURU-4US 'URS 5n U bXS '[#U5S:XaJSUl['U/UR(UR*UR,SSU=(d SU=(d SUS9 /$USn ['U /U R(U R*U R,SSS9n UR(U/0nSnU[#U5:a[/[0X/5n U R2(aU R4(aOSU R(U;aXR(R7U 5 OU /XR('US- nU[#U5:aM[#XR(5m[9U4SjUR;555(d3[5R!U<S35 SmUHnUUSSUU'M ['XR(T/UR(Q7UR*SUR,-SSU=(d SU=(d SUS9 nURS 5nUR=5HunnUUR(:XaMUSn URU R- n0n0nSnUb2UU-nSSS.nSU RU-4US 'SU RU-4US 'UbUU- US 'UR>R7['UT/U R(Q7U R*SU R,-SSU=(d SU=(d SUS9 5 M UR7U5 UR7U 5 [AS5HnU[#U5:Xa OtX/n [U [05(deU RBS:XaSOSnUR7['U /U R(U R*U R,USS95 US- nM SUlU$![a,n [5R!U<S U <S35 Sn A GNSn A ff=f)z'Return image series in Aperio SVS file.TFrNMPPr rYrj rrAppMagrz" SVS description metadata failed: r_rYrr)rrrrr Thumbnailr-rTc3@># UHn[U5T:Hv M g7fryr )rrzsizes rvrseries_svs..Ps@us5zU"rD z% SVS series focal planes do not matchr rvr;rr)"rrrlrrrsvs_description_metadatarrSrrrYrOrPrr7rmrr7rrrrr_rr^rrrlrr`rrr)rrrrrrrr rHrrrr thumbnailrrrrorrratiorlmpprrrs @rvrrtPs F IIEEKEO q KKM KKEEF G#'E '(9(9:hhuo cC< ( (S1WCjG&\:E 0 07 :;F3K 1 1G ;> I,,00a89AI,,00a89AI,,00a89Ai..u56C' +,/j0A1,Ej)),U7^Q)?g03f qf-)*%&&'VSM* "($#!' (9(9(;!UR[U/URURURSSS95 MrURS :Xd URRS 5(a>UR[U/URURURS SS95 MS UR;a?UR[U/URURURS SS95 GM/Uc5[U/URURURS SS9nU/UQnGMgURR[U/URURURSSS95 GM [5R!U<S35 UGb&SSKJn UnSnSnSn UR&n U (a[(R*"[,5 UR/U 5n U R0S:XaU OU R3S5n U bU R5S5n U b [7U 5nU R5S5nUb [7U5nU R5S5nU R5S5nUbUb[9U5S:a [7U5n SSS5 UbuSSS.UlSUR<R>U-4UR@S'SUR<RBU-4UR@S'URDRGS5 U bvSUR;afURURRIS5nSUU -4UR@S'URDRKS5 SUR:S'UbXvRLS'URN(GaUcUGbSSjnURSSGHnU"UR<R5nUbUURLS'UbU(a|X-U- nSSS.UlSUR<R>U-4UR@S'SUR<RBU-4UR@S'URDRGS5 OUbUR<R>UR<R>- nUU- URLS'UbzUU-nSSS.UlSUR<R>U-4UR@S'SUR<RBU-4UR@S'URDRGS5 U cGM~SUR;dGMURURRIS5nSUU -4UR@S'URDRKS5 SUR:S'GM SUl(U$!,(df  GNC=f) z.Return image series in Ventana/Roche BIF file.NTFrrOverviewrr-r Probabilityrrrrvz" BIF series tiles are not stitchedrviScanrxScanResz Z-spacingzZ-layersrYr rYrj rrr rcUR5H*nURS5(dM[USS5s $ g![[4a  gf=f)Nzmag=r)rrrYrr4)rtokens rv parse_magseries_bif..parse_magfRs\)..0E''//(#(qr#331 !+J7(#'(s AAA)rrzr6r))rrrlrrr_rrrrrrrrrr7rmrrwrrrrr rrrSrYrr rrOrrPr r rr$r&r r7)rrrorrrwrrrzspacingr ryiscanrscanreszspzlayersrrr level_magrrs rvrrQs F&*H IIEEKEO q KKMHd#    & &w / / MMFJJJJII#     ,0@0@0K0K 1 1  MMFJJJJII&  D,, , MMFJJJJII"   %    H((F OO " "FJJJJII%  cx Hw@AB) !% $!% $$Y/"--c2 $G 379K$))O4C#(:#ii 2G*"'.))K0C#ii 3G#/L1,#(:#0$  ) =AH!1::#8#87#BCAIIcN!1::#9#9G#CDAIIcN   % %j 1  C166MGGAFFLL-.E!58#34AIIcN   " "3 '(AHHSM  (0HH_ % >>>w2h6J !"%enn&@&@A (4=ELL1*x$+$6$B -9 'M !NN55 A. c*  !NN66B. c*..55jA)JJ11ENN4M4MME4E*-ux/?)@EMM#&**..s3(4ELL%G&JCN Mc0/s B8Y Yc @ SSKJn /nURnSUlSUlUR S5 UR 5 URnU(dgURU5nURS5Vs/sHLnURcM[S URRS S 5R!555PMN nn[#U5S :a+[5RU<S [#U5<S35 g0n /U S'/U S'UHn [%U [&5(deU R(R+S5(aU /U S'MBU R(R+S5(aU /U S'MjU R,(dU SR/U 5 MU SR/U 5 M U R1S5n [#U 5[#U5:wa7[5RU<S[#U 5<S[#U5<35 gU SR2n U SR4n USup[7U SSUSSSS9GH<un unnU [9UU- 5-nU [9UU- 5-nU R2U R:- U:am[5R=U<SU R><SU R2<SU R:<SU<3 5 U =R2U R:S- -slOTU R2U:a=[5R=U<SU R><SU R2<SU<35 OUU lU R2nU R4U R@- U:am[5R=U<SU R><SU R4<SU R@<SU<3 5 U =R4U R@S- -slOUU lU R4nU RBSS:aUUU RDS4U l"O4U RBSS:aU RDSUU4U l"O UU4U l"/U RBSS QUPUPU RBSSQ7U l!GM? [GU S/S S!S"9/n[IU SS5H4unn USRJR/[GU /SUS-3S!S"95 M6 U RM5H*unnUHn UR/[GU /US!S"95 M M, USn[7URJUSS9HununnUS#-nUS#-nS$S$S%.Ul'S&URPR2U-4URRS''S&URPR4U-4URRS('URTRWS%5 M SUl,U$!URa+n[5RU<SU<S35 SnAgSnAff=fs snf))z1Return pyramidal image series in Philips DP file.rrvTFNz Philips series raised r_z].//*/DataObject[@ObjectType="PixelDataRepresentation"]/Attribute[@Name="DICOM_PIXEL_SPACING"]c38# UHn[U5v M g7fry)rYr s rvr!series_philips..Rs C B1eAhh Brr r=rTz# Philips series len(pixel_spacing)=z < 2LevelOtherrrz Philips series len(levels)=z != len(pixel_spacing)=rYr4z Philips series page.index=z page.imagewidth=z-page.tilewidth=z >= imagewidth=z < imagewidth=z page.imagelength=z-page.tilelength=z >= imagelength=rKrrr-rr rYrj rr)-rrwrrrlrrrsr rr7rfindallrr~rrrrrrrr^rrrOrPrroundrRrmrrSrrrrrr`r rrr r r7)rrwrrrHr relem pixel_spacing series_dictrr imagewidth0 imagelength0h0w0r+rGrOrPrrrOrrrrs rvrrRs% F IIEEKEO q KKM   D %%d+LL 6  D 99 D C 1 1#r : @ @ B CC  =A# D]1C0ETJK-/KKK$))))    & &w / /$(6K    ( ( 1 1$(6K   ' ' -  ' ' -__W %F 6{c-((g6{n4]!3 5 7 )&&K!9((L 1 FBF12J ab(9$G fq! E!b&M1 "eAFm3 ??T^^ +z 9 H  '5$**7$??$$5dnn%67-!  OOt~~1 1O __z ) H  '5$**7$??$O }6  )DO__   doo - < H  '5$**7%##%%7t&89 ."    ! 3 3 *D && ;;r?Q %z4::b>BDJ [[^a **Q-jADJ%z2DJ [[!_    [[    KHXfQi[z J KFVABZ(4q  D6%Awi H )"'') UD MM.$c J K* q AQXX}TB v1DD) = !5>>#<#>#=#=#EF c %%j1 CCN MW  ! !# 7|d|DEs$W=X>XX-!XXc  SSKJn URnU(dgURU5n[URS55VVs/sH*upVURRS[U55PM, nnn0nURS5Hn [R"[[ 5 [#U RS 5n [#U RS5n [#U RS 5n X;a0X'XU U 'SSS5 M UR$n S U lS U lU R+S5 U R-5 U(dg/nU(a[.R0"U5OSn[[3UR5555HunnUUn[3U5V s/sH oUU PM nn [7S U5S5nUcMC[9U5nUS:aUUR:UR<4nSnOUR:UR<4nSnUS:XaSOSU3n[?UUUR@UUSS9nUb3US:a-USUURBS'URDRGS5 URIU5 M U(dS Ul%gUSnUUl&SnSn[R"[N5 URPnURRn[#URT5nUS:XaUSS:a SUS- nOUS:XaUSS:aSUS- nSSS5 [R"[N5 URWS5nUb[YURS5nSSS5 UcUbURPR<n UHn!U U!RPR<- n"UbzUU"-n#SSS.U!l-SU!RPR<U#-4U!RBS'SU!RPR:U#-4U!RBS 'U!RDR]S5 UcMUU"- U!R^S!'M S Ul%U/$!URa+n[ 5R U<SU<S35 SnAgSnAff=fs snnf!,(df  GM$=fs sn f!,(df  GN=f!,(df  GNY=f)"z1Return pyramidal image series in IndicaLabs file.rrvNz Indica series raised r_r$rz./image/pixels/dimensionrrTFc3T# UHn[U[5(dMUv M g7fry)rrrs rvr series_indica..GSs <1Jq($;QQs( (rYCYXrxrrrr-rrr%rTg@z .//objectiverOr rYrj rrr)0rrwrwr rr7rrrrrSrzrrrrrrrrrlrrrrrur* rrrPrOrrrr r$rr7rrrrrrrYr r r&)$rrwrHr rrr$r levels_ifdsr6 lvchrr all_levelsc_coordslv_num channel_ifdslv_pages first_pagenchrrr lv_seriesrorrrgresrurrprrrs$ rvrrSs%   D %%d+$DIIi$899JA 63q6*9 .0K||67  : 6SZZ()BSZZ *+Bcjj'(C$"$ "%OB  7 68 IIEEKEO q KKM (*J-:u{{=)Hvk&6&6&89: 6"6* 6<\6JK6J,r*+6JK < corrupted tag list @rr_r^z: suspicious number of tags zinvalid data type z for tag #rYzinvalid value offset rz8 could not read all values for tag #rr+rrz> coercing invalid ASCII to bytes for tag #z , due to c34># UH nT"U5v M g7fryrtrs rvrread_tags..3Ts%:EqaddErrz tag #z. invalid next page offset=)rrererXrrrr]r7rrSrzrrrrrrr\rmrrrrrcrrr~r)$rlrrDtagnamesrrrgr'rCrEr&rrrerrrrrrmrrrrr valuebytesrrrrrrrOprocessrr.s$ @rv read_tagsr Sss\Q 3  #o #g- q 3  #o #g-#o #%F ]]F WWYF f+  ; (:;A>E 4< HNN;F8D--2G5  L MIwww'ggiuA-3eego!>. *D%  W E<<c$i0D "//6  <"$  :%);$\:>qA ?kI&=&GHNN/ }JtfM $:%)$/H$RE5*MEi'GGI.E5zY.((BBFIX%"3 (:;E&reUJOE)#":I.sJz $:;J&.QJ  5A: W- !LL1779E4==( d+A %%:E%: :s5zQ!!HEDJcf  d   ggj&9:1= Q;  M WW  HNNLVIN O  M g f+ j Mc g&  HNN;F8Dd%  X Mc 4 !3E9JtfMN d* % X 6 < < >-((..2V9SL4LJ&z1"H,,"!R R: !R5.R>5R::R> S= 'S88S=c[XU[RSS9SnSH?n[R"[ [ [5 [XV5XV'SSS5 MA [URS5[5(aGUSSSnUS:Xa[USSS5US'U$US :XaUSSSRS 5US'U$U$!,(df  M=f![[4a U$f=f) zRead EXIF tags from file. Post-process ExifVersion and FlashpixVersion to strings, and decode UserComment according to its character-code prefix (ASCII or UTF-16). rYrr)rr^Nr2rPsASCIIsUNICODEutf-16)r rrrrrrrr bytes2strrrSr{rr)rlrrrrDexifridcodes rvrWrWOTs RJ J1 MD2  96H I"4:.DJJ I3$((=)511m$Ra( --&/]0CAB0G&H]# K >)&*=&9!"&=&D&DX&N]# K4KJ I#N3   K s$CC", C" C "C65C6c<[XU[RSS9S$)zRead GPS tags from file.rYrr)r rrrlrrrrDs rvrXrXmT RJ q I! LLruc<[XU[RSS9S$)z%Read Interoperability tags from file.rYrr)r rrrs rvrYrYyTrrucU[R"US:XaSOU[RUS-5R-nUR U5n[ U5U:wa([5RSUS[ U535 U$)zRead tag data from file.rTrrKz% failed to read r ) rrrrrrrr7rm)rlrrrrDrrs rvrIrITs  ++A:C9t/@/@/G/K#K (  779 D 4yI '[ SYK A  KrurzcURU5nUR5$![a(n[5R SU<S35 SnAOSnAff=fURS5$)z!Read unicode tag value from file.z raised r_Nzlatin-1)rrrr7rmrlrrrrDrrs rv read_utf8rTsc 775>DF{{} F7|d|DEEF ;;y !!s# AAAcnURUS:XaSU5$U[RUS-U5$)z%Read NumPy array tag value from file.rTr rK)rrrrs rvrrTsD ==z (4+<+ unexpected count=z, cannot reshape to (3, N))rrrrtr7rm)rlrrrrDcmaps rvrHrHTss ==T%6%6u%=b%AA5 ID qyA~||G$ K 95(;' '  KrucURU5n[R"[U55$![[ 4a(n[ 5RSU<S35 SnAgSnAff=f)zRead JSON tag value from file.z raised r_N)rjsonloadsrrrr7rmrs rvrTrTTsd 775>DFzz)D/** * +F7|d|DEE Fs2A*A%%A*c [UR[R"[R 5US95nUSVs/sHGn[ US5R5USUSUS[ US5R54PMI snUS'USn[ US5R5USUSUS[ US5R54US'U$s snf) z,Read FluoView mm_header tag value from file.rrrrYrTrrr) recarray2dictr rrrrrrc)rlrrrrDrHrs rvrNrNTs  u{{4>>2iH D l##A 1Q4   !A$!adIadO4I4I4KL#D ]A!A$ ! ! !!A$ D KsAC%c,URUS-S5$)z+Read FluoView mm_stamp tag value from file.rlrP)rrs rvrOrOTs ==T)1 --ructUS;dUS:waSUU3n[U5e0nUS:Xa=URSSU-5RUS45nSUSS2S 4USS2S 4- 0nU$[U5Hn [R "S UR S 55S n US :aU S ;aUR S 5 MK[X US5upU S:XaaUR5n URU S -5 URU /5R[U55 URU 5 MXU 'M U$)z`Read MetaMorph STK UIC1Tag value from file. Return empty dictionary if planecount is unknown. >rrrszinvalid UIC1Tag rrr%()Tr) rrrtrrerer read_uic_tagrXr\rPrr)rlrrrrDrhrrrrrMrrOrms rvrrUs9 Fi3.  E73oF zua%i088%Dvad|fQTl:; MuAMM$ 3A6EA~%+?"? &r*dCKD&ggi "!!$+223DR3HI $t  MrucUS:wdUS:wa Sn[U5eURSSU-5RUS45nUSS2S4USS2S4- USS2S 4USS2S 4USS2S 4USS2S4S .$) z+Read MetaMorph STK UIC2Tag value from file.rrszinvalid UIC2Tagr%rNrrYrTrr)r DateCreatedr DateModifiedrrrrtrlrrrrDrrs rvrJrJ0Us zY#%o ]]5!e) , 4 4eQZ @FAqD\F1a4L0ad|ad|q!t q!t  rucUS:wdUS:wa Sn[U5eURSSU-5RUS45nSUSS2S4USS2S 4- 0$) z+Read MetaMorph STK UIC3Tag value from file.rrszinvalid UIC3Tagr%rTrNrrYr-r.s rvrKrKFUsd zY#%o ]]5!e) , 4 4eQZ @F 6!Q$<&A,6 77rucUS:wdUS:wa Sn[U5e0n[R"SURS55SnUS:XaU$[ XUS5upXU'MG)z+Read MetaMorph STK UIC4Tag value from file.rrszinvalid UIC4Tagr rTrF)rrererr)) rlrrrrDrrrMrrOs rvrLrLVUsu zY#%oF ]]44Q7 A:  M#2eU; t ruc^SU4SjjnSU4Sjjn[RUupg[RSSnU(asTR5n U[S1;aWU"5n U S:a9U[ LaUS4$US :XaXj4$[ 5RS U<S U 35 Xj4$TRU 5 UcS U-nU"5n GOU[La U"5n GOXxLaU"5n U S U S- n GOU[LaU"5n [U 6n GOxU[La [T5n GObU[ LaU"5n S U s=::aS:a?O O<[R"U S3TRU 55S SSn [!U 5n GOU(a!Sn [ 5RSU<35 GOSU 3n[U5eUS :XaSn GOUS:Xa/n [#U5HnU"5n S U s=::aS:aNO OK[R"U S3TRU 55S SSnU R%[!U55 MeU(a[ 5RSU<35 MSU 3n[U5e GOSU-nSU;aXr-nSU;aTR'US5S n U R(SS:XaU SR+[,R.5nU SR+[,R.5n[,R0"UR([,R25n US :gnUUUU- U U'ON[R"UTR[R4"U555n [7U 5S:XaU S n U(aTRW S-5 Xk4$![a SU3U"54s$f=f![[4a-n Sn [ 5RSUSU <S35 Sn A NrSn A ff=f) z]Read single UIC tag value from file and return tag name and value. UIC1Tags use an offset. ch>[[R"STRS55S5$)Nr rr)rrererrlsrvread_intread_uic_tag..read_intxUs&6==rwwqz21566ruc>[R"STRS55n[US5[US54$)Nz<2IrPrrY)rererr)rOrls rv read_int2read_uic_tag..read_int2{Us6 eRWWQZ058}c%(m++ru_TagIdrrYNrPr=r(z/ invalid offset for tag rrrz reading rr_rrrKz. invalid string in tag zinvalid string size rzinvalid string size: rsz%ir rT).rYrTrK)r6tuple[int, int])rrr4rXrrzr7rmr\rrr5rrererrrrrrr,rr fullnanrr)rlrMrhrr4r7rrrWrmoffrOrrrrstringdenomnumerr@s` rvr)r)lUs7,,mmE*  }}Q"H ggi d #*CQwC<8OB;9$  ..2XRu>y GGCL }Tz  #    a58# / !  #U+E # #!"% #z  u MMTF!*bggdmLILIirrNr)rrererr\rrrrrrrrr"r rr`rSrrrr])rlrrrrDr magic_numberstructure_sizerlsminforrtypestrrreaderrs rvrPrPUsyC,o#)== #C L//,oGGB J J/888)+'MD EKK(11 1D$ NND? + ( * u{{7+yAF //557  > HtOQ/ A:    V\\7 C!":FLD C8 MD Cs " F;; G ct[R"SURS55SnURSUS9$)z%Read LSM channel data type from file.r rrr%rrererrrlrs rvrr+Vs2 ==rwwqz *1 -D ==d= ++ruct[R"SURS55SnURSUS9$)z-Read LSM channel wavelength ranges from file. invalid LSM TimeStamps blockr invalid LSM ChannelColors structurer\rrLrr NrrrA)rXrererr7rmrr\rrrPrtrrrr) rlrrmrncolorsnnamescoffsetnoffsetmonocolorsr rnamesizes rvrrUVsG&+rLF '')C4:MM2772;51D6G 2  $ZF6NGGCM ]]5;;gk] :F ^^WaL )F}}F8GGCM WWT^ $F E f+/==vbqz215 Yva!h,789H ' f+/!< Mruc,0n[R"SURS55unnnnnnUS:a[5R S5 U$URS5 [ R U5US'XaS'XAS'XqS '/=US 'n[U5GHwn [R"S URS 55S n U S ::a U$[R"S URS 55S S- S U s=:aS :aO OURSUS9n OU S :Xa%URSUS -S9n U RS5n OU S:XaR[R"S URS 55S n URSXL-S-S9n U RXLS45n OJU S:Xa%URSUS-S9n U RS5n O[5R SU 35 U$UR[ RU 5U S.5 GMz U$)z!Read LSM lookup tables from file.z invalid LSM LookupTables structure$LutTypeAdvancedNumberChannelsCurrentChannel SubBlocksrPrrrPrTrLz invalid LSM SubBlock type )r Data) rererr7rmrrrrrtrr) rlrr nsubblocks nchannelsluttypeadvancedcurrentchannel subblocksrsbtypernknotss rvrrtVsF  i-  by 1  GGEN++G4F9!:( - &((F;) : tRWWQZ03 Q; 2 M1  dBGGAJ'*Q. v>>==i=8D q[==i!m==?D<< +D H  --3H6   M ..v6 E 38 Mruc0nU/n[Rn[R"SURS55SS:wa[5R S5 U$URS5 U"SURS55upEnUS :Xa[ URU55nOWUS:XaU"S URS55SnO5US :XaU"S URS55SnOSnURU5 U[ R;a-URU5 [ RUn/n XU'U nOU[ R;a'URU5 0n URU 5 U nOPU[ R;aXq[ RU'O&US :XaU(aUR5nOXqSUS3'U(dU$GMl)z&Read LSM ScanInfo structure from file.r rrrz; invalid LSM ScanInfo structurerPz MK ) (||  6 M9 <<  s0)E/1!F*-F/ E=FFF54F5c[[URU555$![[[ [ 4a*n[5RSU<S35 0sSnA$SnAff=f)z%Read OlympusSIS INI string from file.z' raised r_N) olympus_ini_metadatarrrrrrr7rm)rlrrrrDrs rvrUrU!Ws^#Ibggen$=>> *NH E5c\D\ B  s"%A)A$A)$A)cj0n[RnUR[R"U5US9nUHupXxR 5XX'M USS:Xa[R n UR[R"U 5US9nUSS:wa[5RS5 0$U HPupU RS5(a![XxR5SS 5XX'M<XxR 5XX'MR U$USS :wa[5RS 5 0$U$) z%Read TVIPS EM-MENU headers from file.rrrTrpl*UUz: invalid TVIPS v2 magic numberr'z utf-16-leignorerYz9 unknown TVIPS header version) rr5r rrrrqr7rmrrr) rlrrrrDr header_v1rmr_typestr header_v2rIs rvrRrR3Ws* F$$I ^^EKK 2i^ HF#|**, $ iA((  I 6)L '?j ( H  L I&MD!!#&&(L((*K   &|224 '" M  a  G  Mrucp0n0n[URU55nUR5HrnUR5nUR S5(a 0nXeUSS'M4UR SS5up[U R55XiR5'Mt U$![ a Mf=f)z'Read FEI SFEG/HELIOS headers from file.rrYrKrH)rr splitlinesrcrrrr,) rlrrrrDrsectionrr rrOs rvrQrQ^Ws F G RWWU^ $D!zz| ??3  G!(4":   C+JC &ekkm4 " M   s$B'' B54B5c SS0nSn[URU55nUR5HnUR5(aUR 5nM*U(aUR SS5upU R5n Sn U R 5up[U [[45nX:waUn U n U R5U 4XV'U (a XV==U 4- ss'SnMUS==[U[[454- ss'M U$![ a+ UR SS5upN![ a GMf=ff=f![ [4a2 [U [[45nX:waUn U S;aSn NU S ;aS n Nf=f) zuRead Zeiss SEM tag from file. See https://sourceforge.net/p/gwyddion/mailman/message/29275000/ for unnamed values. r=rtNrHrYr>NoOffF>OnYesT) rrrisupperrrrrcr,rrYr)rlrrrrDrrrr rrOrrrnumbers rvrMrMxWs}!"XF C RWWU^ $D! <<>>**,C  "jja0  KKMED !{{}C<0;"ED ::</FK w& C 2J6$e 57 7JA"B M7 "&**S!"4KD%!  * !U|4?"EM)!Em+ E !sB#D 1E ED00 E:E?EE5F >F F cUR[RUS9nURURR U55n[ U5nUSSUSUS'USSUSUS'U$)z*Read NIH_IMAGE_HEADER tag value from file.rrNrrr)r rrrrr r")rlrrrrDarrrs rvrSrSWs| ....). DC ((399)))4 5C*3/FWo&;{(;  B&CS/ !  '-}}Wbggbk'J$ J '"7#UHM 3CS/ !#8is(;<=J27!)yS!UA.H  (( '2o3& LL' "'5o3&'s$BC11 D9;D  D9&D44D9c Uc1SknURS5 SSS.URS5nURS5 [R"US -URS55unn0nUS :XaXGS '[R"US -URS55unn US :waGXS'U S :waSU <3n[U5e[R"US-URS55Sn SU;aOURU 5n [U 5U :wa Sn[U5e[R"[U 55US'U$[R"US-URS55un n n nnn SU;agUS :waSU<3n[U5eURU 5n [U 5U :wa Sn[U5e[R"[U 55US'SU;aUS:waSU<3n[U5eURU5 [R"US -URS55unnUS:wa S n[U5eURUS!-5n [R "XS"-US#-5R#S$5US'S&U;GaU S':waS(U <3n[U5eURU 5 [R"US -URS55unnUS):waWURU S*-5 [R"US -URS55unnUS):waS+U<3n[U5eURU5n [U 5U:wa Sn[U5e[R"[U 55US&'SUS 'U S-:XaS.U;aURU5 [R"US -URS55unnUS/:waSURUS*-5 [R"US -URS55unnUS/:wa S0n[U5eURU5n [U 5U:wa Sn[U5e[R"[U 55US.'U$U S :XaXS 'U$U S:Xa US:XaU$S.U;aS1U <3n[U5eU$![[R [ 4anS n[U5UeSnAff=f![R [ [[4a,n[5RSUSU<S35 SnAU$SnAff=f![R [ 4a*n[5RSU<S35 UsSnA$SnAff=f![R [ [[4a)n[5RSU<S35 SnAGNSnAff=f![R [ [4a)n[5RS%U<S35 SnAGNSnAff=f![R$R&a GN[R [ [[4a)n[5RS,U<S35 SnAGNSnAff=f![R [ [[4a)n[5RS2U<S35 SnAU$SnAff=f)3aReturn Micro-Manager non-TIFF settings from file. The settings can be used to read image data without parsing any TIFF structures. Parameters: fh: Open file handle to Micro-Manager TIFF file. keys: Name of keys to return in result. Returns: Micro-Manager non-TIFF settings, which may contain the following keys: - 'MajorVersion' (str) - 'MinorVersion' (str) - 'Summary' (dict): Specifies the dataset, such as shape, dimensions, and coordinates. - 'IndexMap' (numpy.ndarray): (channel, slice, frame, position, ifd_offset) indices of all frames. - 'DisplaySettings' (list[dict]): Image display settings such as channel contrast and colors. - 'Comments' (dict): User comments. Notes: Summary metadata are the same for all files in a dataset. DisplaySettings metadata are frequently corrupted, and Comments are often empty. The Summary and IndexMap metadata are stored at the beginning of the file, while DisplaySettings and Comments are towards the end. Excluding DisplaySettings and Comments from the results may significantly speed up reading metadata of interest. References: - https://micro-manager.org/Micro-Manager_File_Formats - https://github.com/micro-manager/NDTiffStorage N>rMrrNDisplaySettingsrrsrr)rLrMrTrPIIznot a Micro-Manager TIFF fileiarAi$# MinorVersionzinvalid summary_length=r rrMznot enough dataz< failed to read NDTiffvz summary settings, raised r_IIIIIIrzD failed to read header, raised zinvalid summary_header=zN failed to read summary settings, raised rNiCzinvalid index_header=i4zinvalid headerr rar)rKrzG failed to read index map, raised rizinvalid display_header=idrvzinvalid display header=zN failed to read display settings, raised i}rie zinvalid comments headerzinvalid comments_header=zF failed to read comments, raised )r\rrererrr]rrrr rrr7rmrrrtdecoderJSONDecodeError)rlr* r index_header index_offsetrrrsummary_headersummary_lengthrdisplay_headerdisplay_offsetcomments_headercomments_offsetrmrs rvrCrCWsP |EGGAJ ',RWWQZ8    MM)d*BGGAJ 7    Fv!-~  i$. ; ()7~&!W,4^$56C$S/)!'y3 !KA!ND ww~.t9.+C$S/)$(JJy$?y!  MM)h. <      D (0 12 o%77>*D4yN*' o% $ 9T? ;F9 T x'.0 o% GGL !"MM)d*:BGGAJGMFE & o%7752:&D!&!1!1$& "gg : D  *0 12 o% GGN #"MM)d*:BGGAJGMFE"./ & i$.> K Y&4VI6C$S/)775>D4yE!' o%(, 9T?(CF$ %F> h &T!( & i$.> K X%GGOe34$*MM)d2BBGGAJ$OMFE)7(o-wwu~t9%+C$S/)%)ZZ $%@z" M &%4> " M !o&:  M4 -_./CS/ !  Mg fllG ,'-o3&'4 gz3EF  H  ))57'     $ LL' " \D\ #  " gz3EF  H  ;;>,,H   ( gz2  H  447<$<A   2||++   gz3EF  H  ;;>,,H   B LL':/A B  \D\ #  M  sAS;CT 0UA&V0B*W/"DX:(C1Z* Z*' Z*6Z*T/S==T$U)!UUV2VVV$W,W''W,/X7X22X7:Z'#Z'>Z""Z'*$[7[22[7c ## [US5nURS5n[U5S:waO[R"SU5Sn[ R "URU55n[R"SURS55SnURU5RSSS9n[R"SURS 55unnn n n n n nUUUUU U U U U U4 v MS S S 5 g ![R[ R[4a)n[5RS U<S 35 S nAMVS nAff=f!,(df  g =f7f) a Return iterator over fields in Micro-Manager NDTiff.index file. Parameters: file: Path of NDTiff.index file. Yields: Fields in NDTiff.index file: - axes_dict: Axes indices of frame in image. - filename: Name of file containing frame and metadata. - dataoffset: Offset of frame data in file. - width: Width of frame. - height: Height of frame. - pixeltype: Pixel type. 0: 8-bit monochrome; 1: 16-bit monochrome; 2: 8-bit RGB; 3: 10-bit monochrome; 4: 12-bit monochrome; 5: 14-bit monochrome; 6: 11-bit monochrome. - compression: Pixel compression. 0: Uncompressed. - metaoffset: Offset of JSON metadata in file. - metabytecount: Length of metadata. - metacompression: Metadata compression. 0: Uncompressed. rErr rrr)errorsz raised r_N) rDrrrererr rrrrr7rm)rrlr rr{rrrrXrrr metaoffset metabytecountmetacompressionrs rvrDrDXsV@ dD R A1v{ MM$*1- JJrwwqz2 MM$ 3A6771:,,WY,GMM+rwwr{; !#  1  (LL$"6"6 C   :3,,G  )  sF E(#EB6D)E9 E()E+E EEE E%!E(cURS5 URS5nUS;a Sn[U5eUS:XaSOSn[R"US-URS55SnURS S S .U5 URS 5R 5nUS SS:wag [ USS5nURU5R 5n0nUR5H?n SU ;dM U RSS5upU R5XR5'MA U$![a g f=f)zRead non-TIFF GDAL structural metadata from file. Return ``None`` if the file does not contain valid GDAL structural metadata. The metadata can be used to optimize reading image data from a COG file. rrT>rLrMznot a TIFF filerLrsrrrQrPr)rRrOrONrzGDAL_STRUCTURAL_METADATA_SIZE=rfrHrY) r\rrrererrrrrrc) rlbyteorder_bytesrrrnrmrlinesrr rrOs rvrBrBXs,GGAJ''!* . 0#CS/ !*e3C -- C=D>c[e)zwRead MetaSeries non-TIFF hint catalog from file. Raise ValueError if the file does not contain a valid hint catalog. rr3s rvread_metaseries_catalogrYs  ruc 6U(dgSSS.U/nS/n/nS$SjnS%SjnS&SjnS'S jnS S U4S S U4SSU4SSU4SSU4SSU4SSU4SSU44n U GH;n U upn U R5U;aU R5n OX;aM5US:XaU SSS2n X n[U[5(a@UR5VVs/sHoHn[ U5PM M nnn[ U5nO6XLaU/nSnO,[U[ [45(a [ U5nOU/nSnURU [R"US-U5-5 UH7nU "UU5nURU5 UR[ U55 M9 GM> U(dgSRU5nSRU5nUU-n[ U5US'[R"US[ U5--/UQ76nS S[ U5US!4S"S#[ U5S#-US!44$s snnf)(aReturn IJMetadata and IJMetadataByteCounts tags from metadata dict. Parameters: metadata: May contain the following keys and values: 'Info' (str): Human-readable information as string. 'Labels' (Sequence[str]): Human-readable label for each image. 'Ranges' (Sequence[float]): Lower and upper values for each channel. 'LUTs' (list[numpy.ndarray[(3, 256), 'uint8']]): Color palettes for each channel. 'Plot' (bytes): Undocumented ImageJ internal format. 'ROI', 'Overlays' (bytes): Undocumented ImageJ internal region of interest and overlay format. Can be created with the `roifile `_ package. 'Properties' (dict[str, str]): Map of key, value items. byteorder: Byte order of TIFF file. Returns: IJMetadata and IJMetadataByteCounts tags in :py:meth:`TiffWriter.write` ``extratags`` format. rtIJIJJIJIrqrc6URSSSS.U-5$Nrbelerqrrrs rv_string$imagej_metadata_tag.._stringSY {{8Dt&._doublesVYs%{{i[T 15===ruc"UR5$ry)rrs rv_ndarray%imagej_metadata_tag.._ndarrayYYs||~rucU$ryrtrs rv_bytes#imagej_metadata_tag.._bytes\Yrrurinforlablrrangrlutsrplotrroi roverrproprsNrKrYr rurTrnr)rrzrror6r{)rzSequence[float]rror6r{)rrrror6r{rr{rror6r{) rrrr`rzrrMr~rrerfr)rr header_listbytecount_list body_listrrrrmetadata_typesrrmtyperrkvrrrOrbodyrmrs rvr3r3)YsXH  w/ :;KSNII> '" 7G$ 7H% (# &!  Wf% w( D 99;( "))+C    $B$KE fd # #'-||~B~r!c!frf~FBKE  XFE u . .KEXFE56;;y3#FFGEy)D   T "  ! !#d) ,-6  88I D XXk "F D=DF N1S3~../2@J 3t9dD) 3z?a'T: 5Cs>Hc SSjnSSjnS SjnS!SjnSU4SU4SU4SU4S U4S U4S U4S U4S .nURUR5VV s0sHupUSSS2U _M sn n5 U(d Sn [U 5eUSSS;a Sn [U 5eUSn U S:dU S:a Sn [U 5eU S- S-n [R"USU --USSU S--5n SU S--nSn0n[ U SSS2U SSS2SS9Hunn/nUR U[U5U45unn[U5H+nUS- nXU-nURU"XUU55 UnM- US:XaUSOUUUR5'M UR S 5n[U[5(a5[U5S-S:Xa#[[R "US55US 'U$s sn nf)"aReturn IJMetadata tag value. Parameters: data: Encoded value of IJMetadata tag. bytecounts: Value of IJMetadataByteCounts tag. byteorder: Byte order of TIFF file. Returns: Metadata dict with optional items: 'Info' (str): Human-readable information as string. Some formats, such as OIF or ScanImage, can be parsed into dicts with :py:func:`matlabstr2py` or the ``oiffile.SettingsFile()`` function of the `oiffile `_ package. 'Labels' (Sequence[str]): Human-readable labels for each channel. 'Ranges' (Sequence[float]): Lower and upper values for each channel. 'LUTs' (list[numpy.ndarray[(3, 256), 'uint8']]): Color palettes for each channel. 'Plot' (bytes): Undocumented ImageJ internal format. 'ROI', 'Overlays' (bytes): Undocumented ImageJ internal region of interest and overlay format. Can be parsed with the `roifile `_ package. 'Properties' (dict[str, str]): Map of key, value items. c6URSSSS.U-5$rrrs rvr imagej_metadata.._stringYrrucT[R"US[U5S---U5$)NrrP)rererrs rvr!imagej_metadata.._doublesYs%}}Y#Ta*@A4HHrucj[R"U[R5RS5$)N)rKr)rrrPrtrs rv_lutimagej_metadata.._lutYs$ekk2::9EErucU$ryrtrs rvrimagej_metadata.._bytesYrrurrrrrrrr)rrrrrrrrNrKzno ImageJ metadatar>rrzinvalid ImageJ metadatarri$z#invalid ImageJ metadata header sizerP4sIrTrYTr4)rr{rror6rz)rr{rror6ztuple[float, ...])rr{rror6zNDArray[numpy.uint8]r)r r`rrererrSrrrrcrrMrrrbatched)rrrrrrrrrrr header_sizentypesrmrmcounterrrrrrrrpos1rs rvrrYsFNIIF'"G$H%$&!f%( .2F2F2HI2H$!1TrT7A:2HIJ "o BQx))'oQ-KR;,3oAo! #F ]]EFN"DQ!^$<F fqj.CG FF3Q3K1dC u#'' %0@&/IJ duA qLGG,,D MM$t~y9 :C  -2QJvayFtzz|D ::l #D$#d)a-1"4#I$5$5dA$>?| MEJsG% clSSjn0nUR5HYnURSS5upEUR5nUR5n[[ U4H nU"U5n O XRU'M[ SU;aSU;aSU<3n[U5eU$![a Mf=f![ a MUf=f)a Return metadata from ImageJ image description. Raise ValueError if not a valid ImageJ description. >>> description = 'ImageJ=1.11a\nimages=510\nhyperstack=true\n' >>> imagej_description_metadata(description) {'ImageJ': '1.11a', 'images': 510, 'hyperstack': True} c.SSS.UR5$)NTF)r r r)r s rv_bool*imagej_description_metadata.._boolZsu-ciik::rurHrYrSCIFIOz!not an ImageJ image description: )r rzr6r)rrrrcrrYr)rrrr rr rrs rvrrYs; F&&( zz#q)HCiikiik5%(E Cj) s )v(&"81&<o M     s#B!B% B"!B"% B32B3rc SU;a4[R"S[SS9 [UR S55nUR SS5nUR SS5nUR SS5nUR S S 5nU(aS nS n[ XUS 9nUS S;n/n SU3/n U R S[USS535 UcSnU R S5 O4U R S[[U55R535 USS:aU R SUS35 UcU(d U(dSnU(aU(aU R SU35 USS:aU R SUS35 USS:a+U R SUS35 UcU R S5 Ub4U R S[[U55R535 UR5HaupU S;dM [U [5(a[U 5R5OU n U R U R5SU 35 Mc S RX-S!/-5$)"aReturn ImageJ image description from data shape and metadata. Parameters: shape: Shape of image array. axes: Character codes for dimensions in ``shape``. ImageJ can handle up to 6 dimensions in order TZCYXS. ``Axes`` and ``shape`` are used to determine the images, channels, slices, and frames entries of the image description. rgb: Image is RGB type. colormapped: Image is indexed color. **metadata: Additional items to be included in image description: ImageJ (str): ImageJ version string. The default is '1.11a'. hyperstack (bool): Image is a hyperstack. The default is ``True`` unless ``colormapped`` is ``True``. mode (str): Display mode: 'grayscale', 'composite', or 'color'. The default is 'grayscale' unless ``rgb`` or ``colormapped`` are ``True``. Ignored if ``hyperstack`` is ``False``. loop (bool): Loop frames back and forth. The default is ``False``. finterval (float): Frame interval in seconds. fps (float): Frames per seconds. The inverse of ``finterval``. spacing (float): Voxel spacing in ``unit`` units. unit (str): Unit for ``spacing`` and X/YResolution tags. Usually 'um' (micrometer) or 'pixel'. xorigin, yorigin, zorigin (float): X, Y, and Z origins in pixel units. images, channels, slices, frames (int): Ignored. Examples: >>> print(imagej_description((51, 5, 2, 196, 171))) ImageJ=1.11a images=510 channels=2 slices=5 frames=51 hyperstack=true mode=grayscale loop=false colormapedzirrrrerJ r rHr r=) rhrirVrrrTrr@rzrr`rr)rrrrrrrrrnrrrrOr s rvr2r2 ZsM@x  F   8<< 56 << %DlD1J << %Dll8W-G  d 3E )v C Fy! "F MMGGE#2J/012  '( CZ(8$9$?$?$A#BCD Qx!| %(,- |C d dVn% Qx!| az*+ Qx!| az*+ < MM, '  c$t*o335678nn&  J J(25$(?(?#e*""$UC MMSYY[M3%0 1' 99V_t+ ,,rurc[SU55n[U5nUS:dUS:a Sn[U5eUb[U5U:wa Sn[U5eSnUR5nUH+nSR U5nXu:a Sn[U5eUS-nM- /nSnSH;nXS:a"XbU:XaUR X5 US- nM*UR S5 M= US S ;a S n[U5e[U5$UcUS S ;=(a US :nU(aUS S ;a Sn[U5eU(dUS:XaUS S:wa Sn[U5eU(d US S:Xa SSU- -U-$SSU- -U-S-$)zReturn shape normalized to 6D ImageJ hyperstack TZCYXS. Raise ValueError if not a valid ImageJ hyperstack shape or axes order. Shape must be 1-6 dimensional. >>> imagej_shape((2, 3, 4, 5, 3), rgb=False) (2, 3, 4, 5, 3, 1) c38# UHn[U5v M g7fryrrs rvrimagej_shape..Zs(%Q#a&&%rrYrz)ImageJ hyperstack must be 1-6 dimensionalz-ImageJ hyperstack shape and axes do not matchrTZCYXSz.ImageJ hyperstack axes must be in TZCYXS orderrK>rYrrz1ImageJ hyperstack must contain 1, 3, or 4 samplesrrTz$ImageJ hyperstack is not a RGB imagez*ImageJ hyperstack is not a grayscale imagerr)r~rrrNrr) rrrrrrrr2newshapes rvrTrTZs (%( (E u:D ax4!89o  t9 ACS/ ! zz|B b!AuF o%AA   BxBq'M)Q"  BBHHBrzno SOF marker found)rrerer)jpegrmarkerrYrs rvrrZs A c$i-tTa!e_5a8 Q V   V   V %v %  V  tTa!e_5a8 Q V %v %==$1q5/: : V   aZ; c$i-> C S/rucSnSnSnSnSnSnU[U5:GaT[R"SXUS-5SnUS- nUS:XaM<US:XaGO SUs=::aS::aO OMVUS :XaM^[R"SXUS-5SnUS- nUS :Xa [R"SXUS-5SnOUS :XaUS-n[R"S XUS -5uppUS - nSnSn[U 5HCn [R"SXUS-5upnUS- n[ XOS- 5n[ X_S-5nME US-nUS-nUS- nOUS:XaXh-S- nOXhS- - nU[U5:aGMTUS:Xd US:XdUS:Xa Sn[ U5eUnX-nUSU[R "SUU5-XS-U-nUUU4$)zReturn tile shape and JPEG header from JPEG with restart markers. Returns: Tuple of (tilelength, tilewidth, jpegheader). Raises: ValueError: Missing required JPEG markers (DRI, SOF0, SOS). rrYr rTrrrrrirrrz>BBBrrrrPrzmissing required JPEG markersNr )rrererrkrrf)rrestartinterval sofoffset sosoffsetmcuwidth mcuheightrrrY _precision _imlength_imwidth ncomponentsr_cidfactor_tablerrSrRrWs rvrr'[s/OIIHI A c$i-tTa!e_5a8 Q V   V   V %v %  V  tTa!e_5a8 Q V $mmD$1q5/B1EO v AI;A==!a%< 8J8 FAHI;''-}}VTa!e_'M$fQx15 C<8 ( MH NIA A v  QI  aZe c$i-h!yA~a-oJ*I Zi ++eZ 3 4 1}y ) * y* ,,ruc H[R"S[U50UE5$)zReturn JSON image description from data shape and other metadata. >>> shaped_description((256, 256, 3), axes='YXS') '{"shape": [256, 256, 3], "axes": "YXS"}' r)rdumpsrM)rrs rvrfrfz[s! ::wU 8x8 99rucUSSS:Xa([SUSSRS555nSU0$[R"U5$![a Of=fS USS <3n[ U5e) aUReturn metadata from JSON formatted image description. Raise ValueError if ``description`` is of unknown format. >>> description = '{"shape": [256, 256, 3], "axes": "YXS"}' >>> shaped_description_metadata(description) {'shape': [256, 256, 3], 'axes': 'YXS'} >>> shaped_description_metadata('shape=(256, 256, 3)') {'shape': (256, 256, 3)} NrrRc38# UHn[U5v M g7fryrrs rvr.shaped_description_metadata..[sC&Bc!ff&BrrrKr|rzinvalid image description r )r~rrr r)rrrs rvrfrf[s2A("Ck!B&7&=&=c&BCC zz+&&    &{3B'7&: ;C S/sA AAcURS5(d Sn[U5eUcSS1n0nU/nUnSnUR5GHnU(dUR5nU(dM$USS:XaUSSS :XalUS US nUS SnU(aS R XX5XX'USS S:Xa8[ R "XX[ RS9n U RS5XX'MSnUS S nUSS S:Xa/nO X;a/nSnO0nURU5 XSU'MU(aURU5 MURSS 5n [U 5S :XaSXZSR5'GM+U upU SS S:Xa)URSU R555 GMa[U R55X[R5'GM U$)aUReturn metadata from FluoView image description. The FluoView image description format is unspecified. Expect failures. >>> descr = ( ... '[Intensity Mapping]\nMap Ch0: Range=00000 to 02047\n' ... '[Intensity Mapping End]' ... ) >>> fluoview_description_metadata(descr) {'Intensity Mapping': {'Map Ch0: Range': '00000 to 02047'}} rz"invalid FluoView image descriptionNzRegion Info (Fields)zProtocol DescriptionFrrz End]rKrYr rzLUT rz)rKrTrHzRGB c38# UHn[U5v M g7fryr)rrs rvr0fluoview_description_metadata..[s=}3s88}r)rrrrcrrrrPrtrrrrr,) rignoresectionsrrsectionsrcommentr rr rrrOs rvfluoview_description_metadatar![s"  ! !# & &2o02HIFxHGG&&(::BCyG#RL"2,Abz$(IIgm$>> pilatus_description_metadata('# Pixel_size 172e-6 m x 172e-6 m') {'Pixel_size': (0.000172, 0.000172)} rz#:=,()rr NrTr r%Y-%m-%dT%H %M %S.%frhrYnotNaNc34># UH nT"U5v M g7fryrtrrrs rvr/pilatus_description_metadata.. \s0AuQxxr)rrrrrrIrrrrrrYr~rz) rrrraw_linetokensrrrrrs @rvrr[s F  ! !$ ' ' !))!S1  %%d+ BQ<4  ! ay t** * 4%-HHV$&<&z" ,,T2 gaj% ( (w<1$ $$ ,F)01AQiF1 E>fQi50WF000 C<XXf%F [A AYFt ;,< M% 4"xxqr 3  42s E)5F) F  F clURS5(d Sn[U5e0nURS5nUSR5US'USSHMnUR5RSSS 9upV[ UR55X%R5'MO U$![a M`f=f) zReturn metadata from Aperio image description. The Aperio image description format is unspecified. Expect failures. >>> svs_description_metadata('Aperio Image Library v1.0|AppMag = 20') {'Header': 'Aperio Image Library v1.0', 'AppMag': 20} rz invalid Aperio image descriptionrIrHeaderrYNrH)maxsplit)rrrrcr,)rrrr`rrrOs rvrr\s  ! !) , ,0oF   c "EQx~~'F8ab  ++C!+>> stk_description_metadata('name: value') [{'name': 'value'}] rrrYrr=)rcrrrr,r)rrplanerr rrrOs rvstk_description_metadatar0/\s##%K  F""6*{{}} $$&DJJsA&E5zA~# "("7**,a(5Qw" U+!&"' 1 MM! %+& Mruc*^^URS5(d Sn[U5eSSKnSSKJn UR U5n[ [SSURS.mS UU4S jjmT"U05nS U;aUS RS S 5US 'U$)z2Return metadata from MetaSeries image description.rz$invalid MetaSeries image descriptionrNrvc[USS5$)Nonr=)asboolrs rvr1metaseries_description_metadata..f\s &D%0ruc[US5$)N%Y%m%d %H:%M:%S.%f)rIrs rvrr5g\s (1&:;ru)rYrrrm guidc:>UHxnURnU(dT"U05XR'M-SU;dM5USnURSS5nURSS5nUT;aTU"U5X'MtXaU'Mz U$![[4a XaU'Mf=f)NrO rwr=rO)rrrSrr) ryrrrrr.rr( typess rvr( .metaseries_description_metadata..parsem\sE\\F$)%$4yy!v~4LJJvr*JJw+:&$)!HQK !"1I  ' 2&$%q &s) BBBr z r )ryElementTree.Elementrrr6r) rrr rrwr rYrr r)rrr rwryrr( r:s @@rvrrY\s  ! !, / /4o%  ! !+ .D0; ,E!+9 ,#4_F &} 5 = = $! } Mruc[U5$)z1Return metadata from ScanImage image description.)r9rs rvscanimage_description_metadatar>\s  $$ruc[R"U5$![a(n[5R SU<S35 SnAgSnAff=f)z*Return metadata from ScanImage artist tag.z, raised r_N)rr rr7rm)artistrs rvscanimage_artist_metadatarA\sN zz&!!  :3,, G     s A AA ctS SjnSS0n0n/nSnSnSn0nSn UR5GHUn U R5n U S:Xd U SS:XaM%U SS:XaU S S :XaU S S n0=X7'nUS :Xa/=US 'n /=US'n MXUS:Xa/X7'MdUS:XaS U;a /=X7S'nM{M}US:XaS U;a /=X7S'nMMUS:Xa-US Sn [U 5Vs/sHnS/0PM nnXCU'Sn MMU RSS 5unnUR5nUR5S:XaSnO3SU;a"[ SURS555nO [ U5nUS :Xa)UX'W R U5 W R U5 GMiUS:XaAUS:Xa"[U5Vs/sHn0PM snUS'GMU"U5unnUUSUU'GMUS:Xa[USSS:Xa>XISn[R"SU5nUR USUS US/5 GMU"U5upUXIU'GMUSSS:XaUbUR U5 GM1USSS:XaUbUR U5 GMQUX'GMX S U;a/n /n [USUS SS9HQunnUS :dMU R URUUSR555 U R U5 MS SRU 5US '[ U 5US'[R"[[ 5 ["R$"USSSUS S["R&5USS'SSS5 [R"[[ 5 ["R$"USSSUS S["R(5USS'SSS5 UH.n["R$"US["R*5US'M0 U$s snfs snf!,(df  N=f!,(df  N_=f)!zMReturn OlympusSIS metadata from INI string. No specification is available. cSn[URS55nU[U5:a[XS5S- nUSUnX4$)Nr 0123456789rY)rrr)rrrs rvkeyindex&olympus_ini_metadata..keyindex\sJ  <( ) s3x<BL1$Ebq'CzrurrNr=r;rrKr rY DimensionrrASDr rJrrLUTrHr|c38# UHn[U5v M g7fry)r,r s rvr'olympus_ini_metadata..\sB1AAfQii1ArCountrr rTrrTr4)rrzr6r )rrcrrr~r,rrerfrrSrNrrrrrrrr r rP)inistrrEsisaxesrrzpostpos section_nameribandr rrnbandsrrrOrlutpackedrrbands rvrr\sM &smGF"$E!D!DL GE!!#zz| 2:aC  7c>d2h#o":L-/ /F 7{*(**v*,,w%&')$$&(:<16u$>AR$>F5M!)#JC05F5M%(-'r7e#,u-C#[[u5FJJq 6!9fQi@A!)#JC(-EL%RaF"t'7 E"RaI%$*: E"$ q$twEDAq1u GKK1Q4::<89 QFv,w   Y 3#kk 3K  :&"5c": ;U]] s F 4   Y 3$)KK 6N9 %&C{(;F(C D KK% vy! 4 kk$u+u{{;U  Mu=&%?8 4 3 4 3s$P* P3;P;P) P&) P7c^ Sn0n0nUR5GHnUR5nU(dMUSSR5nUSSnURS5(d3XaS3-U;aXtXaS3-'SX6'OXtXaX63-'X6==S- ss'M~USSnSU;a%URSS5upxUR5nOSnUR5nU(dSnGOEUS S :Xa[ U5S :a$[ 5R X&S U<3-5 GMUS S :XaUSS nOS U;aSU;d$[ 5R X&S U<3-5 GMFUSSR5SSRS S5upxURSS5S R5nO~US S:XaEUS S:Xa<USS nSU;a[O[m [U 4SjURS555nO0US:XaSnO'US:XaSnOSU;a [U5nO [U5nXd;a[ 5R X&S3-5 XtU'U(dGMAXXaS3-'US S:XdGMVSU;dGM_USSRSS5S XFUS3-'GM U$![a& [ 5R X&SU<3-5 GMf=f)zReturn metadata from AstroTIFF image description. >>> astrotiff_description_metadata( ... 'SIMPLE = T / FITS standard' ... ) {'SIMPLE': True, 'SIMPLE:COMMENT': 'FITS standard'} z* NrPrH0rY/r=rrrTz: invalid string rKr;r rzr}c3P># UHnT"UR55v M g7fry)rcr's rvr1astrotiff_description_metadata..I]s!E4Dq% **4Dr r|rTrJ Fz: invalid value z: duplicate keyCOMMENTrr UNIT) rrcrrrr7rmrYrr~r) rseplogmsgcountsrr rrOr rs @rvrr]s:FFF&&(zz| 2AhnnQR$$uAYf,*/suAY' 6;suV[M223 q ab  %<"[[a0NEmmoGG E 1X_5zA~  E1B5)*L!LMRyCa w3'>H$$5(9%!CC!%ab!1!"!5!;!;C!C!--Q/399; 1X_rc!1!BKE E\EsEEEKK4DEEE c\E c\E E\%LE E  = H  V_&== >s 7,335( )qzS SG^-4QR[->->sA-Fq-IuD\)*U)X M   E1A%*K!KL s J+K Kc [R"S[R5n[R"S5n0nURUR 55GH%upV0nURU5GHnUupU R 5n U (aU S:XaSn O&[ U 5S:aU SS:XaU SS:XaU SSn U bS U ;aE[ R"[5 [S U RS 555n SSS5 OcS U ;a/[ R"[5 [U 5n SSS5 O.[ R"[5 [U 5n SSS5 XU 'GM XtU'GM( UR(d_UR5n S H8n US U S-tpnURU 5 UR!SUS9US U 'M: URU 5 U$!,(df  N=f!,(df  N=f!,(df  N=f!["[$[&4a Mf=f)zwReturn metadata from Hamamatsu streak image description. Read scaling arrays from ``fh`` if the file handle is open. z!\[([a-zA-Z0-9 _\-\.]+)\],([^\[]*)z4([a-zA-Z0-9 _\-\.]+)=(\"[^\"]*\"|[\+\-0-9\.]+|[^,]*)r NrTrrKrYr|c3v# UH/nSU;a [U5O[USS:XaUSSOU5v M1 g7f)r}r#rYN)rYrr s rvr.streak_description_metadata..]sH& &6$'!8!&a%(!A$#+121%E!F&6s79r})ScalingXScalingScalingYScalingrBFilez  M?989898i1  s6'"G92 H ! H.4H,9 H H  H) ,IIcSSKJn URU5n0nURS5HnURR S5nU(dM'UR nUcM8US:XaSnOYUS:XaS nOPUS :Xa?[R"[[5 [R"U5nSSS5 O [U5nXcU'URR S 5nUcMXsUS 3'M U$!,(df  N?=f) zReturn metadata from EER (Electron Event Representation) XML tag values. Boolean strings 'Yes' and 'No' are converted to bool. rrvz./itemrNrTrF timestamprz.unit)rrwr rrrSrrrrrrh fromisoformatr,)xmlstrrwryrrrrOrs rvrr]s &  ! !& )DF X&kkoof%   =  E>E d]E K $$Y ; ..u5<;5MEs {{v&  $(cU%= !)'* M<;s C66 D T)rescalec ^^ UcSnTcSm[R"T5m[U5m T S:d[U4SjU55(aSU3n[ U5e[ U 4SjS55n[R "UTRU-5n[R"UR[U54T5n[U5HupU[X(S -S5- n U S U -S - -n U(aqTRS -U -S -U -n XRRS -:aU RS 5n U S U -S - S U -S - --n U S U TRS -- --n XSS2U4'M URS 5$)aReturn array from bytes containing packed samples. Use to unpack RGB565 or RGB555 to RGB888 format. Works on little-endian platforms only. Parameters: data: Bytes to be decoded. Samples in each pixel are stored consecutively. Pixels are aligned to 8, 16, or 32 bit boundaries. dtype: Data type of samples. The byte order applies also to the data stream. bitspersample: Number of bits for each sample in pixel. rescale: Upscale samples to number of bits in dtype. Returns: Flattened array of unpacked samples of native dtype. Examples: >>> data = struct.pack('BBBB', 0x21, 0x08, 0xFF, 0xFF) >>> print(unpack_rgb(data, '>> print(unpack_rgb(data, '>> print(unpack_rgb(data, '# UHoTRS-:v M g7frPN)r)rrrs rvrunpack_rgb..]sF 1ENNQ.. rzsample size not supported: c3z># UH0n[R"U5RS-T:dM,Uv M2 g7frw)rrr)rrr>s rvrrx]s- FA%++a."9"9A"="Eaas+; ;BHIrYrPr rTrK)rrrr;rrrrrBrrrrr,rt) rrrrtrrrrrr*r.rr>s ` @rvrr]sN!  } KK E } D byCF FFF+M?;o F F FB!!$"(<=J [[*//3}+=> FFM* #mEG45 5 a3h!^ ..1$,q0C7A##,,q00HHSM !Q$(3 + +A !U^^a/01 1Aq!t + >>" ru)r c[R"XSS9n[R"USS5nU(a[R"U5nU$)a|Return palette-colored image. The colormap is indexed along its second axis (palette dimension). The returned image array is of shape ``image.shape + (colormap.shape[0],)`` and dtype ``colormap.dtype``. Parameters: image: Array of indices into colormap. colormap: RGB lookup table aka palette of shape ``(3, 2**bitspersample)``. contig: Return contiguous array. Examples: >>> import numpy >>> im = numpy.arange(256, dtype='uint8') >>> colormap = numpy.vstack([im, im, im]).astype('uint16') * 256 >>> apply_colormap(im, colormap)[-1] array([65280, 65280, 65280], dtype=uint16) rYrrrK)rtakerr)rrr rs rvrUrU^s>2ZZa 0F ^^FAr *F ((0 Mrur c ^^^^^^UcSO [U5nUctUb>[U5S:wdUS[U5:aS[U54SU3n[U5eS[U54[[U55Vs/sHow4PM snU4$[R R X5nU(d Sn[U5e[U[5(a[R"U5mO![US5(aUmO Sn[U5eTc0mTRR5VV s0sHupX_M sn nmSUUU4S jjn U(d S n[U5eUV s/sH"n [RR!U 5PM$ n n [U 5S:Xa#[RR#U S5n O[RR%U 5n [U 5nSm/nU HnU "UUSR'[R(55unmTc_UmTbY[T5[T5:wd,[+U4S j[[T5555(aS T<S T<3n[U5eOTU:wa Sn[U5eTb[U4SjT55mUR-T5 M TceTb[U4SjT55m[.R0"U[.R2S9n[.R4"USS9nUU-n[.R6"USS9S-nUc![SUR9555nOK[U5[U5:wd [+S[;UUSS955(aSUSU3n[U5eUR95nUVs/sHn[U5PM nnTX_U4$s snfs sn nfs sn fs snf)aReturn shape and axes from sequence of file names matching pattern. Parameters: files: Sequence of file names to parse. pattern: Regular expression pattern matching axes names and chunk indices in file names. By default, no pattern matching is performed. Axes names can be specified by matching groups preceding the index groups in the file name, be provided as group names for the index groups, or be omitted. The predefined 'axes' pattern matches Olympus OIF and Leica TIFF series. axesorder: Indices of axes in pattern. By default, axes are returned in the order they appear in pattern. categories: Map of index group matches to integer indices. ``{'axislabel': {'category': index}}`` _shape: Shape of file sequence. The default is ``maximum - minimum + 1`` of the parsed indices for each dimension. Returns: - Axes names for each dimension. - Shape of file series. - Index of each file in shape. - Filtered sequence of file names. Examples: >>> parse_filenames( ... ['c1001.ext', 'c2002.ext'], r'([^\d])(\d)(?P\d+)\.ext' ... ) (('c', 't'), (2, 2), [(0, 0), (1, 1)], ['c1001.ext', 'c2002.ext']) NrYrzshape z does not fit provided shape )r zinvalid pattern groupindexc>T ce/n/nT RU5nUcSU<3n[U5eSn[UR55H}upgUnUcM US-T ;a T US-nOUSR 5(aUnM:UcSn[ UT ;aT UUOU5nURU5 URU5 SnM [U5[U54$![[ 4an SU<3n[U5U eSn A ff=f)Nz!pattern does not match file name rYrr/ zinvalid index ) searchrrgroupsisalpharrrr~) rrrmatchesrrrmatchr-rrr~pattern_compileds rvr( parse_filenames..parses^s,%%%"))(3 ?5h\BCS/ ! !'.."23HAAy1u "A&1z /R:-= 2q)1E NN1  KKOB%4&T{E'N** ) /&qe, o3. /s C""D 2DD zfiles is emptyc3,># UH oT;v M g7fryrt)rrrs rvr"parse_filenames..^sD3Ca )3Crzinvalid axesorder z for z'dims do not match within image sequencec3.># UH nTUv M g7fryrt)rrrs rvrr^s2 1A r c3.># UH nTUv M g7fryrtrs rvrr^s0iT!Wir rzrc38# UHn[U5v M g7fryrrs rvrr^s;&:c!ff&:rc3.# UH upX:v M g7fryrtr1s rvrr^s/>$!>rTr4z parsed shape )rrzr6z'tuple[tuple[str, ...], tuple[int, ...]])r~rrrrrLrSrrzrirjrr~r`rrEnormpathrGrS lstripr_r;rrrintprrkrr)rrrrrrrrrrr( r normpaths prefix_strrorrlblr startindex parsedshape indices_listrrr~rrs `` @@@@rvr=r=#^sdNDf E  #e*/U1XE 5JCJ=/)FugNCS/ !  ZM U, -,aT, -      $$W6G o'3::g. , ' '"o #3#>#>#D#D#FG#F41!$#FGJ++> o.34e!!!$eI4 9~WW__Yq\2 WW'' 2 _F#'D%'G&'*11"&&9:S <D$I#d)+D5T3CDDD*9-uTHE o% S[;CS/ !  2 22Cs"   0i00KKuzz:M=q1JZM))M2Q6K };k&8&8&:;; [ SZ '3/e[>/,,k]*GwOo$1$8$8$:L)56uU|G6  &&U .(HJ5^7s= O0O$)O6O"c#$# UShvN gN7f)z=Return iterator over pages in data array of normalized shape.Nrt)rs rvrsrs^s OOs c## [R"USU- 5nUHanUc[R"X5nOUR U5nUH-nUH$n[ U5Hn XU-U S-U-v M M& M/ Mc g7f)aReturn iterator over strips in pages. Parameters: pageiter: Iterator of pages, each of shape ``shape``, or ``None`` for missing pages. Missing pages are replaced with zero-filled arrays. shape: Normalized page shape ``(pages, depth, rows, cols, samples)``. dtype: Data type of page arrays. rowsperstrip: Number of rows per strip. Yields: Strips of shape ``(rows, cols, samples)`` where rows <= rowsperstrip. rNrY)rorprrrtr) pageiterrrrrrpagedatar/rZrs rvr{r{^s0 %)l23I <{{50H||E*HEy)AL 0AE\3IJJ*sBBc #R# S[U5s=:aS:aO O[U5[U5:wa Sn[U5e/UQURSP7nURnURSSupg[U5S:XaUupUHn U Hn [ US5Hn X-n [ XU - 5n[ US5H]nX-n[ XU- 5nU SXU-2UUU-24nURU:wa#[ R"XE5nUUS U2S U24'UnUv M_ M M M g UunpURSnUHn U Hn [ US5HnUU-n[ UUU- 5n[ US5Hn X-n [ XU - 5n[ US5HpnX-n[ XU- 5nU UUU-2XU-2UUU-24nURU:wa&[ R"XE5nUUS U2S U2S U24'UnUS:XaUSOUv Mr M M M M g 7f) aReturn iterator over full tiles in data array of normalized shape. Tiles are zero-padded if necessary. Parameters: data: Normalized array of shape ``(pages, depth, rows, cols, samples)``. tile: Tile shape as ``(rows, cols)`` or ``(depth, rows, cols)``. tiles: Number of tiles along each tiled dimension. Yields: Tiles of shape ``(*tile, samples)``, zero-padded at image boundaries. rYrzinvalid tile or tiles shaperKrrrTrN)rrrrrrrr)rrrrrrr_r^rrrr/iytycyixtxcxrchunk_rQ sziztzczs rvrrrr^sM, s4y 1 D SZ 7+o(4(B(J JJE ZZ!_FB 4yA~Da/BBQRB#E!HoV G_ %a2grBG|&C D ;;*4%*[[%CF/4F3B38,$*E# .* 1 ZZ]Da/BaBQRB#E!HoV G_"'a/B!#B!$QRB$) "R"W b7lBbL H%E %{{j8).Z)G8=ssCRC"} 5(../1f%(%?#2.*sH%H'c#l^^^^^^# TS::ag[T5TR-mU(a SUUUU4SjjnO SUU4SjjnUb US:dTS:a)[T5Hn [T5n U"U 5v A M gUc[R S-nTS:XaUn O[ XVT-5n TU ::a<S UU4Sjjn [U5n U RX"55ShvN SSS5 g[U5n Sn/n[T5HYn [T5n U bUS- nURU 5 X:XdM.U RX5ShvN UR5 SnM[ U(aU RX5ShvN SSS5 gN!,(df  g=fNVN"!,(df  g=f7f) zbReturn iterator over encoded chunks. Chunks that are ``None`` yield b'' without calling encode. rNc >Ucg[R"UT5nURT:wa;[S[ TUR SS955n[R "X5nT"U5$)Nruc32# UH upSX- 4v M g7fr0rtr1s rvr.encode_chunks..func..[_s EJ Er3Fr4)rrrr~rrr)rrrrrgrs rvrencode_chunks..funcT_si}++E59E||y( #E5;;u E %-%= rucJ>Ucg[R"UT5nT"U5$)Nru)rr)rrrgs rvrrd_s'}++E59E%= rurTc3R># [T5Hn[T5nUv AM g7fry)rr)rr chunkiterrs rvrencode_chunks..chunks}_s&9%Y  &r rY)rr r6r{)r6Iterator[NDArray[Any] | None]) r@rrrrr rkrTr8rr )rrrgrrrrrK rrr maxchunksrr;r chunk_listrs````` @rvrzrz=_s A~/I  ! !  ! ! Z!^y1}y!AOEu+  " __q( A~  )$;< I   +x||D&(3 3 3, J '8 y!AOE     e $!#<<999  "" ||D5 5 5 ( ' 4, +: 6 ( 'srB;F4FF F"F46:F#4F#F 5F#>F!?F# F4 F FF4F#!F## F1-F4c<[[[[U55nU=[R:Xa U$=[R:Xa USSSS2SS24$=[R :Xa USSSS2SS2SS24$=[R :Xa USSSS2SSS2SS24$=[R:Xa [R"USS5$=[R:Xa$ [R"USS5SSSS2SS24$=[R:Xa' [R"USS5SSSS2SS2SS24$[R:Xa'[R"USS5SSSS2SSS2SS24$[5RSU<35 U$)zReturn reoriented view of image array. Parameters: image: Non-squeezed output of ``asarray`` functions. Axes -3 and -2 must be image length and width respectively. orientation: Value of Orientation tag. .NrKrryz( unknown orientation=)r_r r.ry rz r| r{ r} rswapaxesr~ r r r7rm)r orientations rvreorientr_s`{GK$EFK  [ L ![ ! !ddA& & [ ddAq) ) ![ ! !ddDbD!+, , [ >>%R0 0 ![ ! !>>%R0ddA> > ![ ! !>>%R0ddAqA A  >>%R0ddDbD!1CD D  H  HK;KL MLrucn/n/n/n[R"U5n[URURUSS9H>upVnUR Xg45 UR US45 UR Xg-5 M@ [RRRXUSS9RU5$)aeReturn read-only view into input array with elements repeated. Zoom image array by integer factors using nearest neighbor interpolation (box filter). Parameters: a: Input array. repeats: Number of repetitions to apply along each dimension of input. Length must equal the number of dimensions in ``a``. All values must be positive integers. Returns: Read-only view of ``a`` with each element repeated along each axis. Examples: >>> repeat_nd([[1, 2], [3, 4]], (2, 2)) array([[1, 1, 2, 2], [1, 1, 2, 2], [3, 3, 4, 4], [3, 3, 4, 4]]) Tr4rF) writeable) rrrstridesrrrlib stride_tricks as_stridedrt)r repeatsrtrrstriderrepeats rvrFrF_s0GEG aA #AIIqww Mf d^${#t}%!N 99 " " - - 'U .  ggrucgryrt data_or_shapers rvrHrH_srucgryrtrs rvrHrH_sKNruc(US:aSU<S3n[U5e[U[5(a%[U5U:aU$SU[U5- -U-$URU:aU$SXR- -UR -nUR U5$)aReturn image array or shape with at least ``ndim`` dimensions. Prepend 1s to image shape as necessary. Parameters: data_or_shape: Image array or shape tuple to expand. ndim: Minimum number of dimensions required. If the input already has at least ``ndim`` dimensions, it is returned unchanged. Returns: Array or shape tuple with at least ``ndim`` dimensions. Ones are prepended as needed. >>> import numpy >>> reshape_nd(numpy.empty(0), 1).shape (0,) >>> reshape_nd(numpy.empty(1), 2).shape (1, 1) >>> reshape_nd(numpy.empty((2, 3)), 3).shape (1, 2, 3) >>> reshape_nd(numpy.empty((3, 4, 5)), 3).shape (3, 4, 5) >>> reshape_nd((2, 3), 3) (1, 2, 3) rYzndim=rr)rrr~rrrrt)rrrrs rvrHrH_s@ axtno-'' }  % tc-001MAAT! D--- .1D1D DE   ''rucgryrtrrrs rvrr`s 58rucgryrtrs rvrr#`s ?Bruc^[U5[U5:wa Sn[U5eU(d[U5US4$UcSn/n/n/n[XSS9HVupxUS:dX;a5UR S5 UR U5 UR U5 MEUR S5 MX [U5S:Xa-SUS 'UR US 5 UR US 5 [ U[ 5(aS RU5nO [U5n[U5U[U54$) aReturn shape and axes with length-1 dimensions removed. Remove unused dimensions unless their axes are listed in ``skip``. Parameters: shape: Sequence of dimension sizes. axes: Character codes for dimensions in ``shape``. skip: Character codes for dimensions whose length-1 dimensions are not removed. The default is 'XY'. Returns: shape: Sequence of dimension sizes with length-1 dimensions removed. axes: Character codes for dimensions in output ``shape``. kept: Dimensions were kept (True) or removed (False). Examples: >>> squeeze_axes((5, 1, 2, 1, 1), 'TZYXC') ((5, 2, 1), 'TYX', (True, False, True, True, False)) >>> squeeze_axes((1,), 'Q') ((1,), 'Q', (True,)) z)dimensions of axes and shape do not matchrt)rrrXrrYTr4rYFrrKr=)rrr~rrrrzr) rrrrkeptr r~ rrs rvrr,`sD 5zSY9o U|T2%% |4D "N!MD1 !8rz KK   ! !$ '   $ KK  2 >aReBi(T"X&$ww}%]# . !4t 55rucUcSn[U5UR:wa(S[U5<SUR<3n[U5e[U5nUHnXT;dM SU<3n[U5e [ U5Vs/sH oUU;dM UPM nnSR U5U-nUR S[U5-UR-5nURUVs/sHoWRU5PM sn5$s snfs snf)aReturn image array with its axes permuted to match specified axes. Parameters: image: Image array to permute. axes: Character codes for dimensions in image array. Length must equal the number of dimensions in ``image``. asaxes: Character codes for dimensions in output image array. The default is 'CTZYX'. Returns: Transposed image array. A length-1 dimension is added for added dimensions. A view of the input array is returned if possible. Examples: >>> import numpy >>> transpose_axes( ... numpy.zeros((2, 3, 4, 5)), 'TYXC', asaxes='CTZYX' ... ).shape (5, 2, 1, 3, 4) CTZYXr z != image.ndim=z unknown axis r=r) rrrr]rrrtr transposer)rrasaxesrvalidrmissingrts rvrLrLj`s>~ 4yEJJT , .o f E ?!"(CS/ ! %V,?,b$r,G? 4'I MM$W- ; D D Dcgryrtrrrunknowns rvrGrG`s rucgryrtrs rvrGrG`sruc[U5n[U5n[U5[U5:wa'S[U5<S[U5<3n[U5e[U5n[U5nXV:waSUSU3n[U5eU(d U(d[ U[ 5(aS$S$[ S[U5[U5- 5nU(aUSU--n[U5S - nS n S n /n US S S 2Hn X-n US:a)XS :Xa!U S :waUS -nUS:aXS :XaU S :waMXU:Xa+XX-:Xa!XU-n U RX5 US -nMiU RU=(d S 5 M [ U[ 5(aSR[XS 55nU$[[XS 55nU$) a-Return axes matching new shape. Parameters: axes: Character codes for dimensions in ``shape``. shape: Input shape matching ``axes``. newshape: Output shape matching output axes. Size must match size of ``shape``. unknown: Character used for new axes in output. The default is 'Q'. Returns: Character codes for dimensions in ``newshape``. Examples: >>> reshape_axes('YXS', (219, 301, 1), (219, 301)) 'YX' >>> reshape_axes('IYX', (12, 219, 301), (3, 4, 219, 1, 301, 1)) 'QQYQXQ' r r cannot reshape rr=rtrrrYNrKr/ ) r~rrr@rrzrkrrr) rrrrrrr lendiffrprodnsprodsrrs rvrGrG`s< %LEXH 4yCJT ,U .o 5>DhG wd8*5o c**r22!SZ#h-/0GdWn, E QA F E Fttn !eA "' FA!eA "' q>f(88 1X E MM$' " FA MM'.S )$wwxx 012 KXfX./0 Krurc ^[R"[R"[R"USS95SS9m[ S[R "TSS955nU(a[ U4SjU55nU$)aReturn order of axes sorted by variations in indices. Parameters: indices: Multi-dimensional indices of chunks in array. If only one row is provided, all axes appear non-varying and are returned in their natural order. squeeze: Remove length-1 dimensions of nonvarying axes. If all axes are constant, an empty tuple is returned. Returns: Order of axes sorted by variations in indices. The axis with the least variations in indices is returned first, the axis varying fastest is last. Examples: Axis 0 varies fastest; axis 1 is constant and squeezed out: >>> order_axes( ... [(0, 2, 0), (1, 2, 0), (0, 2, 1), (1, 2, 1)], squeeze=True ... ) (2, 0) rrc38# UHn[U5v M g7fryrrs rvrorder_axes..asC"BQ#a&&"BrT)stablec3>># UHnTUS:wdMUv M g7fr0rt)rrrs rvrras7A$q'Q,aas  )rrr- rr~rl)rrr rs @rvrr`s\< 99UYYuzz':;! DD C%--T"BC CE777 Lruc8[U5n[U5nUS:XaUS:XagUS:XdUS:XagX2-(ag[[U55nSnS=pV[U5H8nXW-nXSH)nUS- nXh-nXx:XdXV:Xa M$US:XaM!Xe:wdM( g M: g)aReturn if page and series shapes are compatible. Compatible means the series product is a multiple of the page product and the trailing dimensions of both shapes align such that pages tile exactly into the series without remainder. Parameters: page_shape: Shape of a single page. series_shape: Shape of the full series. Returns: ``True`` if the page can tile exactly into the series, else ``False``. rTFrYN)r@r~r) r| series_shaper_ series_sizer pipjrr2s rvr:r: as" #I,'KA~+*A~),/0L AKB j ! b!A FA GBvAvx" " rurTcgryrtr r rrs rv subresolutionrMarucgryrtrs rvrrSarrucURUR:wdURUR:wagSn[URR5URURSS9HxupVnUS;aeUc;[ U5H*nX(-n X:a gXi-U:XdXi-S- U -U:XdM'Un MF gX$-n X:a gXi-U:waXi-S- U -U:wa gMoMqXg:wdMx g U$)aReturn level of subresolution of series or page b vs a. Parameters: a: Reference page or series. b: Candidate page or series to test against ``a``. p: Downsampling factor per pyramid level. n: Maximum number of pyramid levels to test. Returns: Pyramid level of ``b`` relative to ``a``, or ``None`` if ``b`` is not a subresolution of ``a``. Level 0 means same resolution as ``a``. NTr4xyzrY)rrrrrr) r r rrrrrr2rWrs rvrrYas( vv177agg- E Fq ;}qAAu#v{quqyQ&6!&; !" H56Q;AEAI!#3q#8$9; V/G0 Lru)rAsamplingfactorsc8UcSnSnU[U5:GaXnSnUS-nURR(aUS- nM=U[U5:aXnU(a"URR(dUS- nM<Uc/UH"n[ UR SXxS9S:XdM Un O+ US- nMn[ UR SXuS9S:waUS- nMUR R U5 X U[U5:aMUS- nU[U5:aGMgg)aPyramidize list of TiffPageSeries in-place. TiffPageSeries that are a subresolution of another TiffPageSeries are appended to the other's TiffPageSeries levels and removed from the list. Levels are to be ordered by size using the same downsampling factor. Each candidate series must be exactly one subresolution step below the previously added level. TiffPageSeries of subifds cannot be pyramid top levels. Parameters: series: List of TiffPageSeries to pyramidize in-place. reduced: Only consider series whose keyframe is reduced image as pyramid levels. samplingfactors: Downsampling factors to probe when detecting the pyramid factor. The default is (2, 3, 4). N)rTrrrrYrKr)rrrcrrrr) rrArrr rr2r rs rvr6r6as6# A c&k/ I  E ::   FA #f+o Aqzz44Qy(A$QXXb\1:a?) FAqxx|Q49Q HHOOA  %#f+o& Q7 c&k//ru)rK r*rrc B[U5nUS:Xa Sn[U5eUS:Xa&Uc#X5S'USceUSR"SSU0UD6$[SU55nUceUcU/UR Q7O UR n UR n U ce[XIU 5nUbUS:axURn [U[R5nUS:XdU S:aS=p;OhUS :d6U S ::a3URS:Xa#URS:XaURS:XaSnO)Sn O&US:XaS=p;OXc:dURS :aSn OUn SnXS'URR n Uc=U R"n U (dUS:dU S:aU R%S 5 U R&nOS n [)[+S U5US 9nUcUUUU4SSjjnUS :a[-U5HunnU"UU5 M OTUR/5 [1U5nUR3X[5U55HnM SSS5 O Sn[7U5eUR95 U (dU R%S5 U$![a Sn[U5Sef=f!,(df  NT=f)a#Return vertically stacked image arrays from sequence of TIFF pages. Parameters: pages: TIFF pages or frames to stack. tiled: Organize pages in non-overlapping grid (not implemented). lock: Reentrant lock to synchronize seeks and reads from file. maxworkers: Maximum number of threads to concurrently decode pages or segments. By default, use up to :py:attr:`_TIFF.MAXWORKERS` threads. out: Output destination for frame data. By default, a new NumPy array is created. If a *numpy.ndarray*, a writable array to which the images are copied. If a string or open file, the file used to create a memory-mapped array. **kwargs: Additional arguments passed to :py:meth:`TiffPage.asarray`. rzno pagesrYNrrc3B# UHocMURv M g7fryr[rs rvrstack_pages..as@AZQZZsrrrTTr)rr*cUcX!RS5 gURURR5 UR"SXBUS.UD6 UR URR5 g)Nr)r*rrt)fillrDrrrr)rrrrr*rs rvrstack_pages..func#bs[| "t{{556 A$JA&A 6 67ruztiled stacking not implementedFrt)rrrrrrgrrr*rrrr6r)rrrrrrrr-rrrrrrVrrrr r r*rrkrrrTr8rrr )rrK r*rrrrrrrrpage_maxworkersrlhaslockrrrrr;rs rvrrasBZF {o {u})|Qx###Qx2C2622(@@@   &+mV "ekk "E KKE    E *CZ!^**1 ?o1+, ,J aZ q !!Q&1$1$JO q'(( _   0 01 4$ *<  B |++JN/B KK wws1j1=I } #,9=%+  8- 8 8 8!  8 7  8 #  8 8" >(/ tT5! 0    #J/8!d5=AAB0/ /!#&&:OO  E JY ("o4'(J0/s I4#J4J  Jzw+)rsuffixrc[U5n[R"U5nUcMUc[R"X5$U(a[R"XU5$[R "X5$[ U[R5(a[U5[UR5:waSUSUR3n[U5e[R"X R5(dSUSUR3n[U5eURU:waURUSS9nUbURU5 U$[ U[5(aqURS5(a[SSKnUS S=(d SnUcS nUR#XS 9n [R$"XX#S 9nUbURU5 UsSSS5 $[R$"XX#S 9nUbURU5 U$!,(df  N9=f) atReturn NumPy array where data of shape and dtype can be copied. Parameters: out: Specifies kind of array of ``shape`` and ``dtype`` to return: ``None``: Return new array. ``numpy.ndarray``: Return view of existing array. ``'memmap'`` or ``'memmap:tempdir'``: Return memory-map to array stored in temporary binary file. ``str`` or open file: Return memory-map to array stored in specified binary file. shape: Shape of array to return. dtype: Data type of array to return. If ``out`` is an existing array, ``dtype`` must be castable to its data type. mode: File mode to create memory-mapped array. Only used when ``out`` is a file path or ``'memmap'``. The default is 'w+' to create new, or overwrite existing file for reading and writing. suffix: Suffix of ``NamedTemporaryFile`` if ``out`` is ``'memmap'``. Only used when ``out`` is ``'memmap'``. The default is '.memmap'. fillvalue: Value to initialize output array. By default, return uninitialized array. Returns: NumPy array or memory-mapped array of ``shape`` and ``dtype``. Raises: ValueError: Existing array cannot be reshaped to ``shape`` or cast to ``dtype``. Nrrz cannot cast Frr:rrz.memmap)rCr)rrr)r~rrrBr;rrr8r@rrrrtrrzrtempfileNamedTemporaryFiler:) rrrrrrrrtempdirrls rvr-r-cbsh %LE KK E {  ;;u, , ::e6 6{{5((#u}}%% 5>WSYY/ /#E7$syyk:CS/ !~~eYY// tCII;7CS/ ! 99 ++e%+0C  HHY  #sx 8 8ab'/T >F  ( (W ( D,,reGC$# E D ,,su @C  JE Ds +G99 Hc^^^^SU4SjjmSSjmSS.SSjjmSUU4SjjnSU;dSU;a0nUR5HwnUR5nU(aUS S :XdS U;aM+URS S 5umnTR5m[U4S jS55(aMlU"U5UT'My U$U"U5$)aReturn Python object from Matlab string representation. Use to access ScanImage metadata. Parameters: matlabstr: String representation of Matlab objects. Returns: Matlab structures are returned as ``dict``. Matlab arrays or cells are returned as ``lists``. Other Matlab objects are returned as ``str``, ``bool``, ``int``, or ``float``. Examples: >>> matlabstr2py('1') 1 >>> matlabstr2py("['x y z' true false; 1 2.0 -3e4; NaN Inf @class]") [['x y z', True, False], [1, 2.0, -30000.0], [nan, inf, '@class']] >>> d = matlabstr2py( ... "SI.hChannels.channelType = {'stripe' 'stripe'}\n" ... "SI.hChannels.channelsActive = 2" ... ) >>> d['SI.hChannels.channelType'] ['stripe', 'stripe'] c >S/nT"U5up#UcO_US:XaURS5 OAUS:XaURS5 O)US:XaURS5 OURU5 XSnMmURS5 U$)NrrG)r r)rrr )r r )rr)rr*r.r next_tokens rvlexmatlabstr2py..lexbsa=DAyCx j)c j)c j) a "A  c ruc[U5nUS:XagSnX!:a:XR5(a#US- nX!:aXR5(aM#X!:XaSU4$XS;a XUS-4$XS:Xa+URSUS-5nUS:aUOUnXUS-US-4$XS:Xa+URSUS-5nUS:aUOUnXUS-US-4$UnX1:aXS;aUS- nX1:a XS;aMXUU4$) NrrrYz{[;]}rrsrrz {[;]})risspacer)rrYrr2s rvr matlabstr2py..next_tokenbs*Q Q; jQT\\^^ FAjQT\\^^ ;7N 47?4Q;  43;sAE"A!VAQ<Q& & 43;sAE"A!VAQ<Q& & jQT1 FAjQT11vqyruFfailc ^TR5mT(dT$TSS:Xa)U(a TSS:wd STSS;a [T5eTSS$TSS:Xa&U(a TSS:wd STSS;a [T5eT$U(a%[U4SjS55(a [T5eTSS :XaT$TS ;ag TS ;ag TSSS:XaP[R"TSSR S5Vs/sHn[ U5PM sn5R5$TSSS:XaP[R"TSSR S5Vs/sHn[ U5PM sn5R5$ST;dST;a [T5$[ T5$s snfs snf![[4a N(f=f![[4a Of=f[T5$![[4anU(a[UeSnAT$SnAff=f)NrrrKrYrsrrc3,># UH oT;v M g7fryrt)rrrs rvr.matlabstr2py..value..cs2 1Q rz ';[]{}r >Truer T>Falser Frzzeros(r|rzones(r}r) rcrr;rrrrronesrYr)rrrrs` rvrOmatlabstr2py..valuecs GGIH Q43;2##1R. m#Qr7N Q43;2##1R. m#H C2 222Q-  Q43;H   " " Ra5H ;;!B c0BC0B1A0BCDKKM M Ra5G ::q2w}}S/AB/A!s1v/ABCJJL L !8sax Qx q6M DBz*  :&    *8O:& * c) *sH0F F F! F7!F43F47G  G  GH)G==HcN>UR5nT"USS9$![a Of=f/=pU/nT"U5HnUS;a/nURU5 MUS;a|[U5S:a OUR 5nUSn[U5S:Xa4[ US[ [45(aURUS5 MURU5 MURT"U55 M [U5S:Xa#[ US[ [45(aUS$U$) NTrz[{z]}rTrKrYr)rcrrrrrrMrz)rraddtorr.rrrOs rvr( matlabstr2py..parse/cs  GGI & &   QADy e$dv;?JJLr q6Q;:adT3K#@#@LL1&LLO U1X& v;!  6!9tSk B B!9  s  '' r r%rHrYc3,># UH oT;v M g7fryrt)rrrs rvrmatlabstr2py..Wcs/;a6;rz ';[]{}<>)rrzr6r )rrzr6ztuple[str | None, int])rrzrrr6rg)rrzr6rg)rrcrr;) matlabstrr( rr rrrrrOs @@@@rvr9r9bs<&2','R> yDI- ((*D::S_::c1%DAq A/;///8AaD+  rucSnUbU/UQ7OUHn[R"X5s $ SU<S3n[U5e![a M=f=f)aReturn datetime corresponding to date string using common formats. Parameters: datetime_string: String representation of date and time. fmt: Format of ``datetime_string``. By default, several datetime formats commonly found in TIFF files are parsed. Raises: ValueError: ``datetime_string`` does not match any known format. Examples: >>> strptime('2022:08:01 22:23:24') datetime.datetime(2022, 8, 1, 22, 23, 24) )rr7r#z%Y-%m-%dT%H:%M:%S.%fz%Y-%m-%dT%H:%M:%Sz%Y:%m:%d %H:%M:%S.%fz%d/%m/%Y %H:%M:%Sz%d/%m/%Y %H:%M:%S.%fz%m/%d/%Y %I:%M:%S %pz%m/%d/%Y %I:%M:%S.%f %pz%Y%m%d %H:%M:%Sz%Y/%m/%d %H:%M:%Sz%Y/%m/%d %H:%M:%S.%fz%Y-%m-%dT%H:%M:%S%zz%Y-%m-%dT%H:%M:%S.%f%zz time data z does not match any format)rhrIr)datetime_stringrformatsfmt_rs rvrIrI^csk&G"$'?w? $$_; ;@ ))C DC S/   s> A  A cgryrtrOr r s rvr4r4c rucgryrtrs rvr4r4crrucUR5R5nUbUO[U[5(aSOSnUbUO[U[5(aSOSnX;agX;agU<S3n[ U5e)zReturn string as bool if possible, else raise TypeError. Custom ``true`` and ``false`` sequences must contain lowercase strings. >>> asbool(b' False ') False >>> asbool('ON', ['on'], ['off']) True strue)r sfalse)r TFz" is not a recognized boolean value)rcrrr{r)rOr r true_vals false_valsrs rvr4r4cs KKM   !E   #E511gy   $UE22h     I7 8C C.rucUc[[[[4nUH nU"U5s $ U$![[ [ [4a M/f=f)aReturn argument converted to first matching type. By default, tries to convert to ``int``, ``float``, ``bool`` (via ``asbool``), and ``str`` (via ``bytes2str``), in that order. >>> astype('42') 42 >>> astype('3.14') 3.14 >>> astype('True') True >>> astype(b'Neee-Wom') 'Neee-Wom' )rrYr4rrrrr)rOr:typs rvr,r,cs[( }eVY/ u:  L          s.A  A c [U[[45(a[USUS5nODUS:Xag[U5n[ S[ S[ U5- 55nURU5nURUR4$)zReturn rational numerator and denominator from float or two integers. >>> rational(0.5) (1, 2) >>> rational((3, 4)) (3, 4) >>> rational(0) (0, 1) rrYrrU) rr~rMrWrrr- limit_denominator numerator denominator)rxrmax_denominators rvrArAcsy#t}%% SVSV $ !8 SMj#j3q6.A*BC   0 ;; %%ruc## [5n0nUHsnX1;aURU5 Uv MURUS5S-X#'UX#3nXA;aX#==S- ss'UX#3nXA;aMURU5 Uv Mu g7f)zReturn iterator over unique strings, appending a counter to duplicates. >>> list(unique_strings(iter(('a', 'b', 'a')))) ['a', 'b', 'a2'] >>> list(unique_strings(iter(('a', 'a2', 'a')))) ['a', 'a2', 'a3'] rYN)r!r$rS)stringsknownrar candidates rvrwrwcseEF  > IIaLG 1a(1,FI#fi[)I$ Q  c&)- $ IIi Os A+B /B c^X:aUSS3$SHnUS-nX:dMUSSU3s $ USS3$)zReturn file size as string from byte size. Sizes below 1.5 KiB (1536 B) are shown in bytes; larger sizes are shown in the largest unit that keeps the value below the threshold. >>> format_size(1234) '1234 B' >>> format_size(12345678901) '11.50 GiB' z.0fz B)KiBMiBGiBTiBPiBg@z.2frz PiBrt)r thresholdrs rvr0r0dsU s23   3Zq' '43Zt rucU$)zCSingle argument identity function. >>> identityfunc('arg') 'arg' rt)rxrrs rvr r (ds  Jrucg)z4Null function. >>> nullfunc('arg', kwarg='kwarg') Nrt)rrs rvr<r<2ds  ruc8SnUHnU[U5-nM U$)zReturn product of integers. Equivalent of ``math.prod(iterable)``, but multiplying NumPy integers does not overflow. >>> product([2**8, 2**30]) 274877906944 >>> product([]) 1 rYr)iterableprodrs rvr@r@;ds& D D  Kruc@^^[T5mSUU4SjjnTU"54$)aReturn first item and new iterator that includes first item. The original iterator must not be used after calling this function. Raises: StopIteration: Iterator is empty. >>> first, it = peek_iterator(iter((0, 1, 2))) >>> first 0 >>> list(it) [0, 1, 2] c3.># Tv TShvN gN7fryrt)riteratorsrvnewiterpeek_iterator..newiter^ds s )r6rr)r5r6rs` @rvrvrvMds' NE ') rucR^[R"S5mSU4Sjjn[XS9$)zReturn naturally sorted list of strings. Use to sort file names containing numbers. >>> natural_sorted(['f1', 'f2', 'f10']) ['f1', 'f2', 'f10'] z(\d+)c>TRU5Vs/sH&nTRU5(a [U5OUPM( sn$s snfry)r fullmatchr)rrnumberss rvsortkeynatural_sorted..sortkeypdsG;B==;K ;Kag''**CF 1;K   s-Ar )rrzr6zlist[int | str])rirjru)r1r=r<s @rvr;r;eds%jj"G ( ((ruc@[R"US-US- -5$)zReturn datetime object from epicsTSSec and epicsTSNsec tag values. >>> epics_datetime(802117916, 103746502) datetime.datetime(2015, 6, 2, 11, 31, 56, 103746) i%geA)rh fromtimestamp)secnsecs rvepics_datetimerCxds"  ! !# /D3J"> ??rucB[R"U5[US9-$)a_Return datetime from Excel serial timestamp. Use to convert LSM time stamps. Parameters: timestamp: Excel serial date (days since epoch, fractional part is time). epoch: Ordinal of day 0. Default is 1899-12-30 (standard Excel epoch). >>> excel_datetime(40237.029999999795) datetime.datetime(2010, 2, 28, 0, 43, 11, 999982) )days)rh fromordinalr~ )rqepochs rvexcel_datetimerHds&    & )B BBruc US::aSU<S3n[U5eUS-nUS:a*[R"US- S- 5nUSU-US-- - nUS -n[R"US - S - 5n[R"S U-5n[R"XW- S - 5nXW- [S U-5- n XS ::aSOS - n XjS:aSOS- n Un [ U S5up[ U S5up[ U S5up[ XXXU S-5$)aReturn datetime from days since 1/1/4713 BC and ms since midnight. Convert Julian dates according to MetaMorph. Algorithm after Meeus, "Astronomical Algorithms", ch. 7. >>> julian_datetime(2451576, 54362783) datetime.datetime(2000, 2, 2, 15, 6, 2, 783000) >>> julian_datetime(1721423) Traceback (most recent call last): ... ValueError: no datetime before year 1 (julianday=1721423) iODz%no datetime before year 1 (julianday=rzrYi#g@}@rrTiliki6i`r)rrotruncrrrh) juliandayrrr rQr rrrrrrrrrrs rvrrds"G6I' (big-endian), '=' (native), as well as the sys.byteorder strings 'little' and 'big'. >>> byteorder_isnative('=') True rHTrrrs)r<rJ)r_rrS)rr* s rvrrds?S#--((# &D 88I )T#---@ @@rucVXS1;dUS:XagUS:Xa[nUS:Xa[nX:H$)asReturn if two NumPy byte-order characters are equivalent. The byte-order characters are '<' (little-endian), '>' (big-endian), '=' (native), and '|' (not applicable). '|' matches any order. >>> byteorder_compare('<', '<') True >>> byteorder_compare('>', '<') False >>> byteorder_compare('|', '>') True >>> byteorder_compare('=', '<') # on a little-endian system True rITrH)rL)rr3s rvbyteorder_comparerOds9 CL ESLC$  |   rucUbUR5RSS5RS5(aW[R"SU[R 5nUbUS[ URS55nURX5$URS5nUS:aUSUnURUcS U5$UU5$![a UbeURS U5s$f=f) aReturn Unicode string from encoded bytes up to first NULL character. Parameters: b: Bytes to decode. encoding: Character encoding of ``b``. The default is to try UTF-8, falling back to cp1252 on failure. errors: Error handling for :py:meth:`bytes.decode`. Raises: UnicodeDecodeError: Decoding with the specified ``encoding`` failed. N-rutf_16s^((?:..)*?)\x00\x00rYr+rrr) rrrrirrkrgrouprrr)r r rr-rs rvrrds& 0 8 8c B M M!! II-q")) < =#C O$Axx)) wAAv bqE*xx8#36JJ6JJ *   xx&))*s,CC C+*C+c^0nURRHnUSSup4XnURS:Xa%UR5nUSS:Xa [ U5nODURS:Xa4UR5nUSS:XaUVs/sHn[ U5PM nnXQU'M U$s snf)a Return numpy.recarray as dictionary. >>> r = numpy.array( ... [(1.0, 2, 'a'), (3.0, 4, 'bc')], ... dtype=[('x', '>> recarray2dict(r) {'x': [1.0, 3.0], 'y': [2, 4], 's': ['a', 'bc']} >>> recarray2dict(r[1]) {'x': 3.0, 'y': 4, 's': 'bc'} NrTrrYrS)rdescrrrr)recarrayrrUrrrOrs rvr"r"esF%%BQi  ::?LLNEQx3!%( ZZ1_LLNEQx3/45u!1u5t & M6s B*r|)sanitizeror_c^^^^^^SSKJn U=(d SummSUU4SjjmSUUUUU4SjjmT"URU55$)aReturn XML as dictionary. Parameters: xml: XML data to convert. sanitize: Remove prefix from from etree Element. prefix: Prefixes for dictionary keys. sep: Sequence separator. Pass empty string to disable sequence parsing. Examples: >>> xml2dict( ... '1' ... ) {'root': {'key': 1, 'attr': 'name'}} >>> xml2dict('3.5322,-3.14') {'level1': {'level2': (3.5322, -3.14)}} rrv)r=r=cn>[U[5(dU$T(a]TU;aW/nURT5H5nT"U5n[U[5(aUs $URU5 M7 [ U5$[ [ [4H nU"U5s $ U$![[4a M%f=fry) rrzrrr~rrYr4rr)rOrr rr.r,r_s rvr,xml2dict..astypeOes%%%L 3%<F{{3'3Ka%% L a ( = uf%A x&  z*  sB  B43B4c H>URnT (aURSS5SnUS0n[U5nU(a[R"[5n[ T U5H/nUR 5HupgXFRU5 M M1 XR 5VVs0sHupgU[U5S:XaUSOU_M snn0nUR(aQ[X![5(d0X!'X!RU U 4SjURR 555 UR(aUURR5nU(dUR(aU(aT "U5X!T S-'U$T "U5X!'U$s snnf)N}rYrKrc3B># UHupTU-T"U54v M g7fryrt)rrrr,ats rvr/xml2dict..etree2dict..ses"K:J$!266!9-:JsrO)rrsplitrM collections defaultdictr8r`rrrrrr rrc)r.rrchildrendddcrrrr,r^ etree2dictrWrs rvrfxml2dict..etree2dictces@ee **S!$R(C $K7 ((.B*h/HHJDAELLO'0Lq#a&A+!A$14LMA 88afd++ FMMK!((..:JK K 6666<<>D188+1$>> import binascii >>> hexdump(binascii.unhexlify('49492a00080000000e00fe0004000100')) '49 49 2a 00 08 00 00 00 0e 00 fe 00 04 00 01 00 II*.............' rYrTr=rurs%%0%ix: s%xrNr s...rs [^\x20-\x7f].c32># UH nTXS-v M g7fr= rt)rr2r+s rvrhexdump..esO1NA1QQ<1Nrr r)rrrorpr- floorrrgbinasciirhexlifyrisubrrr)rrXrrir rjraddr bytesperlinenlinesrxrrg end1end2elpsrrrbstrhexstrstrstrrrWr+s @rvr1r1esD t9D ax519  { D )a/F: ;T  ! S.. D1H -!3> ?  ! L 3tax=04./ ~1 S[ 1 FO, z [F{fkd=L)*+L  v'd) 10uv,'(  VaZ#d4Cj/"$23   <' 'D  D Ud  [4  & [$d{}- .   L1$3tax=<1+>> isprintable('abc') True >>> isprintable(b'\01') False TF)rcrrz isprintablerr)r>s rvrres`\\^F &#!!## }}**,,    sA A*)A*compactc$[R"SSU5n[R"SSU5nURSS5nU(a8[R"SSURSS5RSS55nUR5$)zReturn string with compressed whitespace. >>> clean_whitespace(' a \n\n\n b ') 'a\n b' >>> clean_whitespace(' a \n\n b ', compact=True) 'a b' z (\r\n|\r|\n)+r z [ \t]{2,}|\trz z[ r)rirtrrc)r>rs rvclean_whitespacerfswVV$dF 3F VVOS& 1F ^^E4 (F S&..s";"C"CD#"N  <<>rucSRSU55nUR5Vs/sH o"(dM UPM nnU(dgUS/nURSUSS55 SRU5$s snf)a3Return joined string representations of objects with indented lines. The first line is not indented. Subsequent non-empty lines are indented by two spaces. Empty lines are dropped. >>> print(indent('Title:', 'Text')) Title: Text >>> print(indent('Title:', 'Line1', '', 'Line3')) Title: Line1 Line3 r c38# UHn[U5v M g7fryr)rrxs rvrindent..0fs.#SXXrr=rc3,# UH nSU-v M g7fr rtrr s rvrr5fs4)$$+)r" rYN)rrr)rrr rrs rvr%r%!fst 99.. .D"oo/ 8/d4T/E 8 AhZF MM4%)44 99V  9s A;A;cSSKJn [U[5(aUOUR 5nSSKJn UR[R"U55nURUSSURR=(d SS9n[U[5(de[U5nS R%S UR'555$![aE U"U5RSS9nNH![ a [U5R#S S 5nNpf=f[ aE U"U5RSS9nN![ a [U5R#S S 5nNf=ff=f) zReturn pretty formatted XML.r) parseStringr Tr)r r r r)r%z> .YfsF'D ::< < T3''c299;;'s A7A)xml.dom.minidomrrr{rgr r r( r}r~rdocinfor rr toprettyxmlrrrr)r rxmlbr r formattedrs rv pformat_xmlr9fsP+#C//#SZZ\D;{{2::d+,NN  \\**5g # )U++++9% 99%%'  ; ; &22#2>F ;t_,,T6:F ; ; ; &22#2>F ;t_,,T6:F ; ;sHA)rXrr r rXrF)rXr sort_dictsTrrTr c3,># UH oSTv M g7fryrtrr rs rvrpformat..fs )M) )Mrrc3,># UH oSTv M g7fryrtrs rvrrfsC]TZi(]rrt)pprintrget_printoptionsset_printoptionsrr{rrrrr1rzrrr r?rMrrr) rxrrXrrrnpoptarglheadtails ` rvr?r?`fsQ ~! } IM  " " $E SE:/( c5 ! !2Aw}}(*c"#h'.AnS!!&y~6sqIN ''K c3  2Aw}}')SX-?+1A+c+AI&;s;K**,C U\\ * ***,%%'C&..'e!C '' {/EM"sD1:I  !D Q;D A: D 4y6ii )M4;)M)MUV )M   JiiCT'6]CC J# ''sA0H8B.H88I)rirjcUcSnUcSn[U5nUR5n/nUGH:n[U5nX::aURU5 M'US:XaUn O=S[U5s=:aS:aO O[R "X-5n O [ U5n U S:aX- n [U S5n US:XdXS-:a2U S::aURXq*S5 MURUSU5 MU S::aURX7XA- S-5 MX:dXS-:aURUSX- U-5 GM X- U-n XS-- n X-n URUSU U-X|S-5 GM= SRU5$) uReturn string cut to specified length. Parameters: string: String to snip. width: Maximum length of returned string. snipat: Approximate position at which to split long strings. The default is 0.5. ellipsis: Characters to insert between splits of long strings. The default is '…'. Examples: >>> snipstr('abcdefghijklmnop', 8, ellipsis='...') 'abc...op' N?u…rYrrrTr ) rrrr- rorqrrkr) r>rXrirjrWrrr linelenrsplitlenrxrys rvr*r*fs6~ ME""$J Fd)   MM$   Q;E V q JJw/0EKE 19  EqME A:*z d67m, d6El+ aZ MM(%-/%:: ;  !2 MM$/(: ;.Hq=(D?D MM$u+04;> ?=@ 99V rucRUR=(d [UR5$)zXReturn short string representation of Enum member. >>> enumstr(PHOTOMETRIC.RGB) 'RGB' )rrzrO)members rvr/r/gs ;; +#fll++rucU"U5$![[4aL XR5s$![[4a#nUR SU<3n[U5UeSnAff=ff=f)aqReturn enum member from its name or value. Parameters: enumtype: Type of IntEnum. arg: Name or value of enum member. Returns: Enum member matching name or value. Raises: ValueError: No enum member matches name or value. Examples: >>> enumarg(PHOTOMETRIC, 2) >>> enumarg(PHOTOMETRIC, 'RGB') z: invalid argument N)rrrNrrr)enumtyperxrrs rvr.r. gsr(+}  "+ +IIK( (.) +&&'':3'BCS/s * ++s( A&/A&A"AA""A&c0nUHnX@;dM URU5X4'M UR5H#upEX@;aURU5X4'MXSU'M% U$)aExtract keys from kwargs into a new dict, removing them from kwargs. Keys listed in ``keys`` are extracted by name only. Keys listed in ``keyvalues`` are extracted by name if present in ``kwargs``, otherwise their default value is used. Extracted keys are deleted from ``kwargs``. >>> kwargs = {'one': 1, 'two': 2, 'four': 4} >>> parse_kwargs(kwargs, 'two', 'three', four=None, five=5) {'two': 2, 'four': 4, 'five': 5} >>> kwargs {'one': 1} >>> parse_kwargs({}, 'a', b=2) {'b': 2} )rr`)rr* keyvaluesrrrOs rvr>r>+gs^&F = **S/FK oo'  = **S/FK3K ( Mruc XUR5Hup#URX#5 M g)zUpdate dict with keys and values if keys do not already exist. >>> kwargs = {'one': 1} >>> update_kwargs(kwargs, one=None, two=2) >>> kwargs {'one': 1, 'two': 2} N)r`rP)rrrrOs rvrMrMJgs% oo' #%(ruc bUR5VVs0sH upUcM X_M snn$s snnf)zkReturn kwargs as dict, excluding items with None values. >>> kwargs_notnone(one=1, none=None) {'one': 1} )r`)rrrs rvrrWgs*$\\^ =^TQqDAD^ == =s ++c.[R"S5$)z"Return logger for tifffile module.tifffile)logging getLoggerrtrurvr7r7ags   Z ((ruc^ SSKnUc [SS15nUcSnURXSS/URS9nS nUR 5HlnUR 5nURU5(dM+U[U5SR5m [U 4S jU55(aMc[T 5e g![anS U<3n[ U5UeSnAff=f) a Validate TIFF file with ``jhove -m TIFF-hul``. JHOVE does not support the BigTIFF format, more than 50 IFDs, and many TIFF extensions. Parameters: filename: Name of TIFF file to validate. jhove: Path of jhove app. The default is 'jhove'. ignore: Jhove error message to ignore. Raises: ValueError: Jhove printed error message and did not contain one of strings in ``ignore``. References: - `JHOVE TIFF-hul Module `_ rNzMore than 50 IFDszPredictor value out of rangejhovez-mzTIFF-hul)stderrzjhove executable not found: sErrorMessage: c3,># UH oT;v M g7fryrt)rrrs rvr!validate_jhove..gs26aEz6r) subprocessr] check_outputSTDOUTr^rrcrrrr;r) rrrrrrrror rs @rvrNrNfgs8 ~ "@ A  }.%% dJ /$$& F zz| ??6 " "V'..0E26222 '' ! .,UI6$#-.sB<< CCCcUcSnUcSnUbSOSn[XS9nURUn[U[5(dSUS3n[ U5eUR R U5nUcP[U[5(a)[RR US5=(d UnSU<S 3n[U5eUcURsSSS5 $URU5 SSS5 g!,(df  g=f) aReturn or replace ImageDescription value in first page of TIFF file. Parameters: arg: Specifies TIFF file to open. comment: 7-bit ASCII string or bytes to replace existing tag value. The existing value is zeroed. pageindex: Index of page which ImageDescription tag value to read or replace. The default is 0. tagcode: Code of tag which value to read or replace. The default is 270 (ImageDescription). Returns: ``None``, if ``comment`` is specified. Else, the current value of the specified tag in the specified page. Raises: IndexError: If ``pageindex`` is not found. ValueError: If the specified tag is not found in the page. Nrrr)rrkz not foundzno z tag found) rrrrr4rrSrrrrrOr) rxr rtagcoderrrrrs rvrKrKgs> +D # !Syy#$))i[ 3CS/ !iimmG$ ;'3''))--6A'{*-CS/ ! ?99 " ! g " ! !sB2C2C22 D) rrrrrrrr groupnamern zarr_formatc Uc[R"U5S-n[U5n U RUUUUUUU S9nUR UUU U U S9 SSS5 SSS5 U$!,(df  N=f!,(df  U$=f)axWrite fsspec ReferenceFileSystem in JSON format for data in TIFF file. By default, the first series, including all levels, is exported. Parameters: filename: Name of TIFF file to reference. url: Base URL of the remote TIFF file, without filename. out: Name of output JSON file. The default is ``filename`` with a '.json' extension appended. key, series, level, chunkmode, fillvalue, zattrs, squeeze: Passed to :py:meth:`TiffFile.aszarr`. groupname, version, zarr_format: Passed to :py:meth:`ZarrTiffStore.write_fsspec`. Returns: Path of written JSON file. Nz.json)rrrrrrr)rrnr)rr rr write_fsspec)rurlrrrrrrrrrrnrrrs rvrJrJgsL {ii!G+c      #    $ J#   $ Js"A5A$A5$ A2 .A55 B)rverbosecvU(a[O[nUcSnUcUnOUR5S:XaSnU(aURSS5nUS- nU"SSS S 9 [ 5n[ U5nUR (dU"S US S 9 S n[U5eURSnURn URn URn [U 5U R-n U"U5 U"[SSU 3SU 3SU 3S[U 535S S 9 U S:XaSS/U Q7n O^U S:XaS/U Q7n OQU S:Xa/U SSQSPSPU SSQ7n O9U S:Xa/U SSQSPU SSQ7n O#U R!S5(d Sn[U5eU"SSS S 9 UR#5 U SUS-U SUS-4n U(aXSU S USUS4-nS!S"[%U 5- -U -n [&R("U S#SU S$9n[&R("U SU S USUS4U S$9n[+U5n[-U S5Hn[-U S5Hn[-U S5Hn[-U S#5H&n[/U5nUceUR15UU'M( [-U S5Hmn[-U S5HXnUS%UUS-US-US-2UUS-US-US-24USS&U(aUR3UUUUUU4-5 U"S&SS S 9 MZ Mo M M M U"US S 9 SSS5 g!,(df  g=f)'aConvert [MP]TZCYX LSM file to series of BIN files. One BIN file containing 'ZCYX' data is created for each position, time, and tile. The position, time, and tile indices are encoded at the end of the filenames. Parameters: lsmfile: Name of LSM file to convert. binfile: Common name of output BIN files. The default is the name of the LSM file. tile: Y and X dimension sizes of BIN files. The default is (256, 256). verbose: Print status of conversion. N)rrrr z%%%%z*_(z%ic%iy%ix%i)_m%%ip%%it%%03iy%%ix%%i.binz Opening LSM file... r=Tri r )rznot a LSM filerr zaxes: zshape: zdtype: zsize: rrYrMPCYXrTMPZCYXrznot a *TZCYX LSM filez#Copying image from LSM to BIN filesryrKrrrrrrz.r})rl r<rrr)rrgrrrrrr@rr%r0rZrrrrBrrrrr )lsmfilebinfilerrprintstimerrrrrrrrrrrrr-rr.rQ rrrs rvr8r8hs6,3%F | F "//#v.?? #48 GE ' czz 4D )"CS/ !A {{ u~.u  $ %!%!+d+,-    5=NENE V^KKE W_2eBQi22A2ab 2E X /eBQi//U12Y/Ew'')CS/ !4"DI b T"X%uRyDH'<< rE"ItAwQ HHGCJ'%/{{59E2kk 2Yb 47DG 4E V uQxA58_uQxA"58_#E{#///"&,,.Q-#58_!&uQxA%) # !DG q1uQ.? ? !DG q1uQ.? ?!A&CF ' # 7aAq!_+D E"3Bd;"1- )%!" uD!A   s 0J1L** L8`)rrrrZ interpolationrvminvmaxfiguresubplotr window_titledpimaxdim backgroundshowc f^^ ^$^%^&^'^(^)UcSnUcSnUS;nTRS:XaTR[R5mTRRS:XaSnU(a:TR SS ;d'TR S :aTR S S ;dSnS nTR5mUS ;a [TS 5mO [TS5mTR m&T&S :a Sn[U5eT&S :XaSm&SnGOU(aWTR S S ;aDTR SS ;a1[R"TS S5m[R"TSS5mO}U(dvTR STR SS-:aSTR STR S S-:a0[R"TS S5m[R"TSS5mU=(a TR SS ;nT&U(aSOS -m&UcSnO[U[5(aUnOSnU(aBTSSU2SU2SU24mU(a+TR SU:dTR S U:aSnOASnO>TSSU2SU24mU(a+TR SU:dTR SU:aSnOSnUS:Xa;U(a4[R"T5nUS:aTS- mTRSSS9mGOTRRS;aU(aTRRS::aUc:[R "[R""TR555nO>[U[[R&45(dTRRS-nUceS U-nU(a-US:a TSU- -mOUS:aTUS- - mTRSSS9mGO TRRS:XaU(a&TR)5m[R*TTU:H'[R,"T5nU(a<US:a6TRR.S:XaTRS5mTU-mOmTU- mOgTRRS:XaSnOJTRRS :Xa.[R0"T5m[R,"T5nOSnU(aSnGOUcUnUGcTRRS!:Xad[R2"TR5R4n[R4"T5nUU:Xa[R4"TTU:5nOTRRS:Xam[7[R8"TR5R45n[R:"T5nUU:Xa[R:"TTU:5nOSnSS#KJn SS$K J!n T cURES%S&S'SS(9 URGU S)S*S+S,S-9m U bR[HRJ"[L5 T RNRPRRRUU 5 SSS5 U (a[WU RY55OSn[[U4S.j[]T&555nUR_S/US --S0US/-- S1S2S3S"S49 U cS5n URaU 5n UcS6nU RcU5 U (a6[U [d5(aU RgS75n URUU S8S99 UcMTRR.S::XaS;nO%TRRS<;dUS:XaS=nOS>nUS?:XaUS@- nURh"[Rj"TSAT&-R554UUUUSB.UD6m'U(dURm5 SQU$U%UU&4SCjjnSRSDjnUU l7UT'l8UT'l9T&(GaA[uSAT&-5m%ST[wT%5R5/m$[]T&5Vs/sHnTR US:dMUPM nn[yU5V Vs/sHNun nU"UR{SES/U S--SFSG45SHU3STR US- SSITR USJ3SK9PMP n!n nU!H n"SU"l>M U!UT4U$U U'4SLjjm)TT%4U$U)4SMjjm(TT%4U$U(4SNjjn#T RNRSOU#5 [yU5H!un nU!U RU4U(4SPjj5 M# U(aUR5 T U T'4$![a SnGNf=f![[$4a TRRS-nGN&f=f![a SnGNf=f![a SnGNf=f![a SnGNf=f![a S"nGN3f=f!,(df  GN=fs snfs snn f)Sa`Plot n-dimensional images with ``matplotlib.pyplot``. Parameters: data: Image array to display. photometric: Color space of image. planarconfig: How components of each pixel are stored. bitspersample: Number of bits per channel in integer RGB images. interpolation: Image interpolation method used in ``matplotlib.imshow``. The default is 'bilinear' for image dimensions > 512, else 'nearest'. cmap: Colormap mapping non-RGBA scalar data to colors. See ``matplotlib.colors.Colormap``. vmin: Minimum of data range covered by colormap. By default, the complete range of the data is covered. vmax: Maximum of data range covered by colormap. By default, the complete range of the data is covered. figure: Matplotlib figure to use for plotting. See ``matplotlib.figure.Figure``. subplot: A ``matplotlib.pyplot.subplot`` axis. title: Subplot title. window_title: Window title. dpi: Resolution of figure. maxdim: Maximum image width and length. background: Background color. show: Display figure. **kwargs: Additional arguments passed to :py:func:`matplotlib.pyplot.imshow`. Returns: Matplotlib figure, subplot, and plot axis. NrHr >rHrIfloat16r FrKrrTrrF> r]rh r^ri rJrk rFrGrl rz not an imagerryrPr .bilinearnearestrJrYrrruirrrrrrj pyplot)Sliderfontz sans-serifnormal)familyweightr)g$@g333333@Tz1.0rG)rfigsizeframeon facecolor edgecolorc3R># UHnTRUS:dMSv M g7frr)rr rs rvrimshow..lis#I[TDJJt4Dq4Hqq[s' 'gQ?g\(\?r gffffff?r )bottomtopleftrighthspacewspaceo)禛 r?rrz Windows-1252r>rrgraybufviridiscoolwarmrGrr)rrrrc>[US-5n[US-5nT(aTSX4STSUSSUSS3$TX4SUSSUSS3$![a g f=f) NrrYz @ z [4rr z @ [r=)rr4)rrcuraxdatcurrentrrs rv format_coordimshow..format_coordis CL CL "1+ad+,Cy1Q%r!AaHH14j\aU"QqE3 3  sAA AAcg)Nr=rt)r(s rv _nocursorimshow.._nocursorisrug?g333333?g?z Dimension z%.0f [r )rrvalminvalmaxvalinitvalfmtc>U[U5R5TS'TRTS5 [XSS9H&upESUlUR X5 SUlM( TR R5 g)NrYTr4F)r~rset_datareventsonset_valcanvasdraw) rsliders slider_axesrctrlr rrrs rv set_imageimshow..set_imageisruW~.668HQK NN8A; '!'tD  %  W]+ $ E MM   ruc>[U5nUTS'XU:XagXRU:aSnOUS:aURUS- nXU'T"U5 g)NrrY)rr)rr rrrrs rv on_changedimshow..on_changedis_%LEHQK % 4(( 4(1,!DM g ruc>URnTSn[U5S;a T"X45 gUS:XaT"X$S-U5 gUS:XaT"X$S- U5 gUS:Xa'U[UR5S- :XaSOUS-TS'gUS:Xa'US:Xa[UR5S- OUS- TS'gUS:XaT"URUS- U5 gUS :Xa T"SU5 gg) NrrDrrYrupdownrg home)rrzrr)r(rrrr rr s rv on_keypressedimshow..on_keypressedis))CA;D3x<'3%7=1,d37=1,d3#'3tzz?Q+>#>aD1H 59QYc$**o1D1H 4::d+a/61d#rukey_press_eventc>T"X5$ryrt)rr r s rvrimshow..is Jq4Dru)rrYrrYr6rz)r(rgr6rz)Brr,rrrrrrrHrrrrrkrrorplog2r5rrdr<nanmaxrabsoluteiinforrYfinfonanmin matplotlibrmatplotlib.widgetsrrcrrrrrmanagerwindowrrrrrsubplots_adjustr set_facecolorr{rr5 atleast_2dcolorbarrget_cursor_dataformat_cursor_datarMr~rrdrawon mpl_connectr r)*rrrrrZrrrrrrrrrrrrrrrr-datamaximinfminrrrnslidersrrr rrrsliderrrrrrr rs*` ` @@@@@@rvr5r5|hsX P  ~ + +E zzY{{5==) zz#  2& IIMdjjn6" <<>D  $"$" 99D axo qy TZZ^v-$**R.2N>>$B/D>>$B/D JJrNTZZ^q0 0 2B1!44>>$B/D>>$B/D2$**R.F2 U! M3 ' '!   C&'6'7F723 zz"~ )TZZ^i-G * ) C&'6')* zz"~ )TZZ^i-G * ) iE iioG S=19D{{3U{+ D $**--2}7L 8 $ $))DHHJ*? @ MC+?@@ JJ//!3M(((]" q M 12"  12;;s;/D C  99;D#(99D  ll4(G Ws]zz#%{{3'g~ C  C ~~d# ll4(G  <D <zz#%{{4::.22 99T?D4< 99T$+%67DC'U[[4889 <<-D4< <<TD[(9:D!) ~ &hQ G    #$$Y/ %%,,22<@0*/s5##%&QIU4[II8a<(td{"  nnW%G*  *% eU # #LL0E U $ | ::??c !D ZZ__ %DD , & DLD MM dTk*2245    #     E   (G%E(E td{#tE'N+3356(-d L tzz$7G!7Kt L%[1  24 ;;tq1u~ueDE"4&)zz$'!+ 4 013  2   F!FM%+D ! !*.w  '+G $ $&  !!"3]C -GAt AJ ! !d"D E.  7E !!u G  . 8 $ 3 3a 7  8& G  G "D"D(0/FM  s7f)8f(g gg0 h0h#h(>h(Ah- ff)gg gg g-,g-0 h?h hh h%c SSKJnJn U"5nUR5 UR 5 UR "S0UD6nUR 5 U$!UR 5 f=f)zEReturn file name from Tkinter's file open dialog, or '' if cancelled.r)Tk filedialogrt)tkinterr/r0withdrawr r+destroy)rr/r0ryrps rvr+r+isR& 4DMMOKKM..88    s AA'c.^SSKnScSjnSdSjn[R"5 URSSS9nUR SS S [ 3S 9 URnU"S S [ SSS9 U"SS[ SSS9 U"SS[ SSS9 U"SSSS9 U"S[ SSS9 U"SSS S!9 U"S"[ S#S$S9 U"S%[S&S'9 U"S([S)S'9 U"S*S+S,9 U"S-[ S.S'9 U"S/SS0S9 U"S1[ S2S3S9 U"S4S5SS6S9 U"S7S8S9S:9 URUcSOUS;S5nUR=(d S9mT(dURS?5 [U4S@jSA55(a:[R"TSBSC9nU(d[!SD["R$SE9 g;USmUR&(d [!SFSGSBSH9 [)5n[+TUR,(+SI9n UR&(d [!U5 U  /n UR6S:GaUR&(d [!SLSMSBSH9 UR95 UR:S:aAU R=UR:UR>SN9U R@UR:S4/n GO+URBS:aU"U RBURBURD5n U R=URBU UR>SO9U"U RBURBRF5U RBURB4/n O[IU RBSUR65HbupU"XRD5n U RKU R=U U UR>SO9U"URF5U RBU 45 Md UR&(d [!U5 UR&(d{[!SUSVSBSH9 UR95 [LRN"5SnU RSURTUS;- SX9n[!U5 [!5 [!U5 [!5 U (GaSSYK+J,n U GHunnnUcM URZnUR\UR^nnUR`(ayURbRdSZ:Xa7[fRhUUUR`:H'[fRj"U5nO'[fRl"UUUR`:5nU Rp(a=U RrS[nU RrS\nUU::aUR\UR^nnU(a&U SJUSJU3nU RvS]URx3nO"U SJU3nU RvS^URx3nS_nURz[|R~:wa[}URz5Rn[UUUUUURURUR`UURURS`Sa9 GM UR5 SSS5 g![.aNn UR0(ae[!SJU R2R4SKU 3["R$SE9 Sn A g;Sn A ff=f![.aUn U RKSU"UR@5S45 UR0(ae[!SPU SQU <SRSS3S._best_leveljsI > ~~)FCqww%' *ruc&[SU55$)z)Return first non-None item from iterable.c3.# UH ocMUv M g7fryrtrs rvr(main..notnone..js2q!AAqrr8rs rvnotnonemain..notnonejs2q222ruz(Display image and metadata in TIFF file.r)rprogz --versionrnz %(prog)s )actionrnz-pz--pagerKzdisplay single page)rwrhelpz-sz--serieszdisplay select seriesz-lz--levelzdisplay pyramid level of seriesz--no-multifile store_truez*do not read OME series from multiple files)r@rAz --maxplotsrzmaximum number of plot windowsz--interpolationMETHODzimage interpolation method)metavarrAz--dpirzplot resolutionz--vminzminimum value for colormapping)rwrAz--vmaxzmaximum value for colormappingz--cmapz(colormap name used to map data to colors)rAz --maxworkersz)maximum number of threads (default: auto)z--debugzraise exception on failuresz--detailrTz#detail level of report (default: 2)z-qz--quietzsuppress outputrErz)path or glob pattern of TIFF file to open)nargsrArYr=zSelect a TIFF file)r filetypeszNo file specifiedc3,># UH oT;v M g7fryrt)rrrEs rvrmain..mjs #d9drz?*T) recursivezNo files match the pattern)rz Reading TIFF header:rri )rr rDzReading image data:r )rr)rrrz Series rr_z... rq zGenerating report:z Prrrrrz series z page rFF) rrrrrrrZrrrrz ImportError: )rrgr6rr6r)rrgr6rg)Hargparser basicConfigArgumentParser add_argumentr*rrY parse_argsrEr+rr]rr;rrl r_rquietr)r no_multifilerr$rrmaxplotsrrrrrrrr rrrget_terminal_sizer]rrrrrrrrZrrrr<rrrr:rrrrrr rJrr5rrrrrr )argvrKr8r=r optrn path_listrrrrerrrrXrrimgrrrrrrrrrEs @rvmainrXis 3   $ $> %F I;-/H   C   "    $    .  9   -   ) c2,=>  -   -  7  8  *   2  i 3DEc KL  48DH #D &$2F2F  LL, - #d ###IIdd3  .SZZ @| >> &Ct< GEtH,A,A(AB >> e -/   q >>+TB KKM5 K==A% KK$,MM+3+>+>( IIhmm4  F__)' 8??3X^^E  KK'/&++3+>+>( $CJJx$?$F$FGJJx7 F!*#**5Hx7H7H*I J +A~~ >"MM$'KK/0.33;3F3F%0%& %,AHH$5$'JJqM!" !K6>>e ~~ &E > KKM ,,.q1888??%!)8DD %L G $K G 3 -*0%Cv{ #}}H!) $D!"yy~~4>CiiC8??$: ;',||C'8',yyS8??5J1K'LzzJ##3J#?D##3J#?D $t|-5]]HMMd#&%r$r& :*-,,x ~'N #&%r$ 0*-,,vdjj\'J ".K++{/B/BB&1(2F2F&G&L&L #%1!!%]]&.&<&<'$/&.&<&<$LL" A*0\ E H [  >>  3==))*"SE2D t )"MM41A4*HI'~~ %!"+A3hslTl$ G$&  K>>//03%8szzJJ K  4 *! ! (! !+ > cU+#**== >c H s>ZA`A]%`'B!]` 9]A [! ]A `^3A`_ A`A^1`&^1`_6D` [A[[! ]+A \;4];]] ^ A^`^` ^.*`-^..`1 ^?;`>^??` _ `_` `_>8`>`` `)rN ZarrStorer__main__ry)JrYstr | os.PathLike[Any] | FileHandle | IO[bytes] | Sequence[str | os.PathLike[Any]] | Noner Any | NonerzLiteral['xarray']rrrr3rrQrr3rr%rr3rr3rrrrQrr3rr3rrQrr2r dict[str, dict[str, int]] | Noner4"Callable[..., NDArray[Any]] | Nonerr*rrn rrm rr/rr3rro rr3rCHUNKMODE | int | str | Nonerrrr*rr%rrQrr3rrwrr%rr%rr%rrgr6rn)Jrr[rr\rzLiteral['zarr']rrrr3rrQrr3rr%rr3rr3rrrrQrr3rr3rrQrr2rr]r4r^rr*rrn rrm rr/rr3rro rr3rr_rrrr*rr%rrQrr3rrwrr%rr%rr%rrgr6z%ZarrTiffStore | ZarrFileSequenceStore)Jrr[rr\rzLiteral['numpy'] | Nonerrrr3rrQrr3rr%rr3rr3rrrrQrr3rr3rrQrr2rr]r4r^rr*rrn rrm rr/rr3rro rr3rr_rrrr*rr%rrQrr3rrwrr%rr%rr%rrgr6r)Lrr[rr\rz)Literal['numpy', 'xarray', 'zarr'] | Nonerrrrrr3rrQrr3rr%rr3rr3rrrrQrr3rr3rrQrr2rr]r4r^rr*rrn rrm rr/rr3rro rr3rr_rrrr*rr%rrQrr3rrwrr%rr%rr%rrgr6z@NDArray[Any] | ZarrTiffStore | ZarrFileSequenceStore | DataArray)Rrr1rr-rr.rr%rr/rr0rrrr%rr%rrrr2rr3rr4rr5rr6rrrr2rr3rr3rzCOMPRESSION | int | str | Nonerr*rr7rr8rr9rr9rr:rr;rUr<rr=rr>rr?rr@rr*rrArrrrrr3rr3rr3rrr6r8)rstr | os.PathLike[Any]rr2rr3rr3rr3rrQrr3rr%rzLiteral['r+', 'r', 'c']rrgr6znumpy.memmap[Any, Any])rrr6rF)rrorDrr r%rlrrr3rzGdict[int, Callable[[FileHandle, ByteOrder, int, int, int], Any]] | Noner6list[dict[str, Any]]) rlrrrorrrrrDrr6r) rlrrrorrrrrDrr6r{) rlrrrorrrrrDrr6rz) rlrrrorrrrrDrr6r) rlrrrorrrrrDrr6rgr)rhrrlrrrorrrrrDrr6r) rlrrrorrrrrDrr6r) rlrrMrrhrrrr6ztuple[str, Any])rlrr6r)rlrr6r)rlrr6zlist[tuple[float, int, str]])rlrr6z*tuple[dict[str, Any], dict[str, Any], int])r* Container[str] | NonerlFileHandle | IO[bytes]r6r)rr`r6zRIterator[tuple[dict[str, int | str], str, int, int, int, int, int, int, int, int]])rlrcr6zdict[str, str] | None)rlrcr6r)rrrror6zKtuple[tuple[int, int, int, bytes, bool], tuple[int, int, int, bytes, bool]])rr{rrError6r)rrzr6r) rrQrrErr%rrrrgr6rz)rrErr%rrQr6rM) rrrrrrMr?rr6z#tuple[int | None, int | str | None])rr{r6r )rr{r6ztuple[int, int, bytes])rrErrgr6rz)rrbrrzr6r)rrzr6ra)rrzr6rg)r@rzr6r*)rNrzr6r)r)r_rzrrzr6r)rrzrlrr6r)rsrzr6rr) rr3rr/rr{rtrr6r)rrrrr rr6rr ) rrQrr2rr]r Sequence[str]rr2r6zMtuple[tuple[str, ...], tuple[int, ...], list[tuple[int, ...]], Sequence[str]])rrr6Iterator[NDArray[Any]]) rrrrMrr rrr6re)rrrrMrrMr6re)rrrrrgzCallable[[NDArray[Any]], bytes]rrErr rr3rr3rK rr6r7)rrrzORIENTATION | int | strr6r)r rjrrEr6r)rrMrrr6rM)rrrrr6r)rtuple[int, ...] | NDArray[Any]rrr6rf)rrQrrErrzr6z-tuple[tuple[int, ...], str, tuple[bool, ...]])rSequence[str] | NonerrErrdr6z7tuple[tuple[int, ...], Sequence[str], tuple[bool, ...]])rr rrErstr | Sequence[str]r6z=tuple[tuple[int, ...], str | Sequence[str], tuple[bool, ...]])rrQrrrrzr6r) rrQrrzrrErrEr6rz) rrQrrdrrErrEr6rd) rrQrrhrrErrEr6rh)rrjrrr6rM)r|rErrEr6rr) rrrrr rr rr6r3) rrrrr rr rr6r3) rrrrr TiffPage | TiffPageSeriesr rir6r3)rrrArrr2r6r)rr rK zTiledSequence | Noner*rrr3rrwrrgr6r)rrErr3rrwrzLiteral['r+', 'w+', 'r', 'c']rrQrrr6z%NDArray[Any] | numpy.memmap[Any, Any])rrzr6rg)rrzrrQr6rh)r rgr rgrOrzr6r)r Sequence[bytes] | Noner rjrOr{r6r)r Sequence[str | bytes] | Noner rkrO str | bytesr6r)r:z#Sequence[Callable[..., Any]] | NonerOrgr6rg)rxzfloat | tuple[int, int]r6r:)r$ Iterable[str]r6rp )i)r-rYrrYr6rz)rxrgrrgrrgr6rg)rrgrrgr6r)r1zIterable[int | numpy.integer]r6r)r5rr6ztuple[Any, Iterator[Any]])r1rmr6r )rArrBrr6rh)iZ )rqrYrGrr6rh)rKrrrr6rh)rrzr6r)rrzr3rzr6r)Nr5)r rQrrzr r{r6rz)rVr r6r) r rzrWrroztuple[str, str] | Noner_rzr6r)rr{rXrrrrirr rrjrQr6rz)r>rlr6r)r>rzrrr6rz)rrgr6rz)r rlr6rz) rxrgrr3rXr3rr3rrr6rz)r) rXrr>rzrirrjrQr6rz)rz enum.Enumr6rz)rrrxrgr6z enum.IntEnum)rrr* rzrrgr6r)rrrrgr6r)rrgr6r)r6zlogging.Logger)rrQrzCollection[str] | Nonerrzr6r) r r;rr3rzint | str | Nonerxr-r6r;)rrzrr`rrQrr3rr3rr3rr_rrrr*rr%rrQrnr3rr3r6rz) rrQrrzrr8rrr6r)&rrrr4rr5rr3rZrYrrQrrgrrrrrrgrrgrr;rrQrrrr3rz'tuple[float, float, float] | str | Nonerrrrgr6ztuple[Any, Any, Any])rrgr6rz)rTrr6r( r __future__rr*__all__rarr9rr}rrrrorrirer_r rm rhcollections.abcrPrQrRrSconcurrent.futuresrTrUrhrVr~ fractionsrW functoolsrXrr(r r=r[typingr\r]r^r_r`rarbrcrdrer:rfrgrhri numpy.typingrjrkrlrrnrorwr|rrrLr4r6r:rrr'rrrrr r$r&r%rr#rzrr"r(rrrrrr)rrrrJr r r:rrrr IntFlagrr r r r rrrrrrr*r rr rr rrrrrrrr r rrrrrrrrrrr rWrXrYrIrrrHrTrNrOrrJrKrLr)rrPrrrrrrrrrVrUrRrQrMrSrErCrDrBrr3rrr2rTr%rrrfrfr!rrr0rr>rArrr rrrUr=rsr{rrrzrrFrHrrLrGrr:rr6rr-r9rIr4r,rArwr0r r<r@rvr;rCrHrrrLrrOrr"rOr1rrr%rr?r*r/r.r>rMrr7rNrKrJr8r5r+rXr!rrN rYrrexitrtrurvrxs%@y v# M ^    AA1)+% +POO??#)):: "7B $&.%  -!.2!!&*&*3715(,-1/3)-#'CG.2"$(##""W- --!- ,- - - - !-"#-$%-& $'-( )-* +-, --./-0$1-213-4 /5-6&7-8 +9-:-;-<'=->!?-@AA-BC-D,E-FG-H "I-JK-L M-NO-P Q-RS-TU-VW-XY-Z[- -`  -0!.2!!&*&*3715(,-1/3)-#'CG.2"$(##""W-0 -0-0-0 ,-0 -0 -0 -0 !-0"#-0$%-0& $'-0( )-0* +-0, --0./-00$1-0213-04 /5-06&7-08 +9-0:-;-0<'=-0>!?-0@AA-0BC-0D,E-0FG-0H "I-0JK-0L M-0NO-0P Q-0RS-0TU-0VW-0XY-0Z+[-0 -0`  -!)-.2!!&*&*3715(,-1/3)-#'CG.2"$(##""W- --'- ,- - - - !-"#-$%-& $'-( )-* +-, --./-0$1-213-4 /5-6&7-8 +9-:-;-<'=->!?-@AA-BC-D,E-FG-H "I-JK-L M-NO-P Q-RS-TU-VW-XY-Z[- -p X !;?.2!!&*&*3715(,-1/3)-#'CG.2"$(##""YX  X X 9X  X  ,X  X  X !X "#X $%X &'X ( $)X * +X , -X . /X 01X 2$3X 415X 6 /7X 8&9X : +;X <-=X >'?X @!AX BACX DEX F,GX HIX J "KX LMX N OX PQX R SX TUX VWX XYX Z[X \F]X H h ,0"&AE"&"2648=A!%# $26-159*.##!%&*-1 15)-*.&6+/!!gh   h 9h  )h h  h  ?h  h !h " #h $ %h & 'h ( )h *0+h ,2-h .;/h 01h 2 3h 45h 67h 809h :+;h <3=h >(?h @Ah BCh DEh F$Gh H+Ih L GMh P/Qh R'Sh T(Uh X$Yh Z)[h \]h ^_h ` ah bch deh fgh hih ^#'"$(CC$CC CC  CC  CC CC CC CCCC "CCCCCCL8J8~*N~*N~*NBV|?|?|?~/s s s lg-:g-:g-:T[};};};@| 7I-.| 7| 7~i i i Xtttn{ { { |[ 4Xh2T9:[ 4|s1.)s1s1ls 8C=s l =<==2b b b Jc c c Lo:o:o:dR (3-R R j)))XrrrjF)FF+F+F+R B!wsHS&[$99:B!B!J~!WS(3;"778~!~!B&0t||&0Rb$,,bJ .$,,@t||,    @ @$,," B4<< Bdll, #$,, #"4<<"*" "Pz$Jz$JzI w$$ 3   #   c s#3 ##3 ##3 !" S#$ c%(G L 6rYxvrQ h~BK\:z]@*Z7tSltnOdTnWt3lYxNbXvQhcL|~u~ {{ {  {{{ P{{|     < M M M  M  M  M M M M M  M  M  M M      0""" "  "  " ""               (      "     6 . . .  .  .  . .&%%%% %  %  %%P     , 8 8 8  8  8  8 8      ,~~ ~~  ~  ~B :--- -  -  --`, - - - >4n3l=== =  =  ==@     $((( (  (  ((V     4333 3  3  33l     "+)+)/+)^BFE)>EEEPD DDN   Fjj)2jjZc c*c7@ccL!Np-  p- p- p-  p-  p-p- p-n 9, 9,  9,  9,  9,x'%'%'%"'%  '% ) '%T+\P-f:6-1F*FF FR.b2'T/d% hX%([![[[|99$99x L#,0 =  = =* = =  ==BGK #/?CF&*37 d'$(d'd'$ d' 1 d' d' !d'd'N %K+%K %K %K %K  %KPC@ C@ C@ C@  C@LY6Y6,Y6 ,Y6  Y6  Y6  Y6Y6 Y6Y6x" "&=""J"J "*-   N N*(1*(9<*(#*(Z  8  8 8 8 3 8 8 "& B  B B B = B B(, ;6 % ;6 ;6 ;6 C ;6D /C  /C /C /C  /Cd                   H  H H HH  H^ " " "  "J**-:* *Z 68$'03   BD03 A 4=E%*%%*69%* %*%*PF%) K3 K3 K3 # K3 K3K3dv. v.  v.  v.  v. v.v. v.r*9>&0$VY Y  Y  Y  YY Y~D   D D D  D  D DDN,+< &)8;> &>)%) 2( 2( # 2(2(  2(p#' $ 2 2 2  2 82  22t.2"$( "; ;$;  ;  ; ; ;,;; ";;;;;  !;;Bk" $( k"k" k" ! k"  k" k"k"d3748 $ $ $#:>'r" r"0 r" 2 r"  r" r"r" r" r" r" r"r" r"r" !r"" #r"$8%r"& 'r"()r"*+r"r"j H H X EEE zHHTVO| ++11 +*+ +s*?z)){ 0z99 {{ {{