NormalizeImage


Rescales an image linearly, so that its minimum becomes inNewMinimum and the maximum of the remaining pixels becomes inNewMaximum.

Applications:Aims at better using the image's dynamic range to represent an interesting subset of pixel values.

Syntax

C++
Python
 
def NormalizeImage(
	inImage: Image,
	outImage: Image,
	/,
	*,
	inRoi: Region | None = None,
	inNewMinimum: float = 0.0,
	inNewMaximum: float = 255.0,
	inSaturateBrightestFraction: float = 0.0,
	inSaturateDarkestFraction: float = 0.0,
	inMinValue: float | None = None,
	inMaxValue: float | None = None,
	diagLinearNormalizedRegion: Region | None = None
)
-> (
	outA: float,
	outB: float
)

Parameters

Name Type Range Default Description
Input value inImage Image Input image
Input value inRoi Region | None None Range of pixels to be processed
Input value inNewMinimum float 0.0 Desired minimum value of the resulting image
Input value inNewMaximum float 255.0 Desired maximum value of the resulting image
Input value inSaturateBrightestFraction float 0.0 - 1.0 0.0 Fraction of the brightest pixels skipped during normalization
Input value inSaturateDarkestFraction float 0.0 - 1.0 0.0 Fraction of the darkest pixels skipped during normalization
Input value inMinValue float | None None Pixels darker than that value will be skipped during normalization
Input value inMaxValue float | None None Pixels brighter than that value will be skipped during normalization
Output value outImage Image Rescaled image
Output value outA float Multiplicative parameter of the applied linear transformation of pixel values
Output value outB float Additive parameter of the applied linear transformation of pixel values
Diagnostic input diagLinearNormalizedRegion Region | None None Region of image that has been linearly normalized