Save file format

Experiments are stored in two files.
Description of experiment is stored in text *.exp file. The recorded data are stored in binary *.d01 file.

Structure of *.d01 file

Name	Type	Description
Data amount	unsigned 32	Number of recorded variables stored.
Data format	unsigned 32	0 - data stored in double format, 1 -data stored in float format

This section repeated amount of times equal to Data amount value.

Data dimension	int 32	The number of dimensions of stored data.
Array of dimensions	(int 32)*4	The sizes of dimensions.
Overall data size	int 32	The size of data stored. Equal to the multiplication of all dimension sizes.

This section repeated amount of times equal to Data amount value.

Data	(Overall data size)*sizeof(double or float)	Data stored in c-style (1D array [(0,0,0,0), (1,0,0,0), ... , (n,0,0,0), (0,1,0,0), (1,1,0,0), ... , (n,1,0,0), ... , (n,m,0,0), ... , (n,m,k,l)]). Fastest index corresponds to transient axes, slowest to Z-axes.

Structure of *.exp file

Exp file is written in Windows ini-file style. The section names are enclosed in square brackets '[]'. Fields have 'field_name = field_value' format. The order in which fields met in the file (within one section) is insignificant. Some sections contain the plain text. Table below present the structure of exp-file. Required sections marked with red. Section and field names with_underline stand for arbitrary name. Field names in bold style stand for reserved words.

Section	Field	Value	Description
[general]	name	string	The name of the experiment
[text]	-	plain multyline text	Any text (sample description)
[sweep]	-	-	Experimental axis definition
[sweep]	transient	string	Transient axis. Format: T/I,trace_length,rep_number,first_stream_name[, second_stream_name[,..]]. T means transient trace is stored. I means trace is integrated and only integral is stored. F.e. transient = I,200,30,a,b means that transient data of the length 200 points were integrated, 30 shots per loop was made, two streams a and b was stored. For single point devices trace length is equal to 1. Streams have to be defined in the [aquisition] section.
[sweep]	sweep0/1/...	string	The axes. Format: X/Y/Z/S/P,trace_length,rep_number,first_par_name (or stream_name)[, second_stream_name (or stream_name)[,..]]. F.e. sweep0 = X,128,1,T1. The order in which parameters are defined affect the presentation order of the axis. Corresponding data are stored in the exp file as 1D c-style array in the order from fastest index to slowest: I/T,X,Y and Z. S(um) and P(arameters) axis does not increase stored data amount. Parameters have to be described in [params] section.
[presetup]	var_name	string	The presetup axis. Actions before the experiment. Format: value; some_property@some_device. F.e. Delay = 10 ms;Delay@ADC.
[aftersetup]	var_name	string	The aftersetup axis. Actions after the experiment. Format: value; some_property@some_device. F.e. Delay = 10 ms;Delay@ADC.
[eachpoint]	var_name	string	The eachpoint axis. Actions that executed each points. Format: value; some_property@some_device. F.e. Delay = 10 ms;Delay@ADC.
[params]	-	-	Parameters of experiment
[params]	par_name	string	Format: value; some_property@some_device. Value of parameter can be: (i) comma separated list; (ii) first_value step increment; (iii) first_value to last_value. F.e. T1 = 40 ns step 20 ns;PPL variable or RF = 40 MHz to 60 MHz; Freq@Gen1
[aquisition]	-	-	Acquisitions streams.
[aquisition]	stream_name	string	Format: some_property@some_device. F.e. a = In_Ch0@PulseGen.
[program]	-	plain multyline text	Pulse program.
[streams]	-	-	Supporting information about data streams.
[streams]	names	Comma separated string list.	Name of data streams (can be different from acquisition streams). F.e. names = Re, Im.
[streams]	units	Comma separated string list.	Units of data streams. F.e. units = V, V.
[streams]	dwelltime	Comma separated string list.	Dwelltime of transient data streams. F.e. dwelltime = 10 ns, 10 ns.
[device_name]	any_field	device dependent.	Any information that device want to store to exp file.

Index//Top/Experiment