Instructions

RIGOL Chapter 2 Command System
2-192 RSA5000 Programming Guide
:TRACe[:DATA]
Syntax
:TRACe[:DATA]
TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6,<definite_length_block>|<comma_separated_ASCII
_data>
:TRACe[:DATA]? TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6
Description
Load the user data into the specified trace.
Query the logarithmic data of the specified trace.
Parameter
Name
Type
Range
Default
-- Keyword
TRACE1|TRACE2|TRACE3|TRACE4|
TRACE5|TRACE6
--
<definite_length_block>
ASCII String
--
--
<comma_separated_ASCII_data>
ASCII String
--
--
Explanation
1. Use the :FORMat[:TRACe][:DATA] command to set the format of the user data.
2. <comma_separated_ASCII_data>:
Data block
[1]
. Select this parameter when the data format is ASCii. The two neighboring data points
are separated by a comma (1 byte) and a space (1 byte) and each point is expressed in scientific
notation; for example, -1.390530e+01 (13 bytes). Up to 801 points can be sent.
3. <definite_length_block>:
Data block
[1]
. Select this parameter when the data format is REAL[,32]|REAL[,64]|INTeger[,32] and
each point is represented by a 32 bit (4 bytes)|64 bit (4 bytes)|32 bit (4 bytes) binary number. Up to
801 points can be sent.
Use the :FORMat:BORDer
command to set the byte order of the binary data transmission.
4. When VSWR is enabled, the :TRACe? TRACE1 command returns the reference data of the VSWR,
the :TRACe? TRACE6 command returns the trace data of the calibration currently enabled and
the :TRACe? TRACE3 (the current mathematical operation trace) command returns the difference
(the return loss) between the reference data and trace data.
Return Format
The query returns the data of the specified trace and the format of the return data depends on the setting
of the
:FORMat[:TRACe][:DATA] command.
Example
[2]
1. When the data format is ASCii
The command below sends the user data to trace 1.
:TRACe:DATA TRACE1, -1.390530e+01, -7.108871e+01, -7.089631e+01, -6.992984e+01,
-7.010770e+01, ……
The query below returns -1.390530e+01, -7.108871e+01, -7.089631e+01, -6.992984e+01,
-7.010770e+01, ……
:TRACe:DATA? TRACE1
2. When the data format is REAL[,32]
The command below sends the user data to trace 2.
:TRACe:DATA
TRACE2,#9000003204111111111111111111111111111001111111111111111111111111111101110
111111111111111111111111111010011……
The query below returns
#90000032041111111111111111111111111110011111111111111111111111111111011101111111