MasterMind

java.lang.Object
- util.PropertyContainer
- - util.PropertyResources
  - - util.rmi.RmiPropertyContainer
    - - util.rmi.AbstractRmiCaster
      - stella.CastingContainer
        
        stella.MasterMind

All Implemented Interfaces:

Cloneable, Runnable, Remote, RmiErrorCaster, RmiParameterClustering, SchedulerControlling, SchedulerLogging, TargetOfOpportunity, AlarmHandler, CancelRunnable, ExitCleaning, Initializable, PropertySupplying, Refreshing, ResourceSupplying, RmiCaster, RmiPropertyBearing, RmiStatusProviding
```
public class MasterMind
extends CastingContainer
implements AlarmHandler, Refreshing, CancelRunnable, Initializable, ExitCleaning, RmiParameterClustering, TargetOfOpportunity, SchedulerLogging, RmiStatusProviding, RmiErrorCaster
```
The entry class for the STELLA-SCS control system. Starting this class with
```
 java stella.MasterMind [properties.file]
 
```
launches the STELLA-SCS. The following properties are stored within the file, specified with these keys. Note that all keys linked to properties files (KEY_RECEIVER, KEY_RENDER, KEY_GLOBAL, KEY_ERROR, KEY_SEQUENCER, KEY_SCHEDULER, and KEY_LOGGER) require that a class is present in these properties. Only the most important keys are explained.
- KEY_RECEIVER (required): Matches to a comma-seperated list of properties files used to construct the command servers. The properties objects loaded from the specified files are used as an argument to the appropriate command servers. The properties must contain a class key that is used by the AbstractCommandLauncher class to actually instantiate the command server. Note that after construction, the command launcher must be ready to send commands. The number of property files in the list determines the number of command servers visible for the master mind. Note that due to the use of a single class as the command-server class, the properties of the generated objects must determine the type of command the server is willing to accept, see CommandLaunching.handles(stella.CommandEvent).
- KEY_RENDER (required): Links to the properties of a CommandRendering instance. This object is needed to convert generic sequencer steps to actual commands. E.g. positioning the telescope has a generic move telescope in the sequence steps, but the actual position has to be derived from the actual target. The command renderer does this job.
- KEY_GLOBAL (required): A parameter cluster that combines all data necessary for sequencing and scheduling. It comprises all data known to the system, ranging from weather data to telescope position.
- KEY_ERROR (required): The object responsible for error handling it must have access to the current observation sequence to take appropriate updates in the sequence if errors occur.
- KEY_SEQUENCER (required): This must point to a properties file describing an instantiable class implementing the Sequencing interface. Again, the class definition used for instantiating must be given in the properties file.
- KEY_SCHEDULER (required): Points to a properties file describing an instantiable class implementing the Scheduling interface. Again, the class definition used for instantiating must be given in the properties file.
- KEY_SERVER (optional): Allows the inclusion of a socket-based parameter server to the master mind. Java-based apllications may query the parameters directly. A parameter server listens on a specific port for parameter value requests. On query, the name of the parameter is read in from a socket connection and its value is writtn to it.
- KEY_LOGGER (optional): Points to a comma separated list of instantiable classes implementing the Logging interface. Loggers are created via a call to the AbstractLogger.createLogger(java.util.Map<java.lang.String, java.lang.String>) method, using the properties found in the list as arguments. All exisitng casters, i.e. the command servers, the weather watcher, its sensors and the sequencer and scheduler if these two classes are casters, are registered to the loggers.
In version 1.1, a simulation modus was added, KEY_SIMULATE. In simulation mode, the only differences to normal action are
- No device for relaying the commands are necessaary (i.e. construction of master mind does not fail due to missing command launchers.)
- No command renderer is necessary.
- If the scheduler returns null on the highest target, the time is advanced instead of thread sleep.
Different simulation modi are possible, either full-fledged simulation, where also commands are relayed to (simulated) peripherals, or simulation just for testing the scheduling. In the latter case, the sequencer should advance the time variable for the anicipated target observing time. The errorhandler can in principle used to mimic bad-weather siutautions.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

private static class MasterMind.Stamp
Class that holds the unique id plus the time stamp.
- Nested classes/interfaces inherited from class util.PropertyResources
  PropertyResources.Load, PropertyResources.URLResource

Nested Classes
Modifier and Type	Class and Description
`private static class`	`MasterMind.Stamp` Class that holds the unique id plus the time stamp.

Field Summary

