Package tech.tablesaw.api

Class DoubleColumn

java.lang.Object

tech.tablesaw.columns.AbstractColumn<C,T>

tech.tablesaw.api.NumberColumn<DoubleColumn,Double>

tech.tablesaw.api.DoubleColumn

All Implemented Interfaces:

Iterable<Double>, Comparator<Double>, NumericColumn<Double>, Column<Double>, NumberFillers<DoubleColumn>, NumberFilters, NumberMapFunctions, FilterSpec<Selection>, NumberFilterSpec<Selection>

public class DoubleColumn
extends NumberColumn<DoubleColumn,Double>
implements NumberFillers<DoubleColumn>

A column that contains double values

Field Summary

Fields

Modifier and Type	Field	Description
protected final it.unimi.dsi.fastutil.doubles.DoubleArrayList	data

Fields inherited from class tech.tablesaw.api.NumberColumn

comparator, locale

Fields inherited from class tech.tablesaw.columns.AbstractColumn

DEFAULT_ARRAY_SIZE, DEFAULT_COLUMN_TYPE_MISMATCH_MESSAGE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DoubleColumn(String name)
protected	DoubleColumn(String name, it.unimi.dsi.fastutil.doubles.DoubleArrayList data)

Method Summary

Modifier and Type	Method	Description
DoubleColumn	append(double d)	Adds the given double to this column
DoubleColumn	append(float f)	Adds the given float to this column
DoubleColumn	append(int i)
DoubleColumn	append(Double val)	Appends value to the bottom of this column and return this column
DoubleColumn	append(Number val)
DoubleColumn	append(Column<Double> column)	Appends all the values in the argument to the bottom of this column and return this column
DoubleColumn	append(Column<Double> column, int row)	Appends the value at the given row in the given column to the bottom of this column and return this column
DoubleColumn	appendCell(String value)	Add one element to the bottom of this column and set its value to the parsed value of the given String.
DoubleColumn	appendCell(String value, AbstractColumnParser<?> parser)	Add one element to the bottom of this column and set its value to the parsed value of the given String, as performed by the given parser
DoubleColumn	appendMissing()	Appends a missing value appropriate to the column
DoubleColumn	appendObj(Object obj)	Appends the given value to the bottom of this column and return this column
byte[]	asBytes(int rowNumber)	Returns the contents of the cell at rowNumber as a byte[].
double[]	asDoubleArray()
FloatColumn	asFloatColumn()	Returns a new FloatColumn containing a value for each value in this column, truncating if necessary.
IntColumn	asIntColumn()	Returns a new IntColumn containing a value for each value in this column, truncating if necessary.
LongColumn	asLongColumn()	Returns a new LongColumn containing a value for each value in this column, truncating if necessary
Double[]	asObjectArray()	Returns an array of objects as appropriate for my type of column
Set<Double>	asSet()	Returns a Set containing all the unique values in this column
ShortColumn	asShortColumn()	Returns a new ShortColumn containing a value for each value in this column, truncating if necessary.
DoubleColumn	bottom(int n)	Returns the smallest ("bottom") n values in the column TODO(lwhite): Consider whether this should exclude missing
void	clear()	Removes all elements TODO: Make this return this column
int	compare(Double o1, Double o2)
DoubleColumn	copy()	Returns a deep copy of the receiver
int	countUnique()	Returns the count of unique values in this column.
static DoubleColumn	create(String name)
static DoubleColumn	create(String name, double... arr)
static DoubleColumn	create(String name, float... arr)
static DoubleColumn	create(String name, int initialSize)
static DoubleColumn	create(String name, int... arr)
static DoubleColumn	create(String name, long... arr)
static DoubleColumn	create(String name, Number[] numbers)
static DoubleColumn	create(String name, Collection<? extends Number> numberList)
static DoubleColumn	create(String name, DoubleStream stream)
DoubleColumn	createCol(String name)
DoubleColumn	createCol(String name, int initialSize)
boolean	equals(int rowNumber1, int rowNumber2)	Returns true if the value in this column at rowNumber1 is equal to the value at rowNumber2
DoubleColumn	fillWith(double d)
DoubleColumn	fillWith(it.unimi.dsi.fastutil.doubles.DoubleIterator iterator)
DoubleColumn	fillWith(DoubleSupplier supplier)
DoubleColumn	fillWith(DoubleRangeIterable iterable)
DoubleColumn	filter(DoublePredicate test)	Returns a new NumberColumn with only those rows satisfying the predicate
Double	get(int index)	Returns the value at the given zero-based index
double	getDouble(int row)	Returns a double representation of the number at index
String	getString(int row)	Returns a string representation of the value at the given row.
String	getUnformattedString(int row)	Returns a String representation of the value at index r, without any formatting applied
Selection	isIn(double... doubles)
boolean	isMissing(int rowNumber)	Returns true if the value at rowNumber is missing
boolean	isMissingValue(double value)
Selection	isNotIn(double... doubles)
Iterator<Double>	iterator()
DoubleColumn	lag(int n)	Returns a column of the same type and size as the receiver, containing the receivers values offset by n.
DoubleColumn	removeMissing()	Returns a copy of this column with the missing values removed
DoubleColumn	set(int i, double val)
DoubleColumn	set(int i, Double val)	Sets the value at index row to the given value and return this column
Column<Double>	set(int row, String stringValue, AbstractColumnParser<?> parser)	Sets the value at row to the parsed value of the given String using the given parser and returns this column
DoubleColumn	set(int row, Column<Double> column, int sourceRow)	Sets the value at row to the value at sourceRow in the given column and return this column
DoubleColumn	set(DoublePredicate condition, NumericColumn<?> other)	Updates this column where values matching the selection are replaced with the corresponding value from the given column
DoubleColumn	setMissing(int index)	Sets the value at index i to the missing-value indicator for this column type, and return this column
int	size()	Returns the number of elements in this column, including missing values
void	sortAscending()	Sorts my values in ascending order
void	sortDescending()	Sorts my values in descending order
DoubleColumn	subset(int[] rows)	Return a column of the same type containing just those elements whose indexes are included in the given array
DoubleColumn	top(int n)	Returns the largest ("top") n values in the column TODO(lwhite): Consider whether this should exclude missing
DoubleColumn	unique()	Returns a column of the same type containing only the unique values
int	valueHash(int rowNumber)	Returns an int suitable as a hash for the value in this column at the given index
static boolean	valueIsMissing(double value)
DoubleColumn	where(Selection selection)	Returns the subset of data in this column included in the given Selection

