FingerMatcher.compareTemplateRecords Method

Module: FingerMatcher

Definition

Compares two template records and outputs a score.

The score is normalized to take into account the number of fingers/views inside each record

compare_template_records(self, reference_record: FingerTemplateRecord, probe_record: FingerTemplateRecord, trust_filled_positions: bool) -> int

Parameters

reference_record FingerTemplateRecord
in Reference template record.

in Probe template record.

trust_filled_positions bool
in If True, template(s) of one position in reference will be compared only to the templates of the same position in probe. If False, all templates in reference will be compared to all templates in probe (this method is also known as ‘flat’ comparison).

Returns

int
Comparison score, in the range 0 to 65535.
See FingerMatcherThreshold to set a threshold to take a match/no-match decision.

Exceptions

An error has occurred during Finger Library execution.
int compareTemplateRecords(FingerTemplateRecord referenceRecord, FingerTemplateRecord probeRecord, bool trustFilledPositions)

Parameters

referenceRecord FingerTemplateRecord
in Reference template record.

in Probe template record.

trustFilledPositions bool
in If True, template(s) of one position in reference will be compared only to the templates of the same position in probe. If False, all templates in reference will be compared to all templates in probe (this method is also known as ‘flat’ comparison).

Returns

int
Comparison score, in the range 0 to 65535.
See FingerMatcherThreshold to set a threshold to take a match/no-match decision.

Exceptions

An error has occurred during Finger Library execution.
public int CompareTemplateRecords(FingerTemplateRecord referenceRecord, FingerTemplateRecord probeRecord, bool trustFilledPositions)

Parameters

referenceRecord FingerTemplateRecord
in Reference template record.

in Probe template record.

trustFilledPositions bool
in If True, template(s) of one position in reference will be compared only to the templates of the same position in probe. If False, all templates in reference will be compared to all templates in probe (this method is also known as ‘flat’ comparison).

Returns

int
Comparison score, in the range 0 to 65535.
See FingerMatcherThreshold to set a threshold to take a match/no-match decision.

Exceptions

An error has occurred during Finger Library execution.
public int compareTemplateRecords(FingerTemplateRecord referenceRecord, FingerTemplateRecord probeRecord, boolean trustFilledPositions) throws FingerException

Parameters

referenceRecord FingerTemplateRecord
in Reference template record.

in Probe template record.

trustFilledPositions boolean
in If True, template(s) of one position in reference will be compared only to the templates of the same position in probe. If False, all templates in reference will be compared to all templates in probe (this method is also known as ‘flat’ comparison).

Returns

int
Comparison score, in the range 0 to 65535.
See FingerMatcherThreshold to set a threshold to take a match/no-match decision.

Exceptions

An error has occurred during Finger Library execution.
public func compareTemplateRecords(referenceRecord: FingerTemplateRecord, probeRecord: FingerTemplateRecord, trustFilledPositions: Bool) throws -> Int32

Parameters

referenceRecord FingerTemplateRecord
in Reference template record.

in Probe template record.

trustFilledPositions Bool
in If True, template(s) of one position in reference will be compared only to the templates of the same position in probe. If False, all templates in reference will be compared to all templates in probe (this method is also known as ‘flat’ comparison).

Returns

Int
Comparison score, in the range 0 to 65535.
See FingerMatcherThreshold to set a threshold to take a match/no-match decision.

Exceptions

An error has occurred during Finger Library execution.
int id3FingerMatcher_CompareTemplateRecords (
    ID3_FINGER_MATCHER hFingerMatcher,
    ID3_FINGER_TEMPLATE_RECORD hReferenceRecord,
    ID3_FINGER_TEMPLATE_RECORD hProbeRecord,
    bool trustFilledPositions,
    int * score)

Parameters

hFingerMatcher ID3_FINGER_MATCHER
in Handle to the FingerMatcher object.

in Reference template record.

in Probe template record.

trustFilledPositions bool
in If True, template(s) of one position in reference will be compared only to the templates of the same position in probe. If False, all templates in reference will be compared to all templates in probe (this method is also known as ‘flat’ comparison).

score int *
out Comparison score, in the range 0 to 65535.

Returns

int
An error code.
See id3FingerError file for the list of possible error codes.