Calculate Peaks Of Trace Data (Remote Command Only) - Keysight x-series User Reference Manual

8 Frequency Scan Measurement
Meas

Calculate Peaks of Trace Data (Remote Command Only)

Returns a list of all the peaks for the currently selected measurement and sub-opcode [n]. The peaks must
meet the requirements of the peak threshold and excursion values.
n = any valid sub-opcode for the current measurement. See the MEASure:<measurement> command
description of your specific measurement for information on the data that can be returned.
The command can only be used with specific sub-opcodes with measurement results that are trace data.
Both real and complex traces can be searched, but complex traces are converted to magnitude in dBm. In
many measurements the sub-opcode n=0, is the raw trace data which cannot be searched for peaks. And
Sub-opcode n=1, is often calculated results values which also cannot be searched for peaks.
This command uses the data setting specified by the FORMat:BORDer and FORMat:DATA commands and
can return real or ASCII data. If the format is set to INT,32, it returns REAL,32 data.
The command has four types of parameters:
• Threshold (in dBm)
• Excursion (in dB)
• Sorting order (amplitude, frequency, time)
• Optional in some measurements: Display line use (all, > display line, < display line)
Remote Command
Example
Notes
436
For Swept SA measurement:
:CALCulate:DATA[1]|2|...|6:PEAKs? <threshold>,<excursion>[,AMPLitude |
FREQuency | TIME[,ALL | GTDLine | LTDLine]]
For most other measurements:
:CALCulate:DATA[1]|2|...|6:PEAKs? <threshold>,<excursion>[,AMPLitude |
FREQuency | TIME]
Example for Swept SA measurement in Spectrum Analyzer Mode:
CALC:DATA4:PEAK? –40, 10, FREQ, GTDL This will identify the peaks of trace 4 that are above –
40 dBm, with excursions of at least 10 dB. The peaks are returned in order of increasing frequency,
starting with the lowest frequency. Only the peaks that are above the display line are returned.
Query Results 1:
With FORMat:DATA REAL, 32 selected, it returns a list of floating-point numbers. The first value in
the list is the number of peak points that are in the following list. A peak point consists of two values:
a peak amplitude followed by its corresponding frequency (or time).
If no peaks are found the peak list will consist of only the number of peaks, (0).
<n> - is the trace that will be used
<threshold> - is the level below which trace data peaks are ignored. Note that the threshold value is
required and is always used as a peak criterion. To effectively disable the threshold criterion for this
command, provide a substantially low threshold value such as –200 dBm. Also note that the
threshold value used in this command is independent of and has no effect on the threshold value
stored under the Peak Criteria menu.
<excursion> - is the minimum amplitude variation (rise and fall) required for a signal to be identified
as peak. Note that the excursion value is required and is always used as a peak criterion. To
effectively disable the excursion criterion for this command, provide the minimum value of 0.0 dB.
Also note that the excursion value used in this command is independent of and has no effect on the
EMI Receiver Mode Reference