BOR format specifications : Bor extension

The Bor Format consists of two parts:

the specification of the storage format
the specification of the field type

Introduction

First, it is assumed that a file matches a recording as an independant logical unit. The file is named with a .bor extension.

File name example

50000240705140601D.bor

Table 1. File name structure
5	0001	240705140601	D	.bor
Generation	Serial	Date	Domain	Format

Table 2. Domain ID
ID	Domain
`D`	Drilling parameters
`G`	Grouting parameters
`J`	JetGrouting parameters
`P`	Ménard Pressuremeter Test
`A`	Continuous Flight Auger Pile (CFA)
`L`	Lugeon Test
`Y`	Dynamic probing

Abilities

The file has the following abilities:

recording description
data logs
non-modification source-file guarantee

Format specification

The bor file is a zip format archive containing the files below:

A file description that contains technical informations non-specific to the recording type and field properties, references to data file: description.xml
Data file, example: data.nc

Note	an archive may hold other entries reserved by the device. They are not part of the format: readers must ignore any entry other than `description.xml` and the data file it references.

Data file

Data file use the netCDF (3.6+, NETCDF3_CLASSIC) format. It contain data logs and each variable.

Description file

The description file contains 2 different types of information:

non-specific technical information
field-specific properties

Note	the format is unit-agnostic by design. Every quantity-typed property carries its own `unit` attribute (see the examples below, e.g. `bar` vs `psi`, `mm` vs `inch`); the examples in this spec use SI units for clarity, but readers must not assume a fixed unit for any field.

Note

enumerated code lists are append-only. A code is never renamed, removed or reassigned to another meaning - new values are only ever added. Readers must therefore keep an unrecognised code as-is: neither drop it silently nor reject the file. This is what keeps files readable across dictionary growth without a version marker on the non-specific part of the description.

Example of Description file

Example of description.xml file (drilling parameters)

<?xml version="1.0" encoding="UTF-8"?>
<description xmlns="http://www.lim.eu/description" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.lim.eu/description description.xsd">
  <filename>50000240705140601D</filename>
  <creation>2024-07-05T14:06:01+02:00</creation>
  <modification>2024-07-05T14:08:02+02:00</modification>
  <project_ref>Bor-Format</project_ref>
  <borehole_ref>BH1</borehole_ref>
  <operator>GASTON</operator>
  <device>
    <serial>50000</serial>
    <version>1.0</version>
    <build>20190104</build>
  </device>
  <position>
    <longitude unit="degree">4.9187880</longitude>
    <latitude unit="degree">45.7597504</latitude>
    <altitude unit="m">192.000000</altitude>
    <epv unit="m">655.35</epv>
    <eph unit="m">655.35</eph>
  </position>
  <cell>
    <mcc>208</mcc>
    <mnc>01</mnc>
    <cellid>00B2350F</cellid>
    <lac>00000884</lac>
  </cell>
  <borehole>
    <borehole_diameter unit="mm">160</borehole_diameter>
    <borehole_inclination unit="degree">0</borehole_inclination>
    <water_depth unit="m">0.1</water_depth>
  </borehole>
  <drilling>
    <machine_ref>DCH 218</machine_ref>
    <method>DRLMTD_RTR</method>
    <tool>DRLBIT_CNTCI</tool>
    <tool_diameter unit="mm">150</tool_diameter>
    <fluid>DRLFLD_WTR</fluid>
    <rod_length unit="m">4.5</rod_length>
  </drilling>
  <convention version="1.1">
    <parameters phase="DRILL">
      <inclination>
        <X unit="degree">171.9</X>
        <Y unit="degree">86.3</Y>
      </inclination>
      <effective_duration unit="s">59.40</effective_duration>
      <logfile>data.nc</logfile>
    </parameters>
  </convention>
</description>

Non-specific technical information

Table 3. Non-specific technical information
Property	Description	Type	Required	Example
`borehole_ref`	Borehole reference	text	required ^[1]	BH1
`borehole`	Borehole information	structure (see below)	optional
`cell`	Cell position	structure (see below)	optional
`client`	Client name	text	optional	fm
`company`	Company name	text	optional
`creation`	Creation date	iso8601	required	2024-07-05T14:06:01+02:00
`device`	Device information	structure (see below)	required
`drilling`	Drilling information	structure (see below)	required ^[2]
`filename`	File name	text	required	50000240705140601D
`modification`	Modification date	iso8601	required	2024-07-05T14:08:02+02:00
`operator`	Operator name	text	optional	ROBERT
`position`	GPS measurement	structure (see below)	optional
`project_ref`	File reference	text	required	Bor-Format

Borehole information (optional)

Table 4. Borehole information
Property	Description	Type	Required	Example
`borehole_diameter`	Borehole diameter	length	optional	66 (mm)
`borehole_inclination`	Borehole inclinaison	angle	optional	0 (degree)
`water_depth`	Depth of water level ^[3]	level	optional	0.1 (m)

Cell position (optional)

See http://www.opencellid.org

Table 5. Cell position
Property	Description	Type	Required	Example
`cellid`	Cell ID	integer	required	00B2350F
`lac`	Local area code	integer	required	00000884
`mcc`	Mobile country code	integer	required	208
`mnc`	Mobile network code	integer	required	01

GPS position (optional)

Table 6. GPS position (WGS84)
Property	Description	Type	Required	Example
`altitude`	Altitude	length	required	192.000000 (m)
`eph`	Standard deviation of horizontal position error	length	required	655.35 (m)
`epv`	Standard deviation of vertical position error	length	required	655.35 (m)
`latitude`	Latitude	angle	required	45.7597504 (degree)
`longitude`	Longitude	angle	required	4.9187880 (degree)

Device information

Table 7. Device information
Property	Description	Type	Required	Example
`build`	Build version	text	optional	20190104
`serial`	Serial number	integer	required	50000
`version`	Hardware version	text	optional	1.0

Drilling information

Table 8. Drilling information
Property	Description	Type	Required	Example
`bit_mass`	Drilling tool mass	mass	optional	10 (kg)
`fluid`	Drilling fluid	code (see below)	optional	DRLFLD_WTR
`holdback_area`	Surface of holdback pressure	area	optional	301 (cm2)
`machine_ref`	Drilling machine	text	optional	DCH 218
`method`	Drilling method	code (see below)	optional	DRLMTD_RTR
`rod_diameter`	Drilling rod diameter	length	optional	32 (mm)
`rod_mass`	Drilling rod mass	mass	optional	20 (kg)
`rod_length`	Drilling rod length	length	optional	4.5 (m)
`thrust_area`	Surface of thrust pressure	area	optional	401 (cm2)
`tool`	Drilling tool	code (see below)	optional	DRLBIT_CNTCI
`tool_diameter`	Drilling tool diameter	length	optional	150 (mm)
`torque_factor`	Torque factor	decimal	optional	112

