The commands in this subsystem process data that are collected via the :CALCulate subsystem.
:CALCulate<Tr>:DATA? FDATa|SDATa|FMEM|SMEM
Description
Transfers the given trace data specified by <Tr> from the instrument to the controller. <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.
FDATa: Formatted (or Final) data. The returned data are based on the Graph Type that is associated with the trace. For graph types that use only one number per point (such as Log Mag, SWR, Phase, Real, Imaginary, Group Delay, Log Mag /2), the command returns one number per data-point. For graph types that use two numbers per point (such as Smith Chart), the command returns two numbers per data-point. Following is a list of the returned values for each Graph Type:
Graph Type and Returned Units (Sheet 1 of 2)
Graph Type
Returned Units
Log Magnitude
dB
Log Magnitude /2
dB
Phase
degree
SWR
unitless
Real
unitless
Imaginary
unitless
Group Delay
ns (nanosecond)
Smith Chart
R + jX ohm
Linear Polar
unitless, degree
Log Polar
dB, degree
Real Impedance
ohm
Imaginary Impedance
ohm
SDATa: Complex measurement data. The returned numbers (which are independent of the Graph Type that is associated with the trace) are the complex measurement data (Real and Imaginary) for each point of the trace. A 551 point trace therefore has a total of 1102 points that get transferred.
FMEM: Formatted (or Final) Memory data. Similar to FDATa, but for memory data.
SMEM: Complex memory data. Similar to SDATa, but for memory data.
Note that in order to get valid data when querying for memory data, you must first store a trace into memory using the command CALC:MATH:MEMorize. The format of the block data that is returned can be specified by the command :FORMat:DATA. The response begins with an ASCII header that specifies the number of data bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header. Each data-point is separated by a comma delimiter.
Cmd Parameter
NA (query only)
Query Parameter
<char> FDATa|SDATa|FMEM|SMEM
Query Response
<block> (returns block data)
Related Command
:FORMat:DATA
Front Panel Access
NA
:CALCulate:FORMat Subsystem
Commands in this subsystem define the display format for a measurement.
Defines the graph type for 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. <Graph Type> is the graph type to which the specified trace is set, and it must be one of the following values:
The query version of this command returns “LMAG” if the specified trace graph type is set to Log Mag, “SWR” if set to SWR, “PHAS” if set to Phase, “REAL” if set to Real, “IMAG” if set to Imaginary, “GDEL” if set to Group Delay, and “SMIT” is set to Smith chart, and “LM/2” if set to Log Mag/2 (cable loss), “LINP” if set to Linear Polar, “LOGP” if set to Log Polar, “RIMP” if set to Real Impedance, and “IIMP” if set to Imaginary Impedance.
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.
Cmd Parameter
<boolean> OFF|ON|0|1
Query Response
<bNR1> 0|1
Default Value
OFF or 0 (query returns 0 for OFF)
Example
To turn off limit alarm
: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
: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.
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
: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.
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
: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.
Cmd Parameter
NA
Query Response
NA (no query)
Example
To delete the trace 4 lower limit current active point:
:CALCulate4:LIMit:LOWer:POINt:DELete
Front Panel Access
Shift 6 (Limit), Limit Edit, Delete Point
:CALCulate<Tr>:LIMit:LOWer:POINt:LEFT
Description
Sets the limit point to the left of the lower limit active point of the given trace <Tr> as the new 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.
Cmd Parameter
NA
Query Response
NA (no query)
Example
To make the lower limit point to the left of the current active point of trace 2 as the new active point:
:CALCulate2:LIMit:LOWer:POINt:LEFT
Front Panel Access
Shift 6 (Limit), Limit Edit, Next Point Left
:CALCulate<Tr>:LIMit:LOWer:POINt:RIGHt
Description
Sets the limit point to the right of the lower limit active point of the given trace <Tr> as the new 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.
Cmd Parameter
NA
Query Response
NA (no query)
Example
To make the lower limit point to the right of the current active point of trace 2 as the new active point:
Sets the location of the lower limit point of the given trace <Tr> on the x‑axis at the specified location. <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. <x‑parameter> is defined in the current x‑axis. Sending the set command changes the Move Limit on the front panel to Point if it is currently set to Limit, and sets the given trace as the active trace. The <x‑parameter> given unit must correspond to the given trace domain type. If no unit is specified with the <x‑parameter>, then the default unit is used. The query version of the command returns the location of the given trace active lower limit point on the x‑axis followed by the unit. If an error occurs, such as limit not ON, then the query version of the command returns – 400 error codes. Limit line must be ON for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
<NRf> <x‑parameter> (hertz, meters, feet)
Query Response
<NR3> <x‑parameter> (hertz, meters, feet)
Default Units
Hz for Frequency domain, Meters or Feet for distance domain.
Example
To set the trace 4 lower limit point to 5000 Hertz (trace 4 in frequency domain):
:CALCulate4:LIMit:LOWer:POINt:X 5000
OR to 500 MHz:
:CALCulate4:LIMit:LOWer:POINt:X 500 MHz
To set the trace 1 lower limit point to 5 Feet (trace 1 in distance domain with current distance unit in meter):
Sets the location of the lower limit point of the given trace <Tr> on the y‑axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified then default is trace number 1. Sending the set command changes the Move Limit on the front panel to Point if it is currently set to Limit, and sets the given trace as the active trace. The <y‑parameter> is defined in the given trace current y‑axis. If no unit is specified with the <y‑parameter>, then the default unit is used. The query version of the command returns the location of the given trace lower limit point on the y‑axis. If an error occurs, such as limit not ON, then the query version of the command returns – 400 error codes. Limit line must be ON for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Turns the lower limit line of the given trace <Tr> ON or OFF. <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. <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. The query version of the command returns a 1 if the lower limit line of the given trace is ON, and returns a 0 if it is OFF.
Cmd Parameter
<boolean> OFF|ON|0|1
Query Response
<bNR1> 0|1
Default Value
OFF or 0 (query returns 0 for OFF)
Example
To turn on lower limit of trace 1
:CALCulate:LIMit:LOWer ON :CALCulate1:LIMit:LOWer 1 :CALCulate:LIMit:LOWer:STATe ON
To turn off upper limit of trace 4
:CALCulate4:LIMit:LOWer OFF :CALCulate4:LIMit:LOWer 0 :CALC4:LIM:LOW:STAT 0
Moves the lower limit of the given trace <Tr> on the x‑axis to the given value. <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. <x‑parameter> is defined in the given trace current x‑axis. The unit given with the <x‑parameter> must correspond to the given trace domain type. If no unit is specified with the <x‑parameter>, then the default unit is used. The set version of the command changes the Move Limit on the front panel to Limit if it is currently set to Point, and sets the given trace as the active trace. The query version of the command returns the location of the given trace lower limit point on the x‑axis followed by the unit. If an error occurs, such as limit not ON, then the query version of the command returns – 400 error codes. Limit line must be ON for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
<NRf> <x‑parameter> (hertz, meters, feet)
Query Response
<NR3> <x‑parameter> (hertz, meters, feet)
Default Units
Hz for Frequency domain, Meters or Feet for distance domain.
Example
To move the trace 4 lower limit to 5000 Hertz (trace 4 in frequency domain)
:CALCulate4:LIMit:LOWer:X 5000
OR to 500 MHz:
:CALCulate4:LIMit:LOWer:X 500 MHz
To move the trace 1 lower limit to 5 Feet (trace 1 in distance domain with current distance unit in meter)
:CALCulate:LIMit:LOWer:X 5 FT
OR to 4 Meter
:CALCulate1:LIMit:LOWer:X 4 M :CALCulate:LIMit:LOWer:X 4
Sets the location of the lower limit line of the given trace <Tr> on the y‑axis at the given value. This moves the entire lower limit and moves the current active limit point by the given value. <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. The <y‑parameter> is defined in the current y‑axis. If no unit is specified with the <y‑parameter>, then the default unit is used. The set version of the command changes the Move Limit on the front panel to Limit if it is currently set to Point, and sets the given trace as the active trace. The query version of the command returns the location of the active limit point on the y‑axis. If an error occurs, such as limit not ON, then the query version of the command returns a – 400 error codes. Limit line must be ON for the command to be valid.
Deletes the active trace active limit point. After deletion, the point that is immediately to the left of the point that was deleted becomes the active point. Note that deletion is valid only if 2 or more limit points exist. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
NA
Query Response
NA (no query)
Example
To delete the currently active limit point
:CALCulate:LIMit:POINt:DELete
Related Command
:CALCulate:LIMit:POINt:ADD
Front Panel Access
Shift 6 (Limit), Limit Edit, Delete Point
:CALCulate:LIMit:POINt:LEFT
Description
Sets the limit point immediately to the left of the active limit point as the active point. This makes it active for editing or deleting. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
NA
Query Response
NA (no query)
Example
To select the point to the left of the active point
:CALCulate:LIMit:POINt:LEFT
Related Command
:CALCulate:LIMit:POINt:RIGHt
Front Panel Access
Shift 6 (Limit), Limit Edit, Next Point Left
:CALCulate:LIMit:POINt:RIGHt
Description
Sets the limit point immediately to the right of the active limit point as the active point. This makes it active for editing or deleting. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
NA
Query Response
NA (no query)
Example
To select the point to the right of the active point:
Sets the location of the active limit point on the x‑axis at the specified location. Sending this command changes the Move Limit on the front panel to Point if it is currently set to Limit. The <x‑parameter> must correspond to the current active trace domain type. If no unit is specified with the <x‑parameter>, then the default unit is used. The query version of the command returns the location of the active limit point on the x‑axis followed by the unit. If an error occurs, such as limit not ON, then the query version of the command returns – 400 error codes. Limit line must be ON for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
<NRf> <x‑parameter> (hertz, meters, feet)
Query Response
<NR3> <x‑parameter> (hertz, meters, feet)
Default Units
Hz for Frequency domain, Meters or Feet for distance domain.
Example
To set the active limit point to 5000 Hertz (active trace in frequency domain):
:CALCulate:LIMit:POINt:X 5000
OR to 500 MHz:
:CALCulate:LIMit:POINt:X 500 MHz
To set the active limit point to 5 Feet (active trace in distance domain with current distance unit in meter):
:CALCulate:LIMit:POINt:X 5 FT
OR to 4 Meter
:CALCulate:LIMit:POINt:X 4 M :CALCulate:LIMit:POINt:X 4
Sets the location of the active limit point on the y‑axis at the specified location. Sending this command changes the Move Limit on the front panel to Point if it is currently set to Limit. The <y‑parameter> is defined in the current y‑axis. If no unit is specified with the <y‑parameter>, then the default unit is used. The query version of the command returns the location of the active limit point on the y‑axis. If an error occurs, such as limit not ON, the query version of the command returns an error code of – 400. Limit line must be ON for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Turns the active trace currently selected limit line (upper or lower) ON or OFF. If the value is set to ON or 1, then the active trace selected limit line is turned ON. If the value is set to OFF or 0, then the active trace selected limit line is turned OFF. The query version of the command returns a 1 if the active trace selected limit line is ON and returns a 0 if it is OFF. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Cmd Parameter
<boolean> OFF|ON|0|1
Query Response
<bNR1> 0|1
Default Value
OFF or 0 (query returns 0 for OFF)
Example
To turn on the currently selected limit line:
:CALCulate:LIMit ON :CALCulate:LIMit:STATe ON :CALCulate:LIMit:STATe 1
To turn off the currently selected limit line:
:CALCulate:LIMit OFF :CALCulate:LIMit:STATe 0 :CALCulate:LIMit 0
Front Panel Access
Shift 6 (Limit), Limit State
:CALCulate:LIMit:TYPE 0|1 :CALCulate:LIMit:TYPE?
Description
Sets the limit line segment type (upper or lower) to be edited. Set the value to 1 for Lower limit segment and to 0 for Upper limit line segment. The query version of the command returns a 1 if the lower limit line is currently active for editing and returns a 0 if the upper limit line is currently active for editing.
Cmd Parameter
<char> 0|1
Query Response
<char> 0|1
Default Value
0
Example
To set upper limit line active for editing:
:CALCulate:LIMit:TYPE 0
To set lower limit line active for editing:
:CALCulate:LIMit:TYPE 1
Front Panel Access
Shift 6 (Limit), Limit
:CALCulate<Tr>:LIMit:UPPer:POINt?
Description
Query only. Returns the number of points currently in the upper 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:UPPer:POINt?
Cmd Parameter
NA (query only)
Query Response
<NR1> <integer>
Example
To query for the upper limit line total point on trace #2:
:CALC2:LIM:UPP:POIN?
Front Panel Access
NA
:CALCulate<Tr>:LIMit:UPPer:POINt:ADD
Description
Adds a new limit point to the upper 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.
Parameter
NA
Query Syntax:
NA (no query)
Query Response
NA
Example
To add a point to the upper limit line on trace 2:
:CALC2:LIM:UPP:POIN:ADD
Related Command
:CALCulate<Tr>:LIMit:UPPer:POINt:DELete
Front Panel Access
Shift 6 (Limit), Limit Edit, Add Point
:CALCulate<Tr>:LIMit:UPPer:POINt:DELete
Description
Deletes the upper 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 2 or more limit points are active.
Parameter
NA
Query Syntax:
NA (no query)
Query Response
NA
Example
To delete trace 3 upper limit current active point:
:CALCulate3:LIMit:UPPer:POINt:DELete
Related Command
:CALCulate<Tr>:LIMit:UPPer:POINt:ADD
Front Panel Access
Shift 6 (Limit), Limit Edit, Delete Point
:CALCulate<Tr>:LIMit:UPPer:POINt:LEFT
Description
Sets the limit point to the left of the upper limit active point of the given trace <Tr> as the new 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.
Parameter
NA
Query Syntax:
NA (no query)
Query Response
NA
Example
To make the upper limit point to the left of the current active point of trace 2 as the new active point:
Sets the limit point to the right of the upper limit active point of the given trace <Tr> as the new active point. <Tr> is the trace number in the range 1 to 4. If no trace number is specified than defaults to trace number 1.
Parameter
NA
Query Syntax:
NA (no query)
Query Response
NA
Example
To make the upper limit point to the right of the current active point of trace 2 as the new active point:
Sets the location of the upper limit point of the given trace <Tr> on the x‑axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified than defaults to trace number 1. Sending the set command will change the Move Limit on the front panel to Point if it is currently set to Limit and set the given trace as the active trace. <x‑parameter> is defined in the given trace current x‑axis. The given unit must correspond to the given trace domain type. If no unit is specified with the <x‑parameter> then the default unit will be used. The query version of the command returns the location of the given trace upper limit point on the x‑axis followed by the unit. If an error occurs, such as limit not ON, the query version of the command returns an error code of – 400. Limit line must be on for the command to be valid. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Cmd Parameter
<NRf> <x‑parameter> (hertz, meters, feet)
Query Response
<NR3> <x‑parameter> (hertz, meters, feet)
Default Units
Hz for Frequency domain, Meters or Feet for distance domain.
Example
To set the trace 4 upper limit point to 5000 Hertz (trace 4 in frequency domain):
:CALCulate4:LIMit:UPPer:POINt:X 5000
OR to 500 MHz:
:CALCulate4:LIMit:UPPer:POINt:X 500 MHz
To set the trace 1 upper limit point to 5 Feet (trace 1 in distance domain with current distance unit in meter):
:CALCulate:LIMit:UPPer:POINt:X 5 FT
OR to 4 Meter
:CALCulate1:LIMit:UPPer:POINt:X 4 M :CALCulate:LIMit:UPPer:POINt:X 4
Sets the location of the upper limit point of the given trace <Tr> on the y‑axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified than defaults to trace number 1. Sending the set command will change the Move Limit on the front panel to Point if it is currently set to Limit and set the given trace as the active trace. The <y‑parameter> is defined in the given trace current y‑axis. If no unit is specified with the <y‑parameter> then the default unit will be used. The query version of the command returns the location of the given trace upper limit point on the y‑axis. If an error occurs, such as limit not ON, the query version of the command returns an error code of – 400. Limit line must be on for the command to be valid. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Turns the upper limit line of the given trace <Tr> ON or OFF. <Tr> is the trace number in the range 1 to 4. If no trace number is specified than defaults to trace number 1. The query version of the command returns a 1 if the upper limit line of the given trace is ON and returns a 0 if the given trace is OFF.
Cmd Parameter
<boolean> OFF|ON|0|1
Query Response
<bNR1> 0|1
Default Value
OFF or 0 (query returns 0 for OFF)
Example
To turn on upper limit of trace 1:
:CALCulate:LIMit:UPPer ON :CALCulate1:LIMit:UPPer 1 :CALCulate:LIMit:UPPer:STATe ON
To turn off upper limit of trace 4:
:CALCulate4:LIMit:UPPer OFF :CALCulate4:LIMit:UPPer 0 :CALC4:LIM:UPP:STAT 0
Moves the upper limit of the given trace <Tr> on the x‑axis to the given value. <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. <x‑parameter> is defined in the given trace current x‑axis. The unit given with the <x‑parameter> must correspond to the given trace domain type. If no unit is specified with the <x‑parameter> then the default unit will be used. The set version of the command will change the Move Limit on the front panel to Limit if it is currently set to Point and set the given trace as the active trace. The query version of the command returns the location of the given trace upper limit point on the x‑axis followed by the unit. If an error occurs, such as limit not ON, the query version of the command returns an error code of – 400. Limit line must be on for the command to be valid. Use the command :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
<NRf> <x‑parameter> (hertz, meters, feet)
Query Response
<NR3> <x‑parameter> (hertz, meters, feet)
Default Units
Hz for Frequency domain, Meters or Feet for distance domain.
Example
To move the trace 4 upper limit to 5000 Hertz (trace 4 in frequency domain):
:CALCulate4:LIMit:UPPer:X 5000
OR to 500 MHz:
:CALCulate4:LIMit:UPPer:X 500 MHz
To move the trace 1 upper limit to 5 feet (trace 1 in distance domain with current distance unit in meter):
:CALCulate:LIMit:UPPer:X 5 FT
OR to 4 Meter
:CALCulate1:LIMit:UPPer:X 4 M :CALCulate:LIMit:UPPer:X 4
Sets the location of the upper limit line of the given trace <Tr> on the y‑axis at the given value. This moves the entire upper limit and moves the current active limit point by the given value. <Tr> is the trace number in the range 1 to 4. If no trace number is specified than defaults to trace number 1. The <y‑parameter> is defined in the current y‑axis. If no unit is specified with the <y‑parameter> then the default unit will be used. The set version of the command will change the Move Limit on the front panel to Limit if it is currently set to Point and set the given trace as the active trace. The query version of the command returns the location of the active limit point on the y‑axis. If an error occurs, such as limit not ON, the query version of the command returns an error code of – 400. Limit line must be on for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Sets the location of the active limit point on the x‑axis at the specified location. This moves the entire limit and moves the active limit point to the given value. The <x‑parameter> given unit must correspond to the current active trace domain type. If no unit is specified with the <x‑parameter> then the default unit will be used. Sending the set command will change the Move Limit on the front panel to Limit if it is currently set to Point. The query version of the command returns the location of the active limit point on the x‑axis followed by the unit. If an error occurs, such as limit not ON, the query version of the command returns an error code of – 400. Limit line must be on for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
<NRf> <x‑parameter> (hertz, meters, feet)
Query Response
<NR3> <x‑parameter> (hertz, meters, feet)
Default Units
Hz for Frequency domain, Meters or Feet for distance domain.
Example
To move the active limit to 5000 Hertz (active trace in frequency domain):
:CALCulate:LIMit:X 5000
OR to 500 MHz:
:CALCulate:LIMit:X 500MHz
To move the active limit to 5 Feet (active trace in distance domain with current distance unit in feet):
Sets the location of the active limit line on the y‑axis at the given value. This moves the entire limit and moves the current active limit point by the given value. Sending this command will change the Move Limit on the front panel to Limit if it is currently set to Point. The <y‑parameter> is defined in the current y‑axis. If no unit is specified with the <y‑parameter> then the default unit will be used. The query version of the command returns the location of the active limit point on the y‑axis. If an error occurs, such as limit not ON, the query version of the command returns an error code of – 400. Limit line must be on for the command to be valid. Use :CALCulate:LIMit:TYPE to set the currently active limit line.
Cmd Parameter
<NRf> <y‑parameter> (depends on display type)
Query Response
<NR3> <y‑parameter> (depends on display type)
Default Units
Current active trace y‑axis unit
Related Command
:CALCulate:LIMit:TYPe :CALCulate:LIMit:X
Front Panel Access
Shift 6 (Limit), Limit Edit, Amplitude
:CALCulate:MARKer Subsystem
This subsystem contains commands to manipulate data markers.
:CALCulate:MARKer:AOFF
Turns off all markers. This command will turn off all the markers and set Marker Type to off.
:CALCulate:MARKer:DATA?
Description
Reports the marker information. Each marker datum is separated by a comma and data are returned similar to that when Readout Format is set to Table.
Sets the specified delta marker reference to the given reference marker specified by <Mk>. <Mk> is the reference marker number in the range of 1 to 12. The query version of the command returns the reference marker number to which the specified delta marker should be referenced. If the selected marker is not a delta marker, then – 230 is returned. Note that the set version of this command will set the specified delta marker as the active marker. The given reference marker number must be currently set as a reference marker and the specified delta marker number must currently be set as delta marker. Also both markers (delta and reference) must be in the same domain type.
Cmd Parameter
<char> <Mk>
Query Response
<char> <Mk>
Default Value
– 230 (The selected marker is a reference marker)
Example
Set Marker 1 as the reference marker of delta Marker 3:
Sets the specified marker as the active marker and turn it on or off. If the value is set to ON or 1, then the specified marker is turn on and set as a delta marker. If the value is set to OFF or 0, then the specified marker is turn off. The query version of the command returns a 1 if the specified marker is a delta marker, and returns a 0 if it is not a delta marker.
Cmd Parameter
<boolean> OFF|ON|0|1
Query Response
<bNR1> 0|1
Default Value
OFF
Example
To turn on marker #3 and set it as a delta marker:
:CALCulate:MARKer3:DELTa ON :CALCulate:MARKer3:DELTa 1 :CALCulate:MARKer3:DELTa:STATe ON :CALCulate:MARKer3:DELTa:STATe 1
To turn off delta marker #6:
:CALCulate:MARKer6:DELTa OFF :CALCulate:MARKer6:DELTa:STATe OFF :CALCulate:MARKer6:DELTa:STATe 0
Sets the display readout format for markers. The query version of the command returns “NONE” if the display readout format is set to None, “SCRE” if Screen, “TABL” if Table, and “TRAC” if Trace.
Query the specified marker <Mk> domain type. <Mk> is the marker number in the range of 1 to 12. If no marker number is specified, then the marker number (the <Mk> value) defaults to 1. This command returns “FREQ” if the specified marker domain is frequency and “DIST” if distance.
Sets the specified marker <Mk> readout style. <Mk> is the marker number in the range of 1 to 12. If no marker number is specified, then the marker number (the <Mk> value) defaults to 1. <Style> is the marker readout style and must be one of the following values:
The query version of the command returns “GRAP” if the specified marker readout style is set to Graph Type, “LMAG” if the specified marker readout style is set to Log Magnitude, “LOGP” if Log Mag and Phase, “PHAS” if Phase, “RLIM” if Real and Imaginary, “SWR” if standing wave ratio, “IMP” for impedance, “ADM” for admittance, “NIMP” for normalized impedance, “NADM” for normalized admittance, “PIMP” for polar impedance, “GDEL” if group delay, “LM/2” for log mag/2 (cable loss), “LINM” for Linear Magnitude (Lin Mag), and “LINP” for Linear Magnitude and Phase. Note that the set version of this command will set the specified marker as the active marker.
Cmd Parameter
<char> <Style> (GRAPh|LMAGnitude|LOGPhase|and so forth)
Puts the specified marker at the maximum value in the trace. Note that this turns on the selected marker (if it is not already on) and sets the selected marker as the active marker.
Puts the specified marker at the minimum value in the trace. Note that this turns on the selected marker (if it is not already on) and set the selected marker as the active marker.
Sets the specified marker <Mk> as the active marker and turn it on or off. If the value is set to ON or 1, the specified marker is turn on and set as a reference marker. If the value is set to OFF or 0, the specified marker is turn off. The query version of the command returns a 1 if the specified marker is ON and is a reference marker, and returns a 0 if not. <Mk> is the marker number in the range of 1 to 12. If no marker number is specified, then the marker number (the <Mk> value) defaults to 1.
Sets the specified marker <Mk> to the given trace <Tr>. <Mk> is the marker number in the range of 1 to 12. If no marker number is specified, then the marker number (the <Mk> value) defaults to 1. <Tr> is the trace and must be one of the following 9 values:
TR1|TR2|TR3|TR4|MEM1|MEM2|MEM3|MEM4|ALL
The query version of the command returns “TR1” if the specified marker is on trace 1, “TR2” if on trace 2, “TR3” if on trace 3, “TR4” if on trace 4, “MEM1” if on trace 1 memory, “MEM2” if on trace 2 memory, “MEM3” if on trace 3 memory, “MEM4” if on trace 4 memory, and “ALL” if the specified marker is on all 4 traces. Note that the set version of this command will set the specified marker as the active marker.
If an error occurs, such as “Marker not ON”, the query version of the command returns an error code of – 400.
Sets the specified marker to the given marker type and make it the active marker. If set to REF then the specified marker is turn on and is set as reference marker. If set to DELT then the specified marker is turn on and is set as a delta marker. If set to OFF then the specified marker is turn off. The query version of this command returns the string “REF” if the specified marker is set as reference marker, “DELT” if set as delta marker, or “OFF” if the specified marker is currently set to off.
Cmd Parameter
<char> REFerence|DELTa|OFF
Query Response
<char> REF|DELT|OFF
Default Value
OFF
Example
To set marker #1 as the reference marker and turn it on:
Sets the location of the marker on the x‑axis at the specified location. <x‑parameter> is defined in the current x‑axis units. The set command will set the specified marker as the active marker. The <x‑parameter> given unit must correspond to the specified marker domain type. If no unit is specified with the <x‑parameter> then the default unit will be used.
The query version of the command returns the location of the marker on the x‑axis followed by the unit. If the Start and Stop values of the domain are the same, then the query returns the X value along with the marker point number within the brackets. The marker point number is determined with the following formula:
For example, if 201 points are used in the measurement display, then the query returns: <x‑value> (101). When the results of division include a fraction, as in the current example, the result is rounded DOWN. 201 / 2 = 100.5 Rounding down to 100 before adding 1 yields the 101 that is returned by the query.
If an error occurs, such as marker not ON, the query version of the command returns an error code of – 400. Note that the marker is snapped to the data-point closest to the specified value. The selected marker must be ON for the command to be valid.
Cmd Parameter
<NRf> <x‑parameter> (hertz, meters, feet)
Query Response
<NR3> <x‑parameter> (hertz, meters, feet)
Default Units
Hz for frequency domain, Meters or Feet for distance domain.
Example
To set reference marker #2 (frequency domain) to 5000 hertz on the x‑axis:
Reads the current Y value for the specified marker. The units are in the y‑axis unit. The command returns the marker readout style followed by the Y value and unit. If an error occurs, such as marker not ON, the command returns an error code of – 400. The selected marker must be ON for the command to be valid.
Sets the math operations on the currently active trace and the trace stored in memory. Note that a trace MUST be stored in Memory. Setting the FUNCtion to NORMal is equivalent of setting the Trace Math to “None” on the front panel. Setting the FUNCtion to ADD is equivalent of setting the Trace Math to “Trace Plus Memory” on the front panel. Setting the FUNCtion to SUBTract is equivalent to setting the Trace Math to “Trace Minus Memory” on the front panel. Setting the FUNCtion to MULTiply is equivalent to setting the Trace Math to “Trace Multiply Memory” on the front panel. Setting the FUNCtion to DIVide is equivalent to setting the Trace Math to “Trace Divide Memory” on the front panel. The query version of the command returns the string “NORM” for no trace math, “ADD” for trace plus memory, “SUBT” for trace minus memory, “MULT” for trace multiply memory, and “DIV” for trace divide memory.
Cmd Parameter
<char> NORMal|ADD|SUBTract|MULTiply|DIVide
Query Response
<char> NORM|ADD|SUBT|MULT|DIV
Default Value
NORM
Related Command
:CALCulate:MATH:MEMorize
Front Panel Access
Shift 5 (Trace), Trace Math
:CALCulate:MATH:MEMorize
Description
Copies the current measurement trace into memory.
Cmd Parameter
NA
Query Response
NA (no query)
Front Panel Access
Shift 5 (Trace), Save Trace to Memory
:CALCulate:SMOothing Subsystem
This subsystem contains functions for trace smoothing.
Sets the smoothing percentage for the given trace <Tr>. The query form of the command returns the current smoothing percentage. <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 setting the smoothing also sets the given trace as the active trace if it is not already active.
Front panel soft keys that are related to distance measurements, such as the Additional Dist Setup soft key, appear in menus only when the Setup Domain is set up for distance.
:CALCulate:TRANsform:DISTance:MAXimum?
Description
This command returns the maximum distance in millimeters if the current distance unit is set to meter, and otherwise returns the maximum distance in feet. This value is set based on the number of data-points, the propagation velocity, and the start and stop frequency.
Cmd Parameter
NA (query only)
Query Response
<NR3> (millimeters or feet)
Default Value
For 1.6 GHz Model: 18.7429 m For 6 GHz Model: 4.997 m
Default Unit
millimeters (mm)
Range
– 3000.0 m to + 3000.0 m
Front Panel Access
Freq/Dist, Additional Dist Setup, Distance Info
:CALCulate:TRANsform:DISTance:RESolution?
Description
This command returns the distance resolution in millimeters if the current distance unit is set to meter, and otherwise returns the resolution in feet. This value is set based on the propagation velocity and the start and stop frequencies.
Cmd Parameter
NA (query only)
Query Response
<NR3> (millimeters or feet)
Default Value
For 1.6 GHz Model: 18.743 cm For 6 GHz Model: 4.997 cm
Sets the start distance for DTF measurements. The query version of this command returns the start distance in millimeters if the current distance unit is set to meter, and otherwise returns the start distance in feet.
Cmd Parameter
<NRf> (meters or feet)
Query Response
<NR3> (millimeters or feet)
Default Value
0.0 mm
Default Unit
Meters (m) when setting, Millimeters (mm) for query
Sets the stop distance for DTF measurements. The query version of this command returns the stop distance in millimeters if the current distance unit is set to meter, and otherwise returns the stop distance in feet.
Cmd Parameter
<NRf> (meters or feet)
Query Response
<NR3> (millimeters or feet)
Default Value
6850 mm
Default Unit
Meters (m) when setting, Millimeters (mm) for query
Sets the units to be used for DTF measurements. The query version of this command returns the string “METER” if the current distance unit is set to meter, and otherwise returns the string “FEET”.
Produces the distance list in meters for the given trace. <Tr> is the trace number in the range 1 to 8 (1 to 4 for Traces TR1 to TR4 and 5 to 8 for Memory M1 to M4). If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The response begins with an ASCII header that specifies the number of data bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header. Each distance value is returned in scientific notation and separated by a comma delimiter.