Rigol DSA832E - Trace[:Data]

Chapter 2 Command System RIGOL
DSA800E Programming Guide 2-181
:TRACe[:DATA]
Syntax
:TRACe[:DATA]
TRACE1|TRACE2|TRACE3|TRACE4,<definite_length_block>|<comma_separated_ASCII_data>
:TRACe[:DATA]? TRACE1|TRACE2|TRACE3|TRACE4
Description
Load the user data into the specified trace.
Query the data of the specified trace.
Parameter
Name
Type
Range
Default
--
Keyword
TRACE1|TRACE2|TRACE3|TRACE4
--
<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 601 points can be sent.
3. <definite_length_block>:
Data block
[1]
. Select this parameter when the data format is REAL[,32] and each point is represented
by a 32 bit (4 bytes) binary number. Up to 601 points can be sent.
Use the :FORMat:BORDer
command to set the byte order of the binary data transmission.
4. When the Pass/Fail test is enabled, the :TRACe? TRACE2 command returns the data of the upper
limit line and the :TRACe? TRACE3 command returns the data of the lower limit line.
5. When VSWR is enabled, the :TRACe? TRACE1 command returns the reference data of the VSWR,
the :TRACe? TRACE2 command returns the trace data of the calibration currently enabled and
the :TRACe? TRACE4 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,#9000009014 -1.390530e+01, -7.108871e+01, -7.089631e+01,
-6.992984e+01, -7.010770e+01, ……
The query below returns #9000009014 -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,#9000002404111111111111111111111111111001111111111111111111111111111101110
111111111111111111111111111010011……
The query below returns
#90000024041111111111111111111111111110011111111111111111111111111111011101111111
11111111111111111111010011……