de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.mtree

Class MTreeIndex<O>

java.lang.Object

de.lmu.ifi.dbs.elki.index.tree.IndexTree<N,E>

de.lmu.ifi.dbs.elki.index.tree.metrical.MetricalIndexTree<O,N,E>

de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.AbstractMTree<O,MTreeNode<O>,MTreeEntry,MTreeSettings<O,MTreeNode<O>,MTreeEntry>>

de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.mtree.MTree<O>

de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.mtree.MTreeIndex<O>

Type Parameters:

O - Object type

All Implemented Interfaces:

DynamicIndex, Index, KNNIndex<O>, RangeIndex<O>, Result

public class MTreeIndex<O>
extends MTree<O>
implements RangeIndex<O>, KNNIndex<O>, DynamicIndex

Class for using an m-tree as database index.

Since:

0.4.0

Author:

Erich Schubert

Nested Class Summary

Nested classes/interfaces inherited from class de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.AbstractMTree

AbstractMTree.Statistics

Field Summary

Fields

Modifier and Type	Field and Description
protected DistanceQuery<O>	distanceQuery The distance query.
private Relation<O>	relation The relation indexed.

Fields inherited from class de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.AbstractMTree

EXTRA_INTEGRITY_CHECKS, settings, statistics

Fields inherited from class de.lmu.ifi.dbs.elki.index.tree.IndexTree

dirCapacity, dirMinimum, initialized, leafCapacity, leafMinimum

Constructor Summary

Constructors

Constructor and Description
MTreeIndex(Relation<O> relation, PageFile<MTreeNode<O>> pagefile, MTreeSettings<O,MTreeNode<O>,MTreeEntry> settings) Constructor.

Method Summary

Modifier and Type	Method and Description
protected MTreeEntry	createNewLeafEntry(DBID id, O object, double parentDistance)
boolean	delete(DBIDRef id) Throws an UnsupportedOperationException since deletion of objects is not yet supported by an M-Tree.
void	deleteAll(DBIDs ids) Throws an UnsupportedOperationException since deletion of objects is not yet supported by an M-Tree.
double	distance(DBIDRef id1, DBIDRef id2) Returns the distance between the two specified ids.
KNNQuery<O>	getKNNQuery(DistanceQuery<O> distanceQuery, java.lang.Object... hints) Get a KNN query object for the given distance query and k.
java.lang.String	getLongName() A "pretty" name for the result, for use in titles, captions and menus.
RangeQuery<O>	getRangeQuery(DistanceQuery<O> distanceQuery, java.lang.Object... hints) Get a range query object for the given distance query and k.
java.lang.String	getShortName() A short name for the result, useful for file names.
void	initialize() Initialize the tree if the page file already existed.
protected void	initializeCapacities(MTreeEntry exampleLeaf) Determines the maximum and minimum number of entries in a node.
void	insert(DBIDRef id) Inserts the specified object into this index.
void	insertAll(DBIDs ids) Inserts the specified objects into this index.

Methods inherited from class de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.mtree.MTree

createNewDirectoryEntry, createNewDirectoryNode, createNewLeafNode, createRootEntry, getLogger, preInsert

Methods inherited from class de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.AbstractMTree

createEmptyRoot, distance, getDistanceFunction, getHeight, getLeaves, getSortedEntries, insert, insertAll, logStatistics, toString

Methods inherited from class de.lmu.ifi.dbs.elki.index.tree.IndexTree

createHeader, deleteNode, getDirMinimum, getFile, getLeafMinimum, getNode, getNode, getPageID, getPageSize, getRoot, getRootEntry, getRootID, getRootPath, initialize, initializeFromFile, isRoot, postDelete, writeNode

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.lmu.ifi.dbs.elki.index.Index

logStatistics

Field Detail

relation

private Relation<O> relation

The relation indexed.

distanceQuery

protected DistanceQuery<O> distanceQuery

The distance query.

Constructor Detail

MTreeIndex

public MTreeIndex(Relation<O> relation,
                  PageFile<MTreeNode<O>> pagefile,
                  MTreeSettings<O,MTreeNode<O>,MTreeEntry> settings)

Constructor.

Parameters:

relation - Relation indexed

pagefile - Page file

settings - Tree settings

Method Detail

distance

public double distance(DBIDRef id1,
                       DBIDRef id2)

Description copied from class: AbstractMTree

Returns the distance between the two specified ids.

Specified by:

distance in class AbstractMTree<O,MTreeNode<O>,MTreeEntry,MTreeSettings<O,MTreeNode<O>,MTreeEntry>>

Parameters:

id1 - the first id

id2 - the second id

Returns:

the distance between the two specified ids

initializeCapacities

protected void initializeCapacities(MTreeEntry exampleLeaf)

Description copied from class: IndexTree

Determines the maximum and minimum number of entries in a node.

Specified by:

initializeCapacities in class IndexTree<MTreeNode<O>,MTreeEntry>

Parameters:

exampleLeaf - an object that will be stored in the index

createNewLeafEntry

protected MTreeEntry createNewLeafEntry(DBID id,
                                        O object,
                                        double parentDistance)

Returns:

a new MTreeLeafEntry representing the specified data object

initialize

public void initialize()

Description copied from class: IndexTree

Initialize the tree if the page file already existed.

Specified by:

initialize in interface Index

Overrides:

initialize in class IndexTree<MTreeNode<O>,MTreeEntry>

insert

public void insert(DBIDRef id)

Description copied from interface: DynamicIndex

Inserts the specified object into this index.

Specified by:

insert in interface DynamicIndex

Parameters:

id - the object to be inserted

insertAll

public void insertAll(DBIDs ids)

Description copied from interface: DynamicIndex

Inserts the specified objects into this index. If a bulk load mode is implemented, the objects are inserted in one bulk.

Specified by:

insertAll in interface DynamicIndex

Parameters:

ids - the objects to be inserted

delete

public final boolean delete(DBIDRef id)

Throws an UnsupportedOperationException since deletion of objects is not yet supported by an M-Tree.

Specified by:

delete in interface DynamicIndex

Parameters:

id - Object to remove

Returns:

true if this index did contain the object, false otherwise

Throws:

java.lang.UnsupportedOperationException - thrown, since deletions aren't implemented yet.

deleteAll

public void deleteAll(DBIDs ids)

Throws an UnsupportedOperationException since deletion of objects is not yet supported by an M-Tree.

Specified by:

deleteAll in interface DynamicIndex

Parameters:

ids - Objects to remove

Throws:

java.lang.UnsupportedOperationException - thrown, since deletions aren't implemented yet.

getKNNQuery

public KNNQuery<O> getKNNQuery(DistanceQuery<O> distanceQuery,
                               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>

Parameters:

distanceQuery - Distance query

hints - Hints for the optimizer

Returns:

KNN Query object or null

getRangeQuery

public RangeQuery<O> getRangeQuery(DistanceQuery<O> distanceQuery,
                                   java.lang.Object... hints)

Description copied from interface: RangeIndex

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

Specified by:

getRangeQuery in interface RangeIndex<O>

Parameters:

distanceQuery - Distance query

hints - Hints for the optimizer

Returns:

KNN Query object or null

getLongName

public java.lang.String getLongName()

Description copied from interface: Result

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

Specified by:

getLongName in interface Result

Returns:

result name

getShortName

public java.lang.String getShortName()

Description copied from interface: Result

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

Specified by:

getShortName in interface Result

Returns:

result name