FlatExposureTime

java.lang.Object
- util.PropertyContainer
- - util.PropertyResources
  - - globals.parameter.AbstractParameter
    - - stella.globals.AbstractTargetParameter
      - stella.globals.AbstractTargetValue
        
        stella.globals.AbstractFitsMomentsValue
        
        stella.globals.FlatExposureTime

All Implemented Interfaces:

Parameter, ParameterDepending, TargetDependingParameter, Value, Cloneable, ExposureTimeMeasuring, TargetDependingValue, TargetDepending, ExitCleaning, Initializable, PropertySupplying, ResourceSupplying
```
public class FlatExposureTime
extends AbstractFitsMomentsValue
implements ExposureTimeMeasuring
```
We estimate the exposure time for a flat field to yield a good exposure level. The parameter is reset on target picked. Later, as we have ADU moments available, we use the average of all quadrants to estimate a new exposure time. This parameter listens to the filter in the target supplied to make a zero-guess. The exposure time returned is in seconds. 25000*tanh(0.3*x-.8)+25000

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`FlatExposureTime.Test` Reads the fits file given at the command line, extract the exposure time and does an exposure calculation using default bias levels.

Nested classes/interfaces inherited from class util.PropertyResources
PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields
Modifier and Type	Field and Description
`private List<Double>`	`bias` All quadrants average bias level.
`private static double`	`DEFADUTOLERANCE` The default tolerance if on exposure edge.
`private static double`	`DEFADUTWILIGHT` The default tolerance if on exposure edge.
`private static String`	`DEFBIASADU` The default bias ADU per quadrant, measured on STELLA1, 12-07-10.
`private static String`	`DEFFILTERLUX` The default lux-to-sec expressions for all filters.
`private static String`	`DEFGAIN` The default gains, measured 01-07-2010.
`private static String`	`DEFLUXSENSOR` The default lux value name.
`static String`	`DEFNAME` The default name.
`private static String`	`DEFTARGETADU` The default adus for a good flat.
`private static double`	`DEFTIMEHIGH` Default high time limit.
`private static double`	`DEFTIMELOW` Default low time limit.
`private List<Double>`	`desired` All quadrant's target ADU for a good flat.
`private boolean`	`dolog` For debugging purpose, a flag to write.
`private String`	`filter` The last filter registered.
`private List<Double>`	`gain` All quadrant's target ADU for a good flat.
`static String`	`KEY_ADUTOLERANCE` The tolerance in target adu if at exposure limit.
`static String`	`KEY_ADUTWILIGHT` If we have sol sink parameter, we add/subtract this from targetadu.
`static String`	`KEY_BIASADU` The crude bias estimation of the quadrants.
`static String`	`KEY_CONSTANT` The name of the setup constant that holds the filter.
`static String`	`KEY_FILTERLUX` This key links filter names to expressions for time calculation.
`static String`	`KEY_GAIN` The gains of the quadrants.
`static String`	`KEY_LUXSENSOR` The name of the parameter that delivers the current sky brightness.
`static String`	`KEY_SETUP` The setup section that carries the flat-field filter.
`static String`	`KEY_TARGETADU` The list of desireged average ADUs after bias substraction.
`static String`	`KEY_TIMEHIGH` If exposure time falls below this limit, we increase the target adu.
`static String`	`KEY_TIMELOW` If exposure time falls below this limit, we increase the target adu.
`static String`	`KEY_USEQUADRANTS` If that is given, only use these quadrants for averaging.
`private Value`	`lux` The parameter that delivers current sky brightness.
`private Map<String,Function>`	`luxtime` The expressions on how we calculate from lux to exposure time.
`private long`	`pick` The time the target was chosen.
`private SolSink`	`sunset` We allow to distinguish berween sun rise and sun set.
`private List<Integer>`	`usequad` If this is set, only these quadrants are used.

Fields inherited from class stella.globals.AbstractFitsMomentsValue
KEY_FITSMOMENTS

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

FlatExposureTime(Map<String,String> prop)
Construction of the flat exposure time calculator.

Constructors
Constructor and Description
`FlatExposureTime(Map<String,String> prop)` Construction of the flat exposure time calculator.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private double`	`getExposureEstimate(String f)` Using the flat-field filter name and the fits moments, we estimate the best exposure time by using the average of the current fits compared to the target average in `#KEY_TARGETLEVEL`.
`private double`	`getExposureLevelTime(double texp, List<CentralMoments> cm)` From the average of the exposure, do the calculation for the time.
`Number`	`getForTarget(TargetDefinition td)` If queried with a target, we always ignore the fits moments, as these cannot be valid.
`private double`	`getLightLevelTime(String f)` We calculate an exposure time from the light sensor.
`Number`	`getValue()` We get the estimated flat exposure time.
`void`	`init()` On init, we create the table for calculating the times.
`void`	`registerParameter(Parameter p)` We register a parameter that delivers sky brightness.
`void`	`registerTarget(TargetDefinition td)` We register the target.

