/// <summary> /// Compute similarity score between two <see cref="Person"/>s. /// </summary> /// <param name="probe">First of the two persons to compare.</param> /// <param name="candidate">Second of the two persons to compare.</param> /// <returns>Similarity score indicating similarity between the two persons or 0 if there is no match.</returns> /// <remarks> /// <para> /// <see cref="Verify"/> method compares two <see cref="Person"/>s, <see cref="Fingerprint"/> by <see cref="Fingerprint"/>, and returns /// floating-point similarity score that indicates degree of similarity between /// the two <see cref="Person"/>s. If this score falls below <see cref="Threshold"/>, <see cref="Verify"/> method returns zero. /// </para> /// <para> /// <see cref="Person"/>s passed to this method must have valid <see cref="Fingerprint.Template"/> /// for every <see cref="Fingerprint"/>, i.e. they must have passed through <see cref="Extract"/> method. /// </para> /// </remarks> /// <seealso cref="Threshold"/> /// <seealso cref="MinMatches"/> /// <seealso cref="Identify"/> public float Verify(Person probe, Person candidate) { lock (this) { probe.CheckForNulls(); candidate.CheckForNulls(); BestMatchSkipper collector = new BestMatchSkipper(1, MinMatches - 1); Parallel.ForEach(probe.Fingerprints, probeFp => { var candidateTemplates = (from candidateFp in candidate.Fingerprints where IsCompatibleFinger(probeFp.Finger, candidateFp.Finger) select candidateFp.Decoded).ToList(); ParallelMatcher.PreparedProbe probeIndex = Matcher.Prepare(probeFp.Decoded); float[] scores = Matcher.Match(probeIndex, candidateTemplates); lock (collector) foreach (float score in scores) { collector.AddScore(0, score); } }); return(ApplyThreshold(collector.GetSkipScore(0))); } }
/// <summary> /// Compute similarity score between two <see cref="Person"/>s. /// </summary> /// <param name="probe">First of the two persons to compare.</param> /// <param name="candidate">Second of the two persons to compare.</param> /// <returns>Similarity score indicating similarity between the two persons or 0 if there is no match.</returns> /// <remarks> /// <para> /// <see cref="Verify"/> method compares two <see cref="Person"/>s, <see cref="Fingerprint"/> by <see cref="Fingerprint"/>, and returns /// floating-point similarity score that indicates degree of similarity between /// the two <see cref="Person"/>s. If this score falls below <see cref="Threshold"/>, <see cref="Verify"/> method returns zero. /// </para> /// <para> /// <see cref="Person"/>s passed to this method must have valid <see cref="Fingerprint.Template"/> /// for every <see cref="Fingerprint"/>, i.e. they must have passed through <see cref="Extract"/> method. /// </para> /// </remarks> /// <seealso cref="Threshold"/> /// <seealso cref="MinMatches"/> /// <seealso cref="Identify"/> public float Verify(Person probe, Person candidate) { lock (this) { probe.CheckForNulls(); candidate.CheckForNulls(); BestMatchSkipper collector = new BestMatchSkipper(1, MinMatches - 1); Parallel.ForEach(probe.Fingerprints, probeFp => { var candidateTemplates = (from candidateFp in candidate.Fingerprints where IsCompatibleFinger(probeFp.Finger, candidateFp.Finger) select candidateFp.Decoded).ToList(); ParallelMatcher.PreparedProbe probeIndex = Matcher.Prepare(probeFp.Decoded); float[] scores = Matcher.Match(probeIndex, candidateTemplates); lock (collector) foreach (float score in scores) collector.AddScore(0, score); }); return ApplyThreshold(collector.GetSkipScore(0)); } }