When should I use piletest-pro?

piletest-pro is useful in the following scenarios: • Automated Calculation of Safe Loads: Instantly compute safe load capacities using the 12mm settlement and ultimate load criteria based on raw pressure and gauge readings. • IS 2911 Compliance Validation: Automatically verify if pile test results (IVPLT, RVPLT, Lateral, or Uplift) meet the specific acceptance benchmarks and net settlement limits defined by Indian Standards. • Standardized Engineering Report Generation: Streamline the creation of professional geotechnical reports with automated chart specifications for load-settlement curves and structured PDF templates. • Field Data Verification: Use Python-based validation scripts to check the consistency and accuracy of field test readings before final report submission.

piletest-pro

from nirukk52

Domain knowledge and workflows for pile load testing reports compliant with IS 2911 (Part 4) - 2013. Use when working on test calculations, report generation, PDF templates, pass/fail criteria, or adding new test types (IVPLT, RVPLT, Lateral, Uplift). This skill encodes Indian Standard formulas, acceptance criteria, report structure requirements, and chart specifications for pile foundation testing.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 9, 2026

When & Why to Use This Skill

PileTest Pro is a specialized domain skill designed to automate and standardize pile load testing reports in compliance with IS 2911 (Part 4) - 2013. It streamlines geotechnical engineering workflows by encoding complex Indian Standard formulas for vertical, lateral, and uplift tests, ensuring accurate pass/fail validation and professional PDF report generation.

Use Cases

Automated Calculation of Safe Loads: Instantly compute safe load capacities using the 12mm settlement and ultimate load criteria based on raw pressure and gauge readings.
IS 2911 Compliance Validation: Automatically verify if pile test results (IVPLT, RVPLT, Lateral, or Uplift) meet the specific acceptance benchmarks and net settlement limits defined by Indian Standards.
Standardized Engineering Report Generation: Streamline the creation of professional geotechnical reports with automated chart specifications for load-settlement curves and structured PDF templates.
Field Data Verification: Use Python-based validation scripts to check the consistency and accuracy of field test readings before final report submission.

name	piletest-pro
description	Domain knowledge and workflows for pile load testing reports compliant with IS 2911 (Part 4) - 2013. Use when working on test calculations, report generation, PDF templates, pass/fail criteria, or adding new test types (IVPLT, RVPLT, Lateral, Uplift). This skill encodes Indian Standard formulas, acceptance criteria, report structure requirements, and chart specifications for pile foundation testing.

name

piletest-pro

description

PileTest Pro Domain Knowledge

This skill provides domain expertise for pile load testing and IS 2911-compliant report generation.

Quick Reference

Test Types & Load Multipliers

Test Type	Code	Load Multiplier	Description
Initial Vertical	`IVPLT`	2.5× design load	First test on new piles
Routine Vertical	`RVPLT`	1.5× design load	Production/working piles
Lateral	`LATERAL`	2.5× design load	Horizontal resistance
Uplift/Pullout	`UPLIFT`	2.5× design load	Upward resistance

Core Formulas

// Load from pressure (MT)
load = (pressureKgCm2 × ramAreaCm2) / 1000

// Average settlement (mm)  
avgSettlement = (dg1 + dg2 + dg3 + dg4) / enabledGaugeCount

// Net settlement (mm)
netSettlement = maxSettlement - elasticRebound

// Safe load from 12mm criterion (MT)
safeLoad_12mm = (2/3) × loadAt12mmSettlement

// Safe load from ultimate criterion (MT)  
safeLoad_ultimate = 0.5 × loadAt10PercentDiameter

Pass/Fail Criteria (IS 2911)

Vertical Tests (IVPLT/RVPLT):

Net settlement ≤ 12mm (or 2% of pile diameter, whichever is less)
Safe load = minimum of design load, safeLoad_12mm, safeLoad_ultimate

Workflow

1. Calculate Results

See references/is2911-standards.md for detailed calculation steps.

2. Generate Report

See references/report-structure.md for PDF section specifications.

3. Validate Readings

For IS 2911 compliance validation, see scripts/validate_readings.py.

Files

references/is2911-standards.md - Complete IS 2911 Part 4 acceptance criteria
references/report-structure.md - PDF report section specifications
references/test-types.md - Detailed test type configurations
scripts/validate_readings.py - Python validation for readings
assets/templates/ - HTML report template patterns

Key Implementation Points

Settlement Calculations

Max Settlement: Highest avgSettlementMm during LOADING phase
Elastic Rebound: Max settlement minus final settlement after full unload
Net Settlement: Permanent settlement after load removal

Safe Load Determination

governingCriterion = 
  if (settlementLimit was reached) → "SETTLEMENT_12MM"
  if (10% diameter was reached) → "ULTIMATE_10PCT_DIA"  
  else → "DESIGN_LOAD"

safeLoadAdopted = min(
  designLoadT,
  safeLoadFromSettlementT,  // (2/3) × load at 12mm
  safeLoadFromUltimateT     // (1/2) × load at 10% dia
)

Chart Configuration

X-axis: Load (MT)
Y-axis: Settlement (mm) - inverted (0 at top, increases downward)
Curves: Loading (blue), Holding (amber), Unloading (green)
Annotations: 12mm limit line, safe load vertical line