Web App Guide
The BoreholeAI web app lets you upload borehole log PDFs, monitor processing progress, view extraction results with full visual grounding, and download structured output files — all from your browser.
Playground
The Playground is the fastest way to see BoreholeAI in action. It includes pre-loaded demo borehole logs that you can interact with immediately — no account required.
Click any row in the extraction results table to see exactly where that data was found in the original PDF. This visual grounding feature works in both directions: click a region in the PDF viewer and the corresponding data row is highlighted in the table.
The Playground also supports uploading your own files. Each anonymous session allows up to 2 uploads within a 24-hour window. For unlimited uploads, create a free account.
Uploading Borehole Logs
Supported Formats
Upload any borehole log as a PDF, JPG, PNG, or WebP file. Any template, from any company, simple or complex. Single-page and multi-page logs are both supported. The maximum file size is 200 MB per file.
Batch Upload
From the Dashboard, you can upload multiple PDF files at once by dragging them into the upload zone or clicking to browse. All files in a batch are processed together as a single job. When processing completes, results from all files are merged into consolidated Excel, AGS, and annotated PDF outputs.
Multi-Borehole PDFs
If a single PDF contains multiple borehole logs (e.g. a multi-page document with BH01 on pages 1–3 and BH02 on pages 4–6), BoreholeAI will detect and process each borehole separately. The output files will contain data from all boreholes in the document.
Credit Usage
Processing costs 1 credit per page. Before uploading from the Dashboard, you will see an estimate dialog showing the total number of pages detected and the credits that will be deducted. Credits are deducted when you confirm the upload. If a job fails during processing, credits are refunded automatically.
Monitoring Progress
After uploading, your job appears on the Jobs page with real-time status updates. You can see:
- Page progress: Which page is currently being processed out of the total page count.
- Subgraph progress: Within each page, which processing stage (tabularisation, depth extraction, material extraction, etc.) is currently running.
- Status: Queued, Processing, Completed, or Failed. If a job fails, the error message is displayed on the job detail page.
Processing time depends on the number of pages and the complexity of the borehole log. A typical single-page log takes 30–90 seconds. Multi-page logs process each page sequentially, with later pages processing faster due to layout reuse from the first page.
Visual Grounding
One of BoreholeAI's key features is full traceability between the extracted data and the original document. Every extracted data row links back to its exact location in the source PDF.
Table to PDF
Click any row in the extraction results table (ground profile, test data, etc.) and the PDF viewer will scroll to and highlight the exact region where that data was extracted from. This lets you verify every single data point against the original document.
PDF to Table
It works in the other direction too. Click a region in the PDF viewer and the corresponding data row is highlighted in the results table. This bidirectional linking means there is no black box — you can see exactly what was extracted and where it came from.
Downloading Results
Once processing is complete, you can download the output files from the job detail page. Each completed job produces the following files:
Excel Workbooks (.xlsx)
Two Excel files are generated. Borehole_ground_profile.xlsx contains sheets for processing metadata, material records, geology records, and consistency/density data. Borehole_test_data.xlsx contains sheets for groundwater summary, SPT records, UCS, Is50, and Cu test results. Both files include a processing information sheet with the borehole metadata and cost summary.
AGS4 File (.ags)
An AGS4-compliant data transfer file containing 11 groups: PROJ, TRAN, LOCA, GEOL, SAMP, ISPT, RUCS, RPLT, IVAN, IPEN, and WSTG. This is the industry standard format used by geotechnical software for data exchange. The AGS file can be imported directly into tools like gINT, HoleBASE, KeyAGS, or any AGS-compatible application.
Annotated PDF
A copy of the original PDF with markup overlays showing exactly what was extracted and where — red depth boundary lines and blue material labels annotated on each page. This serves as a full audit trail that you can share with reviewers or attach to project documentation.
Batch Operations
The Jobs page supports bulk actions for managing multiple jobs at once:
- Batch download: Select multiple completed jobs using the checkboxes and click “Download Results” to download all output files as a ZIP archive.
- Batch cancel: Select jobs that are queued or processing and cancel them. Credits for cancelled jobs are refunded.
- Batch delete: Select completed or failed jobs and delete them along with their uploaded files and results from storage.
- Select all: Use the checkbox dropdown to select the current page, all filtered results, or all jobs of a specific status (e.g. all queued).
You can also filter jobs by status, date range, and search by filename. The sort order can be toggled between newest and oldest first.
Usage Tracking
Navigate to Settings → Usage & Costs to view your credit consumption over time. The usage page shows:
- Monthly summary: Total credits used, total jobs processed, and total pages processed for the selected month.
- Daily usage chart: A bar chart showing pages processed per day, with interactive tooltips.
- Activity log: A detailed table of all credit transactions — job usage, purchases, refunds, and bonuses — with timestamps and descriptions.
- CSV export: Download the activity log as a CSV file for record-keeping or accounting purposes.
Both web app uploads and API usage appear in the activity log, so you have a complete view of all credit consumption regardless of how jobs were submitted.