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:
- The layer's
hatch, if you give one."hatch": "none"leaves the layer blank. - 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. - The layer's
uscssymbol. - 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.
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.)
| Description | Graphic log draws | USCS 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 medium | none | blank |
| clayey SILT | none | blank |
| lean to fat CLAY | none | blank |
| FILL: silty sand, loose | FILL Fill | (SM) |
| Dark gray silty SAND (HYDRAULIC FILL) | FILL_HYD Hydraulic fill | (SM) |
| ASPHALT concrete, 100 mm | ASPHALT Asphalt pavement | blank |
| Topsoil, dark brown, organic silt with roots | TOPSOIL Topsoil | blank |
| silty SAND with trace shells | SM Silty sand | (SM) |
| coarse pumice SAND | none | blank |
| SHALE, black, hard | SHALE Shale | blank |
| rock, clay | CLAYSTONE Claystone | blank |
| No recovery | NO_RECOVERY No recovery | blank |
When a USCS symbol is inferred
A symbol is inferred only when the soil description provides adequate information:
- a symbol written in the text, such as "(SP-SM)";
- an ASTM D2487 group name, such as "fat CLAY", "silty SAND" or "poorly graded SAND with silt";
- CLAY or SILT with a plasticity descriptor ("CLAY, high plasticity");
- "silty clay" (CL-ML), SILT group names (ML), and organic SILT or CLAY with low (OL) or high (OH) plasticity.
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:
- Fill: as the main material ("FILL"), as a leading label ("FILL: silty sand"), or as an origin tag ("(HYDRAULIC FILL)"). Hydraulic, engineered and undocumented fill have their own symbols. British "MADE GROUND" is fill too.
- Pavement and base: asphalt, concrete, aggregate base course.
- Other materials: topsoil, shells, cobbles and boulders, wood, ash, pumice, loam and others in the table below.
- No recovery or core loss, when no soil is named.
- Rock names: "SHALE, black, hard", "Weathered GRANITE". "rock, clay" is claystone.
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.
- Not a possible symbol. ASTM D2487 dual symbols are the ten shown below plus CL-ML (in either order, e.g. SM-SP), and borderline soils are written with "/" (CL/CH). Something like
GW-GPorSM-Gis accepted, but flagged. - The description reads differently.
SP-SMon a "well graded SAND" is flagged, because the description says SW. - Agreement is read generously. A recorded symbol that includes the one read from the description counts as agreeing: a dual (SP-SM for "silty SAND"), a dual in the other order (ML-CL), or a borderline symbol (CL/CH for "lean CLAY").
Recorded uscs | Description | USCS column shows | Graphic log draws | Why |
|---|---|---|---|---|
SM | silty SAND | SM | SM | Agrees with the description |
SP-SM | silty SAND | SP-SM | SP-SM | Agrees with the description |
CL/CH | lean CLAY | CL/CH | CL-CH | Agrees with the description |
SP-SM | well graded SAND | SP-SM over (SW) | SP-SM | The description reads as a different symbol (warning) |
SP | sandy SILT | SP over (ML) | SP | The description reads as a different symbol (warning) |
GW-GP | poorly graded GRAVEL | GW-GP over (GP) | GW-GP | Not a possible USCS symbol (warning) |
SM-G | silty SAND with gravel | SM-G over (SM) | SM | Not 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).
GWWell-graded gravelGPPoorly graded gravelGMSilty gravelGCClayey gravelSWWell-graded sandSPPoorly graded sandSMSilty sandSCClayey sandMLSiltCLLean clayOLOrganic silt or clay (low plasticity)MHElastic siltCHFat clayOHOrganic silt or clay (high plasticity)PTPeat
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.
GW-GMWell-graded gravel with siltGW-GCWell-graded gravel with clayGP-GMPoorly graded gravel with siltGP-GCPoorly graded gravel with clayGC-GMSilty clayey gravelSW-SMWell-graded sand with siltSW-SCWell-graded sand with claySP-SMPoorly graded sand with siltSP-SCPoorly graded sand with claySC-SMSilty clayey sand
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
FILLFillFILL_HYDHydraulic fillFILL_ENGEngineered fillFILL_UNDOCUndocumented fillDEBRISDebris, rubble or wasteASPHALTAsphalt pavementCONCRETEConcreteBASE_COURSEAggregate base course
Natural materials
TOPSOILTopsoilSHELLShell or shelly soilCOBBLESCobbles and bouldersWOODWood or organic debrisASHVolcanic ash or tephraCEMENTEDCemented soil, caliche or hardpanLOESSLoessMARLMarlDIATOMITEDiatomaceous earthBENTONITEBentoniteLOAMLoamQUICK_CLAYSensitive (quick) clay
Non-material intervals
WATERWaterNO_RECOVERYNo recoveryVOIDVoid or cavity
Rock: category
ROCKRock (unspecified)ROCK_SEDSedimentary rockROCK_IGNIgneous rockROCK_METMetamorphic rock
Rock: transitional
WEATHEREDWeathered rock or saproliteIGMIntermediate geomaterial
Rock: sedimentary (clastic)
SANDSTONESandstoneSHALEShaleSILTSTONESiltstoneMUDSTONEMudstoneCLAYSTONEClaystoneCONGLOMERATEConglomerateBRECCIABreccia
Rock: sedimentary (chemical/organic)
LIMESTONELimestoneDOLOMITEDolomiteCHALKChalkCHERTChertCOALCoal or ligniteEVAPORITEEvaporite (gypsum, anhydrite, halite)
Rock: igneous (intrusive)
GRANITEGraniteGRANODIORITEGranodioriteDIORITEDioriteGABBROGabbroPERIDOTITEPeridotite
Rock: igneous (extrusive)
BASALTBasaltANDESITEAndesiteDACITEDaciteRHYOLITERhyolite
Rock: igneous (pyroclastic)
TUFFTuffVOLC_BRECCIAVolcanic brecciaSCORIAScoriaPUMICEPumice
Rock: metamorphic (foliated)
SLATESlatePHYLLITEPhylliteSCHISTSchistGNEISSGneiss
Rock: metamorphic (non-foliated)
QUARTZITEQuartziteMARBLEMarbleHORNFELSHornfelsSERPENTINITESerpentiniteGREENSTONEGreenstone or amphibolite
Rock: fault rock
FAULT_GOUGEFault gougeFAULT_BRECCIAFault brecciaMYLONITEMylonite
Need a symbol that isn't here, or want your office's own version of one? See Your own hatches.