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
| Option | On the web page | Default | What it does |
|---|---|---|---|
units | Units | as in the data | Display 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 units | Display unit weight in kN/m3 or pcf |
diameter_units | – | follows units | Display diameters in mm, cm, m, in or ft |
width | Width | layout's, else 800 | Width 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 | – | 500 | Starting 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_text | Fit text | on | Stretch the depth scale so sample rows line up with their symbols and descriptions fit (see why the depth scale stretches) |
header | Header | on | The header box above the log |
legend | Legend | on | The legend below the log |
references | References | on | The references, in the header (or below the legend if the header is off) |
hide_empty_columns | Hide empty columns | on | Leave out columns with no data |
columns | Layout… | layout's, else see below | Which columns to draw, in order |
title | – | boring name | Title text |
font_size | Layout… | layout's, else 10 | Text size in px |
infer_uscs | – | on | Read USCS symbols from descriptions: shown in parentheses for layers without one, and compared with the ones given |
infer_materials | – | on | Draw fill, pavement, rock and other materials named in descriptions |
depth_range | – | whole boring | Draw only part of the boring, [top, bottom] in display units (JavaScript only) |
id_prefix | – | automatic | Prefix 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
- For a page in a report, a
widthof 800 to 1000 px works well. Give more width when descriptions are long or there are many lab columns. - To draw several borings at the same depth scale (e.g. for a fence diagram or a side-by-side comparison), turn off
fit_textand give the samescaleto each, e.g.scale=40for 40 px per foot. - With
fit_textoff and noscale, the log body isheightpx tall whatever the boring depth.
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.