de.lmu.ifi.dbs.elki.index.tree.spatial.rstarvariants.query

Class DoubleDistanceRStarTreeKNNQuery<O extends SpatialComparable>

java.lang.Object

de.lmu.ifi.dbs.elki.database.query.AbstractDataBasedQuery<O>

de.lmu.ifi.dbs.elki.database.query.knn.AbstractDistanceKNNQuery<O,DoubleDistance>

de.lmu.ifi.dbs.elki.index.tree.spatial.rstarvariants.query.DoubleDistanceRStarTreeKNNQuery<O>

All Implemented Interfaces:

DatabaseQuery, KNNQuery<O,DoubleDistance>

@Reference(authors="G. R. Hjaltason, H. Samet",
           title="Ranking in spatial databases",
           booktitle="Advances in Spatial Databases - 4th Symposium, SSD\'95",
           url="http://dx.doi.org/10.1007/3-540-60159-7_6")
public class DoubleDistanceRStarTreeKNNQuery<O extends SpatialComparable>
extends AbstractDistanceKNNQuery<O,DoubleDistance>

Instance of a KNN query for a particular spatial index. Reference:

G. R. Hjaltason, H. Samet
Ranking in spatial databases
In: 4th Symposium on Advances in Spatial Databases, SSD'95

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) class	DoubleDistanceRStarTreeKNNQuery.DoubleDistanceEntry Optimized double distance entry implementation.

Field Summary

Fields

Modifier and Type	Field and Description
protected SpatialPrimitiveDoubleDistanceFunction<? super O>	distanceFunction Spatial primitive distance function
protected AbstractRStarTree<?,?,?>	tree The index to use

Fields inherited from class de.lmu.ifi.dbs.elki.database.query.knn.AbstractDistanceKNNQuery

distanceQuery

Fields inherited from class de.lmu.ifi.dbs.elki.database.query.AbstractDataBasedQuery

relation

Fields inherited from interface de.lmu.ifi.dbs.elki.database.query.DatabaseQuery

HINT_BULK, HINT_EXACT, HINT_HEAVY_USE, HINT_NO_CACHE, HINT_OPTIMIZED_ONLY, HINT_SINGLE

Constructor Summary

Constructors

Constructor and Description
DoubleDistanceRStarTreeKNNQuery(AbstractRStarTree<?,?,?> tree, DistanceQuery<O,DoubleDistance> distanceQuery, SpatialPrimitiveDoubleDistanceFunction<? super O> distanceFunction) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	batchNN(AbstractRStarTreeNode<?,?> node, Map<DBID,DoubleDistanceKNNHeap> knnLists) Performs a batch knn query.
private double	expandNode(O object, DoubleDistanceKNNHeap knnList, ComparableMinHeap<DoubleDistanceSearchCandidate> pq, double maxDist, int nodeID)
List<DoubleDistanceKNNList>	getKNNForBulkDBIDs(ArrayDBIDs ids, int k) Bulk query method
DoubleDistanceKNNList	getKNNForObject(O obj, int k) Get the k nearest neighbors for a particular id.
protected List<DoubleDistanceRStarTreeKNNQuery.DoubleDistanceEntry>	getSortedEntries(AbstractRStarTreeNode<?,?> node, DBIDs ids) Sorts the entries of the specified node according to their minimum distance to the specified objects.

Methods inherited from class de.lmu.ifi.dbs.elki.database.query.knn.AbstractDistanceKNNQuery

getKNNForDBID

Methods inherited from class de.lmu.ifi.dbs.elki.database.query.AbstractDataBasedQuery

getRelation

Methods inherited from class java.lang.Object

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

Field Detail

tree

protected final AbstractRStarTree<?,?,?> tree

The index to use

distanceFunction

protected final SpatialPrimitiveDoubleDistanceFunction<? super O extends SpatialComparable> distanceFunction

Spatial primitive distance function

Constructor Detail

DoubleDistanceRStarTreeKNNQuery

public DoubleDistanceRStarTreeKNNQuery(AbstractRStarTree<?,?,?> tree,
                               DistanceQuery<O,DoubleDistance> distanceQuery,
                               SpatialPrimitiveDoubleDistanceFunction<? super O> distanceFunction)

Constructor.

Parameters:

tree - Index to use

distanceQuery - Distance query to use

distanceFunction - Distance function

Method Detail

getKNNForObject

public DoubleDistanceKNNList getKNNForObject(O obj,
                                    int k)

Description copied from interface: KNNQuery

Get the k nearest neighbors for a particular id.

Specified by:

getKNNForObject in interface KNNQuery<O extends SpatialComparable,DoubleDistance>

Specified by:

getKNNForObject in class AbstractDistanceKNNQuery<O extends SpatialComparable,DoubleDistance>

Parameters:

obj - Query object

k - Number of neighbors requested

Returns:

neighbors

expandNode

private double expandNode(O object,
                DoubleDistanceKNNHeap knnList,
                ComparableMinHeap<DoubleDistanceSearchCandidate> pq,
                double maxDist,
                int nodeID)

batchNN

protected void batchNN(AbstractRStarTreeNode<?,?> node,
           Map<DBID,DoubleDistanceKNNHeap> knnLists)

Performs a batch knn query.

Parameters:

node - the node for which the query should be performed

knnLists - a map containing the knn lists for each query objects

getSortedEntries

protected List<DoubleDistanceRStarTreeKNNQuery.DoubleDistanceEntry> getSortedEntries(AbstractRStarTreeNode<?,?> node,
                                                                         DBIDs ids)

Sorts the entries of the specified node according to their minimum distance to the specified objects.

Parameters:

node - the node

ids - the id of the objects

Returns:

a list of the sorted entries

getKNNForBulkDBIDs

public List<DoubleDistanceKNNList> getKNNForBulkDBIDs(ArrayDBIDs ids,
                                             int k)

Description copied from interface: KNNQuery

Bulk query method

Specified by:

getKNNForBulkDBIDs in interface KNNQuery<O extends SpatialComparable,DoubleDistance>

Overrides:

getKNNForBulkDBIDs in class AbstractDistanceKNNQuery<O extends SpatialComparable,DoubleDistance>

Parameters:

ids - query object IDs

k - Number of neighbors requested

Returns:

neighbors