stella.telescope

Class VattDriver

java.lang.Object

util.PropertyContainer

io.AbstractDriver

io.AbstractSocketDriver

stella.net.vatt.VattHandler

stella.telescope.VattDriver

All Implemented Interfaces:

ParameterDepending, Driver, StreamIODriver, Cloneable, CommandCodes, DerotatorAccessible, FocusAccessible, OffsetAccessible, PointingAccessible, TelescopeDriver, ExitCleaning, Initializable, PropertySupplying

public class VattDriver
extends VattHandler
implements TelescopeDriver, ParameterDepending, CommandCodes

Implementation of a telescope driver that taks to the VATT on the binary server interface.

Author:

wooz

Field Summary

Fields

Modifier and Type	Field and Description
private static String	DEFPARALLACTICANGLE Name of the target height parameter.
static String	KEY_PARALLACTICANGLE Name of the target height parameter.
private Value	parangle Value stating parallactic angle of target.

Fields inherited from class stella.net.vatt.VattHandler

KEY_ALWAYSCLOSE

Fields inherited from class io.AbstractSocketDriver

KEY_CLOSETIMEOUT, KEY_SOCKETPORT, KEY_SOCKETSERVER, KEY_SOCKETTIMEOUT

Fields inherited from class io.AbstractDriver

KEY_DRIVERNAME

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface stella.net.vatt.CommandCodes

