User's Guide to Shane Adaptive Optics System


Table of Contents


Introduction
AO Observing Preparation
Hardware Overview
Software Overview
Real-time code shaneao
Real-time control GUI
Peeko
TTPeeko
Power Control saopower_ui
Motor Control saomot_gui
Field Steering fieldsteer.tcl
Laser Shutdown Monitor LSM.tcl
WFS Focus Tracking saoWFSFocusTrack.tcl
SAO System Monitor
aopococ
imageSharpen
Gallery of Aberrations
Techref

Data Archive
Mt. Hamilton Homepage

ShaneAO Motor Control

The GUI to control the motors in ShaneAO is saomot_gui. It can be started from shanevnc, covert, gouda, or karnak with the command saomot_gui.

Position and status of each motor are displayed in the GUI. It also allows one to either change the position of each motor individually or reconfigure using stored setups. The GUI with a typical setup is shown in Figure 1.


Figure 1: saomot_gui GUI

Each motor has its own control interface within the GUI and each works in a similar way. For motors with defined positions (e.g. Lenslet), click on the name of the position (e.g. 16x) and it will give you a menu of available positions. Simply click on the desired position and it will be shown with a yellow background and a green arrow will appear immediately to the right (Figure 2). The yellow background is a warning that the motor has not yet moved. To move the motor click on the green arrow.


Figure 2: Selection and Go Arrow

Many motors do not have predefined positions, for example the TT Cam X motor. To move these motors, enter the desired position in the entry box or use the up and down arrows to the left of the entry box to change the value (for example, the step size for the TT Cam X stage is 10 counts). Once you press the green arrow to move the motor, the icon will change from the green Ready check to a pie chart that will update from being all black at the beginning of the move to all green as the move completes. When the move is done, the icon will revert back to the green Ready check.

Other icons, shown in the table below, indicate the status of the motors. A red Error X indicates there is a problem with the motor motion. One can get more information about the motor by clicking on the icon, which will bring up a motor detail panel (see Figure 3). A yellow Warning triangle alerts users that there may be an issue, such as hitting a motion limit. Usually moving the motor again will clear the warning, but if not one can click on the icon to bring up the detail panel to get more information. A Lock icon indicates that the motor has been locked out to prevent use either due to a mechanical problem or because a staff member is doing maintenance on the mechanical stage or motor itself. The Gear icon is used to indicate that the stage is moving during calibration.

Motor Status Icons
StatusIconStatusIcon
Ready/OK Moving
Warning Error
Locked Calibrating


Figure 3: Motor Detail Panel

The detail panel (see Figure 3 for an example) shows detailed information about the motor and its status. From this panel one may change the operation mode of the motor or move it in absolute or relative moves. The buttons at the bottom of the window are all reasonably self-explanatory. The Lock button brings up a separate GUI (see Figure 4) to select which motors to lock out and an entry window to describe the reason for the lockout. Do not unlock a stage unless 100% sure that it is safe to do so.


Figure 4: Lockout GUI

File Menu

The File menu enables one to change the font size of the GUI. This can also be done with the shortcuts Ctrl + to increase the font size or Ctrl - to decrease the font size. One can also quit the GUI from the file menu or by using the shortcut Ctrl q.


Figure 5: File Menu

Actions Menu

The Action menu has many options for interacting with the motors. The top section has two options to Cancel pending motor moves or Apply pending moves. This is handy when many stages need to be moves to change between Instrument setups (see below) or when you want to cancel such a move. Instead of using the menu, once can use the shortcut Ctrl c to cancel pending moves, or Ctrl m to move the stages.

The second section has options for Enabling Motion (useful when the saomot server has been restarted) or Calibrating the motors. When calibrating motors, one has the choice of calibrating just stages that are not currently calibrated, or doing all stages. (Note, at present there is a bug in the server code, so that calibrating all stages, does most but not all, so some may need to be done individually).

The third section is to deal with misbehaving or broken motors, as well as safety lockouts. In case motors are moving in ways they shouldn't (e.g. when not commanded to move, or not properly reaching the desired position), one can stop all motor motion by clicking on Stop all motion. Locking out software control of one or more stages can be accomplished by clicking on Lock stages... which brings up the Lock GUI (shown above in Figure 4). If stages have been locked out and are ready to be put back into service, motion control can be re-enabled by clicking Unlock all. Please note that Unlock all should never be performed unless one is 100% certain that it is safe to do so.


Figure 6: Actions Menu, inclusing Calibrate Sub-menu

Instrument Setups

