stella.merit

Class AfterPickMerit

java.lang.Object

util.PropertyContainer

stella.merit.AbstractMerit

stella.merit.AfterPickMerit

All Implemented Interfaces:

Serializable, Cloneable, EndpointDefining, Meriting, PropertySupplying

Direct Known Subclasses:

ConsecutiveMerit, FollowingProgramMerit, SuccessorCloseMerit, SuccessorMerit

public abstract class AfterPickMerit
extends AbstractMerit
implements EndpointDefining

This merit represents a merit that grows/shrinks after a first successful observation of a target. Until the target has been observed for the first time, the merit is one, indicating its use as a timeslot. The merit is fitted with a two-order polynom such has a value of k at t=t0, from t0 it rises within a time m to its peak value (m may also be negative, then the merit drops as soon as the target was picked). After a time z the merit drops to zero, where it stays (EndpointDefining). This behaviour implies that k is non-negative, m is arbitrary, z is non-negative and z>2m. The polynom used is

    merit(t)=k[(t-t0)²/z(2m-z)+2m(t-t0)/z(z-2m)+1]
 

The definition of t0 and the flavor of the merit is different in its three non-abstract subclasses SuccessorMerit, ConsecutiveMerit, and FollowingProgramMerit. To allow a time-independant merit, set zero to a high value. In particular, setting zero to a value less equal zero renders z to be positive infinitive.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private double	apoly To easy evaluation, calculate polynom at construct.
private double	bpoly To easy evaluation, calculate polynom at construct.
private static double	DEFMAXIMUMDAY The default rise-time to the maximum.
private static double	DEFSCALE The default scale.
private static String	DEFTIME The default name of the time parameter.
static String	KEY_FLAVOR The key linked to the 'flavor' of the merit.
static String	KEY_MAXIMUM The rise-time to the maximum, same unit as the time.
static String	KEY_MAXIMUMDAY The rise-time to the maximum, same unit as the time.
static String	KEY_SCALE The key linked to the scaling factor k of the merit.
static String	KEY_TIME The name of the time parameter.
static String	KEY_ZERO The time down to zero.
static String	KEY_ZERODAY The time down to zero.
private double	m The time to raise tio the maximum.
private double	z The time to drop to zero.

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
AfterPickMerit(Map<String,String> prop) Constructs a new after-start merit.

Method Summary

Modifier and Type	Method and Description
protected abstract double	checkForStartTime(Appointable me, Collection<Appointable> others, GlobalGrouping set) Checks for the starting time.
double	getMerit(GlobalGrouping needtime, Appointable aim, Collection<Appointable> oftargets, long within) Calculates the merit.
boolean	isCompleted(GlobalGrouping set, Appointable aim) Test, if the first successful observation has been done too long in the past.

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

KEY_SCALE

public static final String KEY_SCALE

The key linked to the scaling factor k of the merit.

See Also:

Constant Field Values

KEY_FLAVOR

public static final String KEY_FLAVOR

The key linked to the 'flavor' of the merit. Either zero or one.

See Also:

Constant Field Values

KEY_MAXIMUM

public static final String KEY_MAXIMUM

The rise-time to the maximum, same unit as the time.

See Also:

Constant Field Values

KEY_MAXIMUMDAY

public static final String KEY_MAXIMUMDAY

The rise-time to the maximum, same unit as the time.

See Also:

Constant Field Values

KEY_ZERO

public static final String KEY_ZERO

The time down to zero.

See Also:

Constant Field Values

KEY_ZERODAY

public static final String KEY_ZERODAY

The time down to zero.

See Also:

Constant Field Values

KEY_TIME

public static final String KEY_TIME

The name of the time parameter.

See Also:

Constant Field Values

DEFSCALE

private static final double DEFSCALE

The default scale.

See Also:

Constant Field Values

DEFMAXIMUMDAY

private static final double DEFMAXIMUMDAY

The default rise-time to the maximum.

See Also:

Constant Field Values

DEFTIME

private static final String DEFTIME

The default name of the time parameter.

See Also:

Constant Field Values

apoly

private final double apoly

To easy evaluation, calculate polynom at construct. Quadratic factor.

bpoly

private final double bpoly

To easy evaluation, calculate polynom at construct. Linear factor.

z

private double z

The time to drop to zero.

m

private final double m

The time to raise tio the maximum.

Constructor Detail

AfterPickMerit

public AfterPickMerit(Map<String,String> prop)

Constructs a new after-start merit. The zero-time must be specified.

Method Detail

getMerit

public double getMerit(GlobalGrouping needtime,
                       Appointable aim,
                       Collection<Appointable> oftargets,
                       long within)

Calculates the merit. If the target has never been successfully picked, the entry value is returned. If the first successful pick was longer than KEY_ZERO time in the past, zero is returned. In the intermittant phase return a merit that rises from the scale factor until some KEY_MAXIMUM time is passed, then drops to zero.

Specified by:

getMerit in interface Meriting

Parameters:

needtime - Current observing conditions.

aim - The actual target.

oftargets - All targets, observable or not.

within - The relevant time span in ms.

isCompleted

public boolean isCompleted(GlobalGrouping set,
                           Appointable aim)

Test, if the first successful observation has been done too long in the past.

Specified by:

isCompleted in interface EndpointDefining

checkForStartTime

protected abstract double checkForStartTime(Appointable me,
                                            Collection<Appointable> others,
                                            GlobalGrouping set)

Checks for the starting time. May be depend on this target or even on the list of other targets.