Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples
WFMOutpre? Query results
Explanation
PT_FMT Y
This value indicates the format of the data points in the waveform record. In this case,
the value represents YT format. This is query only – the returned values can be Y for YT
format or ENV f
or envelope format (min/max pairs). (If you would like to determine only this
value, use the WFMOutpre:PT_Fmt? query.)
PT_ORDER LIN
EAR
This value is
always
LINear.
XUNIT "s"
This value i
ndicates the units of the x-axis of the waveform record. This is determined by the
horizontal settings for the waveform source. Typically, this value is “s”, representing seconds.
When using the math waveform as a source, the value can be “s” or “Hz”. This is query only.
(If you woul
d like to determine only this value, use the WFMOutpre:XUNit? query.)
XINCR 4.0000E-9
This value
indicates the time, in seconds, or frequency, in hertz, between data points in the
waveform record. This is query only. (If you would like to determine only this value, use
the WFMOutpre:XINcr? query.)
XZER0 -20.0000E-6
This value indicates the time, in s econds, or frequency, in hertz, of the first d ata point in the
waveform
record. This time or frequency is relative to the time of the trigger, which is always
0. So, this XZEro time or frequency can be negative. This is query only. (If you would like to
determine only this value, use the WFMOutpre:XZEro? query.)
PT_OFF 0
This is a query p rovided only for compatibility with performance oscilloscopes. The
return
ed value is always 0. (If you would like to determine only this value, use the
WFMOutpre:PT_Off? query.)
YUNIT "V"
This value indicates the vertical units of data points in the waveform record. This can be
any of several string values, depending upon the vertical units of the source waveform –
in thi
s case, volts. This is query only. (If you would like to determine only this value, use
the WFMOutpre:YUNit? query.)
YMULT
4.0000E-3
This value indicates the multiplying factor t o convert the data point values from digitizing
levels to the units specified by the
WFMOUTpre:YUNit command. This is query only. (If
you w
ould like to determine only this value, use the WFMOutpre:YMUlt? query.)
YOFF 0.0E+0
This
value indicates the vertical position of the source waveform in digitizing levels. There
are 25 digitizing levels per vertical division. This is query only. (If you would like to determine
only this value, use the WFMOutpre:YOFf? query.)
YZERO 0.0E+0
This value indicates the vertical offset of the source waveform in units specified by the
WFM
OUTpre:YUNit
command. This is query only. (If you would like to determine only this
value, use the WFMOutpre:YZEro? query.)
Example 2: Digital Waveform
Goal: Transfer 25 points of digital channel waveform data from the oscilloscope
to a PC.
Command Comment
:DATa:SOUrce CH1_D5
:DATa:START 1
:DATa:STOP 25
:WFMOutpre:ENCdg ASCi i
:WFMOutpre:BYT_Nr 1
MSO54, MSO56, MSO58, MSO58LP Programmer D-3