Table 9. Drilling method codes
Drilling method	Description
`DRLMTD_HA`	Auger
`DRLMTD_CFA`	Continuous flight auger
`DRLMTD_ADM`	Auger with drilling mud
`DRLMTD_AUG`	Auger
`DRLMTD_HSA`	Hollow Stem Auger
`DRLMTD_OHD`	Open hole drilling
`DRLMTD_DTM`	Disintegrating tool with mud circulation
`DRLMTD_COR`	Core drilling
`DRLMTD_RTR`	Rotary drilling
`DRLMTD_RRFFM`	Rotary reverse flow of flushing medium
`DRLMTD_RTRPRC`	Rotary percussion
`DRLMTD_RPM`	Rotary percussion with mud
`DRLMTD_DTH`	Downhole hammer
`DRLMTD_DRI`	Driving
`DRLMTD_DS`	Driven sampler
`DRLMTD_PT`	Pushed tube
`DRLMTD_TWT`	Thin wall tube, pushed
`DRLMTD_DST`	Driven slotted tube
`DRLMTD_STDTM`	Slotted tube with inside disintegrating tool and mud circulation
`DRLMTD_CPD`	Cable percussion drilling
`DRLMTD_VDS`	Vibro driven sampler
`DRLMTD_VDT`	Vibro driven tube
`DRLMTD_VD`	Vibration drilling
`DRLMTD_VS`	Vibro-sinking
`DRLMTD_PS`	Push sampler
`DRLMTD_DT`	Driven tube
`DRLMTD_GRAB`	Grabbing Cable with grab
`DRLMTD_TP`	Trial-pit
`DRLMTD_SHFT`	Shaft

Table 10. Drilling tool (bit) codes
Drilling tool	Description
`DRLBIT_BLD`	Blade bit
`DRLBIT_BLD2`	2 Blades bit
`DRLBIT_BLD3`	3 Blades bit
`DRLBIT_BLD4`	4 Blades bit
`DRLBIT_BLDTIP`	Bladed tool tip
`DRLBIT_BLDTUB`	Bladed tool with tube topped
`DRLBIT_JET`	Jet bit
`DRLBIT_RTDK`	Rotary disk bit
`DRLBIT_FLTCHS`	Flat chisel
`DRLBIT_CRSCHS`	Cross chisel
`DRLBIT_STPCHS`	Cross Cut Step bit with TCI
`DRLBIT_BTT`	Buttons bit (Rotary percussion)
`DRLBIT_BTTDTH`	Buttons bit DTH
`DRLBIT_BTTODX`	Button bit ODEX
`DRLBIT_CTTPDC`	Cutter bit PDC (polycrystalline diamond compact)
`DRLBIT_CTTGHI`	Cutter bit GHI (grit hotpressed inserts)
`DRLBIT_STBB`	Stubber (heavy tool)
`DRLBIT_CACH`	California chisel bit
`DRLBIT_BICN`	Bicone bit
`DRLBIT_TRCN`	Tricone bit
`DRLBIT_CNST`	Tricone Steeltooth bit
`DRLBIT_CNTCI`	Tricone TCI (Tungsten Carbide Insert)
`DRLBIT_SPRL`	Spiral bit
`DRLBIT_AUG`	Auger
`DRLBIT_ABCK`	Auger with bucket
`DRLBIT_HA`	Hand Auger
`DRLBIT_CONE`	Cone
`DRLBIT_DPCN`	Dynamic probing cone
`DRLBIT_HSA`	Hollow Stem Auger
`DRLBIT_CFA`	Continuous Flight Auger
`DRLBIT_COR`	Core bit
`DRLBIT_TC`	Tungsten carbide set
`DRLBIT_GTS`	Geotechnical saw-tooth carbide set
`DRLBIT_PCD`	Polycrystalline diamond core bit
`DRLBIT_TSP`	Thermally stable polycrystalline set
`DRLBIT_STCB`	Single-tube corebarrel
`DRLBIT_DTCB`	Double-tube corebarrel
`DRLBIT_TTCB`	Triple-tube corebarrel
`DRLBIT_DTCBXT`	DD/TT corebarrel with extended inner tube
`DRLBIT_OSTW`	Open-sampler thin-walled (Shelby)
`DRLBIT_OSTKW`	Open-sampler thick-walled
`DRLBIT_HPS`	Hydraulic Piston samplers
`DRLBIT_PSTKW`	Piston samplers, thick-walled
`DRLBIT_PSTW`	Piston samplers, thin-walled
`DRLBIT_CPDS`	Bit with shell (or bailer)
`DRLBIT_CPDC`	Bit with clay cutter
`DRLBIT_CPSS`	Sectional shell

Table 11. Drilling fluid codes
Drilling fluid	Description
`DRLFLD_NONE`	No Fluid
`DRLFLD_AIR`	Air
`DRLFLD_WTR`	Water
`DRLFLD_AIRWTR`	Air-Water
`DRLFLD_AIRPLM`	Air-Polymer
`DRLFLD_WBM`	Water-based mud
`DRLFLD_WBMSHL`	Water-Shale-based mud
`DRLFLD_WBMPLM`	Dry-polymer-based mud
`DRLFLD_WBMLSF`	Lignosulfonate-based mud
`DRLFLD_WBMSEA`	Sea-Water-based mud
`DRLFLD_WBMNACL`	Saturated-Salt-based mud
`DRLFLD_WBMLIM`	Lime-based mud
`DRLFLD_WBMCLC`	Calcium-based mud
`DRLFLD_OBM`	Oil-based mud
`DRLFLD_SBM`	Synthetic-based mud

Field types (convention)

Each domain (see Domain ID) is described in description.xml by one <convention> element, carrying its own version="x.y" attribute. The version applies per convention, not to the file as a whole: two .bor files of different domains have independent version histories. Log names (the netCDF variable names in the data file) are scoped to their convention too - the same short name can mean different things in different conventions (e.g. EVP is an integer drilling event in the Drilling Parameters convention, but a string pump-state code in the Grouting convention). Never assume a log name’s meaning carries over across domains.

Table 12. Convention versions
Convention	Current version	Changelog
`parameters`	1.1	initial
`pressuremeter`	1.2	1.1 → 1.2: `thresholds`/`stop_cause` added; ground test’s `drilling_start_level`/`drilling_end_level`/`casing_foot_level` added
`grouting`	1.2	1.1 → 1.2: `<sections>` (plural) replaced by a single `<section>`; `pressure_loss`, `stage_number`, `grout_type` added
`lugeon`	1.1	no earlier version observed
`dynpen`	1.1	no earlier version observed

Drilling Parameters convention
Ménard Pressuremeter Test convention
Dynamic probing convention
Grouting convention
Lugeon convention

Drilling Parameters convention

Definition

Drilling Parameters convention combine drilling parameters recorded during drilling tool movement according to time or depth.

The convention is simply named parameters.

Three different field types are actually supported by this format. Each field type can have different phases.

Table 13. Parameters phases
Field type	Phase
Parameters recorded during drilling	`DRILL`
Jet grouting parameters recorded during drilling and injection	`JETDOWN, JETUP, PREJETDOWN, PREJETUP`
CFA Pile parameters recorded during drilling and concreting	`PILEDOWN, PILEUP`

Example of parameters convention

  <convention version="1.1">
    <parameters phase="DRILL">
      <inclination>
        <X unit="degree">171.9</X>
        <Y unit="degree">86.3</Y>
      </inclination>
      <effective_duration unit="s">59.40</effective_duration>
      <logfile>data.nc</logfile>
    </parameters>
  </convention>