It is possible to save setups for future use and for ease of switching between setups during observations. To get the instrument setup menu, click on the setup's name (default is None as shown in Figure 7). The menu initially has three items, Load setup file..., Choose directory..., and Save new setup.... Load setup file... will bring up a file browser and you can load an existing setup. Setup files for ShaneAO will always have the extension .shaneao. Choose directory... will also bring up a file browser window in which one can select the directory that contains the saved setup files. Once that directory is selected, the saved setup file names will be displayed in the top portion of the Instrument setup menu (as shown in Fig. 7). One can switch between setups by clicking on the desired setup then moving the motors (either individually by pushing the green arrow icons, or all at once using Actions-Apply pending, or with the keyboard shortcut Ctrl m.

The last option, Save new setup..., brings up the Save Setup GUI (see Figure 8 below). By default, all movable stages are selected and highlighted in yellow. Click on a stage to deselect it if the value is not desired in the saved setup. Once the desired motors are selected, click on Save as..., which will bring up a file browser window in which the directory and file name for the new setup can be set.


Figure 7: Instrument Setup Menu


Figure 8: Save Setup GUI


Individual Motor Information

Details about each motor stage are described below.

Lenslet

The lenslet stage has three positions, 8x, 16x, and 30x, corresponding to lenslet arrays with 8, 16, or 30 lenslets across the telescope aperture. One can move to the 30x position, but those optics have not yet been installed.


Figure 9: Lenslet Selection

Lenslet Motor Technical Specifications
Lenslet 16xEncoder=-2206
Lenslet AEncoder=-446178
Lenslet CEncoder=443354
Motor Encoder Minimum-454000
Motor Encoder Maximum445000
Max Speed40000

WFS Focus

WFS focus stage is normally at 4475 for NGS observations. In LGS mode, when closing the WFS loop on the laser, the WFS focus position is set with the help of the WFS Focus Tracking GUI.

WFS Focus Motor Technical Specifications
NGS PositionEncoder=4475
Motor Encoder Minimum-6875
Motor Encoder Maximum5400
Max Speed1000

TT Cam X and Y stages

The TT Cam X and Y stages are used during LGS operations to position the TT camera on the tip/tilt star.

TT Cam X Motor Technical Specifications
On-axis PositionEncoder=4018
Motor Encoder Minimum-280000
Motor Encoder Maximum210000
Max Speed25000

TT Cam Y Motor Technical Specifications
On-axis PositionEncoder=-23867
Motor Encoder Minimum-250000
Motor Encoder Maximum250000
Max Speed25000

WFS Dichroic

The WFS Dichroic stage moves different dichroics into the beam to determine which wavelengths of light go to the WFS and the ShARCS NIR Camera. Currently the WFS Dichroic stage is locked out due to a hardware problem and not movable.

WFS Dichroic Motor Technical Specifications
900nm DichroicEncoder=???
Motor Encoder Minimum-13000
Motor Encoder Maximum2200
Max Speed1000

TT Dichroic

The TT Dichroic stage moves different dichroics or a mirror into the beam to determine which wavelengths of light go to the TT Camera. In NGS mode one will typically use the Mirror to send all the light to the WFS and no light will get to the TT Camera. In LGS mode, we use the Splitter, which is a 600 nm dichroic.


Figure 10: TT Dichroic Selection

TT Dichroic Motor Technical Specifications
MirrorEncoder=-7403
Splitter (600nm Dichroic)Encoder=13010
Motor Encoder Minimum-26200
Motor Encoder Maximum16700
Max Speed1000

Cal X and Cal Y

The Cal X and Cal Y stages control the positions of the calibration sources. Current sources are a White Light Source, Red Laser Source (635nm), and a Flea Camera (for field acquisition, if necessary). For strehl calibration using ShARCS, both Cal X and Cal Y should be in the White Light Source position. For science data acquisition, Cal Y should be in the Open position.


Figure 11: TT Dichroic Selection


Figure 12: TT Dichroic Selection

Cal X Motor Technical Specifications
White Light SourceEncoder=-4702
Motor Encoder Minimum-38000
Motor Encoder Maximum15000
Max Speed2000

Cal Y Motor Technical Specifications
Aquisition CameraEncoder=7625
White Light SourceEncoder=1492
Red Laser SourceEncoder=-1000
Motor Encoder Minimum-9200
Motor Encoder Maximum8000
Max Speed2000

Orientation

Many motors in the SAO system have different motion parameters based on how the instrument is oriented as the TUB rotates and telescope moves. In general use, On Telescope should be selected. When SAO is stowed in the AO lab, select Stow(Z). For engineering tests, UserSet should be selected and the following saomot service keyword can be used to manually set the orientation: ORIENTATION. When ORIENTATION=OnTelescope, then OF_TOB, OF_DEC, and OF_HA come from poco (the 3-m telescope pointing service). If ORIENTATION=Stow(Z), it is the same as OnTelescope except Dec=37.3. If ORIENTATION=UserSet then OF_TUB, OF_DEC, and OF_HA keywords are user-writable, and used as if the bench is on the telescope and poco has those values.


Figure 13: Orientation Selection

WFS steer 1 Rx and Ry

