Dynamic LST Validation (NEW!)

We have added a new tab to the scheduling block (SB), "Dynamic LST Validation" (aka Block Checker Tool). This new built-in tool will allow observers to check their observations for a specified LST start range and several defined parameters.

Important Notes:

This new tool is a work in progress. Please contact the NRAO Science Helpdesk if you encounter any issues, discrepancies, or you see a message with "unknown" severity.

The NRAO staff will continue to check SBs before approving for observation.

We have added a few new parameters to help observers check their SBs:

  • Antenna Shadowing (applicable to D and C-configuration)
    • Observers may now enter an antenna shadow limit (in meters) to help them determine when during the LST start range antennas are being shadowed, which antennas are shadowed, and by how much (in meters).
    • Antenna shadowing information remains present on the Static Reports tab in the Summary Report table near the bottom. You will need to adjust the assumed LST start time to check when/if there are shadowed antennas.
  • Antenna Wraps (CW, CCW, or no preference)
    • We have made this visible to observers to help determine which antenna wrap should be selected. However, we realize the output is not always correct and can be confusing. We are continuing our work to optimize this for less confusion. If you are confused, ask us for help in determining which antenna wrap to use if you are unsure.
    • Basic tips for selecting an antenna wrap at the start of an SB:
      • Select the CCW wrap, if the starting azimuth is ~70-90d.
      • Select the CW wrap, if the starting azimuth is ~270-290d.
      • No antenna wrap is needed if the starting azimuth and the sources following are:
        • always in the north: azimuth is ~290-445d (outer wrap) or ~-85d-70d (inner wrap)
        • always in the south: azimuth is ~90-270d
  • Max Slew Time
    • This check can help the observer determine when there are long antenna slews between sources, i.e., flux/bandpass cal and complex gain calibrator or if a group of science targets have long slews between them possibly indicating the scans in the SB may benefit from being rearranged or perhaps split out into a different SB.
    • 4m 30s is the default setting. Observers may adjust the time to a maximum of 8m 0s.
      • Syntax is important, must be in minutes and seconds, e.g., 4m 30s, 5m 5s, 2m (0s will be autofilled), etc..

 

Dynamic LST Validation Parameters

As seen in the screen capture of the Dynamic LST Validation tab within the OPT, please note the "?" found beside each parameter. While working in the OPT, the "?" can be found throughout and contain helpful information regarding the parameters.

Starting Conditions

The following are editable starting conditions.

LST Start Range To use the same LST start range from the Information tab, select the "Get LST From Info Tab" button.
  • Any changes made to the LST start range on the Dynamic LST Validation tab do not propagate to the Information tab. If you determine a new LST start range is more suitable while you are working in the Dynamic LST Validation tab, then you will need to change the LST start range in the Information tab.
LST Step

This will allow you to step through the defined LST start range in increments of 5, 10, 15, 20, 25, or 30 minutes. The default is 5 minutes, since the LST start range can be set in 5 minute increments.

Assumed Antenna Starting Direction

Azimuth

This will help you determine if you have enough slew and on source time for the first calibrator scan, i.e., reference pointing, flux, bandpass, complex gain calibrator, etc.. The default starting AZ position is 225.0d.

  • If the starting azimuth of the first source is rising (AZ = ~85d), then set the assumed starting AZ position to 445.0d.
  • If the starting azimuth of the first source is setting (AZ= ~275d), then set the assumed starting AZ position to -85.0d.

Elevation

You may also set an assumed starting elevation position. The default starting position of 35.0d is usually sufficient.

 

Evaluator Settings

The following are editable evaluator settings.

Antenna Shadowing

Shadowing Limit (max)

  • Default is 0.0 meters
  • Only applicable to D and C-configuration.
Elevation Limits

Low EL Limits

  • 10.0d is the recommended lower limit.
  • 8.0d is the hard limit of the VLA antennas. When possible, please avoid elevations less than 10.0d.
  • For D and C-configuration, you may want to consider a more conservative lower elevation limit to avoid antenna shadowing.

