Data Types¶
VIPP uses typed graph data to communicate and check intended scientific meaning. Port types prevent many category errors; they cannot determine whether an image, mask, or table is appropriate for your biological question.
| Type | Meaning | Typical napari display |
|---|---|---|
image |
Intensity image, RGB image, PSF, or restored image. | Image layer |
mask |
Binary foreground/background image. | Labels-style overlay |
labels |
Integer object IDs, with zero as background. | Labels layer |
table |
Measurement or summary rows. | Inspector table preview and CSV/TSV output |
array |
Generic array accepted by many processing nodes. | Depends on output node |
mask_or_labels |
Input may be either a binary mask or label image. | Depends on connected input |
any |
Pass-through or generic output where type is resolved from context. | Depends on connected input |
Images¶
Images carry array data plus metadata such as axes, scale, unit, channel names, source identity, and operation history where available.
Masks¶
Masks represent inside/outside decisions. They are usually produced by thresholding, morphology, or colocalized-voxel nodes.
Use masks before label creation when you are still deciding what is foreground.
VIPP stores binary masks as Boolean arrays where possible. If a Boolean mask is
connected to a global automatic-threshold node, VIPP recognizes that it is
already segmented and preserves its True/False decisions. It does not
reinterpret the two levels through Otsu, Triangle, Li, Yen, Isodata, or Minimum
thresholding.
For floating-point intensity images, non-finite pixels (NaN, positive
infinity, or negative infinity) are excluded from global automatic-threshold
estimation and become False in the resulting mask. Inspect why those values
exist; treating them as background is a defined calculation rule, not evidence
that the source data are valid.
Labels¶
Labels represent object identity. Label 0 is background; positive integers are
objects.
Use labels when you want object measurements, label cleanup, object colocalization, or event assignment.
Tables¶
Tables are first-class outputs, not fake images. They appear in the inspector and can be saved as CSV or TSV.
Common table nodes include:
Measure ObjectsMeasure Objects + IntensityMeasure 3D Mesh Morphology- skeleton and network measurements
- colocalization metrics
Merge TablesAdd Metadata ColumnsSummarize Measurements
Manual Calculation Nodes¶
Expensive measurement, graph-analysis, RACC, and deconvolution nodes can be
manual/cached. Select the node and click Calculate or use toolbar
Calculate all.