The IMB Command

back to software page




IMB/CONFIGURE

back to top

/CONFIGURE is generally issued by dewar subprocesses to set the turret to point to their dewar, and shift the X-Y stage to the position of the telescope aperture definition for that dewar. It can be initiated from the keyboard, but the telescope will not be offset to bring the star into the appropriate aperture as it is when the command is issued by the dewar subprocess.



IMB/TURRET=keyword

back to top

/TURRET sets the position of the turret on which the dichroic reflexer is mounted. This action directs the infrared beam from the telescope to the dewar to be used. The turret can be positioned in any one of four positions identified by the keywords A_POS (or 1), B_POS (or 2), C_POS (or 3), and IMB_POS (or 4). Dewars can only be mounted on the IMB ports corresponding to position keywords A_POS (or 1) and C_POS (or 3). CASPIR is mounted on IMB port position A. An IMB/TURRET=A_POS command is implicitly executed when a CASPIR command is first issued.



IMB/FOCUS

back to top

/FOCUS is used to control the focus function of the Tip-Tilt focusser unit mounted on the IMB X-Y stage. This optical focus is independent of the telescope focus which should be optimised for the infrared dewar. /FOCUS runs a routine which allows the user to control the Tip-Tilt focus using the up and down arrows on the control terminal keyboard. The focus is moved by a preset amount each time the arrow key is pressed. Limit switches ensure safe operation. Type Q to quit.



IMB/X_ABSOLUTE=integer_number

back to top

/X_ABSOLUTE sets the X-axis of the IMB X-Y stage carrying the Tip-Tilt sensor to the specified integer X-axis encoder number. Permitted integer values are in the approximate range of about 9000. Limit switches ensure safe operation.



IMB/Y_ABSOLUTE=integer_number

back to top

/Y_ABSOLUTE is the same as for /X_ABSOLUTE but applies to the Y-axis of the X-Y stage.



IMB/XY_ZERO

back to top

/XY_ZERO defines the zero point of the relative coordinate system for the IMB X-Y stage to be the current absolute (X,Y) position. This relative coordinate system is in units of millimeters in the f/18 beam of the telescope (as the focal ratio converter moves with the X-Y stage) and would normally be zeroed on the position of the center of the infrared array. Offset guide stars can then be found from known offsets in arcsec (the plate scale at f/18 is nominally 5.0''/mm).



IMB/X=real_number

back to top

/X sets the IMB X-Y stage carrying the Tip-Tilt sensor to the specified X coordinate in mm relative to a zero point defined with the /XY_ZERO qualifier.



IMB/Y=real_number

back to top

/Y is the same as for /X but applies to the Y-axis of the X-Y stage.



IMB/XY_HOME

back to top

/XY_HOME returns the IMB X-Y stage to the defined zero position of the relative coordinate system. This qualifier can be used to return the Tip-Tilt sensor from the position of an offset guide star to the infrared position.



IMB/XY_INCREMENT

back to top

/XY_INCREMENT runs a routine which allows the position of the IMB X-Y stage to be controlled from the control terminal keyboard using the four arrow keys. The space bar is used to toggle fast and slow motion controls. This qualifier is used for interactive adjustment of the X-Y stage position, such as when centering the Tip-Tilt sensor on a star.



IMB/CALIBRATION=keyword

back to top

/CALIBRATION automatically configures the calibration lamp module for measurements of each lamp. The available keywords are ARGON, XENON, INCANDESCENT, and OFF. /CALIBRATION=OFF turns off the calibration lamps and reconfigures the module for observing celestial objects. This is the default qualifier value, i.e., this is the action taken in response to IMB/CALIBRATION.



IMB/ARGON=[ON/OFF]

back to top

/ARGON turns on or off the argon lamp in the calibration lamp module.



IMB/XENON=[ON/OFF]

back to top

/XENON turns on or off the xenon lamp in the calibration lamp module.



IMB/INCANDESCENT=ON/OFF]

back to top

/INCANDESCENT turns on or off the incandescent lamp in the calibration lamp module.



IMB/LAMP_SELECT=keyword

back to top

/LAMP_SELECT positions the lamp select mirror in the calibration lamp module to point to the appropriate lamp. The lamp select keywords are ARGON, XENON, and INCANDESCENT.



IMB/FLIP_MIRROR=[IN/OUT]

back to top

/FLIP_MIRROR moves the calibration lamp module flip mirror in and out of the telescope beam. This mirror directs light from the calibration lamps to the infrared detector and Tip-Tilt sensor.



IMB/DISPLAY=keyword

back to top

/DISPLAY selects the IMB status display screen to be put on the top half of the instrument status screen. The startup communications display is available by specifying IMB/DISPLAY=COMMUNICATIONS.



IMB/INFORMATION

back to top

/INFORMATION produces a copy of the IMB status display screen on the control terminal screen. This is useful for determining the IMB status without overwriting the normal instrument status display.



IMB/STATUS_NOW

back to top

/STATUS_NOW queries the IMB for its current status without altering any settings. This qualifier is used to confirm that the status display is showing the true settings.



IMB/[NO]REPORT

back to top

/[NO]REPORT toggles a flag which defines whether or not some explanatory messages will be broadcast to IR_BROADCAST . If /NOREPORT has been selected, error conditions are flagged only as highlighted and cryptic messages in the IMB status display (which may not be visible at the time).



IMB/ABORT

back to top

/ABORT causes the current operation to be terminated.



IMB/[NO]DEBUG

back to top

/[NO]DEBUG toggles a flag which defines whether or not various diagnostic messages are broadcast to IR_BROADCAST during normal operation. As the name suggests, this qualifier would not normally be used.