SourceAFIS
HomeDownloadJavadoc.NET ReferenceForum
com.machinezoo.sourceafis

Class FingerprintMatcher

SourceAFIS » API Reference

    • Constructor Detail

      • FingerprintMatcher

        public FingerprintMatcher(FingerprintTemplate probe)
        Create FingerprintMatcher from probe fingerprint template. Constructed FingerprintMatcher is heavy in terms of RAM footprint and CPU consumed to create it. It should be reused for multiple match(FingerprintTemplate) calls in 1:N matching.
        Parameters:
        probe - fingerprint template to be matched to candidate fingerprints
        See Also:
        match(FingerprintTemplate)
    • Method Detail

      • match

        public double match(FingerprintTemplate candidate)
        Match candidate fingerprint template to this probe fingerprint and calculate similarity score. Candidate fingerprint is matched to probe fingerprint previously passed to FingerprintMatcher(FingerprintTemplate).
        Returned similarity score is a non-negative number that increases with similarity between probe and candidate fingerprints. Application should compare the score to a threshold with expression (score >= threshold) to arrive at boolean match/non-match decision. Threshold 10 corresponds to FMR (false match rate) of 10%, threshold 20 to FMR 1%, threshold 30 to FMR 0.1%, and so on.
        Recommended threshold is 40, which corresponds to FMR 0.01%. Correspondence between threshold and FMR is approximate and varies with quality of fingerprints being matched. Increasing threshold rapidly reduces FMR, but it also slowly increases FNMR (false non-match rate). Threshold must be tailored to the needs of the application.
        This method is thread-safe. Multiple threads can match candidates against single FingerprintMatcher.
        Parameters:
        candidate - fingerprint template to be matched with probe fingerprint represented by this FingerprintMatcher
        Returns:
        similarity score between probe and candidate fingerprints