stella.telescope

Interface OffsetAccessible

All Known Subinterfaces:

PilarDriver, TelescopeDriver

All Known Implementing Classes:

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

public interface OffsetAccessible

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	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	commenceGuiding(boolean start) Starts or stops tracking of the telescope and waits until the new tracking state is reached.
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.

Method Detail

commenceGuiding

boolean commenceGuiding(boolean start)
                 throws IOException,
                        TimeoutException

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

Parameters:

start - true for start, false for stop

Throws:

IOException

TimeoutException

commenceAbsoluteOffset

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

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.

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

Throws:

IOException

TimeoutException

commenceAbsoluteOffset

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

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.

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

h - Height of telescope in degrees.

Throws:

IOException

TimeoutException

commenceRelativeOffset

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

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

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

Throws:

IOException

TimeoutException

commenceRelativeOffset

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

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

Parameters:

azoff - Offset of azimuth axis in degrees.

altoff - Offset in altitude axis in degrees.

h - Height of telescope.

Throws:

IOException

TimeoutException