ImgLib2 bindings for N5 containers. The N5Utils
class provides static convenience methods to open N5 datasets as cache backed RandomAccessibleInterval
-s (n-dimensional images in ImgLib2 speech), and to save RandomAccessibleInterval
-s as N5 datasets. When opening datasets with block-sizes other than the grid raster, you will see the intersection of grid-cell and block filled with data. Beyond other things, this makes it compatible with datasets stored by Jan Funke's n5-bindings for Zarr, where trailing blocks are overhanging instead of cropped to size. Datasets are saved with trailing blocks cropped to size.
Beanshell example (which is almost Java, but without types, let Eclipse auto-add them in Java code):
import org.janelia.saalfeldlab.n5.*;
import org.janelia.saalfeldlab.n5.imglib2.*;
img = N5Utils.open(new N5FSReader("/home/saalfelds/example.n5"), "/volumes/raw");
Will open the /volumes/raw
dataset from the filesystem based N5 container (directory) /home/saalfelds/example.n5
as a lazy cell image, i.e. no data is loaded initially, but as you access pixels, the necessary blocks will be loaded and cached in memory.
Please add more examples as required.