FETCh:SMONitor?

Last Updated: August 29, 2007

These commands return results for the Spectrum Monitor (SMON) measurement.

For more information on the conventions used in the programming examples click here.

FETCh:SMONitor[:ALL]?

Queries the integrity indicator, start frequency offset, step frequency, number of bins, and the power results (in dBm) for each bin of the trace data for the last Spectrum Monitor measurement performed.

The Spectrum Monitor divides the frequency span by the number of display points such that each bin contains a segment of the frequency span.

For descriptions of non-zero integrity indicators, refer to Measurement Integrity Indicator.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator, start frequency offset,
' step frequency, number of bins, and the power results (in dBm) for each bin.

TestSet.WriteString("FETCh:SMONitor:ALL?")

FETCh:SMONitor:AMARkers[:LIST]?<sp><marker number><sp><marker number>...

Queries the integrity indicator, and a pair of frequency and power level results for each marker you specify.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator and a frequency/power result pair for markers 2 and 4.

TestSet.WriteString("FETCh:SMONitor:AMARkers? 2 4")

FETCh:SMONitor:ICOunt?

Queries the intermediate count of spectrum monitor multi-measurements completed.

Query Range: 0 to 999

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Queries the intermediate total number of measurements completed for the Spectrum Monitor measurement.

TestSet.WriteString("FETCh:SMONitor:ICOunt?")

FETCh:SMONitor:INTegrity?

Queries the integrity indicator for Spectrum Monitor measurements. Zero indicates normal.

For non-zero integrity indicators, refer to Measurement Integrity Indicator.

Query Range: See Measurement Integrity Indicator.

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator for Spectrum Monitor measurements.

TestSet.WriteString("FETCh:SMONitor:INTegrity?")

FETCh:SMONitor:MARKer:LIST?<sp><marker number><sp><marker number>...

Queries the integrity indicator, and a pair of frequency and power level results for each marker you specify.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator and frequency/power result pair for markers 2 and 4.

TestSet.WriteString("FETCh:SMONitor:MARKer:LIST? 2 4")

FETCh:SMONitor:MARKer([1]|2|3|4|5)?

Queries the integrity indicator, and a pair of frequency and power level results for the specified marker.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator, and a pair of frequency and power level results for marker 3.

TestSet.WriteString("FETCh:SMONitor:MARKer3?")

FETCh:SMONitor:TRACe[:POWer]?

Queries the integrity indicator, and the individual power levels in dBm for all bins in the Spectrum Monitor measurement.

The number of bins and the bin spacing is dependant on the frequency span setting (see SETup:SMONitor:FREQuency:SPAN[?]). The Spectrum Monitor divides the frequency span by the number of display points such that each bin contains a segment of the frequency span.

The Number of Bins parameter returned by the FETCh:SMONitor:TRACe:PARameters? command allows you to determine how many results are returned by this command.  

This command returns only the power level results. You can use these power level results, in conjunction with the start frequency offset and step frequency values returned by the FETCh:SMONitor:TRACe:PARameters? command to reconstruct the Spectrum Monitor trace information.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator, and the individual power levels in dBm for all bins.

TestSet.WriteString("FETCh:SMONitor:TRACe?")

FETCh:SMONitor:TRACe:FREQuency?<sp><frequency value in Hz>,<frequency value in Hz>...  

Queries the integrity indicator, and a pair of frequency and power level results for each frequency you specify in the comma-separated list. The frequency values you enter in the comma-separated list must be in Hz and no units can be provided. If you specify a frequency which does not exist in the trace, NAN is returned.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator and a frequency/power result
' pair for the trace frequencies 900 Hz and 1800 Hz.

TestSet.WriteString("FETCH:SMONitor:TRACe:FREQuency? 900, 1800")

FETCh:SMONitor:TRACe:PARameters?

Queries the Spectrum Monitor measurement parameters: Integrity indicator, start frequency offset in Hz (the frequency for the first bin in the spectrum monitor trace), step frequency in Hz (trace bin spacing equal to half the resolution bandwidth), and the number of bins.     

The Spectrum Monitor divides the frequency span by the number of display points such that each bin contains a segment of the frequency span.

The number of bins value returned by this command defines how many bins are returned by FETCh:SMONitor:TRACe?.     

You can use the start frequency offset and step frequency values returned by this command in conjunction with the amplitude bin results returned by FETCh:SMONitor:TRACe? to reconstruct the Spectrum Monitor trace information.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the Spectrum Monitor measurement parameters.

TestSet.WriteString("FETCh:SMONitor:TRACe:PARameters?")

FETCh:SMONitor:TRACe:PEAKs?<sp><number of peaks>

Queries the integrity indicator, and a pair of frequency and power level results for the number of peaks you specify. A peak search is performed for the number of peaks you have requested. If insufficient peaks are found, NAN is returned for the remaining results.

Query Range:

Test Set Requirements: E6601A WCTS Program Version A.01 and above

Example:

' Query the integrity indicator and frequency/power result
' pair for the highest 6 peaks on the trace.

TestSet.WriteString("FETCh:SMONitor:TRACe:PEAKs? 6")