RegionsOperatorsmRgnHeterogeneity Method

Parameters

regions

Type: MediaCy.IQL.FeaturesMcRegions

Return Value

Type: McMeasure

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type McRegions. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Heterogeonous pixels are those that vary by more than the McHeterogeneity.IntensityRange property percent (of the full intensity) from the average intensity for the region (mRgnDensity). The measurement was originally described by Young IT, Verbeek PW, and Mayall BH, Characterization of chromatin distribution in cell nuclei. Cytometry, 1986. 7: p. 467-474. The IntensityRange parameter can be set either by assigning to mRgnHeterogeneity.IntensityRange or by calling mRgnHeterogeneity.SetParameter(0, NewIntensityRange). The default IntensityRange is 10%. By default the test for heterogeneous pixels is bipolar, including pixels that are both sufficiently darker than the mean as well as those sufficiently brighter. A second parameter takes a Bipolar enumeration 0=Both, 1=BrightOnly, 2=DarkOnly. This parameter is set by calling mRgnHeterogeneity.SetParameter(1, NewBipolarEnum). By default the Bipolar parameter is 0 ("Both"). Givnen the measured image's McImage.RangeMax and RangeMin, the computation is done as follows: LuminanceRange = (RangeMax - RangeMin) * IntensityRange / 100 Bright hetrodox pixels are those more intense than mRgnDensity+LuminanceRange, while dark hetrodox pixels are those less intense than mRgnDensity-LuminanceRange. If Bipolar is not DarkOnly, bright hetrodox pixels are added to the count (and marked in the mRgnClumpiness pre-erosion map). Similarly, if Bipolar is not BrightOnly, dark hetrodox pixels are added. Of course if Bipolar is Both (the default), then both bright and dark hetrodox pixels are counted and marked. The IntensityRange parameter is allowed to be negative, which may be useful in cases where the Bipolar parameter is either DarkOnly or BrightOnly. For example, if the Bipolar parameter is BrightOnly and IntensityRange is minus 10, then mRgnHeterogeneity would give the fraction of pixels within each sub-region that are brighter than the mean intensity for that region minus 10% of the full luminance range. You might or might not find a negative IntensityRange with either Bipolar BrightOnly or DarkOnly to be useful for your mRgnHeterogeneity measurements, but this sort of arrangement can be quite useful for mRgnClumpiness where it allows you to have more control over the pixels included in the "hetrodox" mask before the erosion is applied (see mRgnClumpiness for more discussion). This is a pixel-based measurement. So for regions created by the McThreshold.Execute method or McFeatures.SetFromMask method (features of Type mcftScanList), holes in the blob are significant.