FlatGroup

java.lang.Object
- util.PropertyContainer
- - util.PropertyResources
  - - globals.parameter.AbstractParameter
    - - stella.globals.FlatGroup

All Implemented Interfaces:

Parameter, Cloneable, ExitCleaning, Initializable, PropertySupplying, Refreshing, ResourceSupplying
```
public class FlatGroup
extends AbstractParameter
implements Refreshing
```
This parameter conducts the automatic selection of twilight sky flats.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class FlatGroup.Db
Test class that retrieves statistic from db and prints it out.
- Nested classes/interfaces inherited from class util.PropertyResources
  PropertyResources.Load, PropertyResources.URLResource

Nested Classes
Modifier and Type	Class and Description
`static class`	`FlatGroup.Db` Test class that retrieves statistic from db and prints it out.

Field Summary

Fields
Modifier and Type	Field and Description
`private List<String>`	`dawn` All flat objects in dawn (sun rising).
`static String`	`DAWN` Default object start name for dusk flat groups.
`private static String`	`DEFFILTERLIST` The list of filters served.
`private static String`	`DEFFLATGROUPS` The name of the flat group versus its members.
`private static String`	`DEFFLATMEMBERS` For each filter in filterlist the sky-flat targets to check.
`private static String`	`DEFFLATTYPES` This types indicate flat fields.
`private static String`	`DEFGROUPDEFAULT` Order imposed if multiple groups remain.
`static String`	`DEFNAME` Default name of this parameter.
`private static String`	`DEFPRIORITYDEFAULT` The default filter priority list.
`private static String`	`DEFSCIENCETYPES` These types indicate science targets.
`private static String`	`DEFSETUPIDS` These setups may contain the filter definition.
`private static String`	`DEFTELESCOPE` The name of the telescope for db access.
`private List<String>`	`dusk` All flat objects in dusk (sun setting).
`static String`	`DUSK` Default object start name for dusk flat groups.
`private Map<String,Date>`	`flat` The mapping of served flat objects names to dates of last flat fields.
`private Map<String,List<String>>`	`groups` For each filter group name, we have the list of filters in it.
`private boolean`	`havedusk` Gets true on first announcement that we had a successful dusk group.
`private HistorySql`	`hsql` The done db.
`static String`	`KEY_DAWNFLAT` If explicitly set, this is the list of object names at dawn.
`static String`	`KEY_DUSKFLAT` If explicitly set, this is the list of object names at dusk.
`static String`	`KEY_FILTERLIST` The list of filters served.
`static String`	`KEY_FLATGROUPS` The name of the flat group versus its members.
`static String`	`KEY_FLATMEMBERS` For each filter in filterlist the sky-flat targets to check.
`static String`	`KEY_FLATTYPES` This types indicate flat fields.
`static String`	`KEY_GROUPDEFAULT` Order imposed if multiple groups remain.
`static String`	`KEY_HISTORYDB` This are the done database properties, if needed.
`static String`	`KEY_OBSERVEDB` This are the obs database properties, if needed.
`static String`	`KEY_PRIORITYDEFAULT` The default filter priority list.
`static String`	`KEY_SETUPIDS` These setups may contain the filter definition.
`static String`	`KEY_TELESCOPE` The name of the telescope for db access.
`private Map<String,List<String>>`	`members` The mapping of filter names to sky flat target name lists.
`private boolean`	`nodusk` Gets true on first announcement that we had no dusk group.
`private boolean`	`noobs`

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

FlatGroup(Map<String,String> prop)
Constructs a new flat group parameter object, defaulting all values.

