beautypg.com

Inspect waveform contents – Teledyne LeCroy X-STREAM OSCILLOSCOPES Remote Control User Manual

Page 58

background image

P

A R T

O

N E

:

A B O U T

R E M O T E

C O N T R O L

52

ISSUED: February 2005

WM-RCM-E Rev D

Second Data Array block (DATA_ARRAY_2): This is a second data array, needed to hold the results of
processing functions such as Extrema or FFT math functions:

E

X T R E M A

FFT

DATA_ARRAY_1

Roof trace

Real part

DATA_ARRAY_2

Floor trace

Imaginary part

NOTE: The instrument template

also describes an array named DUAL.

But this is simply a way to allow the

INSPECT? command to examine the

two data arrays together.

INSPECT WAVEFORM CONTENTS

Use the INSPECT? query to examine the contents of your waveform. You can use it on both of the main

waveform parts. Its most basic form is: INSPECT? “name”, the template giving you the name of a descriptor
item or data block. You may use single quotation marks or double ones in the command (or none at all) but the

reply will always use double quotes. The answer is returned as a single string, but may cover many lines. Some
typical dialogue follows:

Question

C1:INSPECT? “VERTICAL_OFFSET”

Response

“VERTICAL_OFFSET: -4.0000e-002”

Question

C1:INSPECT? “TRIGGER_TIME”

Response

“TRIGGER_TIME: Date = APR 8, 2004, Time = 10:29: 0.311462573”

You can also use INSPECT? to provide a readable translation of the full waveform descriptor block using
INSPECT? “WAVEDESC”. Again, the template will give you the details for interpretation of each of the

parameters. Also use INSPECT? “SIMPLE” to examine the measured data values of a waveform. For example,
for an acquisition with 52 points:

INSPECT? “SIMPLE”
C1:INSP “

0 . 0 0 0 5 2 2 5 0 . 0 0 0 6 4 7 5 - 0 . 0 0 0 2 9

- 0 . 0 0 0 9 1 5

2 . 2 5 0 0 1 E - 0 5

0 . 0 0 0 8 3 5

0 . 0 0 0 1 4 7 5 - 0 . 0 0 1 3 5 2 5 - 0 . 0 0 2 0 4

- 4 E - 0 5

0 . 0 0 1 1 4 7 5

0 . 0 0 1 1 4 7 5

- 0 . 0 0 0 9 1 5 - 0 . 0 0 1 7 9

- 0 . 0 0 0 2 2 7 5

0 . 0 0 1 1 4 7 5

0 . 0 0 1 0 8 5

- 0 . 0 0 0 7 9

- 0 . 0 0 1 7 9

- 0 . 0 0 0 2 2 7 5

0 . 0 0 0 7 1

0 . 0 0 0 9 6

- 0 . 0 0 0 3 5 2 5 - 0 . 0 0 1 0 4

0 . 0 0 0 2 7 2 5 0 . 0 0 0 7 7 2 5

0 . 0 0 0 7 1

- 0 . 0 0 0 3 5 2 5 - 0 . 0 0 1 2 9

- 0 . 0 0 0 2 2 7 5

0 . 0 0 0 5 2 2 5 0 . 0 0 0 4 6

- 0 . 0 0 1 0 4

- 0 . 0 0 1 5 4

0 . 0 0 0 5 2 2 5

0 . 0 0 1 2 7 2 5

0 . 0 0 1 3 3 5 - 0 . 0 0 0 9 7 7 5 - 0 . 0 0 1 9 1 5

- 0 . 0 0 0 1 6 5

0 . 0 0 1 2 7 2 5

0 . 0 0 0 9 6

- 0 . 0 0 0 6 6 5 - 0 . 0 0 1 6 6 5

- 0 . 0 0 0 1 0 2 5

0 . 0 0 1 0 2 2 5

0 . 0 0 0 9 6

- 0 . 0 0 0 3 5 2 5

- 0 . 0 0 0 9 1 5 8 . 5 0 0 0 1 E - 0 5

0 . 0 0 0 8 3 5

0 . 0 0 0 5 2 2 5

The numbers in the table above are the fully converted measurements in volts. When the data block contains
thousands of items the string will contain a great many lines.

Depending on the application, you may prefer the data in its raw form, with either a BYTE (8 bits) or a
WORD (16 bits) for each data value. In that case, use the relations INSPECT? “SIMPLE”,BYTE with