The WFS steer 1 Rx and Ry motors are used for field steering the natural guide star into the WFS. Field steering range is about 10 arcsec in any direction (note, the field steering model is not yet complete for this range as of Jan 2015). On-axis positions for the motors are X = -4.0239 and Y=-2.3337 (Note: GUI displays values that are Motor Encoder Counts / 10000.).

These motors work in tandem with the WFS steer 2 Rx and Ry motors. Rarely are they moved directly from the GUI, but rather through the fieldsteer GUI or dither scripts from ShARCS scriptproc.

WFS steer 1 Rx Motor Technical Specifications
Motor Encoder Minimum-132000
Motor Encoder Maximum7400
Max Speed8683

WFS steer 1 Ry Motor Technical Specifications
Motor Encoder Minimum-94650
Motor Encoder Maximum22000
Max Speed8620

WFS steer 2 Rx and Ry

The WFS steer 2 Rx and Ry motors are used for field steering the natural guide star into the WFS. Field steering range is about 10 arcsec in any direction (note, the field steering model is not yet complete for this range as of Jan 2015). On-axis positions for the motors are X = -3.3011 and Y=-3.7888 (Note: GUI displays values that are Motor Encoder Counts / 10000.).

These motors work in tandem with the WFS steer 1 Rx and Ry motors. Rarely are they moved directly from the GUI, but rather through the fieldsteer GUI or dither scripts from ShARCS scriptproc.

WFS steer 2 Rx Motor Technical Specifications
Motor Encoder Minimum-115000
Motor Encoder Maximum17500
Max Speed8765

WFS steer 2 Ry Motor Technical Specifications
Motor Encoder Minimum-110000
Motor Encoder Maximum13000
Max Speed8599

Fold 1 Rx and Ry

The Fold 1 Rx and Ry motors control the steering of light from the telescope into the ShaneAO instrument. Typical positions for the motors are X = 54.13 and Y = 61.78 (Note: GUI displays values that are Motor Encoder Counts / 1000.)

Fold 1 Rx Motor Technical Specifications
Motor Encoder Minimum-17500
Motor Encoder Maximum86000
Max Speed2000

Fold 1 Ry Motor Technical Specifications
Motor Encoder Minimum-3000
Motor Encoder Maximum93500
Max Speed2000

TT Filter

There is a Thorlabs filter wheel in front of the Tip/Tilt camera so that bright stars will not saturate the detector. Normal operations have the TT Filter in the Open position, but ND filters with Optical Density (OD) of 1, 2, 3, 4, and 5.


Figure 14: TT Filter Selection

TT Filter Position List
1OD1
2OD2
3OD3
4OD4
5OD5
6Open

Sci Filter

The Science filter wheel is installed in front of ShARCS to enable installation of custom filters outside of the dewar. Note: This filter wheel is not installed at this time (Jan 2015). Up to six filters can be installed in the filter wheel.


Figure 15: Sci Filter Selection

Sci Filter Position List
1Filter_1
2Filter_2
3Filter_3
4Filter_4
5Filter_5
6Open

Sodium Filter

The Sodium Filter is installed in front of the WFS to block light from objects other than the Laser Guide Star. There are two positions, In and Out. A quirk of the system is that to move the filter Uplink in the shaneao (saocon_gui) code must be off. Hence, turn Uplink off, move the sodium filter, then turn Uplink back on.


Figure 16: Sodium Filter Selection


Additional Info

There are five servers (dispatchers) that run behind the scenes for motor control. These run on shanevnc and are started as a group with the command ao start saomot. Individual servers can be started with the command ao start saomot1 (or saomot2,3,4, or 5). One can stop all servers or just one using the ao stop saomot (or saomot1, etc.). The status of the servers can be seen with the ao status saomot command.

There are 3 Galil motor controllers (saomot1, saomot2, saomot3), a RIO controller (saomot4), and ThorLabs filter wheels (saomot5). The controller and channel for each motor is listed in the table below.

Communication to the Galils goes through a router named saorouter.ucolick.org. Communication to the TT Filter wheel is through the lantronix ao-serial-1.ucolick.org. Communication to the Sci Filter wheel is through the lantronix ao-serial-2.ucolick.org.

Motor Control Channels
MotorDispatcherChannel
Lenslet1G
WFS Focus2H
TT Cam X1F
TT Cam Y1E
WFS Dichroic2G
TT Dichroic2E
Cal X3A
Cal Y2F
WFS steer 1 Rx2C
WFS steer 1 Ry2D
WFS steer 2 Rx2B
WFS steer 2 Ry2A
Fold 1 Rx1A
Fold 1 Ry1B
TT Filter5TTFILT
Sci Filter5SCIFILT
Sodium Filter4Digital 0
Uplink TT Tip (X)4Analog 2
Uplink TT Tilt (Y)4Analog 3


Last modified: Wed Nov 2 12:39:23 PDT 2016