Properties

Table 14. Parameters information
Property	Description	Type	Required	Example
`effective_duration`	Drilling effective duration (out of break)	duration	required	59.40 (s)
`inclination`	Tilt of the drill mast	structure (see below)	optional
`initial_volume`	Volume taken into account before starting the pile.	volume	optional	12 (l)
`logfile`	Name of data file	text	required	data.nc

Table 15. (Inclination) Tilt X encoder / Y encoder of the drilling machine mast (optional)
Property	Description	Type	Required	Example
`X`	inclination according to the X plane of the encoder	angle	required	171.9 (degree)
`Y`	inclination according to the Y plane of the encoder	angle	required	86.3 (degree)

Data file (logfile)

Data file is made with the netCDF (3.6+) format. They contain data logs and log names declarations (variables).

Example of data.nc dump

Example of data file from 50000240705140601D.bor (data.nc dump to data.cdl format)

Data.cdl example

netcdf data {
dimensions:
	time = UNLIMITED ; // (42 currently)
variables:
	float time(time) ;
		time:unit = "s" ;
		time:label = "Temps" ;
	float DEPTH(time) ;
		DEPTH:unit = "m" ;
		DEPTH:label = "Prof." ;
	float AS(time) ;
		AS:unit = "m/h" ;
		AS:label = "VA" ;
		AS:scale_max = 800.f ;
	int EVP(time) ;
		EVP:label = "evt-part" ;
	int EVR(time) ;
		EVR:label = "evt-new-rod" ;
	float TP(time) ;
		TP:unit = "bar" ;
		TP:label = "PO" ;
		TP:scale_max = 200.f ;
	float IP(time) ;
		IP:unit = "bar" ;
		IP:label = "PI" ;
		IP:scale_max = 20.f ;
	float TQ(time) ;
		TQ:unit = "bar" ;
		TQ:label = "CR" ;
		TQ:scale_max = 200.f ;
	float SP(time) ;
		SP:unit = "bar" ;
		SP:label = "PF" ;
		SP:scale_max = 0.f ;
data:

 time = 0, 11.8, 12.6, 12.8, 13.8, 14, 14.2, 15.2, 15.4, 16, 16.2, 16.4,
    16.8, 17.2, 17.4, 17.6, 17.8, 18.6, 19, 19.6, 20.2, 20.6, 21, 21.6, 22.2,
    22.6, 23.2, 23.6, 24.2, 24.6, 25.2, 25.6, 26, 26.2, 26.4, 26.8, 27, 27.2,
    27.4, 27.8, 48, 330.4 ;

 DEPTH = 0, 0.03, 0.04, 0.08, 0.09, 0.11, 0.12, 0.14, 0.16, 0.18, 0.2, 0.22,
    0.23, 0.24, 0.27, 0.3, 0.32, 0.34, 0.36, 0.37, 0.38, 0.39, 0.4, 0.41,
    0.42, 0.44, 0.45, 0.46, 0.47, 0.48, 0.5, 0.52, 0.53, 0.54, 0.55, 0.59,
    0.6, 0.63, 0.65, 0.66, 0.68, 0.7 ;

 AS = 0.6613566, 8.576679, 45.18072, 686.747, 39.75904, 445.7831, 192.7711,
    65.06024, 343.3735, 90.36144, 439.759, 391.5663, 93.3735, 99.39759,
    463.8554, 524.0964, 421.6867, 91.86747, 147.5904, 60.24096, 60.24096,
    93.3735, 93.3735, 68.27309, 80.32128, 117.4699, 76.30522, 90.36144,
    60.24096, 111.4458, 86.34538, 180.7229, 99.39759, 216.8675, 277.1084,
    280.1205, 331.3253, 457.8313, 409.6385, 105.4217, 3.459382, 6.024096 ;

 EVP = 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ;

 EVR = 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ;

 TP = 0, 62.35, 36.71, 73.34, 19.62, 66.01, 23.29, 70.89, 35.49, 9.86, 55.03,
    79.44, 4.98, 14.74, 62.35, 78.22, 80.66, 46.48, 79.44, 79.44, 81.88,
    81.88, 81.88, 81.88, 81.88, 79.44, 81.88, 81.88, 81.88, 81.88, 79.44,
    81.88, 78.22, 78.22, 80.66, 80.66, 80.66, 80.66, 80.66, 70.89, 61.13, 0 ;

 IP = 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ;

 TQ = 0, 78.22, 81.88, 81.88, 80.66, 80.66, 85.54, 80.66, 90.43, 90.43,
    85.54, 89.21, 103.85, 95.31, 90.43, 97.75, 109.96, 111.18, 119.72,
    124.61, 119.72, 113.62, 111.18, 105.07, 105.07, 109.96, 111.18, 111.18,
    113.62, 113.62, 113.62, 125.83, 135.59, 138.03, 138.03, 130.71, 130.71,
    128.27, 124.61, 150.24, 101.41, 0 ;

 SP = 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72,
    661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72,
    661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72,
    661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72, 661.72,
    661.72, 661.72, 661.72, 661.72, 661.72, 661.72 ;
}

Parameters Log names

Table 16. Drilling Parameters log names
Log name	Description	Type	Required	Remark
`time`	Measured time	float	required	dimension
`DEPTH`	Measured penetration length	float	required	variable
`AS`	Advance Speed (penetration rate)	float	required
`EVP`	Event Particular	integer	optional
`EVR`	Event new Rod	integer	optional
`EVS`	Event start relay	float	optional
`TP`	Tool pressure	float	optional
`TPAF`	Tool Pressure As a Force	float	optional
`TQ`	Rotation pressure (Torque)	float	optional
`TQC`	Casing Rotation pressure	float	optional
`TQAT`	Tool Torque As a Torque	float	optional
`TQCCW`	Torque pressure CounterClockWise	float	optional
`TQCW`	Torque pressure ClockWise	float	optional
`GEAR`	Gear engaged in the gearbox	float	optional
`RSP`	Rotation Speed	float	optional
`RSPC`	Casing Rotation Speed	float	optional
`RPI`	Rotation per Inch index	float	optional
`HP`	Holding Pressure	float	optional
`SP`	Striking Pressure	float	optional
`RV`	Reflected Vibration	float	optional
`WOB`	Weight on bit	float	optional
`SPECE`	Specific Energy	float	optional
`TOTE`	Total Energy	float	optional
`IP`	Injection pressure	float	optional
`IF`	Injection Flow (inlet flow)	float	optional
`OF`	Drilling fluid outflow (Outlet Flow)	float	optional
`IV`	Injection Volume	float	optional
`OV`	Outlet Volume	float	optional
`AP`	Air Pressure	float	optional
`AF`	Air Flow	float	optional
`AV`	Air Volume	float	optional
`WF`	Water Flow	float	optional
`WP`	Water Pressure	float	optional
`WV`	Water Volume	float	optional
`ECM`	Electrical Conductivity of Mud	float	optional
`PHM`	pH of Mud	float	optional
`DO2M`	Dissolved O2 in Mud	float	optional
`TEMPM`	Temperature of Mud	float	optional
`PP`	Pile Profile (PILEUP)	float	optional
`VB_X_RMS`	Vibration RMS, X axis	float	optional	m/s2
`VB_X_P2P`	Vibration peak-to-peak, X axis	float	optional	m/s2
`VB_Y_RMS`	Vibration RMS, Y axis	float	optional	m/s2
`VB_Y_P2P`	Vibration peak-to-peak, Y axis	float	optional	m/s2
`VB_Z_RMS`	Vibration RMS, Z axis	float	optional	m/s2
`VB_Z_P2P`	Vibration peak-to-peak, Z axis	float	optional	m/s2
`IV_OV_DIFF`	Difference between Injection Volume and Outlet Volume	float	optional

