The Arecibo Legacy Fast ALFA (ALFALFA) Survey

A2010 Observing Checklist

WARNING: Version date: August 2010

Cookbook date:	02 Sep 2010
CIMA version :	"A `smart' version of CIMA (3.1.08 2010-02-01 17:44 "Smart")"
WAPPdata :	/share/pserverf.sda2/wappdata/ "wdata3" alias New as of September 2, 2010

Find the 2007 version here, the Spring 2008 version here, the Fall 2008 version here, the Spring 2009 version here, and the Jan 2010 version with the normal meridian (transit) setup here. The special Spring 2010 instructions are here as is the corresponding checklist.

We are using a several special configuration files .conf, both for a2010 and the TOGS calibration. They all have "10" in their names.
In Fall 2010, we may be observing north or south of zenith or in "zenith strip" mode. You need to check the schedule to know what azimuth (and what configuration file) to choose. NEW!!
In Fall 2010, TOGS runs at the start of A2010 ONLY. Time is not allocated to run TOGS at the end of the night, so don't run it at the end unless there is extra time (a gap before the next program).
You need to start CIMA by typing "cima --X"
CIMA Version 3 sets up the IF/LO and backend parameters once the configuration file is loaded, so there are fewer steps involved in setting up than before (early 2008).
"Help" info is available by right clicking on any widget or parameter
The sources in your catalog which are "visible" are indicated along with their current location, slew time, etc.
It is possible to launch the system monitoring widgets from within CIMA.
"Accept" is the same as "Apply"+"Dismiss"
The scan number convention is "ydddNNNNN.fits" where "y" is the year number, "ddd" is the day number within the year and "NNNNN" is a sequential number which now has nothing to do with the time. Note also it has nothing to do with the FITS file number.

This is a short checklist of the things to do when observing... for more details see the observing cookbook.
Remote observers, see remote observing checklist .
In case of observational problems, see observational troubleshooting list.
And, it is always a good idea to check the recent log files or ask recent observers about their experiences.

Startup:

Ask the telescope operator to move to the azimuth and approximate zenith angle of the drift you're doing. But... be sure the operator gives you back telescope control! Alternatively, go to the "Pointing Control" window and point the telescope to the first position; just be sure the telescope goes to the proper azimuth. Usually the best approach is to have the telescope operator send the telescope to the approx AZ, ZA before (tell him/her) he/she starts up GALSPECT. If so, don't start CIMA until the telescope is close to position (once you start CIMA, the telescope motion will halt until you start the TOGS command file.)
Check the TOGS setting: (Note: these instructions apply to the period when the ZA is restricted in Aug-Sep 2010).
The TOGS calibration script contained in command_galfasrc_aug10.cmd now sends the telescope to an azimuth and zenith angle and then tracks that position for 5-6 minutes. The TOGS team is supposed to keep this file updated. All you should need to do is check that the file galfa_togs.cat is set up so that the line containing galfasrc has entered a value of the azimuth (the number entered immediately after "galfasrc") close to the one planned for A2010. If it doesn't, skip TOGS or edit the file yourself to fix it.
LET THE OPERATOR DO THIS STEP! On the dataview machine do the following to start GALSPECT:
- Login to dataview using the a2010 account. Switch to the guest account via ssh -l guest dataview. You must do this as guest.
- In the same xterm window ssh to the galfa1 machines. ssh -i galfa_key galfa@galfa1. You should see a '#' prompt.
- Check if ghost galspect processes are running by typing ps. If processes called gdiag are present, kill them by typing the command kill followed by the process number.
- Warm up GALSPECT via typing /var/diag
- Type the command: /var/levels_togs. If you get the message LO2: Set failed, got back: ERROR setting freq, then you need to start the gpib on the wapp server. To do this, start CIMA and click Restart GPIB under the Utilities menu. Go back to the xterm logged into galfa1 and again type /var/levels_togs. You should not receive an error.
- Enter the command /var/togs. This will run for the rest of the night, so minimize the windows.
  Note: if the operator is not able to get GALSPECT to run, he/she should call the TOGS contact for the night.
