CPT Interpretation · Axiom Platform
CPT Processor
End-to-end Cone Penetration Test interpretation — from raw AGS4 files to auditable design lines and report-ready exports. The full pipeline: parse, clean, stack, Robertson 2009/2016 interpretation, stratigraphy, and best/high/low design line extraction, all in one automated run.
Eight-step interpretation pipeline
Every stage from raw AGS4 upload to final export artifacts is handled in a single automated run. Each step is auditable and tested against golden baselines derived from the original implementation.
- Parse AGS
AGS4 Parsing
Convert uploaded .ags files to structured CSV tables using python-AGS4. Format warnings are surfaced automatically.
- Load SCPT
CPT Data Extraction
Extract CPT readings from SCPT and SCPG groups: depth (m), cone resistance qc, sleeve friction fs, and pore water pressure u2.
- Process
Clean & Align
Clean raw readings and align multi-push data from the same borehole. Handles overlapping depth ranges and push inconsistencies.
- Stack
0.02 m Grid Resampling
Resample all readings to a uniform 0.02 m depth grid using linear interpolation. Ensures consistent depth registration across all parameters.
- Interpret
Robertson 2009/2016
Full Robertson interpretation: Ic, Qtn, Fr, and a complete suite of derived parameters — Su, Dr, phi, G0, E, and more. Both 2009 and 2016 classification schemes supported.
- Layers
Stratigraphy Identification
Automatically identify soil strata boundaries from the interpreted Ic profile. Generates a layer model for use in design extraction and reporting.
- Design Lines
Best / High / Low Lines
Extract best-estimate, upper-bound (high), and lower-bound (low) design lines for each parameter per stratum. Suitable for direct use in foundation and retaining structure design.
- Export
Excel, PDF & JSON
Structured Excel workbook, PDF report, and a D3-ready JSON payload for the interactive frontend charts. All outputs from a single run.
Robertson 2009 & 2016
The Robertson Soil Behaviour Type chart is the industry-standard framework for CPT classification. CPT Processor implements both the 2009 and 2016 classification schemes and computes the full suite of derived engineering parameters from normalised cone resistance (Qtn) and friction ratio (Fr).
- Ic — Soil Behaviour Type index (Robertson 2009/2016)
- Qtn — Normalised cone resistance
- Fr — Normalised friction ratio
- Su — Undrained shear strength (from Nkt)
- Dr — Relative density
- φ — Friction angle
- G0 — Small-strain shear stiffness
- E — Young's modulus
Outputs & deliverables
Every run produces a consistent, reproducible set of artifacts — interactive frontend charts, structured exports, and a complete audit trail against validated baselines.
-
D3 depth profiles
Interactive depth-vs-parameter charts for qc, fs, u2, Ic, and derived properties. Rendered in the browser from the backend JSON payload.
-
Robertson chart
Qtn vs Fr plot with the Robertson 2009/2016 SBT zone boundaries. Each data point colour-coded by stratum.
-
Stratigraphy
Visual log of identified soil layers with Ic-derived SBT classification and boundary depths.
-
Design lines
Best/high/low lines for each parameter per layer — directly usable in geotechnical design calculations.
-
Excel workbook
Structured multi-sheet export: raw readings, interpreted values, layer summary, and design line tables.
-
PDF report
Document-ready output with parameter profiles and summary tables. Named via the
doc_nameparameter. -
Audit trail
Results tested against golden baselines from the original implementation. Outputs are reproducible and version-controlled.
-
Async processing
Large or multiple files can be submitted as async jobs. Poll for status/progress; cancel if needed. Suitable for batch workflows.
REST API
Integrate CPT interpretation directly into your own pipelines. Synchronous and asynchronous endpoints — submit a job, poll for progress, retrieve results, or cancel.
- POST api/run/ Synchronous run. Returns full JSON: meta, boreholes, plots payload, exports.
- POST api/run-async/ Async job start. Returns
{"job_id": "..."}. - GET api/job/<id>/ Job status, progress percentage, result, and warnings.
- POST api/job/<id>/cancel/ Best-effort job cancellation.
- GET api/info/ Capabilities, parameter defaults, schema version.
Part of the AxiomBaseLogic platform
CPT Processor ships alongside Borehole EDA, Retaining Wall, Liquefaction Analysis, Plotter, AGS Parser, and Data Mapper — on a single platform with shared auth, shared data, and REST APIs. Subscribe once, access all apps.
Explore other apps
Jump to other AxiomBaseLogic tools and keep your workflow connected across the platform.