Legacy/Manual Spectral Line Setup

Creating a spectral line resource is similar to creating wide band resources as outlined in the previous section, except for the more advanced specification of the subbands and subband frequency tuning and possible Doppler setting of the frequencies.  Eventually, resources with the requested correlator settings will be pre-filled from information submitted to the PST during the observing time allocation procedure.  However, at this stage none of this has been implemented.

For how and when to use this observing mode, refer to the Spectral Line section of the VLA Observing Guide.

The NRAO Defaults resource catalog contains full polarization dual IF pair spectra-polarimetry resources (the wide band continuum resources). If they appeal to you, you can copy/paste them in a personal catalog just as for the wide band resources above and edit them as needed. Check the spectral line resource properties very carefully as the spectral line resources in the NRAO Defaults have a fixed sky frequency whereas you probably want to use a rest frequency in combination with Doppler setting.  Most likely, however, you will opt to create your own resource, just like creating a wide band resource previously.  Some items that need extra attention are described below, but first a small detour to outline the options for creating large numbers of narrow frequency channels.

Setting Up Spectral Line Resources

After generating a new resource within your project's catalog (or personal catalog), we will now guide you through the tabs of an 8/3-bit resource on how to setup a spectral line resource. For a more detailed guided tour of a spectral line setup, with screen captures, refer to the Multi-band, Multi-spectral Line, and Continuum Tutorial.


Name the resource, select a receiver band, enter the correlator integration time (refer to the OSS for the appropriate integration time per configuration), and add any comments for your personal use.


Specify the sky position for which your observations should be Doppler set; you can use the Import Source Position button to use a predefined source from one of your source catalogs in the SCT. If you have more than one source, you can specify an average velocity, a separate line for each source velocity or create a new resource per source. Do not specify a position if you are specifying an exact sky frequency for your lines.

  • In the Lines table, click on Add Line. A row with label L1 will appear. The next step is to specify the specifics of the subband that will cover this line.
  • Name your line and specify the line rest frequency, line-of-sight velocity at which the line should be observed and the rest frame and convention to be used in Doppler calculations. Furthermore, specify the minimum velocity range that should be covered. Note that a first order bandwidth for this range will be calculated using the line frequency and displayed below the input field. This will set the subband bandwidth to the next wider possible value. Try to keep the bandwidth for the range as narrow as possible for your science to maximize flexibility in placing the 128 MHz boundaries between your anticipated subbands; you can widen them later. In general pre-defining subbands wider than 32 MHz will often give problems in the initial placing of the subbands as the final baseband center frequencies are not well determined. Similarly the (maximum) channel separation input field will display the velocity width converted to frequency below the input field, and set the channel separation in the subband to the next possible narrower value. Finally choose the polarization products required for this line. By default the option to use Recirculation when possible (over Baseline Board Stacking) is switched on, and unchecking the box will consider Baseline Board Stacking only when configuring the subband for this line setting.
  • Build your list of lines by adding additional lines and repeating the previous step. You can copy the last line to duplicate the items and make your editing easier using the Copy Last Line button. If there is a specific frequency that you want to Doppler set on, but is not a line that you want to observe as such, e.g., a baseband center frequency, include it in this list. To remove an unwanted line click the delete icon (delete) to the right of the row that needs to be deleted.
  • Note the summary of the baseline board pairs (Bl.BPs) in the top table next to the baseband graph. Only 64 baseline board pairs can be used and this number will be updated in the following steps when generating and updating subbands.

