MDO3000 Programmer Manual.pdf - 第988页

Commands Listed in A lphabetical Order WFMINPRE:YOFF ? might return :WFMINPRE:YOF F 25 indicating the vertical position of the incoming waveform is 25 digitizing levels. WFMInpre:YUNit This command speciﬁes the vertical …

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

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