Object counting

Object counting is the most fundamental measurement workflow in GA3. At its core, it requires only two steps: segmentation to detect objects and object count measurement to quantify them. However, this workflow demonstrates a complete analysis pipeline that produces comprehensive results including temporal trends, per-object features, and synchronized visualizations.

Workflow overview

The recipe consists of four functional blocks:

  1. Segmentation

    Detects objects using thresholding (or alternative segmentation methods).

  2. Object counting block

    Measures field-level statistics, accumulates data across time, and displays temporal trends.

  3. Object measurement block

    Measures detailed features for individual objects in the current frame.

  4. Presentation block

    Organizes all tables and graphs into a synchronized, interactive display.

Recipe variations 
This workflow comes in three variations that share the same core structure:

RGB version (single frame):

Fluorescence version (time-lapse):

  • Uses Threshold for fluorescence channels.

  • Processes multi-frame time-lapse data.

  • Shows temporal evolution of object counts.

Catalog version (with gallery):

Note

The following sections describe the shared workflow structure. Specific differences between RGB and fluorescence variants are noted where relevant.

Segmentation 
Segmentation is the critical first step that determines which pixels belong to objects of interest. GA3 provides multiple segmentation methods, with thresholding being the most straightforward.

Threshold methods

For RGB images - Segmentation > Threshold > RGB Threshold:

  • Works directly on RGB color images.

  • Separates objects based on color (hue, saturation, intensity).

  • Settings used:

    • Auto Threshold Method: Intermodes algorithm.

    • IsHSI: 1 (uses HSI color space instead of RGB).

    • GreenHigh: 142 (upper limit on green channel in HSI).

    • Clean: 0.504 ยตm to remove small debris.

    • Smooth: 0.063 ยตm to regularize boundaries.

    • Fill: Enabled to fill holes inside objects.

    • FilterByCircularity: Enabled with CircularityLow: 0.25 to remove elongated artifacts.

For fluorescence images - Threshold:

  • Works on grayscale fluorescence channels.

  • Separates bright objects from dark background.

  • Settings used:

    • Auto Threshold Method: Triangle algorithm.

    • AutoThresholdOn: Enabled for automatic threshold determination.

    • Clean: 0.498 ยตm to remove noise.

    • Separate: 0.498 ยตm to split touching objects.

    • Smooth: 0.498 ยตm to smooth boundaries.

    • Fill: Enabled to fill holes.

    • IntensityLow: 114 (manual override if needed).

Note

Auto threshold algorithms: GA3 provides many automatic thresholding methods (Triangle, Intermodes, Otsu, Li, etc.). Each works best for different intensity distributions. If auto settings do not work well:

  • Try different auto methods from the drop-down.

  • Use the histogram to manually set IntensityLow/High.

  • Check the preview to verify segmentation quality.

Alternative segmentation methods 
While thresholding works for many samples, GA3 offers more sophisticated segmentation for challenging cases:

Spot Detection (Spot detections)

  • For small, bright, round objects (cells, particles, nuclei).

  • Uses contrast and expected diameter.

  • More robust to background variations.

Segment.ai (NIS.ai > Segmentation > Segment.ai)

  • AI-powered segmentation for complex structures.

  • Learns from training data.

  • Handles variable morphology.

Segment Objects.ai (NIS.ai > Segmentation > Segment Objects.ai)

  • AI segmentation for specific object types.

  • Pre-trained models available.

  • Best for cells, nuclei, organoids.

Cellpose (Segmentation > Special detections > Cellpose4)

  • State-of-the-art cell segmentation.

  • Works without training data.

  • Excellent for cells and nuclei.

Choose the segmentation method that best matches your sample characteristics.

Object counting block 
This block measures field-level (population) statistics and tracks them across time. It produces a table showing how object counts change over the time-lapse sequence.

Measurement > Basic > Object Count computes aggregate statistics for all objects in each field. Unlike measuring individual objects, this node produces one row per frame containing population-level data.

Measured features:

  • Time: Timestamp of the frame (seconds or frame number).

  • Object Count: Total number of detected objects in the field.

  • Total Object Area: Sum of all object areas (ยตm2).

  • Area Fraction: Proportion of the field covered by objects (0-1).

Calculated feature:

  • Area Fraction %: Calculated column = AreaFraction ร— 100 for easier interpretation as percentage.