Log into OBSERVER2: dtusr (once the previous observer is out). Password is taped to computer.
Start CIMA on-line GUI when telescope is close to start position. At the moment, you need to type cima --X in an available window or right click on the screen background and choose CIMA Online GUI. Select the desired version of CIMA; this is currently "The 'smart' version of CIMA (3.1.08 2010-02-01 17:44 "Smart")".
- Project Number: a2010
- Observer: your name
- select Line and Accept.
Receiver selection menu
- Choose Receiver: ALFA and "Accept". Note: "Quick Tsys" should be "no"; "rotate receiver" and "retrack source" should be "yes".
- Hit Accept
- Close window
Main menu / Utilities / Utilities
- Restart the WAPPs
- Close when output to log window complete.
Command File Observing (TOGS) Menu
- Click Load - to open a menu listing available command files.
- Select the file 'command_galfasrc_aug10.cmd' (scroll down) and then click Accept.
- When the operator has given the OK that TOGS is running, check and, if necesary, adjust starting RA on galfasrc entry in a2010.cat.
- Click Run to run the command file. The telescope will slew to requested position and, when it reaches the meridian, TOGS calibration will run for ~7 minutes.
- As soon as "observing menu" appears it can be used to verify settings and then closed. The "command file" window cannot be closed until the run file is finished, at which point click Close . and then continue with Load Configuration menu (below)
- For for any reason the command file hangs, restart it; make sure that you restart from First line by clicking appropriate button at middle left on Command Log GUI.
- Note: if the GALSPECT spectrometer is not set up within ten minutes of their allotted time (so that the ~7 mins of calibration cannot be run before A2010 is scheduled to start), do not run the TOGS calibration if the A2010 prime map LST range is reached. But, even if you don't run it at the beginning, run the TOGS calibration at the end, if there is time and GALSPECT is running.
Main menu / Utilities / Utilities
- Restart the WAPPs again. Favorite A2010 saying: "When in doubt, restart the WAPPs." Another one is, of course, "Boring is good."
- Close when output to log window complete.
Main menu / Utilities / Load configuration
- Scroll down to select the appropriate configuration file. In Fall 2010, this could be either a2010_az180_2010.conf or a2010_az360_2010.conf. Check the schedule to be sure you know what drift you are observing and which file to use. After selecting the proper configuration file, be sure to check that the parameters look correct.
- Click Load and Apply when ready.
  Note: If this works, you will not need to load the IF/LO configuration or adjust the Backend Control (next two steps below).
Receiver IF/LO selection menu Note: Not needed if you loaded the configuration!
- Check receiver ALFA
- Check ALFA filter choice: Full width
- Check IF/LO path: ALFA
- Check center frequency: 1385.0 MHz (when topocentric observing)
- Check backend: WAPP
- Check bandwidths: 100 MHz
- Click Accept Check that the correct ALFA center frequency (1385 MHz), range (1335-1435 MHZ) and 4 IF band setups (100 MHz) are ok on the upper display screen to right of observer2 computer or in CIMA log window.
- Watch CIMA log window to make sure IF/LO params are set before moving on, then Dismiss both IF/LO windows
Backend Control Menu Note: Not needed if you loaded the configuration, but always needed if you restart the WAPPs!
- This opens the Configure Wapp ALFA window. Check that all WAPPs are using 2 channels and 3 levels and at 100MHz.
- Accept this configuration.
CIMA observing menu (should pop open when configuration file loaded)
- Set the azimuth position to the exact value (DD.DD) for this observation. Notice the possible configuration of Az+360 according to wrap. The telescope will chose the closer one, so you should not need to worry about this (we think....).
- Set the ALFA rot angle to the exact value (DD.D) for this observation.
- Quickly check the basic setup for fixed azimuth observing. Correct values:
  - The observing mode is Fixed azimuth drift map
  - Number of loops is set to cover length of run. Easiest to leave it at the default 99.
  - Strip time is 600 secs.
  - Drift type is Follow Dec J2000
  - Calibration type is Hcorcal
  - Calibration time is 1 sec
  - Calibrate when is On @ loopend
  - Add extra cal is No
  - Adjust power is First loop only
  - Loops per file is 1 loop