IAS (superseded by AS), VIC and ORN are historical log names, deprecated, and must not be written by new implementations.

Ménard Pressuremeter Test convention

Definition

Ménard Pressuremeter Test is performed by the radial expansion of a tricell probe placed in the ground. This test is specified by the standard ISO 22476-4.

The convention is simply named pressuremeter.

Three different pressuremeter test types are supported by this format.

Table 17. Ménard Pressuremeter Test types
Test type	Description
`ground`	Ménard pressuremeter test in natural soils
`volume_loss`	Equipment volume loss calibration test
`pressure_loss`	Probe pressure loss calibration test

ISO 22476-4:2015 cross-references: volume_loss corresponds to clause B.4.2 (calibration of the equipment’s own volume), pressure_loss to clause B.4.3 (calibration of the probe’s own resistance/inertia), and the ground test’s PR*/PG*/V* log names (1s/15s/30s/60s readings) follow the reading/recording procedure B of clause 5.7.1.

Example of Ménard Pressuremeter Test convention

Example of Ménard Pressuremeter Test convention (ground test type)

  <convention version="1.2">
    <pressuremeter>
      <cu_ref>CPVA001</cu_ref>
      <ground>
        <pressure_loss_filename>50001180101062101P.bor</pressure_loss_filename>
        <cu_height unit="m">1</cu_height>
        <test_depth unit="m">2</test_depth>
        <logfile>data.nc</logfile>
      </ground>
    </pressuremeter>
  </convention>

Common properties

Table 18. Pressuremeter common properties
Property	Description	Type	Required	Example
`cu_ref`	Control Unit ID	text	optional	CPVA001
`thresholds`	Stop and start thresholds	structure (see below)	optional
`stop_cause`	Stop cause	code (see below)	optional	MANUAL

Table 19. Thresholds (optional)
Property	Description	Type
`limit_volume`	Maximum volume to protect the probe	Quantity
`final_volume`	Volume at end of test	Quantity
`limit_pressure`	Maximum pressure to protect the probe	Quantity
`final_pressure`	Pressuree at end of test	Quantity

Table 20. Stop cause (optional)
Property	Description	Type
`MANUAL`	Manual stop	text
`LIMIT_PRESSURE`	Limit pressure stop	text
`LIMIT_VOLUME`	Limit volume stop	text
`FINAL_PRESSURE`	Final pressure stop	text
`FINAL_VOLUME`	Final volume stop	text
`EMERGENCY_STOP`	Emergency stop	text

Volume loss test

Volume loss example

  <convention version="1.2">
    <pressuremeter>
      <cu_ref>CPVA500</cu_ref>
      <thresholds>
        <limit_volume unit="cm3">630</limit_volume>
        <final_volume unit="cm3">550</final_volume>
        <limit_pressure unit="bar">55.00</limit_pressure>
        <final_pressure unit="bar">10.00</final_pressure>
      </thresholds>
      <stop_cause>MANUAL</stop_cause>
      <volume_loss>
        <cover_type>CVR_REINFORCED_MESH</cover_type>
        <probe_type>PRB_G</probe_type>
        <central_cell_diameter unit="mm">63</central_cell_diameter>
        <central_cell_length unit="mm">370</central_cell_length>
        <tubing_type>TUB_COAXIAL</tubing_type>
        <tubing_length unit="m">25</tubing_length>
        <calibration_cylinder_diameter unit="mm">66</calibration_cylinder_diameter>
        <membrane_pressure_loss unit="bar">0.54</membrane_pressure_loss>
        <slotted_tube>true</slotted_tube>
        <central_cell_diameter_inside_slotted_tube unit="mm">44</central_cell_diameter_inside_slotted_tube>
        <logfile>data.nc</logfile>
      </volume_loss>
    </pressuremeter>
  </convention>

Table 21. Volume loss properties
Property	Description	Type	Required	Example
`calibration_cylinder_diameter`	Calibration cylinder diameter	length	required	66 (mm)
`central_cell_diameter`	Central cell diameter	length	required	63 (mm)
`central_cell_diameter_inside_slotted_tube`	outer diameter of the inner part of the probe in the split tube	length	required	44 (mm)
`central_cell_length`	Central cell length	length	required	370 (mm)
`cover_type`	Cover type	code (see below)	required	CVR_REINFORCED_MESH
`membrane_pressure_loss`	Membrane pressure loss	pressure	required	0.54 (bar)
`probe_type`	Type of pressuremeter probe	code (see below)	required	PRB_G
`slotted_tube`	Slotted tube placed around the probe to protect it	boolean	required	true
`tubing_length`	Tubing length	length	required	25 (m)
`tubing_type`	Tubing type	code (see below)	required	TUB_COAXIAL
`logfile`	Name of data file	text	required	data.nc

Note

default values used when a device leaves these fields unset: cover_type defaults to CVR_RUBBER, probe_type defaults to PRB_G (the only type currently in use), calibration_cylinder_diameter defaults to 66mm, membrane_pressure_loss to its ISO nominal value of 0.054 MPa (0.54 bar, matching the example above). central_cell_diameter typically ranges 56-63mm; central_cell_length is one of two ISO values, 210mm (short) or 370mm (long).

Table 22. Cover type codes
Cover type	Description
`CVR_RUBBER`	Rubber
`CVR_REINFORCED_MESH`	Reinforced mesh
`CVR_METALIC_MESH`	Metallic mesh
`CVR_METALIC_STRIPS`	Metallic strips

Table 23. Probe type codes
Probe type	Description
`PRB_G`	Type of pressuremeter probe where the central measuring cell is formed by a dedicated membrane over which an external membrane is fitted to form the guard cells
`PRB_E`	Type of pressuremeter probe where the three cells are formed by three separate membranes in line

Table 24. Tubing type codes
Tubing type	Description
`TUB_TWIN`	Parallel lines
`TUB_COAXIAL`	Coaxial line

Pressure loss test

Pressure loss example

<convention version="1.2">
    <pressuremeter>
      <cu_ref>CPVA500</cu_ref>
      <thresholds>
        <limit_volume unit="cm3">630</limit_volume>
        <final_volume unit="cm3">550</final_volume>
        <limit_pressure unit="bar">45.00</limit_pressure>
        <final_pressure unit="bar">10.00</final_pressure>
      </thresholds>
      <stop_cause>MANUAL</stop_cause>
      <pressure_loss>
        <volume_loss_filename>50000240718101441P.bor</volume_loss_filename>
        <logfile>data.nc</logfile>
      </pressure_loss>
  </pressuremeter>
