stella.globals

Class StatisticValue

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

globals.value.AbstractValue

stella.globals.StatisticValue

All Implemented Interfaces:

Parameter, Value, Cloneable, ErrorDependingParameter, ExitCleaning, Initializable, PropertySupplying, ResourceSupplying

Direct Known Subclasses:

SensorStatistic, StatisticValue.Average, StatisticValue.Maximum, StatisticValue.Median, StatisticValue.Minimum

public abstract class StatisticValue
extends AbstractValue
implements ErrorDependingParameter

A value that is reset at receiving a certain error-event, cumulates numbers with its set method and returns statistical values on get queris. Note that this class is abstract, concrete subclasses may use one of the getAverage(), getMinimum(), etc. methods to retrieve a single value.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StatisticValue.Average Useable class returning the average.
static class	StatisticValue.Maximum Useable class returning the average.
static class	StatisticValue.Median Useable class returning the median.
static class	StatisticValue.Minimum Useable class returning the average.

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private static int	DEFTHRESHOLD The minimum length of the shelf to return valid values.
static String	KEY_ERROR The class name of the error that serves as a reset-trigger.
static String	KEY_THRESHOLD The minimum length of the shelf to return valid values.
private List<Number>	numbers A list of numbers gathered from the last reset.
private Statistic	stat The statisitcs object used to calculate values.

Fields inherited from class globals.parameter.AbstractParameter

KEY_FORMAT, KEY_NAME, KEY_PRESERVE, UNKNOWN

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface stella.ErrorDependingParameter

NAMING_EXTENSION

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StatisticValue(Map<String,String> prop) Constructs a new snapshot parameter.

Method Summary

Modifier and Type	Method and Description
private static Statistic	createStatistic(List nums) Converts my number list into a ready-to-use statistics object.
protected Number	getAverage() From all accumulated numbers, get the average.
Object	getForError(ErrorEvent err) Checks if the error received is of the type specified in the KEY_ERROR property.
protected Number	getMaximum() From all accumulated numbers, get the maximum.
protected Number	getMedian() From all accumulated numbers, get the median.
protected Number	getMinimum() From all accumulated numbers, get the maximum.
protected Number	getSigma() From all accumulated numbers, get the standard eviation.
boolean	isValid() Returns true if we have at least KEY_THRESHOLD values in our list.
void	registerError(ErrorEvent err) Registers the error.
Number	setValue(Number accu) Accumulates a number to the statistics.

Methods inherited from class globals.value.AbstractValue

get, set

Methods inherited from class globals.parameter.AbstractParameter

createParameter, delivers, exit, getFormatted, getFormatted, getName, getPreserveFile, getString, getString, init, overrideDefaultName, register, rescanned, setName, toString

Methods inherited from class util.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, parseObject, reload, removeProperty, requires, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object

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

Methods inherited from interface globals.Parameter

get, getFormatted, getName, getString, set

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Methods inherited from interface util.Initializable

init

Methods inherited from interface globals.Value

getValue

Field Detail

KEY_ERROR

public static final String KEY_ERROR

The class name of the error that serves as a reset-trigger.

See Also:

Constant Field Values

KEY_THRESHOLD

public static final String KEY_THRESHOLD

The minimum length of the shelf to return valid values.

See Also:

Constant Field Values

DEFTHRESHOLD

private static final int DEFTHRESHOLD

The minimum length of the shelf to return valid values.

See Also:

Constant Field Values

numbers

private final List<Number> numbers

A list of numbers gathered from the last reset.

stat

private transient Statistic stat

The statisitcs object used to calculate values.

Constructor Detail

StatisticValue

protected StatisticValue(Map<String,String> prop)

Constructs a new snapshot parameter.

Method Detail

getForError

public Object getForError(ErrorEvent err)

Checks if the error received is of the type specified in the KEY_ERROR property. If so, the current value is returned via the Value.getValue() method.

Specified by:

getForError in interface ErrorDependingParameter

registerError

public void registerError(ErrorEvent err)

Registers the error. If the error is recognized, i.e. it matches the name in the KEY_ERROR property, the statistics is reset.

Specified by:

registerError in interface ErrorDependingParameter

setValue

public Number setValue(Number accu)

Accumulates a number to the statistics. Returns the number added at the last call to this method or null. Internally, this method clears any left-over statistics.

Specified by:

setValue in interface Value

getAverage

protected Number getAverage()

From all accumulated numbers, get the average.

getMedian

protected Number getMedian()

From all accumulated numbers, get the median. Might be a time-consuming operation.

getMaximum

protected Number getMaximum()

From all accumulated numbers, get the maximum.

getMinimum

protected Number getMinimum()

From all accumulated numbers, get the maximum.

getSigma

protected Number getSigma()

From all accumulated numbers, get the standard eviation.

isValid

public boolean isValid()

Returns true if we have at least KEY_THRESHOLD values in our list.

createStatistic

private static final Statistic createStatistic(List nums)

Converts my number list into a ready-to-use statistics object.