Back to list
nirukk52

piletest-pro

by nirukk52

Automates pile testing report generation.

0🍴 0📅 Jan 9, 2026

SKILL.md


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.

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 TypeCodeLoad MultiplierDescription
Initial VerticalIVPLT2.5× design loadFirst test on new piles
Routine VerticalRVPLT1.5× design loadProduction/working piles
LateralLATERAL2.5× design loadHorizontal resistance
Uplift/PulloutUPLIFT2.5× design loadUpward 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

  1. Max Settlement: Highest avgSettlementMm during LOADING phase
  2. Elastic Rebound: Max settlement minus final settlement after full unload
  3. 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

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon