Limit SCPI

M9370A / M9371A / M9372A / M9374A / M9375A

Calc:Limit Commands


Controls the limit segments used for pass / fail testing.

CALCulate:LIMit:

DATA

       | DELete

DISPlay

       | [STATe]

FAIL?

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>

(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

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

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

(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:SEGMent<snum>:AMPLitude:STARt <num>

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

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

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

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

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

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

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

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


Last Modified:

10-Jan-2011

Minor edits

31-Oct-2008

Added Delete and Fail commands (8.33)