globals.value

Class AltTarget

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

stella.globals.AbstractTargetParameter

stella.globals.AbstractTargetValue

globals.value.AltTarget

All Implemented Interfaces:

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

public class AltTarget
extends AbstractTargetValue
implements TimeDependingValue, TimeDependingTargetValue, TargetDependIncreasing, TargetDependDecreasing, ParameterDepending, Reloadable

Represents the height of the actual target in degrees. Formular:

 sin(h)=sin(φ)sin(δ)+cos(φ)cos(δ)cos(τ)
 

Follows the general Value contract and returns a quantity in degrees. 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 Value	dec The dec of the target, degrees.
private static String	DEFDEC The default name of the solar ecliptical longitude to use.
private static String	DEFLATITUDE The default name of the latitude parameter to use.
static String	DEFNAME The default name of this value.
private static String	DEFTAU The default name of the sidereal parameter to use.
private static DecimalFormat	df The formatter for the target height.
static String	KEY_DEC The name of the solar ecliptical longitude to use.
static String	KEY_LATITUDE The name of the latitude to use.
static String	KEY_TAU The name of the sidereal time to use.
private Value	latitude The latitude of Teide, degrees.
private Value	tau The actual hour angle of the target, degrees.

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
AltTarget(Map<String,String> info) Constructs a new airmass target object.

Method Summary

Modifier and Type	Method and Description
private double	calcTau(double h, double phi, double dec) Calculates the remaining time until a given height is reached.
private Double	calculate(Number tautarget, Number dectarget) Calculates the height using the hour angle and the declination of the target.
private Double	calculateIn(Number tautarget, Number dectarget, double dt) Calculates the azimuth using the hour angle and the declination of the target.
static double	getAltDerivative(double phi, double tau, double de) Calculates the derivative of the altitude with respect to the hour angle.Formular:
static double	getAltTarget(double phi, double tau, double de) Calculates the height using the hour angle and the declination of the target.
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.
Number	getForTargetIn(TargetDefinition star, double dt) gets the azimuth of the target in dt seconds.
Number	getValue() Returns the target's actual airmass, wrapped into a Double.
Number	getValueIn(double dt) 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) As any parameter depending instance we fail if the parameter we depend on is now a different one.
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 globals.Parameter

get, getFormatted, getName, getString, set

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

Methods inherited from interface util.Reloadable

reload

Methods inherited from interface globals.TargetDependingParameter

getFormattedFor

Field Detail

KEY_TAU

public static final String KEY_TAU

The name of the sidereal time to use.

See Also:

Constant Field Values

KEY_LATITUDE

public static final String KEY_LATITUDE

The name of the latitude to use.

See Also:

Constant Field Values

KEY_DEC

public static final String KEY_DEC

The name of the solar ecliptical longitude to use.

See Also:

Constant Field Values

DEFNAME

public static final String DEFNAME

The default name of this value.

See Also:

Constant Field Values

DEFTAU

private static final String DEFTAU

The default name of the sidereal parameter to use.

See Also:

Constant Field Values

DEFLATITUDE

private static final String DEFLATITUDE

The default name of the latitude parameter to use.

See Also:

Constant Field Values

DEFDEC

private static final String DEFDEC

The default name of the solar ecliptical longitude to use.

See Also:

Constant Field Values

tau

private Value tau

The actual hour angle of the target, degrees.

dec

private Value dec

The dec of the target, degrees.

latitude

private Value latitude

The latitude of Teide, degrees.

df

private static final DecimalFormat df

The formatter for the target height.

Constructor Detail

AltTarget

public AltTarget(Map<String,String> 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)

As any parameter depending instance we fail if the parameter we depend on is now a different one.

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.

getForTargetIn

public Number getForTargetIn(TargetDefinition star,
                             double dt)

gets the azimuth of the target in dt seconds.

Specified by:

getForTargetIn in interface TimeDependingTargetValue

Parameters:

star -

dt -

Returns:

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

getValueIn

public Number getValueIn(double dt)

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:

getValueIn in interface TimeDependingValue

Parameters:

dt - Return value not now, but in the stated number of seconds.

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 tau and dec 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 height of the target is oscilatory, therefore we define the ascend time as the time it will take until the height of the target crosses the given value and is still growing. This point will always be in the eastern part of the hemisphere, therefore we calculate the negative hour angle needed to reach the desired height. This hour angle is then passed to the hour-angle of the target as the aim value.

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 height of the target is oscilatory, therefore we define the descend time as the time it will take until the height of the target crosses the given value and is still shrinking. This point will always be in the western part of the hemisphere, therefore we calculate the positive hour angle needed to reach the desired height. This hour angle is then passed to the hour-angle of the target as the aim value.

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 height of the target is oscilatory, therefore we define the ascend time as the time it will take until the height of the target crosses the given value and is still growing. This point will always be in the eastern part of the hemisphere, therefore we calculate the negative hour angle needed to reach the desired height. This hour angle is then passed to the hour-angle of the target as the aim value.

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 height of the target is oscilatory, therefore we define the descend time as the time it will take until the height of the target crosses the given value and is still shrinking. This point will always be in the western part of the hemisphere, therefore we calculate the positive hour angle needed to reach the desired height. This hour angle is then passed to the hour-angle of the target as the aim value.

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.

calculate

private Double calculate(Number tautarget,
                         Number dectarget)

Calculates the height using the hour angle and the declination of the target. The latitude of the site must be registered first. Formular:

 sin(h)=sin(φ)sin(δ)+cos(φ)cos(δ)cos(τ)
 

calculateIn

private Double calculateIn(Number tautarget,
                           Number dectarget,
                           double dt)

Calculates the azimuth using the hour angle and the declination of the target. The latitude of the site must be registered first. Formular:

 tan(a)=sin(τ)/(sin(φ)cos(τ)-tan(δ)cos(φ))
 

getAltTarget

public static final double getAltTarget(double phi,
                                        double tau,
                                        double de)

Calculates the height using the hour angle and the declination of the target. The latitude of the site must be registered first. Formular:

 sin(h)=sin(φ)sin(δ)+cos(φ)cos(δ)cos(τ)
 

getAltDerivative

public static final double getAltDerivative(double phi,
                                            double tau,
                                            double de)

Calculates the derivative of the altitude with respect to the hour angle.Formular:

 cos(h) dh =-cos(φ)cos(δ)sin(τ) dτ

 dh = -sin(az) cos(φ) dτ
 

Parameters:

phi -

tau -

de -

Returns:

calcTau

private double calcTau(double h,
                       double phi,
                       double dec)

Calculates the remaining time until a given height is reached. Always uses the ascend time of the hour angle definition. If the target definition handed over is null, the non-target depending version of the ascend time of tau is used.

Parameters:

h - Target height of object in degrees.

phi - Latitude in degrees.

dec - Declination of object in degree.

target - If non-null the target depending time is used.