Calc:Limit Commands

CALCulate:MEASure:LIMit:

DATA

| DELete

DISPlay

       | [STATe]

FAIL?

SEGMent

| AMPLitude

| STARt                               

| STOP

| STIMulus

| STARt

| STOP

| TYPE

SOUNd

| [STATe]

REPort

| ALL?

| [DATA]?

| POINts?

[STATe]

CALCulate:MEASure:BLIMit:

DISPlay

| MARKer

| STATe

| BWIDth

| THReshold

FAIL

MAXimum

MINimum

REPort

| DATA

STATe

CALCulate:MEASure:RLIMit:

DATA

DISPlay

| LINE

| STATe

| RIPPle

| SELect

| TYPE

| STATe

FAIL

REPort:DATA

STATe

(Read-Write) Sets data for limit segments.

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.

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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

Examples

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

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

Query Syntax

CALCulate<cnum>:MEASure<mnum>:LIMit:DATA?

Return Type

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

Default

100 limit segments - all values set to 0

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

Examples

CALC:MEAS:LIM:DATA:DEL

Query Syntax

Not Applicable

Default

Not Applicable

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

<bool>

Select limit segments from the following:

ON or 1 - Turns the display of limit segments ON.
OFF or 0 - Turns the display of limit segments OFF.

Examples

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

Query Syntax

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

Return Type

Boolean

Default

OFF

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

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

Notes: When the limit test is set to OFF, False or OFF is always read out.

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

Examples

CALC:MEAS:LIM:FAIL?

Return Type

Boolean

• 0 is returned when Pass

• 1 is returned when Fail

Default

Not Applicable

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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:MEAS:LIM:SEGM1:AMPL:STAR 10
calculate2:measure2:limit:segment2:amplitude:start 10

Query Syntax

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

Return Type

Numeric

Default

0

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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:MEAS:LIM:SEGM1:AMPL:STOP 10
calculate2:measure2:limit:segment2:amplitude:stop 10

Query Syntax

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

Return Type

Numeric

Default

0

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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:MEAS:LIM:SEGM1:STIM:STAR 10
calculate2:measure2:limit:segment2:stimulus:start 10

Query Syntax

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

Return Type

Numeric

Default

0

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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:MEAS:LIM:SEGM1:AMPL:STOP 10
calculate2:measure2:limit:segment2:stimulus:stop 10

Query Syntax

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

Return Type

Numeric

Default

0

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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:MEAS:LIM:SEGM:TYPE LMIN
calculate2:measure2:limit:segment3:type lmax

Query Syntax

CALCulate<cnum>:measure2:LIMit:SEGMent<snum>:TYPE | TYPe  ?

Return Type

Character

Default

OFF

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

<bool>

ON or 1 - Turns limit testing ON.
OFF or 0 - Turns limit testing OFF.

Examples

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

Query Syntax

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

Return Type

Boolean

Default

OFF

