ngio 0.5.0__tar.gz → 0.5.0a2__tar.gz

{ngio-0.5.0 → ngio-0.5.0a2}/.github/workflows/build_docs.yml

@@ -3,6 +3,7 @@ name: Build Docs
 on:
   push:
     branches:
+      - dev
       - main
     tags:
       - "v*"
@@ -37,16 +38,16 @@ jobs:
         run: |
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
-
+        
       - name: Restore shared data cache
         id: cache-data
-        uses: actions/cache@v5
+        uses: actions/cache@v4
         with:
           path: data/
           key: "${{ runner.os }}-data-${{ hashFiles('tests/conftest.py') }}"
           restore-keys: |
             "${{ runner.os }}-data-"
-
+            
       - name: Deploy docs
         run: |
           VERSION=$(echo $GITHUB_REF | sed 's/refs\/tags\///' | sed 's/refs\/heads\///')
@@ -58,8 +59,8 @@ jobs:
             mike set-default --push stable
             echo "Deployed stable version $VERSION (stable)"
 
-          elif [[ $GITHUB_REF == refs/heads/main ]]; then
+          elif [[ $GITHUB_REF == refs/heads/dev ]]; then
             mike deploy --push dev
             mike set-default --push dev
-            echo "Deployed development version (dev) from main"
+            echo "Deployed development version (dev)"
           fi

{ngio-0.5.0 → ngio-0.5.0a2}/.github/workflows/ci.yml

@@ -33,7 +33,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.11", "3.12", "3.13"]
         platform: [ubuntu-latest, macos-latest, windows-latest]
 
     steps:
@@ -51,10 +51,10 @@ jobs:
           python -m pip install -U pip
           # if running a cron job, we add the --pre flag to test against pre-releases
           python -m pip install .[test] ${{ github.event_name == 'schedule' && '--pre' || ''  }}
-
+      
       - name: Restore shared data cache
         id: cache-data
-        uses: actions/cache@v5
+        uses: actions/cache@v4
         with:
           path: data/
           key: "${{ runner.os }}-data-${{ hashFiles('tests/conftest.py') }}"
@@ -79,7 +79,6 @@ jobs:
           update_existing: true
 
       - name: Coverage
-        if: success() && matrix.platform == 'ubuntu-latest'
         uses: codecov/codecov-action@v5
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
@@ -119,4 +118,4 @@ jobs:
       - uses: softprops/action-gh-release@v2
         with:
           generate_release_notes: true
-          files: "./dist/*"
+          files: './dist/*'

{ngio-0.5.0 → ngio-0.5.0a2}/.gitignore

@@ -131,8 +131,4 @@ tests/_v01
 # Ignore locks
 *.lock
 
