Boring Log Viewer docs

Graphic log and soil symbols

How each layer's symbol is chosen, and every built-in symbol the viewer can draw.

How the symbol is chosen

For each layer, the viewer uses the first of these that applies:

  1. The layer's hatch, if you give one. "hatch": "none" leaves the layer blank.
  2. A material named in the description, such as fill, asphalt, concrete, topsoil, no recovery, or a rock name ("SHALE, black, hard"). Fill describes where the soil came from, so it wins over the soil type: a layer described as "silty SAND (FILL)" with "uscs": "SM" is drawn with the fill symbol, and SM still appears in the USCS column.
  3. The layer's uscs symbol.
  4. A USCS symbol worked out from the description, such as SM from "silty SAND". It's also shown in the USCS column, in parentheses.

If none of these applies, the layer has no symbol and its graphic log is left blank.

Want full control?

Give every layer a uscs or hatch. To stop materials being picked out of descriptions, turn off infer_materials; to stop symbols being read from descriptions (both inferred and checked), turn off infer_uscs. Both are display options.

Examples

This is what the viewer does with each description when the layer has no uscs or hatch. (This table is produced by the viewer's own code, so it's always up to date.)

DescriptionGraphic log drawsUSCS column shows
Brown silty SAND SM Silty sand(SM)
Gray, stiff, moist, lean CLAY, low plasticity CL Lean clay(CL)
fat CLAY with sand CH Fat clay(CH)
poorly graded SAND with silt SP-SM Poorly graded sand with silt(SP-SM)
Brown sandy lean CLAY (CL) CL Lean clay(CL)
silty clay CL-ML Silty clay(CL-ML)
organic SILT, high plasticity OH Organic silt or clay (high plasticity)(OH)
SAND, fine to mediumnoneblank
clayey SILTnoneblank
lean to fat CLAYnoneblank
FILL: silty sand, loose FILL Fill(SM)
Dark gray silty SAND (HYDRAULIC FILL) FILL_HYD Hydraulic fill(SM)
ASPHALT concrete, 100 mm ASPHALT Asphalt pavementblank
Topsoil, dark brown, organic silt with roots TOPSOIL Topsoilblank
silty SAND with trace shells SM Silty sand(SM)
coarse pumice SANDnoneblank
SHALE, black, hard SHALE Shaleblank
rock, clay CLAYSTONE Claystoneblank
No recovery NO_RECOVERY No recoveryblank

When a USCS symbol is inferred

A symbol is inferred only when the soil description provides adequate information:

If a soil description doesn't contain adequate information, the viewer doesn't assign a USCS symbol. For example, "SAND, fine to medium" doesn't contain gradation and/or plasticity information required to classify it as SP, SW, SM, SC, or a dual symbol. Similarly, "clayey SILT" doesn't say enough to classify the soil as ML or MH, so the viewer doesn't assign a symbol. A heading such as "GRAVEL AND SAND:" that names two different soil types is skipped, and the soil described after it is used.

When a material is picked out

A material counts only when it is the principal material of the description:

A minor constituent never counts: "silty SAND with trace shells" is sand. A soil named in capitals wins over a material that isn't: "coarse pumice SAND" is sand. Bentonite is drawn as CH.

Checking recorded symbols

A uscs you give is checked too, because logs (especially older ones) sometimes have symbols that can't be right, or that disagree with their own description. When that happens, the log shows both, so a reader can see the discrepancy: the recorded symbol, with the one read from the description below it in parentheses. The validator also gives a warning for each.

Recorded uscsDescriptionUSCS column showsGraphic log drawsWhy
SMsilty SANDSM SMAgrees with the description
SP-SMsilty SANDSP-SM SP-SMAgrees with the description
CL/CHlean CLAYCL/CH CL-CHAgrees with the description
SP-SMwell graded SANDSP-SM over (SW) SP-SMThe description reads as a different symbol (warning)
SPsandy SILTSP over (ML) SPThe description reads as a different symbol (warning)
GW-GPpoorly graded GRAVELGW-GP over (GP) GW-GPNot a possible USCS symbol (warning)
SM-Gsilty SAND with gravelSM-G over (SM) SMNot a possible USCS symbol (warning)

The graphic log uses the recorded symbol when it's a real one. For an impossible value, it uses the real group symbols it contains, such as SM for SM-G. Turning off infer_uscs stops the comparison with descriptions; an impossible symbol is still noted.

USCS symbols

The soil symbols follow the legend of the Caltrans Soil and Rock Logging, Classification, and Presentation Manual (2010).

Dual symbols

Coarse-grained dual symbols (5 to 12% fines) are drawn as one Caltrans-style tile: the coarse soil's pattern with a lighter silt or clay pattern over it.

Other pairs, such as CL-ML (silty clay), ML/CL or SP-FILL, or a pair where one half is your own pattern, are drawn with the column split in half: the first symbol on the left, the second on the right. You can write a pair with - or /.

Materials and rock

To use one of these, set the layer's hatch to its code, for example "hatch": "SANDSTONE". They can also be paired with each other or with a USCS symbol: "hatch": "SP-FILL". Rock patterns follow the FGDC Digital Cartographic Standard for Geologic Map Symbolization (FGDC-STD-013-2006, section 37), drawn at a density that reads in a narrow column.

Fill and man-made

Natural materials

Non-material intervals

Rock: category

Rock: transitional

Rock: sedimentary (clastic)

Rock: sedimentary (chemical/organic)

Rock: igneous (intrusive)

Rock: igneous (extrusive)

Rock: igneous (pyroclastic)

Rock: metamorphic (foliated)

Rock: metamorphic (non-foliated)

Rock: fault rock

Need a symbol that isn't here, or want your office's own version of one? See Your own hatches.