Last Updated: August 29, 2007
These commands provide data processing functions for Spectrum Monitor (SMON) measurements. These functions are available after the measurement result data is collected.
For more information on the conventions used in the programming examples click here.
Sets/queries the marker mode for all five markers in Spectrum Monitor measurements.
The following marker modes are available:
In Normal marker mode (POSition), markers are independently positioned and marker measurement displays are independent. Marker frequency settings and measurements conform to the current frequency mode setting (see CALCulate:SMONitor:FREQuency:MODe[?]).
In Reference 1 Delta marker mode (R1Delta), marker settings and measurements are relative to the current Marker 1 Reference (if any). The Marker 1 Reference is set when this state is entered by sampling the current value of Marker 1. If Marker 1 has no valid value, then the Marker 1 reference is set to NAN).
In Marker 1 Delta marker mode (M1Delta), Marker 1 behaves in the same way as in Normal mode (POSition). However, Markers 2 through 5 are entered and displayed relative to the dynamic value of Marker 1.
Setting Range: POSition | R1Delta | M1Delta
Query Range: POS | R1D | M1D
*RST Setting: POSition
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the marker mode to R1Delta.
TestSet.WriteString("CALCulate:SMONitor:AMARkers:MODe R1Delta")
Performs a peak search and sets the marker frequencies to the five highest peak values, in order of peak magnitude with Marker 1 being set to the highest value. This command does not turn the markers on (see CALCulate:SMONitor:AMARkers:STATe[?]).
If not enough peaks are found in the trace for all five markers, the remaining markers are set to NAN.
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Perform a peak search and set the marker frequencies to the five highest peak values.
TestSet.WriteString("CALCulate:SMONitor:AMARkers:PEAK")
Sets the Spectrum Monitor's manual user interface to perform peak tracking for all markers. This command is not applicable when Display Tracking is turned off (see DISPlay:MODE:TRACking[?]).
Setting Range: 0 | OFF | 1 | ON
Query Range: 0 | 1
*RST Setting: 0 | OFF
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Perform peak tracking for all markers.
TestSet.WriteString("CALCulate:SMONitor:AMARkers:PTRack")
Sets/queries whether all markers are turned on or turned off.
Setting Range: 0 | OFF | 1 | ON
Query Range: 0 | 1
*RST Setting: 0 | OFF
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the marker state to On for all markers.
TestSet.WriteString("CALCulate:SMONitor:AMARkers:STATe ON")
Sets/queries the frequency mode for Spectrum Monitor measurements.
The following frequency modes are available:
In Absolute frequency mode (ABSolute), frequency results and settings for all post-processed parameters are provided in absolute frequencies units.
In Relative frequency mode (RELative), frequency results and settings are provided as offsets from the expected RF frequency. For example, 0 Hz represents the frequency content at the expected frequency.
Setting Range: ABSolute | RELative
Query Range: ABS | REL
*RST Setting: RELative
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the frequency mode to Absolute.
TestSet.WriteString("SETup:SMONitor:FREQuency:MODe ABS")
Sets/queries the Marker 1 reference frequency position for Spectrum Monitor measurements. The units (GHz|MHz|KHz|Hz) are optional, if no units are specified then units default to Hz.
Setting Range: (Tuned frequency minimum - (Frequency span / 2)) to (Tuned frequency maximum + (Frequency span / 2)), and 9.91 E+37 (NAN)
Query Range: (Tuned frequency minimum - (Frequency span / 2)) to (Tuned frequency maximum + (Frequency span / 2)), and 9.91 E+37 (NAN)
*RST Setting: 0 Hz
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the marker reference frequency to 1 MHz.
TestSet.WriteString("CALCulate:SMONitor:MARKer:REFerence:FREQuency 1MHZ")
Sets/queries the Marker 1 reference level in dBm for Spectrum Monitor measurements.
Setting Range: Unlimited range
Query Range: Unlimited range
*RST Setting: 0 dBm
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the marker reference level to 10 dBm.
TestSet.WriteString("CALCulate:SMONitor:MARKer:REFerence:LEVel 10DBM")
Sets/queries the specified marker frequency for Spectrum Monitor measurements.
This setting is only implemented when the specified marker state is set to On (see CALCulate:SMONitor:MARKer([1]|2|3|4|5):STATe[?] and CALCulate:SMONitor:AMARkers:STATe[?]).
If you are using one of the delta marker modes, this command sets/queries the offset frequency of the delta marker (see CALCulate:SMONitor:AMARkers:MODe[?])
The marker frequency can also be set using the CALCulate:SMONitor:MARKer([1]|2|3|4|5)[:SFRequency][?] command.
Setting Range: Depends on the marker mode (see CALCulate:SMONitor:AMARkers:MODe[?]):
Normal (POSition) mode: Depends on the settings of the center frequency and the frequency span. The markers frequency range is therefore equal to: (Tuned frequency minimum - (Frequency span / 2)) to (Tuned frequency maximum + (Frequency span / 2))
Reference 1 Delta (R1Delta) and Marker 1 Delta (M1Delta) modes: The range is dependent on the center frequency, the frequency span and the position of the reference marker.
Query Range: Depends on the marker mode (see CALCulate:SMONitor:AMARkers:MODe[?]):
Normal (POSition) mode: Depends on the settings of the center frequency and the frequency span. The markers frequency range is therefore equal to: (Tuned frequency minimum - (Frequency span / 2)) to (Tuned frequency maximum + (Frequency span / 2)), and 9.91 E+37 (NAN)
Reference 1 Delta (R1Delta) and Marker 1 Delta (M1Delta) modes: The range is dependent on the center frequency, the frequency span and the position of the reference marker.
*RST Setting: 0 Hz
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Query the frequency of marker 2.
TestSet.WriteString("CALCulate:SMONitor:MARKer2:FREQuency?")
Moves the specified marker to the highest peak.
Before this command can be used correctly, you must set the Spectrum Monitor measurement to single trigger mode (see SETup:SMONitor:CONTinuous[?]), initiate the measurement (see INITiate) then fetch the results (see FETCh:SMONitor?).
If no peaks are found, the specified marker is set to NAN.
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Move Marker 5 to the highest peak.
TestSet.WriteString("CALCulate:SMONitor:MARKer5:PEAK")
The setting form of this command performs two functions: (1) sets the specified marker frequency for Spectrum Monitor measurements (see CALCulate:SMONitor:MARKer([1]|2|3|4|5):FREQuency[?]) and (2) sets the marker state to on (see CALCulate:SMONitor:MARKer([1]|2|3|4|5):STATe[?]).
The query form of this command returns the current frequency value for the specified marker.
If you are using one of the delta marker modes, this command sets/queries the offset frequency of the delta marker (see CALCulate:SMONitor:AMARkers:MODe[?]).
Setting Range: Depends on the marker mode (see CALCulate:SMONitor:AMARkers:MODe[?]):
Normal (POSition) mode: Depends on the settings of the center frequency and the frequency span. The markers frequency range is therefore equal to: (Tuned frequency minimum - (Frequency span / 2)) to (Tuned frequency maximum + (Frequency span / 2))
Reference 1 Delta (R1Delta) and Marker 1 Delta (M1Delta) modes: The range is dependent on the center frequency, the frequency span and the position of the reference marker.
Query Range: Depends on the marker mode (see CALCulate:SMONitor:AMARkers:MODe[?]):
Normal (POSition) mode: Depends on the settings of the center frequency and the frequency span. The markers frequency range is therefore equal to: (Tuned frequency minimum - (Frequency span / 2)) to (Tuned frequency maximum + (Frequency span / 2)), and 9.91 E+37 (NAN)
Reference 1 Delta (R1Delta) and Marker 1 Delta (M1Delta) modes: The range is dependent on the center frequency, the frequency span and the position of the reference marker.
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Turn on Marker 4 and set the frequency to 20 MHz.
TestSet.WriteString("CALCulate:SMONitor:MARKer4 20MHZ")
Sets/queries the frequency state for the specified marker in Spectrum Monitor measurements.
The marker state can also be set to on using the CALCulate:SMONitor:MARKer([1]|2|3|4|5)[:SFRequency][?] command.
Setting Range: 0 | OFF | 1 | ON
Query Range: 0 | 1
*RST Setting: 0 | OFF
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Query the marker state for Marker 1.
TestSet.WriteString("CALCulate:SMONitor:MARKer1:STATe?")
Sets/queries the amplitude scale state for Spectrum Monitor measurements. On (1) switches the amplitude scale state to Auto for the amplitude scale reference level (CALCulate:SMONitor:SCALe:AMPLitude:MRLevel[?]) and the amplitude scale dB per division (CALCulate:SMONitor:SCALe:AMPLitude:MPDivision[?]) parameters. Off (0) switches the amplitude scale state to Manual allowing you to set the required amplitude scale reference level and amplitude scale dB per division.
Note that Auto scaling does not occur when the test set's display tracking mode is set to OFF (see DISPlay:MODE:TRACking[?]) and the test set is in the remote state.
Setting Range: 0 | OFF | 1 | ON
Query Range: 0 | 1
*RST Setting: 1 | ON
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the amplitude scale state to Manual.
TestSet.WriteString("CALCulate:SMONitor:SCALe:AMPLitude:AUTO OFF?")
The setting form of this command performs two functions: (1) sets the amplitude scale dB per division for Spectrum Monitor measurements (see CALCulate:SMONitor:SCALe:AMPLitude:PDIVision[?]) and (2) switches the amplitude scale state to Manual (see CALCulate:SMONitor:SCALe:AMPLitude:AUTO[?]).
The query form of this command returns the current amplitude scale dB per division setting.
Setting Range: 0.1 dB to 20 dB
Query Range: 0.1 dB to 20 dB
*RST Setting: Not applicable as the amplitude scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the dB per division value to 20 dBm and switch the amplitude scale state to Manual.
TestSet.WriteString("CALCulate:SMONitor:SCALe:AMPLitude:MPDivision 20DBM")
The setting form of this command performs two functions: (1) sets the amplitude scale reference level for Spectrum Monitor measurements (see CALCulate:SMONitor:SCALe:AMPLitude:RLEVel[?]) and (2) switches the amplitude scale state to Manual (see CALCulate:SMONitor:SCALe:AMPLitude:AUTO[?]).
The query form of this command returns the current amplitude scale reference level setting.
Setting Range: -250 dBm to 250 dBm
Query Range: -250 dBm to 250 dBm
*RST Setting: Not applicable as the amplitude scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the amplitude scale reference level to 10 dBm and switch the amplitude scale state to Manual.
TestSet.WriteString("CALCulate:SMONitor:SCALe:AMPLitude:MRLevel 10DBM")
Sets/queries the amplitude scale dB per division for Spectrum Monitor measurements.
The Amplitude Scale dB per Division can also be set using the CALCulate:SMONitor:SCALe:AMPLitude:MPDivision[?] command.
Setting Range: 0.1 dB to 20 dB
Query Range: 0.1 dB to 20 dB
*RST Setting: Not applicable as the amplitude scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the dB per division value to 20 dBm.
TestSet.WriteString("CALCulate:SMONitor:SCALe:AMPLitude:PDIVision 20DBM")
Sets/queries the amplitude scale reference level for Spectrum Monitor measurements.
The amplitude scale reference level can also be set using the CALCulate:SMONitor:SCALe:AMPLitude:MRLevel[?] command.
Setting Range: -250 dBm to 250 dBm
Query Range: -250 dBm to 250 dBm
*RST Setting: Not applicable as the amplitude scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the amplitude scale reference level to 10 dBm.
TestSet.WriteString("CALCulate:SMONitor:SCALe:AMPLitude:RLEVel 10DBM")
Sets/queries the frequency scale state for Spectrum Monitor measurements. ON (1) switches the frequency scale state to Auto for the frequency scale center (CALCulate:SMONitor:SCALe:FREQuency:MCENter[?]) and frequency scale span (CALCulate:SMONitor:SCALe:FREQuency:MSPan[?]) parameters. OFF (0) switches the frequency state to Manual allowing you to set the required frequency scale center and frequency scale span.
Note that Auto scaling does not occur when the test set's display tracking mode is set to OFF (see DISPlay:MODE:TRACking[?]) and the test set is in the remote state.
Setting Range: 0 | OFF | 1 | ON
Query Range: 0 | 1
*RST Setting: 1 | ON
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the frequency scale state to Manual.
TestSet.WriteString("CALCulate:SMONitor:SCALe:FREQuency:AUTO OFF?")
Sets/queries the frequency scale center for Spectrum Monitor measurements.
The frequency scale center can also be set using the CALCulate:SMONitor:SCALe:FREQuency:MCENter[?] command.
Setting Range: Tuned frequency minimum to Tuned frequency maximum
Query Range: Tuned frequency minimum to Tuned frequency maximum
*RST Setting: Not applicable as the frequency scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the frequency scale center to 85 MHz.
TestSet.WriteString("CALCulate:SMONitor:SCALe:FREQuency:CENTer 85MHZ")
The setting form of this command performs two functions: (1) sets the frequency scale center for Spectrum Monitor measurements (see CALCulate:SMONitor:SCALe:FREQuency:CENTer[?]) and (2) switches the frequency scale state to Manual (see CALCulate:SMONitor:SCALe:FREQuency:AUTO[?]).
The query form of this command returns the current frequency scale center setting.
Setting Range: Tuned frequency minimum to Tuned frequency maximum
Query Range: Tuned frequency minimum to Tuned frequency maximum
*RST Setting: Not applicable as the frequency scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the frequency scale center to 78 MHz and switch the frequency scale state to Manual.
TestSet.WriteString("CALCulate:SMONitor:SCALe:FREQuency:MCENter 78MHZ")
The setting form of this command performs two functions: (1) sets the frequency scale span for Spectrum Monitor measurements (see CALCulate:SMONitor:SCALe:FREQuency:SPAN[?]) and (2) switches the frequency scale state to Manual (see CALCulate:SMONitor:SCALe:FREQuency:AUTO[?]).
The query form of this command returns the current frequency scale span setting.
Setting Range: Span minimum to Span maximum
Query Range: Span minimum to Span maximum
*RST Setting: Not applicable as the frequency scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the frequency scale span to 0.8 MHz and switch the frequency scale state to Manual.
TestSet.WriteString("CALCulate:SMONitor:SCALe:FREQuency:MSPan 0.8MHZ")
Sets/queries the frequency scale span for Spectrum Monitor measurements.
The frequency scale span can also be set using the CALCulate:SMONitor:SCALe:FREQuency:MSPan[?] command.
Setting Range: Span minimum to Span maximum
Query Range: Span minimum to Span maximum
*RST Setting: Not applicable as the frequency scale state *RST setting is Auto (ON)
Test Set Requirements: E6601A WCTS Program Version A.04 and above
Example:
' Set the frequency scale span to 0.9 MHz.
TestSet.WriteString("CALCulate:SMONitor:SCALe:FREQuency:SPAN 0.9MHZ")