Package org.apache.commons.statistics.descriptive

Class LongStatistics.Builder

java.lang.Object

org.apache.commons.statistics.descriptive.LongStatistics.Builder

Enclosing class:

LongStatistics

public static final class LongStatistics.Builder
extends java.lang.Object

A builder for LongStatistics.

Field Summary

Fields

Modifier and Type	Field	Description
private StatisticsConfiguration	config	Configuration options for computation of statistics.
private RangeFunction<long[],LongMax>	max	The LongMax constructor.
private RangeFunction<long[],LongMin>	min	The LongMin constructor.
private RangeFunction<long[],FirstMoment>	moment	The moment constructor.
private int	momentOrder	The order of the moment.
private static long[]	NO_VALUES	An empty double array.
private RangeFunction<long[],Product>	product	The Product constructor.
private RangeFunction<long[],LongSum>	sum	The LongSum constructor.
private RangeFunction<long[],SumOfLogs>	sumOfLogs	The SumOfLogs constructor.
private RangeFunction<long[],LongSumOfSquares>	sumOfSquares	The LongSumOfSquares constructor.

Constructor Summary

Constructors

Constructor	Description
Builder()	Create an instance.

Method Summary

Modifier and Type	Method	Description
(package private) LongStatistics.Builder	add(Statistic statistic)	Add the statistic to the statistics to compute.
LongStatistics	build()	Builds a LongStatistics instance.
LongStatistics	build(long... values)	Builds a LongStatistics instance using the input values.
LongStatistics	build(long[] values, int from, int to)	Builds a LongStatistics instance using the specified range of values.
private LongStatistics	create(long[] values, int from, int to)	Builds a LongStatistics instance using the input values.
private static <S,T> T	create(RangeFunction<S,T> constructor, S values, int from, int to)	Creates the object from the values.
private void	createMoment(int order)	Creates the moment constructor for the specified order, e.g.
LongStatistics.Builder	setConfiguration(StatisticsConfiguration v)	Sets the statistics configuration options for computation of statistics.

Methods inherited from class java.lang.Object

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

Field Detail

NO_VALUES

private static final long[] NO_VALUES

An empty double array.

min

private RangeFunction<long[],LongMin> min

The LongMin constructor.

max

private RangeFunction<long[],LongMax> max

The LongMax constructor.

moment

private RangeFunction<long[],FirstMoment> moment

The moment constructor. May return any instance of FirstMoment.

sum

private RangeFunction<long[],LongSum> sum

The LongSum constructor.

product

private RangeFunction<long[],Product> product

The Product constructor.

sumOfSquares

private RangeFunction<long[],LongSumOfSquares> sumOfSquares

The LongSumOfSquares constructor.

sumOfLogs

private RangeFunction<long[],SumOfLogs> sumOfLogs

The SumOfLogs constructor.

momentOrder

private int momentOrder

The order of the moment. It corresponds to the power computed by the FirstMoment instance constructed by moment. This should only be increased from the default of zero (corresponding to no moment computation).

config

private StatisticsConfiguration config

Configuration options for computation of statistics.

Constructor Detail

Builder

Builder()

Create an instance.

Method Detail

add

LongStatistics.Builder add(Statistic statistic)

Add the statistic to the statistics to compute.

Parameters:

statistic - Statistic to compute.

Returns:

this instance

createMoment

private void createMoment(int order)

Creates the moment constructor for the specified order, e.g. order=3 is sum of cubed deviations.

Parameters:

order - Order.

setConfiguration

public LongStatistics.Builder setConfiguration(StatisticsConfiguration v)

Sets the statistics configuration options for computation of statistics.

Parameters:

v - Value.

Returns:

the builder

Throws:

java.lang.NullPointerException - if the value is null

build

public LongStatistics build()

Builds a LongStatistics instance.

Returns:

LongStatistics instance.

build

public LongStatistics build(long... values)

Builds a LongStatistics instance using the input values.

Note: LongStatistics computed using accept may be different from this instance.

Parameters:

values - Values.

Returns:

LongStatistics instance.

build

public LongStatistics build(long[] values,
                            int from,
                            int to)

Builds a LongStatistics instance using the specified range of values.

Note: LongStatistics computed using accept may be different from this instance.

Parameters:

values - Values.

from - Inclusive start of the range.

to - Exclusive end of the range.

Returns:

LongStatistics instance.

Throws:

java.lang.IndexOutOfBoundsException - if the sub-range is out of bounds

Since:

1.2

create

private LongStatistics create(long[] values,
                              int from,
                              int to)

Builds a LongStatistics instance using the input values.

Note: LongStatistics computed using accept may be different from this instance.

Warning: No range checks are performed.

Parameters:

values - Values.

from - Inclusive start of the range.

to - Exclusive end of the range.

Returns:

LongStatistics instance.

create

private static <S,T> T create(RangeFunction<S,T> constructor,
                                    S values,
                                    int from,
                                    int to)

Creates the object from the values.

Type Parameters:

S - value type

T - object type

Parameters:

constructor - Constructor.

values - Values

from - Inclusive start of the range.

to - Exclusive end of the range.

Returns:

the instance