Measurement

Note

Measurement nodes rely on the measurement features closely described here: Measurement Features.

Measurement > Basic

Node input/output overview for all Basic nodes.

Table 26. 

Measurement nodeInputOutput
FieldChannel, Mast? Row per field
ObjectBinary, Channel* Row per object
Object CountBinary+, Channel* Row per field
ParentParent, Child, Channel* Row per parent object
ChildrenParent, Child, Channel* Row per child object
CellCells, Nuclei, Spots?, Channel* Row cell

where:

? ... optional,

+ ... at least one,

* ... zero or more.

In order to reduce the number of nodes required for a recipe all nodes include features from more generic measurements. These are repeated in every row if needed. For example:

  • All measurements include frame metadata to be able to include time filename from the same node.

  • Object measurement includes all features from frame measurement, eliminating the need to add a separate field measurement node to obtain data such as the measured area.

Measurement > Basic > Field, Measurement > Basic > Volume

The Field node measures the intensity features in the whole image field. The output is a table where every row corresponds to one field.

Optionally, a binary input (a mask) can be connected in order to reduce the measured area. Only the pixels under the mask are measured.

All Basic measurement nodes are set in a similar way with variations in the list of measurement features depending on the node type and their dimension (2D/3D).

  1. Select the measurement feature from the Add Feature list. Click on it when you see the + symbol next to its name. It is added to the right list showing all measured features. Use the down arrow next to the feature to further specify the measurement.

    If a feature displays the channels selection bar , first select on which channel the measurement will be done (green channel is selected in our example) and then add the feature. The channel can be changed later by clicking on the Change channels button next to the = icon.

  2. Adjust the name of the feature in the Custom Name column. This name is then passed in the Analysis Results table.

  3. Choose the Channels on which the feature is calculated.

  4. Set the resulting Format and the number of decimal units (dec).

The Calculator (Calculated Column) feature is different than the other features as it displays a scientific calculator at the bottom with buttons for arithmetical operations, allowing the calculation of a new column using already inserted features (click on the icon to insert a feature into the formula).

Measurement of some features can be further specified in their Aggregation drop-down menu. Order of a feature can be changed by clicking and dragging the feature to a different row position in the list. To hide the selected feature in the Records table, click on the icon. To delete a feature, click on the icon. To remove all features in the list, click Remove all.

ObjectId and ObjectEntity are shown in the Analysis Results as {BinaryLayerName}Id and {BinaryLayerName}Entity. Naming the binary layers as Cell, Nuclei, Parent, etc., so that the columns are named CellId, CellEntity, NucleiId, etc., enhances the clarity for the user. Generally one row record is created per cell. Some nodes generate a varying number of rows compared to a classic measurement (e.g. a histogram produces one row for each pixel value or bin). Loop indexes are dependent on the input file and produce multiple columns in the analysis results table if the input file has multiple loops.

Measurement > Basic > Object, Measurement > Basic > Object

Measures all features of every object. The output is a table where every row corresponds to one object.

Optional channel inputs must be connected when intensity features are measured.

Field feature as well as field and global metadata can be measured in the same node. They are repeated for every object.

The description of the dialog window behavior can be found in the Measurement > Basic > Field node.

Measurement > Basic > Object Count, Measurement > Basic > Object Count

Measures object features on the whole field. The output is a table where every row corresponds to one field.

The node measures typical binary features like Object count, Area fraction as well as all other object features as aggregates (mean, sum, max, ...).

Optionally, the node can measure more binary layers at once.

Optional channel inputs must be connected when intensity features are measured.

The description of the dialog window behavior can be found in the Measurement > Basic > Field node.

Measurement > Basic > Parent, Measurement > Basic > Parent

Measures parent and children object features. The output is a table where every row corresponds to one parent object.

Optional channel inputs must be connected when intensity features are measured.

