globals.value

Class AirmassTarget

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

stella.globals.AbstractTargetParameter

stella.globals.AbstractTargetValue

globals.value.AirmassTarget

All Implemented Interfaces:

Decreasing, Increasing, Parameter, ParameterDepending, TargetDependingParameter, Value, Cloneable, TargetDependDecreasing, TargetDependIncreasing, TargetDependingValue, TargetDepending, ExitCleaning, Initializable, PropertySupplying, Reloadable, ResourceSupplying

public class AirmassTarget
extends AbstractTargetValue
implements TargetDependIncreasing, TargetDependDecreasing, ParameterDepending, Reloadable

Represents the airmass to the actual target. Follows the general Value contract. Therefore, three other globals must be registered, TauTarget, DecTarget, and Latitude.

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private static String	DEFALTTARGET The default name of the sidereal parameter to use.
private static double	DEFMINHEIGHT The default validity border.
static String	DEFNAME The default name of this value.
private static DecimalFormat	df The formatter for the airmass.
private TargetDependingParameter	height The actual height of the target, degrees.
static String	KEY_ALTTARGET The name of the latitude to use.
static String	KEY_MINHEIGHT The height until which the airmass formular is correct.

Fields inherited from class stella.globals.AbstractTargetParameter

KEY_INDEX

Fields inherited from class globals.parameter.AbstractParameter

KEY_FORMAT, KEY_NAME, KEY_PRESERVE, UNKNOWN

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Constructor Summary

Constructors

Constructor and Description
AirmassTarget(Map info) Constructs a new airmass target object.

Method Summary

Modifier and Type	Method and Description
private static Double	calculate(Number h, double minheight) Calculates the airmass using the hour angle and the declination of the target.
static double	getAirmassTarget(double h) Calculates the airmass with the default minimum height.
Long	getAscendTime(Number until) Returns the remaining time in ms.
Long	getAscendTimeFor(TargetDefinition target, Number until) Returns the remaining time in ms.
Long	getDescendTime(Number until) Returns the remaining time in ms.
Long	getDescendTimeFor(TargetDefinition target, Number until) Returns the remaining time in ms.
Number	getForTarget(TargetDefinition star) Gets the declination of the target star.
static double	getHeight(double z) Returns the height from the airmass.
Number	getValue() Returns the target's actual airmass, wrapped into a Double.
void	registerParameter(Parameter what) Registers the required additional globals for the Z target.
void	registerTarget(TargetDefinition star) Registers a star to this parameter.
double	rescanned(String key, String old, String newval) It is not possible to rescan the target height parameter name.
Number	setValue(Number val) Sets the airmass of the actual target.

Methods inherited from class stella.globals.AbstractTargetValue

get, set

Methods inherited from class stella.globals.AbstractTargetParameter

getAsStar, getConstant, getFormattedFor, getSetup

Methods inherited from class globals.parameter.AbstractParameter

createParameter, delivers, exit, getFormatted, getFormatted, getName, getPreserveFile, getString, getString, init, overrideDefaultName, register, setName, toString

Methods inherited from class util.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface util.Reloadable

reload

Methods inherited from interface globals.TargetDependingParameter

getFormattedFor

Methods inherited from interface globals.Parameter

getFormatted, getName, getString

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_ALTTARGET

public static final String KEY_ALTTARGET

The name of the latitude to use.

See Also:

Constant Field Values

KEY_MINHEIGHT

public static final String KEY_MINHEIGHT

The height until which the airmass formular is correct.

See Also:

Constant Field Values

DEFNAME

public static final String DEFNAME

The default name of this value.

See Also:

Constant Field Values

DEFMINHEIGHT

private static final double DEFMINHEIGHT

The default validity border.

See Also:

Constant Field Values

DEFALTTARGET

private static final String DEFALTTARGET

The default name of the sidereal parameter to use.

See Also:

Constant Field Values

height

private TargetDependingParameter height

The actual height of the target, degrees.

df

private static final DecimalFormat df

The formatter for the airmass.

Constructor Detail

AirmassTarget

public AirmassTarget(Map info)

Constructs a new airmass target object. Note that this global can only function correctly after the tau and dec of the target and the teide latitude have been registered.

Method Detail