-benchmark/*
-
-# Agents files (for now let's not track them)
-AGENTS.md
-CLAUDE.md
+benchmark/*

{ngio-0.5.0 → ngio-0.5.0a2}/CHANGELOG.md

@@ -5,94 +5,15 @@
 ### Features
 - Add support for OME-NGFF v0.5
 - Move to zarr-python v3
-- API to delete labels and tables from OME-Zarr containers and HCS plates.
-- Allow to explicitly set axes order when building masking roi tables.
-- New metadata modification APIs for `Image`, `Label`, and `OmeZarrContainer`:
-  - `set_channel_labels` - Update channel labels
-  - `set_channel_colors` - Update channel colors
-  - `set_channel_windows` - Update channel display windows (start/end values)
-  - `set_channel_windows_with_percentiles` - Update display windows based on data percentiles
-  - `set_axes_names` - Rename axes in the metadata
-  - `set_axes_unit` - Set space and time units for axes
-  - `set_name` - Set the image/label name in metadata
-- Add translation support in all image/label creation and derivation APIs.
-
-### API Breaking Changes
-
-- New `Roi` models, now supporting arbitrary axes.
+
+### API Changes
+
 - The `compressor` argument has been renamed to `compressors` in all relevant functions and methods to reflect the support for multiple compressors in zarr v3.
 - The `version` argument has been renamed to `ngff_version` in all relevant functions and methods to specify the OME-NGFF version.
-- Remove the `parallel_safe` argument from all zarr related functions and methods. The locking mechanism is now handled internally and only depends on the
+- Remove the `parallel_safe` argument from all zarr related functions and methods. The locking mechanism is now handled internally and only depends on the 
 `cache`.
 - Remove the unused `parent` argument from `ZarrGroupHandler`.
-- Internal changes to `ZarrGroupHandler` to support cleanup unused apis.
-- Remove `ngio_logger` in favor of standard warnings module.
-
-### Migration Guide (v0.4 → v0.5)
-
-#### Roi API Changes
-
-The `Roi` class now uses a flexible slice-based model supporting arbitrary axes:
-
-```python
-# Old (v0.4)
-roi = Roi(x=34.1, y=10, x_length=321.6, y_length=330)
-
-# New (v0.5)
-roi = Roi.from_values(slices={"x": (34.1, 321.6), "y": (10, 330)}, name=None)
-
-# Accessing coordinates
-# Old: roi.x, roi.y, roi.x_length, roi.y_length
-# New: roi.get("x").start, roi.get("y").start, roi.get("x").length, roi.get("y").length
-```
-
-#### Argument Renames
-
-```python
-# compressor → compressors
-# Old (v0.4)
-create_empty_ome_zarr(..., compressor=Blosc())
-
-# New (v0.5)
-create_empty_ome_zarr(..., compressors=Blosc())
-
-# version → ngff_version
-# Old (v0.4)
-create_empty_ome_zarr(..., version="0.4")
-
-# New (v0.5)
-create_empty_ome_zarr(..., ngff_version="0.4")
-```
-
-#### Removed Arguments
-
-- `parallel_safe`: No longer needed, locking is handled internally
-- `ngio_logger`: Use Python's standard `warnings` module instead
-
-### Deprecations
-- Standardized all deprecation warnings to indicate removal in `ngio=0.6`.
-- Deprecated `set_channel_percentiles` method, use `set_channel_windows_with_percentiles` instead.
-
-### Bug Fixes
-- Fix bug in `consolidate` function when using coarsening mode with non power-of-two shapes.
-- Fix HCS plate column name formatting to use standardized zero-padding (e.g., column `3` is now stored as `"03"`).
-- Fix `_stringify_column` not passing `num_digits` parameter to `_format_int_column`.
-
-### Documentation
-- Fix incorrect and incomplete docstrings across the codebase:
-  - `compute_masking_roi`: Added Args/Returns, fixed description (supports 2D, 3D, 4D).
-  - `lazy_compute_slices`: Added Args/Returns sections.
-  - `LabelsContainer.list`: Fixed description (was "Create the /labels group").
-  - `build_masking_roi_table`: Added Args/Returns sections.
-  - `TablesContainer`: Fixed class and method descriptions (were referencing labels instead of tables).
-  - `NgioPlateMeta.add_well`: Fixed description (was "Add an image to the well").
-  - `NgioPlateMeta.derive`: Fixed type annotation in docstring (`NgffVersion` → `NgffVersions`).
-  - Added missing docstrings to several HCS helper functions.
-
-## [v0.4.7]
-
-### Bug Fixes
-- Fix bug adding time axis to masking roi tables.
+## [v0.4.6]
 
 ### Bug Fixes
 - Fix channel selection from `wavelength_id`

{ngio-0.5.0 → ngio-0.5.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ngio
-Version: 0.5.0
+Version: 0.5.0a2
 Summary: Next Generation file format IO
 Project-URL: homepage, https://github.com/BioVisionCenter/ngio
 Project-URL: repository, https://github.com/BioVisionCenter/ngio
@@ -13,9 +13,8 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
-Requires-Python: <3.15,>=3.11
+Requires-Python: <3.14,>=3.11
 Requires-Dist: aiohttp
 Requires-Dist: anndata
 Requires-Dist: dask[array]<2025.11.0
@@ -23,7 +22,7 @@ Requires-Dist: dask[distributed]<2025.11.0
 Requires-Dist: filelock
 Requires-Dist: numpy
 Requires-Dist: ome-zarr-models
-Requires-Dist: pandas<3.0.0,>=1.2.0
+Requires-Dist: pandas>=1.2.0
 Requires-Dist: pillow
 Requires-Dist: polars
 Requires-Dist: pooch
@@ -32,6 +31,7 @@ Requires-Dist: pydantic
 Requires-Dist: requests
 Requires-Dist: zarr>3
 Provides-Extra: dev
+Requires-Dist: devtools; extra == 'dev'
 Requires-Dist: matplotlib; extra == 'dev'
 Requires-Dist: mypy; extra == 'dev'
 Requires-Dist: napari; extra == 'dev'
@@ -43,7 +43,6 @@ Requires-Dist: pyqt5; extra == 'dev'
 Requires-Dist: rich; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
 Requires-Dist: scikit-image; extra == 'dev'
-Requires-Dist: zarrs; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: griffe-typingdoc; extra == 'docs'
 Requires-Dist: markdown-exec[ansi]; extra == 'docs'
@@ -58,17 +57,11 @@ Requires-Dist: mkdocs-jupyter; extra == 'docs'
 Requires-Dist: mkdocs-material; extra == 'docs'
 Requires-Dist: mkdocstrings[python]; extra == 'docs'
 Requires-Dist: rich; extra == 'docs'
-Requires-Dist: ruff; extra == 'docs'
 Requires-Dist: scikit-image; extra == 'docs'
 Requires-Dist: tabulate; extra == 'docs'
 Provides-Extra: test
-Requires-Dist: boto; extra == 'test'
-Requires-Dist: devtools; extra == 'test'
-Requires-Dist: moto[server]; extra == 'test'
 Requires-Dist: pytest; extra == 'test'
 Requires-Dist: pytest-cov; extra == 'test'
-Requires-Dist: pytest-httpserver; extra == 'test'
-Requires-Dist: s3fs; extra == 'test'
 Requires-Dist: scikit-image; extra == 'test'
 Description-Content-Type: text/markdown
 

ngio-0.5.0a2/docs/api/ngio/ngio.md

@@ -0,0 +1,3 @@
+# ngio API documentation
+
+::: ngio

ngio-0.5.0a2/docs/changelog.md

@@ -0,0 +1,5 @@
+{%
+    include-markdown "../CHANGELOG.md"
+    start="<!--intro-start-->"
+    end="<!--intro-end-->"
+%}

{ngio-0.5.0 → ngio-0.5.0a2}/docs/getting_started/0_quickstart.md

@@ -96,4 +96,4 @@ Also, checkout our jupyer notebook tutorials for more examples:
 - [Image Processing](../tutorials/image_processing.ipynb): Learn how to perform simple image processing operations.
 - [Image Segmentation](../tutorials/image_segmentation.ipynb): Learn how to create new labels from images.
 - [Feature Extraction](../tutorials/feature_extraction.ipynb): Learn how to extract features from images.
-- [HCS Exploration](../tutorials/hcs_exploration.ipynb): Learn how to explore high-content screening data using ngio.
+- [HCS Processing](../tutorials/hcs_processing.ipynb): Learn how to process high-content screening data using ngio.

{ngio-0.5.0 → ngio-0.5.0a2}/docs/getting_started/1_ome_zarr_containers.md

@@ -58,8 +58,8 @@ Examples of the OME-Zarr metadata access:
 === "Available Paths"
     Show the paths to all available resolution levels:
     ```pycon exec="true" source="console" session="get_started"
-    >>> ome_zarr_container.level_paths # Show the paths to all available images
-    >>> print(ome_zarr_container.level_paths) # markdown-exec: hide
+    >>> ome_zarr_container.levels_paths # Show the paths to all available images
+    >>> print(ome_zarr_container.levels_paths) # markdown-exec: hide
     ```
 
 === "Dimensionality"
@@ -76,7 +76,7 @@ Examples of the OME-Zarr metadata access:
 
 === "Full Metadata Object"
     ```pycon exec="true" source="console" session="get_started"
-    >>> metadata = ome_zarr_container.meta
+    >>> metadata = ome_zarr_container.image_meta
     >>> print(metadata) # markdown-exec: hide
     ```
     The metadata object contains all the information about the image, for example, the channel labels:
@@ -85,65 +85,6 @@ Examples of the OME-Zarr metadata access:
     >>> print(metadata.channels_meta.channel_labels) # markdown-exec: hide
     ```
 
-## Modifying metadata
-
-ngio provides methods to modify the image metadata, such as channel labels, colors, display windows, axes names, and units.
-
-### Channel metadata
-
-You can update channel labels, colors, and display windows:
-
-=== "Channel Labels"
-    Update the labels (names) of the channels:
-    ```python
-    >>> ome_zarr_container.set_channel_labels(["DAPI", "GFP", "RFP"])
-    ```
-
-=== "Channel Colors"
-    Update the display colors of the channels (hex format):
-    ```python
-    >>> ome_zarr_container.set_channel_colors(["0000FF", "00FF00", "FF0000"])
-    ```
-
-=== "Channel Windows"
-    Update the display windows (start/end values) for each channel:
-    ```python
-    >>> ome_zarr_container.set_channel_windows([(0, 255), (0, 1000), (0, 500)])
-    ```
-
-=== "Channel Windows from Percentiles"
-    Automatically compute display windows based on data percentiles:
-    ```python
-    >>> ome_zarr_container.set_channel_windows_with_percentiles(percentiles=(0.1, 99.9))
-    ```
-
-### Axes metadata
-
-You can update the axes names and units:
-
-=== "Axes Names"
-    Rename the axes in the metadata:
-    ```python
-    >>> ome_zarr_container.set_axes_names(["t", "c", "z", "y", "x"])
-    ```
-
-=== "Axes Units"
-    Set the space and time units:
-    ```python
-    >>> ome_zarr_container.set_axes_units(space_unit="micrometer", time_unit="second")
-    ```
-
-### Image name
-
-You can set the name of the image in the metadata:
-
-```python
->>> ome_zarr_container.set_name("My Processed Image")
-```
-
-!!! note
-    The `set_name` method only updates the metadata. It does not change the group name or file paths.
-
 ## Accessing images / labels / tables
 
 To access images, labels, and tables, you can use the `get_image`, `get_label`, and `get_table` methods of the `OME-Zarr Container` object.
@@ -168,7 +109,7 @@ new_image = ome_zarr_container.derive_image(
     "data/new_ome.zarr", 
     overwrite=True, 
     shape=(16, 128, 128), 
-    pixelsize=0.65, 
+    xy_pixelsize=0.65, 
     z_spacing=1.0
 )
 ```
@@ -188,7 +129,7 @@ x = np.random.randint(0, 255, (16, 128, 128), dtype=np.uint8)
 new_ome_zarr_image = create_ome_zarr_from_array(
     store="random_ome.zarr", 
     array=x, 
-    pixelsize=0.65, 
+    xy_pixelsize=0.65, 
     z_spacing=1.0
 )
 ```
@@ -201,7 +142,7 @@ from ngio import create_empty_ome_zarr
 new_ome_zarr_image = create_empty_ome_zarr(
     store="empty_ome.zarr", 
     shape=(16, 128, 128), 
-    pixelsize=0.65, 
+    xy_pixelsize=0.65, 
     z_spacing=1.0
 )
 ```

{ngio-0.5.0 → ngio-0.5.0a2}/docs/getting_started/2_images.md

@@ -137,7 +137,7 @@ To read or write a specific region of the image defined in world coordinates, yo
 
 ```pycon exec="true" source="console" session="get_started"
 >>> from ngio import Roi
->>> roi = Roi.from_values(slices={"x": (34.1, 321.6), "y": (10, 330)}, name=None) # Define a ROI in world coordinates
+>>> roi = Roi(x=34.1, y=10, x_length=321.6, y_length=330) # Define a ROI in world coordinates
 >>> image.get_roi_as_numpy(roi) # Get the image data in the ROI as a numpy array
 >>> print(image.get_roi_as_numpy(roi).shape) # markdown-exec: hide
 ```

{ngio-0.5.0 → ngio-0.5.0a2}/docs/getting_started/3_tables.md

@@ -35,19 +35,17 @@ Ngio supports three types of tables: `roi_table`, `feature_table`, and `masking_
     cmap_array[0] = 0
     cmap = ListedColormap(cmap_array)
     image_3 = ome_zarr_container.get_image(path="3")
-    image_data = image_3.get_as_numpy(c=0)
+    image_data = image_3.get_array(c=0)
     image_data = np.squeeze(image_data)
     roi = roi_table.get("FOV_1")
-    roi = roi.to_pixel(pixel_size=image_3.pixel_size)
-    x_slice = roi.get("x")
-    y_slice = roi.get("y")
+    roi = roi.to_roi_pixels(pixel_size=image_3.pixel_size)
     #label_3 = ome_zarr_container.get_label("nuclei", pixel_size=image_3.pixel_size)
-    #label_data = label_3.get_as_numpy()
+    #label_data = label_3.get_array()
     #label_data = np.squeeze(label_data)
     fig, ax = plt.subplots(figsize=(8, 4))
     ax.set_title("FOV_1 ROI")
     ax.imshow(image_data, cmap='gray')
-    ax.add_patch(Rectangle((x_slice.start, y_slice.start), x_slice.length, y_slice.length, edgecolor='red', facecolor='none', lw=2))
+    ax.add_patch(Rectangle((roi.x, roi.y), roi.x_length, roi.y_length, edgecolor='red', facecolor='none', lw=2))
     #ax.imshow(label_data, cmap=cmap, alpha=0.6)
     # make sure the roi is centered
     ax.axis('off')
@@ -60,7 +58,7 @@ Ngio supports three types of tables: `roi_table`, `feature_table`, and `masking_
     ROIs can be used to slice the image data:
     ```pycon exec="true" source="console" session="get_started"
     >>> roi = roi_table.get("FOV_1")
-    >>> roi_data = image.get_roi_as_numpy(roi)
+    >>> roi_data = image.get_roi(roi)
     >>> roi_data.shape
     >>> print(roi_data.shape) # markdown-exec: hide
     ```
@@ -78,10 +76,10 @@ Ngio supports three types of tables: `roi_table`, `feature_table`, and `masking_
     cmap = ListedColormap(cmap_array)
     roi = roi_table.get("FOV_1")
     image_3 = ome_zarr_container.get_image(path="3")
-    image_data = image_3.get_roi_as_numpy(roi, c=0)
+    image_data = image_3.get_roi(roi, c=0)
     image_data = np.squeeze(image_data)
     #label_3 = ome_zarr_container.get_label("nuclei", pixel_size=image_3.pixel_size)
-    #label_data = label_3.get_as_numpy()
+    #label_data = label_3.get_array()
     #label_data = np.squeeze(label_data)
     fig, ax = plt.subplots(figsize=(8, 4))
     ax.set_title("FOV_1 ROI")
@@ -106,7 +104,7 @@ Ngio supports three types of tables: `roi_table`, `feature_table`, and `masking_
     ROIs can be used to slice the image data:
     ```pycon exec="true" source="console" session="get_started"
     >>> roi = masking_table.get_label(100)
-    >>> roi_data = image.get_roi_as_numpy(roi)
+    >>> roi_data = image.get_roi(roi)
     >>> roi_data.shape
     >>> print(roi_data.shape) # markdown-exec: hide
     ```
@@ -124,10 +122,10 @@ Ngio supports three types of tables: `roi_table`, `feature_table`, and `masking_
     cmap = ListedColormap(cmap_array)
     roi = masking_table.get_label(100)
     image_3 = ome_zarr_container.get_image(path="2")
-    image_data = image_3.get_roi_as_numpy(roi, c=0)
+    image_data = image_3.get_roi(roi, c=0)
     image_data = np.squeeze(image_data)
     label_3 = ome_zarr_container.get_label("nuclei", pixel_size=image_3.pixel_size)
-    label_data = label_3.get_roi_as_numpy(roi)
+    label_data = label_3.get_roi(roi)
     label_data = np.squeeze(label_data)
     fig, ax = plt.subplots(figsize=(8, 4))
     ax.set_title("Label 1 ROI")
@@ -158,7 +156,7 @@ Tables (differently from Images and Labels) can be purely in memory objects, and
     ```pycon exec="true" source="console" session="get_started"
     >>> from ngio.tables import RoiTable
     >>> from ngio import Roi
-    >>> roi = Roi.from_values(slices={"x": (0, 128), "y": (0, 128)}, name="FOV_1")
+    >>> roi = Roi(x=0, y=0, x_length=128, y_length=128, name="FOV_1")
     >>> roi_table = RoiTable(rois=[roi])
     >>> print(roi_table) # markdown-exec: hide
     ```

{ngio-0.5.0 → ngio-0.5.0a2}/docs/getting_started/4_masked_images.md

@@ -30,10 +30,10 @@ Let's create a masked image from the `nuclei` label:
 
 Since the `MaskedImage` is a subclass of `Image`, we can use all the methods available for `Image` objects.
 
-The two most notable exceptions are the `get_roi_as_numpy` (or `get_roi_as_dask`) and `set_roi` which now instead of requiring a `roi` object, require an integer `label`.
+The two most notable exceptions are the `get_roi` and `set_roi` which now instead of requiring a `roi` object, require an integer `label`.
 
 ```pycon exec="true" source="console" session="masked_images"
->>> roi_data = masked_image.get_roi_as_numpy(label=1009, c=0)
+>>> roi_data = masked_image.get_roi(label=1009, c=0)
 >>> roi_data.shape
 >>> print(roi_data.shape) # markdown-exec: hide
 ```
@@ -50,7 +50,7 @@ cmap_array = np.random.rand(1000, 3)
 cmap_array[0] = 0
 cmap = ListedColormap(cmap_array)
 
-image_data = masked_image.get_roi_as_numpy(label=1009, c=0)
+image_data = masked_image.get_roi(label=1009, c=0)
 image_data = np.squeeze(image_data)
 
 fig, ax = plt.subplots(figsize=(8, 4))
@@ -68,13 +68,13 @@ Additionally we can used the `zoom_factor` argument to get more context around t
 For example we can zoom out the ROI by a factor of `2`:
 
 ```pycon exec="true" source="console" session="masked_images"
->>> roi_data = masked_image.get_roi_as_numpy(label=1009, c=0, zoom_factor=2)
+>>> roi_data = masked_image.get_roi(label=1009, c=0, zoom_factor=2)
 >>> roi_data.shape
 >>> print(roi_data.shape) # markdown-exec: hide
 ```
 
 ```python exec="1" html="1" session="masked_images"
-image_data = masked_image.get_roi_as_numpy(label=1009, c=0, zoom_factor=2)
+image_data = masked_image.get_roi(label=1009, c=0, zoom_factor=2)
 image_data = np.squeeze(image_data)
 
 fig, ax = plt.subplots(figsize=(8, 4))
@@ -90,7 +90,7 @@ print(buffer.getvalue())
 
 ## Masked operations
 
-In addition to the `get_roi_as_numpy` method, the `MaskedImage` class also provides a masked operation method that allows you to perform reading and writing only on the masked pixels.
+In addition to the `get_roi` method, the `MaskedImage` class also provides a masked operation method that allows you to perform reading and writing only on the masked pixels.
 
 For these operations we can use the `get_roi_masked` and `set_roi_masked` methods.
 For example, we can use the `get_roi_masked` method to get the masked data for a specific label:
@@ -123,7 +123,7 @@ We can also use the `set_roi_masked` method to set the masked data for a specifi
 ```
 
 ```python exec="1" html="1" session="masked_images"
-masked_data = masked_image.get_roi_as_numpy(label=1009, c=0, zoom_factor=2)
+masked_data = masked_image.get_roi(label=1009, c=0, zoom_factor=2)
 masked_data = np.squeeze(masked_data)
 fig, ax = plt.subplots(figsize=(8, 4))
 ax.set_title("Masked Label 1009 ROI - After setting")

{ngio-0.5.0 → ngio-0.5.0a2}/docs/index.md

@@ -28,11 +28,11 @@ Ngio's mission is to streamline working with OME-Zarr files by providing a simpl
 ## Getting Started
 
 Refer to the [Getting Started](getting_started/0_quickstart.md) guide to integrate ngio into your workflows. We also provide a collection of [Tutorials](tutorials/image_processing.ipynb) to help you get up and running quickly.
-For more advanced usage and API documentation, see our [API Reference](api/ome_zarr_container.md).
+For more advanced usage and API documentation, see our [API Reference](api/ngio.md).
 
 ## Supported OME-Zarr versions
 
-Ngio supports OME-Zarr v0.4 and v0.5, with Zarr v2 and v3 storage formats.
+Currently, ngio only supports OME-Zarr v0.4. Support for version 0.5 and higher is planned for future releases.
 
 ## Development Status
 
@@ -51,6 +51,7 @@ Ngio supports OME-Zarr v0.4 and v0.5, with Zarr v2 and v3 storage formats.
 
 ### Upcoming Features
 
+- Support for OME-Zarr v0.5 and Zarr v3 (via `zarr-python` v3)
 - Enhanced performance optimizations (parallel iterators, optimized io strategies)
 
 ## Contributors

{ngio-0.5.0 → ngio-0.5.0a2}/docs/tutorials/create_ome_zarr.ipynb

@@ -42,7 +42,7 @@
     "ome_zarr = create_ome_zarr_from_array(\n",
     "    store=\"./data/human_mitosis.zarr\",\n",
     "    array=skimage.data.human_mitosis(),\n",
-    "    pixelsize=0.1,  # Just a guess\n",
+    "    xy_pixelsize=0.1,  # Just a guess\n",
     ")\n",
     "ome_zarr"
    ]
@@ -93,7 +93,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.14"
+   "version": "3.11.13"
   }
  },
  "nbformat": 4,

{ngio-0.5.0 → ngio-0.5.0a2}/docs/tutorials/feature_extraction.ipynb

@@ -142,13 +142,6 @@
    "source": [
     "ome_zarr.get_table(\"nuclei_regionprops\").lazy_frame.collect()"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {
@@ -167,7 +160,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.14"
+   "version": "3.11.13"
   }
  },
  "nbformat": 4,

{ngio-0.5.0 → ngio-0.5.0a2}/docs/tutorials/hcs_exploration.ipynb

@@ -102,13 +102,6 @@
     "print(test_plate)\n",
     "print(f\"Rows: {test_plate.rows}, Columns: {test_plate.columns}\")"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {
@@ -127,7 +120,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.14"
+   "version": "3.11.13"
   }
  },
  "nbformat": 4,

{ngio-0.5.0 → ngio-0.5.0a2}/docs/tutorials/image_processing.ipynb

@@ -241,13 +241,6 @@
     "# No need to consolidate, the iterator takes care of that\n",
     "# after all the regions have been processed"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {
@@ -266,7 +259,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.14"
+   "version": "3.11.13"
   }
  },
  "nbformat": 4,

{ngio-0.5.0 → ngio-0.5.0a2}/docs/tutorials/image_segmentation.ipynb

@@ -240,6 +240,13 @@
     "plt.tight_layout()\n",
     "plt.show()"
    ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
   }
  ],
  "metadata": {
@@ -258,7 +265,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.14"
+   "version": "3.11.13"
   }
  },
  "nbformat": 4,