stella.sensor

Class CosineConversion

java.lang.Object

util.PropertyContainer

stella.sensor.AbstractConversion

stella.sensor.AbstractDerivative

stella.sensor.CosineConversion

All Implemented Interfaces:

Serializable, Cloneable, PI, ConvertToPhysical, PhysicalDerivative, PropertySupplying

public class CosineConversion
extends AbstractDerivative
implements PI

The converter class used by the solz sensor. It converts the cosine of z, which is the raw sensor reading into a 'true' z in degrees.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static DecimalFormat	DEFVALUEFORMAT The default decimal format for the values.
private static DecimalFormat	DEFVALUESIGMA The default deciaml format for the sigma of the values.

Fields inherited from class stella.sensor.AbstractDerivative

KEY_VALUEDERIVATIVE

Fields inherited from class stella.sensor.AbstractConversion

KEY_UNIT, KEY_VALUEFORMAT, KEY_VALUESIGMA

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 util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

Constructors

Constructor and Description
CosineConversion(Map info) Constructs a new cosine converter.

Method Summary

Modifier and Type	Method and Description
double	getDeviation(double cosz, double dummy) Returns the estimated standard deviation in physical units of the physical mean.
double	getPhysical(double sinh) Returns the physical interpretation of this sensors raw reading value.
double	getPhysicalDerivative(double dcosz, double h) Returns the derivative of the physical interpreted raw measure value.
double	getRaw(double h) Returns the raw value from the physical one.
double	getRawDerivative(double dhdt, double h) Converts the derivative of the solar height, given in degrees per second in the raw derivative, which is the derivative of sin(h) with respect to solar time in radians.

Methods inherited from class stella.sensor.AbstractDerivative

getDerivativeValueFormat

Methods inherited from class stella.sensor.AbstractConversion

createConversion, getSigmaValueFormat, getUnit, getValueFormat

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, clone, 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, initProperties, isNew, parseObject, parseObject, reload, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface stella.sensor.ConvertToPhysical

getSigmaValueFormat, getUnit, getValueFormat

Field Detail

DEFVALUEFORMAT

private static final transient DecimalFormat DEFVALUEFORMAT

The default decimal format for the values.

DEFVALUESIGMA

private static final transient DecimalFormat DEFVALUESIGMA

The default deciaml format for the sigma of the values.

Constructor Detail

CosineConversion

public CosineConversion(Map info)

Constructs a new cosine converter. Since the conversion does not need any additional parameters, all the properties defined for the decimal formats should be given in the properties of the solz sensor itself. Its properties are also used to construct this converter.

Method Detail

getPhysical

public double getPhysical(double sinh)

Returns the physical interpretation of this sensors raw reading value. For a solar z sensor, the raw value is the cosine of the solar zenith distance, while the physical interpretation is the true solar height, in degrees.

Specified by:

getPhysical in interface ConvertToPhysical

Parameters:

cosz - The cosine of the solar zenith distance.

Returns:

The solar height above the horizon, in degrees.

getRaw

public double getRaw(double h)

Returns the raw value from the physical one.

Specified by:

getRaw in interface ConvertToPhysical

Parameters:

h - The height of the sun in degrees.

Returns:

The sine of the solar height.

getDeviation

public double getDeviation(double cosz,
                           double dummy)

Returns the estimated standard deviation in physical units of the physical mean. Again, as solar z is a calculating sensor, this standard deviation is defined to be zero, although there is of course a numerical value of a standard deviation because the solar z value changes over the time intervall considered. To unmistakably mark a calculated (i.e. exact) sensor, this deviation is set to zero.

Specified by:

getDeviation in interface ConvertToPhysical

Parameters:

cosz - The raw reading value.

dummy - The standard deviation of the raw readings.

Returns:

Double.NaN to indicate that this sensor is an exact sensor.

getPhysicalDerivative

public double getPhysicalDerivative(double dcosz,
                                    double h)

Returns the derivative of the physical interpreted raw measure value. Because sol z is a calculating sensor, there is no need to consider a numerically, smoothened first derivative value. To convert the raw derivative, which takes the derivative of cos(z) in respect to solar time in radians, one has to devide the result through 240 to get the result in degrees per seconds.

Specified by:

getPhysicalDerivative in interface PhysicalDerivative

Parameters:

dcosz - The derivative of cos(z).

h - The cosine of the solar height.

Returns:

The first derivative of the solar height in degrees per solar time in seconds.

getRawDerivative

public double getRawDerivative(double dhdt,
                               double h)

Converts the derivative of the solar height, given in degrees per second in the raw derivative, which is the derivative of sin(h) with respect to solar time in radians.

Specified by:

getRawDerivative in interface PhysicalDerivative

Parameters:

dhdt - The physical quantity of the first derivative.

h - The physical quantity.