FRAME-LINK Documentation

Technical Documentation · API Reference · AI-Assisted Framework for Structural Connection Integrity

±2.93%
CSII Accuracy
0.90
Min CSII
4.1%
Crack Rate Error
1.0
Version
3+AI
Modules + AI

📖 Overview

"A structural connection is not merely a component of a larger structural system — it is frequently the governing link in the reliability chain, the element whose failure most directly produces overall structural loss of function."

FRAME-LINK is a fully coupled, AI-augmented continuum mechanics framework that treats structural connection fatigue reliability as a continuously governed dynamic invariant — not a static design property frozen at the completion of a finite element run.

A structural connection operating under cyclic and dynamic loading is not in static equilibrium. It is a dynamically evolving system accumulating fatigue damage, experiencing crack propagation, and approaching or receding from its fracture toughness limit in real time. FRAME-LINK quantifies these changes continuously and governs the safety margin accordingly.

🏗️ 3-Module + AI Architecture

Module 01 — SCFMM (Stress Concentration and Fracture Mechanics Module)

IIW sub-model finite element analysis at 0.4t and 1.0t reference points. Paris–Erdogan crack propagation law with Wheeler retardation correction for overload effects. J-integral stress intensity factor computation.

Paris–Erdogan + Wheeler Retardation
da/dN = C·(ΔK)^m
ΔK = Y·Δσ·√(π·a)
(da/dN)_retarded = φ_W·C·(ΔK)^m

Module 02 — FDARM (Fatigue Damage Accumulation and Reliability Module)

ASTM E1049-85 rainflow cycle counting. Palmgren-Miner linear damage accumulation with Goodman mean stress correction. Eurocode 3 FAT class S-N curves. Cornell–Hasofer–Lind reliability index with AI variance augmentation.

Rainflow + Palmgren-Miner + Cornell
D_joint(t) = Σ n_i/N_i(Δσ_i) ≤ D_allowable = 0.80
β = (μ_R - μ_S)/√(σ_R² + σ_S² + σ_AI²)
P_f = Φ(−β) → target β = 3.8 (P_f ≈ 10⁻⁴/year)

Module 03 — CSDM (Connection Stiffness Degradation Module)

Direct joint stiffness measurement from LVDT and clip gauge data. AI-accelerated finite element model updating. Global stiffness matrix K(t) update and force redistribution tracking.

Stiffness Degradation + Model Updating
S_deg,joint = 1 − K_joint(t)/K_joint,0
K(t)·u = f → ΔF_member = K_member·Δu_member
R(t) = R₀·(1 − D_corr − D_fatigue)

AISL — AI-Assisted Support Layer

Strain field anomaly detection A_score = |ε_meas - ε_FE|/σ. LSTM crack propagation pattern recognition from acoustic emission. XGBoost 24-48h CSII forecast. Gaussian process probabilistic reliability. Physics-bounded outputs only.

AI Anomaly + Physics Constraints
A_score = |σ_meas - σ_FE|/σ_FE ≥ Γ_threshold
ε_AI ≤ 5·(da/dN)_Paris bound
γ_ML ≤ 0.15 (EN 1090-2 bound)

CSII — Connection Structural Integrity Index

Weighted composite of stiffness degradation, fatigue damage, and reliability index. Continuous real-time safety certification at connection level with 24-48h forecast.

CSII Formula
CSII = 0.40·(1-S_deg) + 0.35·(1-D_joint/D_allow) + 0.25·(β_joint/β_target) ≥ 0.90
β_target = 3.8, D_allow = 0.80, S_deg_warning = 0.10

📐 Core Equations

