Fluorescence and absorbance histometry using nuclear marker (1-4 labels - advanced background options)

Parameters:

Name	#	Type	Description
Number of labels to measure (1-4)	1	integer	Select how many label channels to measure. Each channel can be selected multiple times.
Histogram or distribution calculation	2	string	Select Histogram to show output as histogram, or None to show individual cell values.
Calculate a single mean±SE for all cells	3	boolean	Calculates a mean value of all traces for each time point.
Position names and microplate worksheet output	4	boolean	Organizes data in table according to microplate well associations in additional worksheets.
Subtract reference image background and shading correct first (all fluorescence channels)	5	boolean	If background reference image is provided, it can be subtracted, or subtracted and also used for shading corrections. Choose between these two at the bottom.
Channel Number, nuclear stain	6	integer	Channel number of the nuclear marker used for nucleus segmentation.
Background subtraction method, nuclear stain	7	string	Select background subtraction method: Percentile, Rolling ball, Spatial filtering, None. See settings below. Background subtraction is performed in the same way for all channels.
Morphological parameter measurement for nuclei	8	string	Plots and saves time course of selected morphological data
Histogram: range for morphological parameter measurement for nuclei	9	string	If left empty or set to "All", a histogram is generated where the lowest bin starts at the smallest data point and the highest bin ends at the largest data point. If a range is given here e.g. 100-500, then the lowest bin starts at the beginning of the range and the highest bin ends at the end of the range.
#1: Channel Number, label #1	10	integer	Channel number of label #1 to be measured. Each channel can be selected multiple times for different measurements.
#1: Name for label #1	11	string	Custom name to be shown in image and plot window captions and in output data.
#1: Channel type, label #1	12	string	Switch between fluorescence intensity and optical density measurement. Optical density calculation needs previously set up blank reference image (cell-free image) for the given channel number.
#1: Measure label #1 over	13	string	Intensity measurement is performed either over the nucleus or in a perinuclear ring or in the whole cell, marked by secondary segmentation of the cell area marker.
#1: Background subtraction method, label #1	14	string	Select background subtraction method: Percentile, Rolling ball, Spatial filtering, None. See settings below. Background subtraction is performed in the same way for all channels.
#1: Intensity measurement type of label #1	15	string	Available plot types: "Mean", "Sum", "Variance", "PDI variance", "PDI sd", "Line Scan". These statistics describe pixels within each segment.
#1: Perinuclear ring width (pixels), label #1	16	integer	Width of the ring around the nucleus to measure perinuclear area, in pixels. This is used only if "Perinuclear ring" is selected above.
#1: Histogram: range, label #1	17	string	If left empty or set to "All", a histogram is generated where the lowest bin starts at the smallest data point and the highest bin ends at the largest data point. If a range is given here e.g. 100-500, then the lowest bin starts at the beginning of the range and the highest bin ends at the end of the range.
#2: Channel Number, label #2	18	integer	Channel number of label #2 to be measured. Each channel can be selected multiple times for different measurements.
#2: Name for label #2	19	string	Custom name to be shown in image and plot window captions and in output data.
#2: Channel type, label #2	20	string	Switch between fluorescence intensity and optical density measurement. Optical density calculation needs previously set up blank reference image (cell-free image) for the given channel number.
#2: Measure label #2 over	21	string	Intensity measurement is performed either over the nucleus or in a perinuclear ring or in the whole cell, marked by secondary segmentation of the cell area marker.
#2: Background subtraction method, label #2	22	string	Select background subtraction method: Percentile, Rolling ball, Spatial filtering, None. See settings below. Background subtraction is performed in the same way for all channels.
#2: Intensity measurement type of label #2	23	string	Available plot types: "Mean", "Sum", "Variance", "PDI variance", "PDI sd", "Line Scan". These statistics describe pixels within each segment.
#2: Perinuclear ring width (pixels), label #2	24	integer	Width of the ring around the nucleus to measure perinuclear area, in pixels. This is used only if "Perinuclear ring" is selected above.
#2: Histogram: range, label #2	25	string	If left empty or set to "All", a histogram is generated where the lowest bin starts at the smallest data point and the highest bin ends at the largest data point. If a range is given here e.g. 100-500, then the lowest bin starts at the beginning of the range and the highest bin ends at the end of the range.
#3: Channel Number, label #3	26	integer	Channel number of label #3 to be measured. Each channel can be selected multiple times for different measurements.
#3: Name for label #3	27	string	Custom name to be shown in image and plot window captions and in output data.
#3: Channel type, label #3	28	string	Switch between fluorescence intensity and optical density measurement. Optical density calculation needs previously set up blank reference image (cell-free image) for the given channel number.
#3: Measure label #3 over	29	string	Intensity measurement is performed either over the nucleus or in a perinuclear ring or in the whole cell, marked by secondary segmentation of the cell area marker.
#3: Background subtraction method, label #3	30	string	Select background subtraction method: Percentile, Rolling ball, Spatial filtering, None. See settings below. Background subtraction is performed in the same way for all channels.
#3: Intensity measurement type of label #3	31	string	Available plot types: "Mean", "Sum", "Variance", "PDI variance", "PDI sd", "Line Scan". These statistics describe pixels within each segment.
#3: Perinuclear ring width (pixels), label #3	32	integer	Width of the ring around the nucleus to measure perinuclear area, in pixels. This is used only if "Perinuclear ring" is selected above.
#3: Histogram: range, label #3	33	string	If left empty or set to "All", a histogram is generated where the lowest bin starts at the smallest data point and the highest bin ends at the largest data point. If a range is given here e.g. 100-500, then the lowest bin starts at the beginning of the range and the highest bin ends at the end of the range.
#4: Channel Number, label #4	34	integer	Channel number of label #4 to be measured. Each channel can be selected multiple times for different measurements.
#4: Name for label #4	35	string	Custom name to be shown in image and plot window captions and in output data.
#4: Channel type, label #4	36	string	Switch between fluorescence intensity and optical density measurement. Optical density calculation needs previously set up blank reference image (cell-free image) for the given channel number.
#4: Measure label #4 over	37	string	Intensity measurement is performed either over the nucleus or in a perinuclear ring or in the whole cell, marked by secondary segmentation of the cell area marker.
#4: Background subtraction method, label #4	38	string	Select background subtraction method: Percentile, Rolling ball, Spatial filtering, None. See settings below. Background subtraction is performed in the same way for all channels.
#4: Intensity measurement type of label #4	39	string	Available plot types: "Mean", "Sum", "Variance", "PDI variance", "PDI sd", "Line Scan". These statistics describe pixels within each segment.
#4: Perinuclear ring width (pixels), label #4	40	integer	Width of the ring around the nucleus to measure perinuclear area, in pixels. This is used only if "Perinuclear ring" is selected above.
#4: Histogram: range, label #4	41	string	If left empty or set to "All", a histogram is generated where the lowest bin starts at the smallest data point and the highest bin ends at the largest data point. If a range is given here e.g. 100-500, then the lowest bin starts at the beginning of the range and the highest bin ends at the end of the range.
Histogram: number of bins	42	integer	When the output is histogram, the histogram is calculated using this number of equal sized bins, where the lowest bin starts at the smallest data point and the highest bin ends at the largest data point. If explicit range definition is used below, the bins will bound the given range. Use zero bin size for automatic binning.
Positive control reference image operation for nuclei detection	43	string	The positive control is an image with many visible cells. Using a positive control avoids amplifying background noise in wells with little or no cells.
Suppress debris and outside of well areas	44	boolean	Brighter areas corresponding to the bottom of microplate outside the well area will be masked.
Debris masking: minimum diameter of continuous bright spot	45	real	Bright objects larger than this pixel value will be masked, and these areas not used for cell detection and measurements.
Debris and well edge detection sensitivity (%)	46	real	Percent of Otsu optimal threshold value. Lower is more sensitive.
Nuclei: Diameter (pixels, for seeding)	47	integer	Diameter of the nucleus in pixels. Nuclei ranging around this size will be selected.
Nuclei: Minimum area (pixels, for gating)	48	integer	Pixel area gate for detected nuclei, set 0 to disable.
Nuclei: Maximum area (pixels, for gating)	49	integer	Pixel area gate for detected nuclei, set 0 to disable.
Nuclei: Debris cutoff for nuclear stain (percentile)	50	real	This percentile of the image histogram sets the intensity value where the maximum of the Look Up Table (LUT) is scaled.
Nuclei: Clip bright nucleoli	51	boolean	Set Yes if only part nuclei are detected due to the presence of bright spots within nuclei.
Nuclei: Minimum fluorescence (%)	52	real	Nuclei must be brighter than this percent of the maximal scaling value, set by the "Debris cutoff" percentile value. Increase this value if debris dimmer than the cells is detected.
Nuclei: Shape factor (minimum; 0-1)	53	real	1 for disc, smaller for irregular shapes. 0 for not checking
Nuclei: Weld segments into round objects	54	boolean	Weld touching segments if they form a rounder object together. Use this to avoid objects fragmenting into multiple segments.
Nuclei: Discard segments at edges of the image	55	boolean	Any segment that has at least 10% of its boundary at the edge of the image will be discarded.
Background percentile	56	real	If background subtraction method is percentile, this percentile value will be used in all channels.
Local background: Rolling ball: median filter size	57	integer	Set this value larger than the object of interest in pixels, if using this type of background subtraction.
Local background: Spatial filtering: Number of tiles in x	58	integer	The image consists of this number of equal sized tiles in x dimension. Required if background subtraction is spatial filtering.
Local background: Spatial filtering: Number of tiles in y	59	integer	The image consists of this number of equal sized tiles in y dimension. Required if background subtraction is spatial filtering.
Local background: Spatial filtering: Largest object size (for background removal, pixels times number of tiles)	60	real	Objects larger than this will be removed as background by spatial filtering. The typical object pixel size must be multiplied by the number if tiles (in x or y). Cut on of the band pass Butterworth filter. .
Thin process suppression for optical density (maximal diameter in pixels)	61	real	For "Densitometry with thin process suppression" this value is the maximal process diameter, thinner details will be suppressed using spatial filtering.
Optical density and shading: optional dark current intensity value	62	real	Enter average pixel intensity measured in an unilluminated, dark image, if not using a dark current reference image when calculating optical density.
Reference image background: Select "Reference Image" or "Background and shading correction by Background Reference Image"	63	string	What kind of background to subtract. Calculated for each frame or for the whole image series.

Description:

Measurement of fluorescence intensities or optical densities over nuclei and perinuclear areas using a nuclear marker and 1-4 label channels. Standard morphological segmentation is used. The pipeline can run in single or tiled images and in whole wells with automatic suppression of outside of the well areas and debris (see “Suppress debris and outside of well areas”). Different measurements may be done in the same label channel, and each label can be defined as fluorescence or optical density (“Channel type”). The pipeline can also be executed on image series for faster analysis compared to frame-by-frame operation. Frames of an image series are scaled independently.
For the SA-bGAL assay use "Densitometry with thin process suppression" as channel type and set the sensitivity of this at "Thin process suppression for optical density (maximal diameter in pixels)". This value is the maximal process diameter, thinner details will be suppressed. Thus a larger value provides greater suppression. This is performed by bandpass spatial filtering between the “Local background: Spatial filtering: Largest object size…” cut on and "Thin process suppression for optical density (maximal diameter in pixels)" cut off. Use additional rolling ball background subtraction. Using additional spatial filtering background subtraction will not have much further effect.

Background subtraction:
The background subtraction technique can be specified for each channel. Choose percentile-based global or local background subtraction methods. All channels use the same method, and the parameters are at the end of the pipeline parameter list. For median or special filtering, the object size must be bigger than the cell size.
Tiled images: the background tiling pattern or vignetting is efficiently removed by spatial filtering if the recording was performed without overlap and image registration. Provide the number of tiles in x and y direction in the “Local background: Spatial filtering: Number of tiles in x” and “…y” parameters.