Methods inherited from class tech.tablesaw.api.NumberColumn

byteSize, countMissing, emptyCopy, emptyCopy, getPrintFormatter, rowComparator, set, set, setPrintFormatter, setPrintFormatter

Methods inherited from class tech.tablesaw.columns.AbstractColumn

asStringColumn, filter, first, indexOf, inRange, last, map, max, min, name, parser, sampleN, sampleX, set, set, setName, setParser, sorted, toString, type

Methods inherited from class java.lang.Object

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

Methods inherited from interface tech.tablesaw.columns.Column

allMatch, anyMatch, asList, columnWidth, contains, count, count, filter, first, indexOf, inRange, last, map, map, mapInto, max, max, min, min, name, noneMatch, parser, print, reduce, reduce, sampleN, sampleX, set, set, set, setMissingTo, setName, setParser, sorted, title, type

Methods inherited from interface java.util.Comparator

equals, reversed, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface tech.tablesaw.columns.numbers.NumberFilters

isBetweenExclusive, isBetweenInclusive, isCloseTo, isEqualTo, isEqualTo, isGreaterThan, isGreaterThan, isGreaterThanOrEqualTo, isGreaterThanOrEqualTo, isLessThan, isLessThan, isLessThanOrEqualTo, isLessThanOrEqualTo, isNegative, isNonNegative, isNotEqualTo, isNotEqualTo, isPositive, isZero

Methods inherited from interface tech.tablesaw.columns.numbers.NumberMapFunctions

abs, add, add, add, asPercent, asRatio, bin, cube, cubeRoot, cumMax, cumMin, cumProd, cumSum, difference, divide, divide, divide, log10, log1p, logN, multiply, multiply, multiply, name, neg, normalize, pctChange, power, power, reciprocal, remainder, remainder, round, roundInt, sqrt, square, subtract, subtract, subtract

Methods inherited from interface tech.tablesaw.api.NumericColumn

