ngio 0.2.0a2__tar.gz → 0.2.0b1__tar.gz

{ngio-0.2.0a2 → ngio-0.2.0b1}/.gitignore

@@ -116,7 +116,10 @@ ENV/
 pixi.lock
 *.egg-info
 
+# Ignore all .zarr directories
 *.zarr
+# but allow .zarr in tests/data
+!tests/data/**/**/test_*.zarr
 
 # ignore data directory
 ./data/

{ngio-0.2.0a2 → ngio-0.2.0b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ngio
-Version: 0.2.0a2
+Version: 0.2.0b1
 Summary: Next Generation file format IO
 Project-URL: homepage, https://github.com/lorenzocerrone/ngio
 Project-URL: repository, https://github.com/lorenzocerrone/ngio
@@ -29,6 +29,7 @@ Requires-Dist: requests
 Requires-Dist: xarray
 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'
@@ -38,6 +39,7 @@ Requires-Dist: pre-commit; extra == 'dev'
 Requires-Dist: pyqt5; extra == 'dev'
 Requires-Dist: rich; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: scikit-image; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: mkdocs; extra == 'docs'
 Requires-Dist: mkdocs-autorefs; extra == 'docs'
@@ -50,6 +52,7 @@ Requires-Dist: scikit-image; extra == 'docs'
 Provides-Extra: test
 Requires-Dist: pytest; extra == 'test'
 Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: scikit-image; extra == 'test'
 Description-Content-Type: text/markdown
 
 # NGIO - Next Generation file format IO

ngio-0.2.0b1/docs/api/core.md

@@ -0,0 +1,3 @@
+# ngio
+
+Work in progress! Sorry!

{ngio-0.2.0a2 → ngio-0.2.0b1}/docs/notebooks/basic_usage.ipynb

@@ -10,15 +10,6 @@
     "\n",
     "For this example we will use a small example image that can be downloaded from the following link: [example ome-zarr](https://zenodo.org/records/13305156)\n",
     "\n",
-    "## Setup\n",
-    "\n",
-    "You can download the example image (on Linux and Mac os) by running the following command:\n",
-    "\n",
-    "```bash\n",
-    "bash setup_data.sh\n",
-    "```\n",
-    "from the root of the repository.\n",
-    "\n",
     "## OmeZarr Container\n",
     "\n",
     "The `OmeZarr Container` provides a high-level interface to read, write and manipulate NGFF images.\n",
@@ -95,8 +86,10 @@
     "print(image)\n",
     "\n",
     "# 3. Get image from a specific pixel size using the pixel_size keyword\n",
-    "image = omezarr_container.get_image(pixel_size=PixelSize(x=0.65, y=0.65, z=1))\n",
-    "print(image)"
+    "# image = omezarr_container.get_image(\n",
+    "#    pixel_size=PixelSize(x=0.65, y=0.65, z=1), strict=True\n",
+    "# )\n",
+    "print(image.pixel_size == PixelSize(x=0.325, y=0.325, z=1))"
    ]
   },
   {
@@ -253,6 +246,32 @@
     "print(new_omezarr_image)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Create an OmeZarr From a Numpy Array\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "\n",
+    "from ngio import create_omezarr_from_array\n",
+    "\n",
+    "x = np.random.randint(0, 255, (16, 128, 128), dtype=np.uint8)\n",
+    "\n",
+    "new_omezarr_image = create_omezarr_from_array(\n",
+    "    store=\"random_ome.zarr\", array=x, xy_pixelsize=0.65, z_spacing=1.0\n",
+    ")\n",
+    "print(new_omezarr_image)\n",
+    "print(new_omezarr_image.get_image())"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -268,6 +287,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "import fsspec\n",
     "import fsspec.implementations.http\n",
     "\n",
     "url = (\n",
@@ -279,17 +299,26 @@
     "\n",
     "fs = fsspec.implementations.http.HTTPFileSystem(client_kwargs={})\n",
     "store = fs.get_mapper(url)\n",
-    "\n",
     "omezarr = open_omezarr_container(store)\n",
     "omezarr"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
+   "cell_type": "markdown",
    "metadata": {},
-   "outputs": [],
-   "source": []
+   "source": [
+    "# Streaming an OmeZarr from a Fractal Server\n",
+    "\n",
+    "Example:\n",
+    "\n",
+    "```python\n",
+    "from ngio.utils import fractal_fsspec_store\n",
+    "\n",
+    "store = fractal_fsspec_store(url=\"https://fracral_url...\", fractal_token=\"**your_secret_token**\")\n",
+    "omezarr = open_omezarr_container(store)\n",
+    "omezarr\n",
+    "```"
+   ]
   }
  ],
  "metadata": {

{ngio-0.2.0a2 → ngio-0.2.0b1}/docs/notebooks/image.ipynb

@@ -216,7 +216,7 @@
    "outputs": [],
    "source": [
     "# Create a a new label object and set it to a simple segmentation\n",
-    "new_label = omezarr.derive_label(\"new_label_2\", overwrite=True)\n",
+    "new_label = omezarr.derive_label(\"new_label\", overwrite=True)\n",
     "\n",
     "simple_segmentation = image.get_array(c=0) > 100\n",
     "simple_segmentation = simple_segmentation[0]\n",
@@ -225,7 +225,7 @@
     "# make a subplot with two image show side by side\n",
     "fig, axs = plt.subplots(1, 2, figsize=(10, 5))\n",
     "axs[0].imshow(image.get_array()[0, 0], cmap=\"gray\")\n",
-    "axs[1].imshow(new_label.get_array()[0], cmap=\"gray\")\n",
+    "axs[1].imshow(new_label.get_array()[0])\n",
     "for ax in axs:\n",
     "    ax.axis(\"off\")\n",
     "plt.tight_layout()\n",
@@ -327,13 +327,6 @@
     "feat_table = omezarr.get_table(\"new_feature_table\")\n",
     "feat_table.dataframe"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {

{ngio-0.2.0a2 → ngio-0.2.0b1}/pyproject.toml

@@ -51,18 +51,20 @@ dependencies = [
 # https://peps.python.org/pep-0621/#dependencies-optional-dependencies
 # "extras" (e.g. for `pip install .[test]`)
 [project.optional-dependencies]
-test = ["pytest", "pytest-cov"]
+test = ["pytest", "pytest-cov", "scikit-image"]
 
 dev = [
     "napari",
     "pyqt5",
     "matplotlib",
+    "devtools",
     "notebook",
     "mypy",
-    "pdbpp",      # https://github.com/pdbpp/pdbpp
+    "pdbpp",        # https://github.com/pdbpp/pdbpp
     "pre-commit",
-    "rich",       # https://github.com/Textualize/rich
+    "rich",         # https://github.com/Textualize/rich
     "ruff",
+    "scikit-image",
 ] # add anything else you like to have in your dev environment here
 
 docs = [
@@ -212,18 +214,12 @@ test13 = { features = ["py13", "test"], solve-group = "py13" }
 # dev env
 dev = { features = ["dev", "test"], solve-group = "py11" }
 
-
-[tool.pixi.feature.py11.tasks]
-pytest_test11 = "pytest"
+[tool.pixi.tasks]
+serve_docs = "mkdocs serve"
+run_tests = "pytest"
+clean_nb_data = "rm -rf ./docs/notebooks/**/*.zarr"
 test_nb = { cmd = "jupyter-execute ./docs/notebooks/*.ipynb" }
-
-[tool.pixi.feature.py12.tasks]
-pytest_test12 = "pytest"
-
-[tool.pixi.feature.py13.tasks]
-pytest_test13 = "pytest"
-
-[tool.pixi.feature.task-feat.tasks]
+test = { depends-on = ["run_tests", "clean_nb_data", "test_nb"] }
 pre_commit_install = "pre-commit install"
 
 ruff-fix-imports = "ruff check --select I --fix"
@@ -233,12 +229,3 @@ pre-commit = { cmd = "pre-commit run --all-files", depends-on = [
     "pre_commit_install",
     "ruff-format",
 ] }
-
-[tool.pixi.tasks]
-serve_docs = "mkdocs serve"
-test = { depends-on = [
-    "pytest_test11",
-    "pytest_test12",
-    "pytest_test13",
-    "test_nb",
-] }

{ngio-0.2.0a2 → ngio-0.2.0b1}/src/ngio/__init__.py

@@ -10,7 +10,7 @@ __author__ = "Lorenzo Cerrone"
 __email__ = "lorenzo.cerrone@uzh.ch"
 
 from ngio.common import ArrayLike, Dimensions
-from ngio.hcs import OmeZarrPlate, OmeZarrWell, open_omezarr_plate, open_omezarr_well
+from ngio.hcs import OmeZarrPlate, create_empty_plate, open_omezarr_plate
 from ngio.images import (
     Image,
     Label,
@@ -20,22 +20,22 @@ from ngio.images import (
     open_image,
     open_omezarr_container,
 )
-from ngio.ome_zarr_meta.ngio_specs import AxesSetup, PixelSize
+from ngio.ome_zarr_meta.ngio_specs import AxesSetup, ImageInWellPath, PixelSize
 
 __all__ = [
     "ArrayLike",
     "AxesSetup",
     "Dimensions",
     "Image",
+    "ImageInWellPath",
     "Label",
     "OmeZarrContainer",
     "OmeZarrPlate",
-    "OmeZarrWell",
     "PixelSize",
     "create_empty_omezarr",
+    "create_empty_plate",
     "create_omezarr_from_array",
     "open_image",
     "open_omezarr_container",
     "open_omezarr_plate",
-    "open_omezarr_well",
 ]

{ngio-0.2.0a2 → ngio-0.2.0b1}/src/ngio/common/__init__.py

@@ -1,6 +1,11 @@
 """Common classes and functions that are used across the package."""
 
-from ngio.common._array_pipe import get_pipe, set_pipe
+from ngio.common._array_pipe import (
+    get_masked_pipe,
+    get_pipe,
+    set_masked_pipe,
+    set_pipe,
+)
 from ngio.common._axes_transforms import (
     transform_dask_array,
     transform_list,
@@ -8,8 +13,9 @@ from ngio.common._axes_transforms import (
 )
 from ngio.common._common_types import ArrayLike
 from ngio.common._dimensions import Dimensions
+from ngio.common._masking_roi import compute_masking_roi
 from ngio.common._pyramid import consolidate_pyramid, init_empty_pyramid, on_disk_zoom
-from ngio.common._roi import RasterCooROI, WorldCooROI
+from ngio.common._roi import RasterCooROI, WorldCooROI, roi_to_slice_kwargs
 from ngio.common._slicer import (
     SliceTransform,
     compute_and_slices,
@@ -27,16 +33,20 @@ __all__ = [
     "SliceTransform",
     "WorldCooROI",
     "compute_and_slices",
+    "compute_masking_roi",
     "consolidate_pyramid",
     "dask_get_slice",
     "dask_set_slice",
     "dask_zoom",
+    "get_masked_pipe",
     "get_pipe",
     "init_empty_pyramid",
     "numpy_get_slice",
     "numpy_set_slice",
     "numpy_zoom",
     "on_disk_zoom",
+    "roi_to_slice_kwargs",
+    "set_masked_pipe",
     "set_pipe",
     "transform_dask_array",
     "transform_list",

{ngio-0.2.0a2 → ngio-0.2.0b1}/src/ngio/common/_array_pipe.py

@@ -158,3 +158,109 @@ def set_pipe(
         )
     else:
         raise NgioValueError("Unknown patch type, expected numpy, dask or delayed.")
+
+
+def _mask_pipe_common(
+    array: zarr.Array,
+    label_array: zarr.Array,
+    label: int,
+    *,
+    dimensions_array: Dimensions,
+    dimensions_label: Dimensions,
+    axes_order: Collection[str] | None = None,
+    mode: Literal["numpy", "dask", "delayed"] = "numpy",
+    **slice_kwargs: slice | int | Iterable[int],
+):
+    array_patch = get_pipe(
+        array,
+        dimensions=dimensions_array,
+        axes_order=axes_order,
+        mode=mode,
+        **slice_kwargs,
+    )
+
+    if "c" in slice_kwargs.keys():
+        # This makes the strong assumption that the
+        # user is passing the channel axis as "c"
+        # This will fail if the channel axis is queried
+        # with a different on-disk name
+        slice_kwargs.pop("c")
+
+    label_patch = get_pipe(
+        label_array,
+        dimensions=dimensions_label,
+        axes_order=axes_order,
+        mode=mode,
+        **slice_kwargs,
+    )
+
+    if isinstance(array_patch, np.ndarray):
+        label_patch = np.broadcast_to(label_patch, array_patch.shape)
+    elif isinstance(array_patch, dask.array.Array):
+        label_patch = dask.array.broadcast_to(label_patch, array_patch.shape)
+    else:
+        raise NgioValueError(f"Mode {mode} not yet supported for masked array.")
+
+    mask = label_patch == label
+    return array_patch, mask
+
+
+def get_masked_pipe(
+    array: zarr.Array,
+    label_array: zarr.Array,
+    label: int,
+    *,
+    dimensions_array: Dimensions,
+    dimensions_label: Dimensions,
+    axes_order: Collection[str] | None = None,
+    mode: Literal["numpy", "dask", "delayed"] = "numpy",
+    **slice_kwargs: slice | int | Iterable[int],
+):
+    array_patch, mask = _mask_pipe_common(
+        array=array,
+        label_array=label_array,
+        label=label,
+        dimensions_array=dimensions_array,
+        dimensions_label=dimensions_label,
+        axes_order=axes_order,
+        mode=mode,
+        **slice_kwargs,
+    )
+    array_patch[~mask] = 0
+    return array_patch
+
+
+def set_masked_pipe(
+    array: zarr.Array,
+    label_array: zarr.Array,
+    label: int,
+    patch: ArrayLike,
+    *,
+    dimensions_array: Dimensions,
+    dimensions_label: Dimensions,
+    axes_order: Collection[str] | None = None,
+    **slice_kwargs: slice | int | Iterable[int],
+):
+    if isinstance(patch, dask.array.Array):
+        mode = "dask"
+    elif isinstance(patch, np.ndarray):
+        mode = "numpy"
+    else:
+        raise NgioValueError(
+            "Mode not yet supported for masked array. Expected a numpy or dask array."
+        )
+
+    array_patch, mask = _mask_pipe_common(
+        array=array,
+        label_array=label_array,
+        label=label,
+        dimensions_array=dimensions_array,
+        dimensions_label=dimensions_label,
+        axes_order=axes_order,
+        mode=mode,
+        **slice_kwargs,
+    )
+    patch = np.where(mask, patch, array_patch)
+    set_pipe(
+        array, patch, dimensions=dimensions_array, axes_order=axes_order, **slice_kwargs
+    )

{ngio-0.2.0a2 → ngio-0.2.0b1}/src/ngio/common/_axes_transforms.py

@@ -9,6 +9,7 @@ from ngio.ome_zarr_meta.ngio_specs._axes import (
     AxesTransformation,
     AxesTranspose,
 )
+from ngio.utils import NgioValueError
 
 T = TypeVar("T")
 
@@ -44,7 +45,7 @@ def transform_numpy_array(
         elif isinstance(operation, AxesSqueeze):
             array = np.squeeze(array, axis=operation.axes)
         else:
-            raise ValueError(f"Unknown operation {operation}")
+            raise NgioValueError(f"Unknown operation {operation}")
     return array
 
 
@@ -59,5 +60,5 @@ def transform_dask_array(
         elif isinstance(operation, AxesSqueeze):
             array = da.squeeze(array, axis=operation.axes)
         else:
-            raise ValueError(f"Unknown operation {operation}")
+            raise NgioValueError(f"Unknown operation {operation}")
     return array

{ngio-0.2.0a2 → ngio-0.2.0b1}/src/ngio/common/_dimensions.py

@@ -57,6 +57,13 @@ class Dimensions:
             return 1
         return self._shape[index]
 
+    def has_axis(self, axis_name: str) -> bool:
+        """Return whether the axis exists."""
+        index = self._axes_mapper.get_axis(axis_name)
+        if index is None:
+            return False
+        return True
+
     def get_shape(self, axes_order: Collection[str]) -> tuple[int, ...]:
         """Return the shape in the given axes order."""
         transforms = self._axes_mapper.to_order(axes_order)

ngio-0.2.0b1/src/ngio/common/_masking_roi.py

@@ -0,0 +1,158 @@
+"""Utilities to build masking regions of interest (ROIs)."""
+
+import itertools
+
+import dask
+import dask.array as da
+import dask.delayed
+import numpy as np
+import scipy.ndimage as ndi
+
+from ngio.common._roi import RasterCooROI, WorldCooROI
+from ngio.ome_zarr_meta import PixelSize
+from ngio.utils import NgioValueError
+
+
+def _compute_offsets(chunks):
+    """Given a chunks tuple, compute cumulative offsets for each axis.
+
+    Returns a list where each element is a list of offsets for that dimension.
+    """
+    offsets = []
+    for dim_chunks in chunks:
+        dim_offsets = [0]
+        for size in dim_chunks:
+            dim_offsets.append(dim_offsets[-1] + size)
+        offsets.append(dim_offsets)
+    return offsets
+
+
+def _adjust_slices(slices, offset):
+    """Adjust slices to global coordinates using the provided offset."""
+    adjusted_slices = {}
+    for label, s in slices.items():
+        adjusted = tuple(
+            slice(s_dim.start + off, s_dim.stop + off)
+            for s_dim, off in zip(s, offset, strict=True)
+        )
+        adjusted_slices[label] = adjusted
+    return adjusted_slices
+
+
+@dask.delayed
+def _process_chunk(chunk, offset):
+    """Process a single chunk.
+
+    run ndi.find_objects and adjust the slices
+    to global coordinates using the provided offset.
+    """
+    local_slices = compute_slices(chunk)
+    local_slices = _adjust_slices(local_slices, offset)
+    return local_slices
+
+
+def _merge_slices(
+    slice1: tuple[slice, ...], slice2: tuple[slice, ...]
+) -> tuple[slice, ...]:
+    """Merge two slices."""
+    merged = []
+    for s1, s2 in zip(slice1, slice2, strict=True):
+        start = min(s1.start, s2.start)
+        stop = max(s1.stop, s2.stop)
+        merged.append(slice(start, stop))
+    return tuple(merged)
+
+
+@dask.delayed
+def _collect_slices(
+    local_slices: list[dict[int, tuple[slice, ...]]],
+) -> dict[int, tuple[slice]]:
+    """Collect the slices from the delayed results."""
+    global_slices = {}
+    for result in local_slices:
+        for label, s in result.items():
+            if label in global_slices:
+                global_slices[label] = _merge_slices(global_slices[label], s)
+            else:
+                global_slices[label] = s
+    return global_slices
+
+
+def compute_slices(segmentation: np.ndarray) -> dict[int, tuple[slice, ...]]:
+    """Compute slices for each label in a segmentation.
+
+    Args:
+        segmentation (ndarray): The segmentation array.
+
+    Returns:
+        dict[int, tuple[slice]]: A dictionary with the label as key
+            and the slice as value.
+    """
+    slices = ndi.find_objects(segmentation)
+    slices_dict = {}
+    for label, s in enumerate(slices, start=1):
+        if s is None:
+            continue
+        else:
+            slices_dict[label] = s
+    return slices_dict
+
+
+def lazy_compute_slices(segmentation: da.Array) -> dict[int, tuple[slice, ...]]:
+    """Compute slices for each label in a segmentation."""
+    global_offsets = _compute_offsets(segmentation.chunks)
+    delayed_chunks = segmentation.to_delayed()
+
+    grid_shape = tuple(len(c) for c in segmentation.chunks)
+
+    grid_indices = list(itertools.product(*[range(n) for n in grid_shape]))
+    delayed_results = []
+    for idx, chunk in zip(grid_indices, np.ravel(delayed_chunks), strict=True):
+        offset = tuple(global_offsets[dim][idx[dim]] for dim in range(len(idx)))
+        delayed_result = _process_chunk(chunk, offset)
+        delayed_results.append(delayed_result)
+
+    return _collect_slices(delayed_results).compute()
+
+
+def compute_masking_roi(
+    segmentation: np.ndarray | da.Array, pixel_size: PixelSize
+) -> list[WorldCooROI]:
+    """Compute a ROIs for each label in a segmentation.
+
+    This function expects a 2D or 3D segmentation array.
+    And this function expects the axes order to be 'zyx' or 'yx'.
+    Other axes orders are not supported.
+
+    """
+    if segmentation.ndim not in [2, 3]:
+        raise NgioValueError("Only 2D and 3D segmentations are supported.")
+
+    if isinstance(segmentation, da.Array):
+        slices = lazy_compute_slices(segmentation)
+    else:
+        slices = compute_slices(segmentation)
+
+    rois = []
+    for label, slice_ in slices.items():
+        if len(slice_) == 2:
+            min_z, min_y, min_x = 0, slice_[0].start, slice_[1].start
+            max_z, max_y, max_x = 1, slice_[0].stop, slice_[1].stop
+        elif len(slice_) == 3:
+            min_z, min_y, min_x = slice_[0].start, slice_[1].start, slice_[2].start
+            max_z, max_y, max_x = slice_[0].stop, slice_[1].stop, slice_[2].stop
+        else:
+            raise ValueError("Invalid slice length.")
+        roi = RasterCooROI(
+            name=str(label),
+            x_length=max_x - min_x,
+            y_length=max_y - min_y,
+            z_length=max_z - min_z,
+            x=min_x,
+            y=min_y,
+            z=min_z,
+        )
+
+        roi = roi.to_world_coo_roi(pixel_size)
+        rois.append(roi)
+    return rois