Agilent Technologies InfiniiVision 7000A Series, Programmer'S Manual

Page: 150 / 922

150 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DIGitize
(see page 786 )
Command Syntax
:DIGitize [<source>[,..,<source>]]
<source> ::= {CHANnel<n> | FUNCtion | MATH | SBUS} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15 | POD{1 | 2}
| BUS{1 | 2} | FUNCtion | MATH | SBUS} for the MSO models
<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.
See Also
• "Introduction to Root (:) Commands" on page 141
• ":RUN" on page 174
• ":SINGle" on page 176
• ":STOP" on page 178
• ":ACQuire Commands" on page 181
• ":WAVeform Commands" on page 616
Example Code
' 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. This ensures that sufficient data is
' available for measurement. If DIGITIZE is used with single mode,
' the completion criteria may never be met. The number of points
' gathered in Single mode is related to the sweep speed, memory
' depth, and maximum sample rate. For example, take an oscilloscope
' 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. Because this number is
N O T E
To halt a :DIGitize in progress, use the device clear command.
N O T E
MATH is an alias for FUNCtion.