allMatch, anyMatch, asDoubleColumn, asStringColumn, autoCorrelation, autoCorrelation, count, count, eval, eval, geometricMean, interpolate, isEmpty, isIn, isMissing, isNotIn, isNotMissing, kendalls, kurtosis, lead, mapInto, max, max, mean, median, min, min, noneMatch, pctChange, pearsons, percentile, populationVariance, product, quadraticMean, quartile1, quartile3, range, reduce, reduce, rolling, skewness, spearmans, standardDeviation, stats, sum, summarize, summary, sumOfLogs, sumOfSquares, variance

Field Details

data

protected final it.unimi.dsi.fastutil.doubles.DoubleArrayList data

Constructor Details

DoubleColumn

protected DoubleColumn(String name,
 it.unimi.dsi.fastutil.doubles.DoubleArrayList data)

DoubleColumn

protected DoubleColumn(String name)

Method Details

valueIsMissing

public static boolean valueIsMissing(double value)

getString

public String getString(int row)

Returns a string representation of the value at the given row.

Specified by:

getString in interface Column<Double>

Overrides:

getString in class NumberColumn<DoubleColumn,Double>

Parameters:

row - The index of the row.

Returns:

value as String

size

public int size()

Returns the number of elements in this column, including missing values

Specified by:

size in interface Column<Double>

Specified by:

size in interface NumberFilters

Specified by:

size in interface NumberMapFunctions

clear

public void clear()

Removes all elements TODO: Make this return this column

Specified by:

clear in interface Column<Double>

setMissing

public DoubleColumn setMissing(int index)

Sets the value at index i to the missing-value indicator for this column type, and return this column

Specified by:

setMissing in interface Column<Double>

create

public static DoubleColumn create(String name,
 double... arr)

create

public static DoubleColumn create(String name)

create

public static DoubleColumn create(String name,
 float... arr)

create

public static DoubleColumn create(String name,
 int... arr)

create

public static DoubleColumn create(String name,
 long... arr)

create

public static DoubleColumn create(String name,
 Collection<? extends Number> numberList)

create

public static DoubleColumn create(String name,
 Number[] numbers)

create

public static DoubleColumn create(String name,
 int initialSize)

create

public static DoubleColumn create(String name,
 DoubleStream stream)

createCol

public DoubleColumn createCol(String name,
 int initialSize)

Specified by:

createCol in class NumberColumn<DoubleColumn,Double>

createCol

public DoubleColumn createCol(String name)

Specified by:

createCol in class NumberColumn<DoubleColumn,Double>

get

public Double get(int index)

Returns the value at the given zero-based index

Specified by:

get in interface Column<Double>

where

public DoubleColumn where(Selection selection)

Returns the subset of data in this column included in the given Selection

Specified by:

where in interface Column<Double>

Specified by:

where in interface NumericColumn<Double>

isNotIn

public Selection isNotIn(double... doubles)

isIn

public Selection isIn(double... doubles)

subset

public DoubleColumn subset(int[] rows)

Return a column of the same type containing just those elements whose indexes are included in the given array

Specified by:

subset in interface Column<Double>

Overrides:

subset in class AbstractColumn<DoubleColumn,Double>

unique

public DoubleColumn unique()

Returns a column of the same type containing only the unique values

Specified by:

unique in interface Column<Double>

Returns:

a Column

top

public DoubleColumn top(int n)

Returns the largest ("top") n values in the column TODO(lwhite): Consider whether this should exclude missing

Specified by:

top in class NumberColumn<DoubleColumn,Double>

Parameters:

n - The maximum number of records to return. The actual number will be smaller if n is greater than the number of observations in the column

Returns:

A list, possibly empty, of the largest observations

bottom

public DoubleColumn bottom(int n)

Returns the smallest ("bottom") n values in the column TODO(lwhite): Consider whether this should exclude missing

Specified by:

bottom in class NumberColumn<DoubleColumn,Double>

Parameters:

n - The maximum number of records to return. The actual number will be smaller if n is greater than the number of observations in the column

Returns:

A list, possibly empty, of the smallest n observations

lag

public DoubleColumn lag(int n)

Returns a column of the same type and size as the receiver, containing the receivers values offset by n.

For example if you lag a column containing 2, 3, 4 by 1, you get a column containing NA, 2, 3

Specified by:

lag in interface Column<Double>

Specified by:

