Czi Reader

CziLatest version

ZVIReader.java: Installation: The LOCI Bio-Formats plugin has superseded this plugin. Description: Imports images and image stacks from a Zeiss ZVI file. The Perfect Software Solution to Work with Microscope Images in CZI File Format. Download ZEN Lite, your free copy of the powerful ZEN software. Use this free software as a viewer for your CZI files or other standard file types, or even to perform image acquisition or fundamental image analysis and processing tasks. This is a PR to fix an issue raised in #2467 Previously the dimension values (Z and C) across each series would be identical, with the largest value be replicated across each series.

Released:

Read Carl Zeiss(r) Image (CZI) files

Project description

Czifile is a Python library to read Carl Zeiss Image (CZI) files, the nativefile format of the ZEN(r) software by Carl Zeiss Microscopy GmbH. CZI filescontain multidimensional images and metadata from microscopy experiments.

Author:Christoph Gohlke
Organization:Laboratory for Fluorescence Dynamics. University of California, Irvine
License:3-clause BSD
Version:2019.7.2

Requirements

  • Imagecodecs 2019.5.22(optional; used for decoding LZW, JPEG, and JPEG XR)

Revisions

2019.7.2
Require tifffile 2019.7.2.
2019.6.18
Add package main function to view CZI files.Fix BGR to RGB conversion.Fix czi2tif conversion on Python 2.
2019.5.22
Fix czi2tif conversion when CZI metadata contain non-ASCII characters.Use imagecodecs_lite as a fallback for imagecodecs.Make CziFile.metadata a function (breaking).Make scipy an optional dependency; fallback on ndimage or fail on zoom().
2019.1.26
Fix czi2tif console script.Update copyright year.
2018.10.18
Rename zisraw package to czifile.
2018.8.29
Move czifile.py and related modules into zisraw package.Move usage examples to main docstring.Require imagecodecs package for decoding JpegXrFile, JpgFile, and LZW.
2018.6.18
Save CZI metadata to TIFF description in czi2tif.Fix AttributeError using max_workers=1.Make Segment.SID and DimensionEntryDV1.dimension str types.Return metadata as XML unicode string or dict, not etree.Return timestamps, focus positions, events, and luts as tuple or ndarray
2017.7.21
Use multi-threading in CziFile.asarray to decode and copy segment data.Always convert BGR to RGB. Remove bgr2rgb options.Decode JpegXR directly from byte arrays.
2017.7.13
Add function to convert CZI file to memory-mappable TIFF file.
2017.7.11
Add ‘out’ parameter to CziFile.asarray.Remove memmap option from CziFile.asarray (breaking).Change spline interpolation order to 0 (breaking).Make axes return a string.Require tifffile 2017.7.11.
2014.10.10
Read data into a memory mapped array (optional).
2013.12.4
Decode JpegXrFile and JpgFile via _czifle extension module.Attempt to reconstruct tiled mosaic images.
2013.11.20
Initial release.

Notes

The API is not stable yet and might change between revisions.

Python 2.7 and 3.4 are deprecated.

“ZEISS” and “Carl Zeiss” are registered trademarks of Carl Zeiss AG.

The ZISRAW file format design specification [1] is confidential and thelicense agreement does not permit to write data into CZI files.

Only a subset of the 2016 specification is implemented. Specifically,multifile images, image pyramids, and topography images are not yet supported.

Tested on Windows with a few example files only.

Czifile relies on the imagecodecspackage for decoding LZW, JPEG, and JPEG XR compressed images. Alternatively,the imagecodecs_lite packagecan be used for decoding LZW compressed images.

Other libraries for reading CZI files (all GPL licensed):

References

  1. ZISRAW (CZI) File Format Design Specification Release Version 1.2.2.CZI 07-2016/CZI-DOC ZEN 2.3/DS_ZISRAW-FileFormat.pdf (confidential).Documentation can be requested athttps://www.zeiss.com/microscopy/us/products/microscope-software/zen/czi.html

Examples

Read image data from a CZI file as numpy array:

Release historyRelease notifications | RSS feed

2019.7.2

2019.6.18

2019.5.22

2019.1.26

2019.1.1

2018.10.18

0.1.5

0.1.4

Czi ReaderCzi

0.1.3

0.1.2

0.1.1

0.1.0

Download files

Zeiss czi reader imagej

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for czifile, version 2019.7.2
Filename, sizeFile typePython versionUpload dateHashes
Filename, size czifile-2019.7.2-py2.py3-none-any.whl (18.0 kB) File type Wheel Python version py2.py3 Upload dateHashes
Filename, size czifile-2019.7.2.tar.gz (17.9 kB) File type Source Python version None Upload dateHashes
Close

Hashes for czifile-2019.7.2-py2.py3-none-any.whl

Hashes for czifile-2019.7.2-py2.py3-none-any.whl
AlgorithmHash digest
SHA256561ba0312e5b9c95db784768d7c81803f62bc323eab42bd5812586ce6dc58db8
MD50a59701d093a8ebd91f254289cf8b12b
BLAKE2-25637863d0b1829c8c24eb1a4214f098a02442209f80302766203db33c99a4681ec
Close

Hashes for czifile-2019.7.2.tar.gz

Czi Reader Download

Hashes for czifile-2019.7.2.tar.gz
AlgorithmHash digest
SHA25604c0e6bed3b24d1bf42bc2cf899a5a08986641379305ce88600fd1c710486436
MD554fd026fbb62598c5c64c2952b212458
BLAKE2-256b1f92c507f4fe3474d541caba4c60eed3d46495c0973a5d5e5f8f5e82c7807d7