Boring Log Viewer docs

Boring Log Viewer

Turn boring log data into a clean, consistent boring log drawing including a graphic log, USCS symbols, material descriptions, samples, blow counts, laboratory results and groundwater.

You give it the data for one boring including metadata, stratigraphy, soil descriptions, sample and specimen information, and it draws the boring log for you. It uses standard soil symbols, a depth scale, a legend and a header. You can download the result as an SVG or PNG image, or print it to PDF.

Boring log drawn from full-example.json
Drawn from full-example.json. Click to open full size.

Who it's for

The viewer was written for geotechnical engineers, engineering geologists, researchers and students who need to show boring logs. For example:

You don't need to be a programmer. If you can fill in a spreadsheet, you can write the data the viewer needs; the first tutorial walks through it. Or fill in the Excel template and open it directly.

Three ways to use it

What it draws

Columns with no data are left out, so a log with only layers is a narrow, simple drawing, and one with full laboratory data gets every column.

For a site with several borings, the web page keeps them in tabs and shows them on a map.

Where the data comes from

The viewer reads a boring log written in JSON, a plain-text format for structured data. JSON looks like this:

{
  "schema_version": "1.0",
  "units": { "length": "ft" },
  "layers": [
    { "top": 0, "bottom": 4,  "description": "Brown, loose, moist, silty SAND" },
    { "top": 4, "bottom": 12, "description": "Gray, soft, wet, lean CLAY" }
  ]
}

That's a complete boring log: two layers, with depths in feet. Everything else (samples, blow counts, lab data, groundwater) is optional and added the same way. The data format reference lists every field.

If your data isn't in JSON, three translators write the JSON for you:

FormatWhereDetails
Excel workbook laid out like the template, one sheet per part of the logWeb pageExcel workbooks
AGS4 (common in the UK and internationally)Web page and APIImporting AGS4 and DIGGS
DIGGS XML (used by several US state DOTs)Web page and APIImporting AGS4 and DIGGS

Each one converts the file to the same JSON, which you can then check, edit and save.

New here?

Start with Your first boring log. It takes about ten minutes and builds a complete log in three steps.