: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?

: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

:CALCulate:LIMit:ALARm 0

To turn on limit alarm:

:CALCulate:LIMit:ALARm ON

:CALCulate:LIMit:ALARm 1

: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?

: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?

: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]?

: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

:CALCulate:LIMit:STATe ON

:CALCulate:LIMit:STATe 1

To turn off the limit line:

:CALCulate:LIMit OFF

:CALCulate:LIMit:STATe 0

:CALCulate:LIMit 0

: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]?

: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?

: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]?

: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

: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

: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?

: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

: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]?

: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?

: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?

: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?

: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?

: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?

: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?

: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?

: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?

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