| MIL 10 Reference
| Customize Help
| Save Settings

MpatSetCertainty


See also
Availability
Not available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
None.
MpatSetCenter
MpatSetDontCare
Synopsis
Set the certainty level of a model.
Syntax
void MpatSetCertainty(
MIL_ID ModelId, //in
MIL_DOUBLE CertaintyThreshold //in
)
Description

This function sets the certainty level for a match made with the specified model when it is sought in an image. If the correlation (match score) between the image and the model is greater than or equal to the certainty level, a match is assumed without looking elsewhere in the image for a better match. The default certainty level is set when the model is allocated (MpatAlloc...()).

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
ModelId

Specifies the identifier of the model for which to change the certainty threshold search parameter.

CertaintyThreshold INQ

Specifies the certainty level, as a percentage. If you set the certainty level too high (close to 100%), you slow down the search because you force the search algorithm to check the whole search region for the best match. A good certainty level is slightly lower than the expected score, so that the search can finish as soon as the match is found. However, if you set the certainty level too low, false matches might be found. Note that the certainty level must be greater than or equal to the acceptance level (MpatSetAcceptance()).

The default value is 80.0%.

Compilation information
Header Include mil.h.
Library Use mil.lib; milpat.lib.
DLL Requires mil.dll; milpat.dll.