stella.auxiliary

Class AuxiliarySimulator

java.lang.Object

util.PropertyContainer

util.PropertyResources

util.rmi.RmiPropertyContainer

util.rmi.AbstractRmiListener

stella.rmi.AbstractRmiCasterAndListener

stella.rmi.ReceiverTorso

stella.rmi.GenericSimulator

stella.auxiliary.AuxiliarySimulator

All Implemented Interfaces:

Cloneable, Remote, EventListener, Caster, ErrorSending, ErrorCaster, RmiAcknowledgeCaster, RmiCommandListener, RmiDoneCaster, RmiErrorCaster, ExitCleaning, PropertySupplying, ResourceSupplying, RmiCaster, RmiEventListener, RmiListener, RmiPropertyBearing, StepInitializable

public class AuxiliarySimulator
extends GenericSimulator

Simulates the action of the adapter.

• Throws out-of command errors like DropTarget, LostGuiding , LostTarget, NoCalibrationUnit, NoFlatFieldSwitch, NoGuiding, and RegainedGuiding. LostGuiding may only be issued if adapter is in guiding mode, after a StartGuidingAuxiliary and guiding is not already lost. LostTarget may be issued if adapter is in guiding mode, regardless if it lost guiding, but only if target was not already lost. DropTarget is issued in a lost-guiding or lost-target situation. RegainedGuiding is only issued after guiding or target has been lost. The other three errors may be issued at any time. To allow testing of the call-back query (if the adapter needs the telescope azimuth), a special error is introduced RequestTelescopePosition. This error is scheduled out of the command cycle and captured in the isAllowed(stella.ErrorEvent) method in a way that during guiding the remote paramters are queried and the values retrieved are stored locally (for status commands). For this error, isAllowed(stella.ErrorEvent) always returns false, because it is not a regular error that should be thrown at any time.
• Understands the AcquireAuxiliary, CalibrationOnAuxiliary, CalibrationOffAuxiliary, ExposeAuxiliary, FindAuxiliary, FlatFieldOnAuxiliary, FlatFieldOffAuxiliary, InitAuxiliary, ParkAuxiliary, SelectFilterAuxiliary, StartGuidingAuxiliary, StopGuidingAuxiliary, and StatusAuxiliary commands. See processCommand(stella.CommandEvent, int) for details.
• The number of acknowledge messages sent back equals the CommandEvent.getExpectedAcknowledgeNumber().
• No remote parameters are supported, but the telescope altitude and azimuth and also the focus position must be rmi-accessible..

Nested Class Summary

Nested classes/interfaces inherited from class stella.rmi.ReceiverTorso

ReceiverTorso.CommandHandler

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private static String[]	ACKTIMES The acknowledge times, same order as commands.
private static String[]	COMMANDS The known command types, used for acknowledges and true dones.
private static String	DEFALTVALUE The default name of the telescope altitude value.
private static String	DEFAZVALUE The default name of the telescope azimuth value.
private static String	DEFERRORCLASSES The default error list.
private static String	DEFERRORPROBABILITIES The default error probabilities.
private static double	DEFFAILAMBIGUOUS The default error list.
private static double	DEFFAILEXPOSE The default error list.
private static double	DEFFAILGUIDE The default error list.
private static double	DEFFAILINIT The default error list.
private static double	DEFFAILSTAR The default error list.
private static double	DEFMAGNITUDE The default error list.
private static long	DEFREADOUTTIME The default error list.
private static String[]	DIVERT The divergence factors for the simulation times of the commands.
private static String[]	DONETIMES The actual simulation times for the commands.
private Trigger	guide The is-guiding trigger.
private boolean	guidingdead True, if a no-guiding error was thrown.
static String	KEY_ALTVALUE The key to the value naming altitude of the telescope.
static String	KEY_AZVALUE The key to the value naming azimuth of the telescope.
static String	KEY_FAILAMBIGUOUS The probability of seeing an ambiguous star pattern on acquire.
static String	KEY_FAILEXPOSE The key to the failure probability of the guider.
static String	KEY_FAILGUIDE The key to the failure probability of the guider.
static String	KEY_FAILINIT The key to the failure probability of the initialization process.
static String	KEY_FAILSTAR The probability of not seeing a star on acquire.
static String	KEY_MAGNITUDE The probability of a star-too-faint on the guider.
static String	KEY_READOUTTIME The key to the readout time of the ST-7.
private ErrorEvent	lasterror The last error occured.
private Trigger	lostguide The guiding-lost trigger.
private Trigger	losttarget The target-lost trigger.

