plexora node prepare
Convert a label mask into something a node can serve.
Convert a label mask into a tiled, pyramidal label image. Masks out of a segmentation pipeline are usually one full-resolution plane, which no tile route can serve at a zoomed-out level. This is the same conversion an import runs, on a machine that has no viewer. node serve does it for you when it has to -- run this first to get the wait over with, to convert somewhere other than beside the mask, or to choose outlines.
Usage
plexora node prepare [-h] [--outlines] source [output]Arguments
sourcerequiredThe mask to convert.
outputWhere to write it. Defaults to beside the original, under the name node serve looks for -- so preparing ahead of time needs no path here and none in the --serve that follows. Name one when the mask's own directory is read-only.
Options
--outlinesBake cell boundaries into the file instead of serving filled labels. Rarely wanted -- the viewer derives outlines at tile-load time from a filled mask, which is faster and smaller.
Examples
Convert a mask ahead of time, next to the original
plexora node prepare /data/tonsil_mask.tifWrite the converted mask somewhere else
plexora node prepare /readonly/tonsil_mask.tif /scratch/me/tonsil_mask.pyramid.ome.tif