Eq. 1 — Paris–Erdogan (SCFMM)
da/dN = C·(ΔK)^m
Crack propagation rate per cycle
Eq. 2 — Stress Intensity Factor
ΔK = Y·Δσ·√(π·a)
Driving force for crack growth
Eq. 3 — Palmgren–Miner (FDARM)
D_joint(t) = Σ n_i/N_i(Δσ_i)
Linear damage accumulation
Eq. 4 — Cornell Reliability Index
β = (μ_R - μ_S)/√(σ_R² + σ_S² + σ_AI²)
Safety margin in standard deviations
Eq. 5 — Stiffness Degradation (CSDM)
S_deg = 1 - K_joint(t)/K_joint,0
Fractional stiffness loss
Eq. 6 — Connection Integrity Index
CSII = 0.40·(1-S_deg) + 0.35·(1-D/D_allow) + 0.25·(β/β_target)
Composite safety metric

⚙️ CSII Governance Protocol

SignalConditionActionGovernance Level
🟢 STEADY ELASTIC STATECSII ≥ 0.90Normal operation — continuous monitoringNone
🟠 ANOMALY DETECTED L10.75 ≤ CSII < 0.90Enhanced monitoring frequency — targeted NDT inspectionLevel 1
🟠 DEGRADATION WARNING L20.65 ≤ CSII < 0.75Immediate temporary load restriction — structural review within 48 hoursLevel 2
🔴 CRITICAL CONNECTION FAILURECSII < 0.65Immediate operational shutdown — site evacuation — emergency assessmentStop

📦 Installation

bash — pip install
pip install frame-link-engine

# From source
git clone https://github.com/gitdeeper12/FRAME-LINK.git
cd FRAME-LINK
pip install -e .

# Quick test
python -c "from frame_link import FrameLinkAssessor; print('FRAME-LINK ready')"

🔧 API Reference

python — main interface
from frame_link import FrameLinkAssessor

# Initialize with connection configuration
assessor = FrameLinkAssessor(
    connection_config="configs/welded_T_joint.yaml",
    sensor_stream="live"
)

# Run full FRAME-LINK pipeline
result = assessor.evaluate()

print(result.csii)          # CSII ∈ [0, 1]
print(result.signal)        # STEADY_ELASTIC | ANOMALY_L1 | DEGRADATION_L2 | CRITICAL
print(result.beta)          # Reliability index β
print(result.d_joint)       # Palmgren–Miner damage D_joint
print(result.s_deg)         # Stiffness degradation index
print(result.crack_depth)   # Current crack depth a (mm)
print(result.da_dn)         # Paris law crack rate da/dN

📊 Validation Summary

ScenarioCSII AccuracyCrack Rate ErrorFatigue MAEβ Accuracy
V1 — Welded T-joint (variable amplitude)±2.9%4.1%3.3%±4.7%
V2 — Railway bridge SHM (crack detected)±3.1%3.8%2.9%±3.2%
V3 — Bolted splice (preload loss)±2.8%4.4%3.7%±5.1%
MEAN±2.93%4.1%3.3%±4.3%

👤 Author

🔗
Samir Baladi
Principal Investigator — Structural Connection Integrity
Samir Baladi is an interdisciplinary researcher at the intersection of structural reliability engineering, fatigue mechanics, and computational safety analysis for civil and mechanical infrastructure. Affiliated with the Ronin Institute and the Rite of Renaissance research program.
FRAME-LINK is the first project in the CONN-SAFETY series (CONN-SAFETY-01), applying continuous fracture mechanics governance principles to structural connection integrity.

📝 Citation

@software{baladi2026framelink, author = {Samir Baladi}, title = {FRAME-LINK: Fatigue Reliability Assessment and Monitoring Extension for Structural Connection Integrity under Cyclic and Dynamic Loading}, year = {2026}, version = {1.0.0}, publisher = {Zenodo}, doi = {10.5281/zenodo.20440786}, url = {https://doi.org/10.5281/zenodo.20440786}, note = {CONN-SAFETY-01, Structural Connection Integrity} }

"A structural connection is not merely a component — it is the governing link in the reliability chain. FRAME-LINK treats each connection as the subject of its own specific fatigue assessment, providing continuous, quantitative safety governance at the detail level where structural failures originate." — FRAME-LINK v1.0.0