Observation Condition Decision tool (OCD)

Getting help

Help can be found at

​http://www.mpe.mpg.de/~montefra/documentation/ocd/devel/index.html

After an update you might have to remake the OCD config file. Be sure to save a copy first and then run ocd config copy.

Running OCD

• Go to the "ocd" directory
• Run queue_short_list.php queue_short_list.php command to generate "autoschedule_n_obs.dat"
• Edit the "autoschedule_n_obs.dat" to remove targets with exposure times longer than the standard 3x6 minutes. NOTE: not all "deep" fields have long exposures and those should remain in the list.
• Then try ocd run --config ~/ocd/ocd.cfg to start OCD. To stop OCD do a cnrt+\.
• If you want to save a log for engineering purposes try the following: ocd run --config ~/ocd/ocd.cfg |& tee logs/OCDlog_YYYYMMDD_X.txt where the X is the test number; note that this produces a pretty big log so keeping to a single track is probably a good idea and gzipping it before e-mailling it is also a good idea.
• Then to allow OCD to select hetdex fields you need to execute ocd allow_hetdex --config ~/ocd/ocd.cfg start
• To check last selected by OCD target use command in ocd subdirectory tail -f logs/OCDlog_YYYYMMDD_X.txt | grep run_shot
• To see what autoschedule is planning, use command in ocd subdirectory tail -f logs/OCDlog_YYYYMMDD_X.txt | grep Autoschedule
• To stop auto hetdex fields running run ocd allow_hetdex --config ~/ocd/ocd.cfg stop

Running a shot

• The RA and DEC must be in floating point format and should be taken from the .cfg file
• shot number must be the target name from shuffle

To run a shot you first need to setup a shuffle run for that object. This should be done in ocd/shuffle/output. In that directory you will also need to make a directory with the name of the object and move the .cfg file from the HETcommands directory into the shuffle directory.

Then look at the .cfg file and pull out the ra, dec and az from that file. fill in the fields like below:

ocd run_shot --config ~/ocd/ocd.cfg -ec -d yes sdss14n643 1001 12.241050 0.856717 144.9583 0 15 15 15

where the 0 is the Az indicator (E=0,W=1), 15 15 15 is the exposure time for exp01, exp02, exp03 and 1001 will be the observation number.

Running autoschedule

Looks at the shot list and for a given JD tries to pick all targets that should be observed after that JD for that night.

$CUREBIN/autoschedule_main -v -i /home/mcs/astronomer/ocd/autoschedule_init.dat -m /home/mcs/astronomer/ocd/moon_loc.dat /home/mcs/astronomer/ocd/autoschedule_n_obs.dat 2458136.793750 135 1.5 0.99 21.2

Updating OCD

If someone updates OCD you may need to regenerate the ocd.cfg file. First save a copy of the working version. Then create a new version with ocd config copy. You will then need to edit the new config copy with all of the old paths and settings. I do this by doing a diff between the new one and the saved copy.