de.lmu.ifi.dbs.elki.database.ids.integer

Class AbstractIntegerDBIDFactory

java.lang.Object

de.lmu.ifi.dbs.elki.database.ids.integer.AbstractIntegerDBIDFactory

All Implemented Interfaces:

DBIDFactory

Direct Known Subclasses:

SimpleDBIDFactory, TrivialDBIDFactory

abstract class AbstractIntegerDBIDFactory
extends Object
implements DBIDFactory

Abstract base class for DBID factories.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) DBID	invalid Invalid ID.

Fields inherited from interface de.lmu.ifi.dbs.elki.database.ids.DBIDFactory

FACTORY

Constructor Summary

Constructors

Constructor and Description
AbstractIntegerDBIDFactory()

Method Summary

Methods

Modifier and Type	Method and Description
void	assignVar(DBIDVar var, int val) Assign an integer value to a DBID variable.
int	compare(DBIDRef a, DBIDRef b) Compare two DBIDs, for sorting.
boolean	equal(DBIDRef a, DBIDRef b) Compare two DBIDs, for equality testing.
ByteBufferSerializer<DBID>	getDBIDSerializer() Get a serializer for DBIDs.
FixedSizeByteBufferSerializer<DBID>	getDBIDSerializerStatic() Get a serializer for DBIDs with static size.
Class<? extends DBID>	getTypeRestriction() Get type restriction.
DBID	importInteger(int id) Import and integer as DBID.
DBIDRef	invalid() Get the invalid DBID value, usable as "undefined" placeholder.
ArrayModifiableDBIDs	newArray() Make a new (modifiable) array of DBIDs.
ArrayModifiableDBIDs	newArray(DBIDs existing) Make a new (modifiable) array of DBIDs.
ArrayModifiableDBIDs	newArray(int size) Make a new (modifiable) array of DBIDs.
<D extends Distance<D>> DistanceDBIDPair<D>	newDistancePair(D val, DBIDRef id) Make a new distance-DBID pair.
DoubleDistanceDBIDPair	newDistancePair(double val, DBIDRef id) Make a new distance-DBID pair.
DoubleDistanceKNNHeap	newDoubleDistanceHeap(int k) Create an appropriate heap for double distances.
HashSetModifiableDBIDs	newHashSet() Make a new (modifiable) hash set of DBIDs.
HashSetModifiableDBIDs	newHashSet(DBIDs existing) Make a new (modifiable) hash set of DBIDs.
HashSetModifiableDBIDs	newHashSet(int size) Make a new (modifiable) hash set of DBIDs.
<D extends Distance<D>> KNNHeap<D>	newHeap(D factory, int k) Create an appropriate heap for the distance function.
<D extends Distance<D>> KNNHeap<D>	newHeap(KNNList<D> exist) Build a new heap from a given list.
DBIDPair	newPair(DBIDRef first, DBIDRef second) Make a DBID pair from two existing DBIDs.
DoubleDBIDPair	newPair(double val, DBIDRef id) Make a double-DBID pair.
DBIDVar	newVar(DBIDRef val) Make a new DBID variable.
String	toString(DBIDRef id) Print a DBID as string.

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.lmu.ifi.dbs.elki.database.ids.DBIDFactory

deallocateDBIDRange, deallocateSingleDBID, generateSingleDBID, generateStaticDBIDRange

Field Detail

invalid

DBID invalid

Invalid ID.

Constructor Detail

AbstractIntegerDBIDFactory

AbstractIntegerDBIDFactory()

Method Detail

importInteger

public DBID importInteger(int id)

Description copied from interface: DBIDFactory

Import and integer as DBID. Note: this may not be possible for some factories!

Specified by:

importInteger in interface DBIDFactory

Parameters:

id - Integer ID to import

Returns:

DBID

assignVar

public void assignVar(DBIDVar var,
             int val)

Description copied from interface: DBIDFactory

Assign an integer value to a DBID variable. Note: this may not be possible for some factories!

Specified by:

assignVar in interface DBIDFactory

Parameters:

var - Variable

val - Integer value

compare

public int compare(DBIDRef a,
          DBIDRef b)

Description copied from interface: DBIDFactory

Compare two DBIDs, for sorting.

Specified by:

compare in interface DBIDFactory

Parameters:

a - First

b - Second

Returns:

Comparison result

equal

public boolean equal(DBIDRef a,
            DBIDRef b)

Description copied from interface: DBIDFactory

Compare two DBIDs, for equality testing.

Specified by:

equal in interface DBIDFactory

Parameters:

a - First

b - Second

Returns:

Comparison result

toString

public String toString(DBIDRef id)

Description copied from interface: DBIDFactory

Print a DBID as string.

Specified by:

toString in interface DBIDFactory

Parameters:

id - DBID reference

Returns:

Formatted ID

newVar

public DBIDVar newVar(DBIDRef val)

Description copied from interface: DBIDFactory

Make a new DBID variable.

Specified by:

newVar in interface DBIDFactory

Parameters:

val - Initial value.

