|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.mahout.math.PersistentObject
org.apache.mahout.math.set.AbstractSet
org.apache.mahout.math.map.AbstractByteDoubleMap
org.apache.mahout.math.map.OpenByteDoubleHashMap
public class OpenByteDoubleHashMap
Open hash map from byte keys to double values.
| Nested Class Summary | |
|---|---|
class |
OpenByteDoubleHashMap.MapElement
|
class |
OpenByteDoubleHashMap.MapIterator
|
| Field Summary | |
|---|---|
protected static byte |
FREE
|
protected int |
freeEntries
The number of table entries in state==FREE. |
protected static byte |
FULL
|
protected static byte |
NO_KEY_VALUE
|
protected static byte |
REMOVED
|
protected byte[] |
state
The state of each hash table entry (FREE, FULL, REMOVED). |
protected byte[] |
table
The hash table keys. |
protected double[] |
values
The hash table values. |
| Fields inherited from class org.apache.mahout.math.set.AbstractSet |
|---|
DEFAULT_CAPACITY, DEFAULT_MAX_LOAD_FACTOR, DEFAULT_MIN_LOAD_FACTOR, distinct, highWaterMark, lowWaterMark, maxLoadFactor, minLoadFactor |
| Constructor Summary | |
|---|---|
OpenByteDoubleHashMap()
Constructs an empty map with default capacity and default load factors. |
|
OpenByteDoubleHashMap(int initialCapacity)
Constructs an empty map with the specified initial capacity and default load factors. |
|
OpenByteDoubleHashMap(int initialCapacity,
double minLoadFactor,
double maxLoadFactor)
Constructs an empty map with the specified initial capacity and the specified minimum and maximum load factor. |
|
| Method Summary | |
|---|---|
double |
adjustOrPutValue(byte key,
double newValue,
double incrValue)
Check the map for a key. |
void |
clear()
Removes all (key,value) associations from the receiver. |
Object |
clone()
Returns a deep copy of the receiver. |
boolean |
containsKey(byte key)
Returns true if the receiver contains the specified key. |
boolean |
containsValue(double value)
Returns true if the receiver contains the specified value. |
void |
ensureCapacity(int minCapacity)
Ensures that the receiver can hold at least the specified number of associations without needing to allocate new internal memory. |
boolean |
forEachKey(ByteProcedure procedure)
Applies a procedure to each key of the receiver, if any. |
boolean |
forEachPair(ByteDoubleProcedure procedure)
Applies a procedure to each (key,value) pair of the receiver, if any. |
double |
get(byte key)
Returns the value associated with the specified key. |
protected void |
getInternalFactors(int[] capacity,
double[] minLoadFactor,
double[] maxLoadFactor)
Access for unit tests. |
protected int |
indexOfInsertion(byte key)
|
protected int |
indexOfKey(byte key)
|
protected int |
indexOfValue(double value)
|
Iterator<OpenByteDoubleHashMap.MapElement> |
iterator()
|
void |
keys(ByteArrayList list)
Fills all keys contained in the receiver into the specified list. |
void |
pairsMatching(ByteDoubleProcedure condition,
ByteArrayList keyList,
DoubleArrayList valueList)
Fills all pairs satisfying a given condition into the specified lists. |
boolean |
put(byte key,
double value)
Associates the given key with the given value. |
protected void |
rehash(int newCapacity)
Rehashes the contents of the receiver into a new table with a smaller or larger capacity. |
boolean |
removeKey(byte key)
Removes the given key with its associated element from the receiver, if present. |
protected void |
setUp(int initialCapacity,
double minLoadFactor,
double maxLoadFactor)
Initializes the receiver. |
void |
trimToSize()
Trims the capacity of the receiver to be the receiver's current size. |
void |
values(DoubleArrayList list)
Fills all values contained in the receiver into the specified list. |
| Methods inherited from class org.apache.mahout.math.map.AbstractByteDoubleMap |
|---|
assign, assign, copy, equals, hashCode, keys, keysSortedByValue, pairsSortedByKey, pairsSortedByValue, toString, toStringByValue, values |
| Methods inherited from class org.apache.mahout.math.set.AbstractSet |
|---|
chooseGrowCapacity, chooseHighWaterMark, chooseLowWaterMark, chooseMeanCapacity, chooseShrinkCapacity, equalsMindTheNull, isEmpty, nextPrime, size |
| Methods inherited from class java.lang.Object |
|---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
protected static final byte FREE
protected static final byte FULL
protected static final byte REMOVED
protected static final byte NO_KEY_VALUE
protected byte[] table
protected double[] values
protected byte[] state
protected int freeEntries
| Constructor Detail |
|---|
public OpenByteDoubleHashMap()
public OpenByteDoubleHashMap(int initialCapacity)
initialCapacity - the initial capacity of the map.
IllegalArgumentException - if the initial capacity is less than zero.
public OpenByteDoubleHashMap(int initialCapacity,
double minLoadFactor,
double maxLoadFactor)
initialCapacity - the initial capacity.minLoadFactor - the minimum load factor.maxLoadFactor - the maximum load factor.
IllegalArgumentException - if initialCapacity < 0 || (minLoadFactor < 0.0 || minLoadFactor >= 1.0) ||
(maxLoadFactor <= 0.0 || maxLoadFactor >= 1.0) || (minLoadFactor >=
maxLoadFactor).| Method Detail |
|---|
public void clear()
clear in class AbstractSetpublic Object clone()
clone in class PersistentObjectpublic boolean containsKey(byte key)
containsKey in class AbstractByteDoubleMappublic boolean containsValue(double value)
containsValue in class AbstractByteDoubleMappublic void ensureCapacity(int minCapacity)
This method never need be called; it is for performance tuning only. Calling this method before put()ing a large number of associations boosts performance, because the receiver will grow only once instead of potentially many times and hash collisions get less probable.
ensureCapacity in class AbstractSetminCapacity - the desired minimum capacity.public boolean forEachKey(ByteProcedure procedure)
forEachKey in class AbstractByteDoubleMapprocedure - the procedure to be applied. Stops iteration if the procedure returns false, otherwise
continues.
public boolean forEachPair(ByteDoubleProcedure procedure)
forEachKey(ByteProcedure).
forEachPair in class AbstractByteDoubleMapprocedure - the procedure to be applied. Stops iteration if the procedure returns false, otherwise
continues.
public double get(byte key)
get in class AbstractByteDoubleMapkey - the key to be searched for.
protected int indexOfInsertion(byte key)
key - the key to be added to the receiver.
protected int indexOfKey(byte key)
key - the key to be searched in the receiver.
protected int indexOfValue(double value)
value - the value to be searched in the receiver.
public void keys(ByteArrayList list)
forEachKey(ByteProcedure).
This method can be used to iterate over the keys of the receiver.
keys in class AbstractByteDoubleMaplist - the list to be filled, can have any size.public Iterator<OpenByteDoubleHashMap.MapElement> iterator()
public void pairsMatching(ByteDoubleProcedure condition,
ByteArrayList keyList,
DoubleArrayList valueList)
forEachKey(ByteProcedure). Example:
ByteDoubleProcedure condition = new ByteDoubleProcedure() { // match even values only
public boolean apply(byte key, double value) { return value%2==0; }
}
keys = (8,7,6), values = (1,2,2) --> keyList = (6,8), valueList = (2,1)
pairsMatching in class AbstractByteDoubleMapcondition - the condition to be matched. Takes the current key as first and the current value as second
argument.keyList - the list to be filled with keys, can have any size.valueList - the list to be filled with values, can have any size.
public boolean put(byte key,
double value)
put in class AbstractByteDoubleMapkey - the key the value shall be associated with.value - the value to be associated.
public double adjustOrPutValue(byte key,
double newValue,
double incrValue)
AbstractByteDoubleMap
adjustOrPutValue in class AbstractByteDoubleMapkey - the key.newValue - the value to store if the key is not currently in the map.incrValue - the value to be added to the current value in the map.protected void rehash(int newCapacity)
public boolean removeKey(byte key)
removeKey in class AbstractByteDoubleMapkey - the key to be removed from the receiver.
protected final void setUp(int initialCapacity,
double minLoadFactor,
double maxLoadFactor)
setUp in class AbstractSetinitialCapacity - the initial capacity of the receiver.minLoadFactor - the minLoadFactor of the receiver.maxLoadFactor - the maxLoadFactor of the receiver.
IllegalArgumentException - if initialCapacity < 0 || (minLoadFactor < 0.0 || minLoadFactor >= 1.0) ||
(maxLoadFactor <= 0.0 || maxLoadFactor >= 1.0) || (minLoadFactor >=
maxLoadFactor).public void trimToSize()
trimToSize in class AbstractSetpublic void values(DoubleArrayList list)
forEachKey(ByteProcedure).
This method can be used to iterate over the values of the receiver.
values in class AbstractByteDoubleMaplist - the list to be filled, can have any size.
protected void getInternalFactors(int[] capacity,
double[] minLoadFactor,
double[] maxLoadFactor)
capacity - minLoadFactor - maxLoadFactor -
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||