stella.merit

Class ChunkTimeMerit

java.lang.Object

util.PropertyContainer

stella.merit.AbstractMerit

stella.merit.ChunkTimeMerit

All Implemented Interfaces:

Serializable, Cloneable, EndpointDefining, Meriting, PropertySupplying

public class ChunkTimeMerit
extends AbstractMerit
implements EndpointDefining

This merit represents a merit that allows putting together chunks of observing periods by featuring a list of block-start JDs and a length parameter (days), either given as a single value or as a list of equal length than jd0. The rise and drop of the merit from zero to one is modelled with a arctan such that the rise time defines the amount of days it takes to rise from 0.05 to 0.95, i.e., 90% of the merit change. This rise time is either defined as a true day span or it might be set as a fraction of the according block length. It defaults to a fraction of 10% of the length.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static double	DEFFRACTION Default fraction rise.
private static String	DEFJD The default name of the time parameter.
private List<Double>	jd0 The list of start JDs of the blocks, ordered for jd.
static String	KEY_FRACTION If no rise given, we take a fraction of the length.
static String	KEY_JD The name of the jd parameter.
static String	KEY_JD0 The key linked to the list of starting jds.
static String	KEY_LENGTH A single length in day or a comma-separated list of equal size as jd0
static String	KEY_RISE Rise time of the merit in days.
private List<Double>	length The list of length of the blocks.
static double	MINRISE For the definition of the rise period.
private List<Double>	sigma The calculated sigma parameters of each block.

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
ChunkTimeMerit(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 within) Calculates the merit.
private static double	getMeritInBlock(double jd, double jd0, double duration, double sigma)
boolean	isCompleted(GlobalGrouping set, Appointable aim) Test, if the last block is over by more than the rise time.

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

MINRISE

public static final double MINRISE

For the definition of the rise period.

See Also:

Constant Field Values

KEY_JD0

public static final String KEY_JD0

The key linked to the list of starting jds.

See Also:

Constant Field Values

KEY_LENGTH

public static final String KEY_LENGTH

A single length in day or a comma-separated list of equal size as jd0

See Also:

Constant Field Values

KEY_RISE

public static final String KEY_RISE

Rise time of the merit in days.

See Also:

Constant Field Values

KEY_FRACTION

public static final String KEY_FRACTION

If no rise given, we take a fraction of the length. Defaults to 0.1.

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

DEFFRACTION

private static final double DEFFRACTION

Default fraction rise.

See Also:

Constant Field Values

jd0

private final List<Double> jd0

The list of start JDs of the blocks, ordered for jd.

length

private final List<Double> length

The list of length of the blocks.

sigma

private final List<Double> sigma

The calculated sigma parameters of each block.

Constructor Detail

ChunkTimeMerit

public ChunkTimeMerit(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 within)

Calculates the merit. We return the merit in the closest block.

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.

getMeritInBlock

private static double getMeritInBlock(double jd,
                                      double jd0,
                                      double duration,
                                      double sigma)

isCompleted

public boolean isCompleted(GlobalGrouping set,
                           Appointable aim)

Test, if the last block is over by more than the rise time.

Specified by:

isCompleted in interface EndpointDefining