</convention>

Table 25. Pressure loss properties
Property	Description	Type	Required	Example
`volume_loss_filename`	Name of associated volume loss test	text	required	50000240718101441P.bor
`logfile`	Name of data file	text	required	data.nc

Ground test

Ground test example

  <convention version="1.2">
    <pressuremeter>
      <cu_ref>CPVA500</cu_ref>
      <thresholds>
        <limit_volume unit="cm3">630</limit_volume>
        <final_volume unit="cm3">550</final_volume>
        <limit_pressure unit="bar">45.00</limit_pressure>
        <final_pressure unit="bar">39.00</final_pressure>
      </thresholds>
      <stop_cause>MANUAL</stop_cause>
      <ground>
        <pressure_loss_filename>50000240718103320P.bor</pressure_loss_filename>
        <cu_height unit="m">1.5</cu_height>
        <test_depth unit="m">3</test_depth>
        <drilling_start_level unit="m">0</drilling_start_level>
        <drilling_end_level unit="m">3</drilling_end_level>
        <casing_foot_level unit="m">1</casing_foot_level>
        <logfile>data.nc</logfile>
      </ground>
    </pressuremeter>
  </convention>

Table 26. Ground properties
Property	Description	Type	Required	Example
`cu_height`	Height of the control unit relative to ground level	length	required	1 (m)
`pressure_loss_filename`	Name of associated pressure loss test	text	required	50001180101060101P.bor
`test_depth`	Depth of the test relative to ground level	length	required	2 (m)
`drilling_start_level`	Start of the drilling pass, relative to borehole mouth along the borehole axis	length	optional	0 (m)
`drilling_end_level`	End of the drilling pass, relative to borehole mouth along the borehole axis	length	optional	3 (m)
`casing_foot_level`	Casing foot level, relative to borehole mouth along the borehole axis	length	optional	1 (m)
`logfile`	Name of data file	text	required	data.nc

Data file

Data file is made with the netCDF (3.6+) format. They contain data logs and log names declarations (variables).

Example of data.nc dump

Example of data file (data.nc dump to data.cdl format)

Data.cdl example

netcdf data {
dimensions:
	time = UNLIMITED ; // (14 currently)
variables:
	float time(time) ;
		time:unit = "s" ;
		time:label = "time" ;
	int STEP(time) ;
		STEP:label = "Palier" ;
	float PR1(time) ;
		PR1:unit = "bar" ;
		PR1:label = "PR1S" ;
	float PR15(time) ;
		PR15:unit = "bar" ;
		PR15:label = "PR15S" ;
	float PR30(time) ;
		PR30:unit = "bar" ;
		PR30:label = "PR30S" ;
	float PR60(time) ;
		PR60:unit = "bar" ;
		PR60:label = "PR60S" ;
	float PG1(time) ;
		PG1:unit = "bar" ;
		PG1:label = "PG1S" ;
	float PG15(time) ;
		PG15:unit = "bar" ;
		PG15:label = "PG15S" ;
	float PG30(time) ;
		PG30:unit = "bar" ;
		PG30:label = "PG30S" ;
	float PG60(time) ;
		PG60:unit = "bar" ;
		PG60:label = "PG60S" ;
	float V1(time) ;
		V1:unit = "cm3" ;
		V1:label = "V1S" ;
	float V15(time) ;
		V15:unit = "cm3" ;
		V15:label = "V15S" ;
	float V30(time) ;
		V30:unit = "cm3" ;
		V30:label = "V30S" ;
	float V60(time) ;
		V60:unit = "cm3" ;
		V60:label = "V60S" ;
		V60:scale_max = 500.f ;
	float CREEP(time) ;
		CREEP:unit = "cm3" ;
		CREEP:label = "fluage" ;
	float DELT60(time) ;
		DELT60:unit = "cm3" ;
		DELT60:label = "delt60" ;
data:

 time = 80, 142, 205, 268, 330, 394, 456, 519, 582, 647, 711, 776, 840, 905 ;

 STEP = 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 ;

 PR1 = 0.06, 1.08, 1.81, 2.85, 4.01, 5.98, 7.96, 9.8, 13.87, 17.81, 22.05,
    25.77, 29.73, 33.8 ;

 PR15 = 0.06, 0.81, 1.81, 2.82, 3.86, 5.81, 7.82, 9.81, 13.82, 17.85, 21.75,
    25.75, 29.75, 33.76 ;

 PR30 = 0.03, 0.81, 1.82, 2.83, 3.84, 5.85, 7.82, 9.83, 13.82, 17.84, 21.78,
    25.75, 29.77, 33.75 ;

 PR60 = 0.04, 0.82, 1.82, 2.84, 3.86, 5.83, 7.83, 9.82, 13.84, 17.81, 21.76,
    25.75, 29.77, 33.75 ;

 PG1 = 0.11, 0.28, 1.31, 2.14, 3.17, 5.24, 7.14, 9.17, 13.21, 17.14, 21.14,
    25.15, 29.12, 33.09 ;

 PG15 = 0.1, 0.29, 1.18, 2.12, 3.15, 5.19, 7.18, 9.17, 13.15, 17.16, 21.06,
    25.09, 29.06, 33.08 ;

 PG30 = 0.09, 0.28, 1.19, 2.16, 3.17, 5.22, 7.17, 9.16, 13.14, 17.15, 21.1,
    25.08, 29.1, 33.06 ;

 PG60 = 0.08, 0.29, 1.17, 2.14, 3.17, 5.18, 7.18, 9.14, 13.15, 17.13, 21.09,
    25.08, 29.06, 33.08 ;

 V1 = 60, 103, 215, 257, 280, 303, 320, 335, 359, 386, 411, 441, 477, 518 ;

 V15 = 76, 149, 238, 266, 285, 307, 324, 339, 366, 392, 419, 452, 491, 532 ;

 V30 = 85, 176, 241, 268, 287, 308, 325, 340, 368, 395, 423, 457, 498, 540 ;

 V60 = 92, 198, 244, 270, 287, 309, 326, 342, 370, 397, 428, 463, 506, 550 ;

 CREEP = 7, 22, 3, 2, 0, 1, 1, 2, 2, 2, 5, 6, 8, 10 ;

 DELT60 = 92, 106, 46, 26, 17, 22, 17, 16, 28, 27, 31, 35, 43, 44 ;
}

Pressuremeter Log names

Table 27. Pressuremeter log names
Log name	Description	Type	Required	Remark
`time`	Measured time	float	required	NETCDF dimension
`STEP`	Step number	integer	required
`PR1`	Liquid pressure at 1 s ^[4]	float	required
`PR15`	Liquid pressure at 15 s ^[4]	float	required
`PR30`	Liquid pressure at 30 s ^[4]	float	required
`PR60`	Liquid pressure at 60 s ^[4]	float	required
`PG1`	Gas pressure at 1 s ^[5]	float	required
`PG15`	Gas pressure at 15 s ^[5]	float	required
`PG30`	Gas pressure at 30 s ^[5]	float	required
`PG60`	Gas pressure at 60 s ^[5]	float	required
`V1`	Volume of injected liquid at 1 s ^[6]	float	required
`V15`	Volume of injected liquid at 15 s ^[6]	float	required
`V30`	Volume of injected liquid at 30 s ^[6]	float	required
`V60`	Volume of injected liquid at 60 s ^[6]	float	required
`CREEP`	Difference in volumes recorded at 60 s and at 30 s at each pressure hold	float	required
`DELT60`	60 s injected volume change between successive pressure holds	float	required

