User`s guide

2-7

Programming Getting Started

Using the DIGitize Command

The DIGitize command is a macro that captures data satisfying the

specifications set up by the ACQuire subsystem. When the digitize process is

complete, the acquisition is stopped. The captured data can then be measured

by the instrument or transferred to the controller for further analysis. The

captured data consists of two parts: the waveform data record and the preamble.

When you send the DIGitize command to the oscilloscope, the specified channel

signal is digitized with the current ACQuire parameters. To obtain waveform

data, you must specify the WAVEFORM parameters for the waveform data prior

to sending the :WAVEFORM:DATA? query.

The number of data points comprising a waveform varies according to the

number requested in the ACQuire subsystem. The ACQuire subsystem

determines the number of data points, type of acquisition, and number of

averages used by the DIGitize command. This allows you to specify exactly what

the digitized information contains.

Ensure New Data is Collected

When you change the oscilloscope configuration, the waveform buffers are cleared.

Before doing a measurement, send the DIGitize command to the oscilloscope to

ensure new data has been collected.

Set :TIMebase:MODE to NORMal when using :DIGitize

:TIMebase:MODE must be set to NORMal to perform a :DIGitize command or to

perform any WAVeform subsystem query. A "Settings conflict" error message will be

returned if these commands are executed when MODE is set to ROLL, XY, or

DELayed. Sending the *RST (reset) command will also set the time base mode to

normal.