PIM Master™ Passive Intermodulation Analyzer with Site Master™ Cable & Antenna Analyzer Option Programming Manual : PIM Analyzer Programming Commands : :SENSe Subsystem
 
:SENSe Subsystem
The commands in this subsystem relate to device‑specific parameters, not signal‑oriented parameters.
[:SENSe]:DTPMeas:AVERage:TYPE
[:SENSe]:DTPMeas:AVERage:TYPE?
Title
DTP Trace Mode
Description
Sets and queries DTP trace mode
Parameter
NORMal = normal
MAXHold = max trace hold
Default Value:
None. If no value is sent, then no action occurs. To verify that a value has been received, follow the command with a query.
Example
To set DTP trace mode to normal:
:SENSe:DTPMeas:AVERage:TYPE NORMal
Front Panel Access
Setup, Normal -> A / Max Hold -> A
 
[:SENSe]:DTPMeas:DISPlay:BOTTom
[:SENSe]:DTPMeas:DISPlay:BOTTom?
Title
DTP Display Bottom
Description
Sets and queries DTP display magnitude in the current units (dBm by default).
Parameter
Bottom magnitude
Range
Bottom = –260 (top = 0)
Default Value:
None. If no value is sent, then no action occurs. To verify that a value has been received, follow the command with a query.
Example
To set the DTP display bottom to –100 dBm:
:SENSe:DTPMeas:DISPlay:BOTTom –100.0
Related Command
:SENSe:DTPMeas:DISPlay:TOP –15.0
:SENS:DTPM:DISP:TOP?
Front Panel Access
Amplitude, Bottom
 
[:SENSe]:DTPMeas:DISPlay:TOP
[:SENSe]:DTPMeas:DISPlay:TOP?
Title
DTP Display Top
Description
Sets and queries DTP display magnitude in the current units (dBm by default).
Parameter
Top magnitude
Range
Top = 0 (bottom = –260)
Default Value:
None. If no value is sent, then no action occurs. To verify that a value has been received, follow the command with a query.
Example
To set the DTP display top to –10 dBm:
:SENSe:DTPMeas:DISPlay:TOP –10.0
Related Command
:SENSe:DTPMeas:DISPlay:BOTTom –90.0
:SENS:DTPM:DISP:BOTT?
Front Panel Access
Amplitude, Top
 
[:SENSe]:DTPMeas:ENREsolution ON|OFF
[:SENSe]:DTPMeas:ENREsolution?
Title
PIM Master Enhanced Resolution
Description
This feature estimates the location of PIM sources on the measurement trace and displays up to 4 vertical impulse bars from bottom of measurement grid to point on measurement trace that indicates a predicted PIM source location. This is useful for resolving PIM sources that are physically close together.
Parameter
ON|OFF
Example
To set Enhanced Resolution to on:
:SENSe:DTPMeas:ENREsolution ON
Front Panel Access
Setup, Enhanced Resolution
 
[:SENSe]:PIManalyzer:AVERaging FAST|LOWNoise
[:SENSe]:PIManalyzer:AVERaging?
Title
PIM vs. Time Trace Mode.
Description
Low Noise provides improvement in measurement range. Fast provides faster measurement updates (measurements per second). The query returns FAST or LOWN (LOWNoise).
Parameter
FAST|LOWNoise
Range
FAST, Averaging is minimum
LOWNoise, Averaging is maximum
Example
To set the PIM Master measurement for maximum averaging:
:SENSe:PIManalyzer:AVERaging LOWNoise
Front Panel Access
Setup, Trace Mode
 
[:SENSe]:PIManalyzer:AUTorange OFF|ON|0|1
[:SENSe]:PIManalyzer:AUTorange?
Title
PIM vs. Time Auto Range
Description
Sets or queries the Auto Range condition for PIM vs. Time measurement.
Parameter
None. If no parameter is given, then ON is the default.
Range
0|OFF, Auto Ranging is OFF
1|ON, Auto Ranging is ON
Example
To set the PIM Master for Auto Range:
:SENSe:PIManalyzer:AUTorange 1
Front Panel Access
Amplitude, Auto Range
 
