B 5Z\]+@sdZddlmZmZmZddlZddlZddlmZddl m Z ddl Z da ddZd Zd Zd ZGd d d e ZeddedZeedS)z' Storage of image data in tiff format. )absolute_importprint_functiondivisionN)formats)FormatcCsntjdkr'} The endianness of the data in the file. By default this is the system's native byte order. software : str Name of the software used to create the image. Saved with the first page only. Metadata for reading -------------------- planar_configuration : {'contig', 'planar'} Specifies if samples are stored contiguous or in separate planes. By default this setting is inferred from the data shape. 'contig': last dimension contains samples. 'planar': third last dimension contains samples. resolution_unit : (float, float) or ((int, int), (int, int)) X and Y resolution in dots per inch as float or rational numbers. compression : int Values from 0 to 9 indicating the level of zlib compression. If 0, data is uncompressed. orientation : {'top_left', 'bottom_right', ...} Oriented of image array. is_rgb : bool True if page contains a RGB image. is_contig : bool True if page contains a contiguous image. is_tiled : bool True if page contains tiled image. is_palette : bool True if page contains a palette-colored image and not OME or STK. is_reduced : bool True if page is a reduced image of another image. is_shaped : bool True if page contains shape in image_description tag. is_fluoview : bool True if page contains FluoView MM_STAMP tag. is_nih : bool True if page contains NIH image header. is_micromanager : bool True if page contains Micro-Manager metadata. is_ome : bool True if page contains OME-XML in image_description tag. is_sgi : bool True if page contains SGI image and tile depth tags. is_stk : bool True if page contains UIC2Tag tag. is_mdgel : bool True if page contains md_file_tag tag. is_mediacy : bool True if page contains Media Cybernetics Id tag. is_stk : bool True if page contains UIC2Tag tag. is_lsm : bool True if page contains LSM CZ_LSM_INFO tag. description : str Image description description1 : str Additional description is_imagej : None or str ImageJ metadata software : str Software used to create the TIFF file datetime : datetime.datetime Creation date and time Metadata for writing -------------------- photometric : {'minisblack', 'miniswhite', 'rgb'} The color space of the image data. By default this setting is inferred from the data shape. planarconfig : {'contig', 'planar'} Specifies if samples are stored contiguous or in separate planes. By default this setting is inferred from the data shape. 'contig': last dimension contains samples. 'planar': third last dimension contains samples. resolution : (float, float) or ((int, int), (int, int)) X and Y resolution in dots per inch as float or rational numbers. description : str The subject of the image. Saved with the first page only. compress : int Values from 0 to 9 controlling the level of zlib compression. If 0, data are written uncompressed (default). volume : bool If True, volume data are stored in one tile (if applicable) using the SGI image_depth and tile_depth tags. Image width and depth must be multiple of 16. Few software can read this format, e.g. MeVisLab. writeshape : bool If True, write the data shape to the image_description tag if necessary and no other description is given. extratags: sequence of tuples Additional tags as [(code, dtype, count, value, writeonce)]. code : int The TIFF tag Id. dtype : str Data type of items in 'value' in Python struct format. One of B, s, H, I, 2I, b, h, i, f, d, Q, or q. count : int Number of data values. Not used for string values. value : sequence 'Count' values compatible with 'dtype'. writeonce : bool If True, the tag is written to the first page only. cCs |j|jkS)N) extension extensions)selfrequestrrr _can_readszTiffFormat._can_readcCs |j|jkS)N)rr)rrrrr _can_writeszTiffFormat._can_writec@s4eZdZddZddZddZddZd d Zd S) zTiffFormat.ReadercKsZts t|jjdr0t|jd|_}nd|_|j}tj |f||_ i|_ dS)N)zhttp://zhttps://rb) r rrfilename startswithopenZget_local_filename_fget_fileZTiffFile_tf_meta)rkwargsfrrr_opens zTiffFormat.Reader._opencCs"|j|jdk r|jdS)N)r$closer")rrrr_closes  zTiffFormat.Reader._closecCs$|jjddkrdSt|jjSdS)Nr vV)rmodelenr$pages)rrrr _get_lengthszTiffFormat.Reader._get_lengthcCsv|jjddkr2|dkr td|j}|j}n<|dksF||krNtd|jj|}|jpl||}||fS)Nr r+rz-Tiff support no more than 1 "volume" per filez/Index out of range while reading from tiff file) rr, IndexErrorr$Zasarrayr%r/r._get_meta_data)rindeximmetarrr _get_datas zTiffFormat.Reader._get_datac Cs|jj|p d}x6tD].}yt|||j|<Wqtk rBYqXqWxDdD]<}y"tj|j|j d|jd<PWqNtk rYqNXqNW|jS)Nr)rZDateTimez%Y:%m:%d %H:%M:%Sr) r$r.READ_METADATA_KEYSgetattrr% ExceptionrZstrptimeZtagsvalue)rr2Zpagekeyrrrr1s    z TiffFormat.Reader._get_meta_dataN)__name__ __module__ __qualname__r(r*r/r5r1rrrrReaders r>c@s.eZdZd ddZddZddZdd ZdS) zTiffFormat.WriterNcCsjts ty$tj|j|||d|_d|_Wn0tk r^t|j|||_||_YnXi|_dS)N)r) r rZ TiffWriterrr#r$ _software TypeErrorr%)rZbigtiff byteorderrrrrr(s  zTiffFormat.Writer._opencCs|jdS)N)r$r))rrrrr*.szTiffFormat.Writer._closecCsX|r|||jdkr2|jjt|f|jn"|jjt|fd|ji|jdS)Nr) set_meta_datar?r$ZsavenpZ asanyarrayr%)rr3r4rrr _append_data1s   zTiffFormat.Writer._append_datacCs2i|_x&|D]\}}|tkr||j|<qWdS)N)r%itemsWRITE_METADATA_KEYS)rr4r:r9rrrrB<szTiffFormat.Writer.set_meta_data)NNN)r;r<r=r(r*rDrBrrrrWriters  rGN) r;r<r=__doc__rrrr>rGrrrrrMs ?rZtiffz TIFF formatZiIvV)rHZ __future__rrrr rrrZcorerZnumpyrCr rZ TIFF_FORMATSrFr6rformatZ add_formatrrrrs   x