Methods inherited from class stella.globals.AbstractFitsMomentsValue
getDateObs, getExposureTime, getFits, getRegistered, registerMonitor, setValue

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, overrideDefaultName, register, rescanned, 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.Value
setValue

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 globals.TargetDependingParameter
getFormattedFor

- Field Detail
  - KEY_FILTERLUX
```
public static final String KEY_FILTERLUX
```
    This key links filter names to expressions for time calculation.
    
    See Also:
    
    Constant Field Values
  - KEY_LUXSENSOR
```
public static final String KEY_LUXSENSOR
```
    The name of the parameter that delivers the current sky brightness.
    
    See Also:
    
    Constant Field Values
  - KEY_SETUP
```
public static final String KEY_SETUP
```
    The setup section that carries the flat-field filter.
    
    See Also:
    
    Constant Field Values
  - KEY_CONSTANT
```
public static final String KEY_CONSTANT
```
    The name of the setup constant that holds the filter.
    
    See Also:
    
    Constant Field Values
  - KEY_TARGETADU
```
public static final String KEY_TARGETADU
```
    The list of desireged average ADUs after bias substraction.
    
    See Also:
    
    Constant Field Values
  - KEY_ADUTOLERANCE
```
public static final String KEY_ADUTOLERANCE
```
    The tolerance in target adu if at exposure limit.
    
    See Also:
    
    Constant Field Values
  - KEY_ADUTWILIGHT
```
public static final String KEY_ADUTWILIGHT
```
    If we have sol sink parameter, we add/subtract this from targetadu.
    
    See Also:
    
    Constant Field Values
  - KEY_BIASADU
```
public static final String KEY_BIASADU
```
    The crude bias estimation of the quadrants.
    
    See Also:
    
    Constant Field Values
  - KEY_GAIN
```
public static final String KEY_GAIN
```
    The gains of the quadrants.
    
    See Also:
    
    Constant Field Values
  - KEY_USEQUADRANTS
```
public static final String KEY_USEQUADRANTS
```
    If that is given, only use these quadrants for averaging.
    
    See Also:
    
    Constant Field Values
  - KEY_TIMELOW
```
public static final String KEY_TIMELOW
```
    If exposure time falls below this limit, we increase the target adu.
    
    See Also:
    
    Constant Field Values
  - KEY_TIMEHIGH
```
public static final String KEY_TIMEHIGH
```
    If exposure time falls below this limit, we increase the target adu.
    
    See Also:
    
    Constant Field Values
  - DEFNAME
```
public static final String DEFNAME
```
    The default name.
    
    See Also:
    
    Constant Field Values
  - DEFFILTERLUX
```
private static final String DEFFILTERLUX
```
    The default lux-to-sec expressions for all filters.
    
    See Also:
    
    Constant Field Values
  - DEFLUXSENSOR
```
private static final String DEFLUXSENSOR
```
    The default lux value name.
    
    See Also:
    
    Constant Field Values
  - DEFTARGETADU
```
private static final String DEFTARGETADU
```
    The default adus for a good flat.
    
    See Also:
    
    Constant Field Values
  - DEFADUTOLERANCE
```
private static final double DEFADUTOLERANCE
```
    The default tolerance if on exposure edge.
    
    See Also:
    
    Constant Field Values
  - DEFADUTWILIGHT
```
private static final double DEFADUTWILIGHT
```
    The default tolerance if on exposure edge.
    
    See Also:
    
    Constant Field Values
  - DEFBIASADU
```
private static final String DEFBIASADU
```
    The default bias ADU per quadrant, measured on STELLA1, 12-07-10.
    
    See Also:
    
    Constant Field Values
  - DEFGAIN
```
private static final String DEFGAIN
```
    The default gains, measured 01-07-2010.
    
    See Also:
    
    Constant Field Values
  - DEFTIMELOW
```
private static final double DEFTIMELOW
```
    Default low time limit.
    
    See Also:
    
    Constant Field Values
  - DEFTIMEHIGH
```
private static final double DEFTIMEHIGH
```
    Default high time limit.
    
    See Also:
    
    Constant Field Values
  - luxtime
```
private Map<String,Function> luxtime
```
    The expressions on how we calculate from lux to exposure time.
  - usequad
```
private List<Integer> usequad
```
    If this is set, only these quadrants are used.
  - desired
