BOR format lithology extension (draft) : Bor extension

Note	This draft extension is not yet implemented in any device or reader. Codes, cardinalities and field names may still change.

Note

water_event uses depth rather than top_depth/bottom_depth (Hervé’s suggestion): a water event occurs at a single depth.
casings moved under <drilling>, not <borehole>.
Kept WE_INFLOW: whether an inflow is an initial inflow or follows a water loss can be deduced from the event sequence.
Dropped the WE_RETURN code: not worth the extra complexity for the driller.
total_depth stays under <drilling>, independent of lithologies (Pierrick & Salem): it is useful whether or not lithology data is recorded.
Dropped MAT_PVC from casing material codes (Hervé): per Thierry, advance casing during drilling is always steel and removed at the end, so MAT_PVC never applies there.
Code and terminology corrections (Salem): GDTP_GRAVELS → GDTP_GRAVEL; COL_GREY → COL_GRAY; MC_VACUOLAR → MC_VESICULAR.
Dropped MAT_NONE from casing material codes (Pierrick).
Reverted characteristic back to main_characteristic (Pierrick & Hervé).
Dropped bottom_depth from lithology (Pierrick, after discussion with Hervé): layers are now contiguous, described by their own top_depth only.

Example description.xml excerpt

  <borehole>
    <borehole_diameter unit="mm">160</borehole_diameter>
    <borehole_inclination unit="degree">0</borehole_inclination>
    <water_depth unit="m">0.1</water_depth>
    <lithologies>
      <lithology>
        <top_depth unit="m">0</top_depth>
        <ground_type>GDTP_CLAY</ground_type>
        <main_characteristic>MC_COARSE</main_characteristic>
        <color>COL_WHITE</color>
      </lithology>
      <lithology>
        <top_depth unit="m">1.8</top_depth>
        <ground_type>GDTP_LIMESTONE</ground_type>
      </lithology>
    </lithologies>
    <equipments>
      <equipment type="EQ_PIEZO">
        <start_depth unit="m">1.43</start_depth>
        <active_length unit="m">1.00</active_length>
        <outer_diameter unit="mm">66</outer_diameter>
      </equipment>
    </equipments>
    <comment>The equipment should be checked once a year</comment>
  </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>
    <total_depth unit="m">8.0</total_depth>
    <casings>
      <casing>
        <top_depth unit="m">0</top_depth>
        <bottom_depth unit="m">1.8</bottom_depth>
        <outer_diameter unit="mm">66</outer_diameter>
        <material>MAT_STEEL</material>
      </casing>
    </casings>
    <water_events>
      <water_event type="WE_LOSS">
        <depth unit="m">4.2</depth>
      </water_event>
      <water_event type="WE_INFLOW">
        <depth unit="m">6.3</depth>
      </water_event>
    </water_events>
  </drilling>

Additions to borehole information

Table 1. New borehole information properties
Property	Description	Type	Required
`comment`	Free-text comment ^[1]	text	optional
`equipments`	Borehole equipment information (see below)	structure (see below)	optional
`lithologies`	Lithology information (see below)	structure (see below)	optional

Lithology (optional)

lithologies contains one or more lithology elements, each describing a ground layer. Depth is measured from the borehole mouth along the borehole axis, using the convention defined for grouting sections in the main specification. Layers are contiguous, in depth order: a layer extends from its own top_depth down to the next layer’s top_depth, or to total_depth for the last layer.

Table 2. Lithology properties
Property	Description	Type	Required	Example
`top_depth`	Top depth of the layer, relative to the borehole mouth along the borehole axis	length	required	0 (m)
`ground_type`	Ground type (see below)	code (see below)	required	GDTP_CLAY
`main_characteristic`	Main characteristic of the ground (see below)	code (see below)	optional	MC_COARSE
`color`	Ground color (see below)	code (see below)	optional	COL_WHITE

Table 3. Ground type codes
Ground type	Description
`GDTP_ASPHALT`	Asphalt
`GDTP_CONCRETE_MASONRY`	Concrete-masonry
`GDTP_BACKFILL_SCREE`	Backfill-scree
`GDTP_SURFACE_SOIL`	Surface soil
`GDTP_MUD`	Mud
`GDTP_SILT`	Silt
`GDTP_ALLUVIUM`	Alluvium
`GDTP_SAND`	Sand
`GDTP_GRAVEL`	Gravel
`GDTP_PEBBLES`	Pebbles
`GDTP_BLOCKS`	Blocks
`GDTP_MORAINE`	Moraine
`GDTP_CLAY`	Clay
`GDTP_LIMESTONE`	Limestone
`GDTP_CHALK`	Chalk
`GDTP_MARL`	Marl
`GDTP_MARL_LIMESTONE`	Marl-limestone
`GDTP_CORAL`	Coral
`GDTP_SANDSTONE`	Sandstone
`GDTP_CONGLOMERATE`	Conglomerate
`GDTP_BRECCIA`	Breccia
`GDTP_SLATE_SCHIST`	Slate-schist
`GDTP_GNEISS`	Gneiss
`GDTP_GRANITIC_ROCK`	Granitic rock
`GDTP_VOLCANIC_ROCK`	Volcanic rock
`GDTP_GYPSUM`	Gypsum
`GDTP_SALT`	Salt
`GDTP_BAUXITE`	Bauxite
`GDTP_LATERITE`	Laterite
`GDTP_PEAT`	Peat
`GDTP_COAL`	Coal
`GDTP_VOID`	Void (cavity)

