Jackson Labs PHASE STATION 53100A, User Manual

Page: 157 / 225

PhaseStation 53100A User’s Manual V1.04 25-Apr-2022 157
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
53100A_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.
Print(
…
)
Displays one or more user-specified values in the script console window associated with
the currently-bound plot. Multiple arguments may be separated by commas; a line feed
will be inserted after each argument. (To avoid this, you can use string concatenation
rather than multiple
Print()
arguments.)
Numerous usage examples for the
Print()
function appear in 53100_performance_test.js
and 5330A_ADC_test.js .
ScriptBindToPlot(Number selection)
Associates the script instance with the plot at the specified position in the legend table,
from 0 to 8.