stella.globals

Class LaserAzAltDistance

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

stella.globals.AbstractTargetParameter

stella.globals.AbstractTargetValue

stella.globals.LaserAzAltDistance

All Implemented Interfaces:

Parameter, ParameterDepending, TargetDependingParameter, Value, Cloneable, TargetDependingValue, TargetDepending, ExitCleaning, Initializable, PropertySupplying, Reloadable, ResourceSupplying

Direct Known Subclasses:

LaserAzAltList

public abstract class LaserAzAltDistance
extends AbstractTargetValue
implements ParameterDepending, Reloadable

A parameter that calculates the distance of a target to some given point in the sky given by azimuth (astronomical, i.e. S=0) and altitude. This parameter is a TargetDependingParameter, allowing proper calculation of the current target distance to the OT Laser.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LaserAzAltDistance.Randomize
static class	LaserAzAltDistance.Stepper

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private TargetDependingValue	alt The altitude parameter of the target.
private TargetDependingValue	az The azimuth parameter of the target.
private TargetDependingValue	de The declination of the target.
private static String	DEFALTTARGET
private static String	DEFAZTARGET
private static String	DEFDECTARGET
private static String	DEFLATITUDE
static String	DEFNAME The name of this global (ra).
private static String	DEFTAUTARGET
private static DecimalFormat	df The formatter for the distance.
static String	KEY_ALTTARGET The name of the parameter that gives the alt of the target.
static String	KEY_AZTARGET The name of the parameter that gives the az of the target.
static String	KEY_DECTARGET We also need the declination for time of specific distance.
static String	KEY_LATITUDE For derivative we also need the latitude of the observatory.
static String	KEY_TAUTARGET We also need the hour angle for computation of minimum distance.
private Value	phi The latitude.
private TargetDependIncreasing	tau The hour angle of the target.

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

Modifier	Constructor and Description
private	LaserAzAltDistance()
protected	LaserAzAltDistance(Map<String,String> prop) Constructs a new global representing the actual object distance to some other point in the sky.

Method Summary

Modifier and Type	Method and Description
protected static double	getArcDerivativeTimeSinD(double az, double alt, double azl, double altl, double latitude) If the first of two points follows a trajectory defined by constant right ascension and declination, while the second position on the sky is fixed in azimuth and altitude, the arc distance between these two points will vary over time.
static double	getArcDistance(double az, double alt, double azl, double altl) Calculates the distance between two right-handed spherical coordinates like azimuth and altitude, hour angle and declination.
protected Long	getArcTime(double dist, double azl, double altl) Returns the time remaining until the target reaches a certain distance to the laser pointing.
protected Long	getArcTimeFor(TargetDefinition star, double dist, double azl, double altl) Returns the time remaining until the target reaches a certain distance to the laser pointing.
abstract Vector2D	getCurrentLaser() Gets the aziumth and altitde, both, in degrees of the current Laser pointing.
protected Number	getDerivative()
static double	getExtremalTau(double azl, double altl, double lat) Calculates the hour angle where the distance to the laser pointing get extremal.
protected Long	getExtremalTime(double azl, double altl) Returns the time remaining until we reach the minimal distance to the laser pointing
protected Long	getExtremalTimeFor(TargetDefinition star, double azl, double altl) Returns the time remaining until we reach the minimal distance to the laser pointing
Number	getForTarget(TargetDefinition star) Gets the distance of the laser pointing to the current target
Number	getForTargetIn(TargetDefinition star, double sec) Gets the future distance of the laser pointing to the current target
private Number	getLaserDerivative(double az, double alt, double latitude)
private Number	getLaserDistance(double az, double alt)
protected Number	getLatitude()
protected Vector2D	getTargetAzAlt() Daughter access: Get the current az alt of the target.
protected Vector2D	getTargetAzAltFor(TargetDefinition star) Daughter access: Get the current az alt of this target.
protected Vector2D	getTargetAzAltForIn(TargetDefinition star, double dt) Daughter access: Get the current az alt of the target.
protected Vector2D	getTargetAzAltIn(double dt) Daughter access: Get the current az alt of the target.
static Vector2D	getTauForArc(double dist, double de, double azl, double altl, double lat) Calculates the hour angle where the minimum distance is reached.
Number	getValue() Returns the distance of the current laser pointing to the actual target.
Number	getValueIn(double sec) Returns the distance of the current laser pointing to the position of the actual target in the specified number of seconds.
void	registerParameter(Parameter what) Registers the parameters giving the ra, dec of two points.
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 distance.

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_AZTARGET

public static final String KEY_AZTARGET

The name of the parameter that gives the az of the target.

See Also:

Constant Field Values

KEY_ALTTARGET

public static final String KEY_ALTTARGET

The name of the parameter that gives the alt of the target.

See Also:

Constant Field Values

KEY_TAUTARGET

public static final String KEY_TAUTARGET

We also need the hour angle for computation of minimum distance.

See Also:

Constant Field Values

KEY_DECTARGET

public static final String KEY_DECTARGET

We also need the declination for time of specific distance.

See Also:

Constant Field Values

KEY_LATITUDE

public static final String KEY_LATITUDE

For derivative we also need the latitude of the observatory.

See Also:

Constant Field Values

DEFNAME

public static final String DEFNAME

The name of this global (ra).

See Also:

Constant Field Values

df

private static final DecimalFormat df

The formatter for the distance.

DEFAZTARGET

private static final String DEFAZTARGET

See Also:

Constant Field Values

DEFALTTARGET

private static final String DEFALTTARGET

See Also:

Constant Field Values

DEFTAUTARGET

private static final String DEFTAUTARGET

See Also:

Constant Field Values

DEFDECTARGET

