Skip to main content

Next Generation file format IO

Project description

ngio - Next Generation file format IO

License PyPI Python Version CI codecov

ngio is a Python library designed to simplify bioimage analysis workflows, offering an intuitive interface for working with OME-Zarr files.

What is ngio?

ngio is built for the OME-Zarr file format, a modern, cloud-optimized format for biological imaging data. OME-Zarr stores large, multi-dimensional microscopy images and metadata in an efficient and scalable way.

ngio's mission is to streamline working with OME-Zarr files by providing a simple, object-based API for opening, exploring, and manipulating OME-Zarr images and high-content screening (HCS) plates. It also offers comprehensive support for labels, tables and regions of interest (ROIs), making it easy to extract and analyze specific regions in your data.

Key Features

🔍 Simple Object-Based API

  • Easily open, explore, and manipulate OME-Zarr images and HCS plates
  • Create and derive new images and labels with minimal boilerplate code

📊 Rich Tables and Regions of Interest (ROI) Support

  • Tight integration with tabular data
  • Extract and analyze specific regions of interest
  • Store measurements and other metadata in the OME-Zarr container
  • Extensible & modular allowing users to define custom table schemas and on disk serialization

🔄 Scalable Data Processing

  • Powerful iterators for building scalable and generalizable image processing pipelines
  • Extensible mapping mechanism for custom parallelization strategies

Installation

You can install ngio via pip:

pip install ngio

To get started check out the Quickstart Guide.

Supported OME-Zarr versions

ngio supports OME-Zarr v0.4/v0.5. Support for version 0.6 and higher is planned for future releases.

Development Status

ngio is under active development and is not yet stable. The API is subject to change, and bugs and breaking changes are expected. We follow Semantic Versioning. Which means for 0.x releases potentially breaking changes can be introduced in minor releases.

Available Features

  • ✅ OME-Zarr metadata handling and validation
  • ✅ Image and label access across pyramid levels
  • ✅ ROI and table support
  • ✅ Image processing iterators
  • ✅ Streaming from remote sources
  • ✅ Documentation and examples

Upcoming Features

  • Enhanced performance optimizations (parallel iterators, optimized io strategies)

Contributors

ngio is developed at the BioVisionCenter, University of Zurich, by @lorenzocerrone and @jluethi.

License

ngio is released under the BSD-3-Clause License. See LICENSE for details.

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 Distribution

ngio-0.5.11.tar.gz (456.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ngio-0.5.11-py3-none-any.whl (236.3 kB view details)

Uploaded Python 3

File details

Details for the file ngio-0.5.11.tar.gz.

File metadata

  • Download URL: ngio-0.5.11.tar.gz
  • Upload date:
  • Size: 456.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ngio-0.5.11.tar.gz
Algorithm Hash digest
SHA256 c1abdb25dd6218a1e3f11ccd4d141cfba92c7b657d26855fa069215bc5d4d70f
MD5 3679a01ac1d81e62b13ed132faf3963d
BLAKE2b-256 639a7c57020e7d6b66a3dce0ea9d8b943932bbb2d9b7b6397eeaa8b893039d03

See more details on using hashes here.

Provenance

The following attestation bundles were made for ngio-0.5.11.tar.gz:

Publisher: ci.yml on BioVisionCenter/ngio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ngio-0.5.11-py3-none-any.whl.

File metadata

  • Download URL: ngio-0.5.11-py3-none-any.whl
  • Upload date:
  • Size: 236.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ngio-0.5.11-py3-none-any.whl
Algorithm Hash digest
SHA256 d9c936712f965921efdbd07130274c1bca861c51ffecf9dbfd6e76da0c285429
MD5 f0b958e63962a9aec4b870dcbc888622
BLAKE2b-256 35b1e36e603dbadd6e61f00e6fc82dbff9b1b461d9c4bf3a2d993a96ff67c1df

See more details on using hashes here.

Provenance

The following attestation bundles were made for ngio-0.5.11-py3-none-any.whl:

Publisher: ci.yml on BioVisionCenter/ngio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page