Table 4. Main ground characteristic codes
Characteristic	Description
`MC_NONE`	None
`MC_FINE`	Fine
`MC_MEDIUM`	Medium
`MC_COARSE`	Coarse
`MC_EARTHY`	Earthy
`MC_CLAYEY`	Clayey
`MC_SILTY`	Silty
`MC_SANDY`	Sandy
`MC_GRAVELLY`	Gravelly
`MC_PEBBLY`	Pebbly
`MC_FLINTY`	Flinty
`MC_WITH_BLOCKS`	With blocks
`MC_SOFT`	Soft
`MC_COMPACT`	Compact
`MC_FISSURED`	Fissured
`MC_FRACTURED`	Fractured
`MC_ALTERED`	Altered
`MC_VESICULAR`	Vesicular
`MC_FOSSILIFEROUS`	Fossiliferous
`MC_VARIEGATED`	Variegated
`MC_DECOMPRESSED`	Decompressed
`MC_OPEN`	Open
`MC_FILLED`	Filled

Table 5. Ground color codes
Color	Description
`COL_NONE`	None
`COL_WHITE`	White
`COL_BEIGE`	Beige
`COL_GREENISH`	Greenish
`COL_REDDISH`	Reddish
`COL_BLACK`	Black
`COL_BROWN`	Brown
`COL_YELLOWISH`	Yellowish
`COL_PURPLISH`	Purplish
`COL_GRAY`	Gray
`COL_REDDISH_BROWN`	Reddish brown
`COL_ORANGE`	Orange
`COL_BLUISH`	Bluish

Borehole equipment (optional)

equipments contains one or more equipment elements, describing hardware left in place in the borehole (e.g. a piezometer or inclinometer).

Table 6. Borehole equipment properties
Property	Description	Type	Required	Example
`type`	Equipment type (see below), specified as an XML attribute	code (see below)	required	EQ_PIEZO
`start_depth`	Depth to the top of the equipment, relative to the borehole mouth along the borehole axis	length	required	1.43 (m)
`active_length`	Length of borehole covered by the equipment’s active part	length	required	1.00 (m)
`outer_diameter`	Equipment outer diameter	length	required	66 (mm)

Table 7. Borehole equipment type codes
Equipment type	Description
`EQ_PIEZO`	Piezometer
`EQ_INCLINO`	Inclinometer
`EQ_EXTENSO`	Extensometer
`EQ_PENDULUM`	Pendulum

Additions to drilling information

Table 8. New drilling information properties
Property	Description	Type	Required	Example
`casings`	Casing information (see below)	structure (see below)	optional
`total_depth`	Total depth reached by drilling	length	optional	8.0 (m)
`water_events`	Water event information (see below)	structure (see below)	optional

Casing (optional)

casings describes temporary steel casing used to support loose ground during drilling and removed once drilling is complete. It belongs under <drilling>.

casings contains one or more casing elements. top_depth/bottom_depth use the same depth datum as lithology’s top_depth: relative to the borehole mouth along the borehole axis.

Table 9. Casing properties
Property	Description	Type	Required	Example
`top_depth`	Top depth of the casing, relative to the borehole mouth along the borehole axis	length	required	0 (m)
`bottom_depth`	Bottom depth of the casing, relative to the borehole mouth along the borehole axis	length	required	1.8 (m)
`outer_diameter`	Casing outer diameter	length	required	66 (mm)
`material`	Casing material (see below)	code (see below)	required	MAT_STEEL

Table 10. Casing material codes
Material	Description
`MAT_STEEL`	Steel

Water event (optional)

water_events contains one or more water_event elements, sorted by depth. Each event records a water loss or inflow encountered during drilling at a given depth. The water level observed in the completed borehole is recorded separately in borehole/water_depth.

Table 11. Water event properties
Property	Description	Type	Required	Example
`type`	Water event type (see below), specified as an XML attribute	code (see below)	required	WE_LOSS
`depth`	Depth at which the water event occurred, relative to the borehole mouth along the borehole axis ^[2]	length	required	4.2 (m)

Table 12. Water event type codes
Water event type	Description
`WE_LOSS`	Water loss
`WE_INFLOW`	Water inflow

1. no special characters, 200 characters max

2. must be unique within water_events