Agilent Technologies X Series Manual page 493

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
For Swept SA measurement:
:CALCulate:DATA[1]|2|3|4|5|6:PEAKs?
<threshold>,<excursion>[,AMPLitude|FREQuency|TIME[,ALL|
GTDLine|LTDLine]]
For most other measurements:
:CALCulate:DATA[1]|2|3|4|5|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).
Meas
493