stella.merit

Class PickRaiseMerit

java.lang.Object

util.PropertyContainer

stella.merit.AbstractMerit

stella.merit.PickRaiseMerit

All Implemented Interfaces:

Serializable, Cloneable, EndpointDefining, Meriting, PropertySupplying

public class PickRaiseMerit
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 n=1, from n=1 it rises within m observations to its peak value (m may also be negative, then the merit drops as soon as the target was picked). After a maximum observations 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[n²/z(2m-z)+2mċn/z(z-2m)+1]
 

See Also:

AfterPickMerit, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private double	apoly To easy evaluation, calculate polynomial at construct.
private double	bpoly To easy evaluation, calculate polynomial at construct.
private static int	DEFPICKMAXIMUM The default rise-time to the maximum.
private static double	DEFSCALE The default scale.
static String	KEY_PICKMAXIMUM The number of picks until the merit reaches its maximum.
static String	KEY_PICKZERO The number of picks when the merit drops down to zero.
static String	KEY_SCALE The key linked to the maximum scaling factor k of the merit.
private double	scaling To easy evaluation, calculate polynomial at construct.

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
PickRaiseMerit(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 oftargets, long ignore) 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 maximum scaling factor k of the merit.

See Also:

Constant Field Values

KEY_PICKMAXIMUM

public static final String KEY_PICKMAXIMUM

The number of picks until the merit reaches its maximum.

See Also:

Constant Field Values

KEY_PICKZERO

public static final String KEY_PICKZERO

The number of picks when the merit drops down to zero.

See Also:

Constant Field Values

DEFSCALE

private static final double DEFSCALE

The default scale.

See Also:

Constant Field Values

DEFPICKMAXIMUM

private static final int DEFPICKMAXIMUM

The default rise-time to the maximum.

See Also:

Constant Field Values

apoly

private final double apoly

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

bpoly

private final double bpoly

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

scaling

private final double scaling

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

Constructor Detail

PickRaiseMerit

public PickRaiseMerit(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 oftargets,
                       long ignore)

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_PICKZERO time in the past, zero is returned. In the intermittant phase return a merit that rises from the scale factor until some KEY_PICKMAXIMUM time is passed, then drops to zero.
This merit is not time dependent, thus the time span is ignored.

Specified by:

getMerit in interface Meriting

Parameters:

needtime - Current observing conditions.

aim - The actual target.

oftargets - All targets, observable or not.

ignore - 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