lag in interface NumericColumn<Double>

removeMissing

public DoubleColumn removeMissing()

Returns a copy of this column with the missing values removed

Specified by:

removeMissing in interface Column<Double>

append

public DoubleColumn append(float f)

Adds the given float to this column

append

public DoubleColumn append(double d)

Adds the given double to this column

append

public DoubleColumn append(int i)

valueHash

public int valueHash(int rowNumber)

Returns an int suitable as a hash for the value in this column at the given index

Specified by:

valueHash in interface Column<Double>

equals

public boolean equals(int rowNumber1,
 int rowNumber2)

Returns true if the value in this column at rowNumber1 is equal to the value at rowNumber2

Specified by:

equals in interface Column<Double>

append

public DoubleColumn append(Double val)

Appends value to the bottom of this column and return this column

Specified by:

append in interface Column<Double>

append

public DoubleColumn append(Number val)

copy

public DoubleColumn copy()

Returns a deep copy of the receiver

Specified by:

copy in interface Column<Double>

Specified by:

copy in interface NumericColumn<Double>

Returns:

a Column

iterator

public Iterator<Double> iterator()

Specified by:

iterator in interface Iterable<Double>

asDoubleArray

public double[] asDoubleArray()

Description copied from interface: NumericColumn

Specified by:

asDoubleArray in interface NumberMapFunctions

Specified by:

asDoubleArray in interface NumericColumn<Double>

asObjectArray

public Double[] asObjectArray()

Returns an array of objects as appropriate for my type of column

Specified by:

asObjectArray in interface Column<Double>

compare

public int compare(Double o1,
 Double o2)

Specified by:

compare in interface Comparator<Double>

set

public DoubleColumn set(int i,
 Double val)

Sets the value at index row to the given value and return this column

Specified by:

set in interface Column<Double>

set

public DoubleColumn set(int i,
 double val)

set

public DoubleColumn set(DoublePredicate condition,
 NumericColumn<?> other)

Updates this column where values matching the selection are replaced with the corresponding value from the given column

set

public Column<Double> set(int row,
 String stringValue,
 AbstractColumnParser<?> parser)

Sets the value at row to the parsed value of the given String using the given parser and returns this column

Specified by:

set in interface Column<Double>

append

public DoubleColumn append(Column<Double> column)

Appends all the values in the argument to the bottom of this column and return this column

Specified by:

append in interface Column<Double>

append

public DoubleColumn append(Column<Double> column,
 int row)

Appends the value at the given row in the given column to the bottom of this column and return this column

Specified by:

append in interface Column<Double>

set

public DoubleColumn set(int row,
 Column<Double> column,
 int sourceRow)

Sets the value at row to the value at sourceRow in the given column and return this column

Specified by:

set in interface Column<Double>

filter

public DoubleColumn filter(DoublePredicate test)

Returns a new NumberColumn with only those rows satisfying the predicate

Parameters:

test - the predicate

Returns:

a new NumberColumn with only those rows satisfying the predicate

asBytes

public byte[] asBytes(int rowNumber)

Returns the contents of the cell at rowNumber as a byte[].

Specified by:

asBytes in interface Column<Double>

Parameters:

rowNumber - index of the row

Returns:

content as byte[]

asSet

public Set<Double> asSet()

Returns a Set containing all the unique values in this column

Specified by:

asSet in interface Column<Double>

countUnique

public int countUnique()

Returns the count of unique values in this column.

Specified by:

countUnique in interface Column<Double>

Returns:

unique values as int

getDouble

public double getDouble(int row)

Returns a double representation of the number at index

Specified by:

getDouble in interface NumberFilters

Specified by:

getDouble in interface NumberMapFunctions

Specified by:

getDouble in interface NumericColumn<Double>

isMissingValue

public boolean isMissingValue(double value)

isMissing

public boolean isMissing(int rowNumber)

Returns true if the value at rowNumber is missing

Specified by:

isMissing in interface Column<Double>

Specified by:

isMissing in interface NumberMapFunctions

sortAscending

public void sortAscending()

Sorts my values in ascending order

Specified by:

sortAscending in interface Column<Double>

sortDescending

public void sortDescending()

Sorts my values in descending order

Specified by:

sortDescending in interface Column<Double>

appendMissing

public DoubleColumn appendMissing()