Constructors
Constructor and Description
`FlatGroup(Map<String,String> prop)` Constructs a new flat group parameter object, defaulting all values.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Object`	`get()` The filter group is determined by grabbing the filters in the priority order and than selecting a filter group out of all.
`private Object`	`getFilterGroup(String filter)` Returns the filter group this filter is in.
`private Object`	`getOldestGroup()`
`long`	`getRefreshInterval()` We are a cron for noon.
`void`	`init()` On init, we update our current knowledge of recently observed filters and flats by refreshing.
`boolean`	`isFixedRate()` We are a cron for noon.
`void`	`refresh()` We update the list of observed filters and successfully executed flat fields.
`private List<String>`	`screen(List<String> from, String filt)` In a non-destructive way we screen all entries from the provided list that refer to a flat group name that has the filter in question not in it.
`Object`	`set(Object no)` Sets the value of this parameter.
`private boolean`	`updateFlats()` For each filter in our sky-flat memeber list we check for the last successful observation and keep the most actual one.

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 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
  - DUSK
```
public static final String DUSK
```
    Default object start name for dusk flat groups.
    
    See Also:
    
    Constant Field Values
  - DAWN
```
public static final String DAWN
```
    Default object start name for dusk flat groups.
    
    See Also:
    
    Constant Field Values
  - KEY_TELESCOPE
```
public static final String KEY_TELESCOPE
```
    The name of the telescope for db access.
    
    See Also:
    
    Constant Field Values
  - KEY_FILTERLIST
```
public static final String KEY_FILTERLIST
```
    The list of filters served.
    
    See Also:
    
    Constant Field Values
  - KEY_FLATGROUPS
```
public static final String KEY_FLATGROUPS
```
    The name of the flat group versus its members.
    
    See Also:
    
    Constant Field Values
  - KEY_GROUPDEFAULT
```
public static final String KEY_GROUPDEFAULT
```
    Order imposed if multiple groups remain.
    
    See Also:
    
    Constant Field Values
  - KEY_FLATMEMBERS
```
public static final String KEY_FLATMEMBERS
```
    For each filter in filterlist the sky-flat targets to check.
    
    See Also:
    
    Constant Field Values
  - KEY_SETUPIDS
```
public static final String KEY_SETUPIDS
```
    These setups may contain the filter definition.
    
    See Also:
    
    Constant Field Values
  - KEY_PRIORITYDEFAULT
```
public static final String KEY_PRIORITYDEFAULT
```
    The default filter priority list.
    
    See Also:
    
    Constant Field Values
  - KEY_FLATTYPES
```
public static final String KEY_FLATTYPES
```
    This types indicate flat fields.
    
    See Also:
    
    Constant Field Values
  - KEY_HISTORYDB
```
public static final String KEY_HISTORYDB
```
    This are the done database properties, if needed.
    
    See Also:
    
    Constant Field Values
  - KEY_OBSERVEDB
```
public static final String KEY_OBSERVEDB
```
    This are the obs database properties, if needed.
    
    See Also:
    
    Constant Field Values
  - KEY_DUSKFLAT
```
public static final String KEY_DUSKFLAT
```
    If explicitly set, this is the list of object names at dusk.
    
    See Also:
    
    Constant Field Values
  - KEY_DAWNFLAT
```
public static final String KEY_DAWNFLAT
```
    If explicitly set, this is the list of object names at dawn.
    
    See Also:
    
    Constant Field Values
  - DEFNAME
```
public static final String DEFNAME
```
    Default name of this parameter.
    
    See Also:
    
    Constant Field Values
  - DEFTELESCOPE
```
private static final String DEFTELESCOPE
```
    The name of the telescope for db access.
    
    See Also:
    
    Constant Field Values
  - DEFFILTERLIST
```
private static final String DEFFILTERLIST
```
    The list of filters served.
    
    See Also:
    
    Constant Field Values
  - DEFFLATGROUPS
```
private static final String DEFFLATGROUPS
```
    The name of the flat group versus its members.
    
    See Also:
    
    Constant Field Values
  - DEFGROUPDEFAULT
```
private static final String DEFGROUPDEFAULT
```
    Order imposed if multiple groups remain.
    
    See Also:
    
    Constant Field Values
  - DEFFLATMEMBERS
```
private static final String DEFFLATMEMBERS
```
    For each filter in filterlist the sky-flat targets to check.
    
    See Also:
    
    Constant Field Values
  - DEFSETUPIDS
```
private static final String DEFSETUPIDS
```
    These setups may contain the filter definition.
    
    See Also:
    
    Constant Field Values
  - DEFPRIORITYDEFAULT
```
private static final String DEFPRIORITYDEFAULT
```
    The default filter priority list.
    
    See Also:
    
    Constant Field Values
  - DEFFLATTYPES
```
private static final String DEFFLATTYPES
```
    This types indicate flat fields.
    
    See Also:
    
    Constant Field Values
  - DEFSCIENCETYPES
```
private static final String DEFSCIENCETYPES
```
    These types indicate science targets.
    
    See Also:
    
    Constant Field Values
  - members
```
private Map<String,List<String>> members
```
    The mapping of filter names to sky flat target name lists.
  - groups
```
private Map<String,List<String>> groups
```
    For each filter group name, we have the list of filters in it.
  - flat
```
private Map<String,Date> flat
```
    The mapping of served flat objects names to dates of last flat fields.
  - dusk
```
private List<String> dusk
```
    All flat objects in dusk (sun setting).
  - dawn
```
private List<String> dawn
```
    All flat objects in dawn (sun rising).
  - hsql
```
private transient HistorySql hsql
```
    The done db.
  - nodusk
```
private boolean nodusk
```
    Gets true on first announcement that we had no dusk group.
  - havedusk
```
private boolean havedusk
```
    Gets true on first announcement that we had a successful dusk group.
  - noobs
```
private boolean noobs
```
- Constructor Detail
  - FlatGroup
```
public FlatGroup(Map<String,String> prop)
```
    Constructs a new flat group parameter object, defaulting all values.
- Method Detail
  - init
```
public void init()
          throws InitException
