Inspect waveform contents – Teledyne LeCroy X-STREAM OSCILLOSCOPES Remote Control User Manual
Page 58
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