Click or drag to resize

IMcProfileEdgesMatchLength Property

The number of profile samples over which averaging or pattern matching is performed.

Namespace:  MediaCy.IQL.Features
Assembly:  MediaCy.IQL.Features (in MediaCy.IQL.Features.dll) Version: 10.0.6912.0
Syntax
VB
Property MatchLength As Integer
	Get
	Set

Property Value

Type: Int32
Remarks
FindEdges performs its weighting analysis by averaging MatchLength profiles values, scaled by the Weights array (for the EdgeFindingMethod values mcpefmPeaks, mcpefmValleys, mcpefmRisingEdges and mcpefmFallingEdges), or by covarying MatchLength profiles values against the Pattern array (for the mcpefmMatchPattern EdgeFindingMethod). This is performed for each position along the profile. Since each value of the weighted profile involves analysis of MatchLength profiles values, the first fully covered weighted value starts MatchLength samples from the start of the profile and the last weighted value ends MatchLength samples from the end. Assuming the MatchHotspot is at the default middle postion, then the first and last edges that could be found would be at MatchLength/2 samples from the ends of the profile. The WeightingFlags reflects one of two methods that are used to allow edges to be found up to the ends of the profile. One method assumes that the profile is that of a closed polygon boundary. This approach (WeightingFlags mcpewfWrapAtEnds will be set) is turned on when the ProfilesAncestor is a descendent of an McRegions object. The other end-handling method is reflection (WeightingFlags mcpewfReflectAtEnds); this method builds the weighted profile assuming that the profile continues beyond its start or end as it did before (i.e., is reflected). Irrespective of the end-handling method, no edges will be found on profiles that have fewer samples than the MatchLength. If the Weights or Pattern array is longer or shorter than MatchLength, then the array is scaled to map onto MatchLength. However, when you assign to the Pattern property, the MatchLength property is automatically set to the length of the assigned array. If you subsequently change the MatchLength, then the Pattern property array is automatically mapped onto the new MatchLength. Assigning to the Weights array does NOT change the MatchLength. By default, the MatchLength is 5 samples. On assignment, it must be at least 2 if EdgeFindingMethod is mcpefmMatchPattern and at least 1 otherwise.
See Also