Agilent Technologies Infiniium 90000 Q-Series, Programmer'S Manual

Page: 546 / 1186

546 Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference
25
Measure Commands
:MEASure:HISTogram:M2S
Command
:MEASure:HISTogram:M2S [<source>]
The :MEASure:HISTogram:M2S command places the histogram percentage
of points within two standard deviations of the mean measurement into
the Measurements tab of the oscilloscope's user interface.
The source is specified with the :MEASure:SOURce command or with the
optional parameter following the command.
The :MEASure:HISTogram commands only apply to Meas Histogram math
functions, the histogram waveform, or memories containing histograms.
<source> { FUNCtion<F> | WMEMory<N> | HISTogram}
<F>
An integer, 1- 16.
<N> An integer, 1- 4.
Example
This example measures the percentage of points that are within two
standard deviations of the mean of the histogram whose source is
specified using the MEASure:SOURce command.
myScope.WriteString ":MEASure:HISTogram:M2S WMEMory1"
Query
:MEASure:HISTogram:M2S? [<source>]
The :MEASure:HISTogram:M2S? query returns the measurement of the
percentage of points within two standard deviations of the mean of the
histogram.
Returned Format
[:MEASure:HISTogram:M2S]<value>[,<result_state>]<NL>
<value> The percentage of points within two standard deviations of the mean of
the histogram.
<result_state> If SENDVALID is ON, the result state is returned with the measurement
result. Refer to the MEASure:RESults command, for a list of the result
states.
Example
This example returns the percentage of points within two standard
deviations of the mean of the current histogram and prints the result to
the computer's screen.
myScope.WriteString ":SYSTem:HEADer OFF" ' Response headers off.
myScope.WriteString ":MEASure:HISTogram:M2S? WMEMory1"
varHistm2s = myScope.ReadNumber
Debug.Print FormatNumber(varHistm2s, 0)
See Also • ":FUNCtion<F>:MHIStogram" on page 350
• ":HISTogram:MODE" on page 374