```
    On init, we update our current knowledge of recently observed filters and flats by refreshing. Additionally, the lookup table matching filter names to available sky-flat group names is initialized and the noon-refresh is initialized.
    
    Specified by:
    
    init in interface Initializable
    
    Overrides:
    
    init in class AbstractParameter
    
    Throws:
    
    InitException
  - get
```
public Object get()
```
    The filter group is determined by grabbing the filters in the priority order and than selecting a filter group out of all. This is done by first using all filter groups available, then discarding all that do not hold the highest priority target. This will leave a list with more than a single entry. We proceed with the next filters in the priority list, now discarding from this already smaller list until only a single element list remains or no more filter are available. Filters that would empty the list completely are ignored, if even after the last filter more than a single filter group prevails, the one higher up in the default list is chosen.
    
    Specified by:
    
    get in interface Parameter
  - getOldestGroup
```
private Object getOldestGroup()
```
  - getFilterGroup
```
private Object getFilterGroup(String filter)
```
    Returns the filter group this filter is in.
  - set
```
public Object set(Object no)
```
    Description copied from interface: Parameter
    
    Sets the value of this parameter.
    
    Specified by:
    
    set in interface Parameter
    
    Returns:
    
    The previous value of this parameter.
  - refresh
```
public void refresh()
```
    We update the list of observed filters and successfully executed flat fields.
    
    Specified by:
    
    refresh in interface Refreshing
  - isFixedRate
```
public boolean isFixedRate()
```
    We are a cron for noon.
    
    Specified by:
    
    isFixedRate in interface Refreshing
  - getRefreshInterval
```
public long getRefreshInterval()
```
    We are a cron for noon.
    
    Specified by:
    
    getRefreshInterval in interface Refreshing
  - screen
```
private List<String> screen(List<String> from,
                            String filt)
```
    In a non-destructive way we screen all entries from the provided list that refer to a flat group name that has the filter in question not in it.
  - updateFlats
```
private boolean updateFlats()
                     throws InitException
```
    For each filter in our sky-flat memeber list we check for the last successful observation and keep the most actual one.
    
    Throws:
    
    InitException

Class FlatGroup

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

Field Summary

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

Field Detail

DUSK

DAWN

KEY_TELESCOPE

KEY_FILTERLIST

KEY_FLATGROUPS

KEY_GROUPDEFAULT

KEY_FLATMEMBERS

KEY_SETUPIDS

KEY_PRIORITYDEFAULT

KEY_FLATTYPES

KEY_HISTORYDB

KEY_OBSERVEDB

KEY_DUSKFLAT

KEY_DAWNFLAT

DEFNAME

DEFTELESCOPE

DEFFILTERLIST

DEFFLATGROUPS

DEFGROUPDEFAULT

DEFFLATMEMBERS

DEFSETUPIDS

DEFPRIORITYDEFAULT

DEFFLATTYPES

DEFSCIENCETYPES

members

groups

flat

dusk

dawn

hsql

nodusk

havedusk

noobs

Constructor Detail

FlatGroup

Method Detail

init

get

getOldestGroup

getFilterGroup

set

refresh

isFixedRate

getRefreshInterval

screen

updateFlats