Download TimePod 5330A Operation and Service
Transcript
MaskSelect([String mask_name]) This function selects a mask for use with MaskResultMargin() and MaskResultValid(), returning the previously-selected mask if any. If mask_name is omitted, the function returns the currently-selected mask name. In both cases, the function will return an empty string if no mask was selected. Mask names should be specified exactly as they appear in the masks.txt file accessed via Masks→Edit mask definitions (which also determines the names under which they are added to the Masks menu). See MaskResultMargin() for other notes on scripted mask tests. MeasurementSelectView(String hotkey) MeasurementDeferSelectView(String hotkey) These functions accept a hotkey parameter that consists of the (case-sensitive) shortcut key for the desired measurement view as it appears in the Measurement menu. For example, MeasurementSelectView(“P”) will emulate the ‘P’ keyboard shortcut (Measurement→Phase noise (P)). If your script is performing mask tests with multiple measurement types, it’s a good idea to call MeasurementDeferSelectView() as the last action taken before returning from EventTimer(). Upon the next invocation of EventTimer(), your script should call MeasurementView() and evaluate the masks or other test parameters for that view, regardless of any changes to the measurement view that may have taken place between timer ticks. Script authors are encouraged to use the EventTimer() handler in 5330A_performance_test.js as a model for test procedures that use multiple measurement types. The difference between MeasurementSelectView() and MeasurementDeferSelectView() is that the latter will not take effect until after the event handler returns. This distinction is important when multiple instances of the same script may be executed at once. Essentially, deferring the view selection until after all script instances with the same EventTimer() interval have been serviced leaves a single script instance “in charge” of the view, reducing opportunities for confusion. MeasurementView() Returns the current measurement view as a String containing the hotkey for the view as it appears in the Measurement menu. For example, when viewing a phase noise plot, MeasurementView() will return “P”, the shortcut key for Measurement→Phase noise. See MeasurementSelectView() for additional notes on measurement view selection. 124