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:

  1. shortname (name of the variable)
  2. type of variable ('<phase>text', '<phase>var', 'column', 'system')
  3. sequence number of the variable within the type
  4. display name (quantity for var/column)
  5. unit(only for var/column)
  6. example (only for var/column; for coordinate systems, locations and calibrations it is filled with a string containing the values from the Testdefinition)
  7. void value (only for column)
  8. input editor - responsible for shortname

Coordinate Systems

Cellarray containing the coordinate systems, see Coordinate Systems and Locations.
Columns:

  1. indicator whether a coordinate system exists in the datafile (1) or only in the Testdefinition (0)
  2. name of the coordinate system
  3. predecessor coordinate system
  4. x-translation
  5. y-translation
  6. z-translation
  7. x-rotation axis
  8. y-rotation axis
  9. z-rotation axis
  10. rotation angle

SensorLocations

Cellarray containg the sensor locations, see Coordinate Systems and Locations.
Columns:

  1. indicator whether a location exists in the datafile (1) or only in the Testdefinition (0)
  2. shortname of the variable (column)
  3. sequence number of the variable within the type
  4. coordinate system in which the location is defined
  5. x-coordinate
  6. y-coordinate
  7. z-coordinate

SensorCalibrations

Cellarray containing the sensor calibrations, see Calibrations.
Columns:

  1. indicator whether a calibration exists in the datafile (1) or only in the Testdefinition (0)
  2. shortname of the variable (column)
  3. sequence number of the variable within the type
  4. serial number
  5. offset
  6. sensitivity
  7. target quantity number
  8. minumum of range
  9. maximum of range
  10. calibration date

Example on Header flags

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;
  • No labels