← AxiomBaseLogic

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.

Parse AGS → Load SCPT → Clean & Align → Stack 0.02m → Interpret → Layers → Design Lines → Export

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.

  1. Parse AGS

    AGS4 Parsing

    Convert uploaded .ags files to structured CSV tables using python-AGS4. Format warnings are surfaced automatically.

  2. 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.

  3. Process

    Clean & Align

    Clean raw readings and align multi-push data from the same borehole. Handles overlapping depth ranges and push inconsistencies.

  4. 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.

  5. 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.

  6. Layers

    Stratigraphy Identification

    Automatically identify soil strata boundaries from the interpreted Ic profile. Generates a layer model for use in design extraction and reporting.

  7. 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.

  8. 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
qc · fs · u2
Qtn Fr Ic
Su Dr φ G0 E

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_name parameter.

  • 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.