com.chemaxon.descriptors.fingerprints.pf2d

Class PfComparatorImpl

java.lang.Object

com.chemaxon.descriptors.fingerprints.pf2d.PfComparatorImpl

All Implemented Interfaces:

DescriptorComparator<FloatVectorDescriptor>, Guarded, PfComparator, Serializable

public class PfComparatorImpl
extends Object
implements PfComparator

PfComparator implementation.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.chemaxon.descriptors.common.Guarded

Guarded.EnsureThat, Guarded.New

Constructor Summary

Constructors

Constructor and Description
PfComparatorImpl()

Method Summary

Modifier and Type	Method and Description
double	calculateDissimilarity(byte[] target, byte[] query) Compare two descriptors in serialized form.
double	calculateDissimilarity(FloatVectorDescriptor target, FloatVectorDescriptor query) Compare two descriptors.
double	calculateSimilarity(byte[] target, byte[] query) Compare two descriptors in serialized form.
double	calculateSimilarity(FloatVectorDescriptor target, FloatVectorDescriptor query) Compare two descriptors.
ComparisonResult	compare(byte[] target, byte[] query) Compare two descriptors in serialized form.
ComparisonResult	compare(FloatVectorDescriptor target, FloatVectorDescriptor query) Compare two descriptors.
Object	getGuardObject() Gets the guard object associated to the generated descriptors/utilities.
Optional<Double>	getLowerBound() Get lower bound for the similarity/dissimilarity values if such one can be determined.
MetricMetadata	getMetricMetadata() Metadata about this metric.
Optional<Double>	getUpperBound() Get upper bound for the similarity/dissimilarity values if such one can be determined.
UnguardedContext<FloatVectorDescriptor,?>	unguardedContext() Associated unguarded context.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PfComparatorImpl

public PfComparatorImpl()

Method Detail

compare

public ComparisonResult compare(FloatVectorDescriptor target,
                                FloatVectorDescriptor query)

Description copied from interface: DescriptorComparator

Compare two descriptors.

Please note that some implementation might return a result object containing additional data related to the compariosn results.

Specified by:

compare in interface DescriptorComparator<FloatVectorDescriptor>

Parameters:

target - Target descriptor

query - Query descriptor

Returns:

Comparison result wrapper

compare

public ComparisonResult compare(byte[] target,
                                byte[] query)

Description copied from interface: DescriptorComparator

Compare two descriptors in serialized form.

Please note that some implementation might return a result object containing additional data related to the compariosn results. This method's functionality is equivalent to comparing (with DescriptorComparator.compare(com.chemaxon.descriptors.common.Descriptor, com.chemaxon.descriptors.common.Descriptor)) deserialized (by DescriptorSerializer.fromByteArray(byte[])) descriptors.

Specified by:

compare in interface DescriptorComparator<FloatVectorDescriptor>

Parameters:

target - Target descriptor in its serialized form

query - Query descriptor in its serialized form

Returns:

Comparison result wrapper

calculateSimilarity

public double calculateSimilarity(FloatVectorDescriptor target,
                                  FloatVectorDescriptor query)

Description copied from interface: DescriptorComparator

Compare two descriptors.

Please note that this convenience method wraps ComparisonResult.getSimilarity() of comparison result constructed by DescriptorComparator.compare(com.chemaxon.descriptors.common.Descriptor, com.chemaxon.descriptors.common.Descriptor)

Specified by:

calculateSimilarity in interface DescriptorComparator<FloatVectorDescriptor>

Parameters:

target - Target descriptor

query - Query descriptor

Returns:

Similarity result

calculateDissimilarity

public double calculateDissimilarity(FloatVectorDescriptor target,
                                     FloatVectorDescriptor query)

Description copied from interface: DescriptorComparator

Compare two descriptors.

Please note that this convenience method wraps ComparisonResult.getDissimilarity() of comparison result constructed by DescriptorComparator.compare(com.chemaxon.descriptors.common.Descriptor, com.chemaxon.descriptors.common.Descriptor)

Specified by:

calculateDissimilarity in interface DescriptorComparator<FloatVectorDescriptor>

Parameters:

target - Target descriptor

query - Query descriptor

Returns:

Dissimilarity result

calculateSimilarity

public double calculateSimilarity(byte[] target,
                                  byte[] query)

Description copied from interface: DescriptorComparator

Compare two descriptors in serialized form.

Specified by:

calculateSimilarity in interface DescriptorComparator<FloatVectorDescriptor>

Parameters:

target - Target descriptor in its serialized form

query - Query descriptor in its serialized form

Returns:

Similarity result

calculateDissimilarity

public double calculateDissimilarity(byte[] target,
                                     byte[] query)

Description copied from interface: DescriptorComparator

Compare two descriptors in serialized form.

Specified by:

calculateDissimilarity in interface DescriptorComparator<FloatVectorDescriptor>

Parameters:

target - Target descriptor in its serialized form

query - Query descriptor in its serialized form

Returns:

Dissimilarity result

getLowerBound

public Optional<Double> getLowerBound()

Description copied from interface: DescriptorComparator

Get lower bound for the similarity/dissimilarity values if such one can be determined.

Specified by:

getLowerBound in interface DescriptorComparator<FloatVectorDescriptor>

Returns:

Lower bond if exists; otherwise absent

getUpperBound

public Optional<Double> getUpperBound()

Description copied from interface: DescriptorComparator

Get upper bound for the similarity/dissimilarity values if such one can be determined.

Specified by:

getUpperBound in interface DescriptorComparator<FloatVectorDescriptor>

Returns:

Upper bond if exists; otherwise absent

getMetricMetadata

public MetricMetadata getMetricMetadata()

Description copied from interface: DescriptorComparator

Metadata about this metric.

It is guaranteed that the actual instance returned can be used as a parameter of the appropriate comparator getter method of the associated DescriptorGenerator

Specified by:

getMetricMetadata in interface DescriptorComparator<FloatVectorDescriptor>

Returns:

Metadata of the comparison

unguardedContext

public UnguardedContext<FloatVectorDescriptor,?> unguardedContext()

Description copied from interface: DescriptorComparator

Associated unguarded context.

Specified by:

unguardedContext in interface DescriptorComparator<FloatVectorDescriptor>

Returns:

unguarded context

getGuardObject

public Object getGuardObject()

Description copied from interface: Guarded

Gets the guard object associated to the generated descriptors/utilities. Note that serialization/deserialization must preserve guard object reference.

This method is intended to use only for ensuring the compatibility of manipulated objects.

Implementations might use the associated DescriptorGenerator or DescriptorParameters reference as the guard object, however it is a non recommended practice to use this method to access the associated generator to perform further operations on it.

Specified by:

getGuardObject in interface Guarded

Returns:

The guard object, can not be null.