OK, now it is time to pick your drift, make final adjustments and begin observing.

Beginning Observations:

CIMA observing menu: The observing widget should still be open since you didn't close the resulting window after completing the Load Configuration. This is the window you'll be using most of the night. Note it also has buttons that allow you to "adjust power", but you should only do that if you stop/start data taking.
- Click on the start position button and select the proper drift from the a2010.cat for tonight's observation.
- Check the RA is set ahead enough for the starting RA (including the offset from LST). Enter the correct value (if it is not already ok). Review the "status" display to be sure the ZA is what you expect it to be. Adjust RA otherwise. Check that the declinationis correct, and click use now and then click accept.
- Click Adjust power Wait until output in log window confirms power adjustment. Once observations have started, check that the power numbers in the Observer's Monitor (alfaobswin) to make sure OK (the numbers should be between 0.8 and 1.2)
- Click Observe to begin the observation. Hopefully only a small countdown will remain, and the photon collecting will begin.

When Observing:

As soon as you start observe, run some immediate quick checks. It is especially important that you do this in Spring 2010 to be sure that the position and ALFA rotation angle are correct.
- Check that the telescope is actually at the correct declination
  1. Check the declination displayed in the CIMA observation status window
  2: Check the "Rslt" line in the monpnt window (the upper right window on the screen below the frequency band monitor). Dec value should stay within a few arcseconds of the drift value.
- Check that the ALFA rotation angle is properly set. Click on telescope in the CIMA observation status window and check the number to the right of "ALFA" in the bottom right hand corner of the display.
- Check the power levels and waterfall plots as usual.
Keep a log file - it is very important to keep an accurate log of what happens, even to note "an uneventful night". To do so:
- ssh to another machine as a2010
- open a new file logYYMMDD in /share/obs4/usr/a2010 using you favorite text editor (vi or pico work well when remote observing; emacs is too slow, unless you use the '-nw' flag to open in a terminal.) Use a posted log file as the template.
- record **anything** of note, especially
  (1) the CIMA version number and the saved state (a2010_az360.gui or a2010_az180.gui)
  (2) any bad files,
  (3) any power adjustments,
  (4) unusual rfi etc. (see observational troubleshooting list to check for notes about specific RFI frequencies.)
  To quote Brian: I cannot stress the importance of keeping accurate logs. While the file conversion software works automatically, it is good to have a backup to check against when comparing scan numbers. Sometimes CIMA squeezes in extra scans at the beginning or end of the run, or has some other unpredictable behavior. It is also important to note "empty" files, as IDL will hiccup on these. The folks who calibrate/process the drifts you take will thank you for your carefully note-taking (and will be entirely justified in saying unkind things about you otherwise).
Be vigilant for new sources of RFI; carefully check the waterfall plots and/or quicklook. Know the expected locations in the band of the "usual suspects". The FAA radar is usually at 1350 MHz (although they sometimes use 1330 MHz, out of our bandpass!). Strong RFI at 1367 and 1382 MHz is due to the Punta Salinas naval base radar, which should not be on during ALFALFA run (see this link.) . If you see this, ask the operator to call Punta Salinas immediately and tell them to turn off their equipment! See observational troubleshooting list for other observing issues.)

Between loops:
- Check power levels periodically. They should stay in the range (0.8,1.2) and be coded blue on the dataview observer's monitor. Note any odd power level variations in log. (Remote observers: be sure to note in log that you checked periodically.) Do not adjust the power levels during a run unless absolutely necessary; be sure to make a clear note in the log file if you do so; it is necessary to process separately drifts done before and after the adjustment, so make sure the processer can tell from the log file how to group the drift files.
- Keep track of the times, file numbers, scan numbers for drift and cal and any notes in the log file.
- Keep an eye on the declination on the monpnt window on the right hand console to make sure it is the same (within a few arcsec) of the desired J2000 declination.
File Integrity: Check the FITS files to make sure the coordinates are being written correctly. Use the IDL program quicklook.
- > cd /share/a2010/idl/eggidl.
- IDL> @wasinit2
- IDL> quicklook, 'filename'
  where 'filename' is the name of the fits file, with directory path. The directory path can be found in the log file, e.g., /share/wappdata/wapp.20061116.a2010.0011.fits
