Home

Awesome

napari-ome-zarr-navigator <img align="right" height="150" src="https://raw.githubusercontent.com/fractal-napari-plugins-collection/napari-ome-zarr-navigator/master/docs/images/navigator_logo.png">

License BSD-3 PyPI Python Version tests codecov napari hub

A plugin to browse OME-Zarr plates by conditions and load images, labels and features from ROIs

Usage

The ImageBrowser recognizes OME-Zarr plates that were loaded via napari-ome-zarr and allows the selection of wells in the multiwell plate.

<img width="1624" alt="navigator_1" src="https://github.com/user-attachments/assets/86c0c0d5-df4c-4579-8719-c36efe67485c">

The ImageBrowser allows to zoom to a given well ("Go to well") & puts a white bounding box around the selected well.

<img width="1624" alt="navigator_2" src="https://github.com/user-attachments/assets/13ead72a-de0e-4b03-8051-b9759af4a131">

Using prototype condition tables (to be defined better, see sample data provided by the plugin orthe example in the test data below), the ImageBrowser allows for selecting subsets of the well list based on conditions defined in the condition table. The operetta-compose Fractal task package provides a task to create such condition tables.

<img width="1624" alt="navigator_3" src="https://github.com/user-attachments/assets/f8cb9311-49ef-43fd-9358-4193ffb58877">

The ROI loader (formerly available separately as a napari plugin) can be used standalone or integrated with the ImageBrowser. If a well is selected from the ImageBrowser, all the images in that well can be loaded via the ROI loader. This supports:

This approach of loading label images and feature data has been optimized for and tested with the napari feature classifier.

<img width="1624" alt="navigator_4" src="https://github.com/user-attachments/assets/0548c8f1-23c3-4c55-9388-c818bb94bbc3">

This plugin is meant to work well for OME-Zarr files generated by Fractal.


Test data

Test data is available at https://zenodo.org/records/11262587

Installation

You can install napari-ome-zarr-navigator via pip:

pip install napari-ome-zarr-navigator

To install latest development version :

pip install git+https://github.com/fractal-analytics-platform/napari-ome-zarr-navigator.git

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the BSD-3 license, "napari-ome-zarr-navigator" is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.