Keysight x-series - Calculate Peaks of Trace Data (Remote Command Only)

9 Strip Chart 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 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 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).
Notes <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
652 EMI Receiver Mode Reference