Fields
Modifier and Type	Field and Description
`private boolean`	`cancel` True if the master mind should stop.
`private static boolean`	`DEFBIND` The default auto-binding as a `RemoteParameter`.
`private static String`	`DEFBINDNAME` Default binding name for a target mangager.
`private static long`	`DEFCANCELTIME` The default maximal wait for cancel time-out.
`private static boolean`	`DEFCLEANONEXIT` Defaults adds a shutdown hook.
`private static long`	`DEFCOOLDOWN` The default sleeping intervall, ms (600000).
`private static long`	`DEFINITDELAY` The default delay before starting the master mind.
`private static String`	`DEFLOGGERGROUP` The default name of the device trigger thread group (devicetrigger).
`private static boolean`	`DEFREMOVEDAUGHTERS` Per default remove all resolved daughters from the selectable list.
`private static boolean`	`DEFREMOVESUCCESSOR` On default, we remove successors from the selectable list.
`private static long`	`DEFRUNTIME` If true, master mind is in simulation modus.
`private static boolean`	`DEFSIMULATE` If true, master mind is in simulation modus.
`private static long`	`DEFSLEEP` The default sleeping intervall, ms (600000).
`private static String`	`DEFSTELLA` Default STELLA identifier.
`private static String`	`DEFTIME` The default name of the time parameter.
`private static long`	`DEFTIMEOUT` The default maximal wait for sequence completion, ms (12h).
`private static String`	`DEFTOO` The default name of the time parameter.
`private static long`	`DEFTOOALIVE` The default time a ToO is active (=able to be picked).
`private static String`	`DEFTWILIGHT` The default name of the time parameter.
`private static String`	`DEFUNIQUE` The default target list parameter.
`private static String`	`DEFURL` The default name of the url parameter.
`private Timer`	`devicetimer` The timer the device triggers run in.
`private ErrorHandling`	`errorhandler` The actual error handler object used.
`private ParameterServer`	`globalserver` The parameter server if any.
`private Map<String,ParsedTarget>`	`grb` A lookup table for ToOs.
`static String`	`GRBTEMPLATE`
`private static boolean`	`idle` A logging flag.
`static String`	`KEY_BIND` The key in the Map for auto-binding of the trigger.
`static String`	`KEY_CANCELTIME` The maximal wait for one sequence completion.
`static String`	`KEY_CLEANONEXIT` True, if the exit cleaner should act as a shutdown-hook.
`static String`	`KEY_COOLDOWN` The coll-down time after one object was finished.
`static String`	`KEY_ERROR` The key matching to the properties of the error handler.
`static String`	`KEY_GLOBAL` The key matching to the properties of the global parameter set.
`static String`	`KEY_INITDELAY` The sleep period before starting the master mind.
`static String`	`KEY_LOCALWEATHER` The key matching to the properties of a local weather station.
`static String`	`KEY_LOGGER` The key matching to the list of logger to use.
`static String`	`KEY_LOGGERGROUP` The key to the name of the device trigger thread group.
`static String`	`KEY_RANKMONITOR` An object that records and stores the scheduling history.
`static String`	`KEY_RECEIVER` The key to the properties of the service provider.
`static String`	`KEY_REMOVEDAUGHTERS` If true, remove resolved daughters.
`static String`	`KEY_REMOVESUCCESSOR` If true, remove resolved daughters.
`static String`	`KEY_RENDER` The key to the properties of the template to command translater.
`static String`	`KEY_RUNTIME` The maximum run-time, zero is run forever.
`static String`	`KEY_SCHEDULER` The key matching to the properties of the scheduler.
`static String`	`KEY_SEQUENCER` The key matching to the properties of the sequencer.
`static String`	`KEY_SERVER` The key matching to the properties of the global parameter set.
`static String`	`KEY_SIMULATE` If true, simulation modi is invoked.
`static String`	`KEY_SLEEP` The maximal sleep period between unsuccessful scheduler querries.
`static String`	`KEY_STELLA` The key to the telescope identifier.
`static String`	`KEY_TARGETLIST` The key matching to the target list parameter.
`static String`	`KEY_THREADNAME` The key matching to this master mind's thread name.
`static String`	`KEY_TIME` The name of the time parameter to use.
`static String`	`KEY_TIMEOUT` The maximal wait for one sequence completion.
`static String`	`KEY_TOO` The name of the too trigger to use.
`static String`	`KEY_TOOALIVE` The time a ToO is active.
`static String`	`KEY_TWILIGHT` The name of the twilight parameter to use.
`static String`	`KEY_UNIQUE` The key matching to the unique parameter.
`static String`	`KEY_URL` The name of the CCD-data URL parameter to use.
`static Object`	`LOCK` A locking object for various purposes.
`private static ThreadGroup`	`loggergroup` The thread group the loggers run in.
`private Logging[]`	`loggers` The loggers to use.
`private static MasterMind`	`mastermind` The static reference to the single master mind that is running.
`private static int`	`MASTERPRIORITY` The priority at `ExitCleaning` on error handler should occur.
`private static Thread`	`masterthread` The thread the master mind runs in.
`private ParameterClustering`	`parameters` The global parameter set.
`private RankingMonitor`	`rank` If we are moitoring the target's rankings.
`private CommandRendering`	`render` The command rendering object.
`private Map<String,Appointable>`	`runnables` On execution, we make runnable targets out of the target skeletons.
`private Scheduling`	`scheduler` The actual scheduling object used.
`private Sequencing<?>`	`sequencer` The actual sequencer object used.
`private CommandLaunching[]`	`servers` The array of command servers from the `KEY_RECEIVER` list.
`private TargetProviding<SporeTarget>`	`targetlist` The global target provider supplying skeleton targets.
`private Map<Appointable,MasterMind.Stamp>`	`timetable` A list of all targets in and their pick time.
`private WeatherSurveying`	`weather` A local weather station.

Fields inherited from class util.rmi.AbstractRmiCaster
ALTERNATEHOST, ALTERNATEPORT, KEY_BINDNAME, 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 util.ResourceSupplying
KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Fields inherited from interface util.PropertySupplying
CONFIG, KEY_CLASS

Constructor Summary

Constructors
Constructor and Description

MasterMind(Map<String,String> prop)
Constructs a new master mind with the given properties.

Constructors
Constructor and Description
`MasterMind(Map<String,String> prop)` Constructs a new master mind with the given properties.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`addMeritLog(String newtd)` Adds a single target for extensive merit logging.
`boolean`	`addTarget(TargetDefinition dom)` Remote interface for adding targets.
`private void`	`advanceTime(long sleep)` Advances the time if the time parameter is a `SettableTime` object.
`void`	`cancel()` Cancels execution of the master mind program.
`private boolean`	`children(ParsedTarget exe)`
`private void`	`createRunnablesFromList()`
`void`	`exit()` On exit, cancel me and exit all exit-cleaning sub-objects.
`private String`	`formatTime()` If we run in simulator mode, we return a formatted version of the simulator time here, otherwise we return an empty string.
`Collection<String>`	`getActive()` Returns all active IDs.
`Collection<TargetDefinition>`	`getAllTargets()` Returns a collection of all targets.
`Thread`	`getAsociatedThread()` Returns the thread asociated with the master mind.
`private static double`	`getFreeMemory()` Returns the free memory in k-bytes.
`long`	`getRefreshInterval()` Refresh intervall is one day.
`TargetDefinition`	`getTarget(String name)` Returns a single target specified by its name.
`String`	`getTelescope()` For remote queries on the telescope we operate.
`private long`	`getTime()` Returns the current time as a Long.
`private Unique`	`getUnique()` Returns the unique parameter.
`void`	`initMaster()` Inits the master mind.
`protected void`	`initOptional()` Initializes optional components of the master mind.
`protected void`	`initRequired()` Initializes the required components of the master mind.
`boolean`	`isFixedRate()` Always do this prior to nightfall.
`static boolean`	`isIdle()` Returns true, if last scheduler query has returned null.
`static boolean`	`isNighttime()` Returns true, if last scheduler query has returned null and the master mind thinks it's night time.
`List<String>`	`listAllTargets()` Lists the name of all targets.
`static void`	`main(String[] arg)` Starts the master mind with a `Properties` object constructed out of the first argument or with the default properties if no argument is given.
`long`	`maxTimeToCancel()` Returns the maximum time the master mind will need for canceling its thread.
`static boolean`	`nighttime()` Returns true, if the master mind thinks its night.
`Object`	`provideStatus()` Returns a status from the master.
`void`	`refresh()` Each night we clear the target list from surviving left-overs before proceeding.
`boolean`	`reloadTargets()` Reloads all targets.
`void`	`removeAllTargets()` Removes all targets.
`boolean`	`removeMeritLog(String newtd)` Removes the target from the scheduler's list.
`boolean`	`removeTarget(String name)` Remote interface for removing a target having the name.
`boolean`	`removeToo(String name)` Removes the target from the scheduler's list.
`private boolean`	`restoreFromList()`
`void`	`rmiAddParameter(URL resource)` Adds a parameter that is loadable from the given resource.
`Object`	`rmiGet(String name)` Returns the parameter's value as an object.
`Set<String>`	`rmiGetAllParameterNames()` Returns all names of the parameters this parameter set serves, tailored for RMI-access.
`Object`	`rmiProvideStatus()` Returns a status from the master.
`void`	`rmiRemoveParameter(String name)` Removes the parameter with the given name.
`Object`	`rmiSet(String name, Object to)` Sets the value of the parameter of the given name to the specified value.
`Serializable`	`rmiTooStatus(String id)` Returns a short description of the status of the GRB targets.
`void`	`run()` The run method of the master mind.
`private boolean`	`runOneSequence(TargetDefinition aux)` Runs a single sequence on a target.
`private boolean`	`runOneTarget(Appointable sub)` Runs a single target.
`void`	`setOff(String id)` Called if an ToO run out of its lifetime.
`protected void`	`startMaster()` Starts this master mind in an individual thread.
`private static String`	`statusProvider(StatusProviding stat)` Provides a generic status string for `StatusProviding` objects by returning thei class name folowed by the string representation of their status.
`boolean`	`triggerGrb(String id, double ra, double de, double exptime, boolean interrupt)` Passes to `triggerToo(java.lang.String, java.lang.String, double, double, double, boolean)` with the special grb template `GRBTEMPLATE`.
`boolean`	`triggerToo(String id, String templ, double ra, double de, double exptime, boolean interrupt)` This method expects the template to point to the serialized version of a parsed target.
`boolean`	`updateToo(String id, String field, Object to)` This method grabs the ToO from the internal list via the supplied id, checks, if the target has a specific field as specified in the second argument, and, if so, tries to update it.

Methods inherited from class stella.CastingContainer
addErrorListener, addRmiErrorListener, init, isValid, notifyErrorListener, removeErrorListener, removeRmiErrorListener, sendError, sendError, sendError, sendStatus, sendStatus, sendStatus

Methods inherited from class util.rmi.AbstractRmiCaster
bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, casterExit, casterExit, getBindName, getBindName, 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, toString

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface util.Initializable
init

Methods inherited from interface stella.rmi.RmiErrorCaster
addRmiErrorListener, removeRmiErrorListener

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
  - LOCK
```
public static final Object LOCK
```
    A locking object for various purposes. Anybody may use it.
  - GRBTEMPLATE
```
public static final String GRBTEMPLATE
```
    See Also:
    
    Constant Field Values
  - KEY_RENDER
```
public static final String KEY_RENDER
```
    The key to the properties of the template to command translater.
    
    See Also:
    
    Constant Field Values
  - KEY_RECEIVER
```
public static final String KEY_RECEIVER
```
    The key to the properties of the service provider.
    
    See Also:
    
    Constant Field Values
  - KEY_SEQUENCER
```
public static final String KEY_SEQUENCER
```
    The key matching to the properties of the sequencer.
    
    See Also:
    
    Constant Field Values
  - KEY_SCHEDULER
```
public static final String KEY_SCHEDULER
```
    The key matching to the properties of the scheduler.
    
    See Also:
    
    Constant Field Values
  - KEY_ERROR
