Normalise intensity

Sets the intensity to maximise the dynamic range of the image.

Description

Sets the intensity to maximise the dynamic range of the image. "Clipping fraction" is the fraction of pixels at either end of the range that gets clipped.The "Per object" region mode will normalise all pixels within each object.

Note: This module will change pixel intensities. To set the display range without altering pixel intensities, use the "Set intensity display range" module

Parameters

Parameter Description
Input image Image from the workspace for which intensity normalisation will be calculated.
Apply to input image Select if the normalisation should be applied directly to the input image, or if it should be applied to a duplicate image, then stored as a different image in the workspace.
Output image If storing the processed image separately in the workspace, this is the name of the output image.
Region mode Controls whether the intensities are normalised across the entire image stack ("Entire image"), across the image slice-by-slice ("Per slice") or separately within each object ("Per slice")
Input objects If normalising intensities on an object-by-object basis ("Region mode" set to "Per object"), these are the objects that will be used.
Calculation mode Controls how the normalisation is calculated. In each case, the minimum and maximum intensities are calculated and all values in the output image linearly interpolated between them:
  • "Fast" All intensity values in the image are collected in a histogram. As such, for 8 and 16-bit this is fast to calculate as there are a limited number of bins. In this instance, the clip fraction corresponds to the fraction of bins.
  • "Manual" The minimum and maximum intensities in the final image are manually specified with the "Minimum range value" and "Maximum range value" parameters.
  • "Precise" All intensity values are ordered by their intensity and the clip fraction corresponds to the fraction of pixels (rather than the fraction of unique intensities as with "Fast" mode. As such, this method is more precise; however, can take a much longer time (especially for large images).
Calculation source When applying a single normalisation to the entire image ("Region mode" set to "Entire image"), this parameter controls whether the normalisation range (min, max) will be determined from the input image or another image:
  • "External" The image for which the normalisation range is calculated is different to the image that the final normalisation will be applied to. For example, this could be a single representative slice or substack. Using this could significantly reduce run-time for large stacks, especially when "Calculation mode" is set to "Precise".
  • "Internal" The normalisation range will be determined from the same image or stack onto which the normalisation will be applied.
External source If using a separate image to determine the normalisation range ("Calculation source" set to "External"), this is the image that will be used for that calculation.
Clipping fraction (min) Fraction of unique intensities ("Precise") or pixels ("Fast") that are clipped when setting the minimum intensity. Any values below this will be set to the calculated minimum intensity.
Clipping fraction (max) Fraction of unique intensities ("Precise") or pixels ("Fast") that are clipped when setting the maximum intensity. Any values above this will be set to the calculated maximum intensity.
Minimum range value If manually setting the minimum intensity, this is the value that will be applied.
Maximum range value If manually setting the maximum intensity, this is the value that will be applied.