hydra

Class NumVector

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.Vector

hydra.NumVector

All Implemented Interfaces:

Serializable, Cloneable, Iterable, Collection, List, RandomAccess

public class NumVector
extends Vector
implements Serializable

A Vector subclass with methods for storing representations of ints, longs, and doubles. Has corresponding methods for retrieving instances of same (for example, longAt()) without doing explicit casts. Also implements some statistical functions so that you easily get mean, std deviation, and so forth of a NumVector of data. Not overwhelmingly efficient in terms of either time or space. Running on a JavaSoft VM on my old Sparc, this takes about 900 milliseconds to run the stats on 10k numbers.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.Vector

capacityIncrement, elementCount, elementData

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
NumVector()
NumVector(Collection c)
NumVector(int initialCapacity)
NumVector(int initialCapacity, int capacityIncrement)

Method Summary

Modifier and Type	Method and Description
void	add(double arg) Adds a double to the receiver
void	add(int arg) Adds an int to the receiver
void	add(long arg) Adds a long to the receiver
void	addAll(Vector aVector) Adds the elements of aVector to the receiver
double	doubleAt(int pos) Returns the item at index pos as a double
long	intAt(int pos) Returns the item at index pos as an int
long	longAt(int pos) Returns the item at index pos as a long
static void	main(String[] args) A test routine that creates a NumVector and calculates the stats
double	mean() Returns a double representing he mean of the receiver's contents
String	printStats() Calculates mean, std dev, and so on, then returns the resulting stats as a String.
String	printStatsAsTableRow() Calculates mean, std dev, and so on, then returns the resulting stats as a String in table-row format.
String	printStatsTableHeader() Returns a String for use as a column labels in a table stat printout.
double[]	stats() Calculates mean, std dev, and so on, then returns the resulting stats as an array of doubles.
double	stddev() Returns a double representing the stddev of the receiver's contents
double	sum() Returns a double representing the sum of the receiver's contents

Methods inherited from class java.util.Vector

add, add, addAll, addAll, addElement, capacity, clear, clone, contains, containsAll, copyInto, elementAt, elements, ensureCapacity, equals, firstElement, forEach, get, hashCode, indexOf, indexOf, insertElementAt, isEmpty, iterator, lastElement, lastIndexOf, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeAllElements, removeElement, removeElementAt, removeIf, removeRange, replaceAll, retainAll, set, setElementAt, setSize, size, sort, spliterator, subList, toArray, toArray, toString, trimToSize

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, stream

Constructor Detail

NumVector

public NumVector()

NumVector

public NumVector(Collection c)

NumVector

public NumVector(int initialCapacity)

NumVector

public NumVector(int initialCapacity,
                 int capacityIncrement)

Method Detail

addAll

public void addAll(Vector aVector)

Adds the elements of aVector to the receiver

add

public void add(double arg)

Adds a double to the receiver

Parameters:

arg - the double to be stored

add

public void add(int arg)

Adds an int to the receiver

Parameters:

arg - the int to be stored

add

public void add(long arg)

Adds a long to the receiver

Parameters:

arg - the long to be stored

doubleAt

public double doubleAt(int pos)

Returns the item at index pos as a double

Parameters:

pos - the index of the item to be returned

intAt

public long intAt(int pos)

Returns the item at index pos as an int

Parameters:

pos - the index of the item to be returned

longAt

public long longAt(int pos)

Returns the item at index pos as a long

Parameters:

pos - the index of the item to be returned

mean

public double mean()

Returns a double representing he mean of the receiver's contents

stddev

public double stddev()

Returns a double representing the stddev of the receiver's contents

printStats

public String printStats()

Calculates mean, std dev, and so on, then returns the resulting stats as a String.

printStatsAsTableRow

public String printStatsAsTableRow()

Calculates mean, std dev, and so on, then returns the resulting stats as a String in table-row format.

printStatsTableHeader

public String printStatsTableHeader()

Returns a String for use as a column labels in a table stat printout.

stats

public double[] stats()

Calculates mean, std dev, and so on, then returns the resulting stats as an array of doubles. The format of the array is: [0] data set size [1] standard deviation [2] sum of the data items [3] the max value [4] the min value

sum

public double sum()

Returns a double representing the sum of the receiver's contents

main

public static void main(String[] args)

A test routine that creates a NumVector and calculates the stats