Appends a missing value appropriate to the column

Specified by:

appendMissing in interface Column<Double>

appendObj

public DoubleColumn appendObj(Object obj)

Appends the given value to the bottom of this column and return this column

Specified by:

appendObj in interface Column<Double>

appendCell

public DoubleColumn appendCell(String value)

Add one element to the bottom of this column and set its value to the parsed value of the given String. Parsing is type-specific

Specified by:

appendCell in interface Column<Double>

appendCell

public DoubleColumn appendCell(String value,
 AbstractColumnParser<?> parser)

Add one element to the bottom of this column and set its value to the parsed value of the given String, as performed by the given parser

Specified by:

appendCell in interface Column<Double>

getUnformattedString

public String getUnformattedString(int row)

Returns a String representation of the value at index r, without any formatting applied

Specified by:

getUnformattedString in interface Column<Double>

fillWith

public DoubleColumn fillWith(it.unimi.dsi.fastutil.doubles.DoubleIterator iterator)

Specified by:

fillWith in interface NumberFillers<DoubleColumn>

fillWith

public DoubleColumn fillWith(DoubleRangeIterable iterable)

Specified by:

fillWith in interface NumberFillers<DoubleColumn>

fillWith

public DoubleColumn fillWith(DoubleSupplier supplier)

Specified by:

fillWith in interface NumberFillers<DoubleColumn>

fillWith

public DoubleColumn fillWith(double d)

Specified by:

fillWith in interface NumberFillers<DoubleColumn>

asLongColumn

public LongColumn asLongColumn()

Returns a new LongColumn containing a value for each value in this column, truncating if necessary

A narrowing primitive conversion such as this one may lose information about the overall magnitude of a numeric value and may also lose precision and range. Specifically, if the value is too small (a negative value of large magnitude or negative infinity), the result is the smallest representable value of type long.

Similarly, if the value is too large (a positive value of large magnitude or positive infinity), the result is the largest representable value of type long.

Despite the fact that overflow, underflow, or other loss of information may occur, a narrowing primitive conversion never results in a run-time exception.

A missing value in the receiver is converted to a missing value in the result

Specified by:

asLongColumn in interface NumericColumn<Double>

asIntColumn

public IntColumn asIntColumn()

Returns a new IntColumn containing a value for each value in this column, truncating if necessary.

A narrowing primitive conversion such as this one may lose information about the overall magnitude of a numeric value and may also lose precision and range. Specifically, if the value is too small (a negative value of large magnitude or negative infinity), the result is the smallest representable value of type int.

Similarly, if the value is too large (a positive value of large magnitude or positive infinity), the result is the largest representable value of type int.

Despite the fact that overflow, underflow, or other loss of information may occur, a narrowing primitive conversion never results in a run-time exception.

A missing value in the receiver is converted to a missing value in the result

Specified by:

asIntColumn in interface NumericColumn<Double>

asShortColumn

public ShortColumn asShortColumn()

Returns a new ShortColumn containing a value for each value in this column, truncating if necessary.

A narrowing primitive conversion such as this one may lose information about the overall magnitude of a numeric value and may also lose precision and range. Specifically, if the value is too small (a negative value of large magnitude or negative infinity), the result is the smallest representable value of type int.

Similarly, if the value is too large (a positive value of large magnitude or positive infinity), the result is the largest representable value of type short.

Despite the fact that overflow, underflow, or other loss of information may occur, a narrowing primitive conversion never results in a run-time exception.

A missing value in the receiver is converted to a missing value in the result

Specified by:

asShortColumn in interface NumericColumn<Double>

asFloatColumn

public FloatColumn asFloatColumn()

Returns a new FloatColumn containing a value for each value in this column, truncating if necessary.

A narrowing primitive conversion such as this one may lose information about the overall magnitude of a numeric value and may also lose precision and range. Specifically, if the value is too small (a negative value of large magnitude or negative infinity), the result is the smallest representable value of type float.

Similarly, if the value is too large (a positive value of large magnitude or positive infinity), the result is the largest representable value of type float.

Despite the fact that overflow, underflow, or other loss of information may occur, a narrowing primitive conversion never results in a run-time exception.

A missing value in the receiver is converted to a missing value in the result

Specified by:

asFloatColumn in interface NumericColumn<Double>