[:SENSe]:PIManalyzer:DTPMeas:LRDTf[:STATe] ON|OFF
[:SENSe]:PIManalyzer:DTPMeas:LRDTf[:STATe]?
Title
PIM Master Low Resolution DTF Sweep State
Description
Sets and queries whether a Low Resolution DTF sweep is performed during a Distance-To-PIM measurement.
Parameter
ON|OFF
Example
To enable the Low Resolution DTF sweep:
:SENSe:PIManalyzer:DTPMeas:LRDTf ON
To query whether the Low Resolution DTF sweep is enabled:
:PIM:DTPM:LRDT?
Front Panel Access
Setup, Low Resolution DTF
 
[:SENSe]:PIManalyzer:DTPMeas:LRDTf:STARt?
Title
PIM Master Low Resolution DTF Sweep Start Frequency
Description
Queries the DTF Sweep Start Frequency in Hz.
Parameter
Frequency in Hz
Example
To get the DTF Sweep Start Frequency:
:PIM:DTPM:LRDT:STAR?
Related Command
:SENSe:PIManalyzer:DTPMeas:LRDTf:STOP?
:PIM:DTPM:LRDT:STOP?
Front Panel Access
NA
 
[:SENSe]:PIManalyzer:DTPMeas:LRDTf:STOP?
Title
PIM Master Low Resolution DTF Sweep Stop Frequency
Description
Queries the DTF Sweep Stop Frequency in Hz.
Parameter
Frequency in Hz
Example
To get the DTF Sweep Stop Frequency:
:PIM:DTPM:LRDT:STOP?
Front Panel Access
NA
 
[:SENSe]:PIManalyzer:FREQuency:F1|2
[:SENSe]:PIManalyzer:FREQuency:F1|2?
Title
PIM Master Frequency Setup
Description
Sets the PIM vs. Time carrier frequencies, calculates the IMx Order frequency, and sets the instrument to display the corresponding IMx frequency.
Parameter
Frequency in Hz
Default Unit
Hz
Ranges
PIM Master option dependent (for a list of ranges, refer to Table: PIM Master Carrier Bands and Frequencies)
Example
To set the PIM vs. Time frequency F2 for 1990 MHz:
:SENSe:PIManalyzer:FREQuency:F2 1990000000
To get the PIM vs. Time frequency F1:
PIM:FREQ:F1?
Front Panel Access
Freq, Carrier F1|Carrier F2
 
[:SENSe]:PIManalyzer:FREQuency:STEP
[:SENSe]:PIManalyzer:FREQuency:STEP?
Title
PIM Master Frequency Sweep Step Size
Description
Sets Frequency Step Size for Swept PIM and Spectrum View measurement modes. The instrument may take up to 5 seconds to update this parameter and all dependent configurations.
Parameter
Frequency in Hz
Ranges
100 kHz to 1000 kHz in 100 kHz increments
Example
To set the step size to 100 kHz:
:SENSe:PIManalyzer:FREQuency:STEP 100000
To get the frequency step size:
PIM:FREQ:STEP?
Front Panel Access
Freq, Step Size
 
[:SENSe]:PIManalyzer:HIReflection:BYPass
[:SENSe]:PIManalyzer:HIReflection:BYPass?
Title
High Reflection Error Bypass
Description
Enables or disables the high reflection error bypass.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
None. If no value is sent, then no action occurs. To verify that a value has been received, follow the command with a query.
Example
To enable the high reflection error bypass:
SENSe:PIManalyzer:HIReflection:BYPass ON
To query the state of the high reflection bypass:
PIM:HIR:BYP?
Front Panel Access
Setup, High Reflection Bypass
 
[:SENSe]:PIManalyzer:IMD:ORDer
[:SENSe]:PIManalyzer:IMD:ORDer?
Title
Measurement Receiver / PIM Master Intermodulation Distortion (IMD) Order Setup
Description
Sets the measurement receiver center frequency to receive one of the following IMDs from the PIM Master measurement system: 3/5/7. The query command returns the possible strings “3rd”, “5th”, and “7th” depending on the current selection of IMD Order.
Default Value
3
Range
3, 5, and 7 are the only acceptable values.
Example
To set the measurement receiver for the 5th order IMD:
:SENSe:PIManalyzer:IMD:ORDer 5
Sets the measurement receiver center frequency to the 5th order IMD.
Front Panel Access
Freq, Intermod Order
 
[:SENSe]:PIManalyzer:IMFReq:BAND LOW|HIGH
[:SENSe]:PIManalyzer:IMFReq:BAND?
Title
Optional High/Low IMD frequency band selection
Description
Sets the receive IMD measurement frequency band. This command works for all options that have band switching functionality, such as with Options 194, 210, 600, or Option 702. The command and the query are ignored by MW82119B PIM Masters with other instrument options.
Parameter
LOW: corresponds to Low, PCS/AWS, GSM, or 600 MHz bands
HIGH: corresponds to High, PCS, IM2, or 1900 MHz bands
Default Value
None. If no value is sent, then no action occurs. To verify that a value has been received, follow the command with a query.
Example
To set the measurement receiver to High Band:
:SENSe:PIManalyzer:IMFReq:BAND HIGH
Front Panel Access
PIM vs. Time and Swept PIM:
 Freq, High/Low Band Select (Low, PCS/AWS, GSM, or 600 MHz bands)
Distance‑to‑PIM:
 Distance, High/Low Band Select (High, PCS, IM2, or 1900 MHz bands)
[:SENSe]:PIManalyzer:MEASure:STATus?
Title
PIM Analyzer Current Measurement Status
Description
The query returns the current measurement status of the measurement receiver/PIM Analyzer measurement system. Because the measurement system can run for the maximum time duration, the query serves to indicate if the measurement is still in process. This command works with any of the available measurement modes: PIM vs. Time, DTP, and Swept PIM.
Range
0, Measurement is OFF
1, Measurement is ON
[:SENSe]:PIManalyzer:MEASure:VALue?
Title
Measurement Receiver Measured Value From PIM Master Measurement Setup
Description
This query returns the peak measured value in both dBc and dBm. For example, if the output power is set to 43 dBm and a PIM value of –80 dBm was read, then this command would return: –123.0, –80.0
This command is not supported for the Distance-To-PIM measurement mode. The dBc value should be ignored for the Noise Floor measurement modes.
A return value of –160 dBm for this query indicates that the measurement is invalid.
 
Query Response:
<amplitude>, <amplitude>
Default Unit
dBc/dBm
Front Panel Access
N/A. Intermodulation distortion value is displayed in the lower measurement box as “PIM”.
[:SENSe]:PIManalyzer:MODe PIM|PIMSwp|DTP|SPECTRUM_VIEW
[:SENSe]:PIManalyzer:MODe?
Title
PIM Analyzer Mode, Set or Request
Description
Puts the system into PIM vs. Time (PIM), Swept PIM (PIMSwp), Distance‑to‑PIM (DTP), or Spectrum View (SPECTRUM_VIEW) measurement mode. The query reports the current system mode. Changing to Swept PIM mode can take as long as 20 seconds.
NOTE: DTP is not supported in 2-port mode.
Parameter
PIM|PIMSwp|DTP|SPECTRUM_VIEW
Query Response
PIM (PIM vs. Time)
PIMSwp (Swept PIM)
DTP (Distance‑to‑PIM)
SPECTRUM_VIEW (Spectrum View)
Default Value
None. If no value is sent, then no action occurs. To verify that a value has been received, follow the command with a query.
Example
To set the PIM Analyzer mode to measure Distance‑to‑PIM:
:SENSe:PIManalyzer:MODe DTP
To query the state of the PIM Analyzer system:
:SENS:PIM:MOD?
Front Panel Access
Measurements, PIM|Distance-to-PIM|Swept PIM|
Noise Floor Measurements| Spectrum View
 
[:SENSe]:PIManalyzer:OUTPut:POWer
[:SENSe]:PIManalyzer:OUTPut:POWer?
Title
PIM Analyzer Output Power
Description
Sets the deliverable output (in dBm) from the PIM Analyzer to the system under test.
Parameter
dBm input with 0.1 dBm resolution
Default Value
None. If no value is sent, then no action occurs. To verify that a value has been received, follow the command with a query.
Range
20 dBm to 46 dBm
Example
To set the PIM Analyzer output power to 43.5 dBm:
:SENSe:PIManalyzer:OUTPut:POWer 43.5
Front Panel Access
PIM vs. Time and Swept PIM: Setup, PIM Aid, Output Power
PIM vs. Time and Swept PIM: Freq, PIM Aid, Output Power
DTP: Distance, DTP Aid, Output Power
DTP: Setup, DTP Aid, Output Power
 
