ATLOD has a long list of adverbs, and I will discuss them all and in the order in which they list in AIPS. Note that if you have a large number of sources to load in one go (i.e. more than 400), please alert either myself or Henrietta May so that we can ensure that there is adequate internal storage in ATLOD for your needs.
DBCON can be used to combined multi-source files from the same observation. However, it has some problems with multi-source files, so please try to do this concatenation with ATLOD.
Note that data from different observing runs with different configurations should not be combined into one multi-source file with ATLOD. This is largely because baselines with the same number but from different configurations would become confused. In principle, the subarray capability of AIPS could be used to deal with this, but ATLOD does not currently take advantage of this. There are other practical problems too. Multi-configuration data can be combined after calibration with DBCON. This is discussed in § 14.
A further option, optype='sysc', is available to write three text files containing the on-line measurements of ancillary system calibration information. These text files can contain (see also cparm(9) the antenna-based XY phase differences (), the system temperatures and sampler statistics for the X and Y feeds of each antenna. These files are written into the /DATA/FITS data area. The only other selection adverbs that are active in this mode are freqsel, ifsel, sources and timer. You can use the program pltsys to plot the contents of these files. Just enter the command pltsys at the Unix prompt and answer the questions. This program has frequency discrimination, so you can use this option of ATLOD and select all frequencies when generating the text files rather than running ATLOD once for each frequency.
For example, to load (unflagged) channels 1 to 320, and 322 to 513, use chansel=1,320,1, 322,513,1.
This option would be useful if you are forced to use data compression (see below) and there is a channel with strong interference in it. The unselected channel is not used when scaling the visibilities into integers.
You may also find it useful to discard a group of channels at the beginning and end of the spectrum where the filter response is poor. In this way also, should you have chosen data compression, you can increase the potential dynamic range of the data, as the range of visibility amplitudes from the central portion of the band is likely to be smaller than the range from the entire band. This also helps with any disk space problems.
You should also consider discarding every second channel if you have invoked Hanning smoothing (see dparm(2)).
Setting ifmap=1 will cause ATLOD to map the on-line IF number to the AIPS IF axis location. For example, if you observed at 4400/4600, selected only frequency 4600, and set ifmap=-1 (default) then ATLOD would put this in IF axis location one. However, if you set ifmap=1, then ATLOD would put it on IF axis location 2, and zero fill location 1 (this would be wasteful of disk space of course).
Generally, I suggest that you set ifmap=-1.
Consider the case where you have an observation such as
IF chain 1 IF chain 2 Scan 1: 4700 8300 Scan 2: 4600 8000
Let us say you set, for some reason known only to yourself, freqsel=4700,4600,8000, thus omitting the 8300 frequency on IF chain 2. Now, you MUST set nif=2 to get all these frequencies loaded. ATLOD notes that you want one frequency from the first scan, and that it would go to IF axis location 1. But this is the only information it has when it reads the header for the first scan, which is when it must build the attributes for the output file. It doesn't know that the other specified frequencies are is succeeding scans and that they will need an IF axis of length 2. Thus, you must set nif=2. IF axis location 2 for the first scan will get filled with dummy visibilities of zeros.
Note, that if you set freqsel=8300,4600,8000 instead, and ifmap=-1, then the 8300 frequency would be put onto IF axis location 1. However, if ifmap=1 then it would go to location 2, and location 1 would be zero filled instead.
Generally, I suggest you set nif=0.
For continuum work you should set douvcomp=-1. For spectral-line work you must make your own decision.
Note that a full polarimetric calibration of ATCA data cannot be performed with AIPS; you must do this with MIRIAD (see the MIRIAD User's Guide).
Recall that raw ATCA correlations (visibilities) are in terms of linear polarizations, and that our ultimate goal is to convert them to the Stokes parameters, I, Q, U, and V which we can then image. A nominal conversion to Stokes parameters is achieved if you put aparm(1)=1.
This nominal Stokes conversion makes three assumptions (the need for such assumptions is obviated by a correct calibration in MIRIAD).
where is the error in the amplitude of the gain a (for the X and Y feeds, and i and j are the antennas involved in the interferometer). This is a first-order effect.
If you don't convert to Stokes parameters, then you must calibrate the XX and YY (remember 2I=XX+YY) polarizations separately under the assumption that your calibrators are not linearly polarized. Although this means the gains are wrong by amounts given by the linear polarization of the source, the errors cancel out on application to a target source (see § 3.3). So you are left only with uncalibrated second order leakage terms.
If you set (aparm(1)=-1), then no Stokes conversion is performed, but AIPS is tricked into believing that the linear polarizations are circular (you could also use PUTHEAD on the header to effect this trickery if you don't do it with ATLOD). It does not affect the actual calibration in any deleterious way. Leaving aparm(1)=0 means load the polarizations just as they are and label them as linear; I do not recommend doing this.
I suggest you set aparm(1)=-1, thus loading the correlations in their natural form, whilst labelling them as circular. You should use MIRIAD to make the best possible calibration, whether you are interested in Stokes I only or all Stokes parameters.
Generally I suggest you set aparm(2)=0.
ATCA data with 128 MHz bandwidth and one IF taken after February 1991 contain a full set of meaningful auto-correlations. 128 MHz bandwidth data from earlier periods do contain the XY correlations, but they are not labelled in an obvious fashion. Please consult with me should you wish to extract them from the older style data. Spectral line data do not contain auto-correlations, so aparm(3) is unimportant in this case. 128 MHz data with 2 IFs do not contain auto-correlations as there is not enough correlator to form them.
Generally I suggest you set aparm(3)=0.
Initial tests indicate that at 20 cm, cross-talk begins before geometric shadowing. At 6 cm, it appears to occur soon after the onset of geometric shadowing. I suggest you set aparm(4)=0 at 3 and 6 cm, and perhaps aparm(4)=25 at 13 and 20 cm if you are feeling conservative.
Generally I suggest you set aparm(5)=0 and aparm(6)=0.
Generally I suggest you set aparm(7)=0.
Set aparm(8) to the number of measurements that you wish to average (I would suggest 10 or so). If you leave aparm(8) at zero (or unity), then no additional scaling is done. If you set aparm(8)=-1 then the on-line correction is undone, and redone with an assumed of 50 K. This is equivalent to not turning on the on-line correction.
Because the improvement is small, and it slows ATLOD down, I suggest that in general you leave aparm(8)=0.
When this averaging option is active, wildly discrepant values are replaced by the running mean of the current stack of aparm(9) measurements. A point is considered discrepant if it is more than a few times the width of the current stack from the stack mean.
Because we do not recommend general application of the on-line values, and because we now prefer all application of to be in MIRIAD, I do not recommend that you use this option. Set aparm(9)=0.
We can detect discrepant values in two ways. First, if aparm(9)>1 then the current can be compared to the mean of the previous aparm(9) measurements. Second, if you are not using the on-line measurements of (as recommended) directly but have input mean values into the xyphase array then a can be noted as bad if it is discrepant from the value in the xyphase array by more than some value.
In the first case, you should have set aparm(9)>1 so that a stack of aparm(9) values can be accumulated for comparison with the current value. If aparm(10) >0 then visibilities associated with the antennas with the discrepant are dropped. If aparm(10)<0, then in addition to ATLOD's own internal criteria a point is not treated as discrepant unless it is abs(aparm(10)) degrees different from the running mean of the current stack of aparm(9) measurements. You need to inspect the values via the optype='sysc' and pltsys combination to be able to set this value meaningfully.
In the second case, you should have set aparm(9)=0. Then, if you set aparm(10) < 0, a will be deemed bad if it is more than abs(aparm(10)) degrees from the relevant value in the xyphase array. Visibilities associated with the bad antenna will then be dropped.
This is a useful editing option. However, because we do not usually recommend direct use of the on-line values, I suggest you only use it only if you input the mean values into the xyphase array and set aparm(10)<0 (and set cparm(4)=1 indicating use of the xyphase array).
Generally I suggest you set bparm=0.
If cparm(1)=1 then some of the system calibration group information is listed. You get the system temperatures, the values and the parallactic angle. You get the chance to stop the listing after a while (answer `Q' when prompted) and continue loading the data. Control is then returned to AIPS. This is meant for a quick inspection rather than an exhaustive listing. Use option optype= 'sysc' and examine the output text files for more extensive examination.
If cparm(1)=2, then you are informed when ATLOD detects that the values or the system temperatures have jumped. By this, I mean jumped to a new value and stayed there, not just a dropout. ATLOD accumulates its averages for the for each frequency, and the system temperatures for each frequency and source. It resets its accumulations if one of these accumulations jumps unexpectedly. This option is active only if aparm(8) or aparm(9) is greater than 1.
If cparm(1)=3, both the previous two options above are active.
Generally I suggest you set cparm(1)=0.
Generally I suggest you set cparm(3)=0.
I suggest you only do this if you wish to use the editing option (see aparm(10)).
First, it causes the XX and YY visibilities to be in phase. Thus, you could ask an AIPS task to form Stokes I by summing XX and YY before calibration. This would allow you to edit on only one quantity, instead of doing it for XX and YY separately. However, generally the correct observing setup done on-line will ensure that XX and YY are already roughly in phase anyway.
The second reason is now deprecated. We used to recommend that for those of you who were going to calibrate in MIRIAD that you apply the values in ATLOD. However, our preferred path now is to do this in MIRIAD.
I suggest you set cparm(5)=0.
If you choose the option to correct the visibilities when the sampler statistics are wrong, then this works only for small errors (), and data with larger errors in the statistics are dropped.
Note that since the sampler statistics are antenna based, all visibilities involving the bad antenna are dropped.
It has been noted in some data prior to March 1992 that the sampler statistics were not getting updated every integration. This means that the off-line correction would make the wrong correction for some visibilities. To assess whether you have this problem or not, you should use the optype='sysc' option with cparm(9)=2 or 3 (see below) to create text files containing the sampler statistics which you can then plot with utility program pltsys. Look for successively duplicated entries.
For data prior to March 1992, I suggest you set cparm(6)=1 (just providing you with warnings). For more recent data taken up until 11 December 1993, I suggest you put cparm(6)=4 and correct the data. For data taken since then, the corrections are done in the correlator. ATLOD will refuse to correct such data.
Generally I suggest you set cparm(7)=0.
Generally I suggest you set cparm(8)=0.
Generally I suggest you set cparm(9)=0 unless you are interested in the samplers.
Generally, I suggest you set cparm(10)=0.
This adverb is offered for you to enter one number per antenna and frequency for the values that you choose from the pltsys plots if you require them. We no longer recommend application of in ATLOD.
However, the editing option (see aparm(10)) is still useful, and this is the only case now for which you should enter values into this array.
You must enter one phase difference (in degrees) for each of the six antennas in the array, regardless of how many antennas were in your observation. Naturally, the values that you insert for antennas that you do not have are arbitrary. If you have observed at more than one frequency (e.g., 3 and 6 cm), then you must enter these values for all frequencies. First, you enter the six numbers for the first frequency observed, and then the six numbers for the second frequency observed, and so on. They must be in the correct frequency order as encountered and loaded in the observation. You could check this by listing a bit of your data (optype='list') and seeing what order the frequencies arrive in.
Except for editing, I suggest you set xyphase=0.
Generally, I suggest you set dparm(1)=0.
Of course, at 128 MHz bandwidth, adjacent channels are already correlated so this option is only meant for spectral-line data.
For 128 MHz bandwidth data you should set dparm(2)= 0. For narrower bandwidths, this option should be considered.
The integration time that ATLOD now has access to includes times losses such as the on-line hold and blank times and also reflects any averaging done in the correlator. Therefore it should accurately reflect the on-source time for each integration.
The division by 15 is for two reasons. Firstly, the task AVSPC (see § 6) that averages channels together sets the weight of the averaged channel to the sum of the weights. This means that the weights may get very large and PRTUV which lists the weights (as well as the data) will overflow the weights field. Secondly, most ATCA data taken to this date have an integration of around 15 seconds (usually somewhat larger for spectral-line data). If you concatenate old unity weight data with new data via DBCON you should rescale the weights of one of the data sets accordingly (see 14). If you forget to do this, this normalization will minimize the damage (or possibly obscure it !).
Generally, I suggest dparm(3)=0.