stella.auxiliary

Class AuxiliaryMaster

java.lang.Object

util.PropertyContainer

util.PropertyResources

util.rmi.RmiPropertyContainer

util.rmi.AbstractRmiListener

stella.rmi.AbstractRmiCasterAndListener

stella.rmi.ReceiverTorso

stella.rmi.GenericMaster

stella.acquire.AcquireMaster

stella.auxiliary.AuxiliaryMaster

All Implemented Interfaces:

Cloneable, Remote, EventListener, Caster, ErrorSending, ErrorCaster, AcquisitionControlling, Alive, DitherControlling, ListenerControlling, RmiAcknowledgeCaster, RmiCommandListener, RmiDoneCaster, RmiErrorCaster, RmiParameterClustering, AlarmHandler, ExitCleaning, PropertySupplying, ResourceSupplying, CcdControlling, RmiCaster, RmiEventListener, RmiListener, RmiPropertyBearing, TriggerableReload, StepInitializable

public class AuxiliaryMaster
extends AcquireMaster
implements DitherControlling

This class handles the adapter communication to the SCS. It extends the CalibrationMaster and additionally understands the following commands:

• FindAuxiliary:
• AcquireAuxiliary :
• StartGuidingAuxiliary:
• StopGuidingAuxiliary:

During execution of the various commands, different errors can be thrown, refer to the appropriate methods.

Nested Class Summary

Nested classes/interfaces inherited from class stella.acquire.AcquireMaster

AcquireMaster.ContinuousExposure

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

GenericMaster.Standalone

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	DEFACQUIREOFFSET
private static long	DEFACQUIRETIME The default acquire time.
private static String	DEFACQUIRETOOLCLASS
private static Dimension	DEFCLEARBIN The frame that should be cleared on a reset.
private static Rectangle	DEFCLEARFRAME The frame that should be cleared on a reset.
private static long	DEFCLEARTIME The time required for a clear ccd.
private static String	DEFCOARSECLASS
private static String	DEFETCCLASS
private static String	DEFETCSTRING
private static long	DEFFINDTIME The default recognize-find time.
private static String	DEFFINECLASS
private static String	DEFFITSPRIOR Default property.
private static String	DEFFOVCLASS
private static String	DEFGAUSSCLASS
private static String	DEFGAUSSSTRING
private static String	DEFGEOMETRYCLASS Default field of fiew provideer.
private static String	DEFGEOMETRYSTRING
private static String	DEFGUIDECLASS
private static String	DEFGUIDETOOLCLASS
private static int	DEFIMPROVECOARSE
private static int	DEFIMPROVEFINE
private static String	DEFMATCHCLASS
private static String	DEFMATCHSTRING
private static long	DEFMOVETIME The maximum time we wait for move telescope.
private static long	DEFOFFSETDELAY The default delay on stop guiding if offset are active.
private static int	DEFOFFSETWAIT The default delay on stop guiding if offset are active.
private static String	DEFPINHOLECLASS
private static long	DEFSTARTGUIDINGTIME The default time till guiding starts.
private static long	DEFSTOPGUIDINGTIME The default time till guiding stops.

Fields inherited from class stella.acquire.AcquireMaster

KEY_ACQUIREOFFSET, KEY_ACQUIRETIME, KEY_ACQUISITIONCCD, KEY_ALTITUDE, KEY_AZIMUTH, KEY_CLEARBIN, KEY_CLEARFRAME, KEY_CLEARGUIDINGBIN, KEY_CLEARGUIDINGFRAME, KEY_CLEARGUIDINGTIME, KEY_CLEARTIME, KEY_COLORTARGET, KEY_DEDITHER, KEY_DETARGET, KEY_FILEOVERSTRING, KEY_FINDTIME, KEY_FITSPRIOR, KEY_GUIDECCD, KEY_IMPROVECOARSE, KEY_IMPROVEFINE, KEY_MAGTARGET, KEY_MOVETIME, KEY_OFFSETDELAY, KEY_OFFSETWAIT, KEY_PARALLACTICANGLE, KEY_PROMPTTIME, KEY_RADITHER, KEY_RATARGET, KEY_STARTGUIDINGTIME, KEY_STOPGUIDINGTIME, KEY_TARGETNAME, POSTFIX_CLASS, POSTFIX_FILE, POSTFIX_STRING, PREFIX_ACQUIREGAUSS, PREFIX_ACQUIRETOOL, PREFIX_CATALOGMATCH, PREFIX_COARSEUNIT, PREFIX_ETC, PREFIX_FINEUNIT, PREFIX_FOV, PREFIX_GEOMETRY, PREFIX_GUIDEETC, PREFIX_GUIDEGAUSS, PREFIX_GUIDEGEOMETRY, PREFIX_GUIDEPINHOLE, PREFIX_GUIDETOOL, PREFIX_GUIDEUNIT, PREFIX_PINHOLE, PREFIX_SPILL, PREFIX_VANISH