Parent-children relationship 
Every parent may โ€œhaveโ€ zero (0) or more children. There are three methods for determining childhood:

  • Child is inside the parent - all child pixels are in the parent.

  • Child is intersecting with the parent - they have at least one common pixel.

  • Child nearest parent - closest parent measured border to border.

The node measures features of the parent objects as well as aggregates (mean, sum, max, ...) of the children object features. Please see the aggregation statistics table (Data manipulation > Grouping > Aggregate Rows).

Note

The Parent Id is always named ObjectId in the results. One row is created per parent. Child measurement is aggregated per parent (pick the Aggregation type for each child measurement).

The description of the dialog window behavior can be found in the Measurement > Basic > Field node.

Measurement > Basic > Children, Measurement > Basic > Children

Measures parent and children object features. The output is a table where every row corresponds to one children object.

Optional channel inputs must be connected when intensity features are measured (see Parent-children relationship in Measurement > Basic > Parent).

The node measures features of both parent and children objects. The parent features are repeated for its every child. Having all children features is useful in later downstream nodes where the parent ID can be used for grouping, reduction or sorting.

Children IDs can be โ€œmeasuredโ€ and used for joining with other nested children nodes.

Note

The Parent Id is always named ObjectId in the results. One row is created per child. Aggregation can be done using Data manipulation > Basic > Reduce Records.

The description of the dialog window behavior can be found in the Measurement > Basic > Field node.

Measurement > Basic > Cell

Measures object features of cell, nucleus and few features of the cytoplasm. The output is a table where every row corresponds to one cell and nucleus.

Optional channel inputs must be connected when intensity features are measured.

Cell must be connected to MakeCell node which ensures that every cell has exactly one. It also gives the same ID to every cell and its nucleus.

Cytoplasm is internally calculated as complement of the nucleus inside cell. Consequently it is hollow and may be split in more than one object (having same object ID though). Because of this it does not make sense to measure most of the object features.

Optionally Spots objects can be connected to count their presence in each compartment.

  • For the count feature the presence in a compartment is defined by the position of the center pixel.

  • For the area and intensity features the intersection of spots and a compartment is used.

Node Inputs

Cells

Layer representing cells (โ€œCellโ€ output).

Nuclei

Layer representing nuclei (โ€œNucleusโ€ output).

Spots

Layer representing โ€œSpotsโ€ inside the nucleus or cytoplasm area.

Channel

Channel used for intensity based measured features.

The description of the dialog window behavior can be found in the Measurement > Basic > Field node.

Measurement > Estimates > Shift Estimate

Outputs the X and Y shift estimates (in px and ยตm) for the checked correction method.

Measurement > Estimates > SNR Estimate

Estimates the Signal to Noise Ratio (โ€œSNRโ€) value present in the connected color result.

Measurement > Metadata > Global

Retrieves global metadata and custom information from Channel A.

Measurement > Metadata > Recorded Data

Shows all recorded data from the connected color image.

Measurement > Metadata > Wellplate

Retrieves well plate information and thumbnail using Channel A and Binaries B1, ..., Bn and stores it in the table.

Thumbnail

Source Rect

Defines size (in microns if calibrated) of the center portion of the frame that is cropped and rendered.

Maximum Size

Maximum size (in pixels) is a limit to which the rendered image is stretched down if being bigger.

Labeling

Predefined labels

List of possible labels separated by comma. Listed values are used in the โ€œNumber Ofโ€ aggregation menu (e.g. in Data manipulation > Basic > Reduce Records node).

Measurement > Field pixel values > Histogram

Calculates a histogram of all pixel values in the color image. If the connected color image has multiple channels they are averaged into a single value per pixel. If a binary is connected only pixels under it are taken.

Minimum

minimum pixel value; 0 or minimum for floats by default

Maximum

maximum pixel value; or maximum for floats by default

Bin count

number of histogram bins; or 65536 for floats by default

Select output columns

Check which columns will be present in the Analysis Results.