```
public static final String KEY_ERROR
```
    The key matching to the properties of the error handler.
    
    See Also:
    
    Constant Field Values
  - KEY_GLOBAL
```
public static final String KEY_GLOBAL
```
    The key matching to the properties of the global parameter set.
    
    See Also:
    
    Constant Field Values
  - KEY_TARGETLIST
```
public static final String KEY_TARGETLIST
```
    The key matching to the target list parameter.
    
    See Also:
    
    Constant Field Values
  - KEY_REMOVEDAUGHTERS
```
public static final String KEY_REMOVEDAUGHTERS
```
    If true, remove resolved daughters.
    
    See Also:
    
    Constant Field Values
  - KEY_REMOVESUCCESSOR
```
public static final String KEY_REMOVESUCCESSOR
```
    If true, remove resolved daughters.
    
    See Also:
    
    Constant Field Values
  - KEY_UNIQUE
```
public static final String KEY_UNIQUE
```
    The key matching to the unique parameter.
    
    See Also:
    
    Constant Field Values
  - KEY_SIMULATE
```
public static final String KEY_SIMULATE
```
    If true, simulation modi is invoked.
    
    See Also:
    
    Constant Field Values
  - KEY_RUNTIME
```
public static final String KEY_RUNTIME
```
    The maximum run-time, zero is run forever.
    
    See Also:
    
    Constant Field Values
  - KEY_RANKMONITOR
```
public static final String KEY_RANKMONITOR
```
    An object that records and stores the scheduling history.
    
    See Also:
    
    Constant Field Values
  - KEY_LOGGER
```
public static final String KEY_LOGGER
```
    The key matching to the list of logger to use.
    
    See Also:
    
    Constant Field Values
  - KEY_SERVER
```
public static final String KEY_SERVER
```
    The key matching to the properties of the global parameter set.
    
    See Also:
    
    Constant Field Values
  - KEY_LOCALWEATHER
```
public static final String KEY_LOCALWEATHER
```
    The key matching to the properties of a local weather station.
    
    See Also:
    
    Constant Field Values
  - KEY_THREADNAME
```
public static final String KEY_THREADNAME
```
    The key matching to this master mind's thread name.
    
    See Also:
    
    Constant Field Values
  - KEY_LOGGERGROUP
```
public static final String KEY_LOGGERGROUP
```
    The key to the name of the device trigger thread group.
    
    See Also:
    
    Constant Field Values
  - KEY_TIME
```
public static final String KEY_TIME
```
    The name of the time parameter to use.
    
    See Also:
    
    Constant Field Values
  - KEY_TWILIGHT
```
public static final String KEY_TWILIGHT
```
    The name of the twilight parameter to use.
    
    See Also:
    
    Constant Field Values
  - KEY_TOO
```
public static final String KEY_TOO
```
    The name of the too trigger to use.
    
    See Also:
    
    Constant Field Values
  - KEY_TOOALIVE
```
public static final String KEY_TOOALIVE
```
    The time a ToO is active.
    
    See Also:
    
    Constant Field Values
  - KEY_URL
```
public static final String KEY_URL
```
    The name of the CCD-data URL parameter to use.
    
    See Also:
    
    Constant Field Values
  - KEY_INITDELAY
```
public static final String KEY_INITDELAY
```
    The sleep period before starting the master mind.
    
    See Also:
    
    Constant Field Values
  - KEY_COOLDOWN
```
public static final String KEY_COOLDOWN
```
    The coll-down time after one object was finished.
    
    See Also:
    
    Constant Field Values
  - KEY_SLEEP
```
public static final String KEY_SLEEP
```
    The maximal sleep period between unsuccessful scheduler querries.
    
    See Also:
    
    Constant Field Values
  - KEY_TIMEOUT
```
public static final String KEY_TIMEOUT
```
    The maximal wait for one sequence completion.
    
    See Also:
    
    Constant Field Values
  - KEY_CANCELTIME
```
public static final String KEY_CANCELTIME
```
    The maximal wait for one sequence completion.
    
    See Also:
    
    Constant Field Values
  - KEY_CLEANONEXIT
```
public static final String KEY_CLEANONEXIT
```
    True, if the exit cleaner should act as a shutdown-hook.
    
    See Also:
    
    Constant Field Values
  - KEY_BIND
```
public static final String KEY_BIND
```
    The key in the Map for auto-binding of the trigger.
    
    See Also:
    
    Constant Field Values
  - KEY_STELLA
```
public static final String KEY_STELLA
```
    The key to the telescope identifier.
    
    See Also:
    
    Constant Field Values
  - DEFLOGGERGROUP
```
private static final String DEFLOGGERGROUP
```
    The default name of the device trigger thread group (devicetrigger).
    
    See Also:
    
    Constant Field Values
  - DEFTIME
```
private static final String DEFTIME
```
    The default name of the time parameter.
    
    See Also:
    
    Constant Field Values
  - DEFTWILIGHT
```
private static final String DEFTWILIGHT
```
    The default name of the time parameter.
    
    See Also:
    
    Constant Field Values
  - DEFREMOVEDAUGHTERS
```
private static final boolean DEFREMOVEDAUGHTERS
```
    Per default remove all resolved daughters from the selectable list.
    
    See Also:
    
    Constant Field Values
  - DEFREMOVESUCCESSOR
```
private static final boolean DEFREMOVESUCCESSOR
```
    On default, we remove successors from the selectable list.
    
    See Also:
    
    Constant Field Values
  - DEFTOO
```
private static final String DEFTOO
```
    The default name of the time parameter.
    
    See Also:
    
    Constant Field Values
  - DEFTOOALIVE
