globals.rmi

Class MomentsTrigger

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

globals.trigger.AbstractTrigger

globals.trigger.SimpleTrigger

globals.rmi.MomentsTrigger

All Implemented Interfaces:

Parameter, ParameterDepending, Trigger, Cloneable, ExitCleaning, Initializable, PropertySupplying, Reloadable, ResourceSupplying, Triggering

public class MomentsTrigger
extends SimpleTrigger
implements ParameterDepending

A moment trigger changes its value depending on a fits moments list provided to it. The general action is that for each moment (one for average, two for standard deviation, from three on central normalized moment), an allowed range is given, stating central value and half-width of allowed range. A negative half-range means that this moment should be ignored, comparison stops when there are no more moments or all required moments have been checked. This parameter is fail-fast: As soon as a criterion is violated, false is returned without checking further.

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private static String	DEFFITSMOMENTS The default lux value name.
static String	KEY_FITSMOMENTS This key links to the name of the fitsmoments parameter.
static String	KEY_MOMENTSLIST This key links to the name of the fitsmoments parameter.
private FitsMoments	moments The parameter that holds the fits central moments, local.
(package private) List<Vector2D[]>	range For convenience, we parse the ranges on init.

Fields inherited from class globals.trigger.SimpleTrigger

KEY_INITBOOLEAN

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 util.PropertySupplying

CONFIG, KEY_CLASS

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Constructor Summary

Constructors

Constructor and Description
MomentsTrigger(Map<String,String> prop) Defaults the fits moment parameter name, but spares the moments ranges.

Method Summary

Modifier and Type	Method and Description
private Boolean	checkMoments(List<CentralMoments> cm) We scan our properties for moment ranges and return true, if we are in the correct range or false if we are not.
Boolean	getTrigger() We get the trigger by scanning the list of central moments.
void	init() On init, we create the table for calculating the times.
private static List<Vector2D[]>	parseRange(String dt) We parse a double tokenized list into a list of vector2D arrays.
private static Boolean	rangeCheck(List<CentralMoments> cm, List<Vector2D[]> edge) We check if the central moments of all extensions are within the desired range as specified in the properties.
void	registerParameter(Parameter p) We register a parameter that delivers sky brightness.

Methods inherited from class globals.trigger.SimpleTrigger

getLastToggleTime, rescanned, setTrigger

Methods inherited from class globals.trigger.AbstractTrigger

get, getElapsedToggleTime, isTrue, set, toggleTrigger

Methods inherited from class globals.parameter.AbstractParameter

createParameter, delivers, exit, getFormatted, getFormatted, getName, getPreserveFile, getString, getString, overrideDefaultName, register, 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 util.Reloadable

reload

Methods inherited from interface globals.Parameter

getFormatted, getName, getString

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

Field Detail

KEY_FITSMOMENTS

public static final String KEY_FITSMOMENTS

This key links to the name of the fitsmoments parameter.

See Also:

Constant Field Values

KEY_MOMENTSLIST

public static final String KEY_MOMENTSLIST

This key links to the name of the fitsmoments parameter.

See Also:

Constant Field Values

DEFFITSMOMENTS

private static final String DEFFITSMOMENTS

The default lux value name.

See Also:

Constant Field Values

moments

private FitsMoments moments

The parameter that holds the fits central moments, local.

range

List<Vector2D[]> range

For convenience, we parse the ranges on init.

Constructor Detail

MomentsTrigger

public MomentsTrigger(Map<String,String> prop)

Defaults the fits moment parameter name, but spares the moments ranges.

Method Detail

init

public void init()
          throws InitException

On init, we create the table for calculating the times.

Specified by:

init in interface Initializable

Overrides:

init in class SimpleTrigger

Throws:

InitException

registerParameter

public void registerParameter(Parameter p)

We register a parameter that delivers sky brightness. Preferrably it links directly to a brightness sensor, if none is present, a solz-dependancy can be used.

Specified by:

registerParameter in interface ParameterDepending

getTrigger

public Boolean getTrigger()

We get the trigger by scanning the list of central moments. If a change has been noted, we set the super trigger.

Specified by:

getTrigger in interface Triggering

Overrides:

getTrigger in class SimpleTrigger

checkMoments

private Boolean checkMoments(List<CentralMoments> cm)

We scan our properties for moment ranges and return true, if we are in the correct range or false if we are not. Never returns null, may not be called with null.

parseRange

private static List<Vector2D[]> parseRange(String dt)

We parse a double tokenized list into a list of vector2D arrays. The size of the inner, comma-separated list defines the dimension of the array, the length of the list returned is the length of the outer, semi-solon tokenizable list. The inner list represents the number of extension (1 in the standard case), while the out list enumerates the moments order, starting with average, followed by standard deviation

rangeCheck

private static Boolean rangeCheck(List<CentralMoments> cm,
                                  List<Vector2D[]> edge)

We check if the central moments of all extensions are within the desired range as specified in the properties.