Package trade.invision.indicators.series

Class Series<T>

java.lang.Object

trade.invision.indicators.series.Series<T>

Type Parameters:

T - the immutable type

Direct Known Subclasses:

BarSeries, Indicator.CacheSeries, NumSeries

public class Series<T>
extends Object

Series is a class that provides a simple interface for storing and retrieving values from a series. Values can only be added to this Series, except for the last value, which can be replaced with a new value. When the number of values stored in this Series exceed a configurable maximum upon adding a new value, then values at the beginning of this Series are removed. Values should be of an immutable type. This class is not thread-safe.

Field Summary

Fields

Modifier and Type	Field	Description
protected long	addCallCount	Gets the number of times add(Object, boolean) has been called.
protected long	endIndex	The index of the last value in this Series, which changes due to getMaximumLength().
protected final Num	epsilon	The Num to use as the epsilon in tolerant comparison operations that consumers of this Series may use.
protected final int	maximumLength	The maximum number of values that this Series will store internally in memory.
protected final NumFactory	numFactory	The NumFactory that consumers of this Series may use for creating Nums.
protected long	startIndex	The index of the first value in this Series, which changes due to getMaximumLength().
protected final List<T>	values

Constructor Summary

Constructors

Constructor	Description
Series(int maximumLength)	Calls Series(Collection, int, NumFactory, Num) with initialValues set to null, numFactory set to null, and epsilon set to null.
Series(int maximumLength, @Nullable NumFactory numFactory)	Calls Series(Collection, int, NumFactory, Num) with initialValues set to null and epsilon set to null.
Series(@Nullable Collection<T> initialValues, int maximumLength)	Calls Series(Collection, int, NumFactory, Num) with numFactory set to null and epsilon set to null.
Series(@Nullable Collection<T> initialValues, int maximumLength, @Nullable NumFactory numFactory, @Nullable Num epsilon)	Instantiates a new Series.

Method Summary

Modifier and Type	Method	Description
void	add(T value)	Calls add(Object, boolean) with replaceLast set to false.
void	add(T value, boolean replaceLast)	Adds the given value to this Series.
T	get(long index)	Gets the value at the given index.
long	getAddCallCount()	Gets the number of times add(Object, boolean) has been called.
long	getEndIndex()	The index of the last value in this Series, which changes due to getMaximumLength().
Num	getEpsilon()	The Num to use as the epsilon in tolerant comparison operations that consumers of this Series may use.
T	getFirst()	Calls get(long) with getStartIndex().
T	getLast()	Calls get(long) with getEndIndex().
long	getLength()	Gets the number of values in this Series, which changes due to getMaximumLength().
int	getMaximumLength()	The maximum number of values that this Series will store internally in memory.
NumFactory	getNumFactory()	The NumFactory that consumers of this Series may use for creating Nums.
long	getStartIndex()	The index of the first value in this Series, which changes due to getMaximumLength().
boolean	isEmpty()	Checks if this Series is empty (getLength() is 0).
List<T>	listView()	Returns a read-only view of this Series as a List.
Num	numOf(Number number)	Convenience method for getNumFactory() NumFactory.of(Number).
Num	numOf(String string)	Convenience method for getNumFactory() NumFactory.of(String).
Num	numOf(BigDecimal bigDecimal)	Convenience method for getNumFactory() NumFactory.of(BigDecimal).
Num	numOf(Num num)	Convenience method for getNumFactory() NumFactory.of(Num).
void	replaceLast(T value)	Calls add(Object, boolean) with replaceLast set to true.

Methods inherited from class java.lang.Object

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

Field Details

maximumLength

protected final int maximumLength

The maximum number of values that this Series will store internally in memory. If the number of values stored in this Series exceed this limit upon adding a new value, then the values at the beginning of this Series are removed.

numFactory

protected final NumFactory numFactory

The NumFactory that consumers of this Series may use for creating Nums.

epsilon

protected final Num epsilon

The Num to use as the epsilon in tolerant comparison operations that consumers of this Series may use.

values

protected final List<T> values

startIndex

protected long startIndex

The index of the first value in this Series, which changes due to getMaximumLength(). This will be -1 if isEmpty() is true.

endIndex

protected long endIndex

The index of the last value in this Series, which changes due to getMaximumLength(). This will be -1 if isEmpty() is true.

addCallCount

protected long addCallCount

Gets the number of times add(Object, boolean) has been called. Use to track if this Series may have changed in any way. Number may overflow.

Constructor Details

Series

public Series(int maximumLength)

Calls Series(Collection, int, NumFactory, Num) with initialValues set to null, numFactory set to null, and epsilon set to null.

Series

public Series(@Nullable
 @Nullable Collection<T> initialValues,
 int maximumLength)

Calls Series(Collection, int, NumFactory, Num) with numFactory set to null and epsilon set to null.

Series

public Series(int maximumLength,
 @Nullable
 @Nullable NumFactory numFactory)

Calls Series(Collection, int, NumFactory, Num) with initialValues set to null and epsilon set to null.

Series

public Series(@Nullable
 @Nullable Collection<T> initialValues,
 int maximumLength,
 @Nullable
 @Nullable NumFactory numFactory,
 @Nullable
 @Nullable Num epsilon)

Instantiates a new Series.

Parameters:

initialValues - the initial Collection of values, or null for no initial values

maximumLength - the getMaximumLength()

numFactory - the getNumFactory(), or null for DecimalNum.decimalNum64Factory()

epsilon - the getEpsilon(), or null for NumFactory.zero()

Method Details

replaceLast

public void replaceLast(T value)

Calls add(Object, boolean) with replaceLast set to true.

add

public void add(T value)

Calls add(Object, boolean) with replaceLast set to false.

add

public void add(T value,
 boolean replaceLast)

Adds the given value to this Series.

Parameters:

value - the value

replaceLast - true to replace the last value in this Series, false to add the value to the end of this Series

get

public T get(long index)

Gets the value at the given index. If the given index is less than getStartIndex(), then getStartIndex() is used.

Parameters:

index - the index

Returns:

the Series value

Throws:

IndexOutOfBoundsException - thrown if the index is outside the range of this Series

getFirst

public T getFirst()

Calls get(long) with getStartIndex().

Returns:

the first value in this Series

getLast

public T getLast()

Calls get(long) with getEndIndex().

Returns:

the last value in this Series

getLength

public long getLength()

Gets the number of values in this Series, which changes due to getMaximumLength().

Returns:

the length of this Series

isEmpty

public boolean isEmpty()

Checks if this Series is empty (getLength() is 0).

Returns:

true if empty, false otherwise

listView

public List<T> listView()

Returns a read-only view of this Series as a List.

Returns:

the List view

numOf

public Num numOf(Number number)

Convenience method for getNumFactory() NumFactory.of(Number).

numOf

public Num numOf(BigDecimal bigDecimal)

Convenience method for getNumFactory() NumFactory.of(BigDecimal).

numOf

public Num numOf(String string)

Convenience method for getNumFactory() NumFactory.of(String).

numOf

public Num numOf(Num num)

Convenience method for getNumFactory() NumFactory.of(Num).

getMaximumLength

public int getMaximumLength()

The maximum number of values that this Series will store internally in memory. If the number of values stored in this Series exceed this limit upon adding a new value, then the values at the beginning of this Series are removed.

getNumFactory

public NumFactory getNumFactory()

The NumFactory that consumers of this Series may use for creating Nums.

getEpsilon

public Num getEpsilon()

The Num to use as the epsilon in tolerant comparison operations that consumers of this Series may use.

getStartIndex

public long getStartIndex()

The index of the first value in this Series, which changes due to getMaximumLength(). This will be -1 if isEmpty() is true.

getEndIndex

public long getEndIndex()

The index of the last value in this Series, which changes due to getMaximumLength(). This will be -1 if isEmpty() is true.

getAddCallCount

public long getAddCallCount()

Gets the number of times add(Object, boolean) has been called. Use to track if this Series may have changed in any way. Number may overflow.