The node has two inputs:

  • Binary layer: The segmentation result defining objects.

  • Channel: For intensity measurements in the objects.

This measurement runs frame-by-frame through the time-lapse, producing one row per frame.

Accumulate Records 
Data manipulation > Basic > Accumulate Records collects measurements from all frames into a single table. Without accumulation, only the current frame data would be available.

Key settings:

  • LoopName: โ€œAll loopsโ€ (accumulate over all loops - time-lapse, z-stack, multi-point).

  • PreviewMode: OFF (accumulate all data in preview).

Note

Preview optimization: To speed up preview, check Apply only on current frame in preview. This limits accumulation during preview but includes all frames in the final run. This is useful for long time-lapses where preview would be slow.

The accumulated table contains one row per frame, allowing temporal analysis of the entire sequence.

Counts table 
Data manipulation displays the accumulated object counts with interactive functionality.

Configuration:

  • Data/Display: โ€œAll dataโ€ to show all frames.

  • Interaction/Row selection: Enabled to link table rows to image frames.

  • Statistics: Shows min, max, mean of all columns.

Interactive behavior:

  • Clicking a row in the table jumps to that frame in the image.

  • The current frame is highlighted in the table.

  • Enables quick navigation through the time-lapse.

Line chart 
Results & Graphs > Graphs > Linechart visualizes the temporal evolution of object populations.

Configuration:

  • Data/Display: โ€œAll dataโ€ to plot all frames.

  • X-axis: Time (with format set to display as time).

  • Left Y-axis: Object Count.

  • Right Y-axis: Area Fraction % (secondary axis for different scale).

Display features:

  • Dual Y-axes allow plotting variables with different scales.

  • Time formatting displays timestamps properly.

  • Interactive tools: pan, zoom, frame selection.

This chart immediately reveals trends like:

  • Increasing object counts (proliferation, accumulation).

  • Decreasing counts (cell death, removal).

  • Periodic patterns (division cycles).

  • Sudden changes (experimental interventions).

Objects measurement block 
While the counting block provides population statistics, this block measures detailed features for every individual object. It produces rich morphological and intensity data for single-object analysis.

Object Features measurement 
Measurement > Basic > Object measures comprehensive features for each detected object. This node produces one row per object, with many measured columns.

Inputs:

  • Binary layer: Defines object boundaries.

  • Channel(s): For intensity measurements.

Measured feature categories:

Morphological features:

  • Size: Area, Equivalent Diameter, Perimeter.

  • Shape: Length, Width, MaxFeret, MinFeret.

  • Form factors: Circularity, Elongation.

  • Position: CenterX, CenterY (object centroids).

Intensity features (per channel):

  • MeanIntensity: Average pixel intensity in the object.

  • SumIntensity: Total intensity (integrated).

  • MinIntensity, MaxIntensity: Intensity range.

  • StdDevIntensity: Intensity variation.

Note

Feature selection: The node can measure dozens of features. Select only those relevant to your analysis to keep the table manageable. More features = larger tables and slower processing.

This measurement runs per frame, producing a table of objects for the currently displayed frame.

Object Features Table 
Table ( Data manipulation) displays individual object measurements.

Configuration:

  • Data/Display: โ€œCurrent frameโ€ to show only objects in the displayed frame.

  • Interaction/Row selection: Enabled to highlight objects.

  • Column Sorting: Enabled for sorting by any feature.

Interactive behavior:

  • Selecting a row highlights the corresponding object in the image.

  • Selecting an object in the image highlights its row in the table.

  • Sort by any column to find largest/smallest/brightest objects.

  • Multiple row selection highlights multiple objects.

This allows for detailed inspection:

โ€œWhich object has the largest area?โ€

โ€œWhat are the intensities of the brightest objects?โ€

Histogram 
Results & Graphs > Graphs > Histogram shows the frequency distribution of any selected object feature.

Configuration:

  • Data/Display: โ€œCurrent frameโ€ to show distribution for current frame objects.

  • Data/Displayed columns: Configurable feature selection (drop-down).

  • Bin count: Number of histogram bins.

  • Fit normal: Optional Gaussian fit overlay.

Visualization options:

  • Select which feature to plot (Area, Circularity, Intensity, etc.).

  • View distribution shape (normal, bimodal, skewed).

  • Identify outliers or subpopulations.

  • Statistical fit shows mean and standard deviation.