```
private static final long DEFTOOALIVE
```
    The default time a ToO is active (=able to be picked).
    
    See Also:
    
    Constant Field Values
  - DEFURL
```
private static final String DEFURL
```
    The default name of the url parameter.
    
    See Also:
    
    Constant Field Values
  - DEFINITDELAY
```
private static final long DEFINITDELAY
```
    The default delay before starting the master mind.
    
    See Also:
    
    Constant Field Values
  - DEFCOOLDOWN
```
private static final long DEFCOOLDOWN
```
    The default sleeping intervall, ms (600000).
    
    See Also:
    
    Constant Field Values
  - DEFSLEEP
```
private static final long DEFSLEEP
```
    The default sleeping intervall, ms (600000).
    
    See Also:
    
    Constant Field Values
  - DEFTIMEOUT
```
private static final long DEFTIMEOUT
```
    The default maximal wait for sequence completion, ms (12h).
    
    See Also:
    
    Constant Field Values
  - DEFCANCELTIME
```
private static final long DEFCANCELTIME
```
    The default maximal wait for cancel time-out.
    
    See Also:
    
    Constant Field Values
  - DEFUNIQUE
```
private static final String DEFUNIQUE
```
    The default target list parameter.
    
    See Also:
    
    Constant Field Values
  - DEFSIMULATE
```
private static final boolean DEFSIMULATE
```
    If true, master mind is in simulation modus.
    
    See Also:
    
    Constant Field Values
  - DEFRUNTIME
```
private static final long DEFRUNTIME
```
    If true, master mind is in simulation modus.
    
    See Also:
    
    Constant Field Values
  - DEFCLEANONEXIT
```
private static final boolean DEFCLEANONEXIT
```
    Defaults adds a shutdown hook.
    
    See Also:
    
    Constant Field Values
  - DEFBIND
```
private static final boolean DEFBIND
```
    The default auto-binding as a RemoteParameter.
    
    See Also:
    
    Constant Field Values
  - DEFBINDNAME
```
private static final String DEFBINDNAME
```
    Default binding name for a target mangager.
    
    See Also:
    
    Constant Field Values
  - DEFSTELLA
```
private static final String DEFSTELLA
```
    Default STELLA identifier.
    
    See Also:
    
    Constant Field Values
  - render
```
private CommandRendering render
```
    The command rendering object. Converts templates into commands.
  - servers
```
private CommandLaunching[] servers
```
    The array of command servers from the KEY_RECEIVER list.
  - scheduler
```
private Scheduling scheduler
```
    The actual scheduling object used.
  - sequencer
```
private Sequencing<?> sequencer
```
    The actual sequencer object used.
  - errorhandler
```
private ErrorHandling errorhandler
```
    The actual error handler object used.
  - parameters
```
private ParameterClustering parameters
```
    The global parameter set. Used for scheduling and sequencing.
  - targetlist
```
private TargetProviding<SporeTarget> targetlist
```
    The global target provider supplying skeleton targets.
  - runnables
```
private Map<String,Appointable> runnables
```
    On execution, we make runnable targets out of the target skeletons.
  - rank
```
private RankingMonitor rank
```
    If we are moitoring the target's rankings.
  - timetable
```
private Map<Appointable,MasterMind.Stamp> timetable
```
    A list of all targets in and their pick time.
  - grb
```
private Map<String,ParsedTarget> grb
```
    A lookup table for ToOs.
  - globalserver
```
private ParameterServer globalserver
```
    The parameter server if any.
  - loggers
```
private Logging[] loggers
```
    The loggers to use. Started, registered, no further care.
  - weather
```
private WeatherSurveying weather
```
    A local weather station.
  - devicetimer
```
private Timer devicetimer
```
    The timer the device triggers run in.
  - cancel
```
private boolean cancel
```
    True if the master mind should stop.
  - mastermind
```
private static MasterMind mastermind
```
    The static reference to the single master mind that is running.
  - masterthread
```
private static Thread masterthread
```
    The thread the master mind runs in.
  - loggergroup
```
private static ThreadGroup loggergroup
```
    The thread group the loggers run in.
  - idle
```
private static boolean idle
```
    A logging flag.
  - MASTERPRIORITY
```
private static final int MASTERPRIORITY
```
    The priority at ExitCleaning on error handler should occur.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - MasterMind
```
public MasterMind(Map<String,String> prop)
           throws RemoteException
```
    Constructs a new master mind with the given properties. Initializes and starts the mastermind in two separated methods, initRequired() and initOptional() before startMaster().
    
    Throws:
    
    RemoteException
- Method Detail
  - initMaster
```
public void initMaster()
                throws MasterInitException
```
    Inits the master mind. Does not start the master, this must be done explicetly with a call to startMaster().
    
    Throws:
    
    MasterInitException
  - initRequired
