Boring Log Viewer docs

Display options

Options change how a log is drawn without changing its data. Most are buttons and checkboxes on the web page; all of them can be given to the API or the JavaScript module.

A log can also carry its own layout: its columns, widths, headings, width and font size. Options given when it's drawn take precedence over the layout, except that the web page keeps a layout's width.

All options

OptionOn the web pageDefaultWhat it does
unitsUnitsas in the dataDisplay lengths in m or ft. Unit weights and diameters follow (kN/m³ and mm, or pcf and in) unless set below, but only when this changes the data's length unit; otherwise they stay in the data's own units.
unit_weight–follows unitsDisplay unit weight in kN/m3 or pcf
diameter_units–follows unitsDisplay diameters in mm, cm, m, in or ft
widthWidthlayout's, else 800Width of the drawing in px. It's widened automatically if the text columns would be too narrow, except when the log has a layout: then the columns share the width given.
height–500Starting height of the log body in px (before Fit text stretches it)
scale––Fixed depth scale, in px per metre or foot. Overrides height.
fit_textFit textonStretch the depth scale so sample rows line up with their symbols and descriptions fit (see why the depth scale stretches)
headerHeaderonThe header box above the log
legendLegendonThe legend below the log
referencesReferencesonThe references, in the header (or below the legend if the header is off)
hide_empty_columnsHide empty columnsonLeave out columns with no data
columnsLayout…layout's, else see belowWhich columns to draw, in order
title–boring nameTitle text
font_sizeLayout…layout's, else 10Text size in px
infer_uscs–onRead USCS symbols from descriptions: shown in parentheses for layers without one, and compared with the ones given
infer_materials–onDraw fill, pavement, rock and other materials named in descriptions
depth_range–whole boringDraw only part of the boring, [top, bottom] in display units (JavaScript only)
id_prefix–automaticPrefix for ids inside the SVG; only needed in unusual cases where several logs share a web page

Units

The data can be in one system and the drawing in another. A boring entered in feet can be drawn in metres by choosing Metric on the web page, or units=m in the API. Every depth, elevation, unit weight and diameter is converted; percentages and blow counts aren't affected.

Size and depth scale

Choosing columns

The default columns, in order:

depth, elevation, groundwater, graphic, uscs, description,
sample_type, sample_name, sampler_diameter, blow_count,
specimen, specimen_name,
water_content, total_unit_weight, dry_unit_weight, specific_gravity, fines_content, liquid_limit, plastic_limit, specimen_uscs,
remarks

There is one more column, energy_ratio, for a per-sample hammer energy ratio. It isn't in the default list, so add it where you want it. For example, a log with only the field data:

columns=depth,graphic,uscs,description,sample_type,sample_name,blow_count,energy_ratio

With hide_empty_columns on (the default), listed columns that have no data are still left out. To change headings and widths, or add columns of your own, use a layout.

Symbol inference

infer_uscs and infer_materials control the two kinds of reading described in how the symbol is chosen and checking recorded symbols. Turn them off when your data already gives a uscs or hatch for every layer and you don't want the descriptions second-guessed.