Sample: fixed or live cells stained for nuclei e.g. with Hoechst 33342 or DAPI, and showing other fluorescence of interest.

Input: 2-4 channels fluorescence image showing a nuclear marker and immuno- or other fluorescence visible over the nuclei or in perinuclear areas. Low or medium magnification 10-40x. May be tiled and whole well image. The area outside of the well must be bright in the fluorescence image for auto detection of the well. Whole slide scans are also workable using the Multi-Dimensional Open/Settings/Crop multi-resolution by ROIs, analyzing multiple regions/scenes loaded as an image series.

Output: 1 morphological parameters of choice of nuclei and 4 intensity or optical density measurements in the same or different label channels. For intensity measurement the “Intensity measurement type of label #” statistics (Mean, Sum, Variance, Punctate over diffuse ratio) is calculated over nuclei or perinuclear area see (“Measure label # fluorescence over” and “Perinuclear ring width”). Output data are single cell values or histogram (see “Histogram or distribution calculation”). Note that the order of labels measured in the output worksheet may vary due to parallel processing. When “Position names and microplate worksheet output” is Yes, labels will show up in renumbered channels as:
Ch0: Nuclei Morphology
Ch1: Label #1
Ch2: Label #2
Ch3: Label #3
Ch4: Label #4

Reference image operation: by default, the calculation of nuclei is self-referenced. Thus, it is independently calculated for each image. This is set by the “Positive control reference image operation for nuclei detection” = ”Self-referenced” option. This works well if none of the samples have very few cells compared to others. If cell density varies between samples, or if some samples have very few cells , use positive control reference. The positive control is one of the images from the data set with about maximum number of cells and positive cells. To make reference image set “Positive control reference image operation for nuclei detection” = ”Make reference image”. Process a positive control sample. The reference images will be minimized, and reused at the following operations. Then set “Positive control reference image operation for nuclei detection” = ”Use reference image” and process all data. To process a different data set, close first reference images by “File/Close All Reference Images” and make new reference images.