High EL Limits

  • 80.0d is the recommended upper limit for high frequency observations (Ku/K/Ka/Q-band)
  • 85.0d is the recommended upper limit for low frequency observations (4/P/L/S/C/X-band)
Max Slew Time

Time:

  • Default is 4m 30s (4 minutes 0 seconds)
  • Users can adjust the max slew time check up to 8m 0s (no greater).
Time On Source Minimum

You may edit the recommended default settings for your observation.

If you wish to reset the evaluators to the default settings, select "Reset to VLA Defaults". Note, the starting conditions will not be reset.

 

Running the Block Checker

Once you are satisfied with your starting conditions and evaluator settings, select "Start Dynamic LST Validation".

The results may be grouped by evaluator, severity, LST, or all.

A "Show All" or "Hide All" results option is also available.

This can be helpful when there are many messages and want to focus on a particular evaluator or severity. The messages in the table(s) may be sorted by selecting the top row of each column, i.e., by scan name, scan number, etc..

In addition to the editable evaluator parameters, you may see addition evaluator messages if they have been flagged in your SB. If they do not appear, then they were not used. This is likely ok. It is also ok if after you select "Start Dynamic LST Validation", you see the info message: "No Messages to display. Scheduling Block looks good."

 

Message Types

 

Evaluators

Setup Scan

messages will appear if,

  • initial attenuator setup scans for any resource is missing and,
  • requantizer gain setup scans are missing for 3-bit or mixed-mode 3/8-bit resources.
Scan Time Type

messages will appear if the prohibited time types are found:

  • Duration (UT)
  • On Source (UT)
  • On Source (LST)
Flux Calibrator

 message will appear if 3C295 is used as the flux density scale calibrator.

  • 3C295 is not recommended for flux density scale calibration since it is highly resolved and CASA does not have a model.
Scan Intent

 messages will appear if,

  • non-standard scan intent is in use, i.e., Determine Autophase,
  • setup intent is used with other scan intents.
Scan Flags

Three types of warnings may appear under this evaluator:

indicates a special mode for observing is in use and may not be what was intended. If intended, then it may be ignored.


 indicates observing modes specific to VLBI (phased array), pulsar mode, or eLWA observations are in use. This may not be what was intended. If intended, then it may be ignored.


 indicates a prohibited mode is in use, i.e., Over the Top.

Scan Duration - Maximum

 will appear for all scans and all LST start times which exceed the default scan duration maximum of 15 minutes.

  • If no scans exceed a maximum duration of 15 min, then no warning messages will appear.
Source Elevation - Maximum

 will appear for all scans and all LST start times which exceed the defined elevation maximum.

  • If no scans exceed the maximum defined elevation, then no warnings will appear.
Source Elevation - Minimum

 will appear for all scans and all LST start times which exceed the defined elevation minimum.

  • If no scans are below the minimum defined elevation, then no warnings will appear.
Time On Source - Minimum

 will appear for all scans and all LST start times which exceed the defined time on source minimum set in the table.

  • If no scans are below the time on source minimums, then no warnings will appear.
Antenna Wrap

will appear when the incorrect antenna wrap has been selected.

  • Note, we are continuing to improve the logic for this parameter.  Sometimes it can give an incorrect warning regarding wrap direction.
Max Slew Time

will appear when the selected max slew check is exceeded.

  • If no scans exceed the selected max slew check, no messages will appear.
Antenna Shadowing

will appear when the selected antenna shadowing max has been exceeded.

  • This only applies to D and C-configuration.
  • No messages will appear for A and B-configuration.
  • Projects allocated Any-configuration will show the worse case scenario using D-configuration. The antenna configuration may be changed using the drop-down menu when checking an SB.

Connect with NRAO

The National Radio Astronomy Observatory and Green Bank Observatory are facilities of the U.S. National Science Foundation operated under cooperative agreement by Associated Universities, Inc.