stella.auxiliary

Class PinholeViewingMaster

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.AdapterMaster

stella.auxiliary.PinholeViewingMaster

All Implemented Interfaces:

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

public class PinholeViewingMaster
extends AdapterMaster
implements AutoFocusControlling

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 AbstractFocussingUnit	autofocus
private static String	DEFACQUIREOFFSET
private static String	DEFACQUIRETOOLCLASS
private static long	DEFAUTOFOCUSTIME The default focus time.
private static long	DEFCLEARTIME No time required for a clear ccd.
private static String	DEFCOARSECLASS
private static String	DEFETCSTRING
private static long	DEFFAINTFOCUSTIME The default focus time.
private static String	DEFFINECLASS
private static double	DEFFOCUSACCURACY The default focus accuracy for zernike accept.
private static String	DEFFOCUSCLASS
private static float	DEFFOCUSMAG The minimum brightness for Zernike focusing.
private static long	DEFFOCUSTIME The default focus time.
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 String	DEFPINHOLECLASS
private static String	DEFPINHOLESTRING
private static String	DEFSPILLCLASS
private static String	DEFVANISHCLASS
static String	KEY_AUTOFOCUSTIME Time for the auto focus command.
static String	KEY_FAINTFOCUSTIME Time for the auto faint focus command.
static String	KEY_FOCUSACCURACY On auto-focus the required accuracy for temperature/zernike accept.
static String	KEY_FOCUSMAG Auto-focus Zernike required minimum brightness of focus star.
static String	KEY_FOCUSTIME Time for the focus command.
static String	PREFIX_FOCUSUNIT The properties of the FocussingUnit.

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
PinholeViewingMaster(Map<String,String> prop)

Method Summary

Modifier and Type	Method and Description
protected boolean	abortMaster(CommandEvent cmd) Method called to abort the device.
private boolean	applyFocusFwhmFinish(double f0, CcdDriver ccd, Star focus, ExposureTimeProviding etc, TransparencyMeasuring haze)
boolean	autoFocus() This method tries its best to acquire a sharp image.
boolean	automatic() Enables automatic operation.
private void	checkAndPrepare(CcdDriver ccd, Star focus, ExposureTimeProviding etc)
private AbstractFocussingUnit	createFocusunit(String prefix)
private boolean	doAutoFocus(AbstractFocussingUnit.Method how)
boolean	focus(double mm) Sets the focus in the telescope.
boolean	focusOffset(double mm) Sets the focus offset in the telescope.
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.
protected void	init2() Has now driver, communication and parameter set.
boolean	manual() Disables automatic operation.
protected boolean	processCommand(CommandEvent cmd, int acknr) Process the command.
protected boolean	setFocus(double mm) Directly moves the focus.
protected boolean	setFocusOffset(double mm) Directly offsets the focus.
private boolean	sufficient(Vector2D f0)

Methods inherited from class stella.auxiliary.AdapterMaster

accepts, main, quit

Methods inherited from class stella.acquire.AcquireMaster

acquire, acquisitionGeometry, center, createSubsystemWithSet, doAcquire, doStartExposing, doStartGuiding, doStopExposing, doStopGuiding, find, getAcquisitionCcd, getAltitude, getAzimuth, getCoarseAcquisition, getGuidingCcd, getParallacticAngle, getStarDescriptions, guidingGeometry, hotPixelShift, hotPixelShiftGuide, initGuider, initializeMaster, initStep, 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, quit, 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

PREFIX_FOCUSUNIT

public static final String PREFIX_FOCUSUNIT

The properties of the FocussingUnit.

See Also:

Constant Field Values

KEY_FOCUSACCURACY

public static final String KEY_FOCUSACCURACY

On auto-focus the required accuracy for temperature/zernike accept.

See Also:

Constant Field Values

KEY_FOCUSMAG

public static final String KEY_FOCUSMAG

Auto-focus Zernike required minimum brightness of focus star.

See Also:

Constant Field Values

KEY_FOCUSTIME

public static final String KEY_FOCUSTIME

Time for the focus command.

See Also:

Constant Field Values

KEY_AUTOFOCUSTIME

public static final String KEY_AUTOFOCUSTIME

Time for the auto focus command.

See Also:

Constant Field Values

KEY_FAINTFOCUSTIME

public static final String KEY_FAINTFOCUSTIME

Time for the auto faint focus command.

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

DEFPINHOLECLASS

private static final String DEFPINHOLECLASS

See Also:

Constant Field Values

DEFPINHOLESTRING

private static final String DEFPINHOLESTRING

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

DEFVANISHCLASS

