A new observing tool for Mosaic II on the Blanco 4-meter called "mosocs" will provide better support for programs that repeatedly image the same field. This script allows astronomers to create a file that completely describes a whole sequence of observations. Each observation is defined on one line, and this definition includes the telescope pointing, guide star position, filter, and exposure time. The script reads the file one line at a time, sending instructions to the telescope, guide camera, and instrument to control all the necessary parameters. The file can also be used to generate a list of positions to be read into the TCS, but under the current implementation this is not necessary because the script itself sends the slew requests to the telescope.
This tool is especially useful for programs that need to return to exactly the same location repeatedly (such as asteroid searches, supernovae searches, and the Super MACHO Survey), since it stores the position of the guide stars used for each pointing. This allows observers to return rather precisely to the same spot on the sky for repeat observations.
The mosocs observing script is driven by an "observing plan" file, which specifies on one line everything the observer would normally specify at the prompt when observing in normal, interactive mode. An example mosocs observing plan looks like:
# This is a comment, to describe the file # fields or columns are numbered below to aid following description # 1 2 3 4 5 6 7 8 9 10 field1 05:30:25.31 -65:34:21.0 2000. S 0 0 5. R Field1_title field2 05:30:25.32 -65:34:22.0 2000. N 0 0 6. R Field2_title
Comment lines begin with #, and are completely ignored by the script. The columns are space delimited, so only order is important, not column numbers. The order of fields on each line is:
The first time you run mosocs, you should simply enter 0 0 for the guider x y coordinates. You will update these the first time you run the script.
Another example of an observing plan, this one specifically for two pointings at a standard star field in multiple filters, looks like:# Landolt standard field SA 107 # 107S puts stds in 4 S CCDs, 107N puts stds in 4 N CCDs sa107S 15:39:39 -00:09:06 2000. N 287 286 10. U sa107S sa107S 15:39:39 -00:09:06 2000. N 287 286 2. B sa107S sa107S 15:39:39 -00:09:06 2000. N 287 286 1. V sa107S sa107S 15:39:39 -00:09:06 2000. N 287 286 1. R sa107S sa107S 15:39:39 -00:09:06 2000. N 287 286 2. I sa107S sa107N 15:39:39 -00:28:06 2000. N 215 120 10. U sa107N sa107N 15:39:39 -00:28:06 2000. N 215 120 2. B sa107N sa107N 15:39:39 -00:28:06 2000. N 215 120 1. V sa107N sa107N 15:39:39 -00:28:06 2000. N 215 120 1. R sa107N sa107N 15:39:39 -00:28:06 2000. N 215 120 2. I sa107N
This and other useful sample observing plan files can be found at the telescope in the ocsfiles directory in the home directory of the mosaic user account.
The first step to using the mosocs script is to set the parameters, most importantly the name (and location) of your observing plan file. An epar of the mosocs script looks like:
I R A F
Image Reduction and Analysis Facility
PACKAGE = user
TASK = mosocs
filename= /ua80/mosaic/ocsfiles/sa107ocs Observing Plan File
doit = yes Observe this field
ingcam = Guide camera
ingx = Guide box x coord
ingy = Guide box y coord
quit = yes Quit out of observing plan
(addstar= no) Add guider box x,y coords
(obspars= ) Observing parameters (pset)
(detpars= ) Detector parameters (pset)
(instrpa= ) Instrument parameters (pset)
(telpars= ) Telescope parameters (pset)
(stdname= yes) Use standard objNNNN image names (yes) or field+
(resume = no) start at position_number rather than beginning o
(positio= 11) starting line number in file
(mode = ql)
the filename parameter should be set to the full pathname of your observing plan file.
the addstar parameter determines whether or not the script will ASK the observer for the guider box x y coordinates. See below for use.
the stdname parameter can be used to change the naming scheme of the FITS files written to disk. The default naming scheme of the Arcon software is objNNNN.fits. Alternatively the observer can define some other root in the template parameter of obspars. Either of these are enabled by stdname=yes, depending on whether the template parameter of obspars is blank or not. With stdname=no, the FITS files are named as fieldname.ut_time.fits, where the ut_time is the time at the START of the exposure (when the observe command is given).
the resume parameter can be used to resume an aborted or interrupted sequence of observations at a specified position.
The other parameters (doit, ingcam, ingx, ingy, quit; and obspars, detpars, instrpars, telpars) are all variables or psets used by the script, and should not be modified.
Once you've set the parameters as desired, you can type mosocs at the ARCON Acquisition IRAF prompt. The observing plan file will be read one line at a time, prompting for needed parameters or input.
If you are interested in using the guide star recovery feature of mosocs, the first time you run the script is unique, since it is the first time you will be observing the fields and hence you will be identifying the guide stars (and their guider x y coordinates) as you go. To help keep track of the guider x y coordinates, you can set addstar=yes. With this setting, mosocs will prompt you for the guide star x y coordinates, and write them out in a new observing plan file (NEWOCSFILE) with all of your other observing configuration, so that you can use this new observing plan file for all subsequent observations, setting addstar=no and allowing mosocs to set the guider box on the previously noted x y position.
Here is an example run of mosocs with addstar=yes:
cl> mosocs addstar=yes
Observing Plan File (/ua80/mosaic/ocsfiles/temp.in):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Moving to position 1:
Field = field1
20:12:00.22 -30:00:00.00 2000
Add guider box x,y coords to file
Guide camera: N
Guide box x coord: 150
Guide box y coord: 175
Polling environmental computer for temperature. Please wait...
Truss temps: 6.9 6.9 6.9 6.6 at UT 03:55:00 on 08/08/2002
Median upper truss temp is = 6.9
Temperature has been set in instrpars.
Best guess at R-band focus:15515.5
Observe field1 title=Field1_title texp=5. filt=B
Observe this field (yes):
Focus calculation:
base focus = 15430.0000000
correction for filters = -20.0000000
correction for temperature = 49.4999771 (Delta T = -0.4 )
final focus = 15459.5000000
Filter1 = B Telfocus = 15457.0000
Image obj054
Mosaic2 [1:8192, 1:8192] bin=[1:1], gain 2
Single character sub-commands:
A Abort exposure
P Pause exposure
R Resume paused exposure
S Stop exposure
T Change exposure title (current exposure ONLY)
X Change exposure time (current exposure ONLY)
Q Interrupt task (optionaly aborting exposure)
Field field1 observed
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Moving to position 2:
Field = field2
20:14:00.00 -31:00:00.00 2000
Add guider box x,y coords to file
Guide camera (N): S
Guide box x coord (150.): 300
Guide box y coord (175.): 250
Polling environmental computer for temperature. Please wait...
Truss temps: 6.9 6.9 6.9 6.6 at UT 03:55:00 on 08/08/2002
Median upper truss temp is = 6.9
Temperature has been set in instrpars.
Best guess at R-band focus:15515.5
Observe field2 title=Field2_title texp=6. filt=R
Observe this field (yes):
Focus calculation:
base focus = 15430.0000000
correction for temperature = 49.4999771 (Delta T = -0.4 )
final focus = 15479.5000000
Filter1 = R Telfocus = 15480.0000
Image obj055
Mosaic2 [1:8192, 1:8192] bin=[1:1], gain 2
Single character sub-commands:
A Abort exposure
P Pause exposure
R Resume paused exposure
S Stop exposure
T Change exposure title (current exposure ONLY)
X Change exposure time (current exposure ONLY)
Q Interrupt task (optionaly aborting exposure)
Field field2 observed
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Observations finished.
The file NEWOCSFILE has been created with all of your
guide star information from this run. You may now
copy and edit that file for your observing plan for
following nights.
Once you've run mosocs once with addstar set to yes, OR if you're not interested in using the guide star recovery feature, you should set addstar=no. The mosocs script then only prompts for
Here is an example run of mosocs with addstar=no:
Last updated: 7 August 2002 by Chris