Technical data

Waveform Commands 34
Agilent Infiniium 9000 Series Oscilloscopes Programmer's Reference 1117
:WAVeform:PREamble?
Query :WAVeform:PREamble?
The :WAVeform:PREamble? query outputs a waveform preamble to the
computer from the waveform source, which can be a waveform memory or
channel buffer.
Returned Format
[:WAVeform:PREamble] <preamble_data><NL>
The preamble can be used to translate raw data into time and voltage
values. The following lists the elements in the preamble.
<preamble_
data>
<format>, <type>, <points>, <count> , <X increment>, <X origin>, < X
reference>, <Y increment>, <Y origin>, <Y reference>, <coupling>, <X display
range>, <X display origin>, <Y display range>, <Y display origin>, <date>,
<time>, <frame model #>, <acquisition mode>, <completion>, <X units>, <Y
units>, <max bandwidth limit>, <min bandwidth limit>
<format> 0 for ASCii format. 1 for BYTE format. 2 for WORD format. 3 for LONG
format. 4 for LONGLONG
<type> Returned type values can be:
• 1 — RAW
• 2 — AVERage
• 3 — VHIStogram
• 4 — HHIStogram
• 5 — not used
• 6 — INTerpolate
• 7 — not used
• 8 — not used
• 9 — DIGITAL
• 10 — PDETect
<points> The number of data points or data pairs contained in the waveform data.
(See ":ACQuire:POINts[:ANALog]" on page 158.)
<count> For the AVERAGE waveform type, the count value is the fewest number of
hits for all time buckets. This value may be less than or equal to the value
requested with the :ACQuire:AVERage:COUNt command. For RAW and
INTerpolate waveform types, this value is 0 or 1. The count value is
ignored when it is sent to the oscilloscope in the preamble. (See
":WAVeform:TYPE?" on page 1129 and ":ACQuire[:AVERage]:COUNt" on
page 149.)