Facilities > VLA > Documentation > Manuals > OPT > Using the Observation Preparation Tool (OPT) > Modifying a Scheduling Block and Editing Multiple Scans

Modifying a Scheduling Block and Editing Multiple Scans

by Gustaaf Van Moorsel last modified Jan 19, 2017 by Lorant Sjouwerman

The schedule created may not be your most preferred schedule, both in the details of each scan and in the order of the scans. If you desire to rename a scan or a scan loop (or a SB or a PB), at any time select the scan and edit the name or time interval, or reselect a (re)source.

Figure 4.6: Web browser screen shots of the SB scan listing page, scrolling further down to the bottom.

By using the menu strip or the icon menu it is possible to delete, cut/paste and add any number of individual scans (or scan loops) to any position in the tree at any time. Some handy icons are the arrows that move a selected scan (or loop) up or down in the current tree (i.e., keeping loops intact as loops), and in or out of a scan loop. Currently still fragile, but useful, is to click the leftmost arrow (pointing to the "northeast": ) which allows to click multiple scans for copying or deleting. Always verify that the scan you moved ended up in the expected location. There seems to be issues with this feature if you are working deeper down in the left hand side column, i.e. in loops and loops of loops.

Bulk Scan Edit

It is not uncommon that an error is made in the resource, that one forgot to tick the apply reference pointing solution, or that one opts to use a different calibrator, etc. Note that for any (re)source definition change, e.g., a frequency, velocity or position, the new information has to be reattached to the SB. That is, changes made in the SCT and RCT do not propagate to existing scans in the OPT! For a simple scheduling block like the one shown above, a few clicks will allow to change individual scans quite easily. However, when a complicated schedule or many individual scan are affected, editing each and every scan is hard to do without making any mistakes during the process.

If one uploaded the SB or scans with a text file, the easiest may be to edit the original file and upload that again, especially if that file is kept as a template or for future reference. Otherwise, one may use the Bulk Scan Edit tab of the SB to specify the parameters to change and the parameters to replace these with.

As example below, consider the SB above where the K-band 8-bit line resource will be replaced by the K-band continuum resource. The steps to take are:

  • Navigate to the Bulk Scan Edit tab to be presented with a filtering page. Tick the checkbox in front of Resource and select, from the resources found in the SB, the resource that should be replaced (i.e., for the example here, K-band 8-bit).

  • Click the Select button at the top or at the bottom of the page.
  • In the replacement page that appears, tick the checkbox in front of Resource again. Now select, from the resources found in your RCT, the resource that should be used instead (i.e., K-band).

  • Click the Update button at the top or at the bottom of the page. The table will show the scans that matched the filter, the scans that had the original resource specified (note that it does not select scans with "Keep Previous Conf."), with the filter matches highlighted in yellow. In this particular case there are three such scans, the rest is using "Keep Previous Conf.".

  • If there are any changes you want from a "change all", uncheck the checkbox in the first column, in front of the scan name, that you do not want modified.
  • Click the Confirm button at the top or at the bottom of the page. The affected scans will briefly light up in the SB tree to show that the replacement has been executed.
  • Check one or more individual scans, and the information in the Reports page, that the changes have taken place. Note that it is much easier to spot if the new (re)source has a different name from before the change. Also, the new SB has to be validated again for, e.g., data rate and other properties that may have changed due to this Bulk Scan Edit.