stella.telescope

Interface PointingAccessible

All Known Subinterfaces:

PilarDriver, TelescopeDriver

All Known Implementing Classes:

AbstractPilarDriver, AbstractRpcTelescope, GregorDriver, OpenPilarSocket, OpenPilarSocket.PilarTest, Pilar3Socket, Pilar3Socket.PilarTest, VattDriver

public interface PointingAccessible

A generic interface describing the essential functionality a telescope must provide to work as an astronomical telescope. Further subclasses may be specified for increased performance. Note that very simple telescope might even only provide a subset of these commands, this interface is a compromise between what you expect on a telescope and what is essentially necessary.

Method Summary

Modifier and Type	Method and Description
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	commenceTracking(boolean start) Starts or stops tracking of the telescope, but does not block until the telescope is in the new state.

Method Detail

commenceMove

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

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

Parameters:

ra - Right ascension in degrees.

de - Declination in degrees.

Throws:

IOException

TimeoutException

commenceMove

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

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.

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

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

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

Parameters:

az - Astronomical azimuth of desired telescope position.

alt - Height of target of desired telescope position

Throws:

IOException

TimeoutException

commenceTracking

boolean commenceTracking(boolean start)
                  throws IOException,
                         TimeoutException

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

Parameters:

start - true for start, false for stop

Throws:

IOException

TimeoutException