Jackson Labs PHASE STATION 53100A, User Manual

Page: 158 / 225

PhaseStation 53100A User’s Manual V1.04 25-Apr-2022 158
Most script authors will not need to use
ScriptBindToPlot().
It is required only in scripts
that support multichannel plots, such as 53100A_performance_test.js and
5330A_ADC_test.js . A script can be associated (“bound”) to only one plot at a time, and
most operations performed by a script implicitly involve the currently bound plot.
When a measurement initiated by a script specifies multiple stability channels, as in the
TimePod and PhaseStation validation scripts mentioned, it’s necessary to use
ScriptBindToPlot()
to access the plots that represent all channels of the measurement.
By default, scripts are bound to channel 0 of a multichannel acquisition. It’s a good idea
to restore the default channel-0 binding with
ScriptBindToPlot(AcqChannel(0))
before
returning from any function or event handler that uses
ScriptBindToPlot().
Since plots in multichannel measurements may be moved up and down in the legend
table by the user,
ScriptBindToPlot()
is normally used together with the
AcqChannel()
function. See the two performance test scripts mentioned above for further comments
and usage examples.
ScriptBoundToPlot()
Returns the position in the legend table beneath the graph, from 0 to 8, of the plot to
which the script is currently bound.
Most script authors will not need to use
ScriptBoundToPlot().
It is required only in scripts
that support multichannel plots, such as 53100A_performance_test.js and
5330A_ADC_test.js .
ScriptEnd()
Marks the script for cleanup by the TimeLab runtime JavaScript engine. Scripts which
are associated with loaded plots must be terminated with a call to
ScriptEnd()
when
finished. Otherwise, they will continue to run (and consume resources) until one of the
following conditions is true:
- A script exception or other fatal error occurs
- The Scripts→Stop all running scripts ( F12 ) command is issued by the user
- The user exits from TimeLab
ScriptFilename(Boolean full_path)
If
full_path
is true, ScriptFilename() returns a String containing the fully-qualified path to
the script’s JavaScript (.js) source file. Otherwise, it returns only the filename itself.