Location of this document: http://www.ociw.edu/~birk/IMACS/user.html

User Manual

The official Observer's Manual for IMACS can be found at: Observing with IMACS

1 : System Startup

1.1 : Startup Window

1.2 : Simulation Mode

2 : Mechanics Control

2.1 : MechGUI

2.2 : GraphGUI

3 : Data Acqusition and Display

3.1 : Science Array Control

3.2 : QuickLook Tool

1.0 : System Startup

• Startup Window
• Simulation Mode

1.1 : Startup Window

Below you see a typical setup for the f/4 (long) camera:

Observer: [edit] : observer's name

Camera: [menu] : FYI only; set by instrument specialist

f/2: Dewar mounted at the Short[f/2] camera

f/4: Dewar mounted at the Long[f/4] camera

Mode: [menu] :

simulator: for tests with no dewar

online: dewar and it's electronics is connected and running

Host: [edit] : hostname of computer that is running the 'CCDserver' (FYI only; set by instrument specialist)

Orientation: FYI only; set by instrument specialist

Normal: dewar orientation (dispersion along y-axis of arrays)

Nod/Shuffle: dispersion along x-axis of arrays

CameraGUI: [button] : AutoStart selected: startup data-acquisition window

Mechanics: [menu] :

simulator: for tests with no IMACS mechanics connected

online: IMACS mechanics and electronics is connected and running

ImacsGUI: [button] : AutoStart selected: startup IMACS user GUI

Telescope: [menu] :

Simulator: use Magellan-simulator

Baade: connect to Baade TCS

[menu] : telescope status

online: TCS (or simulator) is running

offline: do not communicate with TCS

TeleGUI: [button] : AutoStart selected: startup telescope GUI

1.2 : Simulation Mode

2.0 : IMACS Mechanics Control

• MechGUI
• GraphGUI

2.1 : MechGUI

• Main Window
• Hardhat Window

2.1.1 : Main Window

File : [menu] :

Load-Setup: load setup-file (n/a)

Save-Setup: save setup-file (n/a)

Help: start browser with IMACS software manual

Configure: configure electronics (engineering-mode only)

Initialize: initialize (HOME,etc) selected component(s)

Self-Test: self-test selected component (engineering-mode only)

Exit: close this GUI

Shutdown: close all IMACS-GUIs

Modules : [menu] :

CamGUI: startup the data acquisition window

TeleGUI: startup the telescope controls

GraphGUI: startup the graphical IMACS status window

WingGUI: startup the closed-loop flexure control (n/a)

Options : [menu] :

Logfile: show logfile path

Sound: set sounds (n/a)

Rotator: IMACS (internal) rotator (n/a, engineering only)

Hardhat: open engineering data window

Hatch:

[menu] : {open,closed} : open/close hatch. Note: There are no sensors on the hatch. The GUI shows the last selection.

Cal-Lamp

[button]: [Ne] [NeHg] [Ar] [Kr] [Xe]: turn on/off calibration lamps

[menu]: set level of continous calibration lamp {Off,L1,..L7}

CF-Guider

[menu] : CF-guider {in,out}: move guider probe. The Slit-Mask should be in 'CF-Guider' position.

[menu] : Optics {Image,SHL}: select between imaging and Shack-Hartman lens.

[menu] : Filter {in,out}: move filter.

Slit-Mask:

[menu] :

f/2-Imaging: no mask
Mask-1..6: slit-masks for multi-object spectroscopy
CF-Guider: special mask for single-object spectroscopy
f/4-Imaging: special mask for f/4 imaging (limited field-of-view)

[button] : MaskLoad: moves mask-tray mechanism to the loading position. Disables any further mask motions until this button is pressed again.

[menu] : GISMO : selects sub-mask position {1..5}

Disperser

[menu] :

Grating: spectroscopy with f/2 camera
Grism: spectroscopy with f/4 camera
f/2-Imaging: imaging with f/2 camera (open hole)
f/4-Imaging: imaging with f/4 camera (mirror)

[edit] : Tilt {22..48}: grating tilt [degrees]. Available only if a grating is in the disperser position.

[edit] : Etalon {0..4095} etalon spacing. Available only if the MMTF is in the disperser postition.

Filter

[menu] :

Filter1
Filter2
Filter..
Filter15

Focus

[edit] : f/4 {6900..9300}: set detector focus for f/4 camera

