de.unknownreality.dataframe.column

Class BasicColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

java.lang.Object

de.unknownreality.dataframe.DataFrameColumn<T,C>

de.unknownreality.dataframe.column.BasicColumn<T,C>

All Implemented Interfaces:

Iterable<T>

Direct Known Subclasses:

BooleanColumn, NumberColumn, StringColumn

public abstract class BasicColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>
extends DataFrameColumn<T,C>

Created by Alex on 09.03.2016.

Field Summary

Fields

Modifier and Type	Field and Description
static double	GROW_FACTOR
static int	INIT_SIZE
protected T[]	values

Fields inherited from class de.unknownreality.dataframe.DataFrameColumn

ERROR_APPENDING

Constructor Summary

Constructors

Constructor and Description
BasicColumn()
BasicColumn(String name)
BasicColumn(String name, T[] values)
BasicColumn(String name, T[] values, int size)

Method Summary

Modifier and Type	Method and Description
List<T>	asList() Returns this column as an immutable List.
void	clear() Clears this column.
boolean	contains(T o) Returns true if the specified value exists in this column.
boolean	containsAll(Collection<?> c) Returns true if all values of a specified collection are present in this column.
protected boolean	doAppend(T t) Used by DataFrameColumn.append(Comparable) to append a value to this column.
protected boolean	doAppendAll(Collection<? extends T> c) Used by DataFrameColumn.appendAll(Collection)} to append a collection of values.
protected boolean	doAppendNA() Used by DataFrameColumn.appendNA() to append NA at the end of this column.
protected void	doMap(MapFunction<T> mapFunction) Used by DataFrameColumn.map(MapFunction).
protected void	doReverse() Used by DataFrameColumn.reverse() to reverse the order of this column
protected void	doSet(int index, T value) Used by DataFrameColumn.set(int, Comparable) to set a value at a specified index
protected void	doSetNA(int index) Used by DataFrameColumn.setNA(int) to set a specified index to NA.
protected void	doSort() Used by DataFrameColumn.sort() to sort the column values by their natural ordering
protected void	doSort(Comparator<T> comparator) Used by DataFrameColumn.sort(Comparator) to sort the values in this column
T	get(int index) Returns the value at a specified index
boolean	isEmpty() Returns true if this column contains no values.
boolean	isNA(int index) Returns true if the value at the specified index equals NA.
boolean	isValueValid(Comparable value) returns true if the input value is compatible with this column
Iterator<T>	iterator() Returns an iterator over the values in this column.
C	setCapacity(int capacity) Sets the capacity of this column.
protected void	setValue(int index, T value)
int	size() Returns the number of values in this column.
Comparable[]	toArray() Returns an Comparable array that contains all values of this column.
T[]	toArray(T[] a) Copies the values of this column to a specified array of the same type.
List<T>	toList() Returns a List that contains all values of this column.
Set<T>	uniq() Returns a set containing all values in this column

Methods inherited from class de.unknownreality.dataframe.DataFrameColumn

append, append, append, append, appendAll, appendNA, copy, copyEmpty, endDataFrameAppend, getDataFrame, getName, getParser, getThis, getType, getValueFromRow, getValueFromRow, map, notifyDataFrameColumnChanged, notifyDataFrameValueChanged, reverse, set, setDataFrame, setNA, setName, sort, sort, startDataFrameAppend, toDouble, transform, transform, validateAppend

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

GROW_FACTOR

public static final double GROW_FACTOR

See Also:

Constant Field Values

INIT_SIZE

public static final int INIT_SIZE

See Also:

Constant Field Values

values

protected T extends Comparable<T>[] values

Constructor Detail

BasicColumn

public BasicColumn(String name)

BasicColumn

public BasicColumn()

BasicColumn

public BasicColumn(String name,
                   T[] values,
                   int size)

BasicColumn

public BasicColumn(String name,
                   T[] values)

Method Detail

setCapacity

public C setCapacity(int capacity)

Description copied from class: DataFrameColumn

Sets the capacity of this column. Can be used during dataframe creation if the size is known.

Specified by:

setCapacity in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

capacity - capacity

Returns:

self for method chaining

doSort

protected void doSort(Comparator<T> comparator)

Description copied from class: DataFrameColumn

Used by DataFrameColumn.sort(Comparator) to sort the values in this column

Specified by:

doSort in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

comparator - sort comparator

See Also:

DataFrameColumn.sort()

doSort

protected void doSort()

Description copied from class: DataFrameColumn

Used by DataFrameColumn.sort() to sort the column values by their natural ordering

Specified by:

doSort in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

See Also:

DataFrameColumn.sort()

doSet

protected void doSet(int index,
                     T value)

Description copied from class: DataFrameColumn

Used by DataFrameColumn.set(int, Comparable) to set a value at a specified index

Specified by:

doSet in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

index - index of the new value

value - value to be doSet

See Also:

DataFrameColumn.set(int, Comparable)

setValue

protected void setValue(int index,
                        T value)

doMap

protected void doMap(MapFunction<T> mapFunction)

Description copied from class: DataFrameColumn

Used by DataFrameColumn.map(MapFunction). A map function is applied to the values in this column.

Specified by:

doMap in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

mapFunction - function applied to each value

See Also:

DataFrameColumn.map(MapFunction)

doReverse

protected void doReverse()

Description copied from class: DataFrameColumn

Used by DataFrameColumn.reverse() to reverse the order of this column

Specified by:

doReverse in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

get

public T get(int index)

Description copied from class: DataFrameColumn

Returns the value at a specified index

Specified by:

get in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

index - Index of the returned value

Returns:

Value at the specified index

isValueValid

public boolean isValueValid(Comparable value)

Description copied from class: DataFrameColumn

returns true if the input value is compatible with this column

Specified by:

isValueValid in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

value - tested value

Returns:

true if value is compatible

size

public int size()

Description copied from class: DataFrameColumn

Returns the number of values in this column.

Specified by:

size in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Returns:

Number of values in this column

isEmpty

public boolean isEmpty()

Description copied from class: DataFrameColumn

Returns true if this column contains no values.

Specified by:

isEmpty in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Returns:

true if this column is empty.

contains

public boolean contains(T o)

Description copied from class: DataFrameColumn

Returns true if the specified value exists in this column.

Specified by:

contains in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

o - value that is tested

Returns:

true if this column contains the specified value

iterator

public Iterator<T> iterator()

Returns an iterator over the values in this column. Iterator.remove() is not supported

Returns:

iterator over column values

uniq

public Set<T> uniq()

Returns a set containing all values in this column

Returns:

set of values in this column

toArray

public Comparable[] toArray()

Description copied from class: DataFrameColumn

Returns an Comparable array that contains all values of this column.

Specified by:

toArray in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Returns:

Object array with all column values

toArray

public T[] toArray(T[] a)

Description copied from class: DataFrameColumn

Copies the values of this column to a specified array of the same type. The size of the array and the column size must be equal.

Specified by:

toArray in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

a - The array the values are copied to

Returns:

the array with the copied values.

doAppend

protected boolean doAppend(T t)

Description copied from class: DataFrameColumn

Used by DataFrameColumn.append(Comparable) to append a value to this column.

Specified by:

doAppend in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

t - value to be appended

Returns:

true if the value is successfully appended

doAppendNA

protected boolean doAppendNA()

Description copied from class: DataFrameColumn

Used by DataFrameColumn.appendNA() to append NA at the end of this column.

Specified by:

doAppendNA in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Returns:

true if value was appended successfully

See Also:

DataFrameColumn.appendNA()

isNA

public boolean isNA(int index)

Description copied from class: DataFrameColumn

Returns true if the value at the specified index equals NA.

Specified by:

isNA in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

index - index to be tested for NA

Returns:

true if the specified index is NA

doSetNA

protected void doSetNA(int index)

Description copied from class: DataFrameColumn

Used by DataFrameColumn.setNA(int) to set a specified index to NA.

Specified by:

doSetNA in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

index - index to be doSet to NA

containsAll

public boolean containsAll(Collection<?> c)

Description copied from class: DataFrameColumn

Returns true if all values of a specified collection are present in this column.

Specified by:

containsAll in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

c - Collection that contains the tested values

Returns:

true if all values are present in this column

doAppendAll

protected boolean doAppendAll(Collection<? extends T> c)

Description copied from class: DataFrameColumn

Used by DataFrameColumn.appendAll(Collection)} to append a collection of values.

Specified by:

doAppendAll in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Parameters:

c - collection containing values to be added to this column

Returns:

true if the value is successfully appended

See Also:

DataFrameColumn.append(Comparable)

toList

public List<T> toList()

Description copied from class: DataFrameColumn

Returns a List that contains all values of this column.

Specified by:

toList in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Returns:

list with all column values

asList

public List<T> asList()

Description copied from class: DataFrameColumn

Returns this column as an immutable List.

Specified by:

asList in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>

Returns:

immutable list containing all values

clear

public void clear()

Description copied from class: DataFrameColumn

Clears this column. All values are removed and the size is doSet to 0

Specified by:

clear in class DataFrameColumn<T extends Comparable<T>,C extends BasicColumn<T,C>>