xmcVitisRead - 2023.2 English

Vitis Model Composer User Guide (UG1483)

Document ID
UG1483
Release Date
2023-11-15
Version
2023.2 English

xmcVitisRead is a MATLAB utility that reads data files and outputs them into MATLAB. The function supports real and complex, signed and unsigned numbers. If the file contains timestamps, they will be added to a separate, parallel array.

Syntax

A = xmcVitisRead(fileIn,dataType)
[A, TS] = xmcVitisRead(fileIn,dataType)

Where, the option fileIn is the file path and the dataType represents the datatype of the imported data.

The following table shows the list of datatypes and maximum possible columns allowed in the input file.

Table 1. Data Types
Data Types Data Size (bits) Maximum Possible Columns
int8 8 16
int16 16 8
int32 32 4
int64 64 2
uint8 8 16
uint16 16 8
uint32 32 4
uint64 64 2
cint16 32 4
cint32 64 2
float 32 4
cfloat 64 2

Example

Let Input.txt be a file of the following format containing real numbers:

"T 470 ns
             1651 -17 6646 -5720 
             T 472 ns
             8850 -2469 2711 7752 
             T 474 ns
             -4938 -6103 -4659 -2352 
             T 476 ns
             -2144 -6453 1410 5685 
             T 478 ns
             -1591 1962 1190 8775"

The following function call imports the array as MATLAB int16 values.

A = xmcVitisRead("Input.txt",'int16')

This is the resulting column vector:

 A = [
                     1651,
                    -17,
                     6646,
                    -5720,
                     8850,
                    -2469,
                     2711,
                     7752,
                    -4938,
                    -6103,
                    -4659,
                    -2352,
                    -2144,
                    -6453,
                     1410,
                     5685,
                    -1591,
                     1962,
                     1190,
                     8775]

The following function call produces two arrays, signal and timestamp. The result is as follows.

[A, timestamp] = xmcVitisRead("Input.txt",'int16')
           
                  TS = [        A = [
                       470,         1651,  
                       470,        -17,
                       470,         6646,
                       470,        -5270,
                       472,         8850,
                       472,        -2469,
                       472,         2711,
                       472,         7752,
                       474,        -4938,
                       474,        -6103,
                       474,        -4659,
                       474,        -2352,
                       476,        -2144,
                       476,        -6453,
                       476,         1410,
                       476,         5685,
                       478,        -1591,
                       478,         1963,
                       478,         1190,
                       478]         8775]
Important: The function checks for the number of columns and returns an error if the number of columns exceeds the theoretical maximum for that data type.
Important: If the file contains timestamps but they are not required, the timestamp output can be left blank. Conversely, if the file does not have timestamps but two outputs are specified, the timestamp output will be an empty numeric array.