NACKPARAMS, NCMDPARAMS, TCP_PORT, TCP_PORT_IN, TCP_PORT_OUT, VATT_CMD_CLIENT_TERM, VATT_CMD_CONVERT_COORD, VATT_CMD_ERROR_NOTIMPLEMENTED, VATT_CMD_ERROR_UNKNOWN_CMD, VATT_CMD_GUIDER_ERROR_BADAXIS, VATT_CMD_GUIDER_INIT_ALL, VATT_CMD_GUIDER_INIT_AXIS, VATT_CMD_GUIDER_MOVE_AXIS, VATT_CMD_GUIDER_STATUS_AXIS, VATT_CMD_INIT, VATT_CMD_INIT_AXES_ALL, VATT_CMD_INIT_AXES_ALT, VATT_CMD_INIT_AXES_AZ, VATT_CMD_INIT_AXES_DEROT, VATT_CMD_INIT_COORDS, VATT_CMD_INIT_DOME, VATT_CMD_INIT_GUIDER_ALL, VATT_CMD_INIT_GUIDER_CAL, VATT_CMD_INIT_GUIDER_FILT, VATT_CMD_INIT_GUIDER_FOLDM, VATT_CMD_INIT_GUIDER_GUIDE, VATT_CMD_INIT_GUIDER_SLIT, VATT_CMD_INIT_MIRROR_ALL, VATT_CMD_INIT_MIRROR_COVER, VATT_CMD_INIT_MIRROR_CTRL, VATT_CMD_INIT_MIRROR_PNEUM, VATT_CMD_INIT_MIRROR_TEMP, VATT_CMD_MISC_DISABLEMC, VATT_CMD_MISC_DISABLESLIT, VATT_CMD_MISC_SETUSERTEMP, VATT_CMD_MISC_TOGGLECELLFANS, VATT_CMD_MISC_TOGGLEELBRAKE, VATT_CMD_MISC_TOGGLEMC, VATT_CMD_MISC_TOGGLESLIT, VATT_CMD_MISC_TOGGLETEMP, VATT_CMD_MOVE_ALTAZ_ABS_A0, VATT_CMD_MOVE_ALTAZ_ABS_A01, VATT_CMD_MOVE_ALTAZ_ABS_A1, VATT_CMD_MOVE_ALTAZ_ABS_A2, VATT_CMD_MOVE_ALTAZ_ABS_ALL, VATT_CMD_MOVE_ALTAZ_ABS_STOP, VATT_CMD_MOVE_ALTAZ_REL_A0, VATT_CMD_MOVE_ALTAZ_REL_A01, VATT_CMD_MOVE_ALTAZ_REL_A1, VATT_CMD_MOVE_ALTAZ_REL_A2, VATT_CMD_MOVE_ALTAZ_REL_ALL, VATT_CMD_MOVE_ALTAZ_REL_STOP, VATT_CMD_MOVE_ERROR_DRVDSBLD, VATT_CMD_MOVE_ERROR_NOTRCK, VATT_CMD_MOVE_ERROR_OOL, VATT_CMD_MOVE_ERROR_QLCKD, VATT_CMD_MOVE_OFFSET_CLEAR, VATT_CMD_MOVE_OFFSET_FID, VATT_CMD_MOVE_OFFSET_NEW, VATT_CMD_MOVE_OFFSET_REPORT, VATT_CMD_MOVE_OFFSET_SLOT, VATT_CMD_MOVE_OFFSET_UPDATE, VATT_CMD_MOVE_PADDLEBUTTON, VATT_CMD_MOVE_RADEC_ABS_A0, VATT_CMD_MOVE_RADEC_ABS_A01, VATT_CMD_MOVE_RADEC_ABS_A1, VATT_CMD_MOVE_RADEC_ABS_A2, VATT_CMD_MOVE_RADEC_ABS_ALL, VATT_CMD_MOVE_RADEC_ABS_STOP, VATT_CMD_MOVE_RADEC_REL_A0, VATT_CMD_MOVE_RADEC_REL_A01, VATT_CMD_MOVE_RADEC_REL_A1, VATT_CMD_MOVE_RADEC_REL_A2, VATT_CMD_MOVE_RADEC_REL_ALL, VATT_CMD_MOVE_RADEC_REL_STOP, VATT_CMD_MOVE_SET_GUIDERATE, VATT_CMD_MOVE_SET_SETRATE, VATT_CMD_MOVE_STOW, VATT_CMD_MOVE_UPDATE, VATT_CMD_PMAP_CLOSE_FILE, VATT_CMD_PMAP_GO_NEXT, VATT_CMD_PMAP_OFF, VATT_CMD_PMAP_ON, VATT_CMD_PMAP_RESET_FILE, VATT_CMD_PMAP_SAVE_TDATA, VATT_CMD_PMAP_SET_ALTAZ, VATT_CMD_SECONDARY_RESET, VATT_CMD_SECONDARY_SETAUTO, VATT_CMD_SECONDARY_SETUSER, VATT_CMD_SET_RADEC_BIASRATES, VATT_CMD_STATUS_ALTABS, VATT_CMD_STATUS_ALTAZ, VATT_CMD_STATUS_CUROBJ, VATT_CMD_STATUS_RADEC, VATT_CMD_STATUS_RELAY, VATT_CMD_STATUS_SECONDARY1, VATT_CMD_STATUS_SECONDARY2, VATT_CMD_STATUS_TEMPS, VATT_CMD_STATUS_TIMES, VATT_CMD_STOP, VATT_CMD_TOGGLE_DEROT_TRACK

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

Constructors

Constructor and Description
VattDriver(Map<String,String> prop)

Method Summary

Modifier and Type	Method and Description
boolean	commenceAbort() Aborts all active commands.
boolean	commenceAbsoluteOffset(double azoff, double altoff) Applies an absolute offset to the telescope axis.
boolean	commenceAbsoluteOffset(double azoff, double altoff, double h) Applies an absolute offset to the telescope axis.
boolean	commenceDerotator(double position) Sets the derotator position in the system's coordinate system, which is in degrees.
boolean	commenceDerotatorOffset(double position) Offsets the derotator position in the system's coordinate system, which is in degrees.
boolean	commenceFocus(double position) Sets a new focus position.
boolean	commenceFocusOffset(double position) Sets a new focus offset.
boolean	commenceGuiding(boolean start) Starts or stops tracking of the telescope and waits until the new tracking state is reached.
boolean	commenceInit() Initializes the telescope.
boolean	commenceMove(double ra, double de) Moves the telescope to the given ra/dec position in J2000.0 equinox.
boolean	commenceMove(double ra, double de, double off, boolean fol) Moves the telescope to the given ra/dec position in J2000.0 equinox.
boolean	commenceMoveAzAlt(double az, double alt) Moves the telescope to the desired alt/az position.
boolean	commencePark() Parks the telescope.
boolean	commenceRelativeOffset(double azoff, double altoff) Adds a current offset to both telescope axis.
boolean	commenceRelativeOffset(double azoff, double altoff, double h) Adds a current offset to both telescope axis.
boolean	commenceTracking(boolean start) Starts or stops tracking of the telescope, but does not block until the telescope is in the new state.
void	registerParameter(Parameter p) A parameter depending command should drain the necessarry information to get valid out of a parameter value.

Methods inherited from class stella.net.vatt.VattHandler

open, sendCommand

Methods inherited from class io.AbstractSocketDriver

authenticate, close, exit, getInputStream, getOutputStream, getSocket, init, isOpen, setTimeout

Methods inherited from class io.AbstractDriver

createDriver, equals, getDriverName, hashCode

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, clone, 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, initProperties, isNew, parseObject, parseObject, reload, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.Driver

close, getDriverName, isOpen, open

Methods inherited from interface util.Initializable

init

Field Detail

KEY_PARALLACTICANGLE

public static final String KEY_PARALLACTICANGLE

Name of the target height parameter.

See Also:

Constant Field Values

DEFPARALLACTICANGLE

private static final String DEFPARALLACTICANGLE

Name of the target height parameter.

See Also:

Constant Field Values

parangle

private Value parangle

Value stating parallactic angle of target.

Constructor Detail

VattDriver

public VattDriver(Map<String,String> prop)

Parameters:

prop -

Method Detail

commenceAbort

public boolean commenceAbort()
                      throws IOException,
                             TimeoutException

Description copied from interface: TelescopeDriver

Aborts all active commands.

Specified by:

commenceAbort in interface TelescopeDriver

Throws:

IOException

TimeoutException

commenceAbsoluteOffset

public boolean commenceAbsoluteOffset(double azoff,
                                      double altoff)
                               throws IOException,
                                      TimeoutException

Description copied from interface: OffsetAccessible

Applies an absolute offset to the telescope axis. On alt/az telescopes this will be an offset in azimuth and altitude. Calling this method repeatedly with the same value will move the telescope only on the first call.

Specified by:

commenceAbsoluteOffset in interface OffsetAccessible

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

Throws:

IOException

TimeoutException

commenceAbsoluteOffset

public boolean commenceAbsoluteOffset(double azoff,
                                      double altoff,
                                      double h)
                               throws IOException,
                                      TimeoutException

Description copied from interface: OffsetAccessible

Applies an absolute offset to the telescope axis. On alt/az telescopes this will be an offset in azimuth and altitude. Calling this method repeatedly with the same value will move the telescope only on the first call.

Specified by:

commenceAbsoluteOffset in interface OffsetAccessible

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

h - Height of telescope in degrees.

Throws:

IOException

TimeoutException

commenceDerotator

public boolean commenceDerotator(double position)
                          throws IOException,
                                 TimeoutException

Description copied from interface: DerotatorAccessible

Sets the derotator position in the system's coordinate system, which is in degrees.

Specified by:

commenceDerotator in interface DerotatorAccessible

Throws:

IOException

TimeoutException

commenceDerotatorOffset

public boolean commenceDerotatorOffset(double position)
                                throws IOException,
                                       TimeoutException

Description copied from interface: DerotatorAccessible

Offsets the derotator position in the system's coordinate system, which is in degrees.

Specified by:

commenceDerotatorOffset in interface DerotatorAccessible

Throws:

IOException

TimeoutException

commenceFocus

public boolean commenceFocus(double position)
                      throws IOException,
                             TimeoutException

Description copied from interface: FocusAccessible

Sets a new focus position. May throw an UnsupportedOperationException if the telescope is not focusable.

Specified by:

commenceFocus in interface FocusAccessible

Parameters:

position - The new focus position.

Throws:

IOException

TimeoutException

commenceFocusOffset

public boolean commenceFocusOffset(double position)
                            throws IOException,
                                   TimeoutException

Description copied from interface: FocusAccessible

Sets a new focus offset. May throw an UnsupportedOperationException if the telescope is not focusable.

