stella.sensor

Class SolHeightSensor

java.lang.Object

util.PropertyContainer

util.PropertyResources

util.rmi.RmiPropertyContainer

util.rmi.AbstractRmiCaster

stella.sensor.AbstractSensor

stella.sensor.TimerTaskSensor

stella.sensor.DataSensor

stella.sensor.CumulativeSensor

stella.sensor.PredictiveSensor

stella.sensor.SmoothingSensor

stella.sensor.DerivativeSensor

stella.sensor.WeatherSensor

stella.sensor.SolHeightSensor

All Implemented Interfaces:

ParameterDepending, Cloneable, Remote, PI, Caster, DataCaster, RmiDataCaster, RmiErrorCaster, Cumulating, Deriving, Predicting, Smoothing, Telemetering, WeatherJudging, WeatherCaster, ExitCleaning, Initializable, PropertySupplying, ResourceSupplying, RmiCaster, RmiPropertyBearing

public class SolHeightSensor
extends WeatherSensor
implements PI, ParameterDepending

This is a non-abstract implementation of a WeatherSensor that acts similar to the stand-alone SolZSensor. This sensor depends on parameters registered to it, thus it can only be used in environments, where a SolHeight parameter is registerd to it. Note that this class uses its own properties to construct its ConvertToPhysical instance, the CosineConversion.

Nested Class Summary

Nested classes/interfaces inherited from class stella.sensor.TimerTaskSensor

TimerTaskSensor.SensorRead

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.
private static double	DEFRISETWILIGHT The default z solar toggle value.
private static double	DEFSETTWILIGHT The default z solar toggle value.
private static String	DEFSIDEREAL The default name of the sidereal parameter to use.
private static String	DEFSOLDEC The default name of the solar declination to use.
private static String	DEFSOLHEIGHT The default solar height parameter name.
private static String	DEFSOLRA The default name of the solar right ascension to use.
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_SIDEREAL The name of the sidereal time to use.
static String	KEY_SOLDEC The name of the solar declination to use.
static String	KEY_SOLHEIGHT The key describing the solar height parameter.
static String	KEY_SOLRA The name of the solar right ascension to use.
private Value	phi The longitude of Teide, degrees.
private Value	soldec The solar declination parameter to use.
private Value	solra The solar right ascension parameter to use.
private Value	solz The solar height parameter.
private Value	theta The actual sidereal time.

Fields inherited from class stella.sensor.WeatherSensor

KEY_DERIVATIVEINVALID, KEY_DERIVATIVEPARAMETER, KEY_INVERSE, KEY_INVERSEDERIVATIVE, KEY_JUDGEDERIVATIVE, KEY_JUDGEPREDICT, KEY_JUDGERAW, KEY_JUDGESMOOTH, KEY_PREDICTINVALID, KEY_PREDICTPARAMETER, KEY_RAWINVALID, KEY_RAWPARAMETER, KEY_RETARDBADDERIVATIVE, KEY_RETARDBADPREDICT, KEY_RETARDBADRAW, KEY_RETARDBADSMOOTH, KEY_RETARDGOODDERIVATIVE, KEY_RETARDGOODPREDICT, KEY_RETARDGOODRAW, KEY_RETARDGOODSMOOTH, KEY_SMOOTHINVALID, KEY_SMOOTHPARAMETER

Fields inherited from class stella.sensor.DerivativeSensor

DEFRAWDERIVATIVE, derive, KEY_DERIVATIVEADVISE, KEY_DERIVE, KEY_PATH, KEY_RAWDERIVATIVE, z

Fields inherited from class stella.sensor.SmoothingSensor

f, g, KEY_SMOOTH, KEY_SMOOTHADVISE

Fields inherited from class stella.sensor.PredictiveSensor

KEY_CHI, KEY_EXTRAPOLATE, KEY_FUTURE, KEY_PREDICTADVISE, predict

Fields inherited from class stella.sensor.CumulativeSensor

KEY_AVERAGE, KEY_MEMORY, KEY_PACK