(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.

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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:MEAS:LIM:REP:ALL?

Return Type

Variant

Default

Depend on the preset status

(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.

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> 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:MEAS:LIM:REP:DATA?

Return Type

Numeric

Default

9.91E37

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

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

Examples

CALC:MEAS:LIM:REP:POIN?

Query Syntax

Numeric

Default

0

(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.

Parameters

<cnum>

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

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

<bool>

ON or 1 - Turns limit testing ON.
OFF or 0 - Turns limit testing OFF.

Examples

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

Query Syntax

CALCulate<cnum>:MEASure<mnum>:LIMit:STATe?

Return Type

Boolean

Default

OFF or 0

(Read-Write) Turns ON/OFF the bandwidth value display of the bandwidth test, for the active trace of selected channel.

Parameters

<cnum>

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

<bool>

ON or 1 - Turns limit testing ON.
OFF or 0 - Turns limit testing OFF.

Examples

CALC:BLIM:DISP:MARK:STAT ON
calculate2:measure2:blimit:display:marker:state off

Query Syntax

CALCulate<cnum>:BLIMit:DISPLay:BWIDth:STATe?

Return Type

Boolean

Default

OFF

(Read-Write) Sets bandwidth threshold value (attenuation from the peak) of the bandwidth test.

Parameters

<cnum>

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

<value>

Bandwidth N dB points

Examples

CALC:BLIM:DISP:BWID:THR 5
calculate2:measure2:blimit:display:bwidth:threshold 5

Query Syntax

CALCulate<cnum>:BLIMit:DISPLay:BWIDth:THReshold?

Return Type

Numeric

Default

3

(Read-only) Get the bandwidth limit test results, for the active trace of selected channel.

Parameters

<cnum>

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

<bool>

Boolean

• 0 is returned when Pass

• 1 is returned when Fail

Examples

CALC:BLIM:FAIL?
calculate2:blimit:fail?

Query Syntax

CALCulate<cnum>:BLIMit:FAIL?

Return Type

Boolean

Default

Not Applicable

(Read-Write) Sets/gets the upper limit value of the bandwidth test, for the selected channel).

Parameters

<cnum>

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

<max>

Maximum bandwidth

Examples

CALC:BLIM:MAX 1E6
calculate2:blimit:maximum 1E6

Query Syntax

CALCulate<cnum>:BLIMit:MAXimum?

Return Type

Numeric

Default

(Read-Write) Sets or returns the lower limit value of the bandwidth test, for the selected channel.

Parameters

<cnum>

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

<Minl>

Minimum bandwidth

Examples

CALC:BLIM:MIN 1E6
calculate2:blimit:minimum 1E6

Query Syntax

CALCulate<cnum>:BLIMit:MINimum?

Return Type

Numeric

Default

(Read-only) Read the bandwidth value of the bandwidth test, for the active trace of selected channel.

Parameters

<cnum>

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

<data>>

Examples

CALC:BLIM:REP:DATA?
calculate2:blimit:report:data?

Query Syntax

CALCulate<cnum>:BLIMit:REPort:DATA?

Return Type

Variant

Default

OFF

(Read-Write) Turns ON/OFF the bandwidth test function, for the active trace of selected channel.

Parameters

<cnum>

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

<bool>

ON or 1 - Turns limit testing ON.
OFF or 0 - Turns limit testing OFF.

Examples

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

Query Syntax

CALCulate<cnum>:BLIMit:DIPLay:MARKer:STATe?

Return Type

Boolean

Default

OFF

(Read-Write) Sets or returns the ripple limit table for the active trace of selected channel.

Parameters

<cnum>

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

<data>

Indicates the array data (for ripple line) of 1 + Num (number of limit lines)* 4. Where n is an integer between 1 and Num.

• Data(0) :The number of limit lines you want to set. Specify an integer ranging 0 to 12. When the number of limit lines is set to 0 (clears the limit table), the variable Data is only required with Data(0).

• Data(nx4-3) :The type of the n-th line.

Specify an integer 0 to 1 as follows.

0: OFF

1: ON

• Data(nx4-2) :The value on the horizontal axis (frequency/power/time) of the start point of the n-th line.

• Data(nx4-1) :The value on the horizontal axis (frequency/power/time) of the end point of the n-th line.

• Data(nx4) :The ripple line value (dB) of the n-th line.

The index of the array starts from 0.

Examples

CALC:RLIM:DATA
calculate2:rlimit:data

Query Syntax

CALCulate<cnum>:MEASure<mnum>:RLIMit:DATA?

Return Type

Variant type Array

Default

OFF

(Read-Write) Turns ON/OFF the ripple limit line display, for the active trace of selected channel.

Parameters

<cnum>

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

<bool>

ON or 1 - Turns limit testing ON.
OFF or 0 - Turns limit testing OFF.

Examples

CALC:RLIM:DISP:LINE:STAT ON
calculate2:rlimit:display:line:state off

Query Syntax

CALCulate<cnum>:MEASure<mnum>:RLIMit:DISPLay:LINE:STATe?

Return Type

Boolean

Default

OFF

(Read-Write) Sets or gets the ripple limit band for ripple value display for selected channel.

Parameters

<cnum>

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

<band>

 1 to 12

Examples

CALC:RLIM:DISP:RIPP:SEL

calculate2:rlimit:display:ripple:select

Query Syntax

CALCulate<cnum>:MEASure<mnum>:RLIMit:DISPlay:SELect?

Return Type

Numeric

Default

1

(Read-Write) Sets/gets the display type of ripple value for the active trace of selected channel.

Parameters

<cnum>

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

<typ>

Select from the following:

• "OFF": Specifies the display OFF.

• "ABSolute": Specifies the absolute value for display type.

• "MARgin": Specifies the margin for display type.

Examples

CALC:RLIM:DISP:TYPE
calculate2:rlimit:display:type

Query Syntax

CALCulate<cnum>:MEASure<mnum>:RLIMit:DISPLay:TYPE?

Return Type

Boolean

Default

OFF

(Read-Write) Turns ON/OFF the ripple test function for the active trace of selected channel.

Parameters

<cnum>

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

<bool>

ON or 1 - Turns limit testing ON.
OFF or 0 - Turns limit testing OFF.

Examples

CALC:RLIM:DISP:RIPP:STAT ON
calculate2:rlimit:display:ripple:state off

Query Syntax

CALCulate<cnum>:RIMit:DISPlay:STATe?

Return Type

Boolean

Default

OFF

(Read-only) Read the ripple test result for the active trace.

Parameters

<cnum>

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

<bool>

Boolean

• 0 is returned when Pass

• 1 is returned when Fail

Examples

CALC:RLIM:FAIL?
calculate2:Rlimit:FAIL?

Query Syntax

CALCulate<cnum>:MEASure<mnum>:RLIMit:FAIL?

Return Type

Boolean

Default

Not Applicable

(Read-only) Reads the ripple value of the ripple test for the active trace.

Parameters

<cnum>

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

<data>

{numeric 1} ... {numeric NOP×3+1}<newline><^END>

NOP is the number of measurement points.

• {numeric 1}: Number of ripple limit line

• {numeric n×3-1} : Number of ripple limit bands.

• {numeric n×3} : Ripple value.

• {numeric n×3+1} : Ripple test result (1: Fail, 0: Pass)

Examples

CALC:RLIM:REP:DATA?

calculate2:rlimit:report:data?

Query Syntax

CALCulate<cnum>:MEASure<mnum>:RLIMit:REPort:DATA?

Return Type

Variant

Default

OFF

(Read-Write) Turns ON/OFF the ripple test function for the active trace of selected channel.

Parameters

<cnum>

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

<bool>

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

Examples

CALC:RLIM:STAT ON
calculate2:rlimit:state off

Query Syntax

CALCulate<cnum>:RLIMit:STATe?

Return Type

Boolean

Default

OFF

18-May-2016

First Release