Data Type: Stacked Label Field ()

Description:

Data objects of type Label Field are used to represent the result of a segmentation applied to a 3D image volume.

A Label Field is a regular cubic grid with the same dimensions as the underlying image volume. For each voxel it contains a label indicating the region that the voxel belongs to. Use module Multi-Thresholding to create a Label Field from an image data stack. You can manually modify a Label Field using 's Segmentation Editor.

In addition to the labels themselves a Label Field may also contain weights indicating the degree of confidence of the label assignment made for each voxel. Such weights are calculated automatically when you choose option sub-voxel accuracy in Multi-Thresholding, when you apply the smoothing filter of Segmentation Editor, or when you resample a Label Field to a smaller resolution using the Resample module.

You can visualize a Label Field by attaching an Ortho Slice module to it. If a Label Field contains weights, the port Primary Array allows you to choose whether the labels or the probabilities are to be displayed.

Connections:

Master [unused]

ImageData [required]
Connection to the image data that the segmentation results refer to. You cannot connect this port to an image object with dimensions different from that of the Label Field, except if the Label Field was newly created via the Project > Create Object... menu (by selecting Images And Fields / Label Field). In this case, the Label Image will be resized so that it matches the dimensions of the image object.

Ports:

Shared colormap

In case a colormap is connected to the field, this colormap will be shown here. If no colormap is connected, only the Edit menu is visible. To connect, disconnect or change the colormap, use the Edit menu or, equivalently, the popup menu under the right mouse button. See also Colormap and PortSharedColormap.

Primary Array

An option menu which only appears if the Label Field contains weights. In this case, the menu lets you select whether the labels or the weights are the primary data array.

Commands:

hasMaterial <name>
Returns true if the specified material is defined in the material section of the Label Field.

makeColormap
Creates a new Colormap object in 's Project View, containing the default colors of all materials of the LabelField.

setColormap <colormapName>
Use colors of colormap for materials. Colormap must be a label colormap.

relabel
Computes new labels so that the materials are numbered in consecutive order starting from 0.

recolor
Adjust the material colors of a label field such that neighboring labels can be clearly distinguished. To use these colors as a colormap, connect the module Create Label Colormap to your label field. It will extract a colormap from the material colors. Alternatively, type makeColormap in the console.

deleteAltData
Deletes the weight information if it is present.