Example and template
KEYWORD
(version: Legitimate GEFID versions for this keyword)
#Keyword=Param1, Param2, Param3, [ Param4, [Param5]]
Parameter | Type of data | Explanation. |
Param1 | int | An integer number. At least 2 bytes. A maximum value may be required: Maximum = 250 |
Param2 | string | A sequence of alpha numerical characters. A maximum length may be required: Maximum 80 characters. |
Param3 | double | A floating point number of at least 8 bytes long. |
Param4 | float | A floating point number of at least 4 bytes long. Optional, since it is between [ ]. |
Param5 | long | An 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]
Code | string | Text stating how the data generated in earlier phases of the test must be analysed. |
Release | int | A number giving which release of the analysis program must be used to analyse the data. |
Version | int | A number giving the version of the analysis program which must be used to analyse the data. |
Update | int | A number giving which update of the analysis program must be used to analyse the data. |
Reference | string | Reference 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]
Index | int | The number of the text variable. Maximum 1500. |
Text | string | The text belonging to an analysis. Maximum 255 characters. |
Information | string | Information 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
Index | int | Number of the variable. Maximum 1500. |
Value | float | Value of the variable. |
Unit | string | Unit of the variable. Maximum 40 characters. |
Quantity | string | The 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]]]
Index | int | The number of the child, mandatory, max. 1500. |
sReference | string | Reference to the child, mandatory |
value | double | Characteristic value of the child. Optional |
Unit | string | Unit of this characteristic value. Optional |
Quantity | string | Description of the characteristic quantity. Optional |
Quantity number | int | A number describing the type of test of the child. Optional |
Explanation | string | Explanation 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
Column | int | A 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]
Column | int | Number of the column to which the information relates. Maximum 250. |
Unit | string | The unit in which the data in the data block are stored. |
Quantity | string | The quantity stored in the column. |
QNumber | int | The 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
Column | int | The column to which the information relates. Maximum 250. |
Min | double | Minimum value in the column. |
Max | double | Maximum value in the column. |
Example: #Columnminmax=5, 0.17, 5.68.
COLUMNSEPARATOR | version: 1,0,0 / 1,1,0 / 2,0,0 |
#Columnseparator=Char
Char | char | This 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]
State | int | A logical value, determining whether columntext do appear or not. 0 = no columntext. 1 = columntext will occur. |
Remarks | string | Additional remarks. Optional |
Example: #Columntext=1.
COLUMNVOID | version: 1,0,0 / 1,1,0 / 2,0,0 |
#ColumnVoid=Column, Value
Column | int | The number of the column to which the information relates. Maximum 250. |
Value | double | The 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
Text | string | Optional 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
Name | string | Name of the company. |
Taxcode | string | A number by which the company can be identified in the country. For example, a VAT number in The Netherlands. |
CountryID | int | Code for the country. International telephone codes are used. For The Netherlands: 31. |
Example: #Companyid=GEODELFT, 8000.97.476.B.01, 31.
DATAFORMAT | version: 1,0,0 / 1,1,0 / 2,0,0 |
#Dataformat=Type
Type | string | Text 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
Type | string | Text 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
Text | string | Text stating the name of the equipment. |
Example: #Equipment=TS200.
FILEDATE | version: 1,0,0 / 1,1,0 / 2,0,0 |
#Filedate=Yyyy, Mm, Dd
Yyyy | int | Year, when the file was created. Y2k compliant. |
Mm | int | Month, when the file was created. |
Dd | int | Day, when the file was created. |
Example: #Filedate=1995,02,20.
FILEOWNER | version: 1,0,0 / 1,1,0 / 2,0,0 |
#Fileowner=Fileowner
Fileowner | string | Text 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]
Code | string | Text which states how the test data must be archived. |
Release | int | A number giving the release of the archive manager or database program which must be used to file the test. |
Version | int | A number giving which version of the archive manager or database program must be used to file the test. |
Update | int | A number giving which update of the archive manager or database program must be used to file the test. |
Reference | string | Reference 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]
Index | int | The number of the text variable. Maximum 1500. |
Text | string | The text belonging to an archive. Maximum 255 characters. |
Information | string | Information 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
Index | int | Number of the variable. Maximum 1500. |
Value | float | Value of the variable. |
Unit | string | Unit of the variable. Maximum 40 characters. |
Quantity | string | The 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
Rownumber | long | The 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
Release | int | Release number of the geotechnical exchange format of the file. |
Version | int | Version number of the geotechnical exchange format of the file. |
Update | int | Update 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
Language | string | Abbreviation 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
Rownumber | long | Number 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]
Code | string | Text stating how the data were collected. |
Release | int | A number giving the release of the test procedure. |
Version | int | A number giving the version of the test procedure. |
Update | int | A number giving the update of the test procedure. |
Reference | string | Reference 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]
Index | int | The number of the text variable. Maximum 1500. |
Text | string | The text belonging to the test implementation. Maximum 255 characters. |
Information | string | Information 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
Index | int | Sequence number of the variable. Maximum 1500. |
Value | float | Value of the variable. |
Unit | string | Unit in which the variable is expressed. Maximum 40 characters. |
Quantity | string | The 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
Value | long | Reference 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
Type | string | Text 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]]]
Reference | string | Reference to the parent, e.g. a name of a file |
value | double | Characteristic value of the parent. Optional |
Unit | string | Unit of this characteristic value. Optional |
Quantity | string | Description of the characteristic quantity. Optional |
Quantity number | int | A number characterising the type of test of the parent. Optional |
Explanation | string | Explanation 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]
Code | string | Text stating the code of the procedure. |
Release | int | A number which gives the release of the procedure. |
Version | int | A number which gives the version of the procedure. |
Update | int | A number which gives the update of the procedure. |
Reference | string | Reference 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]]
Type | string | Order identification |
Number | string | The order number. Optional |
Sub | string | The sub-project number. Optional |
Example: #Projectid=CO, 342770, 624.
PROJECTNAME | version: 1,0,0 / 1,1,0 / 2,0,0 |
#Projectname=Projectname
Projectname | string | Text 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
Qn | long | The quantity number to which the information relates. |
Min | double | Minimum value in the column associated with this quantity number. |
Max | double | Maximum 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]]
Qn | Long | The quantity number related to the column giving the time since the start of the test. |
Timecode | int | A code for the unit which expresses time. Optional |
Unit | string | Text 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
Qn | long | The quantity number to which the information relates. |
Value | double | The 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
Char | char | The 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]
Code | string | Text stating how the report is compiled. Maximum 80 characters. |
Release | int | A number giving the release of the report. |
Version | int | A number giving the version of the report. |
Update | int | A number giving the update of the report. |
Reference | string | Reference 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
Layout | string | 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:
|
Example: #Reportdataformat=F7.3 F7.3 E11.4 I6.
REPORTTEXT | version: 1,0,0 / 1,1,0 / 2,0,0 |
#Reporttext=Index, Text[, Information]
Index | int | The number of the text variable. Maximum 1500. |
Text | string | The text belonging to the report. Maximum 255 characters. |
Information | string | Information 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
Index | int | Sequence number of the variable. Maximum 1500. |
Value | float | Value of the variable. |
Unit | string | Unit in which the variable is expressed. Maximum 40 characters. |
Quantity | string | The quantity which the variable represents. Maximum 80 characters |
Example: #Reportvar=17, 66, -, number of pages.
ROW | version: 2,0,0 |
#Row=Rows
Rows | long | A 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
Value | float | The frequency used for measuring. |
Startrow | long | The 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
Value | float | The time interval between two readings. |
Startrow | long | The 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]
Code | string | Text which states how the test is prepared. |
Release | int | A number giving the release of the preparation program which must be used to setup the test. |
Version | int | A number giving which version of the preparation program which must be used to setup the setup. |
Update | int | A number giving which update of the preparation program which must be used to setup the test. |
Reference | string | Reference 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]
Index | int | The number of the text variable. Maximum 1500. |
Text | string | The text belonging to an action during setup. Maximum 255 characters. |
Information | string | Information 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
Index | int | Number of the variable. Maximum 1500. |
Value | float | Value of the variable. |
Unit | string | Unit of the variable. Maximum 40 characters. |
Quantity | string | The 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]
Code | string | Text stating how the samples must be collected. Maximum 80 characters. |
Release | int | A number giving the release of the sampling. |
Version | int | A number giving the version of the sampling. |
Update | int | A number giving the update of the sampling. |
Reference | string | Reference 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]
Index | int | The number of the text variable. Maximum 1500. |
Text | string | The text belonging to the sample. Maximum 255 characters. |
Information | string | Information 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
Index | int | Sequence number of the variable. Maximum 1500. |
Value | float | Value of the variable. |
Unit | string | Unit in which the variable is expressed. Maximum 40 characters. |
Quantity | string | The 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
Yyyy | int | The year in which the test started. Y2k compliant. |
Mm | int | The month in which the test started. |
Dd | int | The 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
Hour | int | The hour in which the test started. |
Min | int | The minute in which the test started. |
Sec | float | The 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[,,]]]
Codeword | string | The keyword for which the parameters are described. |
Parameter1 | string | The first parameter belonging to the keyword. |
Parameter [i] | string | The 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[,,]]]
Codeword | string | The keyword for which data types of the parameters are described. |
Parameter1 | string | The data type of the first parameter belonging to the keyword. |
Parameter [i] | string | The 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
TestID | string | Text 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]]
Column | int | Number of the column giving the time since the start of the test. |
Timecode | int | A code for the unit which expresses time. Optional |
Unit | string | Text 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]
MapID | long | A number giving the type of coordinate system used. |
X | double | The x coordinate, measured in an East-West direction. |
Y | double | The y coordinate, measured in a North-South direction. |
EpsX | double | Measurement accuracy of the X coordinate. Optional |
EpsY | double | Measurement 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.
MapID | Description | Date | Projection method |
00000 | own system | ||
00001 | Geographic Coord. System | ||
01000 | SPCS | ||
31000 | RD | RD1918 | stereographic |
31001 | UTM-3N | ED50 | Mercator, central: 3°E |
31002 | UTM-9N | ED50 | Mercator, central: 9°E |
32000 | Belgian Bessel | BD72 | Belgian Lambert |
49000 | Gauss-Krüger | Potsdam | Transversal 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]
ReferenceID | long | A number giving the type of coordinate system used. |
Z | double | The z coordinate, the height or depth. |
EpsZ | double | Measurement 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.