Limit Control Data

This command sets or queries the control data (X-axis values) for the specified limit.

The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

This command takes a list of one or more frequency values as parameters. For example: CALC:LIM1:CONT:DATA 1 MHz, 2MHz, 3MHz

Note that it is permitted to set one or more invalid 'placeholder' values of Not-A-Number (NAN). The placeholder value for NAN is 9.91e37. If a control data point contains a value of 9.91e37, limit line interpolation from the previous data point, and to the next data point, will not occur. This is useful for defining discontiguous (or segmented) limit lines within a single limit.

For example, to define a limit line of two discontiguous segments, one from 1 MHz to 10 MHz, and another from 20 MHz to 30 MHz, send the following control data:

CALC:LIM1:CONT:DATA 1MHz, 10MHz, 9.91e37, 20MHz, 30MHz.

Note that the upper (or lower) data, if used, should contain the same amount of points as the control data (see CALC:LIM:FAIL? for details on what happens when this is not true). Thus, when using placeholders in control data, it is recommended that placeholders are also used in the upper (or lower) data.

For example:

The exact value for the middle point does not matter, as interpolation will always be skipped due to the control data containing NAN, but using NAN for the corresponding upper (or lower) data value will make it easier to remember that the point is a placeholder.

<frequency list>

Lower Limit Data

This command sets or queries the lower limit data (Y-axis values) for the specified limit. The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1. If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON). This command takes a list of one or more amplitude values as parameters. For example,

CALC:LIM1:LOW:DATA 1 dBm, 2 dBm, 3 dBm

Note that it is permitted to set one or more data values of +/- infinity. The placeholder value for +/- infinity is +/-9.9e37. If a lower data point contains a value of +/-9.9e37, the amplitude at that point will be treated as if it were +/- infinity (i.e. the lower limit will either always fail or always pass at that point).

It is also permitted to set one or more invalid 'placeholder' values of Not-A-Number (NAN). This is useful for defining discontiguous (or segmented) limit lines within a single limit. For details, and an example, of using placeholder values, see CALC:LIM:CONT:DATA.

<amplitude list>

Upper Limit Data

This command sets or queries the upper limit data (Y-axis values) for the specified limit. The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1. If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON). This command takes a list of one or more amplitude values as parameters. For example, CALC:LIM1:UPP:DATA 1 dBm, 2dBm, 3 dBm.

Note that it is permitted to set one or more data values of +/- infinity. The placeholder value for +/- infinity is +/-9.9e37. If an upper data point contains a value of +/-9.9e37, the amplitude at that point will be treated as if it were +/-infinity (i.e. the upper limit will either always pass or always fail at that point). It is also permitted to set one or more invalid 'placeholder' values of Not-A-Number (NAN). This is useful for defining discontiguous (or segmented) limit lines within a single limit. For details, and an example, of using placeholder values, see CALC:LIM:CONT:DATA.

<amplitude list>

Limit Active

Queries the numbers of all active limit lines in ascending order.This command returns a empty string if no limits are active.

Limit Comment

Associates a user-defined comment with each limit. The set version of this command takes a single parameter that is a string containing the desired comment. The query version returns the comment that is set.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<string>

Limit Alarm

This command enables/disables the AAE notification for limit failures.

<0 | 1 | ON | OFF>

0 | 1

OFF

Limit Comment

Associates a user-defined comment with each limit. The set version of this command takes a single parameter that is a string containing the desired comment. The query version returns the comment that is set.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<string>

Limit Control Data

This command sets or queries the control data (X-axis values) for the specified limit.

The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

This command takes a list of one or more frequency values as parameters. For example,

CALC:LIM1:CONT:DATA 1 MHz, 2MHz, 3MHz

Note that it is permitted to set one or more invalid ’placeholder’ values of Not-A-Number (NAN). The placeholder value for NAN is 9.91e37. If a control data point contains a value of 9.91e37, limit line interpolation from the previous data point, and to the next data point, will not occur. This is useful for defining discontiguous (or segmented) limit lines within a single limit.

