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
SyntaxProperty MatchLength As Integer
Get
Set
Property Value
Type:
Int32
RemarksFindEdges 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