```
private List<Double> desired
```
    All quadrant's target ADU for a good flat.
  - gain
```
private List<Double> gain
```
    All quadrant's target ADU for a good flat.
  - bias
```
private List<Double> bias
```
    All quadrants average bias level.
  - lux
```
private Value lux
```
    The parameter that delivers current sky brightness.
  - sunset
```
private SolSink sunset
```
    We allow to distinguish berween sun rise and sun set.
  - filter
```
private String filter
```
    The last filter registered.
  - pick
```
private long pick
```
    The time the target was chosen.
  - dolog
```
private boolean dolog
```
    For debugging purpose, a flag to write.
- Constructor Detail
  - FlatExposureTime
```
public FlatExposureTime(Map<String,String> prop)
```
    Construction of the flat exposure time calculator.
- Method Detail
  - init
```
public void init()
          throws InitException
```
    On init, we create the table for calculating the times.
    
    Specified by:
    
    init in interface Initializable
    
    Overrides:
    
    init in class AbstractFitsMomentsValue
    
    Throws:
    
    InitException
  - registerParameter
```
public void registerParameter(Parameter p)
```
    We register a parameter that delivers sky brightness. Preferrably it links directly to a brightness sensor, if none is present, a solz-dependancy can be used.
    
    Specified by:
    
    registerParameter in interface ParameterDepending
    
    Overrides:
    
    registerParameter in class AbstractFitsMomentsValue
  - registerTarget
```
public void registerTarget(TargetDefinition td)
```
    We register the target. Grabs the the target filter and grabs the current time-stamp to allow proper identification of the fits moments.
    
    Specified by:
    
    registerTarget in interface TargetDepending
  - getValue
```
public Number getValue()
```
    We get the estimated flat exposure time.
    
    Specified by:
    
    getValue in interface Value
  - getForTarget
```
public Number getForTarget(TargetDefinition td)
```
    If queried with a target, we always ignore the fits moments, as these cannot be valid.
    
    Specified by:
    
    getForTarget in interface TargetDependingParameter
    
    Specified by:
    
    getForTarget in interface TargetDependingValue
  - getExposureEstimate
```
private double getExposureEstimate(String f)
```
    Using the flat-field filter name and the fits moments, we estimate the best exposure time by using the average of the current fits compared to the target average in #KEY_TARGETLEVEL. If there is no prior fits average, we try to estimate the exposure time from the current light level.
  - getExposureLevelTime
```
private double getExposureLevelTime(double texp,
                                    List<CentralMoments> cm)
```
    From the average of the exposure, do the calculation for the time.
  - getLightLevelTime
```
private double getLightLevelTime(String f)
```
    We calculate an exposure time from the light sensor. This is done, if no prior flats in the desired filter has been exposed.

Class FlatExposureTime

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

Field Summary

Fields inherited from class stella.globals.AbstractFitsMomentsValue

Fields inherited from class stella.globals.AbstractTargetParameter

Fields inherited from class globals.parameter.AbstractParameter

Fields inherited from class util.PropertyResources

Fields inherited from class util.PropertyContainer

Fields inherited from interface util.PropertySupplying

Fields inherited from interface util.ResourceSupplying

Constructor Summary

Method Summary

Methods inherited from class stella.globals.AbstractFitsMomentsValue

Methods inherited from class stella.globals.AbstractTargetValue

Methods inherited from class stella.globals.AbstractTargetParameter

Methods inherited from class globals.parameter.AbstractParameter

Methods inherited from class util.PropertyResources

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Methods inherited from interface globals.Value

Methods inherited from interface globals.Parameter

Methods inherited from interface util.PropertySupplying

Methods inherited from interface globals.TargetDependingParameter

Field Detail

KEY_FILTERLUX

KEY_LUXSENSOR

KEY_SETUP

KEY_CONSTANT

KEY_TARGETADU

KEY_ADUTOLERANCE

KEY_ADUTWILIGHT

KEY_BIASADU

KEY_GAIN

KEY_USEQUADRANTS

KEY_TIMELOW

KEY_TIMEHIGH

DEFNAME

DEFFILTERLUX

DEFLUXSENSOR

DEFTARGETADU

DEFADUTOLERANCE

DEFADUTWILIGHT

DEFBIASADU

DEFGAIN

DEFTIMELOW

DEFTIMEHIGH

luxtime

usequad

desired

gain

bias

lux

sunset

filter

pick

dolog

Constructor Detail

FlatExposureTime

Method Detail

init

registerParameter

registerTarget

getValue

getForTarget

getExposureEstimate

getExposureLevelTime

getLightLevelTime