private static final String DEFDECTARGET

See Also:

Constant Field Values

DEFLATITUDE

private static final String DEFLATITUDE

See Also:

Constant Field Values

az

private TargetDependingValue az

The azimuth parameter of the target.

alt

private TargetDependingValue alt

The altitude parameter of the target.

tau

private TargetDependIncreasing tau

The hour angle of the target.

de

private TargetDependingValue de

The declination of the target.

phi

private Value phi

The latitude.

Constructor Detail

LaserAzAltDistance

private LaserAzAltDistance()

LaserAzAltDistance

protected LaserAzAltDistance(Map<String,String> prop)

Constructs a new global representing the actual object distance to some other point in the sky.

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

registerParameter

public void registerParameter(Parameter what)

Registers the parameters giving the ra, dec of two points. No checks for types are made, only the parameter name counts.

Specified by:

registerParameter in interface ParameterDepending

registerTarget

public void registerTarget(TargetDefinition star)

Registers a star to this parameter. The declination of the star is set as this parameter's value.

Specified by:

registerTarget in interface TargetDepending

getTargetAzAlt

protected Vector2D getTargetAzAlt()

Daughter access: Get the current az alt of the target.

Returns:

getTargetAzAltIn

protected Vector2D getTargetAzAltIn(double dt)

Daughter access: Get the current az alt of the target.

Returns:

getTargetAzAltFor

protected Vector2D getTargetAzAltFor(TargetDefinition star)

Daughter access: Get the current az alt of this target.

Returns:

getTargetAzAltForIn

protected Vector2D getTargetAzAltForIn(TargetDefinition star,
                                       double dt)

Daughter access: Get the current az alt of the target.

Returns:

getForTarget

public Number getForTarget(TargetDefinition star)

Gets the distance of the laser pointing to the current target

Specified by:

getForTarget in interface TargetDependingParameter

Specified by:

getForTarget in interface TargetDependingValue

Returns:

A Double holding the target star's arc distance in degree.

getForTargetIn

public Number getForTargetIn(TargetDefinition star,
                             double sec)

Gets the future distance of the laser pointing to the current target

Parameters:

sec - Time from now in seconds

Returns:

A Double holding the target star's arc distance in degree.

getValue

public Number getValue()

Returns the distance of the current laser pointing to the actual target. Returns null if the ra has not been set previously.

Specified by:

getValue in interface Value

getValueIn

public Number getValueIn(double sec)

Returns the distance of the current laser pointing to the position of the actual target in the specified number of seconds. Returns null if the ra has not been set previously.

getLatitude

protected Number getLatitude()

getDerivative

protected Number getDerivative()

getLaserDistance

private Number getLaserDistance(double az,
                                double alt)

getLaserDerivative

private Number getLaserDerivative(double az,
                                  double alt,
                                  double latitude)

getCurrentLaser

public abstract Vector2D getCurrentLaser()

Gets the aziumth and altitde, both, in degrees of the current Laser pointing.

Returns:

Null if Laser is not active

getArcDistance

public static double getArcDistance(double az,
                                    double alt,
                                    double azl,
                                    double altl)

Calculates the distance between two right-handed spherical coordinates like azimuth and altitude, hour angle and declination. Remember that right ascension, declination is left-handed, though it returns the right distance here, too.

getExtremalTau

public static double getExtremalTau(double azl,
                                    double altl,
                                    double lat)

Calculates the hour angle where the distance to the laser pointing get extremal.

Parameters:

azl -

altl -

lat -

Returns:

getTauForArc

public static Vector2D getTauForArc(double dist,
                                    double de,
                                    double azl,
                                    double altl,
                                    double lat)

Calculates the hour angle where the minimum distance is reached. This happens normally for two hour angles or none at all, thus we return a vector2d here.

getExtremalTime

protected Long getExtremalTime(double azl,
                               double altl)

Returns the time remaining until we reach the minimal distance to the laser pointing

Parameters:

azl -

altl -

Returns:

getExtremalTimeFor

protected Long getExtremalTimeFor(TargetDefinition star,
                                  double azl,
                                  double altl)

Returns the time remaining until we reach the minimal distance to the laser pointing

Parameters:

azl -

altl -

Returns:

getArcTime

protected Long getArcTime(double dist,
                          double azl,
                          double altl)

Returns the time remaining until the target reaches a certain distance to the laser pointing.

getArcTimeFor

protected Long getArcTimeFor(TargetDefinition star,
                             double dist,
                             double azl,
                             double altl)

Returns the time remaining until the target reaches a certain distance to the laser pointing.

getArcDerivativeTimeSinD

protected static double getArcDerivativeTimeSinD(double az,
                                                 double alt,
                                                 double azl,
                                                 double altl,
                                                 double latitude)

If the first of two points follows a trajectory defined by constant right ascension and declination, while the second position on the sky is fixed in azimuth and altitude, the arc distance between these two points will vary over time. this method calculates the derivative of the cosine of the arc distance, assuming that the first position is the one fixed in ra, de, while the second one is fixed on az-alt. This method spares division through the sine of the arc distance, which is in any case a postitive value, thus for a simple check if the arc distance is currently growing or shrinking, a call to this method provides the immediate answer in its return value's sign. To get the true derivative value, calculate the current arc distance an divide the return value by the sine of this arc distance.

Parameters:

az - Current azimuth of star

alt - Current altitude of star

azl - Fixed az position in sky

altl - Fixed alt position in sky

latitude - Geographic latitude

Returns:

setValue

public Number setValue(Number val)
                throws UnsupportedOperationException

Sets the distance. This is a read-only variable, therefore this method throws an UnsupportedOperationException.

Specified by:

setValue in interface Value

Throws:

UnsupportedOperationException