stella.merit

Class RandomSpacedMerit

java.lang.Object

util.PropertyContainer

stella.merit.AbstractMerit

stella.merit.RandomSpacedMerit

All Implemented Interfaces:

Serializable, Cloneable, Meriting, PropertySupplying

public class RandomSpacedMerit
extends AbstractMerit

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static double	DEFSTEEPNESS Default value for the period.
private static String	DEFTIME Default time parameter name.
private static double	DEFZEROFRACTION Default no picking half of the period.
static String	KEY_MAXDAYS The key linked to the period of the observations.
static String	KEY_MINDAYS The key linked to the period of the observations.
static String	KEY_STEEPNESS The key linked to the steepness of the aim time influence.
static String	KEY_TIME The key pointing to the name of the time parameter.
static String	KEY_ZEROFRACTION The key linked to the fraction of the period the merit stay zero.
private static long	serialVersionUID

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

Constructors

Constructor and Description
RandomSpacedMerit(Map<String,String> prop) Constructs an evenly spaced merit.

Method Summary

Modifier and Type	Method and Description
double	getMerit(GlobalGrouping set, Appointable target, Collection ignore, long within) Calculates the actual time slot merit.
protected Date	getT0(GlobalGrouping set, Appointable target) Returns the date of the relevant last observation.
protected Date	getT0FromSubmitted(GlobalGrouping set, Date submit)

Methods inherited from class stella.merit.AbstractMerit

createMerit, getInitializer, initMerit

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, clone, 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, initProperties, isNew, parseObject, parseObject, reload, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties, toString

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

KEY_MINDAYS

public static final String KEY_MINDAYS

The key linked to the period of the observations.

See Also:

Constant Field Values

KEY_MAXDAYS

public static final String KEY_MAXDAYS

The key linked to the period of the observations.

See Also:

Constant Field Values

KEY_ZEROFRACTION

public static final String KEY_ZEROFRACTION

The key linked to the fraction of the period the merit stay zero.

See Also:

Constant Field Values

KEY_STEEPNESS

public static final String KEY_STEEPNESS

The key linked to the steepness of the aim time influence.

See Also:

Constant Field Values

KEY_TIME

public static final String KEY_TIME

The key pointing to the name of the time parameter.

See Also:

Constant Field Values

DEFSTEEPNESS

private static final double DEFSTEEPNESS

Default value for the period. One day.

See Also:

Constant Field Values

DEFZEROFRACTION

private static final double DEFZEROFRACTION

Default no picking half of the period.

See Also:

Constant Field Values

DEFTIME

private static final String DEFTIME

Default time parameter name.

See Also:

Constant Field Values

Constructor Detail

RandomSpacedMerit

public RandomSpacedMerit(Map<String,String> prop)

Constructs an evenly spaced merit. Only non-abstract subclasses of this merit may be used.

Method Detail

getT0

protected Date getT0(GlobalGrouping set,
                     Appointable target)

Returns the date of the relevant last observation. In a fixed-delay scheme this is simply the date of the last obsevation.

Returns:

null if the target is not history aware or was never observed.

getMerit

public double getMerit(GlobalGrouping set,
                       Appointable target,
                       Collection ignore,
                       long within)

Calculates the actual time slot merit. The current time minus the flavour-depending zero time is weighed to the required period (in ms). Depending on the time offset and the KEY_STEEPNESS of the merit, a value between zero and positive infinity is returned. The value returned one period after t0 is always one.
This merit is strictly increasing, thus we use the end time for evaluation.

Parameters:

set - Current observing conditions.

target - The actual target.

ignore - All targets, observable or not.

within - The relevant time span in ms.

getT0FromSubmitted

protected Date getT0FromSubmitted(GlobalGrouping set,
                                  Date submit)