VectorStar™ MS464xB Series Microwave Vector Network Analyzer Programming Manual : SCPI Commands : :CALCulate{1-16}[:SELected]:LIMit Subsystem
 
:CALCulate{1-16}[:SELected]:LIMit Subsystem
The :CALCulate{1-16}[:SELected]:LIMit subsystem provides limit line configuration and control for the active trace.
Limit Line and Segment Subsystems
Related limit line and segment configuration and control subsystems are:
:CALCulate{1-16}[:SELected]:LIMit Subsystem
:DISPlay Subsystem
:SENSe{1-16}:FSEGMent Subsystem.
:SENSe{1-16}:FSEGMent{1-50} Subsystem.
:SENSe{1-16}:ISEGMent Subsystem.
:SENSe{1-16}:ISEGMent{1-50} Subsystem.
:SENSe{1-16}:SEGMent Subsystem
Trace Subsystems
Related trace subsystems are:
:CALCulate{1-16}:PARameter and :PARameter{1-16} Subsystem
:CALCulate{1-16}:PARameter{1-16}:FSIMulator Subsystem
:CALCulate{1-16}:PARameter{1-16}:SELect Subsystem
:CALCulate{1-16}:PARameter{1-16}:COUPling Subsystem
:CALCulate{1-16}:POLar Subsystem
:CALCulate{1-16}:PROCessing:ORDer Subsystem
:CALCulate{1-16}[:SELected]:CONVersion Subsystem
:CALCulate{1-16}[:SELected]:DATA Subsystem
:CALCulate{1-16}[:SELected]:FORmat Subsystem
:CALCulate{1-16}[:SELected]:MATH Subsystem
:CALCulate{1-16}[:SELected]:MDATA Subsystem
:CALCulate{1-16}[:SELected]:SMITh Subsystem
:CALCulate{1-16}[:SELected]:SMOothing Subsystem
:CALCulate{1-16}[:SELected]:TRACE{1-16}:MARKer{1-12} Subsystem
:CALCulate{1-16}[:SELected]:TDATA Subsystem
:DISPlay Subsystem
:CALCulate{1-16}[:SELected]:LIMit:DATA <block>
:CALCulate{1-16}[:SELected]:LIMit:DATA?
Description
Sets the limit line table for the active trace of the indicated channel.
Returns the limit line table of the active trace of the indicated channel.
Cmd Parameters
<block> Block data formatted as XML. See definition of <block> or <arbitrary block>.
Query Parameters
<block> Block data formatted as XML. See definition of <block> or <arbitrary block>.
Range
NA
Default Value
NA
Syntax Example
:CALC1:LIM:DATA <block>
:CALC1:LIM:DATA?
:CALCulate{1-16}[:SELected]:LIMit:DISPlay[:STATe] <char>
:CALCulate{1-16}[:SELected]:LIMit:DISPlay[:STATe]?
Description
Sets limit display on/off state for the active trace of the indicated channel.
Returns the limit display on/off status for the active trace of the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:LIM:DISP ON
:CALC1:LIM:DISP?
 