Returns:

Variable

newArray

public ArrayModifiableDBIDs newArray()

Description copied from interface: DBIDFactory

Make a new (modifiable) array of DBIDs.

Specified by:

newArray in interface DBIDFactory

Returns:

New array

newHashSet

public HashSetModifiableDBIDs newHashSet()

Description copied from interface: DBIDFactory

Make a new (modifiable) hash set of DBIDs.

Specified by:

newHashSet in interface DBIDFactory

Returns:

New hash set

newArray

public ArrayModifiableDBIDs newArray(int size)

Description copied from interface: DBIDFactory

Make a new (modifiable) array of DBIDs.

Specified by:

newArray in interface DBIDFactory

Parameters:

size - Size hint

Returns:

New array

newHashSet

public HashSetModifiableDBIDs newHashSet(int size)

Description copied from interface: DBIDFactory

Make a new (modifiable) hash set of DBIDs.

Specified by:

newHashSet in interface DBIDFactory

Parameters:

size - Size hint

Returns:

New hash set

newArray

public ArrayModifiableDBIDs newArray(DBIDs existing)

Description copied from interface: DBIDFactory

Make a new (modifiable) array of DBIDs.

Specified by:

newArray in interface DBIDFactory

Parameters:

existing - existing DBIDs to use

Returns:

New array

newHashSet

public HashSetModifiableDBIDs newHashSet(DBIDs existing)

Description copied from interface: DBIDFactory

Make a new (modifiable) hash set of DBIDs.

Specified by:

newHashSet in interface DBIDFactory

Parameters:

existing - existing DBIDs to use

Returns:

New hash set

newPair

public DBIDPair newPair(DBIDRef first,
               DBIDRef second)

Description copied from interface: DBIDFactory

Make a DBID pair from two existing DBIDs.

Specified by:

newPair in interface DBIDFactory

Parameters:

first - first DBID

second - second DBID

Returns:

new pair.

newPair

public DoubleDBIDPair newPair(double val,
                     DBIDRef id)

Description copied from interface: DBIDFactory

Make a double-DBID pair.

Specified by:

newPair in interface DBIDFactory

Parameters:

val - Double value

id - DBID

Returns:

New pair

newDistancePair

public <D extends Distance<D>> DistanceDBIDPair<D> newDistancePair(D val,
                                                          DBIDRef id)

Description copied from interface: DBIDFactory

Make a new distance-DBID pair.

Specified by:

newDistancePair in interface DBIDFactory

Type Parameters:

D - Distance type

Parameters:

val - Distance value

id - Object ID

Returns:

New pair

newDistancePair

public DoubleDistanceDBIDPair newDistancePair(double val,
                                     DBIDRef id)

Description copied from interface: DBIDFactory

Make a new distance-DBID pair.

Specified by:

newDistancePair in interface DBIDFactory

Parameters:

val - Distance value

id - Object ID

Returns:

New pair

newHeap

public <D extends Distance<D>> KNNHeap<D> newHeap(D factory,
                                         int k)

Description copied from interface: DBIDFactory

Create an appropriate heap for the distance function. This will use a double heap if appropriate.

Specified by:

newHeap in interface DBIDFactory

Type Parameters:

D - distance type

Parameters:

factory - distance prototype

k - K value

Returns:

New heap of size k, appropriate for this distance type.

newHeap

public <D extends Distance<D>> KNNHeap<D> newHeap(KNNList<D> exist)

Description copied from interface: DBIDFactory

Build a new heap from a given list.

Specified by:

newHeap in interface DBIDFactory

Type Parameters:

D - Distance type

Parameters:

exist - Existing result

Returns:

New heap

newDoubleDistanceHeap

public DoubleDistanceKNNHeap newDoubleDistanceHeap(int k)

Description copied from interface: DBIDFactory

Create an appropriate heap for double distances.

Specified by:

newDoubleDistanceHeap in interface DBIDFactory

Parameters:

k - K value

Returns:

New heap of size k, appropriate for this distance type.

getDBIDSerializer

public ByteBufferSerializer<DBID> getDBIDSerializer()

Description copied from interface: DBIDFactory

Get a serializer for DBIDs.

Specified by:

getDBIDSerializer in interface DBIDFactory

Returns:

DBID serializer

getDBIDSerializerStatic

public FixedSizeByteBufferSerializer<DBID> getDBIDSerializerStatic()

Description copied from interface: DBIDFactory

Get a serializer for DBIDs with static size.

Specified by:

getDBIDSerializerStatic in interface DBIDFactory

Returns:

DBID serializer

getTypeRestriction

public Class<? extends DBID> getTypeRestriction()

Description copied from interface: DBIDFactory

Get type restriction.

Specified by:

getTypeRestriction in interface DBIDFactory

Returns:

type restriction for DBIDs

invalid

public DBIDRef invalid()

Description copied from interface: DBIDFactory

Get the invalid DBID value, usable as "undefined" placeholder.

Specified by:

invalid in interface DBIDFactory

Returns:

Invalid value