MDO3000 Programmer Manual.pdf - 第987页

Commands Listed in Alphabetical Order WFMINPRE:YMUL T 20E-3 speciﬁes that (if WFM Inpr e:YUNit is "V" and WFMInpre:BYT_Nr is 1), the vertical scale is 20 mV/digitizing level (500 mV/div). WFMInpre:YO Ff This co…

Commands Listed in Alphabetical Order

Examples

WFMINPRE:XZER

O 5.7E-6

, which indicates the trigger occurred 5.7 µs before the

ﬁrst sample in the waveform.

WFMINPRE:XZE

RO?

might return :WFMINPRE:XZEro –7.5000E-6 indicating

that the trigger occurs 7.5 µs after the ﬁrst sample in the waveform.

WFMInpre:YMUlt

This command speciﬁes the vertical scale multiplying factor to be used to convert

the incoming data point values being sent to the oscilloscope, from digitizing

levels into the units speciﬁed by the

WFMInpre:YUNit command. For one byte

waveform

data, there are 256 digitizing levels. For two byte waveform data there

are 65,536 digitizing levels.

The

WFMI

npre:YMUlt

, WF MInpre:YOFf, and WFMInpre:YZEro values

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

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

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

CURVe data):

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

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

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

consistent set, otherwise v ertical cursor readouts and vertical measurements may

give incorrect results.

Gro

Waveform Transfer

Syntax

WFMInpre:YMUlt <NR3>

WFMInpre:YMUlt?

Related Commands

DATa:DESTination,

WFMInpre:BYT_Nr,

WFMInpre:YUNit

Arguments

<NR3> is a ﬂoating point number that speciﬁes the vertical scale factor per

digitizing level of the incoming waveform points.

Examples

WFMINPRE:YMULT? might return :WFMINPRE:YMULT 40.0000E-3,which(if

YUNit is “V”) indicates that the vertical scale is 40 mV/digitizing level (1V/div

for 8-bit data).

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

Commands Listed in Alphabetical Order

WFMINPRE:YMUL

T 20E-3

speciﬁes that (if WFM Inpre:YUNit is "V"

and

WFMInpre:BYT_Nr is 1), the vertical scale is 20 mV/digitizing level

(500 mV/div).

WFMInpre:YO

This command speciﬁes the vertical position of the destination reference

waveform in digitizing levels. There are 25 digitizing levels per vertical division

for 1-byte

data, and 6400 digitizing levels per vertical division for 2-byte data.

Variations in this number are analogous to changing the vertical position of the

waveform.

The

WFMInpre:YMUlt, WFMInpre:YOFf, and WFMInpre:YZE ro commands

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

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

dl means digitizing levels, and 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

consi

stent 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:YOFf <NR3>

WFMInpre:YOFf?

Related Commands

WFMInpre:BYT_Nr

WFMInpre:YMUlt

FMOutpre:YOFf?

Arguments

<NR3> is a ﬂoating point number that speciﬁes the vertical offset in digitizing

levels.

Examples

WFMINPRE:YOFF 50 speciﬁes that the zero reference point for the incoming

waveform is 50 digitizing levels (2 divisions, for 8-bit data; 0.0078125 division

for 16-bit data) above the center of the graticule.

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

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