Toolchest · Datasheet
Dataset file: accumath-soils-uscs.csv
Compiled: 2026-10-20
Rows: 24 group symbols — 15 primary groups, 8 borderline dual symbols for coarse-grained soils, 1 fine-grained dual symbol (CL-ML), plus Pt.
The Unified Soil Classification System (USCS) group symbols, their published group names, the published laboratory classification criteria that assign a soil to each group, and the typical engineering-property ratings the reference tables publish for each group (permeability class and coefficient range, qualitative shear strength, qualitative compressibility, workability as a construction material, and typical embankment use).
The USCS originates with the U.S. Army Corps of Engineers (Waterways Experiment Station, Casagrande/Wagner work of the 1940s–1950s) and is standardized today as ASTM D 2487. This dataset was not taken from the ASTM document. It was taken from two open U.S. government publications that republish the system:
Both are U.S. government publications (public domain). Group names, criteria values, qualitative ratings, and permeability ranges are published facts, recorded here with attribution; no standard's expressive text or table layout is reproduced beyond the factual entries themselves.
Fine-grained division — the plasticity chart. Fine-grained soils are classified by where their liquid limit (LL) and plasticity index (PI) plot on the plasticity chart. The A-line is
PI = 0.73 × (LL − 20)
Soils plotting on or above the A-line behave as clays (C); below it, as silts (M). LL = 50 is the second dividing line: below it, low plasticity (L — ML, CL, OL); at or above it, high plasticity (H — MH, CH, OH). Working rules (FHWA Table 4-9): PI > 7 and on/above the A-line → clay; PI < 4 or below the A-line → silt; PI between 4 and 7 plotting on or above the A-line is the hatched borderline zone → dual symbol CL-ML. - Organic soils (O). Identified by the liquid-limit ratio test: a soil is classified organic when LL(oven-dried) / LL(not dried) < 0.75. (The NRCS Figure 3-17 prints this test in an oven-dry/air-dry form with a 0.7 limit; the 0.75 oven-dried/not-dried form in FHWA Table 4-9, which follows ASTM D 2487, is the one recorded in the CSV.) - Highly organic soils (Pt). Peat and muck, identified in the field by color, odor, spongy feel, and fibrous texture — not by chart position. - Fines of coarse-grained soils are classified with the same chart rules: fines classifying as ML or MH give GM/SM; fines classifying as CL or CH give GC/SC; fines classifying as CL-ML give the additional dual symbols GC-GM and SC-SM (FHWA Table 4-9, note d). Those two symbols are real members of the system but are not given rows in this dataset, which carries the 24 symbols it was scoped to; they are recorded here so the set is not mistaken for the whole story. - Group-name modifiers (not separate symbols): ≥15% sand or gravel adds "with sand"/"with gravel"; 15–29% material retained on the No. 200 adds "with sand"/"with gravel" (whichever predominates); ≥30% retained adds "sandy"/"gravelly"; cobbles or boulders in the field sample are named in the group name. Organic fines in a dual-symbol soil add "with organic fines."
permeability_typical — the qualitative class and coefficient of
permeability k exactly as NRCS Figure 3-22 prints them for the soil when
compacted (k in cm/s, with the chart's ft/day equivalents). The cm/s–ft/day
pairs are the chart's own conversions (1 cm/s ≈ 2,830 ft/day, printed
rounded).shear_strength_typical and compressibility_typical — the qualitative
terms exactly as printed in Figure 3-22 (Excellent / Good / Good to fair /
Fair / Fair to poor / Poor; Negligible / Very low / Low / Medium /
Medium to high / High / High to very high). No numeric strengths or
settlements are published in the source table, and none are invented here.workability_or_use_note — the Figure 3-22 workability rating, with the
typical embankment-use statement from Figure 3-23 added for context.The USCS is an index and communication system: it groups soils that behave alike so engineers can talk about them and anticipate behavior. The ratings in this dataset are qualitative generalizations for compacted material, published for guidance. They are not design properties. Actual values of strength, compressibility, and permeability for a specific soil depend on its density, moisture, stress history, and fabric, and must come from laboratory and field tests on that soil (gradation and Atterberg limits for classification; permeability, consolidation, and shear tests for design). A group symbol on a boring log tells you what questions to ask; it never answers them. This is the same framing rule as the Toolchest concrete dataset: published typicals, honestly labeled, never dressed up as guarantees.