Example and template

KEYWORD 

(version: Legitimate GEFID versions for this keyword)

#Keyword=Param1, Param2, Param3, [ Param4, [Param5]]

ParameterType of dataExplanation.
Param1intAn integer number. At least 2 bytes. A maximum value may be required: Maximum = 250
Param2stringA sequence of alpha numerical characters. A maximum length may be required:  Maximum 80 characters. 
Param3doubleA floating point number of at least 8 bytes long. 
Param4floatA floating point number of at least 4 bytes long.  Optional, since it is between [ ].
Param5longAn integer number of at least 4 bytes. A maximum value may be required: Maximum =  100 000. Optional, since it is between [ ].

Example: #Keyword=12, The number PI, 3.141592653589793238, 3.1415926, 98765

Remarks:

  • The legitimate versions of the GEFID for this keyword are listed in the same line as the caption for Keyword. For an explanation about versions, see versions.
  • Type of Data lists the minimum type of variable to hold the information in the field. For examples and restrictions for "Type of data", see the table of datatypes.
  • Strings as in Param3 must obey the rules as stated for information fields, see special characters.
  • Param4 is in between brackets. It is optional, so it may be omitted.
  • Param5 is optional. The brackets around Param5 are nested within the brackets of Param4. This means that if Param4 is omitted, Param5 should be omitted as well.
  • Valid examples for use of Keyword are:
    • #Keyword=12, The number PI, 3.141592653589793238, 3.1415926, 98765
    • #Keyword=12, The number PI, 3.141592653589793238, 3.1415926
    • #Keyword=12, The number PI, 3.141592653589793238

_________________________________________________________________________________________________________________________________________

ANALYSISCODE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Analysiscode=Code, Release, Version, Update[, Reference]

CodestringText stating how the data generated in earlier phases of the test must be analysed.
ReleaseintA number giving which release of the analysis program must be used to analyse the data.
VersionintA number giving the version of the analysis program which must be used to analyse the data.
UpdateintA number giving which update of the analysis program must be used to analyse the data.
ReferencestringReference or ISO-9000 standard with which the analysis complies. Optional

 

Example: #Analysiscode=MSAPRO, 2, 0, 5, ISO-01.

Note. Via this keyword, a program can determine whether the data is suitable for analysis using this version of the program. This prevents a program designed to work out, for example, a dry critical density test from importing data from a compression test. In addition, tests which still need to be analysed using an older version, can be processed using the most suitable method.

 

ANALYSISTEXT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Analysistext=Index, Text[, Information]

IndexintThe number of the text variable. Maximum 1500.
TextstringThe text belonging to an analysis. Maximum 255 characters.
InformationstringInformation about the text. Maximum 80 characters.  Optional

 

Example: #Analysistext=129, Cohesion calculated in accordance with NEN, comments.

 

ANALYSISVAR

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Analysisvar=Index, Value, Unit, Quantity

IndexintNumber of the variable. Maximum 1500.
ValuefloatValue of the variable.
UnitstringUnit of the variable. Maximum 40 characters.
QuantitystringThe quantity which the variable represents. Maximum 80 characters.

 

Example: #Analysisvar=129, 1.33,-,over-relax factor for creep.

 

CHILD

(version:  1,1,0 / 2,0,0)

#CHILD= Index, Reference[, value, Unit, Quantity[, Quantity number[, Explanation]]]

IndexintThe number of the child, mandatory, max. 1500.
sReferencestringReference to the child, mandatory
valuedoubleCharacteristic value of the child.  Optional
UnitstringUnit of this characteristic value.  Optional
QuantitystringDescription of the characteristic quantity.  Optional
Quantity numberintA number describing the type of test of the child.  Optional
ExplanationstringExplanation of the field.  Optional

 

Example: #CHILD= 3, d1.gef, 10, m, penetration length, 2, dissipation test

