globals.value

Class NightLength

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

globals.value.AbstractValue

globals.value.NightLength

All Implemented Interfaces:

Parameter, ParameterDepending, Value, Cloneable, ExitCleaning, Initializable, PropertySupplying, Reloadable, ResourceSupplying

public class NightLength
extends AbstractValue
implements ParameterDepending, Reloadable

A class giving the length of the actual night in milliseconds. It needs the solar longitude and the latitude of the observatory. Additionally, the twilight can be influenced with the KEY_RISETWILIGHT and KEY_SETTWILIGHT key that points to the cosine of the solar zenith distance that should mark the beginning of the night.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NightLength.Test Test class.

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private static String	DEFLATITUDE The default name of the latitude parameter to use.
static String	DEFNAME The default name of this value.
private static double	DEFRISESETWILIGHT The default opening/closing solar height.
private static String	DEFSOL The default name of the solar ecliptical longitude to use.
private static double	DEFSOLARSET The default opening/closing solar height.
static String	KEY_LATITUDE The name of the latitude to use.
static String	KEY_RISETWILIGHT The key to the good-weather toggle height of the sun.
static String	KEY_SETTWILIGHT The key to the good-weather toggle height of the sun.
static String	KEY_SOL The name of the solar ecliptical longitude to use.
private Value	lambda The solar longitude.
private Value	phi The latitude of the observatory.

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
NightLength(Map<String,String> prop) Constructs a new nigth length object.

Method Summary

Modifier and Type	Method and Description
String	getFormatted() Gets a formatted value of the night length.
Number	getValue() Returns the length of the night in milli seconds.
void	registerParameter(Parameter what) Registers the required additional information for the night length calculation.
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 night length.

Methods inherited from class globals.value.AbstractValue

get, set

Methods inherited from class globals.parameter.AbstractParameter

createParameter, delivers, exit, 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.Parameter

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_LATITUDE

public static final String KEY_LATITUDE

The name of the latitude to use.

See Also:

Constant Field Values

KEY_SOL

public static final String KEY_SOL

The name of the solar ecliptical longitude to use.

See Also:

Constant Field Values

KEY_RISETWILIGHT

public static final String KEY_RISETWILIGHT

The key to the good-weather toggle height of the sun.

See Also:

Constant Field Values

KEY_SETTWILIGHT

public static final String KEY_SETTWILIGHT

The key to the good-weather toggle height of the sun.

See Also:

Constant Field Values

DEFRISESETWILIGHT

private static final double DEFRISESETWILIGHT

The default opening/closing solar height.

See Also:

Constant Field Values

DEFSOLARSET

private static final double DEFSOLARSET

The default opening/closing solar height.

See Also:

Constant Field Values

DEFNAME

public static final String DEFNAME

The default name of this value.

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

DEFSOL

private static final String DEFSOL

The default name of the solar ecliptical longitude to use.

See Also:

Constant Field Values

lambda

private Value lambda

The solar longitude.

phi

private Value phi

The latitude of the observatory.

Constructor Detail

NightLength

public NightLength(Map<String,String> prop)

Constructs a new nigth length object. Defaults KEY_RISETWILIGHT and KEY_SETTWILIGHT .

Method Detail

registerParameter

public void registerParameter(Parameter what)

Registers the required additional information for the night length calculation. This includes the solar ecliptical longitude and the latitude of the site.

Specified by:

registerParameter in interface ParameterDepending

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 night length. The night length is a read-only variable, therefore this method throws an UnsupportedOperationException.

Specified by:

setValue in interface Value

Throws:

UnsupportedOperationException

getValue

public Number getValue()

Returns the length of the night in milli seconds.

Specified by:

getValue in interface Value

getFormatted

public String getFormatted()

Gets a formatted value of the night length. It is displayed as an hour-minute-second string.

Specified by:

getFormatted in interface Parameter

Overrides:

getFormatted in class AbstractParameter