```
protected void initRequired()
                     throws MasterInitException
```
    Initializes the required components of the master mind. Called immediately after construction. This method does the following (in the stated order):
    - Converts the KEY_RECEIVER mapping into a vector of devices properties files. Each property file is than used to construct a new CommandLaunching instance via a call to AbstractCommandLauncher.createCommandLauncher(java.util.Map). All command launcher are than comprised into an array.
    - Converts the KEY_RENDER mapping into a Map object and passes it to the static method AbstractCommandRenderer.createCommandRenderer(java.util.Map<java.lang.String, java.lang.String>). This method creates a new command rendering instance.
    - Converts the KEY_GLOBAL mapping into a Map object and passes it to the static method AbstractParameterCluster#createParameterCluster. This method creates a new parameter clustering instance.
    - Converts the KEY_ERROR mapping into a Map object and passes it to the static method AbstractErrorHandler.createErrorHandler(java.util.Map). This method creates a new error handling instance.
    - Converts the KEY_SEQUENCER mapping into a Map object and passes it to the static method AbstractSequencer.createSequencer(java.util.Map<java.lang.String, java.lang.String>). This method creates a new sequencer instance.
    - Converts the KEY_SCHEDULER mapping into a Map object and passes it to the static method AbstractScheduler.createScheduler(java.util.Map<java.lang.String, java.lang.String>). This method creates a new scheduler instance.
    If one of these essential constructs fails, a MasterInitException is thrown. After initializing is complete, the master mind is started via a call to startMaster().
    Throws:
    
    MasterInitException - If construction of either object fails.
  - initOptional
```
protected void initOptional()
```
    Initializes optional components of the master mind. This method is called immediately after the initialization of the required components of the master mind. It does the following
    - Constructs a parameter server. Any parameters in the parameter set are made available to the server. The server is started right after construction.
    - Converts the KEY_LOGGER mapping into a vector of logger properties files if present. Each property file is than used to construct a new Logging via a call to AbstractLogger.createLogger(java.util.Map<java.lang.String, java.lang.String>). All existing casters, i.e. the command servers, the weather watcher, it's sensors and the scheduler and sequencer are than registered at the loggers with a call to Logging.registerCaster(stella.Caster). Each logger is responsible to register itself to the appropriate caster if it wants to use the events it generates. After the registration process, the loggers are started within a demon thread-group loggergroup.
    Implementation note: Always construct the loggers as the last objects.
  - exit
```
public void exit()
```
    On exit, cancel me and exit all exit-cleaning sub-objects.
    
    Specified by:
    
    exit in interface ExitCleaning
    
    Overrides:
    
    exit in class CastingContainer
  - rmiGetAllParameterNames
```
public Set<String> rmiGetAllParameterNames()
                                    throws RemoteException
```
    Returns all names of the parameters this parameter set serves, tailored for RMI-access.
    
    Specified by:
    
    rmiGetAllParameterNames in interface RmiParameterClustering
    
    Throws:
    
    RemoteException
  - rmiGet
```
public Object rmiGet(String name)
              throws RemoteException
```
    Returns the parameter's value as an object. This method is tailored for rmi-access.
    
    Specified by:
    
    rmiGet in interface RmiParameterClustering
    
    Throws:
    
    RemoteException
  - rmiSet
```
public Object rmiSet(String name,
                     Object to)
              throws RemoteException
```
    Sets the value of the parameter of the given name to the specified value.
    
    Specified by:
    
    rmiSet in interface RmiParameterClustering
    
    Returns:
    
    The old parameter value.
    
    Throws:
    
    RemoteException
  - rmiAddParameter
```
public void rmiAddParameter(URL resource)
                     throws RemoteException
```
    Adds a parameter that is loadable from the given resource.
    
    Specified by:
    
    rmiAddParameter in interface RmiParameterClustering
    
    Throws:
    
    RemoteException
  - rmiRemoveParameter
```
public void rmiRemoveParameter(String name)
                        throws RemoteException
```
    Removes the parameter with the given name.
    
    Specified by:
    
    rmiRemoveParameter in interface RmiParameterClustering
    
    Throws:
    
    RemoteException
  - getTelescope
```
public String getTelescope()
                    throws RemoteException
```
    For remote queries on the telescope we operate.
    
    Specified by:
    
    getTelescope in interface SchedulerControlling
    
    Throws:
    
    RemoteException
  - addTarget
```
public boolean addTarget(TargetDefinition dom)
                  throws RemoteException
```
    Remote interface for adding targets.
    
    Specified by:
    
    addTarget in interface SchedulerControlling
    
    Returns:
    
    True, if a target was added
    
    Throws:
    
    RemoteException
  - removeTarget
```
public boolean removeTarget(String name)
                     throws RemoteException
```
    Remote interface for removing a target having the name.
    
    Specified by:
    
    removeTarget in interface SchedulerControlling
    
    Returns:
    
    True, if a target was removed.
    
    Throws:
    
    RemoteException
  - removeAllTargets
```
public void removeAllTargets()
                      throws RemoteException
```
    Removes all targets.
    
    Specified by:
    
    removeAllTargets in interface SchedulerControlling
    
    Throws:
    
    RemoteException
  - reloadTargets
```
public boolean reloadTargets()
                      throws RemoteException
```
    Reloads all targets.
    
    Specified by:
    
    reloadTargets in interface SchedulerControlling
    
    Returns:
    
    True, if a targets were restored.
    
    Throws:
    
    RemoteException
  - restoreFromList
```
private boolean restoreFromList()
```
    Returns:
  - addMeritLog
```
public boolean addMeritLog(String newtd)
                    throws RemoteException
```
    Adds a single target for extensive merit logging.
    
    Specified by:
    
    addMeritLog in interface SchedulerLogging
    
    Returns:
    
    True, if a target was added
    
    Throws:
    
    RemoteException
  - removeMeritLog
```
public boolean removeMeritLog(String newtd)
                       throws RemoteException
```
    Removes the target from the scheduler's list. The target is physically removed and cannot be restored except by re-adding it with the addTarget(target.TargetDefinition) method.
    
    Specified by:
    
    removeMeritLog in interface SchedulerLogging
    
    Returns:
    
    True, if a target was removed.
    
    Throws:
    
    RemoteException
  - getRefreshInterval