For the high frequency bands (K, Ka, and Q) the default is to use 3-bit samplers covering 8 GHz bandwidth using four 2 GHz basebands, but you may select the 8-bit system to use two 1 GHz basebands. For all other bands the default is to use the 8-bit setup. If 3-bit selection is not possible, copy (and edit) a resource from the NRAO Defaults catalog. For 8-bit resources, ignore the message that there are no subbands defined.

  • For each baseband select the baseband center frequency if the defaults won't work for you. Remember that the exact baseband center itself cannot be observed as it falls on one of the 128 MHz boundaries. Try to place your lines as much as possible in the middle of the available basebands, or alternatively in as few basebands (i.e., one if possible) as long as your lines are not very close to the baseband edges and not close to the 128 MHz intervals within each baseband. If you plan on doing this, remember the restrictions: for 3-bit the baseband centers for A1/C1 and A2/C2 must be well within 2.5-3 GHz (same for B1/D1 and B2/D2) to pass through the 5 GHz down-converted frequency bandwidth at the antennas. In cases where AC and BD are spread over a large range (>4 GHz) usually AC needs to have the upper center frequencies and the maximum span of all frequencies in any band must be less than 12 GHz. Ka-band has extra restrictions (see below or the OSS).
  • You may turn on the Doppler setting at this step, or wait until all spectral lines have been generated within the basebands and then turn on the Doppler setting. 
Line Placement

The lines you specified earlier will appear in a summary table. For each of the lines you want to observe click on the Generate button, which will pop-up a dialog window for confirmation. This will generate a subband with a subband bandwidth which covers at least the velocity range requested, with enough baseline board pairs assigned (within the recirculation factor allowed). It aims to cover the bandwidth with spectral channels that are at least as narrow as the requested separation with the specified polarization characteristics. When created, the part of the baseband around the line will be shaded lighter to show the allocation in the baseband (though it may be too narrow to be distinguished). If a line can be observed with more than one baseband, there is the option to select the baseband. If you hit the Generate button more than once you will generate identical subbands without actually increasing the sensitivity for that line.


Every baseband tab will now show a table with the subbands that were generated during the Line Placement step which covers each individual line. The color assigned to a subband indicates which of the four correlator quadrant's baseline board pairs are assigned to it (in continuum typically 16 subbands have the same quadrant color) and currently for 8-bit setups you may generate up to 32 subbands in either baseband.  You have the freedom to modify the subband bandwidths, but note that each doubling of the bandwidth requires a doubling of the number of BlBPs or recirculation factor to retain the channel frequency width (the default behavior is to keep the number of baselineboard pairs and recirculation constant, doubling your channel separation with each doubling of the subband bandwidth). Changing the number of polarization products has a similar effect. If subband bandwidths of less than 128 MHz are used, enable Recirculation to reduce the use of the limited amount of BlBPs (see above).

  • The Snap to Grid and Fix to Baseband check-boxes are unchecked and/or checked by default, depending on the situation. Unchecking Snap to Grid allows for using more correlator resources to define a flatter bandpass filter and unchecking Fix to Baseband keeps the subband tuned if you decide to recenter the baseband respectively. For now, the best option is to keep them with the default at generation: both unchecked for line subbands and both checked for subbands intended as continuum. Note that these items are tools to figure out the best placement of the baseband center frequency for your lines and do not really do anything during the observations and will be ignored after the frequencies are defined.
  • Under every baseband tab (i.e., repeat this four or two times) you want to make sure you have enough continuum sensitivity (subband frequency coverage) to be able to calibrate your gains. You would want to include extra subbands you can use for this by clicking Add/Fill Subbands and placing them in a part of the observing band away from strong lines; whether they are your bright targets or RFI (for 8-bit samplers you may only generate 32 subbands). Each defined subband will fade a fraction of the color of the baseband in the graph on top so you can see whether they are avoiding your line. By default these subbands have the Snap to Grid and Fix to Baseband options reversed compared to the subbands containing your lines for flexibility.
  • If you are unhappy with any of the subbands you can delete individual subbands with the delete icon (delete) at the right hand side of the subband table. Multiple subbands can be selected and deleted with the Delete Selected Subbands button.
  • Subbands can be changed individually, or be selected and bulk-edited using Bulk Edit Selected Subbands. Note that editing is limited to the current baseband tab only; if you, e.g., want to change the polarization of the whole observation you have to repeat the editing in each of the baseband tabs. You can only enter the center frequency for subbands of 16 MHz and narrower, provided that they do not cross a 128 MHz boundary; wider subbands can only be selected from a fixed drop-down list.
  • You may limit the number of subbands (i.e., less than 64 total, 16 per baseband) in favor of more correlator products in another subband. The number of correlator products in a baseband is the number of spectral channels × the number of polarization products and each BlBP can produce 256 products. Doubling the number of BlBPs doubles the number of products at the cost of a subband per baseline board pair, but see above how to counter that with Recirculation. Keep an eye on the total number of BlBPs used in the top table (next to the graph); only 64 baseline boards are available. Also make sure that you do not exceed the maximum data rate (25 MB/s) for the sum of all subband resources.
  • If you want to start anew (using the already specified baseband centers), click Clear All Subbands to remove all subbands in all basebands, or delete the resource (or Group, Catalog) completely using the menu strip or icon menu.
  • Finally, double check the subbands: can they be merged, are they too close to a 128 MHz edge, are there left-over resources (BlBPs) to include more (e.g., continuum) subbands, to double the number of channels to increase the spectral resolution for one or more subbands, etc.?
      • When a subband is very close to a 128 MHz baseband edge (hover your mouse over the yellow triangle to see by how much), you may want to shift the baseband in question to a new center by returning to the Basebands tab; when doing so you should not have (any of) the generated subbands fixed to the baseband so they will not stay fixed close to the 128 MHz edge of the baseband (the default for Fix to Baseband).
      • Adding 128 MHz continuum bands and/or switching on Doppler setting should be done after the baseband center frequencies are determined.
      • Each doubling of the subband bandwidth (e.g., when merging subbands seems useful) requires a doubling of the number of allocated BlBPs to retain the channel width originally requested.
      • Changing the individual subbands invalidates the input given earlier; in principle no information stays correct when stepping backward but more lines can be added in the Lines tab and be generated in the following steps when baseband and subband centers were calculated previously.
      • If your science has the flexibility, assign some subbands a priority other than "Required". This will allow an SB with this resource to run on the telescope even if some of the hardware is inoperable or if one or more baseline boards cannot be configured at the cost of missing those subbands. The larger the number in the label, the less desired a subband is in case there are more choices that can be traded off. That is, the subband with the highest desired-number (64) will be left out first if such a need arises, the lowest (1) last, but Required subbands are never skipped.

