de.lmu.ifi.dbs.elki.index.preprocessed.knn

Class SpacefillingMaterializeKNNPreprocessor<O extends NumberVector>

java.lang.Object

de.lmu.ifi.dbs.elki.index.preprocessed.AbstractPreprocessorIndex<O,KNNList>

de.lmu.ifi.dbs.elki.index.preprocessed.knn.AbstractMaterializeKNNPreprocessor<O>

de.lmu.ifi.dbs.elki.index.preprocessed.knn.SpacefillingMaterializeKNNPreprocessor<O>

Type Parameters:

O - Vector type indexed

All Implemented Interfaces:

Index, KNNIndex<O>, Result

@Reference(authors="Erich Schubert, Arthur Zimek, Hans-Peter Kriegel",
           title="Fast and Scalable Outlier Detection with Approximate Nearest Neighbor Ensembles",
           booktitle="Proc. 20th Int. Conf. Database Systems for Advanced Applications (DASFAA 2015)",
           url="https://doi.org/10.1007/978-3-319-18123-3_2",
           bibkey="DBLP:conf/dasfaa/SchubertZK15")
public class SpacefillingMaterializeKNNPreprocessor<O extends NumberVector>
extends AbstractMaterializeKNNPreprocessor<O>

Compute the nearest neighbors approximatively using space filling curves.

This version does the bulk kNN-join operation, i.e. precomputes the k nearest neighbors for every object, then discards the curves. This is usually more memory intensive but faster than SpacefillingKNNPreprocessor.

Reference:

Erich Schubert, Arthur Zimek, Hans-Peter Kriegel
Fast and Scalable Outlier Detection with Approximate Nearest Neighbor Ensembles
Proc. 20th Int. Conf. Database Systems for Advanced Applications (DASFAA 2015)

Since:

0.7.0

Author:

Erich Schubert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SpacefillingMaterializeKNNPreprocessor.Factory<V extends NumberVector> Index factory class

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.util.List<SpatialSorter>	curvegen Spatial curve generators
private static Logging	LOG Class logger
(package private) Mean	mean Mean number of distance computations
(package private) java.util.Random	random Random number generator.
(package private) int	variants Number of variants to generate for each curve
(package private) double	window Curve window size

Fields inherited from class de.lmu.ifi.dbs.elki.index.preprocessed.knn.AbstractMaterializeKNNPreprocessor

distanceFunction, distanceQuery, k

Fields inherited from class de.lmu.ifi.dbs.elki.index.preprocessed.AbstractPreprocessorIndex

relation, storage

Constructor Summary

Constructors

Constructor and Description
SpacefillingMaterializeKNNPreprocessor(Relation<O> relation, DistanceFunction<? super O> distanceFunction, int k, java.util.List<SpatialSorter> curvegen, double window, int variants, java.util.Random random) Constructor.

Method Summary

Modifier and Type	Method and Description
KNNQuery<O>	getKNNQuery(DistanceQuery<O> distQ, java.lang.Object... hints) Get a KNN query object for the given distance query and k.
protected Logging	getLogger() Get the classes static logger.
java.lang.String	getLongName() A "pretty" name for the result, for use in titles, captions and menus.
java.lang.String	getShortName() A short name for the result, useful for file names.
void	logStatistics() Send statistics to the logger, if enabled.
protected void	preprocess() Perform the preprocessing step.

Methods inherited from class de.lmu.ifi.dbs.elki.index.preprocessed.knn.AbstractMaterializeKNNPreprocessor

createStorage, get, getDistanceQuery, getK, initialize

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final Logging LOG

Class logger

curvegen

final java.util.List<SpatialSorter> curvegen

Spatial curve generators

window

final double window

Curve window size

variants

final int variants

Number of variants to generate for each curve

mean

Mean mean

Mean number of distance computations

random

java.util.Random random

Random number generator.

Constructor Detail

SpacefillingMaterializeKNNPreprocessor

public SpacefillingMaterializeKNNPreprocessor(Relation<O> relation,
                                              DistanceFunction<? super O> distanceFunction,
                                              int k,
                                              java.util.List<SpatialSorter> curvegen,
                                              double window,
                                              int variants,
                                              java.util.Random random)

Constructor.

Parameters:

relation - Relation to index.

distanceFunction - Distance function

k - k

curvegen - Curve generators

window - Window multiplicator

variants - Number of curve variants to generate

random - Random number generator

Method Detail

preprocess

protected void preprocess()

Description copied from class: AbstractMaterializeKNNPreprocessor

Perform the preprocessing step.

Specified by:

preprocess in class AbstractMaterializeKNNPreprocessor<O extends NumberVector>

getLongName

public java.lang.String getLongName()

Description copied from interface: Result

A "pretty" name for the result, for use in titles, captions and menus.

Returns:

result name

getShortName

public java.lang.String getShortName()

Description copied from interface: Result

A short name for the result, useful for file names.

Returns:

result name

logStatistics

public void logStatistics()

Description copied from interface: Index

Send statistics to the logger, if enabled. Note: you must have set the logging level appropriately before initializing the index! Otherwise, the index might not have collected the desired statistics.

getLogger

protected Logging getLogger()

Description copied from class: AbstractPreprocessorIndex

Get the classes static logger.

Specified by:

getLogger in class AbstractPreprocessorIndex<O extends NumberVector,KNNList>

Returns:

Logger

getKNNQuery

public KNNQuery<O> getKNNQuery(DistanceQuery<O> distQ,
                               java.lang.Object... hints)

Description copied from interface: KNNIndex

Get a KNN query object for the given distance query and k. This function MAY return null, when the given distance is not supported!

Specified by:

getKNNQuery in interface KNNIndex<O extends NumberVector>

Overrides:

getKNNQuery in class AbstractMaterializeKNNPreprocessor<O extends NumberVector>

Parameters:

distQ - Distance query

hints - Hints for the optimizer

Returns:

KNN Query object or null