For example, to define a limit line of two discontiguous segments, one from 1 MHz to 10 MHz, and another from 20 MHz to 30 MHz, send the following control data:

CALC:LIM1:CONT:DATA 1MHz, 10MHz, 9.91e37, 20MHz, 30MHz

Note that the upper (or lower) data, if used, should contain the same amount of points as the control data (see CALC:LIM:FAIL? for details on what happens when this is not true). Thus, when using placeholders in control data, it is recommended that placeholders are also used in the upper (or lower) data. For example,

CALC:LIM1:CONT:UPP 0dBm, 10dBm, 9.91e37, 10dBm, 0dBm

The exact value for the middle point does not matter, as interpolation will always be skipped due to the control data containing NAN, but using NAN for the corresponding upper (or lower) data value will make it easier to remember that the point is a placeholder.

<numeric_value> {HZ | KHZ | MHZ | GHZ}, {<numeric_value> {HZ | KHZ | MHZ | GHZ}}, ...

Limit Control Mode

Choose either ABSolute or RELative limit.

In ABSolute mode, the control value of the limit line is defined by absolute physical values (Hz).

In RELative mode, the control value of the limit line is relative to the center frequency (Hz).

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<char>

Limit Control Shift

Move a limit line along the control axis. This command changes the value of:

:CALCulate<n>:LIMit<k>:CONTrol[:DATA]

Issuing this command multiple times will change the limits each time will shift the control axis by 5 Hz.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<freq>

Issuing this command multiple times will change the limits each time.

This will shift the control axis by 5 Hz

Limit Copy

Copies a limit line. For example, :CALC:LIM1:COPY 2 copies limit 1 to line 2. If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<number>

Limit Delete

Deletes a limit line. If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

Limit Envelope Offset

This command sets/gets the limit envelope offset. This defines how far away from the measured signal indicated the limit envelope is placed. Use :CALCulate:LIMit:TYPe to set the currently active limit line.

<numeric_value> {DBM}

Numeric (dBm)

3 dBm

dBm

-100 dBm to 100 dBm

Number of Limit Envelope Points

This command sets the number of inflection point for the limit envelope.

<numeric_value>

Numeric

21

2 to 41

Limit Envelope Shape

This command sets/gets the currently active limit envelope shape.

<SQUare|SLOPe>

SQUare

SQUare|SLOPe

Update Limit Envelope Amplitude

This command updates the amplitude of the upper and lower limits without changing the frequencies of the inflection points.

none

Limit Fail

This command queries the result of a limit check. All traces that have had checking enabled (via CALC:TRAC:CHEC) will be evaluated against the upper and lower data of the specified limit, unless the limit STATe is OFF (in which case this command will always return 0), or the upper or lower STATe is OFF (in which case only the data with STATe ON will be checked).

If the sweep has not completed yet, the partial trace will be evaluated. If INITiate:CONTinuous is ON, a snapshot of the trace at the time this command was received will be evaluated against the limit. This command returns 1 if any of the checked traces violate the limit, otherwise it returns 0.

When a limit is evaluated, there are some rules that are followed if the cardinality of the limits control, upper, and lower data are not equal. If there are fewer control data points than upper or lower data points, then only the first n upper or lower points will be evaluated, where n is the number of control points. If there are fewer upper or lower points than control points, then the effective number of upper or lower points will be increased to the number of control points, with the 'extrapolated' points having a value equal to the last upper or lower point.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

Lower Limit Data

This command sets or queries the lower limit data (Y-axis values) for the specified limit.

The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

This command takes a list of one or more amplitude values as parameters. For example,

CALC:LIM1:LOW:DATA 1 dBm, 2dBm, 3 dBm

Note that it is permitted to set one or more data values of +/- infinity. The placeholder value for +/- infinity is +/-9.9e37. If a lower data point contains a value of +/-9.9e37, the amplitude at that point will be treated as if it were +/-inifinity (i.e. the lower limit will either always fail or always pass at that point).

