IMcProfileEdgesAbsoluteMaxWeightValue Property

Property Value

Type: Double

For any given set of weighting properties and the ancestor McImage.RangeMin and McImage.RangeMax limits over which the ProfilesAncestor.ProfileValues will range, there is a theoretical maximum to any WeightedProfiles value. The AbsoluteMaxWeightValue property exposes this maximum value. When the mcpeofAbsoluteThresholding OptionFlags bit is off, as it is by default, then the AbsoluteMaxWeightValue doesn't matter much, because edge detection is based on finding local maxima in the WeightedProfile relative to peaks along the WeightedProfile. That is, the assumption is that there is very likely to be at least one "edge" along the profile. If the MinEdgesPerProfile is zero, then very weak weighted profiles (ones where the peak weighted value is very far from the AbsoluteMaxWeightValue) will yield no edges, but the ThresholdForEdge is a percentage of the peak weighted values found on the profile. When the mcpeofAbsoluteThresholding OptionFlags bit is on, then the AbsoluteMaxWeightValue is critical, because here the ThresholdForEdge property represents an absolute percentage of the AbsoluteMaxWeightValue. To mark an edge, the weighted profile (available from the WeightedProfiles property) must transition to above threshold and then transition again to below threshold. Appropriate values for the ThresholdForEdge property can be very low (that is interesting "edges" often result in a weighted profile peak that is a small percentage of the AbsoluteMaxWeightValue). The AbsoluteMaxWeightValue is automatically recomputed whenever one of the weighting properties (EdgeFindingMethod, Weights or Pattern, MatchLength, SizeWeighting and WeightingFlags) is changed. But AbsoluteMaxWeightValue is also assignable. You would assign to the AbsoluteMaxWeightValue property only if you were going to assign your own WeightedProfiles and the current weighting properties are not correct for your assigned values. Any assignment to AbsoluteMaxWeightValue should be made just before the assignment to WeightedProfiles.