Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples
WFMOutpre? Query results
Explanation
ENCDG ASCII
This value s pecifies the encoding of the waveform data. To change this value (the
other possibility is BINARY), use the WFMOutpre:ENCdg command. (This value can
also be set usi
ng the DATa:ENCdg command, which provides the ability to set the
WFMOutpre:ENCdg, WFMOut pre:BN_Fmt,: and WFMOut pre:BYT_Or values
using a single command.)
BN_FMT RI
This value specifies the binary format, which in this case is RI (signed integer). To change
this value (
the other possibility is RP or positive integer), use the WFMOutpre:BN_Fmt
command. Note: this field is not applicable for ASCii encoding.
BYT_OR MSB
This value specifies the byte order for the BINARY encoding, which in this case is MSB
(most significant byte first, also known as IBM format). To change this value to LSB, use the
WFMOutpre
:BYT_Or command. Note: this field is not applicable for ASCii encoding.
WFID "Digital, unkn own
coupling, 100.0us/div,
10000 points, Digital
mode"
This quot
ed string represents information about the source waveform that would be returned
by a.
WFMOutpre:WFId? query. It cannot be changed.
NR_PT 25
This value indicates the number of data points in the waveform record to be transferred
using the CURVE? query. (If you would like to determine only this value, use the
WFMOutpre:NR_Pt? query.) Note: this value is typically equal to the full record length,
but you also have the option to transfer only a portion of the record length by using the
DATa:STARt and DATa:STOP commands.
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 for envelope format (min/max pairs). (If you would like to determine only this
value, use the WFMOutpre:PT_Fmt? query.)
PT_ORDER LINEAR
This val u e is always LI Near.
XUNIT “s”
This value indicates the units of the x-axis of t he waveform record. T his 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 would like to determine only this value, use the WFMOutpre:XUNit? query.)
XINCR 1.2121E-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 -6.0606E-6
This value indicates the time, in seconds, or frequency, in hertz, of the first data 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 provided only for compatibi lity with performance oscilloscopes. The
returned value is always 0. ( If you would like to determine only this value, use the
WFMOutpre:PT_Off? query.)
YUNIT “State”
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 this case, State. This is query only. (If you would like to determine only this value, use
the WFMOutpre:YUNit? query.)
YMULT 1.0000
This value indicates the multiplying factor to convert the data point values from digitizing
levels to the units spec i fied by the
WFMOUTpre:YUNit command. This is query only. (If
you would like to determine only this value, use the WFMOutpre:YMUlt? query.)
MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual D-11