Fields inherited from class stella.sensor.DataSensor

DEFRAWFORMAT, DEFREPORT, DEFSIGMAFORMAT, KEY_RAWFORMAT, KEY_REPORT, KEY_SIGMAFORMAT

Fields inherited from class stella.sensor.TimerTaskSensor

KEY_LOGRAWABOVE, KEY_LOGRAWBELOW, KEY_LOGREADLAG, KEY_RESPAWN

Fields inherited from class stella.sensor.AbstractSensor

KEY_BIND, KEY_BINDNAME, KEY_CONVERT, KEY_DESCRIPTION, KEY_SENSORNAME

Fields inherited from class util.rmi.AbstractRmiCaster

ALTERNATEHOST, ALTERNATEPORT, KEY_EXPORTPORT, KEY_REGISTRYHOST, KEY_REGISTRYPORT

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 math.PI

HOUR, PIHALF, PITWO, RADIAN

Fields inherited from interface stella.rmi.RmiDataCaster

NAMING_EXTENSION

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
SolHeightSensor(Map qualify) Constructs a fully-qualified sol height sensor.

Method Summary

Modifier and Type	Method and Description
boolean	currentlyRetarding() Returns false.
void	deriveAt(double raw) The implementation of the deriving interface.
long	getMinClearUpTime() The time until sunset.
protected boolean	goodFromRaw(double rawdummy) The raw value is the solar height.
void	predictFrom(double lastraw) Predicts from the actual data point to the near future.
double	readSensor() Reads the sensor.
void	registerParameter(Parameter what) Registers the required additional parameters for a solar height sensor.
boolean	validReading() The solar height sensor is always valid if the solar height is defined.

Methods inherited from class stella.sensor.WeatherSensor

addWeatherListener, conductOneMeasure, currentlyClear, generateDataEvent, getSensorInitInfo, goodFromDerivative, goodFromPredict, goodFromSmooth, isDerivativeRetard, isPredictRetard, isRawRetard, isSmoothRetard, judgeWeather, notifyWeatherListener, removeWeatherListener, status

Methods inherited from class stella.sensor.DerivativeSensor

getDerivativeFormat, getDerivativeToggleInfo, getDerivator, getLastDerivative, isDerivativeAdvise, isDeriving, newData, regetDerive, registerDerivator

Methods inherited from class stella.sensor.SmoothingSensor

getLastSmooth, getSmoother, getSmoothToggleInfo, isSmoothAdvise, isSmoothing, regetSmooth, registerSmoother, smoothOne

Methods inherited from class stella.sensor.PredictiveSensor

getExtrapolation, getLastPredict, getPredictToggleInfo, init, isPredictAdvise, isPredicting, isReliable, regetPredict

Methods inherited from class stella.sensor.CumulativeSensor

cumulateOne, getLastRaw, getLastTime, getMaxSize, getMemory, getSize

Methods inherited from class stella.sensor.DataSensor

addDataListener, addRmiDataListener, exit, getRawFormat, getSigmaFormat, removeDataListener, removeRmiDataListener, report

Methods inherited from class stella.sensor.TimerTaskSensor

cancel, equals, getRawToggleInfo, getReading, getRespawn, getTimeOfRead, hashCode, initSensorTimerTask, isReady, regetRaw, setTimeOfRead, validReading

Methods inherited from class stella.sensor.AbstractSensor

addRmiErrorListener, createSensor, getBindName, getConvert, getSensorDescription, getSensorName, notifyErrorListener, removeRmiErrorListener, setConvert, toString

Methods inherited from class util.rmi.AbstractRmiCaster

bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, casterExit, casterExit, getBindName, isValid, unbindFromRegistry, unbindFromRegistry

Methods inherited from class util.rmi.RmiPropertyContainer

containsRemoteProperty, getRemoteProperties, getRemoteProperty, setRemoteProperty

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, rescanned, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface stella.sensor.Cumulating