Dynamic probing convention

Definition

Dynamic probing drives a rod string into the ground by repeated hammer blows and records the penetration per blow. The format covers Dynamic Probing (DP, standard/light/medium/heavy/super-heavy variants). Cross-reference: EN ISO 22476-2:2005 (Dynamic probing).

The convention is simply named dynpen, identified via the type attribute set to DPT for Dynamic Probing.

Example of dynpen convention

Example of dynpen convention (DPT)

  <convention version="1.1">
    <dynpen type="DPT">
      <dynamic_probing_type>DPSH-A</dynamic_probing_type>
      <anvil_type>DP_ANV_FIXED</anvil_type>
      <anvil_mass unit="kg">10</anvil_mass>
      <blow_count_frequency unit="min^-1">15</blow_count_frequency>
      <prec_again_rod_friction>DP_PARF_CSN</prec_again_rod_friction>
      <stop_cause>DP_STOP_DEPTH_REACHED</stop_cause>
      <hammer_mass unit="kg">63.5</hammer_mass>
      <drop_height unit="mm">760</drop_height>
      <actual_energy unit="kJ">476</actual_energy>
      <dpt>
        <cone_type>DP_CONE_DISPOSABLE</cone_type>
        <cone_angle unit="degree">5.00</cone_angle>
        <cone_nominal_base_area unit="cm2">10</cone_nominal_base_area>
        <cone_base_diameter_new unit="mm">20</cone_base_diameter_new>
        <cone_mantle_length unit="mm">59</cone_mantle_length>
        <cone_tip_length unit="mm">26</cone_tip_length>
      </dpt>
      <logfile>data.nc</logfile>
    </dynpen>
  </convention>

Common properties

Table 28. Dynpen properties
Property	Description	Type	Required	Example
`dynamic_probing_type`	DP variant	code: DPL/DPM/DPH/DPSH-A/DPSH-B	required	DPSH-A
`equipment_manufacturer`	Equipment manufacturer	text	optional
`hammer_mass`	Hammer mass	mass	required	63.5 (kg)
`anvil_mass`	Anvil mass	mass	required	6 (kg)
`anvil_type`	Anvil type	code: DP_ANV_FIXED/DP_ANV_UNFIXED	optional	DP_ANV_FIXED
`drop_height`	Hammer drop height	length	required	0.5 (m)
`blow_count_frequency`	Blow count frequency	frequency	optional
`prec_again_rod_friction`	Precaution taken against rod friction	code: DP_PARF_NONE/DP_PARF_MUD/DP_PARF_WTR/DP_PARF_CSN	optional	DP_PARF_WTR
`standard_increment`	Standard penetration increment	code: SI_*	optional	SI_200
`actual_energy`	Actual delivered energy	energy	optional
`stop_cause`	Stop cause (see below)	code (see below)	required	DP_STOP_DEPTH_REACHED
`logfile`	Name of data file	text	required	data.nc

Table 29. Stop cause codes
Stop cause	Description
`DP_STOP_DEPTH_REACHED`	Target depth reached
`DP_STOP_REFUSAL`	Refusal
`DP_STOP_FRICTION`	Excessive lateral friction
`DP_STOP_OVERBLOW_2X`	Blow count exceeds twice the maximum value
`DP_STOP_OVERBLOW_1M`	Maximum value exceeded continuously over 1 m of penetration
`DP_STOP_TECH_HITCH`	Technical hitch

drilling.method is restricted for this convention: DRLMTD_DRI or DRLMTD_CPD (reusing the generic drilling method codes, no new codes). drilling.rod_diameter (see the generic Drilling information table) is commonly present.

DPT properties (`dpt`)

Table 30. Dpt properties
Property	Description	Type	Required	Example
`cone_type`	Cone type	code: DP_CONE_FIXED/DP_CONE_DISPOSABLE	optional	DP_CONE_FIXED
`cone_angle`	Cone apex angle	angle	optional
`cone_nominal_base_area`	Cone nominal base area	area	optional
`cone_base_diameter_new`	Cone base diameter, unworn	length	optional
`cone_mantle_length`	Cone mantle length	length	optional
`cone_tip_length`	Cone tip length	length	optional

drilling.tool for DPT is DRLBIT_DPCN (Dynamic probing cone).

Data file

Data file is made with the netCDF (3.6+) format. They contain data logs and log names declarations (variables).

Example of data.nc dump

Example of data file (data.nc dump to data.cdl format)

Data.cdl example

