This subsystem contains commands related to the transfer of trace data to and from the instrument.
:TRACe:COPY TRACE1,TRACE2|TRACE3
Title
Trace Copy
Description
Copies Trace A to either Trace B or Trace C. Copying Trace A to Trace B is equivalent to pressing the Shift-5 (Trace), Trace B Operations, A->B on the front panel. This store Trace A into Trace B and turns on Trace B if it was off. Copying Trace A to Trace C is equivalent to pressing the Shift-5 (Trace), Trace C Operations, A->C on the front panel. This store Trace A into Trace C and turns on Trace C if it was off.
Parameter
TRACE1,TRACE2|TRACE3
Parameter Type
<char>
Example
To copy Trace A to Trace B:
:TRACe:COPY TRACE1,TRACE2
To copy Trace A to Trace C:
:TRACe:COPY TRACE1,Trace3
:TRACe:EXCHange TRACE2,TRACE3
Title
Trace Exchange
Description
Swaps Trace B and Trace C.
Parameter
TRACE2,TRACE3
Parameter Type
<char>
Front Panel Access
Shift-5 (Trace), Trace B Operations, B<->C Shift-5 (Trace), Trace C Operations, B<->C
:TRACe:PREamble? {1|2|3}
Title
Trace Header Transfer
Description
Returns trace header information for the specified trace. Data can be transferred to and from the 3 available display traces. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory. The response begins with an ASCII header. The header specifies the number of following bytes. It looks like #AX, where A is the number of digits in X and X is the number of bytes that follow the header. Parameters are returned in comma-delimited ASCII format. Each parameter is returned as “NAME=VALUE[ UNITS],” Note that the parameters returns depend on the firmware version and that this document does not cover all parameter values returned by the command. Refer to Table: Available Parameters in Spectrum Analyzer Mode (Sheet 1 of 5) for valid parameter names.
Available Parameters in Spectrum Analyzer Mode (Sheet 1 of 5)
Parameter Name
Description
SN
Instrument serial #
UNIT_NAME
Instrument name
DESCR
Trace name
DATE
Trace date/time
BASE_VER
Base FW version
APP_NAME
Application name
APP_VER
Application FW version
UNITS
Amplitude units
CENTER_FREQ
Center frequency
SPAN
Frequency span
FREQ_STEP
Frequency step size
FREQUENCY_OFFSET
Frequency Offset
OFFSET_STEP_SIZE
Offset Step Size
OFFSET_CENTER_FREQ
Center Frequency with Frequency Offset
OFFSET_START_FREQ
Start Frequency with Frequency Offset
OFFSET_STOP_FREQ
Stop Frequency with Frequency Offset
RBW
Resolution bandwidth
RBW_TYPE
RBW coupling auto/manual
VBW
Video bandwidth
VBW_TYPE
VBW coupling auto/manual
RBW_VBW_RATIO
RBW/VBW ratio
SPAN_RBW_RATIO
Span/RBW ratio
INPUT_ATTEN
Input attenuation
ATTEN_TYPE
Attenuation coupling auto/manual
REFERENCE_LEVEL
Reference level
SCALE
Y-axis scale
PREAMP_SET
Preamp state
REF_LEVEL_OFFSET
Reference level offset
DETECTION
Detection type
TRACE_AVERAGE
Number of traces to average
SWEEP_TYPE
Single/continuous
CURRENT_SIGNAL
Current signal index
CURRENT_CHANNEL
Current signal channel
TRACE_MODE
Normal/Avg/Max
TRACE_STATUS
TRACE_A_VIEW_NOT_BLANK: 0x0000000000000001
TRACE_A_WRITE_NOT_HOLD: 0x0000000000000002
TRACE_A_DATA_VALID: 0x0000000000000004
TRACE_B_VIEW_NOT_BLANK: 0x0000000000010000
TRACE_B_WRITE_NOT_HOLD: 0x0000000000020000
TRACE_B_DATA_VALID: 0x0000000000040000
TRACE_C_VIEW_NOT_BLANK: 0x0000000100000000
TRACE_C_WRITE_NOT_HOLD: 0x0000000200000000
TRACE_C_DATA_VALID: 0x0000000400000000
TRACE_C_IS_B_MINUS_A_ON: 0x0000001000000000
TRACE_C_IS_A_MINUS_B_ON: 0x0000002000000000
TRACE_COUNT
Number of traces averaged
UI_DATA_POINTS
Number of display points
IMPEDANCE
Input impedance
REFERENCE_FREQUENCY
Reference freq
SET_SWEEP_TIME
Minimum sweep time setting
TRIGGER_TYPE
Trigger type
VIDEO_TRIGGER_LEVEL
Video trigger level
TRIGGER_POSITION
Trigger position as a percent of the display
PEAK_THRESHOLD
Marker peak search threshold
MARKER_TABLE
Marker table status
ACTIVE_ MEASUREMENT
Current measurement
ANTENNA
Antenna index
OCC_BW_METHOD
Occupied bandwidth method
OCC_BW_PERCENT
Occupied bandwidth % of power setting
OCC_BW_DBC
Occupied bandwidth dBc setting
OCC_BW_MEASURED_ DB
Occupied bandwidth measured dBc value
OCC_BW_MEASURED_ PERCENT
Occupied bandwidth measured % value
OCC_BW_VALUE
Measured occupied bandwidth
OCC_BW_LINE_ MARKER_INFO
Mask off 16 bits at a time to get the display point location of the 3 OBW display indicators
CH_PWR_WIDTH
Channel power integration bandwidth
CH_PWR_VALUE
Measured channel power
CH_PWR_DENSITY
Measured channel power density
CH_PWR_LINE_ MARKER_INFO
Mask off 16 bits at a time to get the display point location of the 2 channel power display indicators
ACPR_MAIN_CH_BW
ACPR main channel bandwidth
ACPR_ADJC_CH_BW
ACPR adjacent channel bandwidth
ACPR_CHANNEL_ SPACING
ACPR channel spacing
ACPR_MAIN_CH_PWR
ACPR measured main channel power
ACPR_UPPER_CH_PWR
ACPR measured upper channel power
ACPR_LOWER_CH_ PWR
ACPR measured lower channel power
ACPR_LOWER_CH_ LINE_MARKER_INFO
Mask off 16 bits at a time to get the display point location of the 2 ACPR lower channel display indicators
ACPR_MAIN_CH_LINE_ MARKER_INFO
Mask off 16 bits at a time to get the display point location of the 2 ACPR main channel display indicators
ACPR_UPPER_CH_ LINE_MARKER_INFO
Mask off 16 bits at a time to get the display point location of the 2 ACPR upper channel display indicators
AM_FM_DEMOD_VOL
AM/FM demod volume
AM_FM_DEMOD_ FREQUENCY
AM/FM demod freq
AM_FM_DEMOD_TYPE
AM/FM demod type
AM_FM_DEMOD_TIME
AM/FM demod time
AM_FM_LINE_ MARKER
Display point location of the demodulation frequency
BEAT_FREQUENCY_ OSC_FREQUENCY
BFO oscillator freq
CI_C_TYPE
C/I measurement carrier type
CI_C_VALUE
C/I measurement measured carrier power
CI_I_BB_VALUE
C/I measurement measured broadband interference power
CI_I_NB_VALUE
C/I measurement measured narrowband interference power
CI_I_WB_VALUE
C/I measurement measured wideband interference power
CI_BB_VALUE
C/I measurement with broadband interference
CI_NB_VALUE
C/I measurement with narrowband interference
CI_WB_VALUE
C/I measurement with wideband interference
MKR_SPA_FREQNx
Marker x frequency (where x is the marker number 0-11, 0 represent the reference marker #1 and 1 represent delta marker #1, 2 represent reference marker #2, and 3 represent delta marker #2, and so on)
MKR_SPA_POINTx
Reference marker x display point
MKR_SPA_MAGNTx
Reference marker x magnitude
MKR_SPA_PRCNTx
Reference marker x display percentage
MKR_SPA_FLAGSx
Reference marker x flags:
SPA_MKR_FLAG_ON_OFF: 0x00000001
SPA_MKR_FLAG_DELTA_MKR: 0x00000002
SPA_MKR_FLAG_SELECTED: 0x00000004
SPA_MKR_FLAG_DATA_INVALID: 0x00000008
SPA_MKR_FLAG_DATA_STALE: 0x00000010
SPA_MKR_FLAG_FIXED: 0x00000020
SPA_MKR_FLAG_MASK: 0x000000FF
SPA_MKR_FLAG_DISPL_AMPL_HZ: 0x00000100
SPA_MKR_FLAG_DISPL_AMPL_PER_HZ: 0x00000200
SPA_MKR_FLAG_DISP_FLAG: 0x00000F00
SPA_MKR_FLAG_RELATIVE: 0x00001000
SPA_MKR_STANDARD: 0x10000000
SPA_MKR_FIELD_STRENGHT: 0x20000000
SPA_MKR_NOISE: 0x30000000
SPA_MKR_COUNTER: 0x40000000
SPA_MKR_TIME: 0x50000000
MKR_SPA_REF_TOx
Specifies which marker is the marker x reference to
MKR_SPA_TRACex
Specifies which trace the marker x is for.
LIM_LFLAGS_UP
Upper limit flags:
LIMIT_FLAG_ON: 0x00000004
LIMIT_FLAG_ALARM_ON: 0x00000002
LIM_FREQNC_UPx
Upper limit point x freq (where x is the limit point number starting with 0)
LIM_MAGNTD_UPx
Upper limit point x amplitude
LIM_LFLAGS_LO
Lower limit flags:
LIMIT_FLAG_ON: 0x00000004
LIMIT_FLAG_ALARM_ON: 0x00000002
LIM_FREQNC_LOx
Lower limit point x freq (where x is the limit point number starting with 0)
This command transfers data from the controlling program to the instrument. The query form transfers trace data from the instrument to the controller. Data are transferred to the instrument enclosed in parentheses as (<header><block>) and from the instrument as <header><block>.
The ASCII header specifies the number of data bytes. It looks like #AX, where A is the number of digits in X and X is the number of bytes in the <block>.
The format of the block data in the query form is specified by :FORMat:DATA. The block data in the command form is always sent in ASCII format. Data can be transferred to and from the 3 available display traces. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory. The command form does not support setting all trace points to a single value. To do this, send the same value to each point. Trace setup information can be acquired using :TRACe[:DATA]:PREamble?
To acquire the data from Trace A in the instrument, send :TRACe[:DATA]? 1. A 551 point trace is returned as #42204<block data>. <block> data could be in either INTeger,32 or REAL,32 format. In both cases, there is 4 bytes per data-point. So, 4 bytes per point * 551 data-points gives 2204 bytes in <block> data. This example assumes that :FORMat:DATA INTeger,32 or :FORMat:DATA REAL,32 has been sent to the instrument before the query command is sent.
The query command will return a #0 if data are invalid for the active trace.
Specifies whether the specified trace should be displayable (visible) or hidden. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the value to ON or 1 will set the specified trace visible. Setting the value to OFF or 0 will set the specified trace hidden. Note that issuing this command will also set the specified trace as active trace.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
ON for Trace A OFF for Trace B OFF for Trace C
Example
To set Trace A to Blank:
:TRACe:DISPlay OFF :TRACe1:DISPlay 0
To set Trace B to View:
:TRACe2:DISPlay ON :TRACe2:DISPlay:STATe ON :TRACe2:DISPlay 1
Specifies whether the specified recall trace should be displayable (visible) or hidden. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the value to ON or 1 will set the specified trace visible. Setting the value to OFF or 0 will set the specified trace hidden. Note that this command is valid only if there is a trace recalled.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
OFF
Example
To set Trace A to Blank:
:TRACe:LOAD:DISPlay OFF :TRACe1:LOAD:DISPlay 0
To set Trace B to View:
:TRACe2:LOAD:DISPlay ON :TRACe2:LOAD:DISPlay:STATe ON :TRACe2:LOAd:DISPlay 1
Front Panel Access
Shift-5 (Trace), Trace [A/B/C], View Blank
Note
These SCPI commands are applicable only if the user selects the option to recall the trace to Trace A and not show the live trace.
Specifies whether the specified trace state should be set to write or hold. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the state to ON or 1 will set the specified trace to write. Setting the state to OFF or 0 will set the specified trace to hold.
Parameter
OFF|ON|0|1
Parameter Type
<boolean>
Default Value
ON for Trace A OFF for Trace B OFF for Trace C
Example
To set Trace A to Hold:
:TRACe:WRITe:STATe OFF :TRACe:WRITe OFF OR :TRACe:WRITe 0
To set Trace C to Write:
:TRACe3:WRITe ON :TRACe3:WRITe:STATe ON :TRACe3:WRITe 1
This command specifies how successive traces are combined to produce the resulting display values.
Setting the operation to NORMal is equivalent to pressing the Shift-5 (Trace), Trace A Operations, Normal->A on the front panel. This displays a trace based on the detection method selected.
Setting the operation to MAXHold is equivalent to pressing the Shift-5 (Trace), Trace A Operations, Max Hold->A on the front panel. This displays the largest signal for each display point over multiple sweeps.
Setting the operation to MINHold is equivalent to pressing the Shift-5 (Trace), Trace A Operations, Min Hold->A on the front panel. This displays the smallest signal for each display point over multiple sweeps.
Setting the operation to AVERage is equivalent to pressing the Shift-5 (Trace), Trace A Operations, Average->A on the front panel. This displays the average value of multiple sweeps for each display point.
The query version of the command returns the current operation mode or “NONE” if no operation is set.
This command specifies how successive traces are combined to produce the resulting display values.
Setting the operation to MAXHold is equivalent to pressing the Shift-5 (Trace), Trace B Operations, Max Hold->B on the front panel. This displays the largest signal for each display point over multiple sweeps.
Setting the operation to MINHold is equivalent to pressing the Shift-5 (Trace), Trace B Operations, Min Hold->B on the front panel. This displays the smallest signal for each display point over multiple sweeps.
The query version of the command returns the current operation mode or “NONE” if no operation is set.
This command specifies how successive traces are combined to produce the resulting display values.
Setting the operation to MAXHold is equivalent to pressing the Shift-5 (Trace), Trace C Operations, Max Hold->C on the front panel. This displays the largest signal for each display point over multiple sweeps.
Setting the operation to MINHold is equivalent to pressing the Shift-5 (Trace), Trace C Operations, Min Hold->C on the front panel. This displays the smallest signal for each display point over multiple sweeps.
Setting the operation to A-B is equivalent to pressing the Shift-5 (Trace), Trace C Operations, A-B->C. This displays the difference between trace A and trace B values in trace C.
Setting the operation to B-A is equivalent to pressing the Shift-5 (Trace), Trace C Operations, B-A->C. This displays the difference between trace B and trace A values in trace C.
The query version of the command returns the current operation mode or “NONE” if no operation is set.