It is also permitted to set one or more invalid ’placeholder’ values of Not-A-Number (NAN). This is useful for defining discontiguous (or segmented) limit lines within a single limit. For details, and an example, of using placeholder values, see CALC:LIM:CONT:DATA.

<numeric_value> {DBM}, {<numeric_value> {DBM}}, ...

Create Lower Limit Envelope

This command is used to create an Lower limit envelope on the selected trace.

none

Limit Lower Mode

Choose either ABSolute or RELative limit.

In ABSolute mode, the control value of the limit line is defined by absolute physical values (dBm).

In RELative mode, the control value of the limit line is relative to the reference level (dB).

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<char>

Lower Limit Shift

Move the lower limit up or down by a relative amplitude. This command changes the value of:

Issuing this command multiple times will change the limits each time.

<relative amplitude>

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

Will shift the lower limit by 5 dB

Lower Limit State

Turns ON or OFF the lower limit.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<boolean>

Limit Name

Associates a user-defined name with each limit. The set version of this command takes a single parameter that is a string containing the desired limit name. The query version returns the name that is set.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<string>

Limit State

Turns the limit check for a specific limit ON or OFF.

When CALC:LIM:STATE is ON, any changes to the limit data or control for that limit will cause CALC:LIM:UPP:STATE and CALC:LIM:LOW:STATE to automatically be set ON.

When CALC:LIM:STATE is OFF, any changes to the limit data or control for that limit will cause CALC:LIM:UPP:STATE and CALC:LIM:LOW:STATE to automatically be set OFF.

<0 | 1 | ON | OFF>

Limit Trace Check

This command turns the limit check for a specific trace on and off.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<0 | 1 | ON | OFF>

Upper Limit Data

This command sets or queries the upper limit data (Y-axis values) for the specified limit.

The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

This command takes a list of one or more amplitude values as parameters. For example,

CALC:LIM1:UPP:DATA 1 dBm, 2dBm, 3 dBm

Note that it is permitted to set one or more data values of +/- infinity. The placeholder value for +/- infinity is +/-9.9e37. If an upper data point contains a value of +/-9.9e37, the amplitude at that point will be treated as if it were +/-inifinity (i.e. the upper limit will either always pass or always fail at that point).

It is also permitted to set one or more invalid ’placeholder’ values of Not-A-Number (NAN). This is useful for defining discontiguous (or segmented) limit lines within a single limit. For details, and an example, of using placeholder values, see CALC:LIM:CONT:DATA.

<numeric_value> {DBM}, {<numeric_value> {DBM}}, ...

Create Upper Limit Envelope

This command is used to create an Upper limit envelope on the selected trace.

none

Upper Limit Mode

Choose either ABSolute or RELative limit.
In ABSolute mode, the control value of the limit line is defined by absolute physical values (dBm).
In RELative mode, the control value of the limit line is relative to the reference level (dB).

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<char>

Upper Limit Shift

Move the upper limit up or down by a relative amplitude. This command changes the value of
:CALCulate<n>:LIMit<k>:UPPer[:DATA].

Issuing this command multiple times will change the limits each time.

CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB

Will shift the upper limit by 5 dB

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<relative amplitude>

Upper Limit State

Turns ON or OFF the upper limit.

If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).

<0 | 1 | ON | OFF>

Peak Count

The desired number of peaks to be reported by FETC:PEAK? query.

<numeric_value>

Numeric

1

1 to 6

Peak Threshold Level

Sets the threshold level which peak powers must exceed to be reported by FETC:PEAK? query.

<numeric_value> {DBM}

Numeric (dBm)

0 dBm

dBm

-150 dBm to 30 dBm

Peak Threshold State

Turn ON|OFF the threshold that peak powers must exceed to be reported by PEAKS? query.

<0 | 1 | ON | OFF>

0 | 1

OFF