Calc:Limit Commands


Controls the limit segments used for pass / fail testing.

These commands are Superseded by the CALCulate:MEASure:LIMit commands.

CALCulate:LIMit:

DATA

       | DELete

DISPlay

       | [STATe]

FAIL?

REPort

       | ALL?

       | DATA?

       | POINts?

SEGMent

       | AMPLitude

            | STARt

            | STOP

       | COUNt?

       | STIMulus

            | STARt

            | STOP

       | TYPE

SOUNd

       | [STATe]

[STATe]

Click on a keyword to view the command details.

See Also

Critical Note: CALCulate commands act on the selected measurement. You can select one measurement for each channel using Calc:Par:MNUM or Calc:Par:Select. Learn more.


CALCulate<cnum>:LIMit:DATA <block>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets data for limit segments.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement for which limit lines are to be set. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<block>

Data for all limit segments in REAL,64 format. The following is the data format for 1 segment:
Type,BegStim, EndStim, BegResp,EndResp

Type

Type of limit segment. Choose from
0 - Off

1 - Max

2 - Min

BegStim

Start of X-axis value (freq, power, time)

EndStim

End of X-axis value

BegResp

Y-axis value that corresponds with Start of X-axis value

EndResp

Y-axis value that corresponds with End of X-axis value

Examples

The following writes three max limit segments for a bandpass filter.

CALC:LIM:DATA 1,3e5,4e9,-60,0,1,4e9,7.5e9,0,0,1,7.5e9,9e9,0,-30

Query Syntax

CALCulate<cnum>:LIMit:DATA?

Return Type

Depends on FORM:DATA - All 100 predefined limit segments are returned.

Default

100 limit segments - all values set to 0


CALCulate<cnum>:LIMit:DATA:DELete

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Write-only) Deletes all limit line data for the selected measurement on the specified channel.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

Examples

CALC2:LIM:DATA:DEL

Query Syntax

Not Applicable

Default

Not Applicable


CALCulate<cnum>:LIMit:DISPlay[:STATe] <ON | OFF>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Turns the display of limit segments ON or OFF (if the data trace is turned ON).

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<ON | OFF>

ON (or 1) - turns the display of limit segments ON.
OFF
(or 0) - turns the display of limit segments OFF.

Examples

CALC:LIM:DISP:STAT ON
calculate2:limit:display:state off

Query Syntax

CALCulate<cnum>:LIMit:DISPlay[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON


CALCulate<cnum>:LIMit:FAIL?

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-only) Returns the Pass / Fail status of the limit line test. Returns 1 (Fail) if any data point fails for any limit segment.

Limit display (CALC:LIM:DISP) does NOT have to be ON.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

Examples

CALC:LIM:FAIL?

Return Type

Boolean

  • 0 is returned when Pass

  • 1 is returned when Fail

Default

Not Applicable


CALCulate<cnum>:LIMit:REPort:ALL? <block>

Applicable Models: N522xB, N523xB, N524xB

(Read-only) Reads the bandwidth test results (stimulus value, limit test result, upper limit value and lower limit value of all measurement points), for the active trace of selected channel.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<block>

Depends on FORM:DATA

If the number of the measurement points is N,

<Block> = <first stimulus>,<test result>,<upper limit>,<lower limit>, …, <Nth stimulus>,<test result>,<upper limit>,<lower limit>

Where <test result>=   -1: No limit, 0:Fail, 1:Pass

Examples

CALC:LIM:REP:ALL?

Return Type

Variant

Default

Depend on the preset status


CALCulate<cnum>:LIMit:REPort[:DATA]? <block>

Applicable Models: N522xB, N523xB, N524xB

(Read-only) Reads the stimulus values (frequency, power level or time) at all the measurement points that failed the limit test, for the active trace of selected channel.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<block>

Depends on FORM:DATA

If the number of the measurement points that failed the limit test is N, <block>=<First failed stimulus>, ..., <Nth failed stimulus>.

Examples

CALC:LIM:REP:DATA?

Return Type

Numeric

Default

9.91E37


CALCulate<cnum>:LIMit:REPort:POINts?

Applicable Models: N522xB, N523xB, N524xB

(Read-only) Reads the number of the measurement points that failed the limit test, for the active trace of selected channel.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

Examples

CALC:LIM:REP:POIN?

Query Syntax

