com.yahoo.sketches.theta

Interface Union

public interface Union

The API for Union operations

Author:

Lee Rhodes

Method Summary

Modifier and Type	Method and Description
CompactSketch	getResult() Gets the result of this operation as an ordered CompactSketch on the Java heap.
CompactSketch	getResult(boolean dstOrdered, Memory dstMem) Gets the result of this operation as a CompactSketch of the chosen form.
void	reset() Resets this Union.
byte[]	toByteArray() Returns a byte array image of this Union object
void	update(byte[] data) Present this union with the given byte array.
void	update(char[] data) Present this union with the given char array.
void	update(double datum) Present this union with the given double (or float) datum.
void	update(int[] data) Present this union with the given integer array.
void	update(long datum) Present this union with a long.
void	update(long[] data) Present this union with the given long array.
void	update(Memory mem) Union the given Memory image of the OpenSource Theta Sketch, which may be ordered or unordered, or the earlier versions of SetSketch, which must be compact and ordered.
void	update(Sketch sketchIn) Union the given on-heap sketch.
void	update(String datum) Present this union with the given String.

Method Detail

update

void update(Sketch sketchIn)

Union the given on-heap sketch. Valid for the all of the Open Source, Theta Sketches. Not valid for older (prior to Open Source) Theta Sketches. This method can be repeatedly called. If the given sketch is null it is interpreted as an empty sketch.

Parameters:

sketchIn - The incoming sketch.

update

void update(Memory mem)

Union the given Memory image of the OpenSource Theta Sketch, which may be ordered or unordered, or the earlier versions of SetSketch, which must be compact and ordered.

This method can be repeatedly called. If the given sketch is null it is interpreted as an empty sketch.

Parameters:

mem - Memory image of sketch to be merged

update

void update(long datum)

Present this union with a long.

Parameters:

datum - The given long datum.

update

void update(double datum)

Present this union with the given double (or float) datum. The double will be converted to a long using Double.doubleToLongBits(datum), which normalizes all NaN values to a single NaN representation. Plus and minus zero will be normalized to plus zero. The special floating-point values NaN and +/- Infinity are treated as distinct.

Parameters:

datum - The given double datum.

update

void update(String datum)

Present this union with the given String. The string is converted to a byte array using UTF8 encoding. If the string is null or empty no update attempt is made and the method returns.

Note: this will not produce the same output hash values as the update(char[]) method and will generally be a little slower depending on the complexity of the UTF8 encoding.

Parameters:

datum - The given String.

update

void update(byte[] data)

Present this union with the given byte array. If the byte array is null or empty no update attempt is made and the method returns.

Parameters:

data - The given byte array.

update

void update(int[] data)

Present this union with the given integer array. If the integer array is null or empty no update attempt is made and the method returns.

Parameters:

data - The given int array.

update

void update(char[] data)

Present this union with the given char array. If the char array is null or empty no update attempt is made and the method returns.

Note: this will not produce the same output hash values as the update(String) method but will be a little faster as it avoids the complexity of the UTF8 encoding.

Parameters:

data - The given char array.

update

void update(long[] data)

Present this union with the given long array. If the long array is null or empty no update attempt is made and the method returns.

Parameters:

data - The given long array.

getResult

CompactSketch getResult(boolean dstOrdered,
                        Memory dstMem)

Gets the result of this operation as a CompactSketch of the chosen form. This does not disturb the underlying data structure of the union. Therefore, it is OK to continue updating the union after this operation.

Parameters:

dstOrdered - See Destination Ordered

dstMem - See Destination Memory.

Returns:

the result of this operation as a CompactSketch of the chosen form

getResult

CompactSketch getResult()

Gets the result of this operation as an ordered CompactSketch on the Java heap. This does not disturb the underlying data structure of the union. Therefore, it is OK to continue updating the union after this operation.

Returns:

the result of this operation as an ordered CompactSketch on the Java heap

toByteArray

byte[] toByteArray()

Returns a byte array image of this Union object

Returns:

a byte array image of this Union object

reset

void reset()

Resets this Union. The seed remains intact, otherwise reverts back to its virgin state.