Fields inherited from class stella.rmi.GenericSimulator

ACKNOWLEDGEPREFIX, DEFUNIQUE, DEVIATEPREFIX, DONEPREFIX, KEY_ACCELERATE, KEY_ERRORCLASSES, KEY_ERRORINTERVAL, KEY_ERRORPROBABILITIES, KEY_GENERICACKNOWLEDGE, KEY_GENERICDEVIATE, KEY_GENERICDONE, KEY_SET, KEY_UNIQUE, random

Fields inherited from class stella.rmi.ReceiverTorso

KEY_BIND, KEY_BINDNAME, KEY_COMMANDCASTER, KEY_ERRORCOOL

Fields inherited from class util.rmi.AbstractRmiListener

KEY_ALIVE, KEY_EXPORTPORT, KEY_INIT, KEY_LISTENERNAME, KEY_RETRY, KEY_RETRYSLEEP, KEY_SHUTDOWNDELAY

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 stella.rmi.RmiAcknowledgeCaster

NAMING_EXTENSION

Fields inherited from interface stella.rmi.RmiDoneCaster

NAMING_EXTENSION

Fields inherited from interface util.StepInitializable

KEY_INITDEPTH

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
AuxiliarySimulator(Map prop) Constructs a new adapter simulator.

Method Summary

Modifier and Type	Method and Description
boolean	accepts(CommandEvent ce) Returns true if this receiver accepts commands of the type handed over as an argument.
protected long	getCompletionTime(CommandEvent ce, int acknr) Returns the completion time.
protected ErrorEvent	getLastError(CommandEvent ce) Returns the last error that occured during command processing.
protected long	getSimulationTime(CommandEvent ce, int acknr) Returns the simulation time.
private void	init5() We delay the initialization of the remote values to the last stages of the intialization to avoid blocking.
void	initStep(int curstep) We delay the initialization of the remote values to the last stages of the intialization to avoid blocking.
protected boolean	isAllowed(ErrorEvent ee) Returns true if the error handed over is allowed.
static void	main(String[] arg) Constructs a new adapter simulator.
private static Map	myAugment(Map def) Augmentes the properties for the acknowledge, done, and divert times.
protected boolean	processCommand(CommandEvent ce, int acknr) Simulates execution of the adapter commands.

Methods inherited from class stella.rmi.GenericSimulator

augmentProperties, exit, formatWithGlobals, getAcknowledgeNumber, getNoisyTime, getParameter, getParameterByKey, getParameterByName, getParameterCluster, getParameterValueByKey, getParameterValueByName, getTrigger, getUnique, getValue, setParameter, setParameterValueByKey, setParameterValueByName, setTrigger, setValue, shutdown, sleepFor, statusSimulator

Methods inherited from class stella.rmi.ReceiverTorso

addRmiAcknowledgeListener, addRmiDoneListener, bindDefault, containsRemoteProperty, deregisterAtCaster, equals, getRemoteProperties, getRemoteProperty, hashCode, notifyAcknowledgeListener, notifyDoneListener, registerAtCaster, removeRmiAcknowledgeListener, removeRmiDoneListener, rescanned, rmiCommand, sendAllPrematureDone, sendPrematureDone, setLastError, setRemoteProperty, toString, unbindDefault

Methods inherited from class stella.rmi.AbstractRmiCasterAndListener

addErrorListener, addRmiErrorListener, bindToRegistry, getBindName, isValid, notifyErrorListener, removeErrorListener, removeRmiErrorListener, sendError, sendError, sendError, sendStatus, sendStatus, sendStatus, unbindFromRegistry

Methods inherited from class util.rmi.AbstractRmiListener

allBound, blockBinding, blockBinding, disconnect, getIP, getListenerName, isConnected, listenerName, releaseBinding, releaseBinding, startBinding, startBinding

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

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

Methods inherited from interface util.rmi.RmiCaster

bindToRegistry, isValid, unbindFromRegistry

Methods inherited from interface stella.ErrorCaster

addErrorListener, removeErrorListener

Methods inherited from interface util.rmi.RmiEventListener

getListenerName

Methods inherited from interface util.rmi.RmiListener

disconnect, isConnected

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_AZVALUE

public static final String KEY_AZVALUE

The key to the value naming azimuth of the telescope.

See Also:

Constant Field Values

