Limit Test

SCPI.CALCulate(Ch).SELected.LIMit.STATe

Attribute Detail
Object Type Property (read/write)
Data Type Boolean
Target The active trace of channel Ch,
Ch: channel number 1–16 (see Table 1 on page 25)
Description The ON/OFF state of the limit test function.
Allowable Values True: Limit test function ON
False: Limit test function OFF
Preset Value False
Syntax Dim Status As Boolean
Status = app.SCPI.CALCulate(Ch).SELected.LIMit.STATe
app.SCPI.CALCulate(Ch).SELected.LIMit.STATe = true
Equivalent Softkeys Analysis > Limit Test > Limit Test

SCPI.CALCulate(Ch).SELected.LIMit.DISPlay.STATe

Attribute Detail
Object Type Property (read/write)
Data Type Boolean
Target The active trace of channel Ch,
Ch: channel number 1–16 (see Table 1 on page 25)
Description The ON/OFF state of the limit line display of the limit test function.
Allowable Values True: Limit line display ON
False: Limit line display OFF
Preset Value False
Syntax Dim Status As Boolean
Status = app.SCPI.CALCulate(Ch).SELected.LIMit.DISPlay.STATe
app.SCPI.CALCulate(Ch).SELected.LIMit.DISPlay.STATe = true
Equivalent Softkeys Analysis > Limit Test > Limit Line

SCPI.CALCulate(Ch).SELected.LIMit.DATA

Attribute Detail
Object Type Property (read/write)
Data Type Variant (array of double)
Target The active trace of channel Ch,
Ch: channel number 1–16 (see Table 1 on page 25)
Description The data array, which is the limit line in the limit test function. The array size is 1 + 5N, where N is the number of measuring points.
For the n–th point, where n from 1 to N:
Data(0) The number of limit line segments N is from 0 to 100. Setting 0 clears the limit line;
Data(5n–4) type of the n–th limit line segment;
0: OFF
1: Upper limit
2: Lower limit
3: Single Point limit

Data(5n–3) the stimulus value in the start point of the n–th segment;
Data(5n–2) the stimulus value in the end point of the n–th segment;
Data(5n–1) the response value in the start point of the n–th segment;
Data(5n–0) the response value in the end point of the n–th segment.
Notes If the array size is not 1 + 5N, where N is Data(0), an error occurs (error code 214). If Data(5n – 4) is less than 0 or more than 2, an error occurs (error code 214). When Data(5n–3), Data(5n–2), Data(5n–1) and Data(5n–0) elements are out of allowable range, the value is set to the limit, which is closer to the specified value.
Syntax Dim Data As Variant
Data = app.SCPI.CALCulate(Ch).SELected.LIMit.DATA
app.SCPI.CALCulate(Ch).SELected.LIMit.DATA = Array(1,2,800,900,–10,–10)
Equivalent Softkeys Analysis > Limit Test > Edit Limit Line

SCPI.MMEMory.STORe.LIMit

Attribute Detail
Object Type Property (write only)
Data Type String
Target Active trace of the active channel
Description Saves the limit table into a file with the specified name.
Range up to 254 characters
Syntax app.SCPI.MMEMory.STORe.LIMit = File
Notes If the full path to the file is not specified, the file will be saved to the \Limit subdirectory of the main directory. The files have *.lim extension by default.
Equivalent Softkeys Analysis > Limit Test > Edit Limit Line > Save Limit Table

SCPI.MMEMory.LOAD.LIMit

Attribute Detail
Object Type Property (write only)
Data Type String
Target Active trace of the active channel.
Description Recalls the specified limit table file. The file must be saved by the SCPI.MMEMory.STORe.LIMit property.
Range up to 254 characters
Syntax app.SCPI.MMEMory.LOAD.LIMit = File
Notes If the full path to the file is not specified, the \Limit subdirectory of the main directory will be searched for the file. The limit table files have *.lim extension by default.
Equivalent Softkeys Analysis > Limit Test > Edit Limit Line > Restore Limit Table

SCPI.DISPlay.FSIGn

Attribute Detail
Object Type Property (read/write)
Data Type Boolean
Target Analyzer
Description The ON/OFF state of the Fail sign display, when performing limit test or ripple limit test.
Allowable Values True: Fail sign display ON
False: Fail sign display OFF
Preset Value False
Syntax Dim Status As Boolean
Status = app.SCPI.DISPlay.FSIGn
app.SCPI.DISPlay.FSIGn = true
Equivalent Softkeys Analysis > Limit Test > Fail Sign
Analysis > Ripple Limit > Fail Sign

SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.STIMulus

Attribute Detail
Object Type Property (read/write)
Data Type Double
Target The active trace of channel Ch,
Ch: channel number 1–16 (see Table 1 on page 25)
Description The value of the limit line offset along X–axis.
Range From the stimulus current start value to the stimulus current stop value.
Out of Range No limitation
Preset Value 0
Unit Hz (Hertz) / s (second) / dBm (decibels above 1 milliwatt)
Syntax Dim Value As Double
Value = app.SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.STIMulus
app.SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.STIMulus = 1e6
Equivalent Softkeys Analysis > Limit Test > Limit Lines Offsets > Stimulus Offset

SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.AMPLitude

Attribute Detail
Object Type Property (read/write)
Data Type Double
Target The active trace of channel Ch,
Ch: channel number 1–16 (see Table 1 on page 25)
Description The value of the limit line offset along Y–axis.
Range Varies depending on the trace format.
Out of Range No limitation
Preset Value 0
Unit dB (decibel) / ° (degree) / s (second)
Syntax Dim Value As Double
Value = app.SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.AMPLitude
app.SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.AMPLitude = –10
Equivalent Softkeys Analysis > Limit Test > Limit Line Offsets > Response Offset

SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.MARKer

Attribute Detail
Object Type Method
Target The active trace of channel Ch,
Ch: channel number 1–16 (see Table 1 on page 25)
Description Sets the value of the limit line offset along Y–axis to the active marker value.
Syntax app.SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.MARKer
Equivalent Softkeys Analysis > Limit Test > Limit Line Offsets > Marker > Response Ofs