netcdf data {
dimensions:
	time = UNLIMITED ; // (197 currently)
variables:
	float time(time) ;
		time:unit = "s" ;
		time:label = "time" ;
	float DEPTH(time) ;
		DEPTH:unit = "m" ;
		DEPTH:label = "Depth" ;
	int BC(time) ;
		BC:label = "Blow Count" ;
	float _DPC(time) ;
		_DPC:unit = "m" ;
		_DPC:label = "IPC" ;
		_DPC:scale_max = 1.f ;
	float TQ(time) ;
		TQ:unit = "kN.m" ;
		TQ:label = "TQ" ;
	int EVR(time) ;
		EVR:label = "evt-new-rod" ;
data:

 time = 0, 28.2, 30.8, 33.4, 36, 38.6, 41.2, 43.8, 46.4, 49, 51.6, 54.2,
    56.8, 59.4, 62, 64.6, 67.2, 69.8, 72.4, 75, 77.6, 80.2, 82.8, 85.4, 88,
    90.6, 93.2, 95.8, 98.4, 101, 103.6, 106.2, 108.8, 111.6, 114.2, 116.8,
    119.4, 122, 124.6, 127.2, 129.8, 132.4, 135, 137.6, 140.2, 142.8, 145.4,
    148, 150.6, 153.2, 155.8, 158.4, 161, 163.6, 166.2, 168.8, 171.4, 174,
    176.6, 179.2, 181.8, 184.4, 187, 189.6, 192.2, 194.8, 197.6, 200.2,
    370.8, 373.4, 376, 378.6, 381.2, 383.8, 386.6, 389.2, 391.8, 394.4, 397,
    399.6, 402.2, 404.8, 407.4, 410, 412.6, 415.2, 417.8, 420.4, 423, 425.6,
    428.2, 430.8, 433.4, 436, 438.6, 441.2, 443.8, 446.4, 449, 451.6, 454.2,
    456.8, 459.4, 462, 464.6, 467.2, 469.8, 472.4, 475, 477.6, 480.2, 482.8,
    485.4, 488, 490.6, 493.2, 495.8, 498.4, 501, 503.6, 506.2, 508.8, 511.4,
    643.8, 646.4, 649, 651.6, 654.2, 656.8, 659.4, 662, 664.6, 667.2, 669.8,
    672.4, 675, 677.6, 680.2, 682.8, 685.4, 688, 690.6, 693.2, 696, 698.6,
    701.2, 703.8, 706.4, 709, 711.6, 714.2, 876.2, 878.8, 881.4, 884, 886.6,
    889.2, 891.8, 894.4, 897, 899.6, 902.2, 904.8, 907.6, 910.2, 912.8,
    915.4, 920.6, 925.8, 936.2, 944, 951.8, 957, 967.4, 977.8, 988.2, 996,
    1016.8, 1024.6, 1048.199, 1063.8, 1074.2, 1095.2, 1105.6, 1142, 1163,
    1183.8, 1202.2, 1233.6, 1254.6, 1275.4, 1317.4, 1406.2, 1408.8, 1503,
    1518.8, 1685.6 ;

 DEPTH = 0, 0.02, 0.03, 0.05, 0.07, 0.08, 0.1, 0.11, 0.13, 0.14, 0.15, 0.17,
    0.18, 0.19, 0.21, 0.23, 0.24, 0.26, 0.28, 0.29, 0.3, 0.32, 0.33, 0.35,
    0.36, 0.38, 0.39, 0.4, 0.42, 0.43, 0.44, 0.46, 0.47, 0.48, 0.49, 0.51,
    0.52, 0.53, 0.54, 0.56, 0.57, 0.58, 0.6, 0.61, 0.62, 0.64, 0.65, 0.66,
    0.67, 0.69, 0.7, 0.72, 0.73, 0.74, 0.76, 0.77, 0.79, 0.8, 0.82, 0.84,
    0.85, 0.87, 0.88, 0.89, 0.91, 0.92, 0.94, 0.95, 0.97, 0.99, 1.01, 1.03,
    1.05, 1.07, 1.09, 1.1, 1.12, 1.14, 1.16, 1.17, 1.19, 1.21, 1.22, 1.24,
    1.25, 1.27, 1.28, 1.3, 1.31, 1.33, 1.35, 1.37, 1.38, 1.4, 1.41, 1.43,
    1.45, 1.46, 1.47, 1.49, 1.5, 1.52, 1.53, 1.55, 1.56, 1.58, 1.59, 1.61,
    1.62, 1.64, 1.65, 1.66, 1.68, 1.7, 1.72, 1.74, 1.76, 1.78, 1.81, 1.84,
    1.87, 1.9, 1.94, 1.98, 2.04, 2.08, 2.12, 2.17, 2.2, 2.24, 2.27, 2.31,
    2.34, 2.38, 2.41, 2.45, 2.49, 2.52, 2.56, 2.59, 2.63, 2.66, 2.69, 2.72,
    2.75, 2.79, 2.82, 2.85, 2.88, 2.91, 2.94, 2.97, 3.01, 3.05, 3.1, 3.14,
    3.19, 3.24, 3.3, 3.36, 3.42, 3.48, 3.54, 3.59, 3.63, 3.64, 3.65, 3.66,
    3.67, 3.68, 3.69, 3.7, 3.71, 3.72, 3.73, 3.74, 3.75, 3.76, 3.77, 3.78,
    3.79, 3.8, 3.81, 3.82, 3.83, 3.84, 3.85, 3.86, 3.87, 3.88, 3.89, 3.9,
    3.91, 3.92, 3.93, 3.94, 3.95 ;

 BC = 0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
    21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38,
    39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56,
    57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74,
    75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92,
    93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108,
    109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122,
    123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136,
    137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150,
    151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164,
    165, 166, 167, 169, 171, 175, 178, 181, 183, 187, 191, 195, 198, 206,
    209, 218, 224, 228, 236, 240, 254, 262, 270, 277, 289, 297, 305, 321,
    340, 341, 377, 383, 404 ;

 _DPC = 0.02, 0.02, 0.01, 0.02, 0.02, 0.01, 0.02, 0.01, 0.02, 0.01, 0.01,
    0.02, 0.01, 0.01, 0.02, 0.02, 0.01, 0.02, 0.02, 0.01, 0.01, 0.02, 0.01,
    0.02, 0.01, 0.02, 0.01, 0.01, 0.02, 0.01, 0.01, 0.02, 0.01, 0.01, 0.01,
    0.02, 0.01, 0.01, 0.01, 0.02, 0.01, 0.01, 0.02, 0.01, 0.01, 0.02, 0.01,
    0.01, 0.01, 0.02, 0.01, 0.02, 0.01, 0.01, 0.02, 0.01, 0.02, 0.01, 0.02,
    0.02, 0.01, 0.02, 0.01, 0.01, 0.02, 0.01, 0.02, 0.01, 0.02, 0.02, 0.02,
    0.02, 0.02, 0.02, 0.02, 0.01, 0.02, 0.02, 0.02, 0.01, 0.02, 0.02, 0.01,
    0.02, 0.01, 0.02, 0.01, 0.02, 0.01, 0.02, 0.02, 0.02, 0.01, 0.02, 0.01,
    0.02, 0.02, 0.01, 0.01, 0.02, 0.01, 0.02, 0.01, 0.02, 0.01, 0.02, 0.01,
    0.02, 0.01, 0.02, 0.01, 0.01, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.03,
    0.03, 0.03, 0.03, 0.04, 0.04, 0.06, 0.04, 0.04, 0.05, 0.03, 0.04, 0.03,
    0.04, 0.03, 0.04, 0.03, 0.04, 0.04, 0.03, 0.04, 0.03, 0.04, 0.03, 0.03,
    0.03, 0.03, 0.04, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.04, 0.04, 0.05,
    0.04, 0.05, 0.05, 0.06, 0.06, 0.06, 0.06, 0.06, 0.05, 0.04, 0.01, 0.01,
    0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01,
    0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01,
    0.01, 0.01, 0.01, 0.01, 0.01, 0 ;

 TQ = 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0 ;

 EVR = 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0 ;
}

Dynpen Log names

Table 31. Dynpen log names
Log name	Description	Type	Required
`DEPTH`	Measured penetration length	float	required
`BC`	Blow Count	integer	optional
`TQ`	Rotation pressure (Torque) ^[7]	float	optional
`EVR`	Event new Rod ^[7]	integer	optional

Devices may dump additional, vendor-specific variables (e.g. an underscore-prefixed _DPC) that are not part of this specification and must be ignored by readers.

Grouting convention

Definition

Grouting records the injection of a pumpable product (INJECTION) or a solid compaction product (COMPACTION) into the ground, in successive sections.

The convention is simply named grouting, selected via the method attribute on the root element: INJECTION or COMPACTION.

drilling is optional for this convention (real files commonly omit it); client is commonly present at the top level (see the generic non-specific technical information above).

Example of grouting convention

Example of grouting convention (INJECTION)

  <convention version="1.2">
    <grouting method="INJECTION">
      <thresholds>
        <volume unit="l">500</volume>
        <running_pressure unit="bar">20</running_pressure>
        <stopping_pressure unit="bar">40</stopping_pressure>
        <gin>1500</gin>
        <restart_number>2</restart_number>
        <suspend_duration unit="s">300</suspend_duration>
        <overpressure_coefficient>1.2</overpressure_coefficient>
        <strain_volume unit="l">50</strain_volume>
      </thresholds>
      <section>
        <pump>Pump 1</pump>
        <phase>First injection round</phase>
        <stop_cause>VOLUME</stop_cause>
        <bottom_depth unit="m">12</bottom_depth>
        <top_depth unit="m">10</top_depth>
        <residual_volume unit="l">5</residual_volume>
        <pressure_loss unit="bar">1.5</pressure_loss>
        <stage_number>1</stage_number>
        <grout_type>Cement grout</grout_type>
        <logfile>data.nc</logfile>
      </section>
    </grouting>
  </convention>

Note	convention 1.1 used a plural `<sections>` wrapper; convention 1.2 (current) uses a single `<section>` element directly.

Thresholds (optional)

Table 32. Thresholds properties
Property	Description	Type
`volume`	Volume threshold	Quantity
`running_pressure`	Running pressure threshold	Quantity
`stopping_pressure`	Stopping pressure threshold	Quantity
`gin`	GIN coefficient ^[8]	Quantity
`restart_number`	Number of restarts	integer
`suspend_duration`	Suspend duration	duration
`overpressure_coefficient`	Overpressure coefficient	decimal
`strain_volume`	Strain volume	Quantity

Section properties

Table 33. Section properties
Property	Description	Type	Required	Example
`pump`	Pump identification	text	required	Pump 1
`phase`	Injection round description	text	required	First injection round
`stop_cause`	Stop cause (see below)	code (see below)	required	VOLUME
`bottom_depth`	Bottom depth of the section, relative to borehole mouth along the borehole axis	length	optional	12 (m)
`top_depth`	Top depth of the section, relative to borehole mouth along the borehole axis	length	optional	10 (m)
`residual_volume`	Residual volume	volume	optional	5 (l)
`pressure_loss`	Pressure loss	pressure	optional	1.5 (bar)
`stage_number`	Stage number	integer	optional	1
`grout_type`	Grout type	text	optional	Cement grout
`logfile`	Name of data file	text	required	data.nc

Table 34. Stop cause codes
Stop cause	Description
`MANUAL`	Manual stop
`PRESSURE`	Pressure threshold reached
`VOLUME`	Volume threshold reached
`GIN`	GIN threshold reached

Data file

Data file is made with the netCDF (3.6+) format. They contain data logs and log names declarations (variables).

Grouting Log names

Table 35. Grouting log names
Log name	Description	Type	Required	Remark
`time`	Measured time	float	required	dimension
`IP`	Injection Pressure	float	required
`IF`	Injection Flow	float	required
`IV`	Injection Volume	float	required
`EVP`	Pump Event	char	optional	domain-specific: S=manual stop, C=criteria stop, A=auto start, M=manual start - not the same values as the Drilling Parameters convention’s integer `EVP`

Lugeon convention

Definition

A Lugeon test measures the water absorption of a borehole section under pressure via a packer, to characterize rock mass permeability.

The convention is simply named lugeon.

drilling is optional for this convention (real files commonly omit it).

Example of lugeon convention

  <convention version="1.1">
    <lugeon>
      <test_section_bottom unit="m">4</test_section_bottom>
      <test_section_top unit="m">3</test_section_top>
      <packer_length unit="m">1</packer_length>
      <packer_pressure unit="bar">50</packer_pressure>
      <packer_pressure_gauge_height unit="m">0</packer_pressure_gauge_height>
      <pressure_gauge_height unit="m">0.5</pressure_gauge_height>
      <logfile>data.nc</logfile>
    </lugeon>
  </convention>

Properties

Table 36. Lugeon properties
Property	Description	Type	Required	Example
`test_section_bottom`	Bottom of the tested section, relative to borehole mouth along the borehole axis	length	required	4 (m)
`test_section_top`	Top of the tested section, relative to borehole mouth along the borehole axis	length	required	3 (m)
`packer_length`	Packer length	length	required	1 (m)
`packer_pressure`	Packer inflation pressure	pressure	required	50 (bar)
`pressure_gauge_height`	Pressure gauge height relative to ground level ^[9]	length	required	0.5 (m)
`packer_pressure_gauge_height`	Packer pressure gauge height	length	optional	0 (m)
`HC`	Head loss / pressure loss in the tubing	pressure	optional
`logfile`	Name of data file	text	required	data.nc

Data file

Data file is made with the netCDF (3.6+) format. They contain data logs and log names declarations (variables).

Example of data.nc dump

Example of data file from 59987260909142909L.bor, variable declarations only (data.nc dump to data.cdl format, 22468 samples)

Data.cdl example

netcdf data {
dimensions:
	time = UNLIMITED ; // (22468 currently)
variables:
	float time(time) ;
		time:unit = "s" ;
		time:label = "Temps" ;
	float HP(time) ;
		HP:unit = "bar" ;
		HP:label = "Pm" ;
		HP:scale_max = 500.f ;
	float Q(time) ;
		Q:unit = "l/h" ;
		Q:label = "Qj" ;
		Q:scale_max = 500.f ;
	float V(time) ;
		V:unit = "l" ;
		V:label = "Volj" ;
		V:scale_max = 500.f ;
	int EST(time) ;
		EST:label = "evt-start" ;
	int ESP(time) ;
		ESP:label = "evt-stop" ;
}

Lugeon Log names

Table 37. Lugeon log names
Log name	Description	Type	Required
`time`	Measured time	float	required
`HP`	Head Pressure, applied at conditioner	float	required
`Q`	Instantaneous injected flow	float	required
`V`	Volume injected into the cavity	float	required
`EST`	Event Start	integer (0/1)	optional
`ESP`	Event Stop	integer (0/1)	optional

1. except for Ménard Pressuremeter Calibration Test

2. optional for the Grouting (G) and Lugeon (L) conventions

3. RGL,relative to ground level

4. Liquid pressure applied by the control unit indicator to the the central cell as read x s after the beginning of the pressure hold

5. Gas pressure applied by the control unit indicator to the guard cells as read x s after the beginning of the pressure hold

6. Volume injected in the central measuring cell as read x s after the beginning of the pressure hold

7. reusing the generic Drilling Parameters log names, see Parameters Log names

8. unitless in practice, despite the format allowing a unit attribute

9. can be negative, e.g. when the gauge sits below ground level

Introduction

File name example

Abilities

Format specification

Data file

Description file

Example of Description file

Non-specific technical information

Borehole information (optional)

Cell position (optional)

GPS position (optional)

Device information

Drilling information

Field types (convention)

Drilling Parameters convention

Definition

Example of parameters convention

Properties

Data file (logfile)

Example of data.nc dump

Parameters Log names

Ménard Pressuremeter Test convention

Definition

Example of Ménard Pressuremeter Test convention

Common properties

Volume loss test

Pressure loss test

Ground test

Data file

Example of data.nc dump

Pressuremeter Log names

Dynamic probing convention

Definition

Example of dynpen convention

Common properties

DPT properties (dpt)

Data file

Example of data.nc dump

Dynpen Log names

Grouting convention

Definition

Example of grouting convention

Thresholds (optional)

Section properties

Data file

Grouting Log names

Lugeon convention

Definition

Example of lugeon convention

Properties

Data file

Example of data.nc dump

Lugeon Log names

DPT properties (`dpt`)