KEY_ALTVALUE

public static final String KEY_ALTVALUE

The key to the value naming altitude of the telescope.

See Also:

Constant Field Values

KEY_FAILAMBIGUOUS

public static final String KEY_FAILAMBIGUOUS

The probability of seeing an ambiguous star pattern on acquire.

See Also:

Constant Field Values

KEY_FAILGUIDE

public static final String KEY_FAILGUIDE

The key to the failure probability of the guider.

See Also:

Constant Field Values

KEY_FAILEXPOSE

public static final String KEY_FAILEXPOSE

The key to the failure probability of the guider.

See Also:

Constant Field Values

KEY_FAILINIT

public static final String KEY_FAILINIT

The key to the failure probability of the initialization process.

See Also:

Constant Field Values

KEY_FAILSTAR

public static final String KEY_FAILSTAR

The probability of not seeing a star on acquire.

See Also:

Constant Field Values

KEY_MAGNITUDE

public static final String KEY_MAGNITUDE

The probability of a star-too-faint on the guider.

See Also:

Constant Field Values

KEY_READOUTTIME

public static final String KEY_READOUTTIME

The key to the readout time of the ST-7.

See Also:

Constant Field Values

DEFAZVALUE

private static final String DEFAZVALUE

The default name of the telescope azimuth value.

See Also:

Constant Field Values

DEFALTVALUE

private static final String DEFALTVALUE

The default name of the telescope altitude value.

See Also:

Constant Field Values

DEFFAILAMBIGUOUS

private static final double DEFFAILAMBIGUOUS

The default error list.

See Also:

Constant Field Values

DEFFAILGUIDE

private static final double DEFFAILGUIDE

The default error list.

See Also:

Constant Field Values

DEFFAILINIT

private static final double DEFFAILINIT

The default error list.

See Also:

Constant Field Values

DEFFAILEXPOSE

private static final double DEFFAILEXPOSE

The default error list.

See Also:

Constant Field Values

DEFFAILSTAR

private static final double DEFFAILSTAR

The default error list.

See Also:

Constant Field Values

DEFMAGNITUDE

private static final double DEFMAGNITUDE

The default error list.

See Also:

Constant Field Values

DEFREADOUTTIME

private static final long DEFREADOUTTIME

The default error list.

See Also:

Constant Field Values

DEFERRORCLASSES

private static final String DEFERRORCLASSES

The default error list.

See Also:

Constant Field Values

DEFERRORPROBABILITIES

private static final String DEFERRORPROBABILITIES

The default error probabilities.

See Also:

Constant Field Values

COMMANDS

private static final String[] COMMANDS

The known command types, used for acknowledges and true dones.

ACKTIMES

private static final String[] ACKTIMES

The acknowledge times, same order as commands. Add exposure time on 4.

DONETIMES

private static final String[] DONETIMES

The actual simulation times for the commands. Add exposure time on 4.

DIVERT

private static final String[] DIVERT

The divergence factors for the simulation times of the commands.

guide

private Trigger guide

The is-guiding trigger.

lostguide

private Trigger lostguide

The guiding-lost trigger.

losttarget

private Trigger losttarget

The target-lost trigger.

lasterror

private ErrorEvent lasterror

The last error occured.

guidingdead

private boolean guidingdead

True, if a no-guiding error was thrown.

Constructor Detail

AuxiliarySimulator

public AuxiliarySimulator(Map prop)
                   throws RemoteException

Constructs a new adapter simulator. Does not serve any remote triggers. For details of command processing, see processCommand(stella.CommandEvent, int).

Throws:

RemoteException

Method Detail

initStep

public void initStep(int curstep)
              throws InitException

We delay the initialization of the remote values to the last stages of the intialization to avoid blocking.

Specified by:

initStep in interface StepInitializable

Overrides:

initStep in class GenericSimulator

Throws:

InitException

init5

private void init5()
            throws InitException

We delay the initialization of the remote values to the last stages of the intialization to avoid blocking.

Throws:

InitException

myAugment

private static Map myAugment(Map def)

Augmentes the properties for the acknowledge, done, and divert times.

accepts

public boolean accepts(CommandEvent ce)
                throws RemoteException

Returns true if this receiver accepts commands of the type handed over as an argument. An adapter simulator accepts all sort of AuxiliaryCommands.

Throws:

RemoteException

isAllowed

protected boolean isAllowed(ErrorEvent ee)

Returns true if the error handed over is allowed. The following things are checked:

• The NoCalibrationUnit, NoFlatFieldSwitch, and NoGuiding errors are always allowed.
• The LostGuiding error is allowed, if the adapter is guiding ( guide, and if guiding or the target have not already been lost ( lostguide, losttarget).
• The LostTarget error is allowed, if the adapter is guiding ( guide, and if the target has not been lost. Different to LostGuiding it is also allowed if the guiding has been lost.
• DropTarget is allowed only if at least the guiding or, this reflects the more realistic case, the the target was lost. In the simulator, no distinction is made between allowence after lost guiding or lost target.
• RegainedGuiding is allowed only if the target or the guiding has been lost.
• The special error RequestTelescopePosition, which is a error only used during simulation, will always return false (so that it is not transported to an error handler, but will spark a remote-retrieval of the telescope position.

Specified by:

isAllowed in class GenericSimulator

getLastError

protected ErrorEvent getLastError(CommandEvent ce)

Returns the last error that occured during command processing.

Overrides:

getLastError in class ReceiverTorso

getCompletionTime

protected long getCompletionTime(CommandEvent ce,
                                 int acknr)

Returns the completion time. If the command is a ExposeAuxiliary command and the acknowledge number is zero, add the distorted exposure time carried by the command to the value returned by the parental method.

Overrides:

getCompletionTime in class GenericSimulator

Parameters:

ce - The command to process.

acknr - The number of the acknowledge that will be sent back.

getSimulationTime

protected long getSimulationTime(CommandEvent ce,
                                 int acknr)

Returns the simulation time. If the command is a ExposeAuxiliary command and the acknowledge number is zero, add the distorted exposure time carried by the command to the value returned by the parental method.

Overrides:

getSimulationTime in class GenericSimulator

processCommand

protected boolean processCommand(CommandEvent ce,
                                 int acknr)

Simulates execution of the adapter commands. The following commands are served and their possible consequences indicated:

• AcquireAuxiliary: This command is issued when the adapter should acquire a target star. It therefore compares a list of field-of-view stars provided with the FindAuxiliary command with the current field-of-view obtained by the guiding ccd. Failure is possible in quite a bunch of ways: A NoGuiding error might be thrown, KEY_FAILGUIDE. This error is also command-cycle independent. Additionally, a NoStarOnAcquire error might be thrown KEY_FAILSTAR. This error might occur rather frequently, it is an indication of cloud coverage. Then, an AmbiguousStarPattern might occur if the star constellation found does not coincide with the field-of-view stars transfered in the FindAuxiliary command, probability KEY_FAILAMBIGUOUS. Last but not least, a TargetStarMagnitude status event might be issued (KEY_MAGNITUDE), if the target star was found, but its brightness is well of the expected value. This status event is intended for identifying acquiring difficulties and will not block target acquisition.
• CalibrationOnAuxiliary: Fails with #KEY_FAILCALIBRATION to a NoCalibrationUnit. This error may also occur out-of-cycle.
• CalibrationOffAuxiliary: Never fails.
• ExposeAuxiliary: Sends back a AuxiliaryFwhm status message. To allow focus groups to be tested, the current focus position is queried via RMI in the #focus value. Depending on #KEY_FOCUSOPTIMUM and #KEY_FOCUSFWHM together with #KEY_FOCUSDIVERT an artificial FWHM of the star image is calculated and sent back to the SCS.
• FindAuxiliary Never fails.
• FlatFieldOnAuxiliary Fails with #KEY_FAILFLATFIELD to a NoFlatFieldSwitch. This error may also occur out-of-cycle.
• FlatFieldOffAuxiliary never fails.
• InitAuxiliary Fails with a KEY_FAILINIT probability to a CannotInitAuxiliary.
• ParkAuxiliary never fails.
• SelectFilterAuxiliary Fails with a #KEY_FAILFILTERPRESENT to a NoSuchFilter. Additionally can throw a NoFilterWheel (#KEY_FAILFILTERSTUCK).
• StartGuidingAuxiliary Fails with KEY_FAILGUIDE to a NoStarOnAcquire.
• StopGuidingAuxiliary never fails.
• StatusAuxiliary sends back an artificial status command, as right now no parameter is coupled to this status event.

Overrides:

processCommand in class GenericSimulator

main

public static void main(String[] arg)
                 throws RemoteException

Constructs a new adapter simulator. The single argument supplied are the simulator properties.

Throws:

RemoteException