OSIRIS Scripts

Background

The following tables list scripts that can be used to control OSIRIS and/or the telescope. These are useful for two things:

As shortcuts, they can be entered on any napili command line to run the instrument in a command-line mode, as is done with NIRC2
As building blocks in OSIRIS shell scripts which can perform complex operations.

These commands are always available from any OSIRIS account when logged into the OSIRIS workstation, napili.

AO -
CONK -
CONTROL - Scripts to start/stop software
MOT -
OPERATIONS - Scripts for starting MOSFIRE
RUN - Scripts for keyword servers
TDA -
TEL -
UTIL - Scripts for gathering information

OSIRIS Script Library

AO -

ao2real -- disconnects AO simulator
ao2sim -- puts AO system into simulate mode
aodelay -- sets wfao delay time
aohatch -- opens or closes the AO hatch cover
configAOforDomeFlats --
osirisRefocusAO -- change the AO focus to match sscale
rotate -- move rotator and set mode
setdar -- sets dar mode and tells wfao to wait/not wait for dar
trickDichroic -- shows or sets the TRICK dichroic poistion
wait4ao -- sets wait for tip-tilt, deformable mirror, and DAR states
wait4dar -- turns DAR offloading on/off
wait4dm -- enables/disables waiting for deformable mirror loop closure
wait4fsm -- waits for field steering mirror to complete move
wait4tt -- enables/disables waiting for tip-tilt loop closure
wfao -- waits for AO loops to close

CONK -

conk_script --

CONTROL - Scripts to start/stop software

bxy3 --
bxy3.dither --
bxy4 --
bxy4.dither --
bxy5 --
bxy5.dither --
bxy8 --
bxy8.dither --
bxy9 --
bxy9.dither --
iatint --
icoadd --
icoadds --
ifilt -- sets the imager filter
ifilter --
igoi --
iitime --
ingroups --
insamp --
isampmode --
isetnum --
itint --
itmin --
lgdither --
osimgFilterInfo -- normal exit, no error
osimgTakeCals -- takes OSIRIS imager calibrations based upon
osirisAbortAfterSpec -- sets proper keyword so that osirisTakeDataset
osirisAbortAll -- sets proper keyword so that osirisTakeDataset
osirisAbortOnly -- aborts current IMAG or SPEC exposure in dataset
osirisAutoRamp -- configure exposure based on itime
osirisCoadds --
osirisCoordI2S -- convert IMAG pixel coords to instrument coord (in ")
osirisFlushDetector -- takes sufficient test frames to flush either
osirisGetSetnum -- normal exit, no error
osirisGoi -- takes OSIRIS data frames
osirisHeaderPA -- calculates SPEC and IMAG PA's and updates OGS keywords
osirisHomeMech -- normal exit, no error
osirisMoveTel -- basic move telescope command for osiris (in instr coords)
osirisNgroups --
osirisNsamp --
osirisPause -- pauses osirisTakeDataset after current SPEC exposure
osirisRecover -- restart detector server without bothering other servers
osirisResume -- resumes osirisTakeDataset after it has been paused
osirisSampmode --
osirisScriptCleanUp -- resets dataset script keywords in the OGS
osirisScriptMsg -- a general purpose utility for reporting script
osirisScriptReply --
osirisScriptReplyWrapper --
osirisSetTargwave -- sets DCS targwave keywords based on filter
osirisSetnum -- normal exit, no error
osirisSetupMech -- configures OSIRIS IMAG or SPEC mechanisms for an exposure
osirisTakeDarks -- takes a user-defined list of darks
osirisTakeDataset -- coordinates dataset execution for OSIRIS
osirisTint --
osirisTmin --
osirisUnlockMech -- normal exit, no error
ring_bell --
satint --
scoadd --
scoadds --
setnum --
sfilter --
sgoi --
sitime --
sngroups --
snsamp --
ssampmode --
sscale --
ssetnum --
stint --
stmin --
wfgo -- waits for an exposure to finish
wfmech -- waits until all motors (SPEC or IMAG) are idle using OGS keywords
wfready -- checks and waits for detector to be ready before starting exposure

MOT -

om1s --
om2s --
om3s --
om4s --
om5s --
om6s --

OPERATIONS - Scripts for starting MOSFIRE

arrangeWindows --
check_keywords --
osirisCheckoutDetector -- verifies OSIRIS detector is ready
osirisConnect -- powers on instrument, starts servers, and
osirisDisconnect -- sets up OSIRIS software when instrument
osirisEndCooldown -- sets OSIRIS up for a cooldown
osirisEndNight --
osirisSetupDataRoot -- Sets up a new OSIRIS_DATA_ROOT output data tree
osirisSetupNight -- brief description of script function
osirisSetupUser -- prepares instrument and environment for a new user
osirisStartCooldown -- sets OSIRIS up for a cooldown
osirisStartGuis -- normal exit, no error
osirisStartWarmup -- sets OSIRIS up for a cooldown
osirisStopGuis -- normal exit, no error
osirisStopIdl -- normal exit, no error
start_check_keywords --
start_tklogger --
stop_check_keywords --
tklogger --

RUN - Scripts for keyword servers

osiris -- base start/stop/restart script for servers, guis, etc.

TDA -

TEL -

E --
N --
S --
W --
X --
Y --
az --
azel --
en --
gomark --
mark --
mov -- Moves an object from (x0,y0) on the imager
xy --

UTIL - Scripts for gathering information

cabtemps -- print electronics cabinet temps to screen
compareNumbers -- performs comaparison between two numbers
cryotemps -- print electronics cabinet temps to screen
ct -- check tasks for running daemons and GUIs
ctall -- check tasks for running daemons and GUIs
ctx -- check for missing servers and list GUIs
dettemps --
domelamp --
domelamps --
fix_sfilter --
flatlamp --
flatlamps --
help -- prints help for each command
help.cat --
help.inc --
lamp -- normal exit, no error
lastalive -- confirm health of the keyword servers
lastimage --
osirisCheckRPCInfo -- checks if specified service is already registered
osirisCheckServer -- check if server is alive
osirisCleanVncDir -- removes old .log, .pid, and .info files from ~/.vnc
osirisGetCurDisplay -- echos the number of displays on the current host
osirisGetHostname -- echos the number of displays on the current host
osirisGetNumDisplays -- echos the number of displays on the current host
osirisKeywords --
osirisKillRPCEntry -- removes an entry from the RPC registry
osirisPollODSTest --
osirisRPCInfo --
osirisSetTempRanges -- set temperature range keywords
osirisStartVncServers -- start required VNC servers for observing
pressure --
procstatus -- gives the status of a given process
showpower --
syncheck --
temps --
testAll --
vnc --

Go to: OSIRIS Home Page - Instruments Home Page - Keck Home Page

Last modified: