S331E, S332E, S361E, S362E Site Master™MS2711E, MS2712E, MS2713E Spectrum Master™MT8212E, MT8213E Cell Master™ Programming Manual : Spectrum Analyzer Commands : :SENSe Subsystem
 
:SENSe Subsystem
The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters.
[:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent <freq>
[:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent?
Title
ACPR Adjacent Channel Bandwidth
Description
Sets the adjacent channel bandwidth for the ACPR measurement.
Parameter
<freq>
Default Value
10.35 MHz
Default Unit
Hz
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, ACPR, Adj/Alt Ch BW
[:SENSe]:ACPower:BANDwidth|BWIDth:MAIN <freq>
[:SENSe]:ACPower:BANDwidth|BWIDth:MAIN?
Title
ACPR Main Channel Bandwidth
Description
Sets the main channel bandwidth for the ACPR measurement.
Parameter
<freq>
Default Value
10.35 MHz
Default Unit
Hz
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, ACPR, Main Ch BW
[:SENSe]:ACPower:BANDwidth|BWIDth:SPACing <freq>
[:SENSe]:ACPower:BANDwidth|BWIDth:SPACing?
Title
ACPR Channel Spacing
Description
Sets the channel spacing for the ACPR measurement.
Parameter
<freq>
Default Value
10.35 MHz
Default Unit
Hz
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, ACPR, Ch Spacing
[:SENSe]:ACPower:STATe OFF|ON|0|1
[:SENSe]:ACPower:STATe?
Title
ACPR Measurement State
Description
Sets the state of the adjacent channel power ratio measurement, ON or OFF. When using :CONFigure:ACPower, the state is automatically set to ON.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
[:SENSe]:AVERage:COUNt <integer>
[:SENSe]:AVERage:COUNt?
Title
Number of Traces to Average
Description
Sets the number of traces to average.
Parameter
<integer>
Parameter Type
<integer>
Default Value
10
Range
2 to 65535
Front Panel Access
Shift‑5 (Trace), Trace A Operations, # of Averages
[:SENSe]:AVERage:TYPE NONE|SCALar|MAXimum|MINimum
[:SENSe]:AVERage:TYPE?
Title
Trace Mode (Normal/Average/Max Hold/Min Hold)
Description
Specifies how successive traces are combined to produce the resulting display value. Setting the TYPE to NONE is the equivalent of setting the trace mode to “Normal->A” on the front panel. The displayed value for a point is the current measured value for that point. Setting the TYPE to SCALar is the equivalent of setting the trace mode to “Average->A” on the front panel. The displayed value for a point is the average of the last <integer> measured values where <integer> is set by [:SENSe]:AVERage:COUNt. Setting the TYPE to MAXimum is the equivalent of setting the trace mode to “Max Hold->A” on the front panel. The displayed value for a point is the maximum measured value for that point over sweeps. Setting the TYPE to MINimum is the equivalent of setting the trace mode to “Min Hold->A” on the front panel. The displayed value for a point is the minimum measured value for that point over sweeps.
Parameter
NONE|SCALar|MAXimum|MINimum
Parameter Type
<char>
Default Value
NONE
Example
To set the TYPE to SCALar:
:SENSe:AVERage:TYPE SCALar
To set the TYPE to MAXimum:
:SENSe:AVERage:TYPE MAXimum
Related Command
[:SENSe]:AVERage:COUNt
Front Panel Access
Shift‑5 (Trace), Trace A Operations
[:SENSe]:BANDwidth|BWIDth:VIDeo <freq>
[:SENSe]:BANDwidth|BWIDth:VIDeo?
Title
Video Bandwidth
Description
Sets the video bandwidth. Note that using this command turns the automatic video bandwidth setting OFF.
Parameter
<freq>
Default Value
1 MHz
Default Unit
Hz
Range
1 Hz to 3 MHz in a 1:3 sequence except for the MS2711E
10 Hz to 3 MHz in a 1:3 sequence for the MS2711E
Related Command
[:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO
Front Panel Access
BW, VBW
[:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO OFF|ON|0|1
[:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO?
Title
Video Bandwidth Coupling
Description
Sets the state of the coupling of the video bandwidth to the resolution bandwidth. Setting the value to ON or 1 results in the video bandwidth being coupled to the resolution bandwidth. That is, when the resolution bandwidth changes, the video bandwidth changes. Setting the value to OFF or 0 results in the video bandwidth being un-coupled from the resolution bandwidth. That is, changing the resolution bandwidth does not change the video bandwidth. When this command is issued, the video bandwidth setting itself does not change. The default value is ON. That is, sending :SENS:BAND:VID:AUTO is equivalent to sending :SENS:BAND:VID:AUTO ON.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
ON
Front Panel Access
BW, Auto VBW
[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio <number>
[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio?
Title
Video Bandwidth to Resolution Bandwidth Ratio
Description
Sets the ratio of the video bandwidth to the resolution bandwidth for use when the video to resolution bandwidth coupling is enabled. Note that the front panel interface sets the inverse ratio: the resolution bandwidth to the video bandwidth which is an integer, in other words, if you send 0.35, the display shows 2 not 2.857.
Parameter
<number>
Default Value
0.33
Range
0.00001 to 1
Related Command
[:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO
Front Panel Access
BW, RBW/VBW (note that this is the inverse ratio)
[:SENSe]:BANDwidth|BWIDth[:RESolution] <freq>
[:SENSe]:BANDwidth|BWIDth[:RESolution]?
Title
Resolution Bandwidth
Description
Sets the resolution bandwidth. Note that using this command turns OFF the automatic resolution bandwidth setting.
Parameter
<freq>
Default Value
3 MHz
Default Unit
Hz
Range
1 Hz to 3 MHz in a 1:3 sequence except for the MS2711E
100 Hz to 3 MHz in a 1:3 sequence for the MS2711E
Related Command
[:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO
Front Panel Access
BW, RBW
[:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO OFF|ON|0|1
[:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO?
Title
Resolution Bandwidth Coupling
Description
Sets the state of the coupling of the resolution bandwidth to the frequency span. Setting the value to ON or 1 results in the resolution bandwidth being coupled to the span. That is, when the span changes, the resolution bandwidth changes. Setting the value to OFF or 0 results in the resolution bandwidth being un-coupled from the span. That is, changing the span does not change the resolution bandwidth. When this command is issued, the resolution bandwidth setting itself does not change. The default value is ON. That is, sending :SENS:BAND:RES:AUTO is equivalent to sending :SENS:BAND:RES:AUTO ON.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
ON
Related Command
[:SENSE]:BANDwidth|BWIDth[:RESolution]:RATio
Front Panel Access
BW, Auto RBW
[:SENSe]:BANDwidth|BWIDth[:RESolution]:RATio <number>
[:SENSe]:BANDwidth|BWIDth[:RESolution]:RATio?
Title
Resolution Bandwidth to Span Ratio
Description
Sets the ratio of the resolution bandwidth to the span for use when the resolution bandwidth to span coupling is enabled. Note that the front panel interface sets the inverse ratio: the span to the resolution bandwidth.
Parameter
<number>
Default Value
0.01
Range
0.00001 to 1
Related Command
[:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO
Front Panel Access
BW, Span/RBW (note that this is the inverse ratio)
[:SENSe]:CHPower:BANDwidth|BWIDth:INTegration <freq>
[:SENSe]:CHPower:BANDwidth|BWIDth:INTegration?
Title
Channel Power Integration Bandwidth
Description
Sets the integration bandwidth for the channel power measurement. Integration bandwidth must be less than or equal to the frequency span.
Parameter
<freq>
Default Value
10.35 MHz
Default Unit
Hz
Related Command
[:SENSe]:FREQuency:SPAN
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, Channel Power, Ch Pwr Width
[:SENSe]:CHPower:STATe OFF|ON|0|1
[:SENSe]:CHPower:STATe?
Title
Channel Power Measurement State
Description
Sets the state of the channel power measurement, ON or OFF. When using :CONFigure:CHPower, the state is automatically set to ON.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Related Command
:CONFigure:ACPower
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, Channel Power, On/Off
[:SENSe]:CORRection:IMPedance[:INPut]:OFFSet <rel ampl>
[:SENSe]:CORRection:IMPedance[:INPut]:OFFSet?
Title
Other Input Impedance Loss
Description
Sets the value that is used for amplitude correction when the value set by [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] is something other than 50 or 75. This value is not applied if the impedance is set to either 50 or 75.
Parameter
<rel ampl>
Default Value
0
Default Unit
dB
Range
0 dB to 100 dB
Related Command
[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]
Front Panel Access
Shift‑8 (System), Application Options, Impedance
[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] <integer>
[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]?
Title
Input Impedance
Description
Sets the input impedance that is used for amplitude correction and conversion between units (dBm vs. dBV vs. Volts, etc.). If the value of <integer> is 50 no correction is performed. If the value of <integer> is 75 correction is done based on Anritsu adapter 12N50-75B.
Parameter
<integer>
Parameter Type
<integer>
Default Value
50
Range
50, 75 all other values are treated as described above
Related Command
[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio
Front Panel Access
Shift‑8 (System), Application Options, Impedance
[:SENSe]:DETector[:FUNCtion] POSitive|RMS|NEGative|SAMPle
[:SENSe]:DETector[:FUNCtion]?
Title
Detection Type
Description
Sets the detection method for calculating each display point. Each display point represents several measurements. The detection type determines how the display point is derived from its associated measurements. POSitive Peak detection displays the maximum value of the associated measurements. RMS detection displays the average power of the associated measurements. NEGative Peak detection displays the minimum value of the associated measurements. SAMPle detection displays the “middle” point of those measurements associated with a display point. For example, if there are 3 measurement frequencies associated with a given display point, sample detection displays the value at the frequency of the second measurement point.
Parameter
POSitive|RMS|NEGative|SAMPle
Parameter Type
<char>
Default Value
(Positive) Peak
Front Panel Access
Amplitude, Detection
[:SENSe]:EMF:STATe OFF|ON|0|1
[:SENSe]:EMF:STATe?
Title
EMF State
Description
Switches EMF ON or OFF.
The query form of this command returns a 0 or 1 when EMF state is OFF or ON, respectively.
Note: EMF turns ON only if the start and stop frequencies are within the frequency range of the spectrum analyzer and isotropic antenna used. The antenna must be connected.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, EMF Measurement, On/Off
[:SENSe]:EXTRefstatus?
Title
Frequency Reference Status
Description
Returns 0 for internal or GPS reference. Returns 1 for external reference.
Front Panel Access
None
[:SENSe]:FREQuency:CENTer <freq>
[:SENSe]:FREQuency:CENTer?
Title
Center Frequency
Description
Sets the center frequency. Note that changing the value of the center frequency changes the value of the coupled parameters Start Frequency and Stop Frequency. It may also change the value of the span.
Parameter
<freq>
Default Unit
Hz
Front Panel Access
Freq, Center Freq
[:SENSe]:FREQuency:SIGStandard:CHANnel <number>
[:SENSe]:FREQuency:SIGStandard:CHANnel?
Title
Channel Selection
Description
Sets the channel number for the selected signal standard.
Parameter
<number>
Front Panel Access
Freq, Channel
[:SENSe]:FREQuency:SIGStandard:NAMe <string>
[:SENSe]:FREQuency:SIGStandard:NAMe?
Title
Signal Standard
Description
Selects the desired signal standard from the list. The <string> argument is the name of the desired signal standard as displayed in the instrument’s current signal standard list. The list can be displayed on the instrument by choosing the Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is P-GSM 900 - Uplink, then the value of the <string> argument would be “P-GSM 900 - Uplink”.
The query form of this command returns the name of the currently selected Signal Standard on the list.
Parameter
<string>
Front Panel Access
Freq, Signal Standard
[:SENSe]:FREQuency:SPAN <freq>
[:SENSe]:FREQuency:SPAN?
Title
Frequency Span
Description
Sets the frequency span. Setting the value of <freq> to 0 Hz is the equivalent of setting the span mode to zero span. Note that changing the value of the frequency span changes the value of the coupled parameters Start Frequency and Stop Frequency and may change the Center Frequency.
Parameter
<freq>
Default Unit
Hz
[:SENSe]:FREQuency:SPAN:FULL
Title
Frequency Span – Full
Description
Sets the frequency span to full span. Note that changing the value of the frequency span changes the value of the coupled parameters, Start Frequency and Stop Frequency and may change the Center Frequency.
Front Panel Access
Span, Full Span
[:SENSe]:FREQuency:SPAN:PREVious
Title
Frequency Span – Last
Description
Sets the frequency span to the previous span value. Note that changing the value of the frequency span changes the value of the coupled parameters, Start Frequency and Stop Frequency and may change the Center Frequency.
Default Unit
Hz
Front Panel Access
Span, Last Span
[:SENSe]:FREQuency:STARt <freq>
[:SENSe]:FREQuency:STARt?
Title
Start Frequency
Description
Sets the start frequency. Note that in the spectrum analyzer, changing the value of the start frequency changes the value of the coupled parameters, Center Frequency and Span.
Parameter
<freq>
Default Value
0 Hz
Default Unit
Hz
Related Command
[:SENSe]:FREQuency:STOP?
Front Panel Access
Freq, Start Freq
[:SENSe]:FREQuency:STEP[:INCRement] <freq>
[:SENSe]:FREQuency:STEP[:INCRement]?
Title
Frequency Step
Description
Sets the frequency step to the given frequency value.
Parameter
<freq>
Default Value
1 MHz
Default Unit
Hz
Range
1 Hz to 20 GHz
Front Panel Access
Freq, Step Size & Offset, Freq Step
Note 
Setting the frequency step size above the maximum span of the instrument causes the maximum value to be set for the Center Freq, Start Freq or Stop Freq submenu key when the up arrow key is pressed and the minimum value set when the down arrow key is pressed.
[:SENSe]:FREQuency:STOP <freq>
[:SENSe]:FREQuency:STOP?
Title
Stop Frequency
Description
Sets the stop frequency. Note that in the spectrum analyzer, changing the value of the stop frequency changes the value of the coupled parameters, Center Frequency and Span.
Parameter
<freq>
Default Unit
Hz
[:SENSe]:FSTRength:ANTenna <antenna>
[:SENSe]:FSTRength:ANTenna?
Title
Field Strength Antenna
Description
Selects an antenna from the antenna list to use for field strength measurement result calculations. The <antenna> argument is a 1-based index of the position of the desired antenna in the instrument’s current antenna list. The list can be displayed on the instrument by choosing the “Antenna” submenu button in the “F Strength” menu. For example, if the desired antenna were the 3rd item on the antenna listing, then the value of the <antenna> argument would be 3.
The <antenna> value for EMI antenna list starts from 65.
The query form of this command returns the index of the currently selected antenna.
Note 
An invalid selection returns a zero when queried.
Parameter
<antenna>
Default Value
1
Related Command
:CONFigure:FSTRength
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, Field Strength, Antenna
[:SENSe]:FSTRength:STATe OFF|ON|0|1
[:SENSe]:FSTRength:STATe?
Title
Field Strength Measurement State
Description
Sets the state of the field strength measurement, ON or OFF. When using :CONFigure:FSTRength, the state is automatically set to ON.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Related Command
:CONFigure:CHPower
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, Field Strength, On/Off
[:SENSe]:OBWidth:METHod XDB|PERCent
[:SENSe]:OBWidth:METHod?
Title
Occupied Bandwidth Measurement Method
Description
Sets the method for calculating occupied bandwidth. XDB calculates the occupied bandwidth based on points a specified number of dB below the carrier. Issue command [:SENSe]:OBWidth:XDB to set the number of dB to be used. PERCent calculates the occupied bandwidth based on points a specified percentage of the carrier power below the carrier. Issue command [:SENSe]:OBWidth:PERCent to set the percentage to be used.
Parameter
XDB|PERCent
Parameter Type
<char>
Default Value
PERCent
Related Command
[:SENSe]:OBWidth:XDB [:SENSe]:OBWidth:PERCent
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, OCC BW
[:SENSe]:OBWidth:PERCent <percentage>
[:SENSe]:OBWidth:PERCent?
Title
Occupied Bandwidth Percent of Power
Description
This command sets the percentage of carrier power used to measure the occupied bandwidth. This value is used in the measurement if :SENSe:OBWidth:METHod is set to PERCent.
Parameter
<percentage>
Default Value
99
Default Unit
%
Range
0% to 100%
Related Command
[:SENSe]:OBWidth:METHod
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, OCC BW, %
[:SENSe]:OBWidth:STATe OFF|ON|0|1
[:SENSe]:OBWidth:STATe?
Title
Occupied Bandwidth Measurement State
Description
Sets the state of the occupied bandwidth measurement, ON or OFF. When using :CONFigure:OBWidth, the state is automatically set to ON.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Related Command
:CONFigure:OBWidth
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, OCC BW, On/Off
[:SENSe]:OBWidth:XDB <rel ampl>
[:SENSe]:OBWidth:XDB?
Title
Occupied Bandwidth dB Down
Description
This command sets the number of dB below the carrier used to measure the occupied bandwidth. This value is used in the measurement if :SENSe:OBWidth:METHod is set to XDB.
Parameter
<rel ampl>
Default Value
3 dBc
Default Unit
dBc
Range
0 to 100 dBc
Related Command
[:SENSe]:OBWidth:METHod
Front Panel Access
Shift‑4 (Measure), Power and Bandwidth, OCC BW, dBc
[:SENSe]:OPTion:IF:BWSTate 1|2|3|4|5
[:SENSe]:OPTion:IF:BWSTate?
Title
IF Bandwidth State
Description
Sets the IF Bandwidth. Setting a value of 1 is equivalent of setting the IF Bandwidth to Normal on the front panel. Setting a value of 3 is equivalent of setting the IF Bandwidth to 10 MHz BW on the front panel. Setting the value of 4 is equivalent of setting the IF Bandwidth to 16 MHz BW on the front panel. Note that option 89 must be available and in Zero span for the command to be valid. The query version of this command returns a 0 if not in zero span.
Parameter
1|2|3|4|5
Range
1|2|3|4|5
[:SENSe]:POWer[:RF]:ATTenuation <rel ampl>
[:SENSe]:POWer[:RF]:ATTenuation?
Title
Input Attenuation
Description
Sets the input attenuation. Note that issuing this command sets the automatic input attenuation OFF.
Parameter
<rel ampl>
Default Value
30 dB
Default Unit
dB
Range
0 dB to 65 dB
Related Command
[:SENSe]:POWer[:RF]:ATTenuation:AUTO
Front Panel Access
Amplitude, Atten Lvl
[:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1
[:SENSe]:POWer[:RF]:ATTenuation:AUTO?
Title
Input Attenuation Coupling
Description
Sets the input attenuation coupling. Setting the value to ON or 1 results in the input attenuation being coupled to the reference level. Setting the value to OFF or 0 results in the input attenuation being un-coupled from the reference level. That is, changing the reference level does not change the input attenuation. When this command is issued, the input attenuator setting itself does not change. The default value is ON. That is, sending :SENS:POW:ATT:AUTO is equivalent to sending :SENS:POW:ATT:AUTO ON.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
ON
Related Command
[:SENSe]:POWer[:RF]:ATTenuation
Front Panel Access
Amplitude, Auto Atten
[:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1
[:SENSe]:POWer[:RF]:GAIN[:STATe]?
Title
Preamp State
Description
Sets the state of the preamp. Note that this may cause a change in the reference level and/or attenuation.
Note: The MS2711E returns a value of -1 if Preamp (Option 8) is not installed.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Front Panel Access
Amplitude, Pre Amp
[:SENSe]:SWEep:MODE FAST|PERFormance|NOFFt
[:SENSe]:SWEep:MODE?
Title
Sweep Mode
Description
Sets the sweep mode to Fast, Performance or No FFT. The query from of this command returns the current sweep mode short form.
Note: FAST Sweep Mode is not available for the MS2711E.
Parameter
FAST|PERFormance|NOFFt
Parameter Type
<char>
Front Panel Access
Shift‑3 (Sweep), Sweep Mode
[:SENSe]:SWEep:STATus?
Title
Sweep Status
Description
Returns 1 when the sweep is complete. Returns 0 when the sweep is in progress.
Front Panel Access
None
[:SENSe]:SWEep:TIME[:LLIMit]
[:SENSe]:SWEep:TIME[:LLIMit]?
Title
Minimum Sweep Time
Description
Sets the value of the minimum sweep time parameter. The sweep completes in the shortest time possible. To sweep as fast as possible, enter the minimum value allowed for the sweep time.
Default Value
0.001
Default Unit
Seconds
Range
10 μs to 600000000 μs
Front Panel Access
Shift‑3 (Sweep), Sweep Time
[:SENSe]:SWEep:TIME:ACTual?
Title
Actual Sweep Time
Description
Returns the actual sweep time as opposed to the specified sweep time.
Default Unit
Seconds
[:SENSe]:SWEep:TIME:AUTO ON|OFF|1|0
[:SENSe]:SWEep:TIME:AUTO?
Title
Auto Sweep Time
Description
Sets Auto Sweep Time on or off.
Front Panel Access
Shift‑3 (Sweep), Auto Sweep Time
[:SENSe]:SWEep:TRACe?
Title
Trace Count
Description
Returns a string with two integers representing the current trace’s average count and the total number of trace averages.
Front Panel Access
None