Numeric

Default

0


CALCulate<cnum>:LIMit:SEGMent<snum>:AMPLitude:STARt <num>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets the start (beginning) of the Y-axis amplitude (response) value.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<snum>

Segment number; if unspecified, value is set to 1.

<num>

Choose any number between: -500 and 500

Display value is limited to the Maximum and Minimum displayed Y-axis values.

Examples

CALC:LIM:SEGM1:AMPL:STAR 10
calculate2:limit:segment2:amplitude:start 10

Query Syntax

CALCulate<cnum>:LIMit:SEGMent<snum>AMPLitude:STARt?

Return Type

Numeric

Default

0


CALCulate<cnum>:LIMit:SEGMent<snum>:AMPLitude:STOP <num>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets the stop (end) of the Y-axis amplitude (response) value.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<snum>

Segment number; if unspecified, value is set to 1.

<num>

Choose any number between: -500 and 500

Display value is limited to the Maximum and Minimum displayed Y-axis values.

Examples

CALC:LIM:SEGM1:AMPL:STOP 10
calculate2:limit:segment2:amplitude:stop 10

Query Syntax

CALCulate<cnum>:LIMit:SEGMent<snum>AMPLitude:STOP?

Return Type

Numeric

Default

0


CALCulate<cnum>:LIMit:SEGMent:COUNt?

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-only) Returns the number of segments used in a limit test. All segments are counted, whether they are on or not.

Parameters

Not Applicable

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

Examples

CALC:LIM:SEGM:COUN?

Return Type

Numeric

Default

Not Applicable


CALCulate<cnum>:LIMit:SEGMent<snum>:STIMulus:STARt <num>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets the start (beginning) of the X-axis stimulus value.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<snum>

Segment number; if unspecified, value is set to 1.

<num>

Choose any number within the X-axis span of the analyzer.

Examples

CALC:LIM:SEGM1:STIM:STAR 10
calculate2:limit:segment2:stimulus:start 10

Query Syntax

CALCulate<cnum>:LIMit:SEGMent<snum>STIMulus:STARt?

Return Type

Numeric

Default

0


CALCulate<cnum>:LIMit:SEGMent<snum>:STIMulus:STOP <num>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets the stop (end) of the X-axis stimulus value.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<snum>

Segment number; if unspecified, value is set to 1.

<num>

Choose any number within the X-axis span of the analyzer.

Examples

CALC:LIM:SEGM1:AMPL:STOP 10
calculate2:limit:segment2:stimulus:stop 10

Query Syntax

CALCulate<cnum>:LIMit:SEGMent<snum>STIMulus:STOP?

Return Type

Numeric

Default

0


CALCulate<cnum>:LIMit:SEGMent<snum>:TYPE <char>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets the type of limit segment.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<snum>

Segment number. Choose any number between:
1
and 100
If unspecified, value is set to 1.

<char>

Choose from:
LMAX
- a MAX limit segment. Any response data exceeding the MAX value will fail.

LMIN - a MIN limit segment. Any response data below the MIN value will fail.

OFF - the limit segment (display and testing) is turned OFF.

Examples

CALC:LIM:SEGM:TYPE LMIN
calculate2:limit:segment3:type lmax

Query Syntax

CALCulate<cnum>:LIMit:SEGMent<snum>:TYPE?

Return Type

Character

Default

OFF


CALCulate<cnum>:LIMit:SOUNd[:STATe] <ON | OFF>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Turns limit testing fail sound ON or OFF.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<ON | OFF>

ON (or 1) - turns sound ON.
OFF
(or 0) - turns sound OFF.

Examples

CALC:LIM:SOUN ON
calculate2:limit:sound:state off

Query Syntax

CALCulate<cnum>:LIMit:SOUNd[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF


CALCulate<cnum>:LIMit[:STATe] <ON | OFF>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Turns limit segment testing ON or OFF.

  • Use CALC:LIM:DISP to turn ON and OFF the display of limit segments.

  • If using Global Pass/Fail status, trigger the VNA AFTER turning Limit testing ON.

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<ON | OFF>

ON (or 1) - turns limit testing ON.
OFF
(or 0) - turns limit testing OFF.

Examples

CALC:LIM:STAT ON
calculate2:limit:state off

Query Syntax

CALCulate<cnum>:LIMit:STATe?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF