NextItemArray

This Data Header variable is a datatype attribute for array variables. This allows reading the number of points/rows in the data arrays without fully reading the data. Because this information may be important for efficient reading of large CSV and TXT files, NextItemArray is included in the saved file even if Save header with data is not selected in the Save > Save Selected trace > Save Options dialog.

NextItemArray[Type|#Elements|Complex Data]

Type - Data type

2 - short, 16 bit integer

3 - int, 32 bit integer

4 - float, 32-bit floating point value

5 - double, 64-bit floating point value

8 - string

11 - bool

20 - long long, 64-bit integer

#Elements - Number of elements in the array

Complex Data - TRUE or FALSE. If the data is complex, there will be two values per line (the first is the real part and the second is the imaginary value).

 

Example:

NextItemArray[4|1048576|TRUE]

-4.225603e-08,3.895912e-08

-4.31628e-08,3.820423e-08

-2.905745e-08,3.607056e-08

9.627001e-09,3.460627e-08

4.288449e-08,3.706555e-08

3.485638e-08,6.730988e-08

-1.053058e-08,1.078788e-07

-7.559311e-08,1.165045e-07

-1.603248e-07,1.163044e-07

-2.375891e-07,1.154572e-07

-2.491001e-07,8.181064e-08

-1.954627e-07,3.342643e-08

-1.309134e-07,2.550223e-09

-8.38013e-08,-7.365088e-09

-7.265044e-08,6.253686e-09

-9.991345e-08,2.928937e-08

. . .

 

In this example, the saved file contains an array that is of type 4 (float, 32-bit floating point value), has 1048576 elements, and is complex data with two values (real, imaginary) per line.