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

Page: 965 / 1186

Waveform Commands
34
Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference 965
: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 159.)
<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 976 and ":ACQuire[:AVERage]:COUNt" on
page 149.)