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: 2.0.0.0 (2.0.0.0)
Syntax

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

Parameters

sourceData
Type: PrecisionImage SourceData
A SourceData object containing the data to operate on.
channel
Type: OnlineSystem Int32
An OnlineInt32 type indicating the channel to operate on.
targetData
Type: PrecisionImage SourceData
A SourceData object to which the data is stored. Can be the same object as sourceData.
targetChannel
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.
Exceptions

ExceptionCondition
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.
Remarks

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

See Also