stella.xml
Class OppositionMerit

java.lang.Object
  util.PropertyContainer
      util.PropertyResources
          util.PropertyBundles
              stella.AbstractMerit
                  stella.xml.OppositionMerit

All Implemented Interfaces:

Serializable, Cloneable, Meriting, Initializable, LocalizedSupplying, PropertySupplying, ResourceSupplying

public class OppositionMerit
extends AbstractMerit

A merit calculating its merit from the opposition time of the target. If a program duration is given, half of it is reduced from the opposition date of the object to center opposition at the middle of the program. The merit is modeled with a gaussian function, whose fwhm is given with the KEY_AROUNDDAY key, that points to a duration in days. This merit is only active if the number of successful observations of the target is zero, otherwise one is returned. It is used to start the observation of Doppler imaging targets close to their opposition.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.URLResource

Field Summary

private static double	DEFAROUNDDAY Default value for the priority stretch.
private static double	DEFPROGRAMDAY Default value for the priority impact.
private static String	DEFSOLOPPOSITION Default airmass parameter name.
private static String	DEFTIME Default time parameter name.
static String	KEY_AROUNDDAY The time around oposition when the merit drops to 1/2.
static String	KEY_PROGRAMDAY The key linked to the duration of the program in days.
static String	KEY_SOLOPPOSITION The key pointing to the name of the opposition parameter.
static String	KEY_TIME The key pointing to the current time.

Fields inherited from class util.PropertyBundles

KEY_LOCALECOUNTRY, KEY_LOCALELANGUAGE, KEY_RESOURCEBUNDLES

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, localurl, locate, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_URL, urlset

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

OppositionMerit(Map prop)
Constructs a new opposition merit.

Method Summary

double

getMerit(ParameterClustering set, TargetDefinition target, Collection ignore, long span) Calculates the actual gain using the airmass of the target.

Methods inherited from class stella.AbstractMerit

createMerit, getInitializer, initMerit

Methods inherited from class util.PropertyBundles

clone, getLocalized, getLocalized, getLocalizedString, getLocalizedString, loadResource

Methods inherited from class util.PropertyResources

createFrom, createFrom, createFrom, getApplet, getAsResources, getLocalClassLoader, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, init, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface util.ResourceSupplying

getResource, getResourceAsStream, getResources

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Methods inherited from interface util.Initializable

init

Field Detail

KEY_PROGRAMDAY

public static final String KEY_PROGRAMDAY

The key linked to the duration of the program in days.

See Also:

Constant Field Values

KEY_AROUNDDAY

public static final String KEY_AROUNDDAY

The time around oposition when the merit drops to 1/2.

See Also:

Constant Field Values

KEY_SOLOPPOSITION

public static final String KEY_SOLOPPOSITION

The key pointing to the name of the opposition parameter.

See Also:

Constant Field Values

KEY_TIME

public static final String KEY_TIME

The key pointing to the current time.

See Also:

Constant Field Values

DEFPROGRAMDAY

private static final double DEFPROGRAMDAY

Default value for the priority impact.

See Also:

Constant Field Values

DEFAROUNDDAY

private static final double DEFAROUNDDAY

Default value for the priority stretch.

See Also:

Constant Field Values

DEFSOLOPPOSITION

private static final String DEFSOLOPPOSITION

Default airmass parameter name.

See Also:

Constant Field Values

DEFTIME

private static final String DEFTIME

Default time parameter name.

See Also:

Constant Field Values

Constructor Detail

OppositionMerit

public OppositionMerit(Map prop)

Constructs a new opposition merit. Proper creation should be done using the AbstractMerit.createMerit(java.util.Map) method.

Method Detail

getMerit

public double getMerit(ParameterClustering set,
                       TargetDefinition target,
                       Collection ignore,
                       long span)

Calculates the actual gain using the airmass of the target. The gain is higher if the airmass is low. The steepness of the gain decrease with airmass is governed with the #KEY_STEEPNESS parameter.

Parameters:

set - Current observing conditions.

target - The actual target.

ignore - The list of targetes relevant to the actual target.

span - The relevant time span in ms.