cellmap_flow.io.multiscale

The voxel size of the raw level a model’s output is drawn over.

Choosing a level for a voxel size is worldarray’s (select_level, its spec’s Behaviour 3; wa.open(path, voxel_size=...) applies it). What stays here is the viewer’s question: given any path into a pyramid and a model’s declared voxel size, which stored level does the model actually read, so that its output can be placed over the raw at that level’s size.

Attributes

logger

Functions

closest_raw_scale(dataset_path, target_voxel_size) → Optional[tuple]

The voxel size (nm, z/y/x) of the level of dataset_path's pyramid

Module Contents

cellmap_flow.io.multiscale.logger

cellmap_flow.io.multiscale.closest_raw_scale(dataset_path: str, target_voxel_size) → tuple | None

The voxel size (nm, z/y/x) of the level of dataset_path’s pyramid that a model at target_voxel_size reads (worldarray’s “floor”: the level at that size, else the coarsest no coarser than it on any axis, else the first), or None, with a warning, when it cannot be determined.

dataset_path may be the multiscale group or one of its levels, a precomputed volume or one of its scales, or a lone array (its own size). The sizes come from the group’s own document where it lists them (OME-NGFF, COSEM N5, precomputed); no level is opened then.