:CALCulate{1-16}[:SELected]:LIMit:FAIL?
Description
Query only.
Returns the limit testing result for the active trace of the indicated channel, where:
“0” = The limit passed.
“1” = The limit failed.
Query Parameters
<NR1> The output parameter is an integer.
Range
0 | 1
Default Value
0
Syntax Example
:CALC1:LIM:FAIL?
:CALCulate{1-16}[:SELected]:LIMit:OFF
Description
Sets all limits of the indicated channel off.
No query.
Cmd Parameters
NA
Query Parameters:
NA
Range
NA
Default Value
NA
Syntax Example
:CALC1:LIM:OFF
:CALCulate{1-16}[:SELected]:LIMit:REPort:POINt?
Description
Query only.
Returns the number of points failing limit testing.
Query Parameters
<NR1> The output parameter is an integer.
Range
0 to the current number of set measurement points.
Default Value
0
Syntax Example
:CALC1:LIM:REP:POIN?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:ADD {No argument} | {<char>} | {<char>,<NRf>,<NRf>}
Description
Adds a limit line segment for the active trace on the indicated channel. If the optional parameters are omitted, an empty segment is added.
No query.
Limit Lines for Rectilinear Displays
For rectilinear displays, up to 50 segment lines can be added to each trace display.
Limit Lines for Circular Polar and Smith Chart Displays
For circular displays (Smith Impedance Chart, Smith Admittance Chart, Linear Polar Graph, and Log Polar Graph), two limits can be defined as an Upper Limit and a Lower Limit. For example, the following commands set upper and lower limit lines:
Clears all limit lines
:CALC1:LIM:SEGM:CLE
Adds an upper limit line
:CALC1:LIM:SEGM:ADD UPP
Sets the radius of the upper limit line to 1.321
:CALC1:LIM:SEGM:DEF 1.321
Adds a lower limit line
:CALC1:LIM:SEGM:ADD LOW
Sets the radius of the lower limit line to 0.395
:CALC1:LIM:SEGM:DEF 0.395
Limit Lines for Eye-diagram Displays
For eye-diagram displays, up to 50 segment lines can be added to each trace display. Limits can be defined as Upper, Lower, or Polygon.
Cmd Parameters
{<No argument>} | {<char>} | {<char>,<NRf>,<NRf>}
<No argument> If no argument is added to the command, the command adds an empty segment.
<char> UPPer | LOWer | POLYgon | POL1ygon | POL2ygon | POL3ygon| NONe
where POLYgon is valid only for NRZ Signaling type and POL1ygon | POL2ygon | POL3ygon are valid only for PAM-4 Signaling type.
<NRf> Start time, frequency, or distance for X1.
<NRf> Stop time, frequency, or distance for X2.
Range
NA
Default Value
NA
Syntax Example
:CALC1:LIM:SEGM:ADD UPP, 2.0E9, 3.0E9
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:CLEar
Description
Clears all the limit segment definitions on the active trace of the indicated channel.
No query.
Cmd Parameters
NA
Query Parameters
NA
Range
NA
Default Value
NA
Syntax Example
:CALC1:LIM:SEGM:CLE
 
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:COUNt?
Description
Query only.
Returns the number of limit segments defined on the active trace of the indicated channel.
Query Parameters
<NR1> The output parameter is an integer.
Range
0 to 50
Default Value
0
Syntax Example
:CALC1:LIM:SEGM:ADD UPPER, 2.0E9, 3.0E9
:CALC1:LIM:SEGM:COUN?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:DEFine <NRf> | <NRf>,<NRf> | <NRf>,<NRf>,<NRf>,<NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:DEFine?
Description
Defines a limit line segment for an added segment for the active trace of the indicated channel.
Returns the current limit line segment for the active trace of the indicated channel.
If only one <NRf> parameter is set, it defines the limit radius for a circular display.
If two <NRf> parameters are used, it defines the Y1 start value and the Y2 stop value.
If four <NRf> parameters are used, it defines the Y1 start value and the Y2 stop value for the upper trace in a dual trace display, and the Y12 (Y1sub in the GUI) start value and the Y22 (Y2sub in the GUI) stop value for the lower trace in a dual trace display.
Cmd Parameters
<NRf> | <NRf>,<NRf> | <NRf>,<NRf>,<NRf>,<NRf>
Query Parameters
<NRf> | <NRf>,<NRf> | <NRf>,<NRf>,<NRf>,<NRf>
Range
NA
Default Value
NA
Syntax Example
:CALC1:LIM:SEGM:DEF 0.75
:CALC1:LIM:SEGM:DEF?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:RADius <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:RADius?
Description
Sets the radius value of the current circular limit line segment being defined for the active trace of the indicated channel.
Returns the radius value of the current circular limit line segment being defined for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM:RAD 0.75
:CALC1:LIM:SEGM:RAD?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:TYPe <char>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:TYPe?
Description
Sets the limit line type of the current limit line segment being defined for the active trace of the indicated channel where:
UPPer = Upper limit line
LOWer = Lower limit line
POLYgon = Polygon limit line, valid only for Time eye-diagram trace with NRZ signaling type
POL1ygon = Polygon1 limit line, valid only for Time eye-diagram trace with PAM-4 signaling type
POL2ygon = Polygon2 limit line, valid only for Time eye-diagram trace with PAM-4 signaling type
POL3ygon = Polygon3 limit line, valid only for Time eye-diagram trace with PAM-4 signaling type
NONe = No limit line
Returns the limit line type of the current limit line segment being defined for the active trace of the indicated channel.
Note: The limit line must exist before using this command. If no limit lines have been created, use the prerequisite command below to add one or more limit lines:
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:ADD {No argument} | {<char>} | {<char>,<NRf>,<NRf>}
This adds one (1) limit segment which permits the example below to work.
Cmd Parameters
<char> UPPer | LOWer | POLYgon | POL1ygon | POL2ygon | POL3ygon | NONe
Query Parameters
NA
Output
<char> UPP | LOW | POLY | POL1 | POL2 | POL3 | NON
Range
NA
Default Value
NON
Syntax Example
:CALC1:LIM:SEGM:TYP POLY
:CALC1:LIM:SEGM:TYP?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:X1 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:X1?
Description
Sets the start X (X1) value of the current limit line segment being defined for the active trace of the indicated channel.
Returns start X (X1) value of the current limit line segment being defined for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM:X1 10E9
:CALC1:LIM:SEGM:X1?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:X2 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:X2?
Description
Sets the stop X value of the current limit line segment being defined for the active trace of the indicated channel.
Returns stop X value of the current limit line segment being defined for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM:X2 20E9
:CALC1:LIM:SEGM:X2?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y1 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y1?
Description
Sets the start Y value of the current limit line segment being defined for the active trace of the indicated channel.
Returns the start Y value of the current limit line segment being defined for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM:Y1 10
:CALC1:LIM:SEGM:Y1?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y12 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y12?
Description
Sets the start Y value of the bottom graph current limit line segment being defined for the active trace of the indicated channel.
Returns start Y value of the bottom graph current limit line segment being defined for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM:Y12 15
:CALC1:LIM:SEGM:Y12?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y2 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y2?
Description
Sets the stop Y value of the current limit line segment being defined for the active trace of the indicated channel.
Returns the stop Y value of the current limit line segment being defined for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM:Y2 20
:CALC1:LIM:SEGM:Y2?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y22 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:Y22?
Description
Sets the stop Y22 value of the bottom graph current limit line segment being defined for the active trace of the indicated channel.
Returns the stop Y22 value of the bottom graph current limit line segment being defined for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM:Y22 17
:CALC1:LIM:SEGM:Y22?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:DEFine <NRf> | <NRf>,<NRf> | <NRf>,<NRf>,<NRf>,<NRf>}
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:DEFine?
Description
Defines the indexed limit line segment for the active trace of the indicated channel. The limit segment must exist.
Returns the indexed limit line segment for the active trace of the indicated channel.
Note that if a :SYSTem:PRESet command is issued where the :SYSTem:PRESet:TYPe RESET command has been previously set, any user-defined segmented limit lines are cleared and the query generates an error.
One <NRf> Parameter
If only one <NRf> parameter is set, it defines the limit radius for a circular display.
Two <NRf> Parameters
If two <NRf> parameters are used, it defines the Y1 start value and the Y2 stop value.
Four <NRf> Parameters
If four <NRf> parameters are used, it defines the Y1 start value and the Y2 stop value for the upper trace in a dual trace display, and the Y12 (Y1sub in the GUI) start value and the Y22 (Y2sub in the GUI) stop value for the lower trace in a dual trace display.
Cmd Parameters
<NRf> | <NRf>,<NRf> | <NRf>,<NRf>,<NRf>,<NRf>
Query Parameters
<NRf> | <NRf>,<NRf> | <NRf>,<NRf>,<NRf>,<NRf>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM1:DEF 2.0000000000E010
:CALC1:LIM:SEGM1:DEF?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:DELete
Description
Deletes the indicated limit line segment of the active trace of the indicated channel.
No query.
Cmd Parameters
NA
Query Parameters
NA
Output
NA
Range
NA
Default Value
NA
Example
:CALC1:LIM:SEGM1:DEL
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:RADius <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:RADius?
Description
Sets the radius value of the indicated circular limit line segment for the active trace of the indicated channel.
Returns the radius value of the indicated circular limit line segment for the active trace of the indicated channel.
The indicated circular limit line must exist. To create a limit line to edit, use:
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:ADD {No argument} | {<char>} | {<char>,<NRf>,<NRf>}.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEG:ADD
:CALC1:LIM:SEGM1:RAD 0.75
:CALC1:LIM:SEGM1:RAD?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:TYPe <char>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:TYPe?
Description
Sets the limit line type of the indicated limit line segment for the active trace of the indicated channel where:
UPPer = Upper limit line
LOWer = Lower limit line
POLYgon = Polygon limit line
POLYgon = Polygon limit line, valid only for Time eye-diagram trace with NRZ Signaling type
POL1ygon = Polygon1 limit line, valid only for Time eye-diagram trace with PAM-4 Signaling type
POL2ygon = Polygon2 limit line, valid only for Time eye-diagram trace with PAM-4 Signaling type
POL3ygon = Polygon3 limit line, valid only for Time eye-diagram trace with PAM-4 Signaling type
NONe = No limit line
Returns the limit line type of the indicated limit line segment for the active trace of the indicated channel.
Note: The limit line must exist before using this command. If no limit lines have been created, use the prerequisite command below to add one or more limit lines:
:CALCulate{1-16}:LIMit:SEGMent:ADD
This adds one (1) limit segment which permits the example below to work.
Cmd Parameters
<char> UPPer | LOWer | POLYgon | POL1ygon | POL2ygon | POL3ygon | NONe
Query Parameters
NA
Output
<char> UPP | LOW | POLY | POL1 | POL2 | POL3 | NON
Range
NA
Default Value
NON
Syntax Example
:CALC1:LIM:SEGM1:TYP POLY
:CALC1:LIM:SEGM1:TYP?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:X1 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:X1?
Description
Sets the start X1 value of the indicated limit line segment for the active trace of the indicated channel. For a dual trace rectilinear display, this sets the X1 start value for both the upper and lower traces.
Returns start X1 value of the indicated limit line segment for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM1:X1 10E9
:CALC1:LIM:SEGM1:X1?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:X2 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:X2?
Description
Sets the stop X2 value of the indicated limit line segment for the active trace of the indicated channel.
For a dual trace rectilinear display, this sets the X1 start value for both the upper and lower traces.
Returns stop X2 value of the indicated limit line segment for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM1:X2 20E9
:CALC1:LIM:SEGM1:X2?
 
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y1 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y1?
Description
Sets the start Y1 value of the indicated limit line segment for the active trace of the indicated channel. For a dual trace rectilinear display, this sets the Y1 start value for only the upper trace.
Returns the start Y1 value of the indicated limit line segment for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM1:Y1 10
:CALC1:LIM:SEGM1:Y1?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y12 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y12?
Description
Only for use on dual rectilinear displays. If a single rectilinear display is used, the value is accepted but no change is made to the trace display.
Sets the start Y12 value of the bottom graph indicated limit line segment for the active trace of the indicated channel.
Returns start Y12 value of the bottom graph indicated limit line segment for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM1:Y12 15
:CALC1:LIM:SEGM1:Y12?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y2 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y2?
Description
Sets the stop Y2 value of the indicated limit line segment for the active trace of the indicated channel.
For a dual trace rectilinear display, this sets the Y2 stop value for the upper trace only.
Returns the stop Y2 value of the indicated limit line segment for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM1:Y2 20
:CALC1:LIM:SEGM1:Y2?
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y22 <NRf>
:CALCulate{1-16}[:SELected]:LIMit:SEGMent{1-50}:Y22?
Description
Only for use on dual rectilinear displays. If a single rectilinear display is used, the value is accepted but no change is made to the trace display.
Sets the stop Y22 value of the bottom graph indicated limit line segment for the active trace of the indicated channel.
Returns the stop Y22 value of the bottom graph indicated limit line segment for the active trace of the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:LIM:SEGM1:Y22 17
:CALC1:LIM:SEGM1:Y22?
:CALCulate{1-16}[:SELected]:LIMit[:STATe] <char>
:CALCulate{1-16}[:SELected]:LIMit[:STATe]?
Description
Sets limit testing on/off state for the active trace of the indicated channel.
Returns the limit testing on/off status for the active trace of the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:LIM
:CALC1:LIM?