• A
• C
• D
• E
• F
• G
• L
• M
• O
• P
• Q
• R
• S
• T
• X
• Z

Table of all keywords

Example and template

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

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

Keywords listed alphabetically

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

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=Index, Text[, Information]

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

#Analysisvar=Index, Value, Unit, Quantity

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

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

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=Column

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 =Column, Unit, Quantity[, Qnumber]

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

#Columnminmax=Column, Min, Max

Example: #Columnminmax=5, 0.17, 5.68.

#Columnseparator=Char

Example: #Columnseparator=;

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

#Columntext=State[, Remarks]

Example: #Columntext=1.

#ColumnVoid=Column, Value

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=Text

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

#Companyid=Name, Taxcode, CountryID

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

#Dataformat=Type

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=Type

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

#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=Text

Example: #Equipment=TS200.

#Filedate=Yyyy, Mm, Dd

Example: #Filedate=1995,02,20.

#Fileowner=Fileowner

Example: #Fileowner=Lambert Smidt.

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

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

#Filingtext=Index, Text[, Information]

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

#Filingvar=Index, Value, Unit, Quantity

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

#Firstscan=Rownumber

Example: #Firstscan=13.

#GEFID=Release, Version, Update

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=Language

Example: #LANGUAGE=UK.

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

#Lastscan=Rownumber

Example: #Lastscan=888750.

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

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

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

#Measurementtext=Index, Text[, Information]

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

#Measurementvar=Index, Value, Unit, Quantity

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=Value

Example: #OBJECTID=349123.

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

#Os=Type

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

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= Reference[, value, Unit, Quantity[, Quantity number[, Explanation]]]

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=Code, Release, Version, Update[, Reference]

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

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

Example: #Projectid=CO, 342770, 624.

#Projectname=Projectname

Example: #Projectname= High Speed Line.

#Qnminmax=Qn, Min, Max

Example: #Qnminmax=3019, 0.17, 5.68.

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

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

Top

#QnVoid=Qn, Value

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=Char

Example: #Recordseparator=!

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

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

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

#Reportdataformat=Layout

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

#Reporttext=Index, Text[, Information]

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

#Reportvar=Index, Value, Unit, Quantity

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

#Row=Rows

Example: #Row=1495.

#Scanfreq=Value, Startrow

Example: #Scanfreq=27.0, 151745.

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

#Scantime=Value, Startrow

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=Code, Release, Version, Update[, Reference]

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

#Setuptext=Index, Text[, Information]

Example: #Setuptext=250, Removing carbonates by H₂SO₄, carbonate removal.

#Setupvar=Index, Value, Unit, Quantity

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

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

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

#Specimentext=Index, Text[, Information]

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

#Specimenvar=Index, Value, Unit, Quantity

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=Yyyy, Mm, Dd

Example: #Startdate=1995, 02, 06.

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

#Starttime=Hour, Min, Sec

Example: #Starttime=12, 35, 24.75.

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

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

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

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

#Testid=TestID

Example: #Testid=T13B.

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

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

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

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.

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

#Zid=ReferenceID, Z[, EpsZ]

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.

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

• Go to the main GEF files page