```
public long getRefreshInterval()
```
    Refresh intervall is one day.
    
    Specified by:
    
    getRefreshInterval in interface Refreshing
  - isFixedRate
```
public boolean isFixedRate()
```
    Always do this prior to nightfall.
    
    Specified by:
    
    isFixedRate in interface Refreshing
  - refresh
```
public void refresh()
```
    Each night we clear the target list from surviving left-overs before proceeding. This means that the state of the db is automatically reflected in the master-mind.
    
    Specified by:
    
    refresh in interface Refreshing
  - listAllTargets
```
public List<String> listAllTargets()
                            throws RemoteException
```
    Lists the name of all targets. This is a list rather than a collection as Strings provide a natural ordering, which can later be enforced on this list. Additionally, if a collection is the view of the values in a mapping, this view is not serializable, thus remote access will fail.
    
    Specified by:
    
    listAllTargets in interface SchedulerControlling
    
    Throws:
    
    RemoteException
  - getAllTargets
```
public Collection<TargetDefinition> getAllTargets()
                                           throws RemoteException
```
    Returns a collection of all targets. Additionally, if a collection is the view of the values in a mapping, this view is not serializable, thus remote access will fail.
    
    Specified by:
    
    getAllTargets in interface SchedulerControlling
    
    Throws:
    
    RemoteException
  - getTarget
```
public TargetDefinition getTarget(String name)
                           throws RemoteException
```
    Returns a single target specified by its name.
    
    Specified by:
    
    getTarget in interface SchedulerControlling
    
    Throws:
    
    RemoteException
  - rmiProvideStatus
```
public Object rmiProvideStatus()
                        throws RemoteException
```
    Returns a status from the master. This is the string version of all known status providers.
    
    Specified by:
    
    rmiProvideStatus in interface RmiStatusProviding
    
    Throws:
    
    RemoteException
  - provideStatus
```
public Object provideStatus()
```
    Returns a status from the master. This is the string version of all known status providers.
  - triggerGrb
```
public boolean triggerGrb(String id,
                          double ra,
                          double de,
                          double exptime,
                          boolean interrupt)
                   throws RemoteException
```
    Passes to triggerToo(java.lang.String, java.lang.String, double, double, double, boolean) with the special grb template GRBTEMPLATE.
    
    Specified by:
    
    triggerGrb in interface TargetOfOpportunity
    
    Parameters:
    
    id - A unique identifier for the GRB, can be a count number.
    
    ra - The right ascension of the GRB, degrees, J2000.0
    
    de - The declination of the GRB, degrees, J2000.0.
    
    exptime - The initial exposure time in seconds.
    
    interrupt - If true, ongoing observation should be canceled.
    
    Returns:
    
    True, if the new target could be created.
    
    Throws:
    
    RemoteException
  - triggerToo
```
public boolean triggerToo(String id,
                          String templ,
                          double ra,
                          double de,
                          double exptime,
                          boolean interrupt)
                   throws RemoteException
```
    This method expects the template to point to the serialized version of a parsed target. After deserialization, the name is set according to the id, and the ra and de of the main star is updated. If successful, the target is added to the grb lookup table. Then, the exposure time is updated via a call to updateToo(java.lang.String, java.lang.String, java.lang.Object). This method also updates the scheduler. Currently, the interrupt flag is ignored, but in future version, an exception could be generated as the final step, triggering the scheduler to get the next highest target, which is then the GRB.
    
    Specified by:
    
    triggerToo in interface TargetOfOpportunity
    
    Parameters:
    
    id - A unique identifier for the GRB, can be a count number.
    
    templ - A resource description that describes the ToO to use.
    
    ra - The right ascension of the GRB, degrees, J2000.0
    
    de - The declination of the GRB, degrees, J2000.0.
    
    exptime - The initial exposure time in seconds.
    
    interrupt - If true, ongoing observation should be canceled.
    
    Returns:
    
    True, if the new target could be created.
    
    Throws:
    
    RemoteException
  - setOff
```
public void setOff(String id)
```
    Called if an ToO run out of its lifetime. The id is the GRB id.
    
    Specified by:
    
    setOff in interface AlarmHandler
  - updateToo
```
public boolean updateToo(String id,
                         String field,
                         Object to)
                  throws RemoteException
```
    This method grabs the ToO from the internal list via the supplied id, checks, if the target has a specific field as specified in the second argument, and, if so, tries to update it.
    This method calls SporeTarget.getSetups() and scans through all the constants in all setups for a constant of the given field name. If a constant is found, it is updated to the supplied object. If everything is successful, the target is reloaded into the scheduler.
    
    Specified by:
    
    updateToo in interface TargetOfOpportunity
    
    Parameters:
    
    id - The id used on creation of the GRB.
    
    field - The name of the field to be updated.
    
    to - The new value of the field, possible a Number or String.
    
    Returns:
    
    True, if the field was updated successfully.
    
    Throws:
    
    RemoteException
  - removeToo
```
public boolean removeToo(String name)
                  throws RemoteException
```
    Removes the target from the scheduler's list. The target is physically removed and cannot be restored except by re-adding it with the addTarget(target.TargetDefinition) method.
    
    Specified by:
    
    removeToo in interface TargetOfOpportunity
    
    Returns:
    
    True, if a target was removed.
    
    Throws:
    
    RemoteException
  - getActive
```
public Collection<String> getActive()
                             throws RemoteException
```
    Returns all active IDs.
    
    Specified by:
    
    getActive in interface TargetOfOpportunity
    
    Returns:
    
    a collection of ToO id's.
    
    Throws:
    
    RemoteException
  - rmiTooStatus