[edit] : f/2 {6900..9300}: set detector focus for f/2 camera

[menu] : Control {off,on}: automatic focus control

Initialize Components Window:

Select the component(s) you want to initialize (eg. 'Disperser-Wheel') and then press the OK button.

2.1.2 : Hardhat Window

PRG: Principal Guider

[edit] : Theta {-17..+22}: move probe in theta direction

[menu] : Control {On,Off} : guider theta-control

[menu] : Filt {out,int}: insert filter

SHG: Shack-Hartman Guider

[edit] : Radius {-16..+5}: move probe in radial direction

[edit] : Theta {-21..+17}: move probe in theta direction

[menu] : Control {On,Off} : guider theta-control

[menu] : Optics {Image,SHL}: change optics barrel

[menu] : Filt {out,int}: insert filter

L05: Long Camera focus/scale adjustment

[edit] : A {-8..+7}: tip L05 perpendicular to row/column

[edit] : B {-9..+6}: tilt L05 perpendicular to row/column

[edit] : Z {-1600..+1100}: move L05 in Z-direction

Flexure: Flexure (Piezo) control

[edit] : A4 {0..200}: f/4 piezo channel-A position

[edit] : B4 {0..200}: f/4 piezo channel-B position

[edit] : A2 {0..200}: f/2 piezo channel-A position

[edit] : B2 {0..200}: f/2 piezo channel-B position

[menu] : Control {off,on}: automatic flexure control (open loop)

Disperser Service Position: Move the wheel to a special position to replace a disperser unit.

[button] : 1-A: position-1 (grating-A/MOE/MMTF)

[button] : 2-M: position-2 (grism/prism)

[button] : 3-B: position-3 (grating-B/MOE)

[button] : 4-G: position-4 (mirror/grism)

[button] : 5-C: position-5 (grating-C/MOE)

[button] : 6-G: position-6 (grism/prism)

Etalon: [button] : release/acquire CS-100 control.
After control of the CS-100 is released (OK in the confirmation dialog-box) the user may change the settings at the control panel of the CS-100 (right-hand IMACS electronics rack). Then the instrument specialist has to update the mmtf.ini file using SetupTool. After the new 'mmtf.ini' is written the observer may re-acquire the CS-100 control by pressing the 'Etalon' button again. The values in the 'hardhat' area and the FITS file entries are immediately updated (no re-start of 'MechGUI' is necessary).

[edit] : X: X-parallelism

[edit] : Y: Y-parallelism

[edit] : Z: Z-spacing

[output] : c,f,q : X coarse, X fine, X quadrature balance

[output] : c,f,q : Y coarse, Y fine, Y quadrature balance

[output] : c,f,q : Z coarse, Z fine, Z quadrature balance

Temperature Sensors:

[output] : LCamT1,LCamT2: Long(f/4) camera (*)

[output] : SCamT1,SCamT2: Short(f/2) camera (*)

[output] : CollT1,CollT2: collimator (*)

[output] : StrT01...StrT12: structure (*)

[output] : SadBkT: saddle back electronics

[output] : ERackT: electronics rack

[output] : CoolTi,CoolTo: collant-in and coolant-out

[output] : AveInT: average temperature of (*)

Pressure Sensors:

[output] : ClInP,ClOutP: collant in/out pressure (40/20 psi)

[output] : AirP: pressureized air (80-100 psi)

Voltage Sensors

[output] : GCamV1: principal guider power supply (48 V)

[output] : GCamV2: Shack-Hartman guider power supply (48 V)

[output] : GCamV3: center-field guider power supply (48 V)

[output] : MC-5V: motor controller voltage (5V logic)

[output] : MC-24V: motor controller voltage (24V logic)

[output] : RS-24V: serial converter voltage (24V)

[output] : RS-12V: serial converter voltage (12V)

[output] : MC-PC: motor contoller DOS-PC (5V)

[output] : L5-12V: L05 controller (12 V)

[output] : LCamV: Long(f/4) camera science array (48 V)

[output] : LFlxV: Long(f/4) camera wing chips (48 V)

[output] : SCamV: Short(f/2) camera science array (48 V)

[output] : SFlxV: Short(f/2) camera wing chips (48 V)

Close: [button] : close the HardHat window

2.2 : GraphGUI

Below is a snapshot with the following status (f/4 configuration):

