MDO3000 Programmer Manual.pdf - 第369页
Commands Listed in Alphabetical Order Related Commands HIStogram:BOX Pcnt Arguments <NR3> is a floating p oint number that specifies the left position of the histogram box in source waveform horizontal units. <NR3…
Commands Listed in Alphabetical Order
Arguments
OFF sets the Res
ponse Header Enable State to false. This causes the oscilloscope
to omit headers on query responses, so that only the argument is returned.
ON sets the Res
ponse Header Enable State to true. This causes the oscilloscope
to include headers on applicable query responses. You can then use the query
response as a command.
<NR1> = 0 sets the Response Header Enable State to false; any other value sets
this state to true.
Examples
HEADER|:HDR OFF specifies that the oscilloscope omits headers on query
responses, so that only the argument is returned.
HEADER|:HDR? might return :HEADER 1 indicating that the oscilloscope is
including headers on applicable query responses.
HIStogram? (Query Only)
This query-only query returns all histogram parameters; it queries the state of
all histogram parameters that the user can set. This command is equivalent to
selecting Waveform Histograms from the Measure menu.
Group
Histogram
Syntax
HIStogram?
Related Commands
MEASUrement:METHod
Examples
HISTOGRAM? might return the histogram parameters as :HISTOGRAM:BOXPCNT
30.0000,25.1000,70.0000,75.2000;DISPLAY LINEAR;STATE
1;FUNCTION VERTICAL;SI ZE 2.0000;SOURCE CH1
.
HIStogram:BOX
This command specifies the histogram box coordinates in terms of source
waveform vertical and horizontal units.
Group
Histogram
Syntax
HIStogram:BOX <NR3>, <NR3>, <NR3>, <NR3>
HISto
gram:BOX?
2-338 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual
Commands Listed in Alphabetical Order
Related Commands
HIStogram:BOX
Pcnt
Arguments
<NR3> is a floating point number that specifies the left position of the histogram
box in source waveform horizontal units.
<NR3> specifies the top position of the histogram box in source waveform vertical
units.
<NR3> specifies the right position of the histogram box in source waveform
horizontal units.
<NR3> specifies the bottom position of the histogram box in source waveform
vertical units.
Examples
HISTOGRAM:BOX 1E-9, 0.2 50, 2E-9, 0.500 defines the coordinates of the
histogram box in source waveform coordinates.
HISTOGRAM:BOX? might return :HISTOGRA M:BOX 1.0000E-09, 0.2500,
2.0000E-09, 0.5000
, which identifies the coordinates of the histogram box in
source waveform coordinates.
HIStogram:BOXPcnt
This command specifies the histogram box coordinates in terms of percentages
of the full screen extents of the source waveform. The arguments refer to the
left (percent of the horizontal screen extent), top (percent of the vertical screen
extent), right (percent of the horizontal screen extent), bottom (percentofthe
vertical screen extent). The valid range for these values is 0.0 to 100.0.
Group
Histogram
Syntax
HIStogram:BOXPcnt <NR2>, <NR2>, <NR2>, <NR2>
HIStogram:BOXPcnt?
Related Commands
HIStogram:BOX
Arguments
<NR3> is a floating point number th
at specifies the left position of the histogram
box in percentage coordinates. The default value is 20%
<NR3> specifies the top position
of the histogram box in percentage coordinates.
Thedefaultvalueis80%
<NR3> specifies the right posit
ion of the histogram box in percentage coordinates.
Thedefaultvalueis80%
MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-339
Commands Listed in Alphabetical Order
<NR3> specifies
the bottom position of the histogram box in percentage
coordinates. The default value is 20%
Examples
HISTOGRAM:BOXPCNT 30.0,25.0,70.0,75.0 sets the left boundary of the
histogram box to 30% of the graticule (3 divisions from the left edge); the top
boundary to 25% of the graticule (0.25 × 10 = 2.5 divisions from the top edge);
the right boundary to 70% of the graticule (7 divisions from the left edge); and
the bottom boundary to 75% of the graticule (0.75 × 10 = 7.5 divisions from
the top edge).
HISTOGRAM:BOXPCNT? might return :HISTOGRAM:BOXPCNT
30.0000,25.1000,70.0000,75.2000.
HIStogram:COUNt (No Query Form)
This command (no query form) clears the count and statistics for the histogram
and the histogram source data. If the histogram is on, then counting restarts.
Group
Histogram
Syntax
HIStogram:COUNt RESET
Related Commands
HIStogram:BOX
HIStogram:BOXPcnt
Arguments
RESET
Examples
HISTOGRAM:COUNT RESET clears the count and statistics for the histogram and
the histogram source data.
HIStogram:DATa? (Query Only)
This query returns the histogram data when HIStogram:MODe is HORizontal or
VERTical. If the mode is OFF, then no data is returned and an error event is set.
The data values returned for this query represent the number of times the histogram
source waveform samples were coincident with a particular histogram bin.
For vertical histograms, this query returns 256 values, representing the number
of times the histogram source waveform samples were coincident with each of
the 256 digitizing levels. Of these 256 values, the first 2 and last 3 are always
2-340 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual