Boring Log Viewer docs

Importing AGS4 and DIGGS

Open a standard geotechnical data file and the borings in it are drawn, with no conversion on your part.

How to open a file

  1. On the viewer page, click Open files…, or drag the file onto the text box.
  2. Each borehole with strata opens as its own log, in its own tab (see Several logs and the map).
  3. The file is converted to the viewer's JSON, which appears in the text box, and the log is drawn. A note above the text box reports anything that couldn't be read.

The conversion runs in your browser; the file isn't uploaded. You can edit the converted JSON like any other log, for example to fix a description or add a reference, and save it for later.

From a script, send the file to the render API instead.

AGS4

AGS4 is the data transfer format of the Association of Geotechnical and Geoenvironmental Specialists, used in the UK and many other countries. Each borehole (LOCA_ID) becomes one log. Depths are taken as meters unless the file's UNIT row for GEOL_TOP (or LOCA_FDEP) says ft. Use the Units option to display them in the other unit.

AGS4 groupBecomes
PROJ, LOCA, HDIAHeader: project, site, ground level, dates, hole type (spelled out with the ABBR group, e.g. CP = Cable percussion), driller, latitude and longitude when given, remarks, hole diameter
GEOLLayers (GEOL_DESC). A row without a base depth ends at the hole's final depth (LOCA_FDEP), without a warning; it is left out, with a warning, only if it then has no thickness.
DETLDepth notes
SAMPSamples. B/LB = Bulk, BLK = Block, D = Disturbed, U/UT/TW = Shelby, P = Piston, SPT, C = Core, WS = Direct push. Other types (ES, W...) are drawn as Other, with the type in the sample number ("3 ES"). A sample with only a top depth is drawn 0.15 m long (0.45 m for an SPT). SAMP_DESC and SAMP_REM together become its remarks, and SAMP_RECV its recovery (already a percent).
ISPTSPT N-values (ISPT_NVAL, or the main drive of a refusal such as "50/150mm"), blows per 150 mm increment (from the six 75 mm increments), energy ratio
LNMC, LLPL, GRAG, LDEN, LPDNWater content, liquid and plastic limits (NP = non-plastic), fines content, dry unit weight (from dry density), specific gravity. Each is matched to its sample, and put on a specimen: one per SPEC_REF and SPEC_DPTH.
WSTG (and AGS3-style WSTK)Groundwater: water strikes

"MADE GROUND", the British term for fill, is drawn with the fill symbol. AGS3 files aren't supported and are rejected with a message. The import was tested on 48 boreholes from the British Geological Survey's National Geoscience Data Centre.

DIGGS

DIGGS (Data Interchange for Geotechnical and Geoenvironmental Specialists, diggsml.org) is an XML format used by several US state DOTs. Versions 2.5, 2.6 and 3.x are read. Each Borehole (also TestPit and Trench) becomes one log; CPT soundings are skipped.

DIGGSBecomes
Project, BoreholeHeader: project, boring name, latitude, longitude and elevation, dates, drilling method and rig, logger and drilling contractor, remarks
Linear referencingThe log's length unit (ft or m), per borehole
LithologyObservationLayers, from the description, or one built from consistency, color, constituents and moisture. USCS from the classification code. An observation at a single depth inside a layer becomes a depth note.
SamplingActivitySamples: SPT, Shelby, core sizes, bulk and so on, with the recovered length converted to a percent of the sample length
Test resultsSPT N-value and blows per increment; water content, liquid and plastic limits, non-plastic, fines, dry density (as unit weight), specific gravity, USCS. Matched to samples by reference, or else by depth, and put on the specimen they name (or one specimen per tested interval); a USCS result goes on the sample.
WaterStrikeGroundwater

Tested on the official DIGGS examples, including the Ohio DOT projects (13 borings).

If something is missing

Different programs fill these formats in different ways. If a value you expect isn't on the log, check the converted JSON in the text box: if it's there, see the data format reference for where it's drawn; if it isn't, the file may store it in a group or property the import doesn't read. Please open an issue with an example file (with any confidential data removed) and we'll look at adding it.