streamInfo
Introduction
This structure is used to transport all information from the Testdefinition and data file to and from STREAM functions.
Overview
Field |
Description |
Header |
Structure containing the header information of the datafile, which is all information except the column data.
A description of fields in this structure can be found at http://www.geffiles.org.
Composite fields appear as structures as well.
Special attention is needed for the next fields:
- flags: indicator whether a GEF keyword (e.g. setuptext, projectid) is available in the header
- bflags: same as flags but binary. In addition for indexed keywords the presence is shown on element level. The number of parts within a keyword is expressed in a binary value (1 = 1 value; 3 = 2 values; 7 = 3 values etc).
- jdx: crossreference to match a variable or text to the right shortname
See an example below
|
Data |
2D-array containing the datablock (columns) of the datafile. |
Variables |
Cellarray containing the shortnames from the Testdefintion with some useful properties, see Create a Testdefinition.
Columns:
- shortname (name of the variable)
- type of variable ('<phase>text', '<phase>var', 'column', 'system')
- sequence number of the variable within the type
- display name (quantity for var/column)
- unit(only for var/column)
- example (only for var/column; for coordinate systems, locations and calibrations it is filled with a string containing the values from the Testdefinition)
- void value (only for column)
- input editor - responsible for shortname
|
Coordinate Systems |
Cellarray containing the coordinate systems, see Coordinate Systems and Locations.
Columns:
- indicator whether a coordinate system exists in the datafile (1) or only in the Testdefinition (0)
- name of the coordinate system
- predecessor coordinate system
- x-translation
- y-translation
- z-translation
- x-rotation axis
- y-rotation axis
- z-rotation axis
- rotation angle
|
SensorLocations |
Cellarray containg the sensor locations, see Coordinate Systems and Locations.
Columns:
- indicator whether a location exists in the datafile (1) or only in the Testdefinition (0)
- shortname of the variable (column)
- sequence number of the variable within the type
- coordinate system in which the location is defined
- x-coordinate
- y-coordinate
- z-coordinate
|
SensorCalibrations |
Cellarray containing the sensor calibrations, see Calibrations.
Columns:
- indicator whether a calibration exists in the datafile (1) or only in the Testdefinition (0)
- shortname of the variable (column)
- sequence number of the variable within the type
- serial number
- offset
- sensitivity
- target quantity number
- minumum of range
- maximum of range
- calibration date
|
Piece of GEF file:
#TESTID= Test_1
#PROJECTID= CO, 1234567, 890
#SETUPTEXT= 1, Our best customer, Name
#SETUPTEXT= 1500, none;0;0;0;1;1;1;0;, StartLab
#SETUPTEXT= 1499, StartLab;20;1;0.7;0;0;0;0;, StartLab TableInLab
Header structure information:
- Header.testid (not indexed; not composite): field containing string
Header.projectid (not indexed; composite): 1x1 struct containing fields 'type', 'number' and 'subproject'
Header.setuptext (indexed; composite): 1x3 struct containing fields 'idx', text' and 'explanation'; idx is filled with 1, 1500 and 1499 (note the order)
- Header.flags.testid = 1
Header.flags.projectid = 1
Header.flags.setuptext = 1
- Header.bflags.testid = 1 (1 part)
Header.bflags.projectid = 7 (3 parts)
Header.bflags.setuptext(1) = 7
Header.bflags.setuptext(1499) = 7
Header.bflags.setuptext(1500) = 7
- Header.jdx.setuptext(1) = 1;
Header.jdx.setuptext(1499) = 3;
Header.jdx.setuptext(1500) = 2;