Page Layout of the Tools in the OPT
The front page of the Observation Preparation Tool (OPT) is is the page shown directly after redirection by the NRAO user database. The front page shown after navigating to the SCT or RCT is very similar. The web browser window is set up in four main panels (Figure 1.3):
- The menu and navigation strips at the top
- The interface feedback strip at the bottom
- The left hand side column; in the OPT it contains a collection of projects, in the SCT it contains a source search section on top and a collection of source catalogs below it, and in the RCT it contains a collection of resource catalogs (hardware/instrument settings).
- The main editing window; a project (etc.), source or resource manipulation field where most of the editing for each of the different tools occurs.
The relative sizes of these panes can be modified by dragging the dividing lines with the mouse button pressed.
The menu and navigation strips are the first and second line, respectively, at the top of the web interface with menu/navigation items written in white letters on a dark blue background.
The menu strip is used to manipulate – import/export, create/edit, save/delete – projects (etc.) and (re)sources.
The navigation strip allows one to switch between the three components (OPT, SCT, and RCT) of the scheduling software; the bold-faced name is the currently active tool and the underlined names are links to the other tools. Note that we use Observation Preparation for the OPT, Sources for the SCT and Instrument Configurations for the RCT.
More on using the menu items can be found in following chapters.
Occasionally you may encounter the reddish colored Important message banner just below the menu and navigation strips. We use this banner to convey anticipated downtime, emergency software updates, etc. Scheduled regular maintenance would occur on the first and third Wednesday of the month, starting at noon Mountain time (6 or 7 pm UT). A reminder for this, for example, will appear some time before the downtime in the “Important message banner” suggesting you to save your work promptly.
Figure 1.3: General layout of the Observation Preparation Tool web application page in the web browser. For the SCT, the left hand side column includes a source search tool and thus looks slightly different (see inset left).
The interface feedback strip is the strip over the full web page width at the bottom of the page. This strip is used to display feedback information such as error messages (in red font) and warning messages (in blue font) generated by the web interface when entries made through the web interface are validated. It is advised to pay attention to these messages as it may be the only indication that a schedule is faulty. A SB with errors cannot be submitted, but a SB with warnings may be submitted if the observer persists.
The left hand side column, depending on which tool is selected (OPT, SCT or RCT with their more descriptive names in the navigation strip), should have at least one project, source catalog or resource catalog visible.
- OPT (Observation Preparation). The OPT project column should contain the program for which you were awarded observing time. If not, please let us know as soon as possible (vlahelp@nrao.edu). Other catalogs may be visible, in particular if you had previous observing programs or if you were awarded observing time for more than one project in this proposal round. Different icons in the tree depict different items:
for projects,
for program blocks,
for scheduling blocks, and
for scans or
for scan loops. When using this for the first time, the project tree should be visible all the way to the first scan level (otherwise it may only show the
). Some of the information may have been entered from the details of your proposal and should be read-only.
A small plus-sign (
) icon in front of a project or catalog means that there are items defined within that item; click on it to expand and display a tree-view of these items. For example, clicking on a plus-sign icon in front of a project (orange P) will expose, or expand, a list of PBs in that project, etc. Clicking a small minus-sign (
) icon will hide, or collapse, all content within that item. For speed and memory reasons, not all projects are loaded into memory from the start; if there is no plus-sign associated with the project you would like to work on, simply click (highlight) the project name to load it in memory.
Above the project list and each of the source and resource catalog lists, there is an icon menu. In the SCT case this icon menu will be located between a source search tool (on top) and the source catalog list below it. These icons can be clicked to save, cut/delete or copy/paste entire PBs, specific SBs or individual scans, or (re)source catalogs or (re)source groups. The options of this icon menu only act on the items in the tree, not on the items in the main editing window. In contrast to the small icons in front of a tree item, plus-sign and minus-sign icons in the icon menu expand or collapse the entire tree under a selected (highlighted) item. Arrow icons in the OPT, visible whenever a scan is selected, move items around in a tree. Navigating between projects, blocks and scans in the OPT is simply done by selecting (click to highlight) any such item name in the tree. Similarly one can navigate between a tool’s catalogs and groups in the left hand side column trees (in SCT and RCT).
- SCT (Sources) At the top of the left hand side column of the SCT is an interface to search for sources. The source search is performed on a source name only in the selected source catalog (highlight it by clicking) in the list of catalogs in the bottom part. Alternatively, the source is looked up in the SIMBAD data base when the external search field and button are used. Check the alias box if you have not entered the name of the source in the selected catalog, but e.g. its 3C name. Use Advanced Search if you want to search on something else than a source name in a single catalog.
In the bottom part of the left hand side column of the SCT, there should be at least one source catalog visible in red italics, namely source catalog VLA, containing the VLA calibrator list. There may be other source catalogs visible, in particular calibrator lists from other telescopes and catalogs that you have defined yourself. Catalogs in red italics are read-only. Small plus-sign icons mean that there are groups of sources defined within a catalog; click on it to expand and display these groups. Groups may also contain (sub)groups that can be expanded.
- RCT (Instrument Configurations) At least one resource catalog is visible in the RCT resource catalog column, in red italics, namely resource catalog “NRAO defaults”. It currently contains the NRAO default hardware/instrument settings for OSRO continuum and spectra-polarimetry per observing band: 3 second correlator accumulation times of two 128 MHz subbands (formerly identified as IFs) using full polarization and divided in 64 channels per polarization product. Furthermore it contains WIDAR setups for pointing scans at the higher frequencies. Other resource catalogs may be visible, i.e., if any were defined previously. However, note that resources used previously for the VLA correlator cannot be used with the WIDAR correlator from now on! The same editing and navigation rules apply as for SCT catalogs, e.g., catalogs in red italics are read-only.
More on manipulating PBs, SBs and scans in the OPT, manipulating (re)source catalogs and (re)source groups, and using the source search tool can be found in following chapters.
The main editing window, or manipulation field, exposes different information fields per tool and per item type. However, the SCT and RCT in first instance both show a very similar table of catalog contents, i.e., a table of entries in the selected catalog or group. First we describe the OPT case as it is the first you will see when logging in to the OPT web application.
- OPT When a project is selected (highlighted), the main project (etc.) manipulation field will show the details of this project (and PB, SB or scan details on underlying levels). Most of this upper level information may have been entered and fixed (read-only) by the Proposal Scheduling Committee (PSC) or other NRAO staff. The information in this OPT window will be different according to the item that is selected. If instead of a project a PB is highlighted, information on array configuration (for EVLA projects) and underlying SBs appear. The information on selecting a SB is spread over three pages, each accessible via its own tab at the top of the main window (in this case SB Details with e.g. LST start time, SB Summary with e.g. a scan list, and Validate & Submit). Selecting a scan deploys another couple of tabs in the main editing window.
- SCT Selecting a source catalog or group within a source catalog in the SCT will show the sources in this catalog or group in the form of a table listing in the main source manipulation field. If the list contains more than 25 sources, this list will occupy multiple pages, which can be browsed using the page selection buttons at the top and bottom of this table in the main window. Instead of 25, one can select a higher number of entries per page at the top of the page. The source table contains a source per row with a check box, an editing icon (
), a field for the source name, the coordinates and other details. The coordinate frame used for display in the table is listed above the source table, and may be re-selected. Hovering the mouse over the items in the “Details” column pops up additional source information when available.
- RCT A selected resource catalog or group within a resource catalog shows a similar table listing in the main resource manipulation field, but now with resources. Again, initially there are up to 25 entries per table (i.e., per page) shown, and the different pages are navigable using the buttons at the bottom. The resource list contains a resource per row with a check box, an editing icon, a field for the resource name, the telescope, frequency band and back-end of the resource, and a field for user comments. This view will likely change with advances in WIDAR commissioning.
More on manipulating block and scan information, or on manipulating (re)source information can be found in following chapters.

Connect with NRAO