R&S ESR Series User Manual page 543

®
R&S ESR
<PreviewData>...</PreviewData>
</RS_IQ_TAR_FileFormat>
Element
RS_IQ_TAR_FileFormat
Name
Comment
DateTime
Samples
Clock
Format
DataType
ScalingFactor
NumberOfChannels
User Manual 1175.7068.02 ─ 12
Saving and Recalling Settings Files – SAVE/RCL Key
Description
The root element of the XML file. It must contain the attribute
fileFormatVersion that contains the number of the file format definition.
Currently, fileFormatVersion "2" is used.
Optional: describes the device or application that created the file.
Optional: contains text that further describes the contents of the file.
Contains the date and time of the creation of the file. Its type is xs:dateTime
(see RsIqTar.xsd).
Contains the number of samples of the I/Q data. For multi-channel signals all
channels have the same number of samples. One sample can be:
●
A complex number represented as a pair of I and Q values
●
A complex number represented as a pair of magnitude and phase values
●
A real number represented as a single real value
See also Format element.
Contains the clock frequency in Hz, i.e. the sample rate of the I/Q data. A signal
generator typically outputs the I/Q data at a rate that equals the clock frequency.
If the I/Q data was captured with a signal analyzer, the signal analyzer used the
clock frequency as the sample rate. The attribute unit must be set to "Hz".
Specifies how the binary data is saved in the I/Q data binary file (see
DataFilename element). Every sample must be in the same format. The for-
mat can be one of the following:
●
Complex: Complex number in cartesian format, i.e. I and Q values inter-
leaved. I and Q are unitless
●
Real: Real number (unitless)
●
Polar: Complex number in polar format, i.e. magnitude (unitless) and phase
(rad) values interleaved. Requires DataType = float32 or float64
Specifies the binary format used for samples in the I/Q data binary file (see
DataFilename element and
ing data types are allowed:
●
int8: 8 bit signed integer data
●
int16: 16 bit signed integer data
●
int32: 32 bit signed integer data
●
float32: 32 bit floating point data (IEEE 754)
●
float64: 64 bit floating point data (IEEE 754)
Optional: describes how the binary data can be transformed into values in the
unit Volt. The binary I/Q data itself has no unit. To get an I/Q sample in the unit
Volt the saved samples have to be multiplied by the value of the
ScalingFactor. For polar data only the magnitude value has to be multiplied.
For multi-channel signals the ScalingFactor must be applied to all channels.
The ScalingFactor must be > 0. If the ScalingFactor element is not
defined, a value of 1 V is assumed.
Optional: specifies the number of channels, e.g. of a MIMO signal, contained in
the I/Q data binary file. For multi-channels, the I/Q samples of the channels are
expected to be interleaved within the I/Q data file (see
on page 542). If the NumberOfChannels element is not defined, one channel
is assumed.
Data Management and Documentation
"I/Q Data Binary File" on page 542). The follow-
"I/Q Data Binary File"
540