Fields inherited from class stella.rmi.GenericMaster

DEFUNIQUE, KEY_ABORTTIME, KEY_AUTOMATIC, KEY_COMMTIME, KEY_COMMUNICATOR, KEY_DRIVERS, KEY_HISTORYDB, KEY_INITTIME, KEY_NODB, KEY_OBSERVEDB, KEY_OVERRULEAUTO, KEY_PARKTIME, KEY_PERMISSIONDB, KEY_PROPOSALDB, KEY_QUITTIME, KEY_REAUTO, KEY_RESETTIME, KEY_SET, KEY_SHUTDOWNDELAY, KEY_STATUSTIME, KEY_TARGETDB, KEY_TASKDB, KEY_UNIQUE, KEY_USERDB, lastabort, lastinit, lastpark, lastreset, telescope

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

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, 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
AuxiliaryMaster(Map<String,String> prop) Constructs a new adapter master.

Method Summary

Modifier and Type	Method and Description
boolean	accepts(CommandEvent ce) Checks if the command received is accepted by the adapter master.
boolean	ditherOffset(double ra, double de) Sets a dither offset which is allowed only in manual mode.
protected int	getAcknowledgeNumber(CommandEvent cmd) Returns the number of acknowledge events produced for each command.
protected long	getCompletionTime(CommandEvent cmd, int acknr) Returns the individual completion times.
static void	main(String[] arg) Constructs a new adapter master.
protected boolean	processCommand(CommandEvent cmd, int acknr) Process the command.
void	quit() Gracefully quite the adapter master.

Methods inherited from class stella.acquire.AcquireMaster

abortMaster, acquire, acquisitionGeometry, automatic, center, createSubsystemWithSet, doAcquire, doStartExposing, doStartGuiding, doStopExposing, doStopGuiding, find, getAcquisitionCcd, getAltitude, getAzimuth, getCoarseAcquisition, getGuidingCcd, getParallacticAngle, getStarDescriptions, guidingGeometry, hotPixelShift, hotPixelShiftGuide, init2, initGuider, initializeMaster, initStep, manual, offsetAzAlt, offsetXY, parkMaster, prepareAcquire, prepareCatalog, prepareDither, prepareGuidePivotOffset, preparePivotOffset, quitMaster, readoutGeometry, readoutGeometryGuide, resetCcd, resetCcdGuide, resetMaster, singleExposure, singleShot, singleShotGuide, startGuiding, statusMaster, stopGuiding, takeExposure

Methods inherited from class stella.rmi.GenericMaster

addErrorListener, addRmiErrorListener, createCommunicator, createCommunicator, exit, external, formatWithGlobals, getAllDrivers, getDriver, getHistorySql, getObserveSql, getOffsetCaster, getParameterByKey, getParameterByName, getParameterCluster, getParameterValueByKey, getParameterValueByName, getPermissionSql, getProposalSql, getStatus, getTargetSql, getTaskSql, getUnique, getUniqueId, getUserSql, initialize, isAlive, isAuto, isManual, isPassive, park, reload, rescanned, reset, resetAlarm, resetAllDrivers, restartAllDrivers, revert, rmiAddParameter, rmiCommand, rmiGet, rmiGetAllParameterNames, rmiRemoveParameter, rmiSet, setLastError, setOff, setParameterValueByKey, setParameterValueByName, setPassive, shutdown, zeroAllOmc

Methods inherited from class stella.rmi.ReceiverTorso

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

Methods inherited from class stella.rmi.AbstractRmiCasterAndListener

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, removeProperty, requires, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object

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

Methods inherited from interface stella.rmi.ListenerControlling

external, getStatus, initialize, park, reset, setPassive

Methods inherited from interface util.rmi.RmiCaster

bindToRegistry, isValid, unbindFromRegistry

Methods inherited from interface stella.ErrorCaster

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

DEFFITSPRIOR

private static final String DEFFITSPRIOR

Default property.

See Also:

Constant Field Values

DEFMATCHCLASS

private static final String DEFMATCHCLASS

See Also:

Constant Field Values

DEFMATCHSTRING

private static final String DEFMATCHSTRING

See Also:

Constant Field Values

DEFGEOMETRYCLASS

private static final String DEFGEOMETRYCLASS

Default field of fiew provideer.

See Also:

Constant Field Values

DEFGEOMETRYSTRING

private static final String DEFGEOMETRYSTRING

See Also:

Constant Field Values

DEFFOVCLASS

private static final String DEFFOVCLASS

See Also:

Constant Field Values

DEFPINHOLECLASS

private static final String DEFPINHOLECLASS

See Also:

Constant Field Values

DEFETCCLASS

private static final String DEFETCCLASS