cumulateOne, getLastRaw, getLastTime, getMaxSize, getSize, getTimeOfRead, regetRaw

Methods inherited from interface util.rmi.RmiCaster

bindToRegistry, isValid, unbindFromRegistry

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

Field Detail

KEY_SOLHEIGHT

public static final String KEY_SOLHEIGHT

The key describing the solar height parameter.

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

KEY_SIDEREAL

public static final String KEY_SIDEREAL

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_SOLRA

public static final String KEY_SOLRA

The name of the solar right ascension to use.

See Also:

Constant Field Values

KEY_SOLDEC

public static final String KEY_SOLDEC

The name of the solar declination to use.

See Also:

Constant Field Values

DEFRISETWILIGHT

private static final double DEFRISETWILIGHT

The default z solar toggle value.

See Also:

Constant Field Values

DEFSETTWILIGHT

private static final double DEFSETTWILIGHT

The default z solar toggle value.

See Also:

Constant Field Values

DEFSOLHEIGHT

private static final String DEFSOLHEIGHT

The default solar height parameter name.

See Also:

Constant Field Values

DEFSIDEREAL

private static final String DEFSIDEREAL

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

DEFSOLRA

private static final String DEFSOLRA

The default name of the solar right ascension to use.

See Also:

Constant Field Values

DEFSOLDEC

private static final String DEFSOLDEC

The default name of the solar declination to use.

See Also:

Constant Field Values

solz

private Value solz

The solar height parameter.

phi

private Value phi

The longitude of Teide, degrees.

theta

private Value theta

The actual sidereal time.

solra

private Value solra

The solar right ascension parameter to use.

soldec

private Value soldec

The solar declination parameter to use.

Constructor Detail

SolHeightSensor

public SolHeightSensor(Map qualify)
                throws RemoteException

Constructs a fully-qualified sol height sensor. This sensor is useful in conjunction with a parameter cluster assigned to the hosting weather station that constains at least the SolHeight value.

Throws:

RemoteException

Method Detail

registerParameter

public void registerParameter(Parameter what)

Registers the required additional parameters for a solar height sensor. This is the sidereal time, the solar height, the Sun's position, i.e. ra dec and the latitude of the observatory.

Specified by:

registerParameter in interface ParameterDepending

readSensor

public double readSensor()

Reads the sensor. For the calculated sol z sensor this means the calculation of the solar position and the local sidereal time at the actual date. The calculation is done using the helper classes Sol, Sidereal and place which may be defined in the properties at construct.

Specified by:

readSensor in class TimerTaskSensor

Returns:

The cosine of the actual solar zenith distance.

See Also:

ConvertToPhysical

goodFromRaw

protected boolean goodFromRaw(double rawdummy)

The raw value is the solar height. The weather is good, if the height is less then #KEY_TWILIGHT.

Overrides:

goodFromRaw in class WeatherSensor

currentlyRetarding

public boolean currentlyRetarding()

Returns false.

Specified by:

currentlyRetarding in interface WeatherJudging

Overrides:

currentlyRetarding in class WeatherSensor

getMinClearUpTime

public long getMinClearUpTime()

The time until sunset.

Specified by:

getMinClearUpTime in interface WeatherJudging

Overrides:

getMinClearUpTime in class WeatherSensor

validReading

public boolean validReading()

The solar height sensor is always valid if the solar height is defined.

Specified by:

validReading in interface Telemetering

deriveAt

public void deriveAt(double raw)

The implementation of the deriving interface. Sol z is a calculated sensor, therefore it can easyly calculate the derivative. The value returned is dh/dt with dt in millisec.

Specified by:

deriveAt in interface Deriving

Overrides:

deriveAt in class DerivativeSensor

Parameters:

raw - The actual solar height in degrees.

predictFrom

public void predictFrom(double lastraw)

Predicts from the actual data point to the near future. This is no problem for the solz sensor.

Specified by:

predictFrom in interface Predicting

Overrides:

predictFrom in class PredictiveSensor

Parameters:

lastraw - The current raw measurement