Remarks:

  • Child is only listed in files of tests during which other tests are performed; e.g. child is listed in GEF-CPT-Report.
  • The reference item in the child keyword must hold an unique identifier as a link to the child. It is usually a name of a file. Other possibilities are objectids or a primary key in a database. The reference field may contain up to 1023 characters. This item is compulsory.
  • When files are transferred between different clients, one should avoid using path names, since there is no guarantee for a unique directory structure.
  • The items Value, Unit and Quantity are optional. They form a group of items. If a Value is given, the Unit and Quantity must be given as well. The reason is, that if Unit is omitted, it is impossible to know what the Value really means. Unit and Quantity are conditionally compulsory. If a value without a dimension is to be listed, e.g. merely a number, Unit is marked by '-'. For each type of value a description for Quantity can be given: e.g. a number of a scan, a depth or a date (20000419)
  • The item Quantity number is optional. It allows for an automatic recognition of the type of test. If Value, Unit and Quantity are not listed, Quantity number can not be listed as well.
  • The item Explanation is optional. If the Quantity number is not listed, Explanation can not be listed either.

 

COLUMN

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Column=Column

ColumnintA number between 1 and 250. This gives the number of columns which are in the data block.

 

Example: #Column=4.

Note. For a binary file, it is assumed that #Column observations, consisting of 4-bytes floating point numbers, belonging to a scan, are stored. Also see Datatype.

 

COLUMNINFO

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Columninfo =Column, Unit, Quantity[, Qnumber]

ColumnintNumber of the column to which the information relates. Maximum 250.
UnitstringThe unit in which the data in the data block are stored.
QuantitystringThe quantity stored in the column.
QNumberintThe number identifying a quantity.

 

Example: #Columninfo=3, kPa, deviator pressure, 1001.

 

COLUMNMINMAX

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Columnminmax=Column, Min, Max

ColumnintThe column to which the information relates. Maximum 250.
MindoubleMinimum value in the column.
MaxdoubleMaximum value in the column.

 

Example: #Columnminmax=5, 0.17, 5.68.

 

COLUMNSEPARATOR

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Columnseparator=Char

CharcharThis is a character (to be printed in ASCII) which will be printed between each column, making it easier to import data with so-called spreadsheet programs or databases. See also Recordseparator.

 

Example: #Columnseparator=;

Remark: the characters \#=+-.,DEGdeg0123456789 are not allowed as columnseparator. Furthermore Columnseparator and Recordseparator must differ.

 

COLUMNTEXT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Columntext=State[, Remarks]

Stateint

A logical value, determining whether columntext do appear or not.

0 = no columntext.

1 = columntext will occur.

RemarksstringAdditional remarks.  Optional

 

Example: #Columntext=1.

 

COLUMNVOID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#ColumnVoid=Column, Value

ColumnintThe number of the column to which the information relates. Maximum 250.
ValuedoubleThe figure which shows that the value does not contain suitable information.

Example:   #COLUMNVOID = 2, -999

Note. Instead of using a letter of a word, it was decided to define a figure to indicate that no suitable information is present at the position, so the possibility of using the columnvoid keyword in binary data blocks was not blocked.

 

COMMENT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Comment=Text

TextstringOptional random text, not necessary for the test, rather an annotation but as a marginal note. A maximum of 1500 comment lines can be stored. Maximum 255 characters.

 

Example: #Comment=Repeat of the test of 1995-06-25.

 

COMPANYID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Companyid=Name, Taxcode, CountryID

NamestringName of the company.
TaxcodestringA number by which the company can be identified in the country. For example, a VAT number in The Netherlands.
CountryIDintCode for the country. International telephone codes are used. For The Netherlands: 31.

 

Example: #Companyid=GEODELFT, 8000.97.476.B.01, 31.

 

DATAFORMATo

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Dataformat=Type

TypestringText stating whether the readings in the data block are stored as an ASCII or BINARY file.

 

Example: #Dataformat=Binary.

Note. Only ASCII and BINARY are permitted. Binary data storage can be imported and processed extremely rapidly. It is, however, system dependent. The data format default value is ASCII. Also see keyword OS.

 

DATATYPE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Datatype=Type

TypestringText stating which type of numbers are stored in the data block.

 

Example: #Datatype=REAL8.

