dt_fp_similarity

Daylight v4.90
Release Date: 13 Oct 2004

Name

dt_fp_similarity - compute the similarity coefficient of two fingerprints

Generic Prototype

dt_fp_similarity(dt_Handle, dt_Handle, dt_String) => dt_Real

C Prototype

#include "dt_finger.h"

dt_Real dt_fp_similarity(dt_Handle fp1, dt_Handle fp2, dt_Integer expr_len, dt_String expression)

FORTRAN Prototype

include 'dt_f_finger.inc'

real*4 dt_f_fp_similarity(fp1, fp2, expression)

integer*4 fp1
integer*4 fp2
character*() expression

Description

Calculates the similarity coefficient between the fingerprints. The calculation is not performed if the fingerprints are not compatible (different sizes) or if the objects are not fingerprints.

The expression can either be one of a list of built-in expressions or may be an arithmatic expression in terms of:

a - count of bits on in fp1, not on in fp2
b - count of bits on in fp2, not on in fp1
c - count of bits on in both fp1 and fp2
d - count of bits off in both fp1 and fp2

See the Daylight Theory Manual, the chapter on Fingerprints, for an explanation of the Similarity coefficient and expressions and see the expression(5) manpage for documentation of the expression syntax.

Return Value

Returns the similarity coefficient between two fingerprints. The similarity coefficient between all other incompatible objects is defined as -1.0.