Specified by:

commenceFocusOffset in interface FocusAccessible

Parameters:

position - The new focus offset, not cummulative.

Throws:

IOException

TimeoutException

commenceGuiding

public boolean commenceGuiding(boolean start)
                        throws IOException,
                               TimeoutException

Description copied from interface: OffsetAccessible

Starts or stops tracking of the telescope and waits until the new tracking state is reached.

Specified by:

commenceGuiding in interface OffsetAccessible

Parameters:

start - true for start, false for stop

Throws:

IOException

TimeoutException

commenceInit

public boolean commenceInit()
                     throws IOException,
                            TimeoutException

Description copied from interface: TelescopeDriver

Initializes the telescope.

Specified by:

commenceInit in interface TelescopeDriver

Throws:

IOException

TimeoutException

commenceMove

public boolean commenceMove(double ra,
                            double de)
                     throws IOException,
                            TimeoutException

Description copied from interface: PointingAccessible

Moves the telescope to the given ra/dec position in J2000.0 equinox. Tracking is started.

Specified by:

commenceMove in interface PointingAccessible

Parameters:

ra - Right ascension in degrees.

de - Declination in degrees.

Throws:

IOException

TimeoutException

commenceMove

public boolean commenceMove(double ra,
                            double de,
                            double off,
                            boolean fol)
                     throws IOException,
                            TimeoutException

Description copied from interface: PointingAccessible

Moves the telescope to the given ra/dec position in J2000.0 equinox. Additionally, position the derotator to the required offset and set if to follow the tracking. Tracking is started.

Specified by:

commenceMove in interface PointingAccessible

Parameters:

ra - Right ascension in degrees.

de - Declination in degrees.

off - The derotator offset in degress

fol - If true, the derotator follows the tracking.

Throws:

IOException

TimeoutException

commenceMoveAzAlt

public boolean commenceMoveAzAlt(double az,
                                 double alt)
                          throws IOException,
                                 TimeoutException

Description copied from interface: PointingAccessible

Moves the telescope to the desired alt/az position. Intended for non-tracking telescope positions.

Specified by:

commenceMoveAzAlt in interface PointingAccessible

Parameters:

az - Astronomical azimuth of desired telescope position.

alt - Height of target of desired telescope position

Throws:

IOException

TimeoutException

commencePark

public boolean commencePark()
                     throws IOException,
                            TimeoutException

Description copied from interface: TelescopeDriver

Parks the telescope.

Specified by:

commencePark in interface TelescopeDriver

Throws:

IOException

TimeoutException

commenceRelativeOffset

public boolean commenceRelativeOffset(double azoff,
                                      double altoff)
                               throws IOException,
                                      TimeoutException

Description copied from interface: OffsetAccessible

Adds a current offset to both telescope axis. On alt/az telescopes this will be an offset in azimuth and altitude.

Specified by:

commenceRelativeOffset in interface OffsetAccessible

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

Throws:

IOException

TimeoutException

commenceRelativeOffset

public boolean commenceRelativeOffset(double azoff,
                                      double altoff,
                                      double h)
                               throws IOException,
                                      TimeoutException

Description copied from interface: OffsetAccessible

Adds a current offset to both telescope axis. On alt/az telescopes this will be an offset in azimuth and altitude.

Specified by:

commenceRelativeOffset in interface OffsetAccessible

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

h - Height of telescope.

Throws:

IOException

TimeoutException

commenceTracking

public boolean commenceTracking(boolean start)
                         throws IOException,
                                TimeoutException

Description copied from interface: PointingAccessible

Starts or stops tracking of the telescope, but does not block until the telescope is in the new state.

Specified by:

commenceTracking in interface PointingAccessible

Parameters:

start - true for start, false for stop

Throws:

IOException

TimeoutException

registerParameter

public void registerParameter(Parameter p)

Description copied from interface: ParameterDepending

A parameter depending command should drain the necessarry information to get valid out of a parameter value. During rendering, parameter depending commands should receive their data through this method. Note that it is always possible to pile up all the information needed for a single command in a single parameter.

Specified by:

registerParameter in interface ParameterDepending