The histogram reveals patterns like:

  • Uniform population (narrow distribution).

  • Size heterogeneity (broad distribution).

  • Two populations (bimodal distribution).

  • Outliers (isolated bars far from the main peak).

Presentation block 
The presentation block organizes all tables and graphs into a synchronized, interactive display. This creates a cohesive analysis interface where all views are linked together.

The presentation uses stacked layout nodes (Layout) to organize visualizations:

Left pane

  • Object Features Table (current frame individual objects).

Right pane (stacked vertically):

  • Counts Table (all frames population statistics).

  • Histogram (feature distribution).

  • Line Chart (temporal trends).

Display node 
Results & Graphs > Layout > Display combines the two layout panes with the image viewer.

Settings

  • showNotes: 0 (hides the notes panel).

Synchronized interactions:

  • Selecting an object in the image โ†’ highlights its row in Object Features Table.

  • Selecting a row in Object Features Table โ†’ highlights the object in the image.

  • Selecting a row in Counts Table โ†’ navigates to that frame.

  • All views update together when changing frames.

The Results & Graphs > Layout > Display node creates a complete analysis environment where image data and measurements are tightly integrated.

Layout customization

The layout button in the interface allows reorganizing views:

  • Horizontal or vertical splits.

  • Resize panes by dragging dividers.

  • Show/hide individual views.

  • Maximize specific views.

Experiment with layouts to find the arrangement that best suits your analysis workflow.

Output files 
The recipe saves three types of output for further analysis or documentation:

Save Channels

Input & Output > Save to Document > Save Channels does not modify channel data as it โ€œstoresโ€ the source (Original):

  • All input channels (RGB or fluorescence).

  • Original intensity values preserved.

Save Binaries

Input & Output > Save to Document > Save Binaries saves the segmentation results:

  • Binary layers are saved into H5 file by default.

  • Useful for verifying segmentation quality.

Save Tables

Input & Output > Save to Document > Save Tables saves all measurement results:

  • Data is saved into H5 file.

  • Object count table (population statistics).

  • Object features table (individual measurements).

  • Can be exported to Excel, CSV for external analysis.

  • Results section includes all graphs and visualizations.

Adding the Object Catalog (optional) 
The catalog variation adds a visual gallery of all detected objects, which is especially useful for quality control and classification.

Additional nodes for catalog version

Remove Border Objects (Binary processing > Remove objects > Touching Borders)

  • Removes objects touching the image frame.

  • Prevents incomplete objects from appearing in the catalog.

  • Placed immediately after Threshold.

Object Catalog (Results & Graphs > Tables > Object Catalog)

  • Creates a grid gallery of object thumbnails.

  • Input: Connected to the object features table.

  • Settings:

    • tableRowVisibility: โ€œallโ€ to show all objects.

    • colorChannelSelection: Enabled for channel selection.

    • binaryLayerSelection: Enabled to show segmentation overlay.

Modified layout:

  • Object Catalog gets its own stacked layout pane.

  • Typically displayed on the left alongside the object table.

  • Creates a three-pane layout: Catalog | Table | Counts/Charts.

Interactive features:

  • Click a thumbnail to select that object in the image.

  • Thumbnails show the object cropped from the original image.

  • Can toggle between channels and binary overlay.

  • Useful for visual inspection of segmentation quality.

The catalog is particularly valuable when:

  • Verifying segmentation accuracy across many objects.

  • Identifying misclassified objects.

  • Finding objects with specific morphologies.

  • Quality control in automated screening.

Extending the workflow 
This basic counting workflow can be extended in many ways:

Add classification:

  • Use feature thresholds to classify objects (small/large, dim/bright).

  • Create calculated columns for classification logic.

  • Color-code objects by class.

Add tracking:

Add multi-well analysis:

Add statistical analysis:

  • Calculate p-values between conditions.

  • Fit curves to temporal data.

  • Use statistical nodes in Data manipulation category.

Add 3D analysis:

Summary 
Object counting is the foundational workflow in GA3 that demonstrates the complete analysis pipeline: segmentation โ†’ measurement โ†’ accumulation โ†’ visualization. While simple in concept (just threshold + count), this workflow teaches the essential patterns used in more complex analyses:

  • Frame-by-frame vs. accumulated processing.

  • Current frame vs. all data display modes.

  • Field-level vs. object-level measurements.

  • Synchronized multi-view interfaces.

Master this workflow and you will understand the building blocks for all the GA3 analyses.