IO for images stored in the OME-Zarr format.
Project description
ITKIOOMEZarrNGFF
Overview
This is an ITK external module for IO of images stored in Zarr-backed OME-NGFF file format.
Installation
The itk-ioomezarrngff
Python package is available on the Python Package Index.
> python -m pip install itk-ioomezarrngff
Example Usage
C++
Usage from C++ should not require any special action. In special situations, you might need to invoke:
itk::OMEZarrNGFFImageIOFactory::RegisterOneFactory();
Python
In Python, we need to explicitly specify the IO, otherwise DICOM IO will be invoked because it is the built-in default for directories. Example:
import sys
import itk
imageio = itk.OMEZarrNGFFImageIO.New()
image = itk.imread(sys.argv[1], imageio=imageio)
itk.imwrite(image, sys.argv[2], imageio=imageio, compression=False)
Build Instructions
ITKIOOMEZarrNGFF is an ITK C++ external module. It may be built with CMake
and build tools such as
Ninja, gcc, or MSVC.
In the future ITKIOOMEZarrNGFF may be made available as an ITK remote module for direct inclusion in the ITK build process.
Prerequisites
Building
ITKIOOMEZarrNGFF uses CMake for its build process.
# Create the build directory
> mkdir path/to/ITKIOOMEZarrNGFF-build
> cd path/to/ITKIOOMEZarrNGFF-build
# Configure the project
path/to/ITKIOOMEZarrNGFF-build > cmake -DITK_DIR:PATH="path/to/ITK-build" "path/to/ITKIOOMEZarrNGFF"
# Build the project
path/to/ITKIOOMEZarrNGFF-build > cmake --build . --config "Release"
Testing
ITKIOOMEZarrNGFF tests may be run with CTest:
path/to/ITKIOOMEZarrNGFF-build > ctest -C "Release"
Wrapping
See the ITK Software Guide for information on wrapping ITK external modules for Python.
Additional Notes
ITKIOOMEZarrNGFF depends on a fork of Google's Tensorstore library for Zarr interoperation. The InsightSoftwareConsortium/Tensorstore fork implements additional zip support, both for filesystem and in memory zip reading and writing.
Acknowledgements
ITKIOOMEZarrNGFF was developed in part with support from:
- NIH NIMH BRAIN Initiative under award 1RF1MH126732.
- The Allen Institute for Neural Dynamics (AIND).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
File details
Details for the file itk_ioomezarrngff-0.3.0-cp311-abi3-win_amd64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp311-abi3-win_amd64.whl
- Upload date:
- Size: 12.2 MB
- Tags: CPython 3.11+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 28bc6e6ab44488974f53ddf90e3caea37e38c7a5cfa0f7406f99f2b1ea960911 |
|
MD5 | cc1f4604a96e63b2b5d8eaee88eb2485 |
|
BLAKE2b-256 | 523f2248ee20cb0b2bd443702849630c080056295863fd11f8dfa5b44296b97a |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp311-abi3-manylinux_2_28_x86_64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp311-abi3-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 18.2 MB
- Tags: CPython 3.11+, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e6cc914c19692adff9a8e9391d1650e887344f279eb0bd55a44a1f70edcf9444 |
|
MD5 | 9ba00bf6cafae2ee62fb9412f8b7af2f |
|
BLAKE2b-256 | d02a6b96ba71335f66201d81bc3e6998c1ecd277add5140618e3938987dee1e2 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp311-abi3-macosx_11_0_arm64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp311-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 11.5 MB
- Tags: CPython 3.11+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 054a921a0237a3673bb232085bc4b1d5a17851dac5a2a7aae8c7c12e7addc650 |
|
MD5 | 007efb8f37de3a5e1e110cfc194ac574 |
|
BLAKE2b-256 | 3c98c8bde4a7e5f0bbc2d0623f801bd5326a97b0c7a904d6b6003fcf7c22d4f5 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp310-cp310-win_amd64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp310-cp310-win_amd64.whl
- Upload date:
- Size: 12.2 MB
- Tags: CPython 3.10, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54a466e99fee18c3a1d625d8211fd74f56da3415bc8fd795b97be5a1a2e1fc4a |
|
MD5 | 0e8e0b6ad020207f71e2685b11691f3d |
|
BLAKE2b-256 | 1253f05bf31dc7689b682853bb358aff583cdf8a5a681285d62d8ce0a92b59c5 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp310-cp310-manylinux_2_28_x86_64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp310-cp310-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 18.2 MB
- Tags: CPython 3.10, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2a7be5c5839616ea0a5796e25c776f5759843e0d54c0637364c99becfbf8e3f4 |
|
MD5 | c2db3326fdf93c462666ce0aec38c29b |
|
BLAKE2b-256 | 2c5cb54141ef8b0dd47cf32d6035b85d00facced7be1dda913b506b6bd8f5209 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp310-cp310-macosx_11_0_arm64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp310-cp310-macosx_11_0_arm64.whl
- Upload date:
- Size: 11.5 MB
- Tags: CPython 3.10, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4ae78b194a535f5500afad4ce6c4d7f1bf0ed973142f38fd7f671fb47146fec4 |
|
MD5 | 7202872f313f2afb95f620a736977125 |
|
BLAKE2b-256 | f08f9abe96bf22d753ccf9728b1779b9c10b35fe430fa5b3ef33a2ac004d4bf2 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp39-cp39-win_amd64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp39-cp39-win_amd64.whl
- Upload date:
- Size: 12.2 MB
- Tags: CPython 3.9, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ab89894f9ff5f524d555428c413c5a407dbdee0db3be82d8e99e52ccb0cf5876 |
|
MD5 | 95182bea7432f706193892a9c362acee |
|
BLAKE2b-256 | 9c0359672e08d16d2b56b3dd18b9297defda4374a7ebdf7eb2c93d33fc1db359 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp39-cp39-manylinux_2_28_x86_64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp39-cp39-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 18.2 MB
- Tags: CPython 3.9, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b2eba61a55e1d10a9f55cefba0925bf9282fb90d7a68c6c1665a3610194b8907 |
|
MD5 | 7e637f72cf637d73d7659e00c1483187 |
|
BLAKE2b-256 | d7937ec72d687946d9de6f242d7ced41f4b2afa52fc4175b75572d588aa02037 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp39-cp39-macosx_11_0_arm64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp39-cp39-macosx_11_0_arm64.whl
- Upload date:
- Size: 11.5 MB
- Tags: CPython 3.9, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5a6f7793fc2e5d6bc46a5ee407a52dd47276b65d91f10dcda61e3b3c53178dd5 |
|
MD5 | 8c12816b508010e3d95b972a9becbca9 |
|
BLAKE2b-256 | aa2bd719cb7b0b5ab2a6f8a2a1c011c89f9d2f4d2f710c283f92bd5e31d47a67 |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp38-cp38-win_amd64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp38-cp38-win_amd64.whl
- Upload date:
- Size: 12.3 MB
- Tags: CPython 3.8, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 422df735763f4c3da19b1772eb00677b720384c7cff3e660209e277fa38eb38c |
|
MD5 | 42f4a51ad39668ff9dee05ab20f761e6 |
|
BLAKE2b-256 | ad5c0b1cbcd07283d3f353824fc36bc2a330fe91542f74fe3f38e6eb3c3809bf |
Provenance
File details
Details for the file itk_ioomezarrngff-0.3.0-cp38-cp38-manylinux_2_28_x86_64.whl
.
File metadata
- Download URL: itk_ioomezarrngff-0.3.0-cp38-cp38-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 18.2 MB
- Tags: CPython 3.8, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ffcf1bfd579e758dd71fe6d58aab04b98961d1b1da6b7c0f2def357a406e72a0 |
|
MD5 | e2e4012eae270c4d6d82f82604b31c42 |
|
BLAKE2b-256 | 3aa85463ecdfad420bc9fd3859cf48f5d3371bfca6dda995e8f3d93d339bf6b4 |