S331E, S332E, S361E, S362E Site Master™MS2711E, MS2712E, MS2713E Spectrum Master™MT8212E, MT8213E Cell Master™ Programming Manual : Cable & Antenna Commands : :CALCulate Subsystem
 
:CALCulate Subsystem
The commands in this subsystem process data that has been collected via the SENSe subsystem.
:CALCulate:LIMit:ALARm OFF|ON|0|1
:CALCulate:LIMit:ALARm?
Title
Limit Alarm
Description
Enables/disables the currently active limit line alarm. Setting the value to ON or 1 will turn on the limit alarm. Setting the value to OFF or 0 will turn off the limit alarm. The query version of the command returns a 1 if the currently selected limit line alarm is set to ON and returns 0 if OFF.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Example
To turn off limit alarm:
:CALCulate:LIMit:ALARm OFF
:CALCulate:LIMit:ALARm 0
To turn on limit alarm:
:CALCulate:LIMit:ALARm ON
:CALCulate:LIMit:ALARm 1
Front Panel Access
Shift‑6 (Limit), Limit Alarm
:CALCulate:LIMit:CLEar
Title
Clear Selected Limit
Description
Deletes all limit points for the currently active limit line.
Front Panel Access
Shift‑6 (Limit), Clear Limit
:CALCulate:LIMit:POINt:ADD
Title
Add Limit Point
Description
Adds a new limit point to the currently active limit line.
Front Panel Access
Shift‑6 (Limit), Multi-Segment Edit, Add Point
:CALCulate:LIMit:POINt:FREQuency <freq>
:CALCulate:LIMit:POINt:FREQuency?
Title
Limit Point Frequency
Description
Sets the limit point frequency of the current selected limit.
Parameter
<freq>
Default Unit
Hz
Front Panel Access
Shift‑6 (Limit), Multi-Segment Edit, Point Freq
:CALCulate:LIMit:POINt:VALue <value>
:CALCulate:LIMit:POINt:VALue?
Title
Limit Point Value
Description
Sets the limit point value of the current selected limit. The <value> parameter is the limit point value in dB or time units for group delay.
Parameter
<value>
Default Unit
Current active value unit.
Front Panel Access
Shift‑6 (Limit), Multi-Segment Edit, Point Value
:CALCulate:LIMit:POINt?
Title
Number of Limit Points
Description
Returns the number of points currently in the selected limit line.
 
:CALCulate:LIMit[:STATe] OFF|ON|0|1
:CALCulate:LIMit[:STATe]?
Title
Limit State
Description
Turns the limit line ON or OFF. If the value is set to ON or 1, the currently selected limit line is ON. If the value is set to OFF or 0, the currently selected limit line is OFF. The query version of the command returns a 1 if the currently selected limit line is ON and returns a 0 if OFF.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Example
To turn on the limit line:
:CALCulate:LIMit ON
:CALCulate:LIMit:STATe ON
:CALCulate:LIMit:STATe 1
To turn off the limit line:
:CALCulate:LIMit OFF
:CALCulate:LIMit:STATe 0
:CALCulate:LIMit 0
Front Panel Access
Shift‑6 (Limit), Limit On/Off
:CALCulate:MARKer:AOFF
Title
Turn All Markers Off
Description
Turns off all markers.
Front Panel Access
Marker, All Markers Off
:CALCulate:MARKer:TABLe:DATA?
Title
Marker Table Data
Description
Reports marker information similar to the Marker table. The response begins with an ASCII header. The header specifies the number of following bytes. It looks like #AX, where A is the number of digits in X and X is the number of bytes that follow the header. Parameters are returned in comma-delimited ASCII format. Each parameter is returned as “NAME=VALUE[UNITS].”
Parameter Name
Description
MKR_REFx
Reference marker state
MKR_DLTx
Delta marker state.
MKR_REF_FREQNx
Reference marker x frequency
MKR_DLT_FREQNx
Delta marker x frequency
MKR_REF_AMPLy
Reference marker y-axis
MKR_DLT_AMPL
Delta marker y magnitude.
x = marker 1 to 6.
 
