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

Page: 715 / 1186

Root Level Commands
27
Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference 715
:DIGitize
Command
:DIGitize [CHANnel<N> | DIGital<M> | POD<P>][,...]
<N>
An integer, 1- 4.
<M> An integer, 0- 15.
<P>
An integer, 1- 2.
The :DIGitize command invokes a special mode of data acquisition that is
more efficient than using the :RUN command. This command initializes the
selected channels, then acquires them according to the current oscilloscope
settings. When all waveforms are completely acquired, the oscilloscope is
stopped. The waveform completion criteria is set with the
":ACQuire:COMPlete" command.
If you specify channel parameters, then these are the only waveforms
acquired and the display waveforms of the specified channels are turned
off.
If you use the :DIGitize command with no parameters, the digitize
operation is performed on the channels that are being displayed in the
Infiniium waveform viewing area. In this case, the display state of the
acquired waveforms is not changed after the :DIGitize command is
completed. Because the command executes more quickly without
parameters, this form of the command is useful for repetitive measurement
sequences. You can also use this mode if you want to view the digitize
results because the display state of the digitized waveforms is not affected.
See the Chapter 38 , “Sample Programs,” starting on page 1019 for
examples of how to use :DIGitize and its related commands.
Example This example acquires data on channel 1.
myScope.WriteString ":DIGitize CHANnel1"
The ACQuire subsystem commands set up conditions such as COUNt for
the next :DIGitize command. The WAVeform subsystem commands
determine how the data is transferred out of the oscilloscope, and how to
interpret the data.
N O T E
Full Range of Measurement and Math Operators are Available
Even though digitized waveforms are not displayed, you may perform the full range of
measurement and math operators on them.