MDO3000 Programmer Manual.pdf - 第989页

Commands Listed in Alphabetical Order WFMInpre:YUNi t command (YUNit units). It uses the following formula (where dl means digitizing levels; curve_in_dl is a data point value in the CURVe data): V alue in YUNit units = …

Commands Listed in Alphabetical Order

WFMINPRE:YOFF

might return :WFMINPRE:YOFF 25 indicating the vertical

position of the incoming waveform is 25 digitizing levels.

WFMInpre:YUNit

This command speciﬁes the vertical units of data points in the incoming waveform

record sent to the oscilloscope using the

CURVE command. This can be any of

several string values, depending upon the vertical units of the waveform being

sent.

Supported units are: %, /Hz, A, A/A, A/V, A/W, A/dB, A/s, AA, AW, AdB, As,

B, Hz, IRE

, S/s, V, V/A, V/V, V/W, V/dB, V/s, VV, VW, VdB, volts, Vs, W,

W/A, W/V, W/W, W/dB, W/s, WA, WV, WW, WdB, Ws, dB, dB/A, dB/V, dB/W,

dB/dB, dBA, dBV, dBW, dBdB, day, degrees, div, hr, min, ohms, percent, s

NOTE. (See page 2-95, Waveform Transfer Command Group.)

Group

Waveform Transfer

Syntax

WFMInpre:YUNit <QString>

WFMInpre:YUNit?

Related Commands

WFMOutpre:YUNit?

Arguments

<QString> contains the characters that represent the vertical units for the

incoming waveform.

Examples

WFMINPRE:YUNIT? might return :WFMINPRE:YUNIT "V" indicating the vertical

units for the incoming waveform are volts.

WFMINPRE:YUNIT "A" speciﬁes that the vertical units for the incoming waveform

are Amperes.

WFMInpre:YZEro

This command speciﬁes the vertical offset of the destination reference waveform

in units speci

ﬁedbythe

WFMInpre:YUNit command. Variations in this number

are analogous to changing the vertical offset of the waveform.

The

WFMInpre

:YMUlt

, WFMIn pre:YOFf, and WFMInpre :YZEro commands

are used to convert waveform record values to units speciﬁed using the

2-958 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual

Commands Listed in Alphabetical Order

WFMInpre:YUNi

t command (YUNit units). It uses the following formula (where

dl means digitizing levels; curve_in_dl is a data point value in the

CURVe data):

Value in YUNit units = ((curve_in_dl - YOFf) * YMUlt) + YZEro

NOTE. For a given waveform record, YMUlt, YOFf, and YZEro have to be a

consistent set, otherwise vertical cursor readouts and vertical measurements may

give incorrect results.

(See page 2-95, Waveform Transfer Command Group.)

Group

Waveform Transfer

Syntax

WFMInpre:YZEro <NR3>

WFMInpre:YZEro?

Related Commands

WFMInpre:YUNit

WFMInpre:YZEro

Arguments

<NR3> is a ﬂoating point number that speciﬁes the offset in in units speciﬁed by

the

WFMInpre:YUNit command (YUNits).

Examples

WFMINPRE:YZERO 1.5E+0 speciﬁes that the zero reference point for the

incoming waveform is 1.5 V below the center of the data range (given that

WFMInpre:YUNit is set to V).

WFMINPRE:YZERO? might return :WFMINPRE:YZEro 7.5000E-6 indicating

that the zero reference fo

r the incoming waveform is 7.5 µV below the center of

the data range (given that WFMInpre:YUNit is set to V).

WFMOutpre? (Query Only)

This query returns the information needed to interpret the waveform data points

returned by the

CURVe? query. It returns the waveform transmission and

formatting parameters for the waveform speciﬁed by the DATa:SOUrce command.

If the waveform speciﬁed by the DATa:SOUrce command is not displayed, the

oscilloscope returns only the waveform transmission parame

ters (BYT_Nr,

BIT_Nr, ENCdg, BN_Fmt, BYT_Or) and sets an error event indicating that the

source waveform is not turned on.

The Waveform Transfer command group text contains more comprehensive

infor

mation. (See page 2-95, Wa veform Transfer Command Group.)

(See page D-1, Wa veform Transfer (WFMOutpre and CURVe Query) Examples.)

MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-959

Commands Listed in Alphabetical Order

NOTE. For comma

nd sequence examples, see Appendix D. (See page D-1,

Waveform Transfer (WFMOutpre and CURVe Query) Examples.)

Example 1: Analog Waveform (channel 1 - 4)

Example 2: Digital Waveform (channel DO-D15)

Example 3: The Digital Collection with 4 Bytes Per Point with MagniVu Off

Example 4: The Digital Collection with 8 Bytes Per Point with MagniVu Off

Example 5: The Digital Collection with 4 Bytes Per Point with MagniVu On

Example 6: The Digital Collection with 8 Bytes Per Point with MagniVu On

Example 7: RF Frequency Domain Waveform

Group

Waveform Transfer

Syntax

WFMOutpre?

Examples

WFMOUTPRE? ? might return the waveform formatting data as:

:WFMOUTPRE:BYT_NR 2;BIT_NR 16;ENCD G ASCII;BN_FMT RI;BYT_OR

MSB;WFID “Ch1, DC coupling, 100.0mV/div, 4.000us/div, 10000

points, Sample mode”;NR_PT 10000;PT_FMT Y;XUNIT “s”;XINCR

4.0000E-9;XZERO - 2 0.0000E-6;PT_OFF 0;YUNIT “V”;YMULT

15.6250E-6;YOFF :”6.4000E+3;YZERO 0.0000

WFMOutpre:BIT_Nr

This command speciﬁes the number of bits per data point in the outgoing

waveform being transferred using the

CURVe? query. Changing the value of

WFMOutpre:BIT_Nr also changes the values of WFMOutpre:BYT_Nr and

DATa:WIDth. The waveform is speciﬁed by the DATa:SOUrce command.

(See page 2-95, Waveform Transfer Command Group.)

(See page D-1, Waveform Transfer (WFMOutpre and CURVe Query) Examples.)

NOTE. The

WFMOutpre:BYT _Nr

and

WFMOutpre:BIT _Nr

settings are

directly related; setting one causes the other to be set accordingly. For

example,

WFMOutp

re:BYT_Nr 2

causes

WFMOutpre_B IT_Nr

to be set to

16 (2 * 8 bits/byte). Similarly, setting

WFMOutpre: BIT_Nr

to 16 causes

WFMOutpre: BYT_Nr

to be set to 2.

Group

Waveform Transfer

2-960 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual