measurement
¶
The measurement commands module.
These commands are used in the following models: DPO5K, DPO5KB, DPO70KC, DPO70KD, DPO70KDX, DPO70KSX, DPO7K, DPO7KC, DSA70KC, DSA70KD, MSO5K, MSO5KB, MSO70KC, MSO70KDX
THIS FILE IS AUTO-GENERATED, IT SHOULD NOT BE MANUALLY MODIFIED.
Please report an issue if one is found.
Commands and Queries
- MEASUrement:ANNOTation:IMMEDSTAte {ON|OFF|<NR1>}
- MEASUrement:ANNOTation:IMMEDSTAte?
- MEASUrement:ANNOTation:NUMX?
- MEASUrement:ANNOTation:NUMY?
- MEASUrement:ANNOTation:STATE {OFF|MEAS<x>}
- MEASUrement:ANNOTation:STATE?
- MEASUrement:ANNOTation:TYPe {STANdard|DETAiled}
- MEASUrement:ANNOTation:TYPe?
- MEASUrement:ANNOTation:X<x>?
- MEASUrement:ANNOTation:Y<x>?
- MEASUrement:DPOJETSTATistics?
- MEASUrement:GATing {ON|OFF|<NR1>|ZOOM<x>|CURSor}
- MEASUrement:GATing?
- MEASUrement:IMMed:DELay:DIREction {BACKWards|FORWards}
- MEASUrement:IMMed:DELay:DIREction?
- MEASUrement:IMMed:DELay:EDGE2 {FALL|RISe}
- MEASUrement:IMMed:DELay:EDGE2?
- MEASUrement:IMMed:DELay:EDGE<x> {FALL|RISe}
- MEASUrement:IMMed:DELay:EDGE<x>?
- MEASUrement:IMMed:DELay?
- MEASUrement:IMMed:METHod {HIStogram|MINMax|MEAN}
- MEASUrement:IMMed:METHod?
- MEASUrement:IMMed:NOISe {HIGH|LOW}
- MEASUrement:IMMed:NOISe?
- MEASUrement:IMMed:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:HIGH?
- MEASUrement:IMMed:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:LOW?
- MEASUrement:IMMed:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:MID<x>?
- MEASUrement:IMMed:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:IMMed:REFLevel:METHod?
- MEASUrement:IMMed:REFLevel:PERCent:HIGH <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:HIGH?
- MEASUrement:IMMed:REFLevel:PERCent:LOW <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:LOW?
- MEASUrement:IMMed:REFLevel:PERCent:MID<x> <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:MID<x>?
- MEASUrement:IMMed:REFLevel?
- MEASUrement:IMMed:SOUrce1 {CH<x>|MATH<y>|REF<x>|HIStogram}
- MEASUrement:IMMed:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:IMMed:SOUrce1:SIGType?
- MEASUrement:IMMed:SOUrce1?
- MEASUrement:IMMed:TYPe {AMPlitude|AREa|BURst|CARea|CMEan|CRMs|DELay|DISTDUty|EXTINCTDB|EXTINCTPCT|EXTINCTRATIO|EYEHeight|EYEWIdth|FALL|FREQuency|HIGH|HITs|LOW|MAXimum|MEAN|MEDian|MINImum|NCROss|NDUty|NOVershoot|NWIdth|PBASe|PCROss|PCTCROss|PDUty|PEAKHits|PERIod|PHAse|PK2Pk|PKPKJitter|PKPKNoise|POVershoot|PTOP|PWIdth|QFACtor|RISe|RMS|RMSJitter|RMSNoise|SIGMA1|SIGMA2|SIGMA3|SIXSigmajit|SNRatio|STDdev|UNDEFINED|WAVEFORMS}
- MEASUrement:IMMed:TYPe?
- MEASUrement:IMMed:UNIts?
- MEASUrement:IMMed:VALue?
- MEASUrement:IMMed?
- MEASUrement:MEAS<x>:COUNt?
- MEASUrement:MEAS<x>:DELay:DIREction {BACKWards|FORWards}
- MEASUrement:MEAS<x>:DELay:DIREction?
- MEASUrement:MEAS<x>:DELay:EDGE<x> {FALL|RISe}
- MEASUrement:MEAS<x>:DELay:EDGE<x>?
- MEASUrement:MEAS<x>:DELay?
- MEASUrement:MEAS<x>:MAXimum?
- MEASUrement:MEAS<x>:MEAN?
- MEASUrement:MEAS<x>:METHod {HIStogram|MINMax|MEAN}
- MEASUrement:MEAS<x>:METHod?
- MEASUrement:MEAS<x>:MINImum?
- MEASUrement:MEAS<x>:NOISe {HIGH|LOW}
- MEASUrement:MEAS<x>:NOISe?
- MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH?
- MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW?
- MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>?
- MEASUrement:MEAS<x>:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:MEAS<x>:REFLevel:METHod?
- MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH?
- MEASUrement:MEAS<x>:REFLevel:PERCent:LOW <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:LOW?
- MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x> <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>?
- MEASUrement:MEAS<x>:REFLevel?
- MEASUrement:MEAS<x>:SOUrce1 {CH<x>|MATH<y>|REF<x>|HIStogram}
- MEASUrement:MEAS<x>:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:MEAS<x>:SOUrce1:SIGType?
- MEASUrement:MEAS<x>:SOUrce1?
- MEASUrement:MEAS<x>:STATE {ON|OFF|<NR1>}
- MEASUrement:MEAS<x>:STATE?
- MEASUrement:MEAS<x>:STDdev?
- MEASUrement:MEAS<x>:TYPe {AMPlitude|AREa|BURst|CARea|CMEan|CRMs|DELay|DISTDUty|EXTINCTDB|EXTINCTPCT|EXTINCTRATIO|EYEHeight|EYEWIdth|FALL|FREQuency|HIGH|HITs|LOW|MAXimum|MEAN|MEDian|MINImum|NCROss|NDUty|NOVershoot|NWIdth|PBASe|PCROss|PCTCROss|PDUty|PEAKHits|PERIod|PHAse|PK2Pk|PKPKJitter|PKPKNoise|POVershoot|PTOP|PWIdth|QFACtor|RISe|RMS|RMSJitter|RMSNoise|SIGMA1|SIGMA2|SIGMA3|SIXSigmajit|SNRatio|STDdev|UNDEFINED|WAVEFORMS}
- MEASUrement:MEAS<x>:TYPe?
- MEASUrement:MEAS<x>:UNIts?
- MEASUrement:MEAS<x>:VALue?
- MEASUrement:MEAS<x>?
- MEASUrement:METHod {HIStogram|MEAN|MINMax}
- MEASUrement:METHod?
- MEASUrement:NOISe {HIGH|LOW}
- MEASUrement:NOISe?
- MEASUrement:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:REFLevel:ABSolute:HIGH?
- MEASUrement:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:REFLevel:ABSolute:LOW?
- MEASUrement:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:REFLevel:ABSolute:MID<x>?
- MEASUrement:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:REFLevel:METHod?
- MEASUrement:REFLevel:PERCent:HIGH <NR3>
- MEASUrement:REFLevel:PERCent:HIGH?
- MEASUrement:REFLevel:PERCent:LOW <NR3>
- MEASUrement:REFLevel:PERCent:LOW?
- MEASUrement:REFLevel:PERCent:MID<x> <NR3>
- MEASUrement:REFLevel:PERCent:MID<x>?
- MEASUrement:REFLevel?
- MEASUrement:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:SOUrce1:SIGType?
- MEASUrement:STATIstics:COUNt {RESET}
- MEASUrement:STATIstics:MODe {OFF|ALL|VALUEMean|MINMax|MEANSTDdev}
- MEASUrement:STATIstics:MODe?
- MEASUrement:STATIstics:WEIghting <NR1>
- MEASUrement:STATIstics:WEIghting?
- MEASUrement?
Measurement
¶
Bases: SCPICmdRead
The MEASUrement command.
Description
- This query-only command returns all measurement parameters.
Usage
- Using the
.query()method will send theMEASUrement?query. - Using the
.verify(value)method will send theMEASUrement?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement?
Properties
.annotation: TheMEASUrement:ANNOTationcommand tree..dpojetstatistics: TheMEASUrement:DPOJETSTATisticscommand..gating: TheMEASUrement:GATingcommand..immed: TheMEASUrement:IMMedcommand..meas: TheMEASUrement:MEAS<x>command..method: TheMEASUrement:METHodcommand..noise: TheMEASUrement:NOISecommand..reflevel: TheMEASUrement:REFLevelcommand..source1: TheMEASUrement:SOUrce1command tree..statistics: TheMEASUrement:STATIsticscommand tree.
annotation
property
¶
annotation: MeasurementAnnotation
Return the MEASUrement:ANNOTation command tree.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.immedstate: TheMEASUrement:ANNOTation:IMMEDSTAtecommand..numx: TheMEASUrement:ANNOTation:NUMXcommand..numy: TheMEASUrement:ANNOTation:NUMYcommand..state: TheMEASUrement:ANNOTation:STATEcommand..type: TheMEASUrement:ANNOTation:TYPecommand..x: TheMEASUrement:ANNOTation:X<x>command..y: TheMEASUrement:ANNOTation:Y<x>command.
dpojetstatistics
property
¶
dpojetstatistics: MeasurementDpojetstatistics
Return the MEASUrement:DPOJETSTATistics command.
Description
- This queries the DPOJET measurement statistics.
Usage
- Using the
.query()method will send theMEASUrement:DPOJETSTATistics?query. - Using the
.verify(value)method will send theMEASUrement:DPOJETSTATistics?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:DPOJETSTATistics?
gating
property
¶
gating: MeasurementGating
Return the MEASUrement:GATing command.
Description
- This command specifies or returns the measurement gating setting. This command is equivalent to selecting Gating from the Measure menu and then clicking the desired Measurement Gating setting.
Usage
- Using the
.query()method will send theMEASUrement:GATing?query. - Using the
.verify(value)method will send theMEASUrement:GATing?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:GATing valuecommand.
SCPI Syntax
- MEASUrement:GATing {ON|OFF|<NR1>|ZOOM<x>|CURSor}
- MEASUrement:GATing?
Info
ONturns on measurement gating.OFFturns off measurement gating.<NR1>= 0 turns off measurement gating; any other value turns on measurement gating.ZOOM<x>turns on gating, using the left and right edges of the zoom box.specifies the zoom window, which ranges from 1 through 4. CURSORlimits measurements to the portion of the waveform between the vertical bar cursors, even if they are off screen.
immed
property
¶
immed: MeasurementImmed
Return the MEASUrement:IMMed command.
Description
- Returns all immediate measurement setup parameters.
Usage
- Using the
.query()method will send theMEASUrement:IMMed?query. - Using the
.verify(value)method will send theMEASUrement:IMMed?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed?
Sub-properties
.delay: TheMEASUrement:IMMed:DELaycommand..method: TheMEASUrement:IMMed:METHodcommand..noise: TheMEASUrement:IMMed:NOISecommand..reflevel: TheMEASUrement:IMMed:REFLevelcommand..source1: TheMEASUrement:IMMed:SOUrce1command..type: TheMEASUrement:IMMed:TYPecommand..units: TheMEASUrement:IMMed:UNItscommand..value: TheMEASUrement:IMMed:VALuecommand.
meas
property
¶
meas: dict[int, MeasurementMeasItem]
Return the MEASUrement:MEAS<x> command.
Description
- Returns all measurement parameters for the specified active measurement
.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>?
Sub-properties
.count: TheMEASUrement:MEAS<x>:COUNtcommand..delay: TheMEASUrement:MEAS<x>:DELaycommand..maximum: TheMEASUrement:MEAS<x>:MAXimumcommand..mean: TheMEASUrement:MEAS<x>:MEANcommand..method: TheMEASUrement:MEAS<x>:METHodcommand..minimum: TheMEASUrement:MEAS<x>:MINImumcommand..noise: TheMEASUrement:MEAS<x>:NOISecommand..reflevel: TheMEASUrement:MEAS<x>:REFLevelcommand..source1: TheMEASUrement:MEAS<x>:SOUrce1command..state: TheMEASUrement:MEAS<x>:STATEcommand..stddev: TheMEASUrement:MEAS<x>:STDdevcommand..type: TheMEASUrement:MEAS<x>:TYPecommand..units: TheMEASUrement:MEAS<x>:UNItscommand..value: TheMEASUrement:MEAS<x>:VALuecommand.
method
property
¶
method: MeasurementMethod
Return the MEASUrement:METHod command.
Description
- This command sets or queries the method used to calculate the 0% and 100% reference level. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired Determine Base, Top From setting.
Usage
- Using the
.query()method will send theMEASUrement:METHod?query. - Using the
.verify(value)method will send theMEASUrement:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:METHod valuecommand.
SCPI Syntax
- MEASUrement:METHod {HIStogram|MEAN|MINMax}
- MEASUrement:METHod?
Info
HIStogramsets the high and low reference levels to the most common values either above or below the mid point, depending on whether the high reference point or the low reference point is being defined. Because the statistical approach ignores short-term aberrations, such as overshoot or ringing, the histogram method is the best setting for examining pulses.MEANsets the high and low reference levels to the mean values using all values either above or below the midpoint, depending on whether it is defining the high or low reference level. The selection is best used for examining eye patterns.MINMaxuses the highest and lowest values of the waveform record. This selection is best for examining waveforms with no large, flat portions of a common value, such as sine waves and triangle waves.
noise
property
¶
noise: MeasurementNoise
Return the MEASUrement:NOISe command.
Description
- This command sets or queries whether the noise measurement is made on the high or low
level of the waveform. Sending this command is equivalent to selecting Ref Levs > Eye
Top Level or Base Level in the Comm tab of the Measurement Setup dialog box. The Eye section is displayed only if you have an eye-pattern or optical measurement defined.
Usage
- Using the
.query()method will send theMEASUrement:NOISe?query. - Using the
.verify(value)method will send theMEASUrement:NOISe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:NOISe valuecommand.
SCPI Syntax
- MEASUrement:NOISe {HIGH|LOW}
- MEASUrement:NOISe?
Info
HIGHargument causes the measurement for noise to be taken at the high level of the waveform.LOWargument causes the measurement for noise to be taken at the low level of the waveform.
reflevel
property
¶
reflevel: MeasurementReflevel
Return the MEASUrement:REFLevel command.
Description
- Returns the current reference level parameters.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:REFLevel?
Sub-properties
.absolute: TheMEASUrement:REFLevel:ABSolutecommand tree..method: TheMEASUrement:REFLevel:METHodcommand..percent: TheMEASUrement:REFLevel:PERCentcommand tree.
source1
property
¶
source1: MeasurementSource1
Return the MEASUrement:SOUrce1 command tree.
Usage
- Using the
.query()method will send theMEASUrement:SOUrce1?query. - Using the
.verify(value)method will send theMEASUrement:SOUrce1?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.sigtype: TheMEASUrement:SOUrce1:SIGTypecommand.
statistics
property
¶
statistics: MeasurementStatistics
Return the MEASUrement:STATIstics command tree.
Usage
- Using the
.query()method will send theMEASUrement:STATIstics?query. - Using the
.verify(value)method will send theMEASUrement:STATIstics?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.count: TheMEASUrement:STATIstics:COUNtcommand..mode: TheMEASUrement:STATIstics:MODecommand..weighting: TheMEASUrement:STATIstics:WEIghtingcommand.
MeasurementAnnotation
¶
Bases: SCPICmdRead
The MEASUrement:ANNOTation command tree.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.immedstate: TheMEASUrement:ANNOTation:IMMEDSTAtecommand..numx: TheMEASUrement:ANNOTation:NUMXcommand..numy: TheMEASUrement:ANNOTation:NUMYcommand..state: TheMEASUrement:ANNOTation:STATEcommand..type: TheMEASUrement:ANNOTation:TYPecommand..x: TheMEASUrement:ANNOTation:X<x>command..y: TheMEASUrement:ANNOTation:Y<x>command.
immedstate
property
¶
immedstate: MeasurementAnnotationImmedstate
Return the MEASUrement:ANNOTation:IMMEDSTAte command.
Description
- This command sets or queries the state of immediate measurement annotation. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:IMMEDSTAte?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:IMMEDSTAte?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:ANNOTation:IMMEDSTAte valuecommand.
SCPI Syntax
- MEASUrement:ANNOTation:IMMEDSTAte {ON|OFF|<NR1>}
- MEASUrement:ANNOTation:IMMEDSTAte?
Info
NR1= 0 disables immediate state measurement annotation, any other value enables immediate state measurements.OFFdisables annotation on immediate state measurements.ONenables annotation on immediate state measurements.
numx
property
¶
Return the MEASUrement:ANNOTation:NUMX command.
Description
- This query-only command returns the number of horizontal measurement annotations currently being displayed. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:NUMX?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:NUMX?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:NUMX?
numy
property
¶
Return the MEASUrement:ANNOTation:NUMY command.
Description
- This query-only command returns the number of vertical measurement annotations currently being displayed. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:NUMY?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:NUMY?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:NUMY?
state
property
¶
state: MeasurementAnnotationState
Return the MEASUrement:ANNOTation:STATE command.
Description
- This command sets or returns the state of visible measurement annotations.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:STATE?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:STATE?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:ANNOTation:STATE valuecommand.
SCPI Syntax
- MEASUrement:ANNOTation:STATE {OFF|MEAS<x>}
- MEASUrement:ANNOTation:STATE?
Info
OFFturns off visible measurement annotations.MEAS<x>turns on the display of visible measurement annotations for measurement, where can be 1, 2, 3, 4, 5, 6, 7, or 8. There must be an active measurement before you can activate an annotation for a specified measurement.
type
property
¶
Return the MEASUrement:ANNOTation:TYPe command.
Description
- This command sets or queries the type of annotations being used. This command is similar to setting the annotation type in the Measure > Annotation menu.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:TYPe?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:TYPe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:ANNOTation:TYPe valuecommand.
SCPI Syntax
- MEASUrement:ANNOTation:TYPe {STANdard|DETAiled}
- MEASUrement:ANNOTation:TYPe?
Info
STANdardsets the annotation type to STANDARD.DETAiledsets the annotation type to DETAiled, so that more detailed annotations are displayed.
x
property
¶
Return the MEASUrement:ANNOTation:X<x> command.
Description
- This query-only command returns the value of the specified X annotation. X annotations
are numbered, in general, from top to bottom on the display. The value of
can vary from 1 to 6. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:X<x>?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:X<x>?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:X<x>?
y
property
¶
Return the MEASUrement:ANNOTation:Y<x> command.
Description
- This query-only command returns the value of the specified Y annotation. Y annotations
are numbered, in general, from left to right on the display. The value of
can vary from 1 to 6. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:Y<x>?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:Y<x>?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:Y<x>?
MeasurementAnnotationImmedstate
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:ANNOTation:IMMEDSTAte command.
Description
- This command sets or queries the state of immediate measurement annotation. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:IMMEDSTAte?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:IMMEDSTAte?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:ANNOTation:IMMEDSTAte valuecommand.
SCPI Syntax
- MEASUrement:ANNOTation:IMMEDSTAte {ON|OFF|<NR1>}
- MEASUrement:ANNOTation:IMMEDSTAte?
Info
NR1= 0 disables immediate state measurement annotation, any other value enables immediate state measurements.OFFdisables annotation on immediate state measurements.ONenables annotation on immediate state measurements.
MeasurementAnnotationNumx
¶
Bases: SCPICmdRead
The MEASUrement:ANNOTation:NUMX command.
Description
- This query-only command returns the number of horizontal measurement annotations currently being displayed. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:NUMX?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:NUMX?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:NUMX?
MeasurementAnnotationNumy
¶
Bases: SCPICmdRead
The MEASUrement:ANNOTation:NUMY command.
Description
- This query-only command returns the number of vertical measurement annotations currently being displayed. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:NUMY?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:NUMY?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:NUMY?
MeasurementAnnotationState
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:ANNOTation:STATE command.
Description
- This command sets or returns the state of visible measurement annotations.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:STATE?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:STATE?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:ANNOTation:STATE valuecommand.
SCPI Syntax
- MEASUrement:ANNOTation:STATE {OFF|MEAS<x>}
- MEASUrement:ANNOTation:STATE?
Info
OFFturns off visible measurement annotations.MEAS<x>turns on the display of visible measurement annotations for measurement, where can be 1, 2, 3, 4, 5, 6, 7, or 8. There must be an active measurement before you can activate an annotation for a specified measurement.
MeasurementAnnotationType
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:ANNOTation:TYPe command.
Description
- This command sets or queries the type of annotations being used. This command is similar to setting the annotation type in the Measure > Annotation menu.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:TYPe?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:TYPe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:ANNOTation:TYPe valuecommand.
SCPI Syntax
- MEASUrement:ANNOTation:TYPe {STANdard|DETAiled}
- MEASUrement:ANNOTation:TYPe?
Info
STANdardsets the annotation type to STANDARD.DETAiledsets the annotation type to DETAiled, so that more detailed annotations are displayed.
MeasurementAnnotationXItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdRead
The MEASUrement:ANNOTation:X<x> command.
Description
- This query-only command returns the value of the specified X annotation. X annotations are
numbered, in general, from top to bottom on the display. The value of
can vary from 1 to 6. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:X<x>?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:X<x>?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:X<x>?
MeasurementAnnotationYItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdRead
The MEASUrement:ANNOTation:Y<x> command.
Description
- This query-only command returns the value of the specified Y annotation. Y annotations are
numbered, in general, from left to right on the display. The value of
can vary from 1 to 6. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:ANNOTation:Y<x>?query. - Using the
.verify(value)method will send theMEASUrement:ANNOTation:Y<x>?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:ANNOTation:Y<x>?
MeasurementDpojetstatistics
¶
Bases: SCPICmdRead
The MEASUrement:DPOJETSTATistics command.
Description
- This queries the DPOJET measurement statistics.
Usage
- Using the
.query()method will send theMEASUrement:DPOJETSTATistics?query. - Using the
.verify(value)method will send theMEASUrement:DPOJETSTATistics?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:DPOJETSTATistics?
MeasurementGating
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:GATing command.
Description
- This command specifies or returns the measurement gating setting. This command is equivalent to selecting Gating from the Measure menu and then clicking the desired Measurement Gating setting.
Usage
- Using the
.query()method will send theMEASUrement:GATing?query. - Using the
.verify(value)method will send theMEASUrement:GATing?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:GATing valuecommand.
SCPI Syntax
- MEASUrement:GATing {ON|OFF|<NR1>|ZOOM<x>|CURSor}
- MEASUrement:GATing?
Info
ONturns on measurement gating.OFFturns off measurement gating.<NR1>= 0 turns off measurement gating; any other value turns on measurement gating.ZOOM<x>turns on gating, using the left and right edges of the zoom box.specifies the zoom window, which ranges from 1 through 4. CURSORlimits measurements to the portion of the waveform between the vertical bar cursors, even if they are off screen.
MeasurementImmed
¶
Bases: SCPICmdRead
The MEASUrement:IMMed command.
Description
- Returns all immediate measurement setup parameters.
Usage
- Using the
.query()method will send theMEASUrement:IMMed?query. - Using the
.verify(value)method will send theMEASUrement:IMMed?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed?
Properties
.delay: TheMEASUrement:IMMed:DELaycommand..method: TheMEASUrement:IMMed:METHodcommand..noise: TheMEASUrement:IMMed:NOISecommand..reflevel: TheMEASUrement:IMMed:REFLevelcommand..source1: TheMEASUrement:IMMed:SOUrce1command..type: TheMEASUrement:IMMed:TYPecommand..units: TheMEASUrement:IMMed:UNItscommand..value: TheMEASUrement:IMMed:VALuecommand.
delay
property
¶
delay: MeasurementImmedDelay
Return the MEASUrement:IMMed:DELay command.
Description
- Returns information about the immediate delay measurement. This command is equivalent to viewing the delay measurement settings on the measurement readout.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:DELay?
Sub-properties
.direction: TheMEASUrement:IMMed:DELay:DIREctioncommand..edge2: TheMEASUrement:IMMed:DELay:EDGE2command..edge: TheMEASUrement:IMMed:DELay:EDGE<x>command.
method
property
¶
method: MeasurementImmedMethod
Return the MEASUrement:IMMed:METHod command.
Description
- This command specifies or queries the method used to calculate the 0% and 100% reference level for immediate measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:METHod?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:METHod valuecommand.
SCPI Syntax
- MEASUrement:IMMed:METHod {HIStogram|MINMax|MEAN}
- MEASUrement:IMMed:METHod?
Info
HIStogramsets the high and low waveform levels statistically using a histogram algorithm.MINMaxsets the high and low waveform levels to MAX and MIN, respectively.MEANsets the high and low waveform levels to their mean.
noise
property
¶
noise: MeasurementImmedNoise
Return the MEASUrement:IMMed:NOISe command.
Description
- This command sets or queries whether the noise measurement is made on the high or low
level of the waveform. Sending this command is equivalent to selecting Ref Levs > Eye
Top Level or Base Level in the Comm tab of the Measurement Setup dialog box. The Eye section is displayed only if you have an eye-pattern or optical measurement defined.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:NOISe?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:NOISe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:NOISe valuecommand.
SCPI Syntax
- MEASUrement:IMMed:NOISe {HIGH|LOW}
- MEASUrement:IMMed:NOISe?
Info
HIGHargument causes the measurement for noise to be taken at the high level of the waveform.LOWargument causes the measurement for noise to be taken at the low level of the waveform.
reflevel
property
¶
reflevel: MeasurementImmedReflevel
Return the MEASUrement:IMMed:REFLevel command.
Description
- This query-only command returns the reference level settings for the immediate measurement. It returns them in the following order: ABSOLUTE and then PERCENT for individual user measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:REFLevel?
Sub-properties
.absolute: TheMEASUrement:IMMed:REFLevel:ABSolutecommand tree..method: TheMEASUrement:IMMed:REFLevel:METHodcommand..percent: TheMEASUrement:IMMed:REFLevel:PERCentcommand tree.
source1
property
¶
source1: MeasurementImmedSource1
Return the MEASUrement:IMMed:SOUrce1 command.
Description
- This command sets or queries the source for phase or delay immediate measurements. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Source1 (From) setting or Source2 (To) setting. Tip: Source2 measurements only apply to phase and delay measurement types, which require both a target (Source1) and reference (Source2) source.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:SOUrce1?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:SOUrce1?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:SOUrce1 valuecommand.
SCPI Syntax
- MEASUrement:IMMed:SOUrce1 {CH<x>|MATH<y>|REF<x>|HIStogram}
- MEASUrement:IMMed:SOUrce1?
Info
CH<x>is an input channel waveform. The x variable can be expressed as an integer ranging from 1 through 4.MATH<y>is a math waveform. The y variable can be expressed as an integer ranging from 1 through 4.REF<X>is a reference waveform. The x variable can be expressed as an integer ranging from 1 through 4.HIStogramindicates histogram as the object to be measured. HIStogram not allowed on SOUrce2.
Sub-properties
.sigtype: TheMEASUrement:IMMed:SOUrce1:SIGTypecommand.
type
property
¶
type: MeasurementImmedType
Return the MEASUrement:IMMed:TYPe command.
Description
- This command sets or queries the immediate measurement type. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:TYPe?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:TYPe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:TYPe valuecommand.
SCPI Syntax
- MEASUrement:IMMed:TYPe {AMPlitude|AREa|BURst|CARea|CMEan|CRMs|DELay|DISTDUty|EXTINCTDB|EXTINCTPCT|EXTINCTRATIO|EYEHeight|EYEWIdth|FALL|FREQuency|HIGH|HITs|LOW|MAXimum|MEAN|MEDian|MINImum|NCROss|NDUty|NOVershoot|NWIdth|PBASe|PCROss|PCTCROss|PDUty|PEAKHits|PERIod|PHAse|PK2Pk|PKPKJitter|PKPKNoise|POVershoot|PTOP|PWIdth|QFACtor|RISe|RMS|RMSJitter|RMSNoise|SIGMA1|SIGMA2|SIGMA3|SIXSigmajit|SNRatio|STDdev|UNDEFINED|WAVEFORMS}
- MEASUrement:IMMed:TYPe?
Info
AMPlitudemeasures the amplitude of the selected waveform. In other words, it measures the high value less the low value measured over the entire waveform or gated region.Amplitude = High - LowAREameasures the voltage over time. The area is over the entire waveform or gated region and is measured in volt-seconds. The area measured above the ground is positive, while the area below ground is negative.BURstmeasures the duration of a burst. The measurement is made over the entire waveform or gated region.CARea(cycle area) measures the voltage over time. In other words, it measures in volt-seconds, the area over the first cycle in the waveform or the first cycle in the gated region. The area measured above the common reference point is positive, while the area below the common reference point is negative.CMEan(cycle mean) measures the arithmetic mean over the first cycle in the waveform or the first cycle in the gated region.CRMs(cycle rms) measures the true Root Mean Square voltage over the first cycle in the waveform or the first cycle in the gated region.DELaymeasures the time between the middle reference (default = 50%) amplitude point of the source waveform and the destination waveform.DISTDUty(duty cycle distortion) measures the time between the falling edge and the rising edge of the eye pattern at the mid reference level. It is the peak-to-peak time variation of the first eye crossing measured at the mid-reference as a percent of the eye period.EXTINCTDBmeasures the extinction ratio of an optical waveform (eye diagram). Extinction Ratio (dB) measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result in dB. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction dB = 10 × (log 10 (High / Low)EXTINCTPCTmeasures the extinction ratio of the selected optical waveform. Extinction Ratio (%) measures the ratio of the average power levels for the logic Low (off) to the logic (High) (on) of an optical waveform and expresses the result in percent. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction % = 100.0 × (Low / High)EXTINCTRATIOmeasures the extinction ratio of the selected optical waveform. Extinction Ratio measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result without units. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode. Extinction ratios greater than 100 or less than 1 generate errors; low must be greater than or equal to 1 µW.Extinction Ratio = (High / Low)EYEHeightmeasures the vertical opening of an eye diagram in volts.EYEWidthmeasures the width of an eye diagram in seconds.FALLmeasures the time taken for the falling edge of the first pulse in the waveform or gated region to fall from a high reference value (default is 90%) to a low reference value (default is 10%).FREQuencymeasures the first cycle in the waveform or gated region. Frequency is the reciprocal of the period and is measured in hertz (Hz), where 1 Hz = 1 cycle per second.HIGHmeasures the High reference (100% level, sometimes called Topline) of a waveform.HITs(histogram hits) measures the number of points in or on the histogram box.LOWmeasures the Low reference (0% level, sometimes called Baseline) of a waveform.MAXimumfinds the maximum amplitude. This value is the most positive peak voltage found. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the maximum measurement measures the voltage of the highest nonzero bin in vertical histograms or the time of the right-most bin in horizontal histograms.MEANamplitude measurement finds the arithmetic mean over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the mean measurement measures the average of all acquired points within or on the histogram.MEDian(histogram measurement) measures the middle point of the histogram box. Half of all acquired points within or on the histogram box are less than this value and half are greater than this value.MINImumfinds the minimum amplitude. This value is typically the most negative peak voltage. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the minimum measurement measures the lowest nonzero bin in vertical histograms or the time of the left-most nonzero bin in the horizontal histograms.NCROss(timing measurement) measures the time from the trigger point to the first falling edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.NDUty(negative duty cycle) is the ratio of the negative pulse width to the signal period, expressed as a percentage. The duty cycle is measured on the first cycle in the waveform or gated region.Negative Duty Cycle = (Negative Width) / Period × 100%NOVershoot(negative overshoot) finds the negative overshoot value over the entire waveform or gated region.Negative Overshoot = (Low - Minimum) / Amplitude × 100%)NWIdth(negative width) measurement is the distance (time) between the middle reference (default = 50%) amplitude points of a negative pulse. The measurement is made on the first pulse in the waveform or gated region.PBASemeasures the base value used in extinction ratio measurements.PCROss(timing measurement) measures the time from the trigger point to the first positive edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.PCTCROssmeasures the location of the eye crossing point expressed as a percentage of EYEHeight.Crossing percent = 100 ×[(eye-crossing-point - PBASe)/(PTOP - PBASe)]PDUty(positive duty cycle) is the ratio of the positive pulse width to the signal period, expressed as a percentage. It is measured on the first cycle in the waveform or gated region.Positive Duty Cycle = (Positive Width)/Period × 100%PEAKHitsmeasures the number of points in the largest bin of the histogram.PERIodis the time required to complete the first cycle in a waveform or gated region. Period is the reciprocal of frequency and is measured in seconds.PHAsemeasures the phase difference (amount of time a waveform leads or lags the reference waveform) between two waveforms. The measurement is made between the middle reference points of the two waveforms and is expressed in degrees, where 360° represents one waveform cycle.PK2Pk(peak-to-peak) finds the absolute difference between the maximum and minimum amplitude in the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the PK2Pk measurement measures the histogram peak to peak difference.PKPKJittermeasures the variance (minimum and maximum values) in the time locations of the cross point.PKPKNoisemeasures the peak-to-peak noise on a waveform at the mid reference level.POVershootPositive Overshoot = (Maximum - High) / Amplitude ×100%PTOTmeasures the top value used in extinction ratio measurements.PWIdth(positive width) is the distance (time) between the middle reference (default = 50%) amplitude points of a positive pulse. The measurement is made on the first pulse in the waveform or gated region.QFACtormeasures the quality factor. The Q factor is a figure of merit for an eye diagram, which indicates the vertical eye opening relative to the noise at the low and high logic levels. It is the ratio of the eye size to noise.RISetiming measurement finds the rise time of the waveform. The rise time is the time it takes for the leading edge of the first pulse encountered to rise from a low reference value (defaul t is 10%) to a high reference value (default is 90%).RMSamplitude measurement finds the true Root Mean Square voltage in the entire waveform or gated region.RMSJittermeasures the variance in the time locations of the cross point. The RMS jitter is defined as one standard deviation at the cross point.RMSNoisemeasures the Root Mean Square noise amplitude on a waveform at the mid reference level.SIGMA1(histogram measurement) measures the percentage of points in the histogram that are within one standard deviation of the histogram mean.SIGMA2(histogram measurement) measures the percentage of points in the histogram that are within two standard deviations of the histogram mean.SIGMA3(histogram measurement) measures the percentage of points in the histogram that are within three standard deviations of the histogram mean.SIXSigmajit(histogram measurement) is six × RMSJitter.SNRatiomeasures the signal-to-noise ratio. The signal-to-noise ratio is the amplitude of a noise rejection band centered on the mid level.STDdevmeasures the standard deviation (Root Mean Square (RMS) deviation) of all acquired points within or on the histogram box.UNDEFINEDis the default measurement type, which indicates that no measurement type is specified. Once a measurement type is chosen, it can be cleared using this argument.WAVEFORMS(waveform count) measures the number of waveforms used to calculate the histogram.
units
property
¶
units: MeasurementImmedUnits
Return the MEASUrement:IMMed:UNIts command.
Description
- Returns a string containing the units of the immediate measurement.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:UNIts?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:UNIts?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:UNIts?
value
property
¶
value: MeasurementImmedValue
Return the MEASUrement:IMMed:VALue command.
Description
- Returns the value of the measurement specified by the
MEASUREMENT:IMMED:TYPEcommand. The measurement is immediately taken on the source(s) specified by aMEASUREMENT:IMMED:SOURCEXcommand.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:VALue?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:VALue?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:VALue?
MeasurementImmedDelay
¶
Bases: SCPICmdRead
The MEASUrement:IMMed:DELay command.
Description
- Returns information about the immediate delay measurement. This command is equivalent to viewing the delay measurement settings on the measurement readout.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:DELay?
Properties
.direction: TheMEASUrement:IMMed:DELay:DIREctioncommand..edge2: TheMEASUrement:IMMed:DELay:EDGE2command..edge: TheMEASUrement:IMMed:DELay:EDGE<x>command.
direction
property
¶
direction: MeasurementImmedDelayDirection
Return the MEASUrement:IMMed:DELay:DIREction command.
Description
- This command sets or returns the starting point and direction that determines the
delay ‘to’ edge when taking an immediate delay measurement. Use the
MEASUREMENT:IMMED:SOURCEXcommand to specify the delay ‘to’ waveform. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Search Direction setting.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay:DIREction?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay:DIREction?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:DELay:DIREction valuecommand.
SCPI Syntax
- MEASUrement:IMMed:DELay:DIREction {BACKWards|FORWards}
- MEASUrement:IMMed:DELay:DIREction?
Info
BACKWardsstarts the search at the end of the waveform and looks for the last rising or falling edge in the waveform.FORWardsstarts the search at the beginning of the waveform and looks for the first rising or falling edge in the waveform.
edge
property
¶
edge: dict[int, MeasurementImmedDelayEdgeItem]
Return the MEASUrement:IMMed:DELay:EDGE<x> command.
Description
- This command specifies the slope of the edge the oscilloscope uses for the delay ‘from’ or ‘to’ waveform when taking an immediate delay measurement.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay:EDGE<x>?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay:EDGE<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:DELay:EDGE<x> valuecommand.
SCPI Syntax
- MEASUrement:IMMed:DELay:EDGE<x> {FALL|RISe}
- MEASUrement:IMMed:DELay:EDGE<x>?
Info
<x>specifies which waveform to use, where= 1 is the ‘from’ waveform, and = 2 is the ‘to’ waveform. FALLspecifies the falling edge.RISespecifies the rising edge.
edge2
property
¶
edge2: MeasurementImmedDelayEdge2
Return the MEASUrement:IMMed:DELay:EDGE2 command.
Description
- This command sets or queries the slope of the edge that is used for the delay ‘to’
waveform when taking an immediate delay measurement. Use the
MEASUREMENT:IMMED:SOURCEXcommand to specify the waveform. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Delay Edge2 setting.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay:EDGE2?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay:EDGE2?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:DELay:EDGE2 valuecommand.
SCPI Syntax
- MEASUrement:IMMed:DELay:EDGE2 {FALL|RISe}
- MEASUrement:IMMed:DELay:EDGE2?
Info
FALLspecifies the falling edge.RISespecifies the rising edge.
MeasurementImmedDelayDirection
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:DELay:DIREction command.
Description
- This command sets or returns the starting point and direction that determines the delay
‘to’ edge when taking an immediate delay measurement. Use the
MEASUREMENT:IMMED:SOURCEXcommand to specify the delay ‘to’ waveform. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Search Direction setting.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay:DIREction?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay:DIREction?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:DELay:DIREction valuecommand.
SCPI Syntax
- MEASUrement:IMMed:DELay:DIREction {BACKWards|FORWards}
- MEASUrement:IMMed:DELay:DIREction?
Info
BACKWardsstarts the search at the end of the waveform and looks for the last rising or falling edge in the waveform.FORWardsstarts the search at the beginning of the waveform and looks for the first rising or falling edge in the waveform.
MeasurementImmedDelayEdge2
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:DELay:EDGE2 command.
Description
- This command sets or queries the slope of the edge that is used for the delay ‘to’
waveform when taking an immediate delay measurement. Use the
MEASUREMENT:IMMED:SOURCEXcommand to specify the waveform. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Delay Edge2 setting.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay:EDGE2?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay:EDGE2?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:DELay:EDGE2 valuecommand.
SCPI Syntax
- MEASUrement:IMMed:DELay:EDGE2 {FALL|RISe}
- MEASUrement:IMMed:DELay:EDGE2?
Info
FALLspecifies the falling edge.RISespecifies the rising edge.
MeasurementImmedDelayEdgeItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:DELay:EDGE<x> command.
Description
- This command specifies the slope of the edge the oscilloscope uses for the delay ‘from’ or ‘to’ waveform when taking an immediate delay measurement.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:DELay:EDGE<x>?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:DELay:EDGE<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:DELay:EDGE<x> valuecommand.
SCPI Syntax
- MEASUrement:IMMed:DELay:EDGE<x> {FALL|RISe}
- MEASUrement:IMMed:DELay:EDGE<x>?
Info
<x>specifies which waveform to use, where= 1 is the ‘from’ waveform, and = 2 is the ‘to’ waveform. FALLspecifies the falling edge.RISespecifies the rising edge.
MeasurementImmedMethod
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:METHod command.
Description
- This command specifies or queries the method used to calculate the 0% and 100% reference level for immediate measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:METHod?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:METHod valuecommand.
SCPI Syntax
- MEASUrement:IMMed:METHod {HIStogram|MINMax|MEAN}
- MEASUrement:IMMed:METHod?
Info
HIStogramsets the high and low waveform levels statistically using a histogram algorithm.MINMaxsets the high and low waveform levels to MAX and MIN, respectively.MEANsets the high and low waveform levels to their mean.
MeasurementImmedNoise
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:NOISe command.
Description
- This command sets or queries whether the noise measurement is made on the high or low level of the waveform. Sending this command is equivalent to selecting Ref Levs > Eye > Top Level or Base Level in the Comm tab of the Measurement Setup dialog box. The Eye section is displayed only if you have an eye-pattern or optical measurement defined.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:NOISe?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:NOISe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:NOISe valuecommand.
SCPI Syntax
- MEASUrement:IMMed:NOISe {HIGH|LOW}
- MEASUrement:IMMed:NOISe?
Info
HIGHargument causes the measurement for noise to be taken at the high level of the waveform.LOWargument causes the measurement for noise to be taken at the low level of the waveform.
MeasurementImmedReflevel
¶
Bases: SCPICmdRead
The MEASUrement:IMMed:REFLevel command.
Description
- This query-only command returns the reference level settings for the immediate measurement. It returns them in the following order: ABSOLUTE and then PERCENT for individual user measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:REFLevel?
Properties
.absolute: TheMEASUrement:IMMed:REFLevel:ABSolutecommand tree..method: TheMEASUrement:IMMed:REFLevel:METHodcommand..percent: TheMEASUrement:IMMed:REFLevel:PERCentcommand tree.
absolute
property
¶
absolute: MeasurementImmedReflevelAbsolute
Return the MEASUrement:IMMed:REFLevel:ABSolute command tree.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.high: TheMEASUrement:IMMed:REFLevel:ABSolute:HIGHcommand..low: TheMEASUrement:IMMed:REFLevel:ABSolute:LOWcommand..mid: TheMEASUrement:IMMed:REFLevel:ABSolute:MID<x>command.
method
property
¶
method: MeasurementImmedReflevelMethod
Return the MEASUrement:IMMed:REFLevel:METHod command.
Description
- This command specifies or queries the reference level units used for measurement calculations. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired reference level from the Units group box.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:METHod?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:METHod valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:IMMed:REFLevel:METHod?
Info
ABSolutespecifies that the reference levels are set explicitly using theMEASUrement:IMMed:REFLevel:ABSolutecommands. This method is useful when precise values are required. For instance, when designing to published interface specifications, such as RS-232-C.PERCentspecifies that the reference levels are calculated as a percent relative to HIGH and LOW. The percentages are defined using theMEASUrement:IMMed:REFLevel:PERCentcommands.
percent
property
¶
percent: MeasurementImmedReflevelPercent
Return the MEASUrement:IMMed:REFLevel:PERCent command tree.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.high: TheMEASUrement:IMMed:REFLevel:PERCent:HIGHcommand..low: TheMEASUrement:IMMed:REFLevel:PERCent:LOWcommand..mid: TheMEASUrement:IMMed:REFLevel:PERCent:MID<x>command.
MeasurementImmedReflevelAbsolute
¶
Bases: SCPICmdRead
The MEASUrement:IMMed:REFLevel:ABSolute command tree.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.high: TheMEASUrement:IMMed:REFLevel:ABSolute:HIGHcommand..low: TheMEASUrement:IMMed:REFLevel:ABSolute:LOWcommand..mid: TheMEASUrement:IMMed:REFLevel:ABSolute:MID<x>command.
high
property
¶
Return the MEASUrement:IMMed:REFLevel:ABSolute:HIGH command.
Description
- This command sets or queries the high reference level, and is the upper reference
level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Absolute. Note that this command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:HIGH valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:HIGH?
Info
<NR3>is the high reference level in volts. The default is 0.0 V.
low
property
¶
Return the MEASUrement:IMMed:REFLevel:ABSolute:LOW command.
Description
- This command sets or queries the low reference level, and is the zero percent level
when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Absolute. Note that this command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute:LOW?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:LOW valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:LOW?
Info
<NR3>is the low reference level in volts. The default is 0.0 V.
mid
property
¶
Return the MEASUrement:IMMed:REFLevel:ABSolute:MID<x> command.
Description
- This command sets or queries the mid reference level, and is the 50% reference level
when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Absolute. Note that this command affects the results of period, frequency, delay, and all cyclic measurements. Note that this command affects the results of delay measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:MID<x>?
Info
<NR3>is the mid1 (the ‘from’ waveform when taking a delay measurement) or mid2 (the ‘to’ waveform when taking a delay measurement) reference level in volts. The default is 0.0 V.
MeasurementImmedReflevelAbsoluteHigh
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:REFLevel:ABSolute:HIGH command.
Description
- This command sets or queries the high reference level, and is the upper reference level
when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Absolute. Note that this command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:HIGH valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:HIGH?
Info
<NR3>is the high reference level in volts. The default is 0.0 V.
MeasurementImmedReflevelAbsoluteLow
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:REFLevel:ABSolute:LOW command.
Description
- This command sets or queries the low reference level, and is the zero percent level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Absolute. Note that this command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute:LOW?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:LOW valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:LOW?
Info
<NR3>is the low reference level in volts. The default is 0.0 V.
MeasurementImmedReflevelAbsoluteMidItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:REFLevel:ABSolute:MID<x> command.
Description
- This command sets or queries the mid reference level, and is the 50% reference level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Absolute. Note that this command affects the results of period, frequency, delay, and all cyclic measurements. Note that this command affects the results of delay measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:ABSolute:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:ABSolute:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:IMMed:REFLevel:ABSolute:MID<x>?
Info
<NR3>is the mid1 (the ‘from’ waveform when taking a delay measurement) or mid2 (the ‘to’ waveform when taking a delay measurement) reference level in volts. The default is 0.0 V.
MeasurementImmedReflevelMethod
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:REFLevel:METHod command.
Description
- This command specifies or queries the reference level units used for measurement calculations. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired reference level from the Units group box.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:METHod?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:METHod valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:IMMed:REFLevel:METHod?
Info
ABSolutespecifies that the reference levels are set explicitly using theMEASUrement:IMMed:REFLevel:ABSolutecommands. This method is useful when precise values are required. For instance, when designing to published interface specifications, such as RS-232-C.PERCentspecifies that the reference levels are calculated as a percent relative to HIGH and LOW. The percentages are defined using theMEASUrement:IMMed:REFLevel:PERCentcommands.
MeasurementImmedReflevelPercent
¶
Bases: SCPICmdRead
The MEASUrement:IMMed:REFLevel:PERCent command tree.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.high: TheMEASUrement:IMMed:REFLevel:PERCent:HIGHcommand..low: TheMEASUrement:IMMed:REFLevel:PERCent:LOWcommand..mid: TheMEASUrement:IMMed:REFLevel:PERCent:MID<x>command.
high
property
¶
Return the MEASUrement:IMMed:REFLevel:PERCent:HIGH command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the high reference level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Percent. Note that this command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:HIGH valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:PERCent:HIGH <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:HIGH?
Info
<NR1>is the high reference level, ranging from 0 to 100%. The default high reference level is 90%.
low
property
¶
Return the MEASUrement:IMMed:REFLevel:PERCent:LOW command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the low reference level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Percent. Note that this command affects the results of rise and fall measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Percentage Low Ref value.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent:LOW?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:LOW valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:PERCent:LOW <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:LOW?
Info
<NR1>is the low reference level, ranging from 0 to 100%. The default low reference level is 10%.
mid
property
¶
Return the MEASUrement:IMMed:REFLevel:PERCent:MID<x> command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the mid reference level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Percent. Mid1 is for the first waveform specified, and Mid2 is for the second waveform specified. Note that this command affects the results of delay measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:PERCent:MID<x> <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:MID<x>?
Info
<NR1>is the mid reference level, ranging from 0 to 100%. The default mid reference level is 50%.
MeasurementImmedReflevelPercentHigh
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:REFLevel:PERCent:HIGH command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the high reference level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Percent. Note that this command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:HIGH valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:PERCent:HIGH <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:HIGH?
Info
<NR1>is the high reference level, ranging from 0 to 100%. The default high reference level is 90%.
MeasurementImmedReflevelPercentLow
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:REFLevel:PERCent:LOW command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the low reference level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Percent. Note that this command affects the results of rise and fall measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Percentage Low Ref value.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent:LOW?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:LOW valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:PERCent:LOW <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:LOW?
Info
<NR1>is the low reference level, ranging from 0 to 100%. The default low reference level is 10%.
MeasurementImmedReflevelPercentMidItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:REFLevel:PERCent:MID<x> command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the mid reference level when
MEASUREMENT:IMMED:REFLEVEL:METHODis set to Percent. Mid1 is for the first waveform specified, and Mid2 is for the second waveform specified. Note that this command affects the results of delay measurements.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:REFLevel:PERCent:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:REFLevel:PERCent:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:IMMed:REFLevel:PERCent:MID<x> <NR1>
- MEASUrement:IMMed:REFLevel:PERCent:MID<x>?
Info
<NR1>is the mid reference level, ranging from 0 to 100%. The default mid reference level is 50%.
MeasurementImmedSource1
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:SOUrce1 command.
Description
- This command sets or queries the source for phase or delay immediate measurements. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Source1 (From) setting or Source2 (To) setting. Tip: Source2 measurements only apply to phase and delay measurement types, which require both a target (Source1) and reference (Source2) source.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:SOUrce1?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:SOUrce1?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:SOUrce1 valuecommand.
SCPI Syntax
- MEASUrement:IMMed:SOUrce1 {CH<x>|MATH<y>|REF<x>|HIStogram}
- MEASUrement:IMMed:SOUrce1?
Info
CH<x>is an input channel waveform. The x variable can be expressed as an integer ranging from 1 through 4.MATH<y>is a math waveform. The y variable can be expressed as an integer ranging from 1 through 4.REF<X>is a reference waveform. The x variable can be expressed as an integer ranging from 1 through 4.HIStogramindicates histogram as the object to be measured. HIStogram not allowed on SOUrce2.
Properties
.sigtype: TheMEASUrement:IMMed:SOUrce1:SIGTypecommand.
sigtype
property
¶
sigtype: MeasurementImmedSource1Sigtype
Return the MEASUrement:IMMed:SOUrce1:SIGType command.
Description
- This command sets or queries the type of input signal used for measurement SOURCE
, 1 or 2. To ensure accurate measurements, use this command to specify the input-signal type for the measurement source.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:SOUrce1:SIGType?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:SOUrce1:SIGType?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:SOUrce1:SIGType valuecommand.
SCPI Syntax
- MEASUrement:IMMed:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:IMMed:SOUrce1:SIGType?
Info
PULSEis for generic signals that are not associated with synchronous communications standards.EYEis for synchronous-communication signals with NRZ-like characteristics (nonreturn to zero).
MeasurementImmedSource1Sigtype
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:SOUrce1:SIGType command.
Description
- This command sets or queries the type of input signal used for measurement SOURCE
, 1 or 2. To ensure accurate measurements, use this command to specify the input-signal type for the measurement source.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:SOUrce1:SIGType?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:SOUrce1:SIGType?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:SOUrce1:SIGType valuecommand.
SCPI Syntax
- MEASUrement:IMMed:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:IMMed:SOUrce1:SIGType?
Info
PULSEis for generic signals that are not associated with synchronous communications standards.EYEis for synchronous-communication signals with NRZ-like characteristics (nonreturn to zero).
MeasurementImmedType
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:IMMed:TYPe command.
Description
- This command sets or queries the immediate measurement type. Immediate measurements and annotations are not displayed on the screen.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:TYPe?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:TYPe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:IMMed:TYPe valuecommand.
SCPI Syntax
- MEASUrement:IMMed:TYPe {AMPlitude|AREa|BURst|CARea|CMEan|CRMs|DELay|DISTDUty|EXTINCTDB|EXTINCTPCT|EXTINCTRATIO|EYEHeight|EYEWIdth|FALL|FREQuency|HIGH|HITs|LOW|MAXimum|MEAN|MEDian|MINImum|NCROss|NDUty|NOVershoot|NWIdth|PBASe|PCROss|PCTCROss|PDUty|PEAKHits|PERIod|PHAse|PK2Pk|PKPKJitter|PKPKNoise|POVershoot|PTOP|PWIdth|QFACtor|RISe|RMS|RMSJitter|RMSNoise|SIGMA1|SIGMA2|SIGMA3|SIXSigmajit|SNRatio|STDdev|UNDEFINED|WAVEFORMS}
- MEASUrement:IMMed:TYPe?
Info
AMPlitudemeasures the amplitude of the selected waveform. In other words, it measures the high value less the low value measured over the entire waveform or gated region.Amplitude = High - LowAREameasures the voltage over time. The area is over the entire waveform or gated region and is measured in volt-seconds. The area measured above the ground is positive, while the area below ground is negative.BURstmeasures the duration of a burst. The measurement is made over the entire waveform or gated region.CARea(cycle area) measures the voltage over time. In other words, it measures in volt-seconds, the area over the first cycle in the waveform or the first cycle in the gated region. The area measured above the common reference point is positive, while the area below the common reference point is negative.CMEan(cycle mean) measures the arithmetic mean over the first cycle in the waveform or the first cycle in the gated region.CRMs(cycle rms) measures the true Root Mean Square voltage over the first cycle in the waveform or the first cycle in the gated region.DELaymeasures the time between the middle reference (default = 50%) amplitude point of the source waveform and the destination waveform.DISTDUty(duty cycle distortion) measures the time between the falling edge and the rising edge of the eye pattern at the mid reference level. It is the peak-to-peak time variation of the first eye crossing measured at the mid-reference as a percent of the eye period.EXTINCTDBmeasures the extinction ratio of an optical waveform (eye diagram). Extinction Ratio (dB) measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result in dB. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction dB = 10 × (log 10 (High / Low)EXTINCTPCTmeasures the extinction ratio of the selected optical waveform. Extinction Ratio (%) measures the ratio of the average power levels for the logic Low (off) to the logic (High) (on) of an optical waveform and expresses the result in percent. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction % = 100.0 × (Low / High)EXTINCTRATIOmeasures the extinction ratio of the selected optical waveform. Extinction Ratio measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result without units. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode. Extinction ratios greater than 100 or less than 1 generate errors; low must be greater than or equal to 1 µW.Extinction Ratio = (High / Low)EYEHeightmeasures the vertical opening of an eye diagram in volts.EYEWidthmeasures the width of an eye diagram in seconds.FALLmeasures the time taken for the falling edge of the first pulse in the waveform or gated region to fall from a high reference value (default is 90%) to a low reference value (default is 10%).FREQuencymeasures the first cycle in the waveform or gated region. Frequency is the reciprocal of the period and is measured in hertz (Hz), where 1 Hz = 1 cycle per second.HIGHmeasures the High reference (100% level, sometimes called Topline) of a waveform.HITs(histogram hits) measures the number of points in or on the histogram box.LOWmeasures the Low reference (0% level, sometimes called Baseline) of a waveform.MAXimumfinds the maximum amplitude. This value is the most positive peak voltage found. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the maximum measurement measures the voltage of the highest nonzero bin in vertical histograms or the time of the right-most bin in horizontal histograms.MEANamplitude measurement finds the arithmetic mean over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the mean measurement measures the average of all acquired points within or on the histogram.MEDian(histogram measurement) measures the middle point of the histogram box. Half of all acquired points within or on the histogram box are less than this value and half are greater than this value.MINImumfinds the minimum amplitude. This value is typically the most negative peak voltage. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the minimum measurement measures the lowest nonzero bin in vertical histograms or the time of the left-most nonzero bin in the horizontal histograms.NCROss(timing measurement) measures the time from the trigger point to the first falling edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.NDUty(negative duty cycle) is the ratio of the negative pulse width to the signal period, expressed as a percentage. The duty cycle is measured on the first cycle in the waveform or gated region.Negative Duty Cycle = (Negative Width) / Period × 100%NOVershoot(negative overshoot) finds the negative overshoot value over the entire waveform or gated region.Negative Overshoot = (Low - Minimum) / Amplitude × 100%)NWIdth(negative width) measurement is the distance (time) between the middle reference (default = 50%) amplitude points of a negative pulse. The measurement is made on the first pulse in the waveform or gated region.PBASemeasures the base value used in extinction ratio measurements.PCROss(timing measurement) measures the time from the trigger point to the first positive edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.PCTCROssmeasures the location of the eye crossing point expressed as a percentage of EYEHeight.Crossing percent = 100 ×[(eye-crossing-point - PBASe)/(PTOP - PBASe)]PDUty(positive duty cycle) is the ratio of the positive pulse width to the signal period, expressed as a percentage. It is measured on the first cycle in the waveform or gated region.Positive Duty Cycle = (Positive Width)/Period × 100%PEAKHitsmeasures the number of points in the largest bin of the histogram.PERIodis the time required to complete the first cycle in a waveform or gated region. Period is the reciprocal of frequency and is measured in seconds.PHAsemeasures the phase difference (amount of time a waveform leads or lags the reference waveform) between two waveforms. The measurement is made between the middle reference points of the two waveforms and is expressed in degrees, where 360° represents one waveform cycle.PK2Pk(peak-to-peak) finds the absolute difference between the maximum and minimum amplitude in the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the PK2Pk measurement measures the histogram peak to peak difference.PKPKJittermeasures the variance (minimum and maximum values) in the time locations of the cross point.PKPKNoisemeasures the peak-to-peak noise on a waveform at the mid reference level.POVershootPositive Overshoot = (Maximum - High) / Amplitude ×100%PTOTmeasures the top value used in extinction ratio measurements.PWIdth(positive width) is the distance (time) between the middle reference (default = 50%) amplitude points of a positive pulse. The measurement is made on the first pulse in the waveform or gated region.QFACtormeasures the quality factor. The Q factor is a figure of merit for an eye diagram, which indicates the vertical eye opening relative to the noise at the low and high logic levels. It is the ratio of the eye size to noise.RISetiming measurement finds the rise time of the waveform. The rise time is the time it takes for the leading edge of the first pulse encountered to rise from a low reference value (defaul t is 10%) to a high reference value (default is 90%).RMSamplitude measurement finds the true Root Mean Square voltage in the entire waveform or gated region.RMSJittermeasures the variance in the time locations of the cross point. The RMS jitter is defined as one standard deviation at the cross point.RMSNoisemeasures the Root Mean Square noise amplitude on a waveform at the mid reference level.SIGMA1(histogram measurement) measures the percentage of points in the histogram that are within one standard deviation of the histogram mean.SIGMA2(histogram measurement) measures the percentage of points in the histogram that are within two standard deviations of the histogram mean.SIGMA3(histogram measurement) measures the percentage of points in the histogram that are within three standard deviations of the histogram mean.SIXSigmajit(histogram measurement) is six × RMSJitter.SNRatiomeasures the signal-to-noise ratio. The signal-to-noise ratio is the amplitude of a noise rejection band centered on the mid level.STDdevmeasures the standard deviation (Root Mean Square (RMS) deviation) of all acquired points within or on the histogram box.UNDEFINEDis the default measurement type, which indicates that no measurement type is specified. Once a measurement type is chosen, it can be cleared using this argument.WAVEFORMS(waveform count) measures the number of waveforms used to calculate the histogram.
MeasurementImmedUnits
¶
Bases: SCPICmdRead
The MEASUrement:IMMed:UNIts command.
Description
- Returns a string containing the units of the immediate measurement.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:UNIts?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:UNIts?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:UNIts?
MeasurementImmedValue
¶
Bases: SCPICmdRead
The MEASUrement:IMMed:VALue command.
Description
- Returns the value of the measurement specified by the
MEASUREMENT:IMMED:TYPEcommand. The measurement is immediately taken on the source(s) specified by aMEASUREMENT:IMMED:SOURCEXcommand.
Usage
- Using the
.query()method will send theMEASUrement:IMMed:VALue?query. - Using the
.verify(value)method will send theMEASUrement:IMMed:VALue?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:IMMed:VALue?
MeasurementMeasItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdRead
The MEASUrement:MEAS<x> command.
Description
- Returns all measurement parameters for the specified active measurement
.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>?
Properties
.count: TheMEASUrement:MEAS<x>:COUNtcommand..delay: TheMEASUrement:MEAS<x>:DELaycommand..maximum: TheMEASUrement:MEAS<x>:MAXimumcommand..mean: TheMEASUrement:MEAS<x>:MEANcommand..method: TheMEASUrement:MEAS<x>:METHodcommand..minimum: TheMEASUrement:MEAS<x>:MINImumcommand..noise: TheMEASUrement:MEAS<x>:NOISecommand..reflevel: TheMEASUrement:MEAS<x>:REFLevelcommand..source1: TheMEASUrement:MEAS<x>:SOUrce1command..state: TheMEASUrement:MEAS<x>:STATEcommand..stddev: TheMEASUrement:MEAS<x>:STDdevcommand..type: TheMEASUrement:MEAS<x>:TYPecommand..units: TheMEASUrement:MEAS<x>:UNItscommand..value: TheMEASUrement:MEAS<x>:VALuecommand.
count
property
¶
count: MeasurementMeasItemCount
Return the MEASUrement:MEAS<x>:COUNt command.
Description
- Returns the number of values accumulated for this measurement since the last statistical reset. Values may be ignored if they generated an error. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:COUNt?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:COUNt?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:COUNt?
delay
property
¶
delay: MeasurementMeasItemDelay
Return the MEASUrement:MEAS<x>:DELay command.
Description
- Returns the delay measurement parameters for the measurement specified by
, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:DELay?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:DELay?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:DELay?
Sub-properties
.direction: TheMEASUrement:MEAS<x>:DELay:DIREctioncommand..edge: TheMEASUrement:MEAS<x>:DELay:EDGE<x>command.
maximum
property
¶
maximum: MeasurementMeasItemMaximum
Return the MEASUrement:MEAS<x>:MAXimum command.
Description
- Returns the maximum value found for this measurement since the last statistical reset. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:MAXimum?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:MAXimum?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:MAXimum?
mean
property
¶
mean: MeasurementMeasItemMean
Return the MEASUrement:MEAS<x>:MEAN command.
Description
- Returns the mean value accumulated for this measurement since the last statistical reset. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:MEAN?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:MEAN?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:MEAN?
method
property
¶
method: MeasurementMeasItemMethod
Return the MEASUrement:MEAS<x>:METHod command.
Description
- This command specifies or queries the method used to calculate the 0% and 100% reference level.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:METHod?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:METHod valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:METHod {HIStogram|MINMax|MEAN}
- MEASUrement:MEAS<x>:METHod?
Info
HIStogramsets the high and low waveform levels statistically using a histogram algorithm.MINMaxsets the high and low waveform levels to MAX and MIN, respectively.MEANsets the high and low waveform levels to their mean.
minimum
property
¶
minimum: MeasurementMeasItemMinimum
Return the MEASUrement:MEAS<x>:MINImum command.
Description
- Returns the minimum value for this measurement since the last statistical reset.
Measurements are specified by
, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:MINImum?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:MINImum?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:MINImum?
noise
property
¶
noise: MeasurementMeasItemNoise
Return the MEASUrement:MEAS<x>:NOISe command.
Description
- This command sets or queries whether the noise measurement is made on the high or low
level of the waveform. Sending this command is equivalent to selecting Ref Levs > Eye
Top Level or Base Level in the Comm tab of the Measurement Setup dialog box. The Eye section is displayed only if you have an eye-pattern or optical measurement defined. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:NOISe?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:NOISe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:NOISe valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:NOISe {HIGH|LOW}
- MEASUrement:MEAS<x>:NOISe?
Info
HIGHargument causes the measurement for noise to be taken at the high level of the waveform.LOWargument causes the measurement for noise to be taken at the low level of the waveform.
reflevel
property
¶
reflevel: MeasurementMeasItemReflevel
Return the MEASUrement:MEAS<x>:REFLevel command.
Description
- This query-only command returns the current reference level parameters. It returns them in the following order: ABSOLUTE and then PERCENT for individual user measurements. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel?
Sub-properties
.absolute: TheMEASUrement:MEAS<x>:REFLevel:ABSolutecommand tree..method: TheMEASUrement:MEAS<x>:REFLevel:METHodcommand..percent: TheMEASUrement:MEAS<x>:REFLevel:PERCentcommand tree.
source1
property
¶
source1: MeasurementMeasItemSource1
Return the MEASUrement:MEAS<x>:SOUrce1 command.
Description
- This command sets or queries the source for all single channel measurements and specifies the reference source to measure ‘to’ when taking a delay measurement or phase measurement. Measurements are specified by x, which ranges from 1 through 8. This command is equivalent to selecting Measurement Setup from the Measure menu, selecting a measurement type of either Phase or Delay, and then choosing the desired measurement source. Tip: Source2 measurements apply only to phase and delay measurement types, which require both a target (Source1) and reference (Source2) source.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:SOUrce1?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:SOUrce1?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:SOUrce1 valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:SOUrce1 {CH<x>|MATH<y>|REF<x>|HIStogram}
- MEASUrement:MEAS<x>:SOUrce1?
Info
CH<x>is an input channel waveform. The x variable can be expressed as an integer ranging from 1 through 4.MATH<y>is a math waveform. The y variable can be expressed as an integer ranging from 1 through 4.REF<x>is a reference waveform. The x variable can be expressed as an integer ranging from 1 through 4.HIStogramis a histogram. Histogram is valid only for source 1.
Sub-properties
.sigtype: TheMEASUrement:MEAS<x>:SOUrce1:SIGTypecommand.
state
property
¶
state: MeasurementMeasItemState
Return the MEASUrement:MEAS<x>:STATE command.
Description
- This command specifies whether the specified measurement slot is computed and
displayed. The measurement slot is specified by
, which ranges from 1 through 8. For a measurement to display, you must have selected a source waveform and defined the measurement you want to take and display. You select the measurement using the MEASUREMENT:MEASX:SOURCEXcommand. You define the measurement type using theMEASUREMENT:MEASX:TYPEcommand.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:STATE?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:STATE?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:STATE valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:STATE {ON|OFF|<NR1>}
- MEASUrement:MEAS<x>:STATE?
Info
OFFdisables calculation and display of the specified measurement slot.ONenables calculation and display of the specified measurement slot.<NR1>= 0 disables calculation and display of the specified measurement slot; any other value enables calculation and display of the specified measurement slot.
stddev
property
¶
stddev: MeasurementMeasItemStddev
Return the MEASUrement:MEAS<x>:STDdev command.
Description
- Returns the standard deviation of values accumulated for this measurement since the
last statistical reset. Measurements are specified by
, the measurement slots, from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:STDdev?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:STDdev?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:STDdev?
type
property
¶
type: MeasurementMeasItemType
Return the MEASUrement:MEAS<x>:TYPe command.
Description
- This command sets or queries the measurement type defined for the specified measurement slot. The measurement slot is specified by x, which ranges from 1 through 8. This command is equivalent to selecting Measurement Setup from the Measure menu and then choosing the desired measurement type.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:TYPe?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:TYPe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:TYPe valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:TYPe {AMPlitude|AREa|BURst|CARea|CMEan|CRMs|DELay|DISTDUty|EXTINCTDB|EXTINCTPCT|EXTINCTRATIO|EYEHeight|EYEWIdth|FALL|FREQuency|HIGH|HITs|LOW|MAXimum|MEAN|MEDian|MINImum|NCROss|NDUty|NOVershoot|NWIdth|PBASe|PCROss|PCTCROss|PDUty|PEAKHits|PERIod|PHAse|PK2Pk|PKPKJitter|PKPKNoise|POVershoot|PTOP|PWIdth|QFACtor|RISe|RMS|RMSJitter|RMSNoise|SIGMA1|SIGMA2|SIGMA3|SIXSigmajit|SNRatio|STDdev|UNDEFINED|WAVEFORMS}
- MEASUrement:MEAS<x>:TYPe?
Info
AMPlitudemeasures the amplitude of the selected waveform. In other words, it measures the high value less the low value measured over the entire waveform or gated region.Amplitude = High - LowAREameasures the voltage over time. The area is over the entire waveform or gated region and is measured in volt-seconds. The area measured above the ground is positive, while the area below ground is negative.BURstmeasures the duration of a burst. The measurement is made over the entire waveform or gated region.CARea(cycle area) measures the voltage over time. In other words, it measures in volt-seconds, the area over the first cycle in the waveform or the first cycle in the gated region. The area measured above the common reference point is positive, while the area below the common reference point is negative.CMEan(cycle mean) measures the arithmetic mean over the first cycle in the waveform or the first cycle in the gated region.CRMs(cycle rms) measures the true Root Mean Square voltage over the first cycle in the waveform or the first cycle in the gated region.DELaymeasures the time between the middle reference (default = 50%) amplitude point of the source waveform and the destination waveform.DISTDUty(duty cycle distortion) measures the time between the falling edge and the rising edge of the eye pattern at the mid reference level. It is the peak-to-peak time variation of the first eye crossing measured at the mid-reference as a percent of the eye period.EXTINCTDBmeasures the extinction ratio of an optical waveform (eye diagram). Extinction Ratio (dB) measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result in dB. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction dB = 10 × (log 10 (High / Low)EXTINCTPCTmeasures the extinction ratio of the selected optical waveform. Extinction Ratio (%) measures the ratio of the average power levels for the logic Low (off) to the logic (High) (on) of an optical waveform and expresses the result in percent. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction % = 100.0 × (Low / High)EXTINCTRATIOmeasures the extinction ratio of the selected optical waveform. Extinction Ratio measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result without units. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode. Extinction ratios greater than 100 or less than 1 generate errors; low must be greater than or equal to 1 µW.Extinction Ratio = (High / Low)EYEHeightmeasures the vertical opening of an eye diagram in volts.EYEWidthmeasures the width of an eye diagram in seconds.FALLmeasures the time taken for the falling edge of the first pulse in the waveform or gated region to fall from a high reference value (default is 90%) to a low reference value (default is 10%).FREQuencymeasures the first cycle in the waveform or gated region. Frequency is the reciprocal of the period and is measured in hertz (Hz), where 1 Hz = 1 cycle per second.HIGHmeasures the High reference (100% level, sometimes called Topline) of a waveform.HITs(histogram hits) measures the number of points in or on the histogram box.LOWmeasures the Low reference (0% level, sometimes called Baseline) of a waveform.MAXimumfinds the maximum amplitude. This value is the most positive peak voltage found. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the maximum measurement measures the voltage of the highest nonzero bin in vertical histograms or the time of the right-most bin in horizontal histograms.MEANamplitude measurement finds the arithmetic mean over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the mean measurement measures the average of all acquired points within or on the histogram.MEDian(histogram measurement) measures the middle point of the histogram box. Half of all acquired points within or on the histogram box are less than this value and half are greater than this value.MINImumfinds the minimum amplitude. This value is typically the most negative peak voltage. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the minimum measurement measures the lowest nonzero bin in vertical histograms or the time of the left-most nonzero bin in the horizontal histograms.NCROss(timing measurement) measures the time from the trigger point to the first falling edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.NDUty(negative duty cycle) is the ratio of the negative pulse width to the signal period, expressed as a percentage. The duty cycle is measured on the first cycle in the waveform or gated region.Negative Duty Cycle = (Negative Width) / Period × 100%NOVershoot(negative overshoot) finds the negative overshoot value over the entire waveform or gated region.Negative Overshoot = (Low - Minimum) / Amplitude × 100%)NWIdth(negative width) measurement is the distance (time) between the middle reference (default = 50%) amplitude points of a negative pulse. The measurement is made on the first pulse in the waveform or gated region.PBASemeasures the base value used in extinction ratio measurements.PCROss(timing measurement) measures the time from the trigger point to the first positive edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.PCTCROssmeasures the location of the eye crossing point expressed as a percentage of EYEHeight.Crossing percent = 100 ×[(eye-crossing-point - PBASe)/(PTOP - PBASe)]PDUty(positive duty cycle) is the ratio of the positive pulse width to the signal period, expressed as a percentage. It is measured on the first cycle in the waveform or gated region.Positive Duty Cycle = (Positive Width)/Period × 100%PEAKHitsmeasures the number of points in the largest bin of the histogram.PERIodis the time required to complete the first cycle in a waveform or gated region. Period is the reciprocal of frequency and is measured in seconds.PHAsemeasures the phase difference (amount of time a waveform leads or lags the reference waveform) between two waveforms. The measurement is made between the middle reference points of the two waveforms and is expressed in degrees, where 360° represents one waveform cycle.PK2Pk(peak-to-peak) finds the absolute difference between the maximum and minimum amplitude in the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the PK2Pk measurement measures the histogram peak to peak difference.PKPKJittermeasures the variance (minimum and maximum values) in the time locations of the cross point.PKPKNoisemeasures the peak-to-peak noise on a waveform at the mid reference level.POVershootPositive Overshoot = (Maximum - High) / Amplitude ×100%PTOTmeasures the top value used in extinction ratio measurements.PWIdth(positive width) is the distance (time) between the middle reference (default = 50%) amplitude points of a positive pulse. The measurement is made on the first pulse in the waveform or gated region.QFACtormeasures the quality factor. The Q factor is a figure of merit for an eye diagram, which indicates the vertical eye opening relative to the noise at the low and high logic levels. It is the ratio of the eye size to noise.RISetiming measurement finds the rise time of the waveform. The rise time is the time it takes for the leading edge of the first pulse encountered to rise from a low reference value (default is 10%) to a high reference value (default is 90%).RMSamplitude measurement finds the true Root Mean Square voltage in the entire waveform or gated region.RMSJittermeasures the variance in the time locations of the cross point. The RMS jitter is defined as one standard deviation at the cross point.RMSNoisemeasures the Root Mean Square noise amplitude on a waveform at the mid reference level.SIGMA1(histogram measurement) measures the percentage of points in the histogram that are within one standard deviation of the histogram mean.SIGMA2(histogram measurement) measures the percentage of points in the histogram that are within two standard deviations of the histogram mean.SIGMA3(histogram measurement) measures the percentage of points in the histogram that are within three standard deviations of the histogram mean.SIXSigmajit(histogram measurement) is six × RMSJitter.SNRatiomeasures the signal-to-noise ratio. The signal-to-noise ratio is the amplitude of a noise rejection band centered on the mid level.STDdevmeasures the standard deviation (Root Mean Square (RMS) deviation) of all acquired points within or on the histogram box.UNDEFINEDis the default measurement type, which indicates that no measurement type is specified. Once a measurement type is chosen, it can be cleared using this argument.WAVEFORMS(waveform count) measures the number of waveforms used to calculate the histogram.
units
property
¶
units: MeasurementMeasItemUnits
Return the MEASUrement:MEAS<x>:UNIts command.
Description
- Returns the units associated with the specified measurement. The measurement slots are
specified by
, which ranges from 1 through 4.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:UNIts?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:UNIts?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:UNIts?
value
property
¶
value: MeasurementMeasItemValue
Return the MEASUrement:MEAS<x>:VALue command.
Description
- Returns a calculate value for the measurement specified by
, which ranges from 1 through 4.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:VALue?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:VALue?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:VALue?
MeasurementMeasItemCount
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:COUNt command.
Description
- Returns the number of values accumulated for this measurement since the last statistical reset. Values may be ignored if they generated an error. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:COUNt?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:COUNt?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:COUNt?
MeasurementMeasItemDelay
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:DELay command.
Description
- Returns the delay measurement parameters for the measurement specified by
, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:DELay?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:DELay?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:DELay?
Properties
.direction: TheMEASUrement:MEAS<x>:DELay:DIREctioncommand..edge: TheMEASUrement:MEAS<x>:DELay:EDGE<x>command.
direction
property
¶
direction: MeasurementMeasItemDelayDirection
Return the MEASUrement:MEAS<x>:DELay:DIREction command.
Description
- This command sets or queries the starting point and direction that determines the
delay ‘to’ edge when taking a delay measurement. Use the
MEASUREMENT:MEASX:SOURCEXcommand to specify the waveform. This command is equivalent to selecting Time from the Measure menu, choosing Delay from the drop-down list and then clicking the desired Search Direction setting. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:DELay:DIREction?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:DELay:DIREction?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:DELay:DIREction valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:DELay:DIREction {BACKWards|FORWards}
- MEASUrement:MEAS<x>:DELay:DIREction?
Info
BACKWardsmeans that the search starts at the end of the waveform and looks for the last rising or falling edge in the waveform. Use theMEASUREMENT:MEASX:DELAY:EDGEXcommand to specify the slope of the edge.FORWardsmeans that the search starts at the beginning of the waveform and looks for the first rising or falling edge in the waveform. Use theMEASUREMENT:MEASX:DELAY:EDGEXcommand to specify the slope of the edge.
edge
property
¶
edge: dict[int, MeasurementMeasItemDelayEdgeItem]
Return the MEASUrement:MEAS<x>:DELay:EDGE<x> command.
Description
- This command specifies the slope of the edge used for the delay ‘from’ or ‘to’
waveform when taking an immediate delay measurement. The waveform is specified by
MEASUREMENT:MEASX:SOURCEX.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:DELay:EDGE<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:DELay:EDGE<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:DELay:EDGE<x> valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:DELay:EDGE<x> {FALL|RISe}
- MEASUrement:MEAS<x>:DELay:EDGE<x>?
Info
<x>specifies which waveform to use, where= 1 is the ‘from’ waveform, and = 2 is the ‘to’ waveform. FALLspecifies the falling edge.RISespecifies the rising edge.
MeasurementMeasItemDelayDirection
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:DELay:DIREction command.
Description
- This command sets or queries the starting point and direction that determines the delay
‘to’ edge when taking a delay measurement. Use the
MEASUREMENT:MEASX:SOURCEXcommand to specify the waveform. This command is equivalent to selecting Time from the Measure menu, choosing Delay from the drop-down list and then clicking the desired Search Direction setting. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:DELay:DIREction?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:DELay:DIREction?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:DELay:DIREction valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:DELay:DIREction {BACKWards|FORWards}
- MEASUrement:MEAS<x>:DELay:DIREction?
Info
BACKWardsmeans that the search starts at the end of the waveform and looks for the last rising or falling edge in the waveform. Use theMEASUREMENT:MEASX:DELAY:EDGEXcommand to specify the slope of the edge.FORWardsmeans that the search starts at the beginning of the waveform and looks for the first rising or falling edge in the waveform. Use theMEASUREMENT:MEASX:DELAY:EDGEXcommand to specify the slope of the edge.
MeasurementMeasItemDelayEdgeItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:DELay:EDGE<x> command.
Description
- This command specifies the slope of the edge used for the delay ‘from’ or ‘to’ waveform
when taking an immediate delay measurement. The waveform is specified by
MEASUREMENT:MEASX:SOURCEX.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:DELay:EDGE<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:DELay:EDGE<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:DELay:EDGE<x> valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:DELay:EDGE<x> {FALL|RISe}
- MEASUrement:MEAS<x>:DELay:EDGE<x>?
Info
<x>specifies which waveform to use, where= 1 is the ‘from’ waveform, and = 2 is the ‘to’ waveform. FALLspecifies the falling edge.RISespecifies the rising edge.
MeasurementMeasItemMaximum
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:MAXimum command.
Description
- Returns the maximum value found for this measurement since the last statistical reset. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:MAXimum?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:MAXimum?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:MAXimum?
MeasurementMeasItemMean
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:MEAN command.
Description
- Returns the mean value accumulated for this measurement since the last statistical reset. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:MEAN?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:MEAN?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:MEAN?
MeasurementMeasItemMethod
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:METHod command.
Description
- This command specifies or queries the method used to calculate the 0% and 100% reference level.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:METHod?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:METHod valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:METHod {HIStogram|MINMax|MEAN}
- MEASUrement:MEAS<x>:METHod?
Info
HIStogramsets the high and low waveform levels statistically using a histogram algorithm.MINMaxsets the high and low waveform levels to MAX and MIN, respectively.MEANsets the high and low waveform levels to their mean.
MeasurementMeasItemMinimum
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:MINImum command.
Description
- Returns the minimum value for this measurement since the last statistical reset.
Measurements are specified by
, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:MINImum?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:MINImum?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:MINImum?
MeasurementMeasItemNoise
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:NOISe command.
Description
- This command sets or queries whether the noise measurement is made on the high or low level of the waveform. Sending this command is equivalent to selecting Ref Levs > Eye > Top Level or Base Level in the Comm tab of the Measurement Setup dialog box. The Eye section is displayed only if you have an eye-pattern or optical measurement defined. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:NOISe?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:NOISe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:NOISe valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:NOISe {HIGH|LOW}
- MEASUrement:MEAS<x>:NOISe?
Info
HIGHargument causes the measurement for noise to be taken at the high level of the waveform.LOWargument causes the measurement for noise to be taken at the low level of the waveform.
MeasurementMeasItemReflevel
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel command.
Description
- This query-only command returns the current reference level parameters. It returns them in the following order: ABSOLUTE and then PERCENT for individual user measurements. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel?
Properties
.absolute: TheMEASUrement:MEAS<x>:REFLevel:ABSolutecommand tree..method: TheMEASUrement:MEAS<x>:REFLevel:METHodcommand..percent: TheMEASUrement:MEAS<x>:REFLevel:PERCentcommand tree.
absolute
property
¶
absolute: MeasurementMeasItemReflevelAbsolute
Return the MEASUrement:MEAS<x>:REFLevel:ABSolute command tree.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.high: TheMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGHcommand..low: TheMEASUrement:MEAS<x>:REFLevel:ABSolute:LOWcommand..mid: TheMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>command.
method
property
¶
Return the MEASUrement:MEAS<x>:REFLevel:METHod command.
Description
- This command specifies or queries the reference level units used for measurement calculations. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired reference level from the Units group box. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:METHod?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:METHod valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:MEAS<x>:REFLevel:METHod?
Info
ABSolutespecifies that the reference levels are set explicitly using theMEASUrement:MEAS<x>:REFLevel:ABSolutecommands. This method is useful when precise values are required (for example, when designing to published interface specifications, such as RS-232-C.PERCentspecifies that the reference levels are calculated as a percent relative to HIGH and LOW. The percentages are defined using theMEASUrement:MEAS<x>:REFLevel:PERCentcommands.
percent
property
¶
percent: MeasurementMeasItemReflevelPercent
Return the MEASUrement:MEAS<x>:REFLevel:PERCent command tree.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.high: TheMEASUrement:MEAS<x>:REFLevel:PERCent:HIGHcommand..low: TheMEASUrement:MEAS<x>:REFLevel:PERCent:LOWcommand..mid: TheMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>command.
MeasurementMeasItemReflevelAbsolute
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:ABSolute command tree.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.high: TheMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGHcommand..low: TheMEASUrement:MEAS<x>:REFLevel:ABSolute:LOWcommand..mid: TheMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>command.
high
property
¶
Return the MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH command.
Description
- This command sets or queries the high reference level, and is the upper reference
level when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Absolute. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH?
Info
<NR3>is the high reference level in volts. The default is 0.0 V.
low
property
¶
Return the MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW command.
Description
- This command sets or queries the low reference level, and is the lower reference level
when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Absolute. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:LOW?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:LOW valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW?
Info
<NR3>is the low reference level in volts. The default is 0.0 V.
mid
property
¶
Return the MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x> command.
Description
- This command sets or queries the mid reference level for the ‘to’ waveform when taking
a delay measurement, and is the 50% reference level when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Absolute. Mid1 sets the ‘from’ waveform and Mid2 sets the ‘to’ waveform when taking a delay measurement. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>?
Info
<NR3>is the mid reference level in volts. The default is 0.0 V.
MeasurementMeasItemReflevelAbsoluteHigh
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH command.
Description
- This command sets or queries the high reference level, and is the upper reference level
when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Absolute. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:HIGH?
Info
<NR3>is the high reference level in volts. The default is 0.0 V.
MeasurementMeasItemReflevelAbsoluteLow
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW command.
Description
- This command sets or queries the low reference level, and is the lower reference level
when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Absolute. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:LOW?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:LOW valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:LOW?
Info
<NR3>is the low reference level in volts. The default is 0.0 V.
MeasurementMeasItemReflevelAbsoluteMidItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x> command.
Description
- This command sets or queries the mid reference level for the ‘to’ waveform when taking a
delay measurement, and is the 50% reference level when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Absolute. Mid1 sets the ‘from’ waveform and Mid2 sets the ‘to’ waveform when taking a delay measurement. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:MEAS<x>:REFLevel:ABSolute:MID<x>?
Info
<NR3>is the mid reference level in volts. The default is 0.0 V.
MeasurementMeasItemReflevelMethod
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:METHod command.
Description
- This command specifies or queries the reference level units used for measurement calculations. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired reference level from the Units group box. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:METHod?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:METHod valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:MEAS<x>:REFLevel:METHod?
Info
ABSolutespecifies that the reference levels are set explicitly using theMEASUrement:MEAS<x>:REFLevel:ABSolutecommands. This method is useful when precise values are required (for example, when designing to published interface specifications, such as RS-232-C.PERCentspecifies that the reference levels are calculated as a percent relative to HIGH and LOW. The percentages are defined using theMEASUrement:MEAS<x>:REFLevel:PERCentcommands.
MeasurementMeasItemReflevelPercent
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:PERCent command tree.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.high: TheMEASUrement:MEAS<x>:REFLevel:PERCent:HIGHcommand..low: TheMEASUrement:MEAS<x>:REFLevel:PERCent:LOWcommand..mid: TheMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>command.
high
property
¶
Return the MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the high reference level when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Percent. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:HIGH valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH?
Info
<NR3>is the high reference level, ranging from 0 to 100%. The default high reference level is 90%.
low
property
¶
Return the MEASUrement:MEAS<x>:REFLevel:PERCent:LOW command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the low reference level when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Percent. This command is equivalent to selecting Reference Levels from the Measure menu, and then entering the Percentage Low Ref value. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:LOW?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:LOW valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:PERCent:LOW <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:LOW?
Info
<NR3>is the low reference level, ranging from 0 to 100%. The default low reference level is 10%.
mid
property
¶
Return the MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x> command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the mid reference level for the second waveform specified when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Percent. Mid1 specifies the ‘from’ waveform and Mid2 specifies the ‘to’ waveform for delay measurements. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x> <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>?
Info
<NR3>is the mid reference level, ranging from 0 to 100%. The default mid reference level is 50%.
MeasurementMeasItemReflevelPercentHigh
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the high reference level when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Percent. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:HIGH valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:HIGH?
Info
<NR3>is the high reference level, ranging from 0 to 100%. The default high reference level is 90%.
MeasurementMeasItemReflevelPercentLow
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:PERCent:LOW command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the low reference level when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Percent. This command is equivalent to selecting Reference Levels from the Measure menu, and then entering the Percentage Low Ref value. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:LOW?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:LOW valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:PERCent:LOW <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:LOW?
Info
<NR3>is the low reference level, ranging from 0 to 100%. The default low reference level is 10%.
MeasurementMeasItemReflevelPercentMidItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x> command.
Description
- This command sets or queries the percentage (where 100% is equal to HIGH) used to
calculate the mid reference level for the second waveform specified when
MEASUREMENT:MEASX:REFLEVEL:METHODis set to Percent. Mid1 specifies the ‘from’ waveform and Mid2 specifies the ‘to’ waveform for delay measurements. Measurements are specified by x, which ranges from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:REFLevel:PERCent:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x> <NR3>
- MEASUrement:MEAS<x>:REFLevel:PERCent:MID<x>?
Info
<NR3>is the mid reference level, ranging from 0 to 100%. The default mid reference level is 50%.
MeasurementMeasItemSource1
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:SOUrce1 command.
Description
- This command sets or queries the source for all single channel measurements and specifies the reference source to measure ‘to’ when taking a delay measurement or phase measurement. Measurements are specified by x, which ranges from 1 through 8. This command is equivalent to selecting Measurement Setup from the Measure menu, selecting a measurement type of either Phase or Delay, and then choosing the desired measurement source. Tip: Source2 measurements apply only to phase and delay measurement types, which require both a target (Source1) and reference (Source2) source.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:SOUrce1?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:SOUrce1?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:SOUrce1 valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:SOUrce1 {CH<x>|MATH<y>|REF<x>|HIStogram}
- MEASUrement:MEAS<x>:SOUrce1?
Info
CH<x>is an input channel waveform. The x variable can be expressed as an integer ranging from 1 through 4.MATH<y>is a math waveform. The y variable can be expressed as an integer ranging from 1 through 4.REF<x>is a reference waveform. The x variable can be expressed as an integer ranging from 1 through 4.HIStogramis a histogram. Histogram is valid only for source 1.
Properties
.sigtype: TheMEASUrement:MEAS<x>:SOUrce1:SIGTypecommand.
sigtype
property
¶
sigtype: MeasurementMeasItemSource1Sigtype
Return the MEASUrement:MEAS<x>:SOUrce1:SIGType command.
Description
- This command sets or queries the type of input signal used for the specified
measurement slot. MEAS
is 1 through 8 for the measurement slot using SOURCE , 1 or 2. To ensure accurate measurements, use this command to specify the input-signal type for the measurement source.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:SOUrce1:SIGType?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:SOUrce1:SIGType?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:SOUrce1:SIGType valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:MEAS<x>:SOUrce1:SIGType?
Info
PULSEis for generic signals that are not associated with synchronous communications standards.EYEis for synchronous-communication signals with NRZ-like characteristics (nonreturn to zero).
MeasurementMeasItemSource1Sigtype
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:SOUrce1:SIGType command.
Description
- This command sets or queries the type of input signal used for the specified measurement
slot. MEAS
is 1 through 8 for the measurement slot using SOURCE , 1 or 2. To ensure accurate measurements, use this command to specify the input-signal type for the measurement source.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:SOUrce1:SIGType?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:SOUrce1:SIGType?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:SOUrce1:SIGType valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:MEAS<x>:SOUrce1:SIGType?
Info
PULSEis for generic signals that are not associated with synchronous communications standards.EYEis for synchronous-communication signals with NRZ-like characteristics (nonreturn to zero).
MeasurementMeasItemState
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:STATE command.
Description
- This command specifies whether the specified measurement slot is computed and displayed.
The measurement slot is specified by
, which ranges from 1 through 8. For a measurement to display, you must have selected a source waveform and defined the measurement you want to take and display. You select the measurement using the MEASUREMENT:MEASX:SOURCEXcommand. You define the measurement type using theMEASUREMENT:MEASX:TYPEcommand.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:STATE?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:STATE?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:STATE valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:STATE {ON|OFF|<NR1>}
- MEASUrement:MEAS<x>:STATE?
Info
OFFdisables calculation and display of the specified measurement slot.ONenables calculation and display of the specified measurement slot.<NR1>= 0 disables calculation and display of the specified measurement slot; any other value enables calculation and display of the specified measurement slot.
MeasurementMeasItemStddev
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:STDdev command.
Description
- Returns the standard deviation of values accumulated for this measurement since the last
statistical reset. Measurements are specified by
, the measurement slots, from 1 through 8.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:STDdev?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:STDdev?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:STDdev?
MeasurementMeasItemType
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:MEAS<x>:TYPe command.
Description
- This command sets or queries the measurement type defined for the specified measurement slot. The measurement slot is specified by x, which ranges from 1 through 8. This command is equivalent to selecting Measurement Setup from the Measure menu and then choosing the desired measurement type.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:TYPe?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:TYPe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:MEAS<x>:TYPe valuecommand.
SCPI Syntax
- MEASUrement:MEAS<x>:TYPe {AMPlitude|AREa|BURst|CARea|CMEan|CRMs|DELay|DISTDUty|EXTINCTDB|EXTINCTPCT|EXTINCTRATIO|EYEHeight|EYEWIdth|FALL|FREQuency|HIGH|HITs|LOW|MAXimum|MEAN|MEDian|MINImum|NCROss|NDUty|NOVershoot|NWIdth|PBASe|PCROss|PCTCROss|PDUty|PEAKHits|PERIod|PHAse|PK2Pk|PKPKJitter|PKPKNoise|POVershoot|PTOP|PWIdth|QFACtor|RISe|RMS|RMSJitter|RMSNoise|SIGMA1|SIGMA2|SIGMA3|SIXSigmajit|SNRatio|STDdev|UNDEFINED|WAVEFORMS}
- MEASUrement:MEAS<x>:TYPe?
Info
AMPlitudemeasures the amplitude of the selected waveform. In other words, it measures the high value less the low value measured over the entire waveform or gated region.Amplitude = High - LowAREameasures the voltage over time. The area is over the entire waveform or gated region and is measured in volt-seconds. The area measured above the ground is positive, while the area below ground is negative.BURstmeasures the duration of a burst. The measurement is made over the entire waveform or gated region.CARea(cycle area) measures the voltage over time. In other words, it measures in volt-seconds, the area over the first cycle in the waveform or the first cycle in the gated region. The area measured above the common reference point is positive, while the area below the common reference point is negative.CMEan(cycle mean) measures the arithmetic mean over the first cycle in the waveform or the first cycle in the gated region.CRMs(cycle rms) measures the true Root Mean Square voltage over the first cycle in the waveform or the first cycle in the gated region.DELaymeasures the time between the middle reference (default = 50%) amplitude point of the source waveform and the destination waveform.DISTDUty(duty cycle distortion) measures the time between the falling edge and the rising edge of the eye pattern at the mid reference level. It is the peak-to-peak time variation of the first eye crossing measured at the mid-reference as a percent of the eye period.EXTINCTDBmeasures the extinction ratio of an optical waveform (eye diagram). Extinction Ratio (dB) measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result in dB. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction dB = 10 × (log 10 (High / Low)EXTINCTPCTmeasures the extinction ratio of the selected optical waveform. Extinction Ratio (%) measures the ratio of the average power levels for the logic Low (off) to the logic (High) (on) of an optical waveform and expresses the result in percent. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode.Extinction % = 100.0 × (Low / High)EXTINCTRATIOmeasures the extinction ratio of the selected optical waveform. Extinction Ratio measures the ratio of the average power levels for the logic High to the logic Low of an optical waveform and expresses the result without units. This measurement only works for fast acquisition signals or a reference waveform saved in fast acquisition mode. Extinction ratios greater than 100 or less than 1 generate errors; low must be greater than or equal to 1 µW.Extinction Ratio = (High / Low)EYEHeightmeasures the vertical opening of an eye diagram in volts.EYEWidthmeasures the width of an eye diagram in seconds.FALLmeasures the time taken for the falling edge of the first pulse in the waveform or gated region to fall from a high reference value (default is 90%) to a low reference value (default is 10%).FREQuencymeasures the first cycle in the waveform or gated region. Frequency is the reciprocal of the period and is measured in hertz (Hz), where 1 Hz = 1 cycle per second.HIGHmeasures the High reference (100% level, sometimes called Topline) of a waveform.HITs(histogram hits) measures the number of points in or on the histogram box.LOWmeasures the Low reference (0% level, sometimes called Baseline) of a waveform.MAXimumfinds the maximum amplitude. This value is the most positive peak voltage found. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the maximum measurement measures the voltage of the highest nonzero bin in vertical histograms or the time of the right-most bin in horizontal histograms.MEANamplitude measurement finds the arithmetic mean over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the mean measurement measures the average of all acquired points within or on the histogram.MEDian(histogram measurement) measures the middle point of the histogram box. Half of all acquired points within or on the histogram box are less than this value and half are greater than this value.MINImumfinds the minimum amplitude. This value is typically the most negative peak voltage. It is measured over the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the minimum measurement measures the lowest nonzero bin in vertical histograms or the time of the left-most nonzero bin in the horizontal histograms.NCROss(timing measurement) measures the time from the trigger point to the first falling edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.NDUty(negative duty cycle) is the ratio of the negative pulse width to the signal period, expressed as a percentage. The duty cycle is measured on the first cycle in the waveform or gated region.Negative Duty Cycle = (Negative Width) / Period × 100%NOVershoot(negative overshoot) finds the negative overshoot value over the entire waveform or gated region.Negative Overshoot = (Low - Minimum) / Amplitude × 100%)NWIdth(negative width) measurement is the distance (time) between the middle reference (default = 50%) amplitude points of a negative pulse. The measurement is made on the first pulse in the waveform or gated region.PBASemeasures the base value used in extinction ratio measurements.PCROss(timing measurement) measures the time from the trigger point to the first positive edge of the waveform or gated region. The distance (time) is measured at the middle reference amplitude point of the signal.PCTCROssmeasures the location of the eye crossing point expressed as a percentage of EYEHeight.Crossing percent = 100 ×[(eye-crossing-point - PBASe)/(PTOP - PBASe)]PDUty(positive duty cycle) is the ratio of the positive pulse width to the signal period, expressed as a percentage. It is measured on the first cycle in the waveform or gated region.Positive Duty Cycle = (Positive Width)/Period × 100%PEAKHitsmeasures the number of points in the largest bin of the histogram.PERIodis the time required to complete the first cycle in a waveform or gated region. Period is the reciprocal of frequency and is measured in seconds.PHAsemeasures the phase difference (amount of time a waveform leads or lags the reference waveform) between two waveforms. The measurement is made between the middle reference points of the two waveforms and is expressed in degrees, where 360° represents one waveform cycle.PK2Pk(peak-to-peak) finds the absolute difference between the maximum and minimum amplitude in the entire waveform or gated region. When histogram is selected with theMEASUREMENT:METHODcommand, the PK2Pk measurement measures the histogram peak to peak difference.PKPKJittermeasures the variance (minimum and maximum values) in the time locations of the cross point.PKPKNoisemeasures the peak-to-peak noise on a waveform at the mid reference level.POVershootPositive Overshoot = (Maximum - High) / Amplitude ×100%PTOTmeasures the top value used in extinction ratio measurements.PWIdth(positive width) is the distance (time) between the middle reference (default = 50%) amplitude points of a positive pulse. The measurement is made on the first pulse in the waveform or gated region.QFACtormeasures the quality factor. The Q factor is a figure of merit for an eye diagram, which indicates the vertical eye opening relative to the noise at the low and high logic levels. It is the ratio of the eye size to noise.RISetiming measurement finds the rise time of the waveform. The rise time is the time it takes for the leading edge of the first pulse encountered to rise from a low reference value (default is 10%) to a high reference value (default is 90%).RMSamplitude measurement finds the true Root Mean Square voltage in the entire waveform or gated region.RMSJittermeasures the variance in the time locations of the cross point. The RMS jitter is defined as one standard deviation at the cross point.RMSNoisemeasures the Root Mean Square noise amplitude on a waveform at the mid reference level.SIGMA1(histogram measurement) measures the percentage of points in the histogram that are within one standard deviation of the histogram mean.SIGMA2(histogram measurement) measures the percentage of points in the histogram that are within two standard deviations of the histogram mean.SIGMA3(histogram measurement) measures the percentage of points in the histogram that are within three standard deviations of the histogram mean.SIXSigmajit(histogram measurement) is six × RMSJitter.SNRatiomeasures the signal-to-noise ratio. The signal-to-noise ratio is the amplitude of a noise rejection band centered on the mid level.STDdevmeasures the standard deviation (Root Mean Square (RMS) deviation) of all acquired points within or on the histogram box.UNDEFINEDis the default measurement type, which indicates that no measurement type is specified. Once a measurement type is chosen, it can be cleared using this argument.WAVEFORMS(waveform count) measures the number of waveforms used to calculate the histogram.
MeasurementMeasItemUnits
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:UNIts command.
Description
- Returns the units associated with the specified measurement. The measurement slots are
specified by
, which ranges from 1 through 4.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:UNIts?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:UNIts?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:UNIts?
MeasurementMeasItemValue
¶
Bases: SCPICmdRead
The MEASUrement:MEAS<x>:VALue command.
Description
- Returns a calculate value for the measurement specified by
, which ranges from 1 through 4.
Usage
- Using the
.query()method will send theMEASUrement:MEAS<x>:VALue?query. - Using the
.verify(value)method will send theMEASUrement:MEAS<x>:VALue?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:MEAS<x>:VALue?
MeasurementMethod
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:METHod command.
Description
- This command sets or queries the method used to calculate the 0% and 100% reference level. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired Determine Base, Top From setting.
Usage
- Using the
.query()method will send theMEASUrement:METHod?query. - Using the
.verify(value)method will send theMEASUrement:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:METHod valuecommand.
SCPI Syntax
- MEASUrement:METHod {HIStogram|MEAN|MINMax}
- MEASUrement:METHod?
Info
HIStogramsets the high and low reference levels to the most common values either above or below the mid point, depending on whether the high reference point or the low reference point is being defined. Because the statistical approach ignores short-term aberrations, such as overshoot or ringing, the histogram method is the best setting for examining pulses.MEANsets the high and low reference levels to the mean values using all values either above or below the midpoint, depending on whether it is defining the high or low reference level. The selection is best used for examining eye patterns.MINMaxuses the highest and lowest values of the waveform record. This selection is best for examining waveforms with no large, flat portions of a common value, such as sine waves and triangle waves.
MeasurementNoise
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:NOISe command.
Description
- This command sets or queries whether the noise measurement is made on the high or low level of the waveform. Sending this command is equivalent to selecting Ref Levs > Eye > Top Level or Base Level in the Comm tab of the Measurement Setup dialog box. The Eye section is displayed only if you have an eye-pattern or optical measurement defined.
Usage
- Using the
.query()method will send theMEASUrement:NOISe?query. - Using the
.verify(value)method will send theMEASUrement:NOISe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:NOISe valuecommand.
SCPI Syntax
- MEASUrement:NOISe {HIGH|LOW}
- MEASUrement:NOISe?
Info
HIGHargument causes the measurement for noise to be taken at the high level of the waveform.LOWargument causes the measurement for noise to be taken at the low level of the waveform.
MeasurementReflevel
¶
Bases: SCPICmdRead
The MEASUrement:REFLevel command.
Description
- Returns the current reference level parameters.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel?query and raise an AssertionError if the returned value does not matchvalue.
SCPI Syntax
- MEASUrement:REFLevel?
Properties
.absolute: TheMEASUrement:REFLevel:ABSolutecommand tree..method: TheMEASUrement:REFLevel:METHodcommand..percent: TheMEASUrement:REFLevel:PERCentcommand tree.
absolute
property
¶
absolute: MeasurementReflevelAbsolute
Return the MEASUrement:REFLevel:ABSolute command tree.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.high: TheMEASUrement:REFLevel:ABSolute:HIGHcommand..low: TheMEASUrement:REFLevel:ABSolute:LOWcommand..mid: TheMEASUrement:REFLevel:ABSolute:MID<x>command.
method
property
¶
method: MeasurementReflevelMethod
Return the MEASUrement:REFLevel:METHod command.
Description
- Specifies or returns the reference level units used for measurement calculations.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:METHod?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:METHod valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:REFLevel:METHod?
Info
ABSolutespecifies that the reference levels are set explicitly using theMEASUrement:REFLevel:ABSolutecommands. This method is useful when precise values are required (for example, when designing to published interface specifications, such as RS-232-C).PERCentspecifies that the reference levels are calculated as a percent relative to HIGH and LOW. The percentages are defined using theMEASUrement:REFLevel:PERCentcommands.
percent
property
¶
percent: MeasurementReflevelPercent
Return the MEASUrement:REFLevel:PERCent command tree.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent?query and raise an AssertionError if the returned value does not matchvalue.
Sub-properties
.high: TheMEASUrement:REFLevel:PERCent:HIGHcommand..low: TheMEASUrement:REFLevel:PERCent:LOWcommand..mid: TheMEASUrement:REFLevel:PERCent:MID<x>command.
MeasurementReflevelAbsolute
¶
Bases: SCPICmdRead
The MEASUrement:REFLevel:ABSolute command tree.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.high: TheMEASUrement:REFLevel:ABSolute:HIGHcommand..low: TheMEASUrement:REFLevel:ABSolute:LOWcommand..mid: TheMEASUrement:REFLevel:ABSolute:MID<x>command.
high
property
¶
Return the MEASUrement:REFLevel:ABSolute:HIGH command.
Description
- This command specifies the high reference level, and is the upper reference level when
MEASUREMENT:REFLEVEL:METHODis set to Absolute. This command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:ABSolute:HIGH valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:REFLevel:ABSolute:HIGH?
Info
<NR3>is a floating point number that specifies the high reference level, in volts. The default is 0.0 V.
low
property
¶
Return the MEASUrement:REFLevel:ABSolute:LOW command.
Description
- This command specifies the low reference level, and is the lower reference level when
MEASUREMENT:REFLEVEL:METHODis set to Absolute.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute:LOW?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:ABSolute:LOW valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:REFLevel:ABSolute:LOW?
Info
<NR3>is a floating point number that specifies the low reference level, in volts. The default is 0.0 V.
mid
property
¶
Return the MEASUrement:REFLevel:ABSolute:MID<x> command.
Description
- This command specifies an absolute mid reference level (the 50% reference level) for
the ‘to’ waveform when taking a delay measurement, in volts. There are two absolute
mid reference levels; thus MID
can either be MID1 or MID2. This command applies when MEASUREMENT:REFLEVEL:METHODhas been set to Absolute. This command is equivalent to setting the Reference Levels in the MEASURE menu on the oscilloscope front panel.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:ABSolute:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:REFLevel:ABSolute:MID<x>?
Info
<NR3>is a floating point number that specifies the mid reference level in volts.
MeasurementReflevelAbsoluteHigh
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:REFLevel:ABSolute:HIGH command.
Description
- This command specifies the high reference level, and is the upper reference level when
MEASUREMENT:REFLEVEL:METHODis set to Absolute. This command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:ABSolute:HIGH valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:ABSolute:HIGH <NR3>
- MEASUrement:REFLevel:ABSolute:HIGH?
Info
<NR3>is a floating point number that specifies the high reference level, in volts. The default is 0.0 V.
MeasurementReflevelAbsoluteLow
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:REFLevel:ABSolute:LOW command.
Description
- This command specifies the low reference level, and is the lower reference level when
MEASUREMENT:REFLEVEL:METHODis set to Absolute.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute:LOW?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:ABSolute:LOW valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:ABSolute:LOW <NR3>
- MEASUrement:REFLevel:ABSolute:LOW?
Info
<NR3>is a floating point number that specifies the low reference level, in volts. The default is 0.0 V.
MeasurementReflevelAbsoluteMidItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:REFLevel:ABSolute:MID<x> command.
Description
- This command specifies an absolute mid reference level (the 50% reference level) for the
‘to’ waveform when taking a delay measurement, in volts. There are two absolute mid
reference levels; thus MID
can either be MID1 or MID2. This command applies when MEASUREMENT:REFLEVEL:METHODhas been set to Absolute. This command is equivalent to setting the Reference Levels in the MEASURE menu on the oscilloscope front panel.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:ABSolute:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:ABSolute:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:ABSolute:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:ABSolute:MID<x> <NR3>
- MEASUrement:REFLevel:ABSolute:MID<x>?
Info
<NR3>is a floating point number that specifies the mid reference level in volts.
MeasurementReflevelMethod
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:REFLevel:METHod command.
Description
- Specifies or returns the reference level units used for measurement calculations.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:METHod?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:METHod?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:METHod valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:METHod {ABSolute|PERCent}
- MEASUrement:REFLevel:METHod?
Info
ABSolutespecifies that the reference levels are set explicitly using theMEASUrement:REFLevel:ABSolutecommands. This method is useful when precise values are required (for example, when designing to published interface specifications, such as RS-232-C).PERCentspecifies that the reference levels are calculated as a percent relative to HIGH and LOW. The percentages are defined using theMEASUrement:REFLevel:PERCentcommands.
MeasurementReflevelPercent
¶
Bases: SCPICmdRead
The MEASUrement:REFLevel:PERCent command tree.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.high: TheMEASUrement:REFLevel:PERCent:HIGHcommand..low: TheMEASUrement:REFLevel:PERCent:LOWcommand..mid: TheMEASUrement:REFLevel:PERCent:MID<x>command.
high
property
¶
Return the MEASUrement:REFLevel:PERCent:HIGH command.
Description
- This command specifies the percent (where 100% is equal to HIGH) used to calculate the
high reference level when
MEASUREMENT:REFLEVEL:METHODis set to Percent. This command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:PERCent:HIGH valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:PERCent:HIGH <NR3>
- MEASUrement:REFLevel:PERCent:HIGH?
Info
<NR3>is a floating point number that specifies the high reference level, ranging from 0 to 100%. The default high reference level is 90%.
low
property
¶
Return the MEASUrement:REFLevel:PERCent:LOW command.
Description
- This command specifies the percent (where 100% is equal to HIGH) used to calculate the
low reference level when
MEASUREMENT:REFLEVEL:METHODis set to Percent. This command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent:LOW?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:PERCent:LOW valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:PERCent:LOW <NR3>
- MEASUrement:REFLevel:PERCent:LOW?
Info
<NR3>is a floating point number that specifies the low reference level, ranging from 0 to 100%. The default low reference level is 10%.
mid
property
¶
Return the MEASUrement:REFLevel:PERCent:MID<x> command.
Description
- This command specifies the percent (where 100% is equal to HIGH) that is used to
calculate a mid reference level. There are two mid reference levels; thus, MID
can be either MID1 or MID2. This command applies when the command MEASUREMENT:REFLEVEL:METHODhas been set to Percent. This command is equivalent to setting the Reference Levels in the MEASURE menu on the oscilloscope front panel.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:PERCent:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:PERCent:MID<x> <NR3>
- MEASUrement:REFLevel:PERCent:MID<x>?
Info
<NR3>is a floating point number that specifies the mid reference level, ranging from 0 to 100%. The default mid reference level is 50%.
MeasurementReflevelPercentHigh
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:REFLevel:PERCent:HIGH command.
Description
- This command specifies the percent (where 100% is equal to HIGH) used to calculate the
high reference level when
MEASUREMENT:REFLEVEL:METHODis set to Percent. This command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent:HIGH?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent:HIGH?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:PERCent:HIGH valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:PERCent:HIGH <NR3>
- MEASUrement:REFLevel:PERCent:HIGH?
Info
<NR3>is a floating point number that specifies the high reference level, ranging from 0 to 100%. The default high reference level is 90%.
MeasurementReflevelPercentLow
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:REFLevel:PERCent:LOW command.
Description
- This command specifies the percent (where 100% is equal to HIGH) used to calculate the low
reference level when
MEASUREMENT:REFLEVEL:METHODis set to Percent. This command affects the results of rise and fall measurements.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent:LOW?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent:LOW?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:PERCent:LOW valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:PERCent:LOW <NR3>
- MEASUrement:REFLevel:PERCent:LOW?
Info
<NR3>is a floating point number that specifies the low reference level, ranging from 0 to 100%. The default low reference level is 10%.
MeasurementReflevelPercentMidItem
¶
Bases: ValidatedDynamicNumberCmd, SCPICmdWrite, SCPICmdRead
The MEASUrement:REFLevel:PERCent:MID<x> command.
Description
- This command specifies the percent (where 100% is equal to HIGH) that is used to calculate
a mid reference level. There are two mid reference levels; thus, MID
can be either MID1 or MID2. This command applies when the command MEASUREMENT:REFLEVEL:METHODhas been set to Percent. This command is equivalent to setting the Reference Levels in the MEASURE menu on the oscilloscope front panel.
Usage
- Using the
.query()method will send theMEASUrement:REFLevel:PERCent:MID<x>?query. - Using the
.verify(value)method will send theMEASUrement:REFLevel:PERCent:MID<x>?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:REFLevel:PERCent:MID<x> valuecommand.
SCPI Syntax
- MEASUrement:REFLevel:PERCent:MID<x> <NR3>
- MEASUrement:REFLevel:PERCent:MID<x>?
Info
<NR3>is a floating point number that specifies the mid reference level, ranging from 0 to 100%. The default mid reference level is 50%.
MeasurementSource1
¶
Bases: SCPICmdRead
The MEASUrement:SOUrce1 command tree.
Usage
- Using the
.query()method will send theMEASUrement:SOUrce1?query. - Using the
.verify(value)method will send theMEASUrement:SOUrce1?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.sigtype: TheMEASUrement:SOUrce1:SIGTypecommand.
sigtype
property
¶
sigtype: MeasurementSource1Sigtype
Return the MEASUrement:SOUrce1:SIGType command.
Description
- This command sets or queries the type of input signal used for measurement SOURCE
, 1 or 2. To ensure accurate measurements, use this command to specify the input-signal type for the measurement source.
Usage
- Using the
.query()method will send theMEASUrement:SOUrce1:SIGType?query. - Using the
.verify(value)method will send theMEASUrement:SOUrce1:SIGType?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:SOUrce1:SIGType valuecommand.
SCPI Syntax
- MEASUrement:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:SOUrce1:SIGType?
Info
PULSEis for generic signals that are not associated with synchronous communications standards.EYEis for synchronous-communication signals with NRZ-like characteristics (nonreturn to zero).
MeasurementSource1Sigtype
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:SOUrce1:SIGType command.
Description
- This command sets or queries the type of input signal used for measurement SOURCE
, 1 or 2. To ensure accurate measurements, use this command to specify the input-signal type for the measurement source.
Usage
- Using the
.query()method will send theMEASUrement:SOUrce1:SIGType?query. - Using the
.verify(value)method will send theMEASUrement:SOUrce1:SIGType?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:SOUrce1:SIGType valuecommand.
SCPI Syntax
- MEASUrement:SOUrce1:SIGType {PULse|EYE}
- MEASUrement:SOUrce1:SIGType?
Info
PULSEis for generic signals that are not associated with synchronous communications standards.EYEis for synchronous-communication signals with NRZ-like characteristics (nonreturn to zero).
MeasurementStatistics
¶
Bases: SCPICmdRead
The MEASUrement:STATIstics command tree.
Usage
- Using the
.query()method will send theMEASUrement:STATIstics?query. - Using the
.verify(value)method will send theMEASUrement:STATIstics?query and raise an AssertionError if the returned value does not matchvalue.
Properties
.count: TheMEASUrement:STATIstics:COUNtcommand..mode: TheMEASUrement:STATIstics:MODecommand..weighting: TheMEASUrement:STATIstics:WEIghtingcommand.
count
property
¶
count: MeasurementStatisticsCount
Return the MEASUrement:STATIstics:COUNt command.
Description
- This command (no query form) clears existing measurement statistics from memory. This command is equivalent to selecting Measurement Setup from the Measure menu, selecting Statistics, and clicking the Reset button.
Usage
- Using the
.write(value)method will send theMEASUrement:STATIstics:COUNt valuecommand.
SCPI Syntax
- MEASUrement:STATIstics:COUNt {RESET}
Info
RESETclears existing measurement statistics from memory.
mode
property
¶
Return the MEASUrement:STATIstics:MODe command.
Description
- This command controls the operation and display of measurement statistics. This command is equivalent to selecting Measurement Setup from the Measure menu, clicking the Statistics button and then choosing the desired Measurement Format.
Usage
- Using the
.query()method will send theMEASUrement:STATIstics:MODe?query. - Using the
.verify(value)method will send theMEASUrement:STATIstics:MODe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:STATIstics:MODe valuecommand.
SCPI Syntax
- MEASUrement:STATIstics:MODe {OFF|ALL|VALUEMean|MINMax|MEANSTDdev}
- MEASUrement:STATIstics:MODe?
Info
OFFturns off all measurements. This is the default value.ALLturns on statistics and displays all statistics for each measurement.VALUEMeanturns on statistics and displays the value and the mean (µ) of each measurement.MINMaxturns on statistics and displays the min and max of each measurement.MEANSTDdevturns on statistics and displays the mean and standard deviation of each measurement.
weighting
property
¶
weighting: MeasurementStatisticsWeighting
Return the MEASUrement:STATIstics:WEIghting command.
Description
- This command specifies the time constant for mean and standard deviation statistical accumulations.
Usage
- Using the
.query()method will send theMEASUrement:STATIstics:WEIghting?query. - Using the
.verify(value)method will send theMEASUrement:STATIstics:WEIghting?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:STATIstics:WEIghting valuecommand.
SCPI Syntax
- MEASUrement:STATIstics:WEIghting <NR1>
- MEASUrement:STATIstics:WEIghting?
Info
<NR1>is the number of samples used for the mean and standard deviation statistical accumulations.
MeasurementStatisticsCount
¶
Bases: SCPICmdWrite
The MEASUrement:STATIstics:COUNt command.
Description
- This command (no query form) clears existing measurement statistics from memory. This command is equivalent to selecting Measurement Setup from the Measure menu, selecting Statistics, and clicking the Reset button.
Usage
- Using the
.write(value)method will send theMEASUrement:STATIstics:COUNt valuecommand.
SCPI Syntax
- MEASUrement:STATIstics:COUNt {RESET}
Info
RESETclears existing measurement statistics from memory.
MeasurementStatisticsMode
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:STATIstics:MODe command.
Description
- This command controls the operation and display of measurement statistics. This command is equivalent to selecting Measurement Setup from the Measure menu, clicking the Statistics button and then choosing the desired Measurement Format.
Usage
- Using the
.query()method will send theMEASUrement:STATIstics:MODe?query. - Using the
.verify(value)method will send theMEASUrement:STATIstics:MODe?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:STATIstics:MODe valuecommand.
SCPI Syntax
- MEASUrement:STATIstics:MODe {OFF|ALL|VALUEMean|MINMax|MEANSTDdev}
- MEASUrement:STATIstics:MODe?
Info
OFFturns off all measurements. This is the default value.ALLturns on statistics and displays all statistics for each measurement.VALUEMeanturns on statistics and displays the value and the mean (µ) of each measurement.MINMaxturns on statistics and displays the min and max of each measurement.MEANSTDdevturns on statistics and displays the mean and standard deviation of each measurement.
MeasurementStatisticsWeighting
¶
Bases: SCPICmdWrite, SCPICmdRead
The MEASUrement:STATIstics:WEIghting command.
Description
- This command specifies the time constant for mean and standard deviation statistical accumulations.
Usage
- Using the
.query()method will send theMEASUrement:STATIstics:WEIghting?query. - Using the
.verify(value)method will send theMEASUrement:STATIstics:WEIghting?query and raise an AssertionError if the returned value does not matchvalue. - Using the
.write(value)method will send theMEASUrement:STATIstics:WEIghting valuecommand.
SCPI Syntax
- MEASUrement:STATIstics:WEIghting <NR1>
- MEASUrement:STATIstics:WEIghting?
Info
<NR1>is the number of samples used for the mean and standard deviation statistical accumulations.