Debris avoidance: to increase sensitivity, increase “Large debris removal sensitivity (%)” and decrease “Large debris minimum size (length in pixels)”. To decrease sensitivity, do the opposite. Debris avoidance may avoid cells or positive cells, if the cell count or positive cell count is too low. In this case set a small (non-zero) %, e.g. 1 as sensitivity.

Adding more processing, image filtering to labels: Open pipeline window, unlock editing and insert image processing function in between the "Add extra processing below" and "Add extra processing above" placeholders. For this pick the function to be added by pressing the F icon in the toolbar of the Pipeline window. Place this function in an empty space, and then drag it and drop it on the "Add extra processing below" label. Add more processing, or reconnect the "Add extra processing above" label by dropping it on the last added function.

Adjustments:
Set approximate nucleus diameter. To this end load an image, zoom in using the magnifier glass Main Toolbar button, and then using the linear ROI button draw a line across a nucleus. Double-click the status bar of the Image Window to see the length of the ROI (Size of active ROI).
The approximate nucleus diameter is used only for seeding the detection, and there are explicit minimum and maximum area gates for finer control.
Run the pipeline on a single well and observe the results. In the overlay Image Window the gray fluorescence image should be well matched by the colored segments:
*If single nuclei are detected as multiple segments, increase the approximate cell diameter. In addition, you may turn segment welding on.
*If multiple nuclei are detected as single segments, decrease the approximate cell diameter. In addition, you may turn segment welding off.
*If debris is detected a nuclei, increase background cutoff or minimum cell fluorescence.
*If dimmer cells are missed, decrease background cutoff or minimum cell fluorescence.
*If bright debris outshines cells, decrease debris cutoff percentile.
If segmentation goes as it is desired, process the whole microplate using the double blue arrowhead button and ‘Run Pipeline … on All Stage Positions’.

Version history
V1: based on “Microplate whole well cell count (automatic well positioning, with positive control)” and “Seahorse well cell count with nuclear stain”.
V3: Added control on how Excel Data is recorded
Debris avoidance also removes zero edges resulting from stitching
Position names are shown on labels
Reference image background subtraction and shading correction
Optional clipping of bright foci during segmentation
Accidental loopback after background subtraction in label#3 removed
Explicit gating for nuclei area
New "Densitometry with thin process suppression" option for channel type and "Thin process suppression for optical density (maximal diameter in pixels)" for setting its sensitivity
Added "Add extra processing below" and "Add extra processing above" placeholders
Added Histogram Range parameters for each label
V4: ROIs are copied from original images, so ROIs may be drawn on the source images to gate the readout.
Each label can be named now.
V5: Fixed error in "Use reference image" operation for nucleus segmentation