OEFPDatabaseOptions

class OEFPDatabaseOptions

This class is used to control the behavior of:

It allows setting options on a per-search basis.

The OEFPDatabaseOptions class stores the following properties:

Property Get method Set method Corresponding namespace / type
cutoff value GetCutoff SetCutoff / HasCutoff floating point number
order of sorting GetDescendingOrder SetDescendingOrder boolean
max number of scores GetLimit SetLimit integer 0 means no limit
similarity method GetSimFunc SetSimFunc OESimMeasure
\(\alpha\) and \(\beta\) for Tversky GetTverskyAlpha / GetTverskyBeta SetTverskyCoeffs floating point number

Constructors

OEFPDatabaseOptions()

Default constructor.

Default parameters of OEFPDatabaseOptions
Property Default value
cutoff value no cutoff set
order of sorting true (means descending order)
max number of scores 0 (means no limit)
similarity method OETanimotoSim
\(\alpha\) and \(\beta\) for Tversky \(\alpha = 0.95, \beta = 0.05\)
OEFPDatabaseOptions(unsigned int limit,
                    unsigned int simfunc=OESimMeasure::Tanimoto)

Constructs an OEFPDatabaseOptions object with a limit on the number of similarity scores returned and a similarity method from the OESimMeasure namespace. The returned scores will be in descending order and applying no cutoff value.

OEFPDatabaseOptions(const OEFPDatabaseOptions &rhs)

Copy constructors.

operator=

OEFPDatabaseOptions &operator=(const OEFPDatabaseOptions &rhs)

Assignment operator.

ClearCutoff

void ClearCutoff()

Removes the cutoff value previously set by the OEFPDatabaseOptions::SetCutoff method. After clearing the cutoff value, OEFPDatabaseOptions::HasCutoff method will return false.

GetCutoff

float GetCutoff() const

Returns the cutoff value previously set by the OEFPDatabase::SetCutoff method.

GetDescendingOrder

bool GetDescendingOrder() const

Returns whether the similarity scores will be returned in descending or in ascending order.

GetLimit

unsigned int GetLimit() const

Returns the maximum number of similarity scores returned.

GetSimFunc

unsigned int GetSimFunc() const

Returns the similarity measure used to evaluate fingerprint similarities. The return value is taken from the OESimMeasure namespace.

GetTverskyAlpha

float GetTverskyAlpha() const

Returns the \(\alpha\) parameter of the Tversky similarity.

GetTverskyBeta

float GetTverskyBeta() const

Returns the \(\beta\) parameter of the Tversky similarity.

HasCutoff

bool HasCutoff() const

Returns whether the cutoff value of the OEFPDatabaseOptions object has been set by the OEFPDatabaseOptions::SetCutoff method.

SetCutoff

void SetCutoff(float cutoff)

Sets the cutoff value of the OEFPDatabaseOptions object.

SetDescendingOrder

void SetDescendingOrder(bool descending=true)

Sets whether the similarity scores will be returned in descending or in ascending order.

Note

This method has no effect on the OEFPDatabase::GetScores method.

SetLimit

void SetLimit(unsigned int limit)

Sets the maximum number of similarity scores returned.

limit
If it is set to zero, then all similarity scores are returned.

Note

This method has no effect on the OEFPDatabase::GetScores method.

SetSimFunc

void SetSimFunc(unsigned int simtype)

Sets the similarity measure used to evaluate fingerprint similarities.

simtype
This value has to be from the OESimMeasure namespace.

SetTverskyCoeffs

void SetTverskyCoeffs(float alpha=0.95f, float beta=0.05f)

Sets \(\alpha\) and \(\beta\) parameters for the Tversky similarity.