Note. The types currently recognised as legal data types are described in Table 5. All variables in the datablock must be of the same type. This keyword is conditionally compulsory for binary storage (#DATAFORMAT=BINARY). The default value is a 4-byte floating point number.

Table 5     Types of variables used in Datatype

Type

Description

Number of bytes

Example

byte

flag

1

1

int2

integer number

2

-30000

long

integer number

4

2123456789

int4

integer number

4

2123456789

real4

decimal number

4

-3.14159

float

decimal number

4

-3.14159

real8

decimal number

8

6.62×10-34

double

decimal number

8

6.62×10-34

string

text

variable

Measurement

 

EOH

(version: 1,0,0 / 1,1,0 / 2,0,0)

#EOH=

 

Example: #EOH=

Note. This keyword has no data behind the  =  character which needs to be used. In addition, this keyword is completed using a Line Feed (Unix) or the Carriage Return and the Line Feed (DOS). When using binary data, no text in the data block is allowed.

 

EQUIPMENT

(version: 1,0,0 / 1,1,0)

#Equipment=Text

TextstringText stating the name of the equipment.

 

Example: #Equipment=TS200.

 

FILEDATE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Filedate=Yyyy, Mm, Dd

YyyyintYear, when the file was created. Y2k compliant.
MmintMonth, when the file was created.
DdintDay, when the file was created.

 

Example: #Filedate=1995,02,20.

 

FILEOWNER

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Fileowner=Fileowner

FileownerstringText stating the owner of the file. The file owner is responsible for the quality of the file. He/she is usually the same person who performed the test.

 

Example: #Fileowner=Lambert Smidt.

 

FILINGCODE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Filingcode=Code, Release, Version, Update[, Reference]

CodestringText which states how the test data must be archived.
ReleaseintA number giving the release of the archive manager or database program which must be used to file the test.
VersionintA number giving which version of the archive manager or database program must be used to file the test.
UpdateintA number giving which update of the archive manager or database program must be used to file the test.
ReferencestringReference of the ISO-9000 standard with which the archive management complies.  Optional

 

Example: #Filingcode=B17, 3, 0, 1, NEN888888.

 

FILINGTEXT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Filingtext=Index, Text[, Information]

IndexintThe number of the text variable. Maximum 1500.
TextstringThe text belonging to an archive. Maximum 255 characters.
InformationstringInformation about the text. Maximum 80 characters.  Optional

 

Example: #Filingtext=129, Archiving in Oracle table PROJECT, tablename.

 

FILINGVAR

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Filingvar=Index, Value, Unit, Quantity

IndexintNumber of the variable. Maximum 1500.
ValuefloatValue of the variable.
UnitstringUnit of the variable. Maximum 40 characters.
QuantitystringThe quantity which the variable represents. Maximum 80 characters.

 

Example: #Filingvar=133, 0.45, -,Location of the map.

 

 

 

FIRSTSCAN

(version: 1,0,0 / 1,1,0)

#Firstscan=Rownumber

RownumberlongThe number of the first scan containing a meaningful value.

 

Example: #Firstscan=13.

 

GEFID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#GEFID=Release, Version, Update

ReleaseintRelease number of the geotechnical exchange format of the file.
VersionintVersion number of the geotechnical exchange format of the file.
UpdateintUpdate number of the geotechnical exchange format.

 

Example: #GEFID=1,0,0.

Note. This keyword must be the first one to appear in the file. It must be written in capital letters. Using the first line, operation systems like Unix are able to deduce the type of file and which program or printer is needed to control the file.

 

LANGUAGE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Language=Language

LanguagestringAbbreviation which states the language. Maximum 2 characters.

 

Example: #LANGUAGE=UK.

Note. This keyword can influence the program which imports and analyses a GEF file. Default value is  NL .

 

LASTSCAN

(version: 1,0,0 / 1,1,0)

#Lastscan=Rownumber

RownumberlongNumber of the last meaningful scan.

 

Example: #Lastscan=888750.

Note. The default value is 2147483648 (=231). (Nov 2000 I) The scans following the scan number in lastscan, are not processed.

 

MEASUREMENTCODE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Measurementcode=Code, Release, Version, Update[, Reference]

CodestringText stating how the data were collected.
ReleaseintA number giving the release of the test procedure.
VersionintA number giving the version of the test procedure.
UpdateintA number giving the update of the test procedure.
ReferencestringReference or the ISO-9000 standard with which the test procedure complies.  Optional

 

Example: #Measurementcode=Cu, 3, 1, 0, 300-1-CU.

 

MEASUREMENTTEXT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Measurementtext=Index, Text[, Information]

IndexintThe number of the text variable. Maximum 1500.
TextstringThe text belonging to the test implementation. Maximum 255 characters.
InformationstringInformation about the text. Maximum 80 characters.  Optional

 

Example: #Measurementtext=129, Temperature measured in accordance with NEN, temp. measurement.

 

MEASUREMENTVAR

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Measurementvar=Index, Value, Unit, Quantity

IndexintSequence number of the variable. Maximum 1500.
ValuefloatValue of the variable.
UnitstringUnit in which the variable is expressed. Maximum 40 characters.
QuantitystringThe quantity which the variable represents. Maximum 80 characters.

 

Example: #Measurementvar=133, 17.1, °C, temperature outside.

Note. Measurementvar is used to store one-time measurements which form part of a test, such as temperature outside.

 

OBJECTID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Objectid=Value

ValuelongReference to a number in the archive where this GEF file belongs.

 

Example: #OBJECTID=349123.

Note. Objectid can refer to a (primary ) key in a database.

 

OS

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Os=Type

TypestringText stating for which operating system the data are stored. Maximum 10 characters.

 

Example: #OS=UNIX.

Note. This keyword is only important for binary data. If Dataformat is BINARY, the OS keyword is compulsory.

Table 6 Little Endian and Big Endian in keyword OS

Either

Alternative

Representation of 16

Type of processor

DOS

LE

10 00 00 00

Intel

UNIX

BE

00 00 00 10

Motorola



In the old days most Unix's were running on the generic type Motorola processors, which use Big Endian notation. DOS was running on the generic type of Intel processors, which use Little Endian representation. In the third column of Table 6 the number 16 is written down as a long integer, in hexadecimal notation.

 

PARENT

(version: 1,1,0 / 2,0,0)

#PARENT= Reference[, value, Unit, Quantity[, Quantity number[, Explanation]]]

ReferencestringReference to the parent, e.g. a name of a file
valuedoubleCharacteristic value of the parent.  Optional
UnitstringUnit of this characteristic value.  Optional
QuantitystringDescription of the characteristic quantity.  Optional
Quantity numberintA number characterising the type of test of the parent.  Optional
ExplanationstringExplanation of the keyword.  Optional

 

Example: #PARENT= 14.gef, 10, m, penetration length, 1, CPT

Remarks:

  • Parent is only listed in files, which report tests that are performed as part of another test; e.g. parent will appear in a dissipation test.
  • The reference item in the parent keyword must hold an unique identifier as a link to the parent test. It is usually a name of a file. Other possibilities are objectids or a primary key in a database. The reference field may contain up to 1023 characters. This item is compulsory.
  • When files are transferred between different clients, one should avoid using path names, since there is no guarantee for a unique directory structure.
  • The items Value, Unit and Quantity are optional. They form a group of items. If a Value is given, the Unit and Quantity must be given as well. The reason is, that if Unit is omitted, it is impossible to know what the Value really means. Unit and Quantity are conditionally compulsory. If a value without a dimension is to be listed, e.g. merely a number, Unit is marked by '-'. For each type of value a description for Quantity can be given: e.g. a number of a scan, a depth or a date (20000419)
  • The item Quantity number is optional. It allows for an automatic recognition of the type of test. If Value, Unit and Quantity are not listed, Quantity number can not be listed as well.
  • The item Explanation is optional. If the Quantity number is not listed, Explanation can not be listed either.

 

PROCEDURECODE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Procedurecode=Code, Release, Version, Update[, Reference]

CodestringText stating the code of the procedure.
ReleaseintA number which gives the release of the procedure.
VersionintA number which gives the version of the procedure.
UpdateintA number which gives the update of the procedure.
ReferencestringReference or ISO-9000 standard. Maximum 80 characters.  Optional

 

Example: #Procedurecode=GEF-CPT-Report, 1,0,0.

 

PROJECTID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Projectid=Type,[ Number,[ Sub]]

TypestringOrder identification
NumberstringThe order number.  Optional
SubstringThe sub-project number.  Optional

 

Example: #Projectid=CO, 342770, 624.

 

PROJECTNAME

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Projectname=Projectname

ProjectnamestringText stating the name of the relevant project. Maximum of 255 characters.

 

Example: #Projectname= High Speed Line.

 

QNMINMAX

(version: 2,0,0)

#Qnminmax=Qn, Min, Max

QnlongThe quantity number to which the information relates.
MindoubleMinimum value in the column associated with this quantity number.
MaxdoubleMaximum value in the column associated with this quantity number.

 

Example: #Qnminmax=3019, 0.17, 5.68.

 

QNTIME

(version: 2,0,0)

#Qntime=Qn[, Timecode[, Unit]]

QnLongThe quantity number related to the column giving the time since the start of the test.
TimecodeintA code for the unit which expresses time.  Optional
UnitstringText stating the unit.  Optional

 

Example: #QNTIME=102, 2

Note. To calculate the actual time -as on your watch-, the column which gives the time in respect of the starttime and startdate in Unit has preference over a reconstructed time from scanfrequency and scantime. The default value for Code is 1, namely seconds. The values for Timecode are given in Table 7

Table 7     Value of Code and Unit 

Timecode

Unit

1

second

2

minute

3

hour

4

day

5

week

 

QNVOID

(version: 2,0,0)

#QnVoid=Qn, Value

QnlongThe quantity number to which the information relates.
ValuedoubleThe figure which shows that the value does not contain suitable information.

Example:   #QNVOID = 3019, -999

Note. Instead of using a letter of a word, it was decided to define a figure to indicate that no suitable information is present at the position, so the possibility of using the qnvoid keyword in binary data blocks was not blocked.

 

RECORDSEPARATOR

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Recordseparator=Char

CharcharThe character used to finish a data record. A data record always consists of a fixed number of registrations (the value is given by the #column). It is the physical end of the scan. Also see Columnseparator.

 

Example: #Recordseparator=!

(Nov 2000 I) Remark: the characters \#=+-.,DEGdeg0123456789 are not allowed as columnseparator. Furthermore Columnseparator and Recordseparator must differ.

 

REPORTCODE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Reportcode=Code, Release, Version, Update[, Reference]

CodestringText stating how the report is compiled. Maximum 80 characters.
ReleaseintA number giving the release of the report.
VersionintA number giving the version of the report.
UpdateintA number giving the update of the report.
ReferencestringReference or the ISO-9000 standard with which the report complies. Maximum 80 characters.  Optional

 

Example: #Reportcode=Standard, 3, 1, 0, 300-1-SDS.

 

 

REPORTDATAFORMAT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Reportdataformat=Layout

Layoutstring

The layout of the values to be printed sLayout consists of a series of words, separated by blanks. The number of words must be equal to the number of columns, as started in #COLUMN=. Each word consists of one letter and one or more digits. This word determines how a value is printed. The convention of the FORTRAN format identifier is used:

InInteger, n digits long.
Fw.dFloating point number, w digits long, d decimals.
Ew.dExponential representation, w digits long, d decimals.

 

Example: #Reportdataformat=F7.3 F7.3 E11.4 I6.

 

 

REPORTTEXT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Reporttext=Index, Text[, Information]

IndexintThe number of the text variable. Maximum 1500.
TextstringThe text belonging to the report. Maximum 255 characters.
InformationstringInformation about the text. Maximum 80 characters.  Optional

 

Example: #Reporttext=129, Section 5 is confidential, general comment.

 

 

REPORTVAR

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Reportvar=Index, Value, Unit, Quantity

IndexintSequence number of the variable. Maximum 1500.
ValuefloatValue of the variable.
UnitstringUnit in which the variable is expressed. Maximum 40 characters.
QuantitystringThe quantity which the variable represents. Maximum 80 characters

 

Example: #Reportvar=17, 66, -, number of pages.

 

ROW

(version: 2,0,0)

#Row=Rows

RowslongA number between 1 and 2147483647. This gives the number of rows which are in the data block.

 

Example: #Row=1495.

 

SCANFREQ

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Scanfreq=Value, Startrow

ValuefloatThe frequency used for measuring.
StartrowlongThe number of the scan from where this frequency starts.

 

Example: #Scanfreq=27.0, 151745.

Note. The scan frequency is expressed in Hz (s-1).

 

SCANTIME

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Scantime=Value, Startrow

ValuefloatThe time interval between two readings.
StartrowlongThe number of the scan from where this time interval starts.

 

Example: #Scantime=60.0, 151745.

Note. The time interval is expressed in s. In the example, a reading is carried out each minute. For scanfreq and scantime, startdate and starttime are to be used. The scans in the test are thus placed in absolute form in time.

 

SETUPCODE

(version: 2,0,0)

#Setupcode=Code, Release, Version, Update[, Reference]

CodestringText which states how the test is prepared.
ReleaseintA number giving the release of the preparation program which must be used to setup the test.
VersionintA number giving which version of the preparation program which must be used to setup the setup.
UpdateintA number giving which update of the preparation program which must be used to setup the test.
ReferencestringReference or the ISO-9000 standard with which the setup program complies.  Optional

 

Example: #Setupcode=S17, 3, 0, 1, NEN888888.

 

SETUPTEXT

(version: 2,0,0)

#Setuptext=Index, Text[, Information]

IndexintThe number of the text variable. Maximum 1500.
TextstringThe text belonging to an action during setup. Maximum 255 characters.
InformationstringInformation about the text. Maximum 80 characters.  Optional

 

Example: #Setuptext=250, Removing carbonates by H2SO4, carbonate removal.

 

SETUPVAR

(version: 2,0,0)

#Setupvar=Index, Value, Unit, Quantity

IndexintNumber of the variable. Maximum 1500.
ValuefloatValue of the variable.
UnitstringUnit of the variable. Maximum 40 characters.
QuantitystringThe quantity which the variable represents. Maximum 80 characters.

 

Example: #Setupvar=250, 45.89, g, Mass of removed carbonates.

 

SPECIMENCODE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Specimencode=Code, Release, Version, Update[, Reference]

CodestringText stating how the samples must be collected. Maximum 80 characters.
ReleaseintA number giving the release of the sampling.
VersionintA number giving the version of the sampling.
UpdateintA number giving the update of the sampling.
ReferencestringReference or the ISO-9000 standard with which the sample complies. Maximum 80 characters.  Optional

 

Example: #Specimencode=MN, 3, 1, 0, 300-1-Mons.

 

SPECIMENTEXT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Specimentext=Index, Text[, Information]

IndexintThe number of the text variable. Maximum 1500.
TextstringThe text belonging to the sample. Maximum 255 characters.
InformationstringInformation about the text. Maximum 80 characters.  Optional

 

Example: #Specimentext=129, Sample fell apart during transportation, general comment.

 

SPECIMENVAR

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Specimenvar=Index, Value, Unit, Quantity

IndexintSequence number of the variable. Maximum 1500.
ValuefloatValue of the variable.
UnitstringUnit in which the variable is expressed. Maximum 40 characters.
QuantitystringThe quantity which the variable represents. Maximum 80 characters.

 

Example: #Specimenvar=17, 0.37, -, porosity.

Note. Specimenvar is very similar to Measurementvar as far as structure and use are concerned. The difference is that the information is specifically related to a sample with Specimenvar, while Measurementvar is concerned with quantities which are specifically related to measuring and measurement apparatus where appropriate.

 

STARTDATE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Startdate=Yyyy, Mm, Dd

YyyyintThe year in which the test started. Y2k compliant.
MmintThe month in which the test started.
DdintThe day on which the test started.

 

Example: #Startdate=1995, 02, 06.

Note. Together with the start time, the start date is important for tests as a function of time.

 

STARTTIME

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Starttime=Hour, Min, Sec

HourintThe hour in which the test started.
MinintThe minute in which the test started.
SecfloatThe second in which the test started.

 

Example: #Starttime=12, 35, 24.75.

 

STRUCTURETEXT

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Structuretext=Codeword, Parameter1[, Parameter2[, Parameter3[,,]]]

CodewordstringThe keyword for which the parameters are described.
Parameter1stringThe first parameter belonging to the keyword.
Parameter [i]stringThe i-th parameter belonging to the keyword, i goes from 1 up to the number of parameters.

 

Example: #Structuretext=GEFID, Releasenumber, Versionnumber, Updatenumber.

 

STRUCTURETYPE

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Structuretype=Codeword, Type1[, Type2[, Type3[,,]]]

CodewordstringThe keyword for which data types of the parameters are described.
Parameter1stringThe data type of the first parameter belonging to the keyword.
Parameter [i]stringThe data type of the i-th parameter belonging to the keyword, i goes from 1 up to the number of parameters.

 

Example: #Structuretype=GEFID, int2, int2, int2.

 

TESTID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Testid=TestID

TestIDstringText stating which test from a series of tests this file concerns.

 

Example: #Testid=T13B.

 

TIMECOLUMN

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Timecolumn=Column[, Timecode[, Unit]]

ColumnintNumber of the column giving the time since the start of the test.
TimecodeintA code for the unit which expresses time.  Optional
UnitstringText stating the unit.  Optional

 

Example: #TIMECOLUMN=5, 2

Note. To calculate the time, the column which gives the time in respect of the starttime and startdate in sUnit has preference over a reconstructed time from scanfrequency and scantime. The default value for Code is 1, namely seconds. The values are given in Table 8

Table 8     Value of Code and Unit 

Timecode

Unit

1

second

2

minute

3

hour

4

day

5

week

 

XYID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#XYid=MapID, X, Y[, EpsX, EpsY]

MapIDlongA number giving the type of coordinate system used.
XdoubleThe x coordinate, measured in an East-West direction.
YdoubleThe y coordinate, measured in a North-South direction.
EpsXdoubleMeasurement accuracy of the X coordinate.  Optional
EpsYdoubleMeasurement accuracy of the Y coordinate.  Optional

 

Example: #XYid=31000, 155015, 463701, 0.1, 0.1.

Remarks:

  • The EpsX and EpsY fields are optional. It is an optional group. Either both must be given or or both are omitted.
  • The coordinate systems are linked to a country code. The first numbers 0000-0009 are defined free or international, see Table 8.

Table 8   The translation between MapID and coordinate system.

MapIDDescriptionDateProjection method
00000own system  
00001Geographic Coord. System  
01000SPCS  
31000RDRD1918stereographic
31001UTM-3NED50Mercator, central: 3°E
31002

UTM-9N

ED50Mercator, central: 9°E
32000Belgian BesselBD72Belgian Lambert
49000Gauss-KrügerPotsdamTransversal Mercator

The MapID code consists of the international dial code for a specific country, multiplied by 1000, followed by a number 000 .. 999. 

 

ZID

(version: 1,0,0 / 1,1,0 / 2,0,0)

#Zid=ReferenceID, Z[, EpsZ]

ReferenceIDlongA number giving the type of coordinate system used.
ZdoubleThe z coordinate, the height or depth.
EpsZdoubleMeasurement accuracy of the Z coordinate.  Optional

 

Example: #Zid=31001, -15.75, 0.001.

The default value of Z is 0.0. The coordinate systems are linked to a country code. The first numbers 0000-0009 are defined free or international, see Table 9.

Table 9  The translation between ReferenceID and coordinate system.

ReferenceID

Description

00000

own reference level

00001

Low Low Water Spring

31000

NAP

32000

Ostend Level

32001

TAW

49000

Normal Null

 

The ReferenceID consists of the international dial code for a specific country, multiplied by 1000, followed by a number 000 .. 999.

  • No labels