[:SENSe]:PIManalyzer:RF:OUTput ON|OFF
[:SENSe]:PIManalyzer:RF:OUTput?
Title
PIM vs. Time – Set RF Out On/Off
Description
This controls the measurement type of Normal or Noise Floor PVT, which corresponds to whether the RF is ON (for Noise Floor PVT) or OFF (for Normal) during a measurement.
Parameter
ON|OFF
Parameter Type
<char>
Default Value
ON|OFF
Range
20 dBm to 46 dBm
Example
To set a Noise Floor PVT measurement:
:SENSe:PIManalyzer:RF:OUTPut ON
Front Panel Access
Measurements> PIM vs. Time or Noise Floor
 
[SENSe:]PIManalyzer:TWOPort:STATe ON|OFF
[SENSe:]PIManalyzer:TWOPort:STATe?
Title
Two-Port State for PIM Master.
Description
This sets/gets the state of 2-port mode. The command takes a Boolean value (1|0|ON|OFF) and the query returns 1 when 2-port mode is on, and 0 when it is off. If you do not give the command a valid parameter, the state remains unchanged.
Parameter
1|0|ON|OFF
Parameter Type
<char>
Front Panel Access
Frequency>2-Port Mode
 
[:SENSe]:PIManalyzer:SPECtrum:CURRent:MEASure:VALue?
Title
Measured Noise Floor Value from PIM Master
Description
The query returns the latest measured value of Spectrum View in dBm.
Related Command
[:SENSe]:PIManalyzer:SPECtrum:CURRent:FREQuency?
[:SENSe]:PIManalyzer:SPECtrum:MAX:MEASure:VALue?
Front Panel Access
N/A. Signal value is displayed in the lower measurement box as “Signal Amplitude”.
 
[:SENSe]:PIManalyzer:SPECtrum:CURRent:FREQuency?
Title
Measured Noise Floor Frequency from PIM Master
Description
The query returns the latest measured frequency of Spectrum View in Hz.
Related Command
[:SENSe]:PIManalyzer:SPECtrum:CURRent:MEASure:VALue?
[:SENSe]:PIManalyzer:SPECtrum:MAX:FREQuency?
Front Panel Access
N/A. Signal frequency is displayed in the lower measurement box after the “Signal Amplitude” in dBm.
 