(go back to)


You may need to go back to the Basebands tab to adjust the baseband center frequencies if a line(s) is too close to a subband boundary (within 6 MHz from the subband edge).

Once the baseband centers are set, typically after the subband step, select for each baseband the Doppler Line setting characteristics. That is, from the list of lines specified in the Lines tab define the line that will be used to calculate the Doppler shift of the entire baseband for the sky position entered in the Lines tab. Formally your Doppler frequency will be correct for only one line per baseband at the start of your observation, but in practice the differences between the lines in a baseband usually are small enough to correct for in post-processing. This Doppler setting "line" does not have to be observed as that line, but it needs to be specified as a line option (with velocity and definitions) in the Lines tab. For example, one can specify a pseudo-line which is the baseband center frequency, skip generating a subband for it (as it falls on a 128 MHz boundary), but select it as the Doppler setting frequency.


This allows you to inspect your setup in terms of frequencies and correlator resources (i.e., baseline board pair allocations). Check your resource, from top to bottom. If you create more than one resource, check each of the resource properties using the Show/Edit icon for each catalog entry.

Always double check your proposal to make sure your custom resource follows what you proposed to do.

After all this data entering, make sure you check your catalogs for correctness. It is important that your frequencies (with Doppler definitions) are correct before creating scans in the OPT, and before storing to disk or sharing your catalogs with your collaborators.

If there is a need to modify the existing resource, after generating a resource and attaching it to scans in an SB in the OPT, rename or copy it to a new name and make the modifications in the resource with the new name. This adjusted resource has to be re-attached to the scans in the SB, replacing the faulty resource. The easiest way to do this is with the Bulk Scan Edit tab on the selected SB. Having a different name for the two resources is extremely useful in checking whether the edit was successful and whether scans with the old resource have been overlooked.