• hatch is open; calibration lamps are off
• principal- and SH-guiders are roughly in the middle of their travel; the center-field guider is retracted
• f/4-Imaging mask (#8) is inserted
• disperser-wheel has the 'mirror' (f/4-Imaging) in position
• Spectroscopic filter is inserted (f/4 camera)
• f/4 focus is at 8524.0

Below is another example (f/2 configuration):

• hatch is open; calibration lamps are off
• principal- and SH-guiders are roughly in the middle of their travel; the center-field guider is retracted
• the IFU mask is inserted
• disperser-wheel is in the 'open' position (f/2-Imaging)
• Spectroscopic filter is inserted (f/2 camera)
• f/2 focus is at 7767.0

File : [menu] :

Load-Setup: load setup-file (n/a)

Save-Setup: save setup-file (n/a)

Help: start browser with IMACS software manual

Initialize: initialize (HOME,etc) selected component(s)

Exit: close this GUI

Options : [menu] :

Logfile: show logfile path

Sound: set sounds (n/a)

todo

3.0 : IMACS Data Acquisition and Display

• CamGUI
• QlTool

3.1 : CamGUI

• Control Window
• Dewar Status
• CCD Voltages
• Readout Speeds

3.1.1 : Control Window

left: standard (f/4) version; right: MMTF (f/2) version

File : [menu] :

Reset DSP/Server: reload DSP code and restart DSP

Help: start browser with IMACS software manual

Exit: close this GUI

Shutdown: Shutdown IMACS system (close all GUIs)

Modules : [menu] :

QlTool: startup data display window

MechGUI: startup mechanical IMACS control

WingGUI: startup closed-loop flexure control (n/a)

TeleGUI: startup telescope controls

Options : [menu] :

DataPath: set path for writing the data (FITS) files

Logfile: set logfile path

Sounds: select sound for shutter closed and exposure-loop done events.

The string 'default' as any of the sound-file names makes the CamGUI use the standard keyboard bell.

DewarStatus: display CCD-temperatures, heater-values and dewar pressure.

CCD-Voltages: engineering data window (password protected, details here)

ReadSpeed: define readout-speed (password protected, details here)

ExpTime

[edit] : set exposure time (1..8200 seconds)

[bar] : exposure (left to right) and readout (right to left) progress

[output] : current time during exposure

Loops

[edit] : set (repeat) loop number

[output] : current loop number

ExpType

[menu] :

• Object : regular mode for science data
• Nod&Shuffle : shuffle data and move telescope
• MMTF-Shuffle : shuffle data and change etalon wavelength
• Bias : 0 seconds exposure (shutter closed)
• Dark : exposure with shutter closed
• Flat : regular shuttered exposure

[menu] : readout mode

• Full : full array readout
• Subraster : subrastered readout

Binning

[menu] : {1,2,3,4,5,6,7,8} readout binning factor for rows and columns

[icon] : chip selection

Object : [edit] : set object name

Comment : [edit] : comment for FITS header

Start: [button] : start exposure

Snap: [button]: start 4x4 binned exposure (used to clean the array)

File#: [edit] : set file number (ccdXXXXcY.fits)

'XXXX' is a 4 digit exposure (file-) number

'Y' is the chip number (1..8).

Pause: [button] : pause exposure (shutter closes until button is pressed again)

Stop/Abort: [button] :

Stop during exposure: close shutter and start readout

Abort during readout: abort readout and dump data

Shutter: [icon] : shutter status

Speed: [menu] : set readout speed

Slow: 145 seconds (1x1), 50 seconds (2x)

Fast: 100 seconds (1x1), 40 seconds (2x)

Turbo: 85 seconds (1x1), 30 seconds (2x)

Disk: [bar] : disk status

Nod&Shuffle definition dialog-box

Shuffle: [edit] : shuffle distance (arcsec)

[output] : rounded up to pixels

Telescope-Nod: [edit] : telescope motion [arcsec] between exposures

DwellTime: [edit] : exposure time between shuffles/nods

N-Cycles: [edit] : number of 'A-B' cycles (2 exposures per cycle)

MMTF Straddle & Shuffle Dialog

Shuffle: [edit] : shuffle distance (arcsec)

[edit] : shuffle distance (pixels)

Straddle: Off1 [edit] : off-band z-value

On [edit] : on-band z-value

Off2 [edit] : off-band z-value

DwellTime: [edit] : exposure time between shuffles

N-Cycles: [edit] : number of 'On-Off1-Off2-On' cycles (4 exposures per cycle)

3.1.2 : Dewar Status

Displays temperature (Temp) and heater (Heat) current for each chip and the pressure (VacSensor) inside the dewar. Note that the VacSensor reading should be 0.0 because it bottoms out at 1.0e-4 [mbar].
The ion pump (Mosaic2 dewar only) has a more precise pressure sensor, but it only works when the ion pump is on (it uses the current created by the pump).
(Click here for the engineering version)

3.1.3 : CCD-Voltages

3.1.4 : Readout Speeds

3.2 : QlTool

• Control Window
• Mosaic Overview
• Magnifier

3.2.1 : Control Window

File : [menu] :

• Load: Load file(s)
• Help: start browser with IMACS software manual
• Exit: close this GUI

Options : [menu] :

• Satlevel: set count-level above which pixels are marked saturated (red)
• SubrDim: set width and height of a new subraster created by 'QlTool'
• ClearFrame: if checked: clear frame before a new image is displayed
• LargeDisplay: if checked: set data window geometry to 1024x1024

Lookup-Table: [menu] : {Grey,InvG,Rain,BBdy}: set color lookup table for data display windows

Magnification: [menu] : {mag1,mag2,mag4,mag8}: set magnification for magnifier window

Pixel: [output] : pixel coordinates (x=680,y=1129) and pixel value (1234)

Radius: [button] : [output] : [button] : in/decrease the radius for aperture statistics

min/max: [output] : minimum (1042) and maximum (34247) pixel values within the aperture

mean/dev: [output] : mean (1980.7) and standard-deviation (4041.4) within the aperture

flx,fwhm: [output] : estimated flux (294437) and FWHM (2.65 pixels) of the object in the aperture

3.2.2 : Mosaic Overview

Displays all eight arrays in a pixel-averaged de-magnification to 256x512 (512x1024 with 'Options->LargeDisplay) per chip.
After loading a file from disk the title bar shows the name of this file.

Maximum: [edit] : high-cutoff (white-level) of colormap

Stretch: [menu] : Scaling scheme for colormap

• man: manual scaling of colormap (enter values into 'Maximum', 'Minimum' edit windows
• 67%: set black/white cutoffs using 67% of the histogram of all pixels values
• 90%: set black/white cutoffs using 90% of the histogram of all pixels values
• med3: set black/white cutoffs to +-3 sigma around median of all pixels.
• med5: set black/white cutoffs to +-5 sigma around median of all pixels.
• 3/10: set black as 'median-3*sigma' and white as 'median+10*sigma
• mima: set black to the minimum and white to the maximum pixel value

Scale: [menu] :

• On: scale the background (bias-level) of each chip separately (the bias-brightness for all 8 chips will appear similar)
• Off: scale the colors for all 8 chips together (the bias-brightness will differ from chip to chip)

Minimum: [edit] : low-cutoff (black-level) of colormap

Mouse functions on the Mosaic-Overview window:

press/drag left mouse-button:

Move magnifier/aperture to current cursor position. The magnifier cannot be moved across chip boundaries.

press middle mouse-button:

Cycle through magnifications (1mag -> 2mag -> 4mag -> 8mag -> 1mag)

press/drag right mouse-button:

Squeeze colormap.

Keyboard functions on the Mosaic-Overview window:

Space: FWHM-fit and flux-estimate at current magnifier position

Arrow: (cursor-key) move magnifier 1 pixel

'1': move magnifier to the center of chip-1 ('2'..'8' move to chip-2..8)

If CamGUI is in subraster-definition mode:

a: add a subraster at the current magnifier position. The geometry is set with the 'Options->SubrDim' dialog-box.

r: remove subraster closest to the current magnifier position

n: move magnifier to the closest subraster

3.2.3 : Magnifier Window

The magnifier window displays an enlarged area around the current cursor position on the Mosaic-Overview window.

• The current chip-number is displayed in the title bar of the magnifier.
• The position of the magnifier is set by left-clicking in the Mosaic-Overview window. It can be moved with the cursor-keys on the Mosaic-Overview.
• The size of the magnifier window is adjustable by click/drag on the window borders.
• The magnification can be set in the QlTool Control Window