This is fast and is good to use while remote observing.
Or if you want to look at an arbitrary record, see the file "checkfitsnotes.txt" in the /share/obs4/usr/a2010 directory.
Data Monitoring:
- Use the widgets provided on the dataview computer or within the CIMA widgets (there are lots of monitoring tools; learn to use them!). When you are in the control room, you can start them from the pull-down menu on the dataview machine; be sure that the "CIMA version" is set to what you want. Alternatively, you can open the widgets by typing the following commands on an xterm:
  - alfamonwin & - same display as to the right of the operator's station
  - alfamotorwin &- shows ALFA rotation angle - good to check at start
  - alfabeamwin &- shows approximate positions of each beam; can set to RA,Dec (note: currently, the positions aren't quite perfect but still helpful.)
  - alfaobswin &- smaller window showing the power in dB for each beam
  - alfadatawin &- waterfall plots in your color of choice (select ALFA pattern, then waterfalls from the pull-down menu under diagrams). Too cool. Enough said.
  The latter two (alfadatawin and alfaobswin) are particularly useful in monitoring the data and should be left up in plain sight.
- Notice that you will not be able to start alfadatawin if the process is already running on dataview (started by one of the previous observers). If this happens, ask the telescope operator to kill the previous process or, if he cannot, to contact Mikael, Arun, or Phil to do so.
If there is a power failure... There is a remote "reset" switch for ALFA - it is no longer necessary to go up to the dome and push the reset button.

If the WAPPs get confused...which WILL happen:

The only sign of this happening in CIMA is that messages appear in red in the CIMA log window. WAPP error messages include: WAPPs confused indicates a hardware problem (Note the messages WAPP (3) WARNING - Counts don't match for chip 1 and WAPPDATA-queue_agcdata: WARNING received duplicate AGC-datablock are not WAPP errors.) Occasionally there is no warning message from CIMA, but the countdown time on the aostatus window stops, meaning that the WAPPs are no longer taking data. Sometimes the problems go away, so try to restart the WAPPs and then the observing again.

Procedure:
- Abort Observation in, e.g., the observing menu
- Restart the WAPPS under Utilities
- Repeat start up process
  - Load Configuration as before. Load and Apply
  - Reconfigure the WAPPS: Click on B Backend Control Menu, which opens the Configure Wapp ALFA window. Check that all WAPPs are using 2 channels and 3 levels and at 100MHz. Accept this configuration.
  - In the CIMA observing menu, select drift again and adjust starting time.
  - Adjust power and observe.
If this does not work, try again, up to a few times. If this still does not help, exit CIMA and start again. If the error messages keep appearing, it will be necessary to have the operator call an engineer to look into the problem. Currently, the WAPP experts are Giacomo Comes and Arun.

Finishing Up:

After a few seconds of integration time, abort the last unfinished scan.
If running TOGS: (Normally in Fall 2010, there is no time scheduled to run TOGS at the end so skip to next step unless there is a gap before the next program.)
- Under Utilities, Restart the WAPPs (note any error messages when you do this; if you get any, try restarting the WAPPs again)
- Go to Command File Observing, and click on Load . Choose 'command_galfacurpos_aug10.cmd", click accept , and run the script. TOGS calibration will take about 6 minutes, so be sure to allow for this before the next program is set to start. Note: should the telescope run into the ZA limit during TOGS calibration, just let it finish (or abort and give up). .
Exit CIMA normally
Exit the observer2 machine
Exit data monitoring programs "nicely"
Exit IDL (if you were using it)
CTRL-C out of the GALSPECT control and logout of galfa1 (Let the operator do this!)
Exit out of the dataview machine

After observing...

See the list of tasks to do after each run.
Here is a shorter summary of commands that can be saved to the disk and edited for current date.

This page maintained by the members of the Cornell ExtraGalactic Group and their friends, the other members of the ALFALFA observing team
Last modified: Thu Sep 2 11:35:42 EDT 2010 by martha