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

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`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

Interface TelescopeControlling

Method Summary

Methods inherited from interface stella.rmi.FocusControlling

Methods inherited from interface stella.rmi.ListenerControlling

Method Detail

derotator

derotatorOffset

moveAzAlt

moveRaDec

offset

addOffset

startTracking

stopTracking

changePort

setTcsParameter

getTcsParameter

initialize

clear

wipe

errors

pointingAt

closeCover

openCover

quit