Keysight Technologies InfiniiVision 3000T X Series, Programmer'S Manual

Page: 1104 / 1420

1104 Keysight InfiniiVision 3000T X-Series Oscilloscopes Programmer's Guide
34
:WAVeform Commands
:WAVeform:POINts:MODE
(see page 1276 )
Command Syntax
:WAVeform:POINts:MODE <points_mode>
<points_mode> ::= {NORMal | MAXimum | RAW}
The :WAVeform:POINts:MODE command sets the data record to be transferred
with the :WAVeform:DATA? query.
For the analog or digital sources, there are two different records that can be
transferred:
• The first is the raw acquisition record. The maximum number of points available
in this record is returned by the :ACQuire:POINts? query. The raw acquisition
record can only be retrieved from the analog or digital sources.
• The second is referred to as the measurement record and is a 62,500-point
(maximum) representation of the raw acquisition record. The measurement
record can be retrieved from any source.
If the <points_mode> is NORMal the measurement record is retrieved.
If the <points_mode> is RAW, the raw acquisition record is used. Under some
conditions, this data record is unavailable.
If the <points_mode> is MAXimum, whichever record contains the maximum
amount of points is used. Usually, this is the raw acquisition record. But, the
measurement record may have more data. If data is being retrieved as the
oscilloscope is stopped and as the data displayed is changing, the data being
retrieved can switch between the measurement and raw acquisition records.
Considerations for
MAXimum or RAW
data retrieval
• The instrument must be stopped (see the :STOP command (see page 228 ) or
the :DIGitize command (see page 203 ) in the root subsystem) in order to return
more than the measurement record .
• :TIMebase:MODE must be set to MAIN.
• :ACQuire:TYPE must be set to NORMal, AVERage, or HRESolution.
• MAXimum or RAW will allow up to 4,000,000 points to be returned. The
number of points returned will vary as the instrument's configuration is
changed. Use the :WAVeform:POINts? MAXimum query to determine the
maximum number of points that can be retrieved at the current settings.
Query Syntax
:WAVeform:POINts:MODE?
The :WAVeform:POINts:MODE? query returns the current points mode. Setting the
points mode will affect what data is transferred. See the discussion above.
Return Format
<points_mode><NL>
<points_mode> ::= {NORMal | MAXimum | RAW}
See Also • "Introduction to :WAVeform Commands" on page 1091