BTS 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. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
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
Related Command
:CALCulate:LIMit:TYPe
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. The current selected limit line can be modified by using the :CALCulate:LIMit:TYPe command.
Default Value
OFF
Related Command
:CALCulate:LIMit:TYPe
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. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Related Command
:CALCulate:LIMit:TYPe
Front Panel Access
Shift-6 (Limit), Limit 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. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Parameter
<freq>
Default Unit
Hz
Related Command
:CALCulate:LIMit:TYPe
Front Panel Access
Shift-6 (Limit), Limit Edit, Frequency
: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. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Parameter
<value>
Default Unit
Current active value unit.
Related Command
:CALCulate:LIMit:TYPe
Front Panel Access
Shift-6 (Limit), Limit Edit, Value
:CALCulate:LIMit:POINt?
Title
Number of Limit Points
Description
Returns the number of points currently in the selected limit line. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Related Command
:CALCulate:LIMit:TYPe
:CALCulate:LIMit:TYPe
Title
Set Active Limit
Description
Sets the currently active High/Low limit line.
Parameter
<value> 0 for upper limit line; 1 for lower limit line
Default Value
0
Example
To set the lower limit line active:
:CALCulate:LIMit:TYPe 1
:CALCulate:LIMit:VALue <value>
:CALCulate:LIMit:VALue?
Title
Move Limit
Description
Sets the currently active limit line value. This command moves an entire single or multi-segment limit line up or down by the given <value>. This command is equivalent to the command :CALCulate:LIMit:Y. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Parameter
<value>
Default Unit
Current active value unit.
Related Command
:CALCulate:LIMit:Y
:CALCulate:LIMit:TYPe
Front Panel Access
Shift-6 (Limit), Limit Edit, Amplitude
:CALCulate:LIMit[:STATe] OFF|ON|0|1
:CALCulate:LIMit[:STATe]?
Title
Limit State
Description
Turns the currently selected limit line (upper or lower) 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. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
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), 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
(In zero span) If both the reference and delta marker #1 is currently at 25 us on the x-axis, send the command below to set the delta marker to 50us on the x-axis:
:CALCulate:MARKer1:DELTa:X 25us
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}:MAXimum
Title
Marker (Maximum) Peak Search
Description
Puts the specified marker at the maximum amplitude in the trace.
Front Panel Access
Marker, [Marker 1/2/3/4/5/6,] Peak Search
:CALCulate:MARKer{1|2|3|4|5|6}:MINimum
Title
Marker (Minimum) Valley Search
Description
Puts the specified marker at the minimum value in the trace.
Related Command
:CALCulate:MARKer[1]|2|3|4|5|6:VALLey
Front Panel Access
Marker, [Marker 1/2/3/4/5/6,] Valley Search
: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,] Peak Search
: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,] Valley Search
: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 5 hertz on the x-axis:
:CALCulate:MARKer2:X 5
:CALCulate:MARKer2:X 5Hz
To set reference marker #1 to 1.5 GHz on the x-axis:
:CALCulate:MARKer:X 1.5GHz
:CALCulate:MARKer1:X 1.5GHz
(In zero span) To set reference marker #3 to 1.5 seconds on the x-axis:
:CALCulate:MARKer3:X 1.5
:CALCulate:MARKer3:X 1.5s
(In zero span) To set reference marker #1 to 25 us:
:CALCulate:MARKer:X 25us
:CALCulate:MARker1:X 25us
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
Freq/Dist, 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
5.87 m
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
0.02 m
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, Prop Velocity
: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
1000.0 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
Shift-8 (System), Application Options, 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, Next, DTF Setup, Windowing