Measurement > Field pixel values > Pixel Values

Reports all pixel values of the color image. If the connected color image has multiple channels they are averaged into a single value per pixel. If a binary is connected only pixels under it are taken.

Measurement > Resolution > Image Pair FRC

Fourier Ring Correlation (FRC) is a technique used to measure the actual resolution of two independent images of the same scene. This method produces a numerical value that represents the resolution, providing a precise and reliable measurement. However, obtaining two independent images of the identical scene can often be challenging. Despite this, FRC is versatile and applicable across various imaging modalities.

This node implements the paper Measuring image resolution in optical nanoscopy.

Measurement > Resolution > One Image FRC

This node is a modification of the Measurement > Resolution > Image Pair FRC node so that it can be used for only one image and two images are not needed. This is based on the paper Fourier ring correlation simplifies image restoration in fluorescence microscopy. Accuracy and reliability is lower than on the Measurement > Resolution > Image Pair FRC node. It is calibrated for AX and NSPARC images. Trying other modalities is not recommended.

Measurement > Object pixel values > Histogram

Calculates histogram of all pixel values for every binary object.

Please see Measurement > Field pixel values > Histogram.

Measurement > Object voxel values > Histogram

Calculates histogram of all voxel values for every binary object.

Please see Measurement > Field pixel values > Histogram.

Measurement > Object pixel values > Pixel Values

Reports all values for every object.

Measurement > Object pixel values > Profile Line

Reports all pixel values along every line. If the object is not a line the order of pixel is undefined.

Measurement > Distance > Nearest Object, Measurement > Distance > NearestObjDist

Measures the smallest distance to another 2D/3D object. Please see NearestObjDist .

Measurement > Distance > Pairwise Distance

Calculates the distance between objects in two binary layers.

Reference

A center to B center

calculates distance between the centers of two objects.

A center to B border, A border to B center

calculates distance between the center of one object and the closest point on the border of the other object.

A border to B border

calculates distance between the borders of objects (minimal distance between borders). When the objects are touching, the distance is 0.

Measurement > Z-stack measurements > Focus criteria

(requires: General Analysis 3) (requires: Local Option)

Calculates the focus criteria (values which estimate the image sharpness) for each slice in a Z-stack and estimates the focus position. For the bright field and fluorescence criteria, the x-y region of the image is divided into 3x3 crops. The focus criterion is calculated for each crop and Z-position, and the overall results are used to estimate the focus position. The calculated focus position corresponds to the value that would be obtained during (non-AI) live auto-focusing if the camera captured the same Z-stack.

Type

Choose the type of the focus criterion.

Pass type

Choose how the focus should be evaluated as if the Z-stack was obtained in one of the following modes: Single pass autofocus (Single pass), first pass of two-pass (2 passes: pass #1) autofocus, or second pass of two-pass autofocus (2 passes: pass #2).

Output columns

Z coord

Z-position of each slice.

Validity check

Validity of the focus estimation. Can be either OK (the focus position was found), Small range (the focus position is out of range) or Fail (focus position couldn't be estimated).

Focus plane

If the result of the validity check was OK, this column contains the found focus position. If the focus was found to be out of the Z-range, it contains the Z-value at the corresponding border of the range. If the focusing failed, it contains nothing.

Whole frame criteria

Focus criteria calculated across Z for the whole image.

Crop # criteria

Focus criteria calculated across Z for each crop. Crops #1 - #3, #4 - #6 and #7 - #9 correspond, respectively, to the top, middle and bottom of the image.

Selected criteria

If the result is OK, this column contains the focus criteria calculated across Z for the crop which had the most impact on the Z-position. Otherwise, this column is empty.

Measurement > Volume voxel values > Histogram

Calculates histogram of all voxel values. If the connected color volume has multiple channels they are averaged into a single value per voxel. If a binary is connected only pixels under it are taken.

Please see Measurement > Field pixel values > Histogram.