Core Optical, Inc.
Utilities NormalizeDataToSum Method Industrial Strength, Scientific Grade
Normalizes the values in the specified data channel so that their sum equals 1.0.

Namespace: PrecisionImage
Assembly: PrecisionImage (in PrecisionImage.dll) Version: (

public static void NormalizeDataToSum(
	SourceData sourceData,
	int channel,
	SourceData targetData,
	int targetChannel,
	Int32Rect regionOfInterest = null,
	BinaryMask binaryMask = null


Type: PrecisionImage SourceData
A SourceData object containing the data to operate on.
Type: OnlineSystem Int32
An OnlineInt32 type indicating the channel to operate on.
Type: PrecisionImage SourceData
A SourceData object to which the data is stored. Can be the same object as sourceData.
Type: OnlineSystem Int32
An OnlineInt32 type indicating the data channel to copy to. Can be the same as channel.
regionOfInterest (Optional)
Type: OnlineSystem.Windows Int32Rect
An OnlineInt32Rect type indicating the region of interest. Coordinates are zero-index based. This parameter is optional and defaults to the entire image.
binaryMask (Optional)
Type: PrecisionImage.BinarizationAndMorphology BinaryMask
A BinaryMask object indicating areas to bypass. Default is no mask.

OnlineSystem ArgumentNullException Thrown when sourceData or targetData are null.
OnlineSystem ArgumentOutOfRangeException Thrown when channel or targetChannel specify channels that do not exist.
OnlineSystem ArgumentException Thrown when sourceData and targetData do not have the same dimensions.
OnlineSystem ArgumentException Thrown when the dimensions of binaryMask do not match those of sourceData and targetData.
OnlineSystem ArgumentOutOfRangeException Thrown when regionOfInterest specifies a region not completely contained within the input data.

Use this method to normalize the values in the SourceData object such that their sum equals 1.0.

See Also