The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters.
[:SENSe]:AVERage:COUNt <number>
[:SENSe]:AVERage:COUNt?
Title
Sense Average Count
Description
Sets the effective number of averages and the length of the rolling min and max hold. Due to memory limitations the actual length of buffers for rolling min and max hold are limited to 2,000,000 / number of trace points.
Specifies how successive traces are combined to produce the resulting display value. Setting the TYPE to NORMal will cause the displayed value for a point to be the current measured value for that point. Setting the TYPE to AVERage will cause the displayed value for a point to be the average of the last <integer> measured values where <integer> is set by [:SENSe]:AVERage:COUNt. Setting the TYPE to MAXimum will cause the displayed value for a point is the maximum measured value for that point over sweeps. Setting the TYPE to MINimum will cause the displayed value for a point is the minimum measured value for that point over sweeps.Setting the TYPE to RMAXimum will cause the displayed value for a point to be the maximum of the last <integer> measured values where <integer> is set by [:SENSe]:AVERage:COUNt.Setting the TYPE to RMINimum will cause the displayed value for a point to be the minimum of the last <integer> measured values where <integer> is set by [:SENSe]:AVERage:COUNt.
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.
Parameters
<numeric_value>
Query Return
Numeric
Default Value
0.01
Range
1e-05 to 1
[:SENSe]:BANDwidth|BWIDth:SHAPe <FLATtop|NUTall>
[:SENSe]:BANDwidth|BWIDth:SHAPe?
Title
Rbw Filter Type
Description
This command sets the rbw filter type, Flat Top window or Nutall.
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 will show 2 not 2.857
[:SENSe]:BANDwidth[:RESolution]:AUTO <0 | 1 | ON | OFF>
[:SENSe]:BANDwidth[:RESolution]:AUTO?
Title
RBW Auto
Description
Sets the state of the coupling of the resolution bandwidth to the frequency span. Setting the value to ON or 1 will result 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 will result in the resolution bandwidth being un-coupled from the span. That is, changing the span will not change the resolution bandwidth. When this command is issued, the resolution bandwidth setting itself will not change
Parameters
<0 | 1 | ON | OFF>
Query Return
0 | 1
Default Value
ON
[:SENSe]:BANDwidth:VIDeo:AUTO <boolean>
[:SENSe]:BANDwidth:VIDeo:AUTO?
Title
VBW Auto
Description
Sets the state of the coupling of the video bandwidth to the resolution bandwidth. Setting the value to ON or 1 will result 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 will result in the video bandwidth being un-coupled from the resolution bandwidth. That is, changing the resolution bandwidth will not change the video bandwidth.
Parameters
<boolean>
Default Value
ON
[:SENSe]:BANDwidth[:RESolution]:AUTO <boolean>
[:SENSe]:BANDwidth[:RESolution]:AUTO?
Title
RBW Auto
Description
Sets the state of the coupling of the resolution bandwidth to the frequency span. Setting the value to ON or 1 will result 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 will result in the resolution bandwidth being un-coupled from the span. That is, changing the span will not change the resolution bandwidth. When this command is issued, the resolution bandwidth setting itself will not change.
Parameters
<boolean>
Default Value
ON
[:SENSe]:BANDwidth|BWIDth:VIDeo <freq>
[:SENSe]:BANDwidth|BWIDth:VIDeo?
Title
VBW
Description
Sets the video bandwidth. Note that using this command turns the automatic video bandwidth setting OFF.
Parameters
<freq>
Default Value
1e+06 Hz
Default Unit
Hz
Range
1 Hz to 3e+06 Hz
[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio <number>
[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio?
Title
VBW RBW 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 will show 2 not 2.857.
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 span to the resolution bandwidth.
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.
Syntax Example
POSitive|RMS|NEGative
Default Value
POSitive
[:SENSe]:FREQuency:CENTer <freq>
[:SENSe]:FREQuency:CENTer?
Title
Center Frequency
Description
Sets the center frequency. Note that changing the value of the center frequency will change the value of the coupled ParametersStart Frequency and Stop Frequency. It may also change the value of the span.
Set a frequency offset, which will be added to the start, stop, and center frequencies. This offset is for display purposes only and does not affect the frequency range being measured.
This command is only applicable when making CPRI measurements.
Parameters
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return
Numeric (Hz)
Default Value
0 Hz
Default Unit
Hz
Range
-10000000000 Hz to 10000000000 Hz
[:SENSe]:FREQuency:REFerence:SOURce?
Title
Frequency Reference Source
Description
Returns the current frequency reference source used by the instrument, as specified in the following table:
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 will change the value of the coupled ParametersStart Frequency and Stop Frequency and may change the Center Frequency.
Parameters
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Default Value
6e+09 Hz
Default Unit
Hz
Range
10 Hz to 6e+09 Hz
[:SENSe]:FREQuency:SPAN:FULL
Title
Set to Full Span
Description
Sets the frequency span to full span. Note that changing the value of the frequency span will change the value of the coupled parameters, Start Frequency and Stop Frequency and may change the Center Frequency.
[:SENSe]:FREQuency:SPAN:LAST
Title
Set to Last Span
Description
Sets the frequency span to the previous span value. Note that changing the value of the frequency span will change the value of the coupled parameters, Start Frequency and Stop Frequency and may change the Center Frequency.
Sets the start frequency. Note that in the spectrum analyzer, changing the value of the start frequency will change the value of the coupled parameters, Center Frequency and Span.
Sets the stop frequency. Note that in the spectrum analyzer, changing the value of the stop frequency will change the value of the coupled parameters, Center Frequency and Span.
This setting configures data decimation factors in the I/Q capture engine to provide an effective capture bandwidth of at least the amount specified.
Parameters
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Default Value
2.67e+06 Hz
Default Unit
Hz
Range
0 Hz to 1e+08 Hz
[:SENSe]:IQ:BITS <number>
[:SENSe]:IQ:BITS?
Title
IQ Bits per Sample
Description
The number of IQ bits per sample. Lower values enable higher throughput (continuous IQ capture) or longer maximum capture length (block IQ capture). The number of samples per frame increases as the bits per sample decreases:
Bits per sample
Samples per frame
24
1
16
2
10
3
8
4
Parameters
<number>
Default Value
24
[:SENSe]:IQ:LENGth <numeric_value> {US | MS | S | MIN | HR}
[:SENSe]:IQ:LENGth?
Title
Capture Length
Description
The set form of this command sets the iq length in milliseconds and query form returns the IQ length in milliseconds.
Parameters
<numeric_value> {US | MS | S | MIN | HR}
Default Value
10 ms
Default Unit
ms
Range
0.001 ms to 10000 ms
[:SENSe]:IQ:MODE SINGle|STREam <SINGle|STREam>
[:SENSe]:IQ:MODE?
Title
Capture Mode
Description
Specifies the type of capture mode:
• Single mode does a single block capture
• Streaming mode does real time streaming capture.
Parameters
SINGle|STREam
Default Value
SINGle
[:SENSe]:IQ:SAMPle:CALibration:CONFiguration?
Title
IQ Calibration Configuration
Description
In order to get the valid IQ correction factor, user should issue MEAS:IQ:CAPT command first.
• Center frequency
• Preamp state
• Input attenuation
• IQ base sample rate
• Decimation factor
• IQ capture bandwidth
• IQ correction factor in dB
An invalid value of -20000 is returned if any of Center frequency, Preamp state, Input attenuation, IQ capture bandwidth settings is modified after issuing MEAS:IQ:CAPT command.
To apply the IQ correction factor, please refer to the Remote Spectrum Monitoring System Help Introduction. Information is avaliable in I/Q Capture Block Mode section of the manual (full path: Remote Spectrum Monitor/Programming with SCPI/I/Q Capture Block Mode).
[:SENSe]:IQ:SAMPle:CONFiguration?
Title
IQ Configuration
Description
Returns a comma delimited list of I/Q measurement configuration information with 5 fields:
• Base Sample rate
• Number of bytes per frame,
• Effective bits per sample (see SENSE:IQ:BITS),
• Decimation factor
• Timestamp (see SENSE:IQ:TIMESTAMP)
The base sample rate is generally fixed in a specific hardware revision; its value is provided here to enable calculation of the data rate, or time between samples, which is equal to the base sample rate divided by the decimation factor. The data rate is used when extrapolating embedded timestamps to other samples. For example, assuming a data rate of 1 MHz, if the nth sample contains an embedded timestamp of
1444753342s + 37531655ns, the n+1th sample would have an effective timestamp of 1444753342s + 37531655ns + (1/1MHz) = 1444753342s + 37531655ns + 1ms = 1444753342s + 37532655ns.
The number of samples per frame is calculated by:
• floor(bitsPerFrame / bitsPerSample), where bitsPerFrame = 8 * bytesPerFrame
Decimation factor is read only, and its value is derived from the current capture bandwidth setting. There is a 1-to-1 correspondence between an IQ:BAND value and a decimation factor.
Number of bytes per sample is 8 for I/Q and 2 for raw ADC capture. The raw ADC capture must be parsed differently. See TRAC:IQ:DATA? for the data format.
This command provides the information necessary for clients to reconstruct I/Q data samples and timestamps from the raw data returned by TRAC:IQ:DATA?.
[:SENSe]:IQ:TIMEstamps <boolean>
[:SENSe]:IQ:TIMEstamps?
Title
IQ Timestamps
Description
Enables or disables IQ timestamps. When I/Q timestamps are enabled, timestamps will be embedded in the binary response data returned by TRACe:IQ:DATA?. The first 256 frames of each 1024 frame chunk use the least-significant bit of each I and Q sample in each frame for timestamping. For 8-bit and 16-bit captures, the timestamp is attached to every extended frame.
If SENS:IQ:BITS is 24 or 10, the timestamp does not reduce resolution. If SENS:IQ:BITS is 16 or 8, the timestamp reduces the resolution by one bit for 256/1024 frames.
In the 16 bit case, 256/2048 samples are 15 bits. In the 8 bit case, 256/4096 samples are 7 bits
If SENS:IQ:TIMESTAMPS is OFF, then the IQ data cannot be absolutely positioned in time, but all samples have full resolution.
This setting is ignored if SENSE:IQ:BITS is 24 or 10 bits because there are extra, otherwise unused bits. The timestamps are shift-encoded in groups of 64 in bit 0, and there is a shift-encoded mark in bit 32.
Parameters
<boolean>
Default Value
ON
[:SENSe]:OBWidth:METHod XDB|PERCent
[:SENSe]:OBWidth:METHod?
Title
Occupied Bandwidth 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.
The measurement always gives a result, even if there is no signal. For example, the 100 dBc Occupied Bandwidth is the current full span.
Parameters
XDB|PERCent
Default Value
PERCent
[:SENSe]:OBWidth:PERCent <number>
[:SENSe]:OBWidth:PERCent?
Title
Occupied Bandwidth Percent
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.
Parameters
<number>
Default Value
99
[:SENSe]:OBWidth:STATe <0 | 1 | ON | OFF>
[:SENSe]:OBWidth:STATe?
Title
Occupied Bandwidth State
Description
Sets the state of the occupied bandwidth measurement, ON or OFF. When using :CONFigure:OBWidth, the state is automatically set to ON.
Parameters
<0 | 1 | ON | OFF>
Default Value
OFF
[:SENSe]:OBWidth:XDB <relative amplitude>
[:SENSe]:OBWidth:XDB?
Title
Occupied Bandwidth XDB
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.
Sets the input attenuation. Note that issuing this command will set the automatic input attenuation OFF.
Parameters
<numeric_value> {DB}
Default Value
30 dB
Default Unit
dB
Range
0 dB to 50 dB
[:SENSe]:POWer:RF:ATTenuation:AUTO <0 | 1 | ON | OFF>
[:SENSe]:POWer:RF:ATTenuation:AUTO?
Title
RF Attenuation Auto
Description
Sets the input attenuation coupling. Setting the value to ON or 1 will result in the input attenuation being coupled to the reference level.
Setting the value to OFF or 0 will result in the input attenuation being uncoupled from the reference level. That is, changing the reference level will not change the input attenuation. When this command is issued, the input attenuator setting itself will not change.
The default value is ON. That is, sending: :SENS:POW:ATT:AUTO is equivalent to sending: :SENS:POW:ATT:AUTO ON.
Parameters
<0 | 1 | ON | OFF>
Default Value
ON
[:SENSe]:POWer:RF:GAIN:STATe <0 | 1 | ON | OFF>
[:SENSe]:POWer:RF:GAIN:STATe?
Title
Preamp
Description
Sets the state of the preamp. Note that this may cause a change in the reference level and/or attenuation.
Parameters
<0 | 1 | ON | OFF>
Default Value
OFF
[:SENSe]:REFerence:EXTernal <0 | 1 | ON | OFF>
[:SENSe]:REFerence:EXTernal?
Title
External Reference State
Description
Enable or disable the use of an external 10 MHz reference as a reference source.