private static final String DEFVANISHCLASS

See Also:

Constant Field Values

DEFGUIDETOOLCLASS

private static final String DEFGUIDETOOLCLASS

See Also:

Constant Field Values

DEFSPILLCLASS

private static final String DEFSPILLCLASS

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

DEFFOCUSCLASS

private static final String DEFFOCUSCLASS

See Also:

Constant Field Values

DEFACQUIREOFFSET

private static final String DEFACQUIREOFFSET

See Also:

Constant Field Values

DEFCLEARTIME

private static final long DEFCLEARTIME

No time required for a clear ccd.

See Also:

Constant Field Values

DEFFOCUSTIME

private static final long DEFFOCUSTIME

The default focus time.

See Also:

Constant Field Values

DEFAUTOFOCUSTIME

private static final long DEFAUTOFOCUSTIME

The default focus time.

See Also:

Constant Field Values

DEFFAINTFOCUSTIME

private static final long DEFFAINTFOCUSTIME

The default focus time.

See Also:

Constant Field Values

DEFFOCUSACCURACY

private static final double DEFFOCUSACCURACY

The default focus accuracy for zernike accept.

See Also:

Constant Field Values

DEFFOCUSMAG

private static final float DEFFOCUSMAG

The minimum brightness for Zernike focusing.

See Also:

Constant Field Values

autofocus

private AbstractFocussingUnit autofocus

Constructor Detail

PinholeViewingMaster

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

Throws:

RemoteException

Method Detail

init2

protected void init2()
              throws InitException

Has now driver, communication and parameter set.

Overrides:

init2 in class AcquireMaster

Throws:

InitException

focus

public boolean focus(double mm)
              throws RemoteException

Description copied from interface: FocusControlling

Sets the focus in the telescope. STELLA-I does that by moving M2.

Specified by:

focus in interface FocusControlling

Throws:

RemoteException

focusOffset

public boolean focusOffset(double mm)
                    throws RemoteException

Description copied from interface: FocusControlling

Sets the focus offset in the telescope. STELLA-I does that by moving M2.

Specified by:

focusOffset in interface FocusControlling

Throws:

RemoteException

autoFocus

public boolean autoFocus()
                  throws RemoteException

Description copied from interface: AutoFocusControlling

This method tries its best to acquire a sharp image. Whether it depends on a previous acquire/centering of a star is not defined within this method and also object depending.

Specified by:

autoFocus in interface AutoFocusControlling

Throws:

RemoteException

automatic

public boolean automatic()
                  throws RemoteException

Enables automatic operation. If we are currently guiding, the guiding is stopped.

Specified by:

automatic in interface ListenerControlling

Overrides:

automatic in class AcquireMaster

Returns:

True if automatic mode was attained.

Throws:

RemoteException

manual

public boolean manual()
               throws RemoteException

Disables automatic operation. This method calls the AcquireMaster.doStopGuiding() method to kill any ongoing guiding.

Specified by:

manual in interface ListenerControlling

Overrides:

manual in class AcquireMaster

Returns:

True if manual mode was attained.

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 AdapterMaster

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 AdapterMaster

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 AdapterMaster

abortMaster

protected boolean abortMaster(CommandEvent cmd)

Method called to abort the device. Empty implementation.

Overrides:

abortMaster in class AcquireMaster

Parameters:

cmd - Non-null in automatic mode.

setFocus

protected boolean setFocus(double mm)
                    throws FocussingException

Directly moves the focus.

Throws:

FocussingException

setFocusOffset

protected boolean setFocusOffset(double mm)
                          throws FocussingException

Directly offsets the focus.

Throws:

FocussingException

applyFocusFwhmFinish

private boolean applyFocusFwhmFinish(double f0,
                                     CcdDriver ccd,
                                     Star focus,
                                     ExposureTimeProviding etc,
                                     TransparencyMeasuring haze)
                              throws FocussingException

Throws:

FocussingException

checkAndPrepare

private void checkAndPrepare(CcdDriver ccd,
                             Star focus,
                             ExposureTimeProviding etc)
                      throws ConfigurationException,
                             FocussingException

Parameters:

ccd -

focus -

etc -

Throws:

ConfigurationException

FocussingException

sufficient

private boolean sufficient(Vector2D f0)

Parameters:

f0 -

Returns:

doAutoFocus

private boolean doAutoFocus(AbstractFocussingUnit.Method how)
                     throws ConfigurationException,
                            FocussingException

Throws:

ConfigurationException

FocussingException

createFocusunit

private AbstractFocussingUnit createFocusunit(String prefix)
                                       throws InitException

Throws:

InitException