stella.rmi
Interface TelescopeControlling

All Superinterfaces:

FocusControlling, ListenerControlling, Remote

All Known Subinterfaces:

PointingModelControlling

All Known Implementing Classes:

TelescopeMaster

public interface TelescopeControlling
extends FocusControlling

Defines remote access for the guider camera.

Method Summary

boolean	addOffset(double deg1, double deg2) Adds offsets to the telescope.
boolean	changePort(int portid) Switches to the specified port.
boolean	clear() Clears the telescope.
boolean	closeCover() Protects the telescope.
boolean	derotator(double degree) Moves the derotator of the telescope to the absoult position, if it is has one.
boolean	derotatorOffset(double degree) Offsets the derotator by the given amount.
String	errors() Dumps any errors that are present in the underlying system to the return string.
Object	getTcsParameter(String parameter) Generic access to some named parameter exposed by the TCS.
boolean	initialize() Initializes the telescope.
boolean	moveAzAlt(double az, double alt) Moves the azimuth and altitude axis of the telescope, start tracking.
boolean	moveRaDec(double ra, double dec, double off, boolean follow) Moves the telescope to the given ra and dec, start tracking.
boolean	offset(double deg1, double deg2) Offsets the telescope.
boolean	openCover() Protects the telescope.
String	pointingAt() Dumps the instrumental (encoder) position plus the offset to the current pointing.
void	quit() Quits the master.
boolean	setTcsParameter(String parameter, Object to) Generic access to some named parameter exposed by the TCS.
boolean	startTracking() Starts the tracking from the current position of the telescope.
boolean	stopTracking() Stops the tracking of the telescope.
boolean	wipe() Ereases any memory of old errors.

Methods inherited from interface stella.rmi.FocusControlling

focus, focusOffset

Methods inherited from interface stella.rmi.ListenerControlling

automatic, external, getStatus, manual, park, reset, setPassive

Method Detail

derotator

boolean derotator(double degree)
                  throws RemoteException

Moves the derotator of the telescope to the absoult position, if it is has one.

Throws:

RemoteException

derotatorOffset

boolean derotatorOffset(double degree)
                        throws RemoteException

Offsets the derotator by the given amount. Useful only in/before tracking.

Throws:

RemoteException

moveAzAlt

boolean moveAzAlt(double az,
                  double alt)
                  throws RemoteException

Moves the azimuth and altitude axis of the telescope, start tracking.

Throws:

RemoteException

moveRaDec

boolean moveRaDec(double ra,
                  double dec,
                  double off,
                  boolean follow)
                  throws RemoteException

Moves the telescope to the given ra and dec, start tracking.

Throws:

RemoteException

offset

boolean offset(double deg1,
               double deg2)
               throws RemoteException

Offsets the telescope. Both values are in degrees. This offset works on the main axes of the telescope, thus it is an az/alt offset for az/alt telescopes and a ra/de offset for paralactically mounted telescopes. Independent of the mount, it is a spatial offset, not an angle difference. For the case of an az/alt telescope, this means that the difference in the azimuth encoder reading that will result from this offset is higher by 1/cos(alt).

Throws:

RemoteException

addOffset

boolean addOffset(double deg1,
                  double deg2)
                  throws RemoteException

Adds offsets to the telescope. Both values are in degrees. This offset works on the main axes of the telescope, thus it is an az/alt offset for az/alt telescopes and a ra/de offset for paralactically mounted telescopes. Independent of the mount, it is a spatial offset, not an angle difference. For the case of an az/alt telescope, this means that the difference in the azimuth encoder reading that will result from this offset is higher by 1/cos(alt).

Throws:

RemoteException

startTracking

boolean startTracking()
                      throws RemoteException

Starts the tracking from the current position of the telescope.

Throws:

RemoteException

stopTracking

boolean stopTracking()
                     throws RemoteException

Stops the tracking of the telescope. The telescope remains at its current position.

Throws:

RemoteException

changePort

boolean changePort(int portid)
                   throws RemoteException

Switches to the specified port. The port is identified with an integer that is telescope dependend. May throw an unsupported operation exception, if the telescope does not have different ports available.

Throws:

RemoteException

setTcsParameter

boolean setTcsParameter(String parameter,
                        Object to)
                        throws RemoteException

Generic access to some named parameter exposed by the TCS.

Throws:

RemoteException

getTcsParameter

Object getTcsParameter(String parameter)
                       throws RemoteException

Generic access to some named parameter exposed by the TCS.

Throws:

RemoteException

initialize

boolean initialize()
                   throws RemoteException

Initializes the telescope.

Specified by:

initialize in interface ListenerControlling

Throws:

RemoteException

clear

boolean clear()
              throws RemoteException

Clears the telescope. For Halfmann Telescopes this means that the errors are cleared.

Throws:

RemoteException

wipe

boolean wipe()
             throws RemoteException

Ereases any memory of old errors.

Throws:

RemoteException

errors

String errors()
              throws RemoteException

Dumps any errors that are present in the underlying system to the return string. Free format.

Throws:

RemoteException

pointingAt

String pointingAt()
                  throws RemoteException

Dumps the instrumental (encoder) position plus the offset to the current pointing. Includes pointing model offset. Implementation note: In Pilar3, this queries POSITION.HORIZONTAL.[] and POSITION.INSTRUMENTAL.[].REALPOS and returns the former as the encoder pointing and the latter minus former as offset.

Throws:

RemoteException

closeCover

boolean closeCover()
                   throws RemoteException

Protects the telescope. Similar as park, but park is intended for an orderly retreat, a planned park. This method is intended for immediate action.

Throws:

RemoteException

openCover

boolean openCover()
                  throws RemoteException

Protects the telescope. Similar as park, but park is intended for an orderly retreat, a planned park. This method is intended for immediate action.

Throws:

RemoteException

quit

void quit()
          throws RemoteException

Quits the master.

Specified by:

quit in interface ListenerControlling

Throws:

RemoteException