stella.merit

Class AfterTimeMerit

java.lang.Object

util.PropertyContainer

stella.merit.AbstractMerit

stella.merit.AfterTimeMerit

All Implemented Interfaces:

Serializable, Cloneable, EndpointDefining, Meriting, PropertySupplying

public class AfterTimeMerit
extends AbstractMerit
implements EndpointDefining

This merit represents a merit that grows/shrinks after a specified time and dwindles out. It is zero before that day. The merit is fitted with a two-order polynom such has a value of 1 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 double	cpoly To easy evaluation, calculate polynom at construct.
private static String	DEFJD The default name of the time parameter.
static String	KEY_JD The name of the jd parameter.
static String	KEY_JD0 The key linked to the 'flavor' of the merit.
static String	KEY_UNITY The rise-time to the maximum, same unit as the jd.
static String	KEY_ZERO The time down 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
AfterTimeMerit(Map<String,String> prop) Constructs a new after-start merit.

Method Summary

Modifier and Type	Method and Description
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_JD0

public static final String KEY_JD0

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

See Also:

Constant Field Values

KEY_UNITY

public static final String KEY_UNITY

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

See Also:

Constant Field Values

KEY_ZERO

public static final String KEY_ZERO

The time down to zero.

See Also:

Constant Field Values

KEY_JD

public static final String KEY_JD

The name of the jd parameter.

See Also:

Constant Field Values

DEFJD

private static final String DEFJD

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.

cpoly

private final double cpoly

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

Constructor Detail

AfterTimeMerit

public AfterTimeMerit(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 current time is before jd0 or more 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_UNITY 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