VectorStar™ MS4640A SeriesMicrowave Vector Network Analyzer : 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}: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}: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]:TDATA Subsystem
:DISPlay Subsystem
 
:CALCulate{1-16}[:SELected]:LIMit:DATA <block>
:CALCulate{1-16}[:SELected]:LIMit:DATA?
Description
The command inputs the limit line table for the active trace of the given channel. Outputs the limit line table of the active trace of the given 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] <char1>
:CALCulate{1-16}[:SELected]:LIMit:DISPlay[:STATe]?
Description
The command turns limit display on/off for the active trace of the indicated channel. The query outputs the limit display on/off status for the active trace of the given channel.
Cmd Parameters
<char1> 1 | 0 | ON | OFF
Query Parameters
<char1> 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. The query outputs the limit testing result for the active trace of the given 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
The query turns 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. The query outputs 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} | {<char1>} | {<char1>,<NRf>,<NRf>}
Description
On the indicated channel, the command adds a limit line segment for the active trace. 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
Cmd Parameters
{<No argument>} | {<char1>} | {<char1>,<NRf>,<NRf>}
<No argument> If no argument is added to the command, the command adds an empty segment.
<char1> NONE | UPPer | LOWER
<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 UPPER, 2.0E9, 3.0E9
 
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:CLEar
Description
The command 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. Outputs 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
The command defines a limit line segment for an added segment for the active trace of the indicated channel. Output 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. Outputs 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:ADD
:CALC1:LIM:SEGM:RAD 0.75
:CALC1:LIM:SEGM:RAD?
 
:CALCulate{1-16}[:SELected]:LIMit:SEGMent:TYPe <char1>
: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
NONe = No limit line
Outputs the limit line type of the current limit line segment being defined for the active trace of the indicated channel.
Note that 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
<char1>: UPPer | LOWer | NONe
Query Parameters
NA
Output
<char1>: UPP | LOW | NON
Range
NA
Default Value
NON
Syntax Example
:CALC1:LIM:SEGM:ADD
:CALC1:LIM:SEGM:TYP UPP
: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. Outputs 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. Outputs 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. Outputs 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. Outputs 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. Outputs 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. Outputs 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
Define the indexed limit line segment for the active trace of the indicated channel. The limit segment must exist. Output the indexed limit line segment for the active trace of the indicated channel.
Note that if a :SYSTem:PRESet is issued where the :SYSTem:PRESet:TYPe RESET 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. Outputs 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}:LIMit:SEGMent:ADD
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 <char1>
: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
NONe = No limit line
Outputs the limit line type of the indicated limit line segment for the active trace of the indicated channel.
Note that 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
<char1> UPPer | LOWer | NONe
Query Parameters
NA
Output
<char1> UPP | LOW | NON
Range
NA
Default Value
NON
Syntax Example
:CALC1:LIM:SEGM:ADD
:CALC1:LIM:SEGM1:TYP UPP
: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. Outputs 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.
Outputs 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.
Outputs 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 rectinlinear 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.
Outputs 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.
Outputs 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 rectinlinear 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.
Outputs 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] <char1>
:CALCulate{1-16}[:SELected]:LIMit[:STATe]?
Description
The command turns limit testing on/off for the active trace of the indicated channel. The query outputs the limit testing on/off status for the active trace of the given channel.
Cmd Parameters
<char1> 1 | 0 | ON | OFF
Query Parameters
<char1> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:LIM
:CALC1:LIM?