Front Panel Access
Marker, Marker Table On
:CALCulate:MARKer:TABLe[:STATe] OFF|ON
:CALCulate:MARKer:TABLe[:STATe]?
Title
Marker Table State
Description
Turns the Marker Table on or off. Setting the value to ON will turn on the marker table. Setting the value to OFF will turn off the marker table.
Parameter
OFF|ON
Parameter Type
<boolean>
Default Value
OFF
Example
To turn on marker table:
:CALCulate:MARKer:TABLe ON
Front Panel Access
Marker, Marker Table
:CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X <x-parameter>
:CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X?
Title
Delta Marker X Value
Description
Sets the location of the delta marker on the x-axis at the specified location <x-parameter> + the reference marker x-axis. <x-parameter> is defined in the current x-axis units. The query version of the command returns the location of the delta marker on the x-axis.
Parameter
<x-parameter>
Default Unit
Current x-axis unit
Example
If both the reference and delta marker #1 is currently at 1 GHz on the x-axis, send the command below to set the delta marker #1 to 2 GHz on the x-axis:
:CALCulate:MARKer1:DELTa:X 1GHz
Related Command
:CALCulate:MARKer[1]|2|3|4|5|6:X
Front Panel Access
Marker, Delta
:CALCulate:MARKer{1|2|3|4|5|6}:DELTa:Y?
Title
Delta Marker Read Y Value
Description
Reads the current absolute Y value for the specified delta marker. The units are the units of the y-axis.
Default Unit
Current y-axis unit
:CALCulate:MARKer{1|2|3|4|5|6}:DELTa[:STATe] OFF|ON|0|1
:CALCulate:MARKer{1|2|3|4|5|6}:DELTa[:STATe]?
Title
Delta Marker State
Description
Sets the specified delta marker on or off.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Example
To turn on delta marker #3:
:CAL1Culate: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
Front Panel Access
Marker, Delta
:CALCulate:MARKer{1|2|3|4|5|6}:PEAK
Title
Marker Peak Search
Description
Puts the specified marker at the maximum value in the trace.
Related Command
:CALCulate:MARKer[1]|2|3|4|5|6:MAXimum
Front Panel Access
Marker, Marker [1/2/3/4/5/6], Marker to Peak
:CALCulate:MARKer{1|2|3|4|5|6}:VALLey
Title
Marker Valley Search
Description
Puts the specified marker at the minimum value in the trace.
Related Command
:CALCulate:MARKer[1]|2|3|4|5|6:MINimum
Front Panel Access
Marker, Marker [1/2/3/4/5/6], Marker to Valley
:CALCulate:MARKer{1|2|3|4|5|6}:X <x-parameter>
:CALCulate:MARKer{1|2|3|4|5|6}:X?
Title
Marker X Value
Description
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 query version of the command returns the location of the marker on the x-axis. Note that the marker is snapped to the data point closest to the specified value. If the specified marker is not on, it is set to on.
Parameter
<x-parameter>
Default Unit
Current x-axis unit
Example
To set reference marker #2 to 1GHz on the x-axis:
:CALCulate:MARKer2:X 1GHz
To set reference marker #1 to 1.5 GHz on the x-axis:
:CALCulate:MARKer:X 1.5GHz
:CALCulate:MARKer1:X 1.5GHz
Front Panel Access
Marker, Marker [1/2/3/4/5/6]
:CALCulate:MARKer{1|2|3|4|5|6}:Y?
Title
Marker Read Y Value
Description
Reads the current Y value for the specified marker. The units are the units of the y-axis.
Default Unit
Current y-axis unit
:CALCulate:MARKer{1|2|3|4|5|6}[:STATe] OFF|ON|0|1
:CALCulate:MARKer{1|2|3|4|5|6}[:STATe]?
Title
Marker State
Description
Sets the specified marker on/off. If no marker is specified in {1|2|3|4|5|6}, then marker defaults to 1.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Example
To turn off reference marker #1:
:CALCulate:MARKer1:STATe OFF
Front Panel Access
Marker, On/Off
:CALCulate:MATH:FUNCtion NORMal|ADD|SUBTract
:CALCulate:MATH:FUNCtion?
Title
Trace Math Function
Description
Sets math operations on the currently selected measurement and the trace stored in memory. Note that there MUST be a trace stored in Memory. Setting the FUNCtion to NORMal is equivalent of setting the Trace Math to “No Trace Math” 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. The query version of the command returns the string “NORM” for no trace math, returns the string “ADD” for trace plus memory, and returns the string “SUBT” for trace minus memory.
Parameter
NORMal|ADD|SUBTract
Parameter Type
<char>
Default Value
NORMal
Range
NORMal|ADD|SUBTract
Related Command
:CALCulate:MATH:MEMorize
Front Panel Access
Shift‑5 (Trace)
:CALCulate:MATH:MEMorize
Title
Trace To Memory
Description
Copies the current measurement trace into memory.
Front Panel Access
Shift‑5 (Trace), Copy Trace To Display Memory
:CALCulate:MATH:OVERlay ON|OFF
Title:
Trace Overlay On/Off
Description:
Turns trace stored in memory on or off.
Front Panel Access:
Shift‑5 (Trace), Trace Overlay
:CALCulate:SMOothing <integer>
:CALCulate:SMOothing?
Title
Smoothing
Description
Sets the smoothing percentage. The query form of the command returns the current smoothing percentage.
Parameter
<integer>
Parameter Type
<integer>
Default Value
0
Default Unit
%
Range
0 to 10
Front Panel Access
Shift‑3 (Sweep), Averaging Smoothing, Smoothing %
:CALCulate:TRANsform:CLAVerage?
Title
Cable Loss Average
Description
Reports the cable loss average.
Default Value
0 dB
Default Unit
dB
:CALCulate:TRANsform:DISTance:CABLoss
:CALCulate:TRANsform:DISTance:CABLoss?
Title
Cable Loss
Description
Sets the cable loss for DTF measurements.
Default Value
0
Range
0.0 to 5
Front Panel Access
Measurements, Cable Loss
:CALCulate:TRANsform:DISTance:DMAX?
Title
Distance Maximum
Description
Reports the maximum horizontal distance that can be analyzed in DTF. Note that the unit return is based on the current distance units.
Default Value
Dependent on instrument model number and frequency range.
Default Unit
Meters (m)
Range
0.0 m to 1500 m
:CALCulate:TRANsform:DISTance:FRESolution?
Title
Fault Resolution
Description
Reports the system’s ability to separate two closely spaced discontinuities in DTF measurements. Note that the return value is based on the current distance units.
Default Value
Dependent on instrument model number and frequency range.
Default Unit
Meters (m)
Range
0.0 m to 1500 m
:CALCulate:TRANsform:DISTance:PVELocity
:CALCulate:TRANsform:DISTance:PVELocity?
Title
Propagation Velocity
Description
Sets the propagation velocity of the cable for DTF measurements.
Default Value
0.8
Range
0.001 to 1.0
Front Panel Access
Freq/Dist, More, Prop Velocity (Note: For DTF measurements only.)
:CALCulate:TRANsform:DISTance:START
:CALCulate:TRANsform:DISTance:START?
Title
Start Distance
Description
Sets the start distance for DTF measurements.
Default Value
0.0 m
Default Unit
Meters (m)
Range
0.0 m to 1000.0 m
Front Panel Access
Freq/Dist, Start Dist
:CALCulate:TRANsform:DISTance:STOP
:CALCulate:TRANsform:DISTance:STOP?
Title
Stop Distance
Description
Sets the stop distance for DTF measurements.
Default Value
5.48 m
Default Unit
Meters (m)
Range
0.0 m to 1000.0 m
Front Panel Access
Freq/Dist, Stop Dist
:CALCulate:TRANsform:DISTance:UNIT METers|FEET
:CALCulate:TRANsform:DISTance:UNIT?
Title
Distance Units
Description
Sets the units to be used for DTF measurements.
Parameter
METers|FEET
Parameter Type
<char>
Default Value
Meters
Range
METers|FEET
Front Panel Access
Freq/Dist, Units
:CALCulate:TRANsform:DISTance:WINDow
 RECTangular|MSLobe| NSLobe|LSLobe
:CALCulate:TRANsform:DISTance:WINDow?
Title
Windowing
Description
Sets the windowing for DTF measurements. Available types are Rectangular, Nominal Side Lobe, Low Side Lobe and Minimum Side Lobe.
Parameter
RECTangular|MSLobe| NSLobe|LSLobe
Parameter Type
<char>
Default Value
Rectangular
Range
RECTangular|MSLobe| NSLobe|LSLobe
Front Panel Access
Freq/Dist, More, Window