Forum
Please or Register to create posts and topics.

File Source

File Source block:

Import and playback any RTSA-Suite PRO ".rtsa", ".tag", ".dat" (I/Q, Spectra, Video, Tracking etc.), ".wv" and ".iq.tar" files from disk. In addition it can be used as a Powerful IQ export feature to other file formats:

File Source Block | Import, Cut and Export data

Right hand side output:

  • Stream

 

This block is quite similar to the File Reader block but reads the complete file to RAM. This makes it interesting for fast playbacks or whenever high data transfers are needed. It can also read third party I/Q files as there are Waveform (.wv), R&S IQ.TAR (.iq.tar) and Tektronix Text (.txt).

 

In addition the File Source block supports the following features:

  • Read any data format supported by the RTSA-Suite PRO incl. ".wv", ".iq.tar" (Rohde & Schwarz) and ".txt" (Tektronix)
  • Change playback speed
  • Preview the datafile and conditions (spectrum, video-picture, antenna position etc.)
  • Area playback (mark an area within the preview for playback)
  • Varios playback options (once, loop, steady, contiguous)
  • Cut and save/export a marked area under a new file
  • Export the file or portions of it under a new data format (CSV, XML, JSON, RTSA, TAG, DAT, ASC and MAT)
  • Change/add power offset, time offset, location (GPS) etc.

 

The powerful export feature supports CSV, XML, JSON, RTSA, TAG, DAT, ASC and MAT (Matlab) formats:

Powerfull Export Feature

File Soure Block Settings

 

The Screenshot shows an imported file ready for playback or export/conversion:

File Source Block Screenhsot

 

Typical Mission:

File Source Typical Mission

Attached is a sample file for the data import of the Tektronix Textfile format.

The format is quite simple so you can also use it for a custom IQ data import.

InputZoom
XDelta 0.0000001
InputCenter 0
InputRange 2
FreqValidMin -5000000
FreqValidMax 5000000
Y
100 200
16384 -16384
1000 2000
-500 1000
100 200
16384 -16384
1000 2000
-500 1000
100 200
16384 -16384
1000 2000
-500 1000

Uploaded files:

As a side note please make sure to add enough "buffer" via the Time Offset feature (30ms should work fine) and to activate the Emulate Realtime checkbox (added since build 10368) if you use the File Source to send IQ data to the Tx:

Stream IQ data to the Tx

Sofon has reacted to this post.
Sofon

New Feature: Raw IQ Import

The File Source block can now also be used to import Raw IQ files, that is files containing just complex samples without any meta data or header information.

Supported Sample Format:

A complex sample consists of two samples of the basic datatype representing the real and the imaginary part. Assuming we want to represent a sequence of complex numbers, the following should be written to the file:

[ Real(x_0), Imag(x_0), Real(x_1), Imag(x_1), Real(x_2), Imag(x_2), ... ]

The following basic datatypes are supported.

  • float / float32
  • double / float64
  • int8
  • int16
  • int32

Block configuration:

To load a raw IQ file into the file source, make sure to select "Raw IQ" as the file type in the file source file browser. You can then select any .iq file:

When reading .iq files, the File Source will first check for any accompanying .xml files with the following contents:

<?xml version="1.0" encoding="UTF-8"?>
<RTSA_RAW_IQ_File>
<Samples>0</Samples>
<Clock unit="Hz">1048576</Clock>
<CenterFrequency unit="Hz">2414500000.000000</CenterFrequency>
<SampleStartTime unit="Epoch time">1650966052.007605</SampleStartTime>
<Format>complex</Format>
<DataType>float32</DataType>
<DataFilename>chirp.iq</DataFilename>
</RTSA_RAW_IQ_File>

That is, RTSA will attempt to open a $filename.iq.xml alongside your $filename.iq file to figure out which sample rate and center frequency should apply, as well as the sample format that should be used.

Recognizing that it will not always be convenient to create such a file, the Format Override options allow you to override these values from the GUI and ignore any .xml document:

Make sure to press Reload after changing the overrides.