See Also:

Constant Field Values

DEFETCSTRING

private static final String DEFETCSTRING

See Also:

Constant Field Values

DEFACQUIRETOOLCLASS

private static final String DEFACQUIRETOOLCLASS

See Also:

Constant Field Values

DEFGUIDETOOLCLASS

private static final String DEFGUIDETOOLCLASS

See Also:

Constant Field Values

DEFGAUSSCLASS

private static final String DEFGAUSSCLASS

See Also:

Constant Field Values

DEFGAUSSSTRING

private static final String DEFGAUSSSTRING

See Also:

Constant Field Values

DEFCOARSECLASS

private static final String DEFCOARSECLASS

See Also:

Constant Field Values

DEFIMPROVECOARSE

private static final int DEFIMPROVECOARSE

See Also:

Constant Field Values

DEFFINECLASS

private static final String DEFFINECLASS

See Also:

Constant Field Values

DEFIMPROVEFINE

private static final int DEFIMPROVEFINE

See Also:

Constant Field Values

DEFGUIDECLASS

private static final String DEFGUIDECLASS

See Also:

Constant Field Values

DEFACQUIREOFFSET

private static final String DEFACQUIREOFFSET

See Also:

Constant Field Values

DEFCLEARFRAME

private static final Rectangle DEFCLEARFRAME

The frame that should be cleared on a reset.

DEFCLEARBIN

private static final Dimension DEFCLEARBIN

The frame that should be cleared on a reset.

DEFCLEARTIME

private static final long DEFCLEARTIME

The time required for a clear ccd.

See Also:

Constant Field Values

DEFFINDTIME

private static final long DEFFINDTIME

The default recognize-find time.

See Also:

Constant Field Values

DEFACQUIRETIME

private static final long DEFACQUIRETIME

The default acquire time.

See Also:

Constant Field Values

DEFSTARTGUIDINGTIME

private static final long DEFSTARTGUIDINGTIME

The default time till guiding starts.

See Also:

Constant Field Values

DEFSTOPGUIDINGTIME

private static final long DEFSTOPGUIDINGTIME

The default time till guiding stops.

See Also:

Constant Field Values

DEFMOVETIME

private static final long DEFMOVETIME

The maximum time we wait for move telescope.

See Also:

Constant Field Values

DEFOFFSETDELAY

private static final long DEFOFFSETDELAY

The default delay on stop guiding if offset are active.

See Also:

Constant Field Values

DEFOFFSETWAIT

private static final int DEFOFFSETWAIT

The default delay on stop guiding if offset are active.

See Also:

Constant Field Values

Constructor Detail

AuxiliaryMaster

public AuxiliaryMaster(Map<String,String> prop)
                throws RemoteException

Constructs a new adapter master. The parameter set served is constructed in the #init section of the parent class.

Throws:

RemoteException

Method Detail

ditherOffset

public boolean ditherOffset(double ra,
                            double de)
                     throws RemoteException

Sets a dither offset which is allowed only in manual mode.

Specified by:

ditherOffset in interface DitherControlling

Throws:

RemoteException

quit

public void quit()
          throws RemoteException

Gracefully quite the adapter master. The exit of the Java VM is delayed for five seconds.

Specified by:

quit in interface ListenerControlling

Overrides:

quit in class GenericMaster

Throws:

RemoteException

accepts

public boolean accepts(CommandEvent ce)
                throws RemoteException

Checks if the command received is accepted by the adapter master. An adapter master accepts all AuxiliaryCommands.

Specified by:

accepts in interface RmiCommandListener

Throws:

RemoteException

getAcknowledgeNumber

protected int getAcknowledgeNumber(CommandEvent cmd)

Returns the number of acknowledge events produced for each command. If the command is unknown an IllegalArgumentException is thrown.

Overrides:

getAcknowledgeNumber in class GenericMaster

getCompletionTime

protected long getCompletionTime(CommandEvent cmd,
                                 int acknr)

Returns the individual completion times. For exposure commands, the first acknowledge time is the sum of the exposure time plus the read-out time from the controller to the local buffer. The second acknowledge time is the time it takes to write the fits file out of the local data buffer.
If the command is unknown an IllegalArgumentException is thrown.

Overrides:

getCompletionTime in class GenericMaster

Parameters:

cmd - The command to process.

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

processCommand

protected boolean processCommand(CommandEvent cmd,
                                 int acknr)

Process the command. The exposure commands are split into three processes, the first one consisting of taking the exposure, the second transfering the CCD-data to the local buffer. The third part is writing the locally buffered data to the fits file. This allows the sequencer to continue operation once the data has been transfered from the CCD to the local buffer. In principle, the next exposure can start as soon as the data transfer to the local buffer is completed.

Overrides:

processCommand in class GenericMaster

main

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

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

Throws:

RemoteException