IMACS Software Documentation


Location of this document: http://instrumentation.obs.carnegiescience.edu/Software/IMACS/scripting.html


IMACS Scripting

Unless an absolute path (eg. /home/user/file) is given, the GUI assumes the file to be in the $HOME directory.
If file cannot be opened, the GUI will try file.script.
disperser name
rotate the disperser wheel to select name.
mask name
move mask name into the beam.
filter name
select the filter for the current camera (as defined by the disperser).
etalon value
change etalon setting.
sync
wait for all devices (disperser, mask, filter) to reach their target position.

binning nxm
nxm: n,m = { 1..8 }
set binning
exptime #
set the exposure time to '#' seconds.

start [#]
start exposure
optional #loops parameter.

move dx dy
move the telescope by dx (R.A.) and dy (Dec.) arc-seconds.
coord1 dx dy
turn off guiding; then move the telescope by dx (R.A.) and dy (Dec.) arc-seconds and the PR-guider box the opposite way. Then turn on the PR-guiding again.
coord2 dx dy
turn off guiding; then move the telescope by dx (R.A.) and dy (Dec.) arc-seconds and the PR-guider box and SH-guider probe the opposite way. Then turn on the guiding again.
dither dx dy
just move the PR-guider box by -dx (R.A.) and -dy (Dec.) arc-seconds; the telescope should follow the guide-box.

sleep #
pauses the execution of the script for '#' seconds.
wait text
opens a dialog box displaying 'text' and waits for the user to press the 'ok' button.
This allows to move the telescope focus for example.



Christoph C. Birk, Carnegie Observatories (last updated: 2021-12-09)