ALFALFA Survey - Setup and Observing Cookbook     28Sep2004
Disclaimer: CIMA is changing; this works today but may not
tomorrow! Note that there are some redundancies in the current version and some features
are not yet implemented. This and CIMA are works in progress.
Before Observing
- The ALFA cover must have been removed. ALFA is covered during radar runs, so take a look at the telescope schedule beforehand. For instance, if it looks like ALFA had to be covered the day before your observations, make sure that time is allocated to remove the cover before your run starts (this can be done during maintenance or system check time). In any case, it is a good idea to double check with the telescope operator.
- The motor must be switched on (this is also done on the platform!). If the power have failed on the platform, the "reset button" on the motor may have to be pushed; if someone switches the motor on, he/she probably should hit the reset button too, before coming down, just in case. If you have any doubts, look for ALFA rotation using the dome video monitors (you should be able to see it move). Also, the operator may need to turn on ALFA in software from the control room. (Someday, all this will be automated.)
Datataking
- Log into OBSERVER2 as "dtusr" (password taped to the monitor).
- Start CIMA by clicking with the right button of the mouse on the background, and choosing
"cima online GUI" from the menu. Several windows will pop up:
Identify New User (orange),
AO Observer Display (black),
CIMA Observer's Interface (orange), and a couple of others (white background,
with red or blue writing) that you will not use. CIMA Observer's Interface
is the main window and should always be open. The buttons therein open new windows, which allow you
to control the telescope. These windows will be indicated with orange fonts
in this document; all the other ones will be red.
- Identify New User
- Observer(s). This entry is placed in the FITS header for each record.
It is also used in the return address in case, during your observations, you decide to email
the RFI or CIMA groups with a comment (using the E-mail Comment button).
- Proposal Number. This is important. Your settings and log files will be saved (if you decide to do so)
in the corresponding project directory, which for us is /share/obs4/usr/a1946/.
- Select "Line" observing mode.
- Choose Receiver
Select "ALFA", click on "Select Receiver Now", and make sure that ALFA shows up in the AOSTATUS
monitor (on your top-left side). Dismiss the Choose Receiver window.
- Choose "Load/Save State" from the CIMA Observer's Interface and select your setup file. Note that
"a1946AsyncCal.gui" is a basic setup for cals fired at regular intervals throughout each scan and "a1946CalEnd.gui" is a basic
setup for cals fired only at the end of each scan. The current files to use are "Asyncal_am.gui" and "Asyncal_pm.gui". This will
set most of the parameters, but you must still apply the configuration in each of the widgets described below.
- Pointing Control
- For the a1946 project, the telescope is fixed at AZ=180. Point the telescope near where
you will start observing by entering the dec of the strip you will do and the current lst as the RA, and point the
telescope. Note that the telescope won't move until the receiver floor has
finished rotating.
- Enter the "ALFA Rotation Angle" and hit "Send". You can actually see if ALFA is rotating by looking
at the TV camera in the control room (ask the telescope operator to show the appropriate camera).
The blue number next to the "Send" button should change to your entry once ALFA reaches that position.
For drifts at 180 deg azimuth, the correct angle is thought to be 19 deg.
At azimuth 90 deg, it is thought to be -14 deg.
- If, on the other hand, you have a source list, you can load it using the "Catalog" button (on the top left).
You can also type the coordinates of the source (RA and Dec); if you do so, select also the correct
epoch (B1950 or J2000).
- Receiver IF/LO Control
- Select "New Improved IFLO Setup". This will open the New Improved IFLO Control
window.
- New Improved IFLO Control
- Both "Choose Receiver" and "IFLO Path" should be set to ALFA. Note that this is another place where
you can select the receiver (several functions are redundant).
- Check that the central frequency is 1385 MHz, and that the bandwidth is 100 MHz.
- Hit "Apply This Setup".
- Dismiss Receiver IF/LO Control and
New Improved IFLO Control windows.
- Backend Control
- "WAPP as Spectral Line Machine" should be selected (default).
- Check that all four WAPPs are enabled (green) and click on the corresponding square if any are not.
- Hit the "ALFA Backend Control" button. This will open the WAPP ALFA window.
- WAPP ALFA
- Check that the configuration is "2chan, 3-level auto." If not,
choose it from the pull-down menu (click on the displayed configuration
[in red] with the left
button of the mouse).
- Choose a Cal (for a1946, it should be hcal). The number of seconds for its duration is only relevant if you
choose to test the cal by pressing the "Start Cal" button..
- Check that the integration time (i.e., how often the data are written to file) is 1 sec.
- Hit "Configure WAPP ALFA" to apply your setup.
- Adjust power, and look at the numbers on the Backend Control window:
1+/- 0.2 is ok. If the numbers are zeros (or close to zeros), trying redoing the startup sequence:
This appears to depend on the order in which you do things. If that doesn't work, probably
the ALFA amplifiers have
not been turned on. If this is the case, you can ask the telescope operator to turn them on
for you, or you can do it yourself by typing "/home/aoui/bin/alfaon" on an xterm (FYI:
"/home/aoui/bin/alfasafe" turns the ALFA amplifiers off).
If the power is now back, but the numbers look wrong, try adjusting the power a few times.
- The bottom part of the window is the "Monitor Control". Do not worry about it (it is meant to
display the signal from one beam and one polarization at a time on the monitors sitting on the
top shelf of the wall to your right, in the control room). Just make sure that the control
is set to "Remote" and not to "Local".
- Spectral Line Observing
- Choose your observing mode from the "Mode" pull-down menu.
For most a1946 observations, use the "Fixed Azimuth Drift" mode.
In this mode, the name of the drift and the starting RA are taken from
the Pointing Control window.
- Make sure that the starting RA is sufficiently later than current LST so
that the telescope can be in position before that RA drifts into the beam.
Hit "Observe" and make sure that the slew time is less than the wait time displayed
in the AO Observer Display.
If not, hit "Abort" and set a slightly later RA.
- After the scan starts, type in the name, RA and Dec of
the start of the next drift in the Pointing Control window and its duration in the Spectral Line Observing window, as long as you do not hit "Point" nor "Observe"
until the current scan has finished.
- It is possible to write a new fits file automatically at the end of every scan (so you don't have to
hit "new fits file" at all anymore); a large number of loops
are therefore requested. Stop the observing at the end of the run by hitting abort after the desired number of scans.
Wait until the gui says that a new fits file has been written to hit abort. One junk fits file is
therefore created at the end of each run.
- The power levels do not update in the Backend Control widget after you hit "Observe"!
Be sure to check Mikael's data monitoring window periodically to look for power dips.
- Open and update the log file each time a new fits file is written. The file should be in /share/obs4/usr/a1946/   ;
if it's not there, make one.
- Exit normally
- When you are done, make sure that a new fits file has been written, and then select
Exit normally to exit CIMA. There is no
need to hit the "Move Data" button on the Spectral Line Observing
window if you were using the WAPP correlator.
Notes
- You can save your entire setup, or parts of it, by opening the Load/Save State
window, and selecting the configurations that you want to save. When you are done, hit "Save Selected
Choices". Enter a file name (for instance: a1946_fixAZ), and a descriptive comment (e.g., ALFALFA
fixed AZ drift standard mode). A file a1946_fixAZ.gui will be written to your project directory
(/share/obs4/usr/a1946/). The next time that you observe you will be able to recover your saved setup
by opening the Load/Save State window, and selecting "Load a Saved State".
However, loading does not mean applying! You will have to open the windows mentioned above
and apply the corresponding setups.
- Is WAPPDATA confused? On a few occasions, after hitting "Observe" to start the integration, we had a series
of warnings (on the AO Observer Display window): "WAPPDATA is confused".
If this happens, open the User Preferences window, and type
"socksend WAPPDATA FLUSH" on the "Send to GUI" line. Hit the "Send to GUI" button.
If the "WAPPDATA is confused" state persists, exit CIMA and start again,
this time choosing "Pulsar Observing" in the CIMA Observer's Interface.
Click on the "More" button, then on "Restart all WAPPs."
- There is a limit to the size of the FITS file (2 GB or so). It is a good idea to write the data (e.g.,
different drift scans) to separate FITS files; this can be now be done automatically by setting
"New FITS (each loop)" in the Spectral Line Observing widget.
If you don't, and the data exceeds the limiting size,
another FITS will be created (you will get the message "FITS file is full, creating new"
on the AO Observer Display window). This can happen in the middle of a
scan, leaving that scan incomplete and corrupting the new FITS file, so it is essential to avoid it.
- If you abort a scan during the night with the "Abort" command in the Spectral Line Observing widget, be sure to start a new fits file before observing again; if you don't, the two scans (the one you aborted and the new one) will be in the same fits file, complicating the data reduction.
Data Monitoring
Mikael is working on a package for telescope monitoring and data display. Most of the features are
already available. These programs read the data that are being broadcasted to the FITS files, and not
the FITS files themselves. The screens are updated every 10 seconds.
On Dataview, click on the background and select from the menu:
- Quicklook Data Display -- launches the ALFA on-line display.
- Observers Monitor -- opens a widget that currently only gives the power levels.
- Array Rotation -- launches the ALFA motor control.
- Frontend Monitor -- launches the ALFA instrument monitor.
You can open the same widgets by typing on an xterm:
- /home/aoui/alfa/alfadatawin &
- /home/aoui/alfa/alfaobswin &
- /home/aoui/alfa/alfamotorwin &
- /home/aoui/alfa/alfamonwin &
The program alfadatawin is currently only available on Linux machines. The other commands are available
on other machines, too.
Notes
- If you are using the Dataview machine, with its two screens, in the control room, you can
control the display device by setting the DISPLAY environment before you launch the above.
- > setenv DISPLAY :0.1       send display to 2nd screen
- > setenv DISPLAY :0.0       sets display back to primary screen
- > setenv DISPLAY fusion01:0.0       sets display to remote screen
- In particular, use these displays to monitor the power levels. Notice that after hitting
"Observe" the CIMA monitor WAPP power levels do not update, whereas the monitoring windows
show the current levels.
- If you reset the WAPPs, you will have to exit and restart alfadatawin to get it to grab
the online data again.
- To log out of dataview at the end of the observing run, close the windows "politely" by hitting
exit in each display window before logging out. This will make sure that the processes terminate.
Reading Data into IDL
Once a fits file has been written and closed, it can be converted into a set of IDL structures for future use; see Brian's tutorial for details. You can do this at the telescope on dataview machine. Below, IDL> means "inside idl".
- Start up IDL in /share/a1946/data/{run_directory}. Make sure that you are on a fast machine (fusion01, fusion02, aolc1,2,3,4).
- IDL>@wasinit2         (if this doesn't work, check that your idl account is set up properly)
- IDL> .comp ../../idl/alfalist         (compile Brian's programs)
- IDL> .comp ../../idl/filecreator     note: compile akb_filecreator instead to read new fits files... 28sep04
- IDL> .comp ../../idl/headersorter
- IDL> .comp ../../idl/structsort
- IDL>filein='/share/pserverf.sda3/wappdata/{fits filename}'
- IDL>print,wasopen(filein,desc)
- IDL>filecreator, desc     note: do akb_filecreator,desc instead to read new fits files... 28sep04
Note that each 900-sec scan take 5-6mins to be read into IDL.
After Observing
After the run has finished, do the following things to keep the rest of the a1946 group informed about how the run is going.
- Copy the log file from /share/obs4/usr/a1946/log04****** to /share/a1946-2/obslogs/log04******.txt (make sure to make this
file writable for everyone!).
- Modify the alfalfa files obslog.htm and fitsfiles.htm. You need to be able to log in
as galaxy on astrosun to do this; if you are not a Cornell EGG, ask someone who is to do this for you. The files are in /home/astrosun/galaxy/public_html. You will want to upload log04******.txt to the logs/ file therein too.
- If you'd like, you can modify the gui files for the next night ahead of time; they are in /share/obs4/usr/a1946/. Note that the order in which the
drifts in tile 26 (for project a1946) should be completed are in the file /share/a1946-2/obslogs_am.txt  .
Useful Links
Page created and maintained by Barbara Catinella and the members of the
Cornell ExtraGalactic Group
Last modified: Wed Sept 28 2004 by ks