[:SENSe]:PIManalyzer:SPECtrum:MAX:MEASure:VALue?
Title
Maximum Measured Noise Floor Value from PIM Master
Description
The query returns the maximum measured value of Spectrum View in dBm.
Related Command
[:SENSe]:PIManalyzer:SPECtrum:MAX:FREQuency?
[:SENSe]:PIManalyzer:SPECtrum:CURRent:MEASure:VALue?
Front Panel Access
N/A. Maximum signal value is displayed in the lower measurement box as “Max Amplitude”.
[:SENSe]:PIManalyzer:SPECtrum:MAX:FREQuency?
Title
Frequency at Maximum Measured Noise Floor Value from PIM Master
Description
The query returns the frequency of the maximum signal measured in Spectrum View in Hz.
Related Command
[:SENSe]:PIManalyzer:SPECtrum:MAX:MEASure:VALue?
[:SENSe]:PIManalyzer:SPECtrum:CURRent:FREQuency?
Front Panel Access
N/A. Maximum signal frequency is displayed in the lower measurement box after the Max Amplitude dBm value.
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F1|2?
Title
PIM Master Swept PIM F2 Stop Frequency Setup
Description
Queries the Swept PIM Fixed F1 or F2 frequency.
Parameter
Frequency in Hz
Default Unit
Hz
Range
PIM Master option dependent (for a list of ranges, refer to Table: PIM Master Carrier Bands and Frequencies).
Example
To get the Swept PIM Fixed F2 frequency:
PIM:SWEE:FREQ:F2?
Front Panel Access
NA Note that fixed F1 and F2 frequencies are displayed in the lower measurement box in Swept Pim mode.
 
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F1:STARt
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F1:STARt?
Title
PIM Master Swept PIM F1 Start Frequency Setup
Description
Sets the Swept PIM F1 start frequency for the Fixed F2 sweep, then calculates the IMx sweep frequencies, and sets the instrument to display the corresponding IMx sweep frequencies.
Parameter
Frequency in Hz
Default Unit
Hz
Range
PIM Master option dependent (for a list of ranges, refer to Table: PIM Master Carrier Bands and Frequencies).
Example
To set the F1 start frequency to 1990 MHz:
:SENSe:PIManalyzer:SWEEp:FREQuency:F1:STARt 1990000000
To get the Swept PIM F1 start frequency:
PIM:SWEE:FREQ:F1:STAR?
Front Panel Access
Freq, Swept PIM Aid, F1 Start
 
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F1:STOP
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F1:STOP?
Title
PIM Master Swept PIM F1 Stop Frequency Setup
Description
Sets the Swept PIM F1 stop frequency for the Fixed F2 sweep, then calculates the IMx sweep frequencies, and sets the instrument to display the corresponding IMx sweep frequencies.
Parameter
Frequency in Hz
Default Unit
Hz
Range
PIM Master option dependent (for a list of ranges, refer to Table: PIM Master Carrier Bands and Frequencies).
Example
To set the F1 stop frequency to 2110 MHz:
:SENSe:PIManalyzer:SWEEp:FREQuency:F1:STOP 2110000000
To get the Swept PIM F1 stop frequency:
PIM:SWEE:FREQ:F1:STOP?
Front Panel Access
Freq, Swept PIM Aid, F1 Stop
 
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F2:STARt
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F2:STARt?
Title
PIM Master Swept PIM F2 Start Frequency Setup
Description
Sets the Swept PIM F2 start frequency for the Fixed F1 sweep, then calculates the IMx sweep frequencies, and sets the instrument to display the corresponding IMx sweep frequencies.
Parameter
Frequency in Hz
Default Unit
Hz
Range
PIM Master option dependent (for a list of ranges, refer to Table: PIM Master Carrier Bands and Frequencies).
Example
To set the F2 start frequency to 758 MHz:
:SENSe:PIManalyzer:SWEEp:FREQuency:F2:STARt 758000000
To get the Swept PIM F2 start frequency:
PIM:SWEE:FREQ:F2:STAR?
Front Panel Access
Freq, Swept PIM Aid, F2 Start
 
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F2:STOP
[:SENSe]:PIManalyzer:SWEEp:FREQuency:F2:STOP?
Title
PIM Master Swept PIM F2 Stop Frequency Setup
Description
Sets the Swept PIM F2 stop frequency for the Fixed F1 sweep, then calculates the IMx sweep frequencies, and sets the instrument to display the corresponding IMx sweep frequencies.
Parameter
Frequency in Hz
Default Unit
Hz
Range
PIM Master option dependent (for a list of ranges, refer to Table: PIM Master Carrier Bands and Frequencies).
Example
To set the F2 stop frequency to 768 MHz:
:SENSe:PIManalyzer:SWEEp:FREQuency:F2:STOP 768000000
To get the Swept PIM F2 stop frequency:
PIM:SWEE:FREQ:F2:STOP?
Front Panel Access
Freq, Swept PIM Aid, F2 Stop
 
[:SENSe]:PIManalyzer:SWEEp:IMD:ORDer
[:SENSe]:PIManalyzer:SWEEp:IMD:ORDer?
Title
PIM Analyzer Swept PIM Intermodulation Distortion (IMD) Order Setup
Description
Sets the measurement receiver center frequency to receive one of the following IMDs from the PIM Analyzer measurement system: 3/5/7. The query command returns the possible strings “3rd”, “5th”, and “7th”, depending on the current selection of IMD Order.
Default Value
3
Range
3, 5, and 7 are the only acceptable values.
Example
To set the measurement receiver center frequency to the 5th order IMD:
:SENSe:PIManalyzer:SWEEp:IMD:ORDer 5
Front Panel Access
Freq, Intermod Order
 
[:SENSe]:PIManalyzer:TEMPerature? CURRent|CALibration
Title
PIM Analyzer current temperature
Description
Returns the current temperature. If the value cannot be read, N/A is returned
 
[:SENSe]:PIManalyzer:TEST:DURation
[:SENSe]:PIManalyzer:TEST:DURation?
Title
PIM Test Measurement Test Duration
Description
Sets the amount of time in seconds the PIM Master will be on for intermodulation distortion measurements.
Parameter
<time>
Default Value
20
Default Unit
Seconds
Range
1.0 to 1200.0 seconds
Example
To set the test duration time to 5 seconds:
:SENSe:PIManalyzer:TESt:DURation 5.0
Front Panel Access
Setup, Test Duration