SCHED can set observing frequencies for spectral line observations based on velocities provided in the source catalog and rest frequencies provided in a separate type of input. This option is invoked by specifying DOPPLER and can be turned off with NODOP (DOPCAL is an obsolete form that was too easy to confuse with “DO PCAL”). If DOPPLER is invoked, SCHED calculates the velocity of the center of the Earth with respect to the designated reference frame (VREF in the direction of the source at the time of the middle of the project. From this velocity, the source velocity from the source catalog, and the rest frequency, the required observing center frequency is calculated. The antennas need to know the LO settings so SCHED must know the bandwidth. The bandwidth will usually be obtained from the setup file. It may be provided for the scan with the BW parameter for some systems, unfortunately not including the new digital backends such as the RDBE on the VLBA.
The reference frames supported by SCHED are the “Local Standard of Rest” or LSR VREF=L, heliocentric VREF=H, and geocentric VREF=G.
Note that channels assigned to the same BBC will be given the same frequency as the first channel on that BBC, no matter what velocities etc are given for the other channels. This will be the case when there are upper/lower sideband pairs. Their frequencies cannot be set independently. Because of the different sidebands, they will, however, cover different velocity ranges.
The frequencies derived from the Doppler calculations have to be rounded off to a value that can be set on the available synthesizers. For the Mark III/IV and legacy VLBA systems, frequencies can be set to the nearest 10 kHz. For the RDBE with the DDC personality on the VLBA, usable frequencies are multiples of 15.625 kHz. Note that, if there is a mix of systems with 10 kHz and 15.625 kHz steps, one should round to 250 kHz because that is the lowest value common to both. Other systems are different — VSOP, for example, can only be set to the nearest 1 MHz. The RDBE with the PFB personality can only do frequencies in 32 MHz steps, and those have LO dependent offsets — it is probably best to avoid DOPPLER when using the PFB. The parameter DOPINCR can be used to control the rounding.
The Doppler calculations are for the center of the Earth for the middle of the project. This implies that the frequency for each source will be constant for the duration of the project. Experience over the years with spectral line VLBI has shown this to be the preferred observing mode since it minimizes the chances of mistakes at stations that do not have automatic frequency setting. The shifts of the resulting spectra of about a km per second that result from the rotation of the Earth can be removed in post-processing with the CVEL program in the NRAO spectral line software or with a task of the same name and with similar capability in AIPS.
The LO sum used when Doppler calculations are requested are calculated by either the radio definition (VDEF=R in the source catalog ) or the optical definition (VDEF=O or VDEF=Z). With the radio definition, the LO sum is calculated as RESTFREQ * (1 - v/c) - BW/2 where RESTFREQ is the line rest frequency from the line initialization input, c is the speed of light, and BW is the bandwidth (appropriately signed according to the sideband). With the optical definition, the LO sum is RESTFREQ / (1 + v/c) - BW/2. Typically velocities for radio spectral lines in galactic sources are given in the radio definition in the LSR frame. Extragalactic velocities, on the other hand, are typically in the optical definition in the heliocentric frame. The differences in the radio and optical definitions only matter at large (typically extragalactic) velocities.
SCHED will accept redshifts if VDEF=Z in place of velocities, but be very careful that you have adequate accuracy to calculate proper frequencies - the bandwidths are typically very much smaller than the observing frequency so the velocities must be accurate.
Internally, if Doppler calculation is requested, SCHED calculates the desired observing frequencies and puts them in the same array that would be used if FREQ were used. This will override any FREQ specifications in the main schedule and any frequency specifications in the setup files. The frequencies of baseband converters will then be set properly based on the FIRSTLO for the station. Please note that the setup files must still contain a complete, valid frequency specification. This is to allow validity checking and to allow SCHED to pick up default parameters from the frequency catalog. The frequency in the setup should be close enough to the desired observing frequency that only final tuning of the BBCs is needed to get the exact desired frequency. For the VLBA with its 500 MHz IFs, this is not a serious concern.
The number of channels desired is set with NCHAN in the setup file (NCHAN in the main schedule is an obsolete parameter and is not used.). To calculate a frequency, SCHED must have, for each channel, a bandwidth, a velocity from the source catalog, and a rest frequency from the line initialization input information. If a value is missing for any channel of any parameter, the value of that parameter for channel 1 will be used. This avoids the need, for example, of specifying lots of bandwidths when they are all the same.
For continuum sources mixed in with line sources, specify NODOP for that scan to avoid the Doppler calculations.
Often it is desired to observe a continuum source at the same frequency as a line source for bandpass calibration. This can be done by specifying the line source with DOPSRC in the continuum source’s scan. The DOPSRC will be used for the Doppler calculation.
The important parameters in the SCHED keyin file for Doppler frequency calculation are listed below. Detailed descriptions are given with the descriptions of other SCHED parameters.
DOPPLER and NODOP turn the Doppler calculations on and off.
DOPSRC is used to specify the source, if it is different from the scan source, for which the Doppler calculations should be made. This is useful for bandpass calibration. Warning - as with nearly all SCHED variables, it defaults to the previous scan. After using it, be sure to set it to blank or to the next source.
DOPINCR is used to determine the level of rounding of frequencies that is used.
LINENAME specifies which group of rest frequencies to use. It must match one of the sets of lines named with LINESET in the LINEINIT input.
BW sets the bandwidth for the scan and overrides the setup file value. This was useful for switching between wideband observations on calibrators and narrow band observations on line sources. The value in the setup file will be used if it is not specified. In general, it is a good idea to use a new setup file when changing bandwidths because quite a few other parameters also change. With the new digital back ends, oversampling is now allowed so BW basically doesn’t work.
LINEINIT indicates that after the next “/”, information on the rest frequencies of spectral lines will be given. If invoked, the rest frequencies will be read, and SCHED will return to reading input for the same scan that it was on before the “/”.
The rest frequencies are specified in separate keyin inputs in the SCHED keyin file following a “/” if LINEINIT was specified. There can be one rest frequency per channel, although any not specified default to the first which is often the desired behavior. There should be one velocity per channel in the source file for each source to be observed (other than continuum calibrators). Each group of lines has a name which is then referred to using LINENAME in the scan input. The group can change with each scan, but be careful to change the setup file, too, if necessary. Up to 10 groups of lines are allowed. The parameters in the LINEINIT group are:
Argument: Name of up to 8 characters.
Options: Any name.
Default: None
Usage: Defaults to previous value - don’t do it!
Example: LINESET=’H2O’
Argument: Up to one real number per channel. The first value will be used for any channels for which a value is not given.
Options: Any value.
Default: 0
Usage: Defaults to previous value.
Example: RESTFREQ=22235.08
Argument: None.
Options: None.
Default: Not specified.
Usage: Defaults to previous value, but this has no effect since this will be the last line of the rest frequency input to be read.
Example: ENDLINES /
A fairly extensive list of possible rest frequencies is given below. These frequencies are not guaranteed. If anyone finds an error, please notify Craig Walker (cwalkernrao.edu).
The example below shows the SCHED input for a spectral line It is a modified version of the file used for a project by Phil Diamond in Dec 95. The modifications are to adjust for some of the new features of SCHED that were not available at the time the file was used. Note that it is not necessary to repeat the DUR and GAP specification every scan. However some users prefer to show these details and it certainly doesn’t hurt. Also, the bandwidth specification is the same as the setup file so it is not required (it used to be).