rescanned

public double rescanned(String key,
                        String old,
                        String newval)

It is not possible to rescan the target height parameter name. All other return 1.

Specified by:

rescanned in interface Reloadable

Overrides:

rescanned in class AbstractParameter

setValue

public Number setValue(Number val)
                throws UnsupportedOperationException

Sets the airmass of the actual target. This is a read-only variable, therefore this method throws an UnsupportedOperationException.

Specified by:

setValue in interface Value

Throws:

UnsupportedOperationException

getForTarget

public Number getForTarget(TargetDefinition star)

Gets the declination of the target star.

Specified by:

getForTarget in interface TargetDependingParameter

Specified by:

getForTarget in interface TargetDependingValue

Returns:

A Double holding the target star's declination.

getValue

public Number getValue()

Returns the target's actual airmass, wrapped into a Double. Note that this method returns null if either of the globals denoting the tau, dec of the target or the latitude is missing.

Specified by:

getValue in interface Value

getAirmassTarget

public static final double getAirmassTarget(double h)

Calculates the airmass with the default minimum height. This method is public to allow outsiders to use it.

calculate

private static Double calculate(Number h,
                                double minheight)

Calculates the airmass using the hour angle and the declination of the target. The latitude of the site must be registered first. If the height of the target is below KEY_MINHEIGHT, Double.POSITIVE_INFINITY is returned.

Formula is from world of astronomy. 29.9.2015: Formula from Young, A.T., Methods of Experimental Physics 12A (New York Academic Press), Chap. 3, p. 123, 1974

registerParameter

public void registerParameter(Parameter what)

Registers the required additional globals for the Z target. For this particular object, target dec and tau and teide latitude are required. Note that the argumental global is checked for being of instance types of TauTarget, DecTarget or Latitude, rather than querrying for the global name.

Specified by:

registerParameter in interface ParameterDepending

registerTarget

public void registerTarget(TargetDefinition star)

Registers a star to this parameter. The target definition is directly passed to the height reference of this parameter. Note that this will set the target in the additional parameter, too.

Specified by:

registerTarget in interface TargetDepending

getAscendTime

public Long getAscendTime(Number until)

Returns the remaining time in ms. The ascend time is defined as the next time the airmass reaches the target value and is still increasing. This will be when the height of the target is decreasing, i.e. in the western hemisphere. We therefore pass the target height, deduced from the taret airmass, to the height's descend time.

Specified by:

getAscendTime in interface Increasing

Parameters:

until - The value in the future.

Returns:

A double carrying the remaining time or null if the time cannot be calculated.

getDescendTime

public Long getDescendTime(Number until)

Returns the remaining time in ms. The ascend time is defined as the next time the airmass reaches the target value and is still decreasing. This will be when the height of the target is increasing, i.e. in the eastern hemisphere. We therefore pass the target height, deduced from the taret airmass, to the height's ascend time.

Specified by:

getDescendTime in interface Decreasing

Parameters:

until - The value in the future.

Returns:

A double carrying the remaining time or null if the time cannot be calculated.

getAscendTimeFor

public Long getAscendTimeFor(TargetDefinition target,
                             Number until)

Returns the remaining time in ms. The ascend time is defined as the next time the airmass reaches the target value and is still increasing. This will be when the height of the target is decreasing, i.e. in the western hemisphere. We therefore pass the target height, deduced from the taret airmass, to the height's descend time.

Specified by:

getAscendTimeFor in interface TargetDependIncreasing

until - The value in the future.

Returns:

A double carrying the remaining time or null if the time cannot be calculated.

getDescendTimeFor

public Long getDescendTimeFor(TargetDefinition target,
                              Number until)

Returns the remaining time in ms. The ascend time is defined as the next time the airmass reaches the target value and is still decreasing. This will be when the height of the target is increasing, i.e. in the eastern hemisphere. We therefore pass the target height, deduced from the taret airmass, to the height's ascend time.

Specified by:

getDescendTimeFor in interface TargetDependDecreasing

until - The value in the future.

Returns:

A double carrying the remaining time or null if the time cannot be calculated.

getHeight

public static double getHeight(double z)

Returns the height from the airmass. Uses a first-order newtonian approximation to avoid round-off errors.