/// <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));
}
}
