This subsystem defines the limit lines and controls the limit check.
Limit Alarm
:CALCulate:LIMit:ALARm
Description
Enables/disables the active trace currently selected limit line alarm. Setting the value to ON or 1 turns on the active trace limit alarm. Setting the value to OFF or 0 turns off the active trace limit alarm. The query version of the command returns a 1 if the active trace currently selected limit line alarm is set to ON and returns 0 if set to OFF. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
:CALCulate:LIMit:ALARm OFF :CALCulate:LIMit:ALARm 0
To turn on limit alarm
:CALCulate:LIMit:ALARm ON :CALC:LIM:ALAR 1
Related Command
:CALCulate:LIMit:TYPE
Front Panel Access
Shift 6 (Limit), Limit Alarm
Limit Fail
:CALCulate<Tr>:LIMit:FAIL?
Description
Returns the fail status of the given trace <Tr> based on the limits. The limit and the limit message must be ON in order to return a valid boolean value. If either or both limits fail, then a 1 is returned.
<Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Syntax:
:CALCulate<Tr>:LIMit:FAIL?
Cmd Parameter
NA (query Only)
Cmd Parameter
<NR1> <integer>
Example
To query the fail status on trace 2:
CALCulate2:LIMit:FAIL?
:CALC2:LIM:FAIL?
Related Command
:CALCulate:LIMit[:STATe]
:CALCulate<Tr>:LIMit:PFMessage
Front Panel Access
NA
Lower Limit Fail State
:CALCulate<Tr>:LIMit:LOWer:FAIL?
Description
Returns the fail status of the given trace <Tr>. The lower limit and the limit message must be ON in order to return a valid boolean value. If the lower limit fails, then a 1 is returned. Otherwise, a 0 is returned. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Syntax:
:CALCulate<Tr>:LIMit:LOWer:FAIL?
Cmd Parameter
NA (query Only)
Query Parameter
<NR1> <integer>
Example
To query for the fail status on trace 2 for the lower limit:
:CALC2:LIM:LOW:FAIL?
:CALCulate2:LIMit:LOWer:FAIL?
Related Command
:CALCulate<Tr>:LIMit:PFMessage
:CALCulate:LIMit:TYPE
Front Panel Access
NA
Limit Pass/Fail
:CALCulate<Tr>:LIMit:PFMessage
Description
Enables or disables the selected trace pass fail message. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Setting the value to ON or to 1 turns on the selected trace pass fail message. Setting the value to OFF or to 0 turns off the selected trace pass fail message.
The query version of the command returns a 1 if the selected trace pass fail message is set to ON, and the query returns a 0 if the selected trace pass fail message is set to OFF.
Syntax:
:CALCulate<Tr>:LIMit:PFMessage OFF|ON|0|1
:CALCulate<Tr>:LIMit:PFMessage?
Cmd Parameter
<boolean> OFF|ON|0|1
Query Parameter
<boolean> 0|1
Default Value
OFF or 0 (query returns 0 for OFF)
Example
To turn off pass/fail message:
:CALCulate:LIMit:PFMessage OFF
:CALCulate:LIMit:PFMessage 0
:CALC:LIM:PFM 0
To turn on pass fail message:
:CALCulate:LIMit:PFMessage ON
:CALCulate:LIMit:PFMessage 1
:CALC:LIM:PFM 1
Related Command
:CALCulate<Tr>:LIMit:PFMessage
:CALCulate:LIMit:TYPE
Front Panel Access
Shift 6 (Limit), Pass Fail Message
Upper Limit Fail State
:CALCulate<Tr>:LIMit:UPPer:FAIL?
Description
Returns the fail status of the given trace <Tr>. The uppper limit and the limit message must be ON in order to return a valid boolean value. If the upper limit fails, then a 1 is returned. Otherwise, a 0 is returned. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Note that the condition is reset after the end of the sweep. To avoid missing a failing condition, send the command after completing a single sweep.
Syntax:
:CALCulate<Tr>:LIMit:UPPer:FAIL?
Cmd Parameter
NA (query Only)
Query Parameter
<NR1> <integer>
Example
To query for the fail status on trace 2 for the upper limit:
:CALC2:LIM:UPP:FAIL?
:CALCulate2:LIMit:UPPer:FAIL?
Related Command
:CALCulate:LIMit[:STATe]
:CALCulate<Tr>:LIMit:PFMessage
:CALCulate:LIMit:TYPE
Front Panel Access
NA
Number of Lower Limit Points
:CALCulate<Tr>:LIMit:LOWer:POINt?
Description
Returns the number of points currently in the lower limit line of the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Syntax:
:CALCulate<Tr>:LIMit:LOWer:POINt?
Cmd Parameter
NA (query Only)
Query Response
<NR1> <integer>
Example
To query for the lower limit total point on trace #2:
:CALC2:LIM:LOW:POIN?
Front Panel Access
NA
Add Lower Limit Point
:CALCulate<Tr>:LIMit:LOWer:POINt:ADD
Description
Adds a new limit point to the lower limit line of the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Syntax:
:CALCulate<Tr>:LIMit:LOWer:POINt:ADD
Cmd Parameter
NA
Query Response
NA (no query)
Example
To add a point to the lower limit line on trace 2:
:CALC2:LIM:LOW:POIN:ADD
Front Panel Access
Shift 6 (Limit), Limit Edit, Add Point
Delete Lower Limit Point
:CALCulate<Tr>:LIMit:LOWer:POINt:DELete
Description
Deletes the lower limit point of the given trace <Tr>. After deletion, the point that is immediately to the left of the point that was deleted becomes the active point. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Note that deletion is valid only if more than 2 limit points are present.
Syntax:
:CALCulate<Tr>:LIMit:LOWer:POINt:DELete
Cmd Parameter
NA
Query Response
NA (no query)
Example
To delete the trace 4 lower limit current active point: