9 Programming the Instrument
9.3 SCPI Operation and Results Query
9.3.3.3 Format Data: Numeric Data (Remote Command Only)
Specifies the format of the trace data input and output.
Specifies the formats used for trace data during data transfer across any remote
port. Affects only the data format for setting and querying trace data for :TRACe
[:DATA], :TRACe[:DATA]?, :CALCulate:DATA[n]? and :FETCh:SANalyzer
[n]?.
Remote Command
:FORMat[:TRACe][:DATA] ASCii | INTeger,32 | REAL,32 | REAL,64
:FORMat[:TRACe][:DATA]?
Notes The query response is:
ASCii: ASC,8
REAL,32: REAL,32
REAL,64: REAL,64
INTeger,32: INT,32
When the numeric data format is REAL or ASCii, data is output in the current Y Axis unit. When the
data format is INTeger, data is output in units of mdBm (.001dBm)
The INT,32 format returns binary 32-bit integer values in internal units (mdBm), in a definite length
block
Dependencies Sending a data format spec with an invalid number (for example, INT,48) generates no error. The
instrument simply uses the default (8 for ASCii, 32 for INTeger, 32 for REAL)
Sending data to the instrument which does not conform to the current FORMat specified, results in
an error. Sending ASCII data when a definite block is expected generates message -161 "Invalid Block
Data" and sending a definite block when ASCII data is expected generates message -121 "Invalid
Character in Number"
Preset
ASCii
Backwards
Compatibility
Notes
Note that the INT,32 format is only applicable to :TRACe:DATA. This preserves backwards
compatibility for the Swept SA measurement. For all other commands/queries that honor
:FORMat:DATA, if INT,32 is sent the instrument will behave as though it were set to REAL,32
The specifications for each output type are:
ASCii
Amplitude values are in ASCII, in the current Y Axis Unit, one ASCII character per
digit, values separated by commas, each value in the form: SX.YYYYYEsZZ,
where:
S = sign (+ or -)
X = one digit to left of decimal point
Y = 5 digits to right of decimal point
E = E, exponent header
s = sign of exponent (+ or -)
ZZ = two digit exponent
Short Range Comms & IoT Mode User's &Programmer's Reference 2438