```
public Serializable rmiTooStatus(String id)
                          throws RemoteException
```
    Returns a short description of the status of the GRB targets.
    
    Specified by:
    
    rmiTooStatus in interface TargetOfOpportunity
    
    Throws:
    
    RemoteException
  - statusProvider
```
private static String statusProvider(StatusProviding stat)
```
    Provides a generic status string for StatusProviding objects by returning thei class name folowed by the string representation of their status.
  - startMaster
```
protected void startMaster()
```
    Starts this master mind in an individual thread. Called after initialization of all necessary components of the master mind has been initialized.
  - createRunnablesFromList
```
private void createRunnablesFromList()
```
  - children
```
private boolean children(ParsedTarget exe)
```
  - run
```
public void run()
```
    The run method of the master mind. This method loops forever until the cancel method is called. It does the following:
    
    Specified by:
    
    run in interface Runnable
  - cancel
```
public void cancel()
```
    Cancels execution of the master mind program. Will get effective after the current observation has finished. Cancels also the device checking timer.
    
    Specified by:
    
    cancel in interface CancelRunnable
  - isIdle
```
public static boolean isIdle()
```
    Returns true, if last scheduler query has returned null. Intended for logging purposes of non-MasterMind childrens.
  - isNighttime
```
public static boolean isNighttime()
```
    Returns true, if last scheduler query has returned null and the master mind thinks it's night time.
  - nighttime
```
public static boolean nighttime()
```
    Returns true, if the master mind thinks its night. This returnes true if the twilight parameter returns negative number or is undefined.
  - getAsociatedThread
```
public Thread getAsociatedThread()
```
    Returns the thread asociated with the master mind.
    
    Specified by:
    
    getAsociatedThread in interface CancelRunnable
  - maxTimeToCancel
```
public long maxTimeToCancel()
```
    Returns the maximum time the master mind will need for canceling its thread.
    
    Specified by:
    
    maxTimeToCancel in interface CancelRunnable
  - runOneTarget
```
private boolean runOneTarget(Appointable sub)
```
    Runs a single target. Reentrant. Dives into the daughters of the target until no further daugther is found. Only then the single target execution runOneSequence(target.TargetDefinition) starts. Returns only if the target has no unfinished Successor and no parent.
  - runOneSequence
```
private boolean runOneSequence(TargetDefinition aux)
```
    Runs a single sequence on a target. The parent classes are also given. If the sequence is run on a generic target, those two parent classes are equal to the last target.
    
    Parameters:
    
    aux - The target to run the sequence on.
    
    Returns:
    
    The outcome of the sequence
  - getUnique
```
private Unique getUnique()
```
    Returns the unique parameter.
  - getTime
```
private long getTime()
```
    Returns the current time as a Long. If no parameter matching the time parameter can be found, the system time is used.
  - formatTime
```
private String formatTime()
```
    If we run in simulator mode, we return a formatted version of the simulator time here, otherwise we return an empty string.
  - advanceTime
```
private void advanceTime(long sleep)
```
    Advances the time if the time parameter is a SettableTime object. Otherwise we sleep for the anticipated period.
  - getFreeMemory
```
private static double getFreeMemory()
```
    Returns the free memory in k-bytes.
  - main
```
public static void main(String[] arg)
                 throws MasterInitException,
                        RemoteException
```
    Starts the master mind with a Properties object constructed out of the first argument or with the default properties if no argument is given.
    
    Throws:
    
    MasterInitException
    
    RemoteException

Class MasterMind

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

Field Summary

Fields inherited from class util.rmi.AbstractRmiCaster

Fields inherited from class util.PropertyResources

Fields inherited from class util.PropertyContainer

Fields inherited from interface util.ResourceSupplying

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class stella.CastingContainer

Methods inherited from class util.rmi.AbstractRmiCaster

Methods inherited from class util.rmi.RmiPropertyContainer

Methods inherited from class util.PropertyResources

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Methods inherited from interface util.Initializable

Methods inherited from interface stella.rmi.RmiErrorCaster

Methods inherited from interface util.rmi.RmiCaster

Methods inherited from interface util.PropertySupplying

Field Detail

LOCK

GRBTEMPLATE

KEY_RENDER

KEY_RECEIVER

KEY_SEQUENCER

KEY_SCHEDULER

KEY_ERROR

KEY_GLOBAL

KEY_TARGETLIST

KEY_REMOVEDAUGHTERS

KEY_REMOVESUCCESSOR

KEY_UNIQUE

KEY_SIMULATE

KEY_RUNTIME

KEY_RANKMONITOR

KEY_LOGGER

KEY_SERVER

KEY_LOCALWEATHER

KEY_THREADNAME

KEY_LOGGERGROUP

KEY_TIME

KEY_TWILIGHT

KEY_TOO

KEY_TOOALIVE

KEY_URL

KEY_INITDELAY

KEY_COOLDOWN

KEY_SLEEP

KEY_TIMEOUT

KEY_CANCELTIME

KEY_CLEANONEXIT

KEY_BIND

KEY_STELLA

DEFLOGGERGROUP

DEFTIME

DEFTWILIGHT

DEFREMOVEDAUGHTERS

DEFREMOVESUCCESSOR

DEFTOO

DEFTOOALIVE

DEFURL

DEFINITDELAY

DEFCOOLDOWN

DEFSLEEP

DEFTIMEOUT

DEFCANCELTIME

DEFUNIQUE

DEFSIMULATE

DEFRUNTIME

DEFCLEANONEXIT

DEFBIND

DEFBINDNAME

DEFSTELLA

render

servers

scheduler

sequencer

errorhandler