Digitize - Agilent Technologies InfiniiVision 5000 Series Programmer's Manual

5
Commands by Subsystem

:DIGitize

Command Syntax
:DIGitize [<source>[,..,<source>]]
<source> ::= {CHANnel<n> | FUNCtion | MATH | SBUS}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The <source> parameter may be repeated up to 5 times.
The :DIGitize command is a specialized RUN command. It causes the
instrument to acquire waveforms according to the settings of the :ACQuire
commands subsystem. When the acquisition is complete, the instrument is
stopped. If no argument is given, :DIGitize acquires the channels currently
displayed. If no channels are displayed, all channels are acquired.
To halt a :DIGitize in progress, use the device clear command.
N O T E
MATH is an alias for FUNCtion.
N O T E
See Also
•
•
•
•
•
•
Example Code
132
(see page 658)
"Introduction to Root (:) Commands"
":RUN" on page 156
":SINGle" on page 158
":STOP" on page 160
":ACQuire Commands"
":WAVeform Commands"
' DIGITIZE - Used to acquire the waveform data for transfer over
' the interface. Sending this command causes an acquisition to
' take place with the resulting data being placed in the buffer.
'
' NOTE! The DIGITIZE command is highly recommended for triggering
' modes other than SINGLE.
' available for measurement.
' the completion criteria may never be met.
' gathered in Single mode is related to the sweep speed, memory
' depth, and maximum sample rate.
' with a 1000-point memory, a sweep speed of 10 us/div (100 us
' total time across the screen), and a 20 MSa/s maximum sample rate.
' 1000 divided by 100 us equals 10 MSa/s.
' less than or equal to the maximum sample rate, the full 1000 points
' will be digitized in a single acquisition.
' (10 us across the screen).
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
on page 124
on page 163
on page 500
This ensures that sufficient data is
If DIGITIZE is used with single mode,
For example, take an oscilloscope
1000 divided by 10 us equals 100 MSa/s;
The number of points
Because this number is
Now, use 1 us/div