| Case | Configuration | Scour RMSE | Fatigue MAE | BSHI Accuracy | Resonance Sens. |
|---|---|---|---|---|---|
| B1 | Single pier — sandy riverbed | 0.06 m | 2.4% | 97.2% | 94.8% |
| B2 | Twin pier — gravel riverbed | 0.08 m | 2.9% | 96.5% | 93.7% |
| B3 | Offshore monopile — sand | 0.07 m | 2.6% | 97.8% | 95.1% |
| B4 | Jacket foundation — rock-clay | 0.09 m | 3.1% | 95.9% | 92.8% |
| B5 | Cable-stayed — composite deck | 0.07 m | 2.8% | 96.8% | 94.6% |
| B6 | Suspension — deep-water pier | 0.08 m | 3.0% | 97.1% | 95.3% |
| MEAN | — | 0.075 m | 2.8% | 96.9% | 94.4% |
D_s,crit = 4.2 m · δ_max = 45 mm · BSHI certification threshold = 0.85
pip install pier-vibe-engine
from pier_vibe import BridgeGovernor # Initialize with bridge configuration and water depth governor = BridgeGovernor( bridge_config="configs/offshore_monopile.yaml", water_depth_m=25.0, sensor_stream="live" ) result = governor.evaluate() print(result.signal) # "STABILITY_CERTIFIED" | "MONITORING" | "STOP_COMMAND" print(result.bshi) # Bridge Structural Health Index [0,1] print(result.scour_depth_m) # Current scour depth (metres) print(result.fatigue_damage) # Cumulative fatigue damage print(result.frequency_drift_pct) # Natural frequency drift (%) print(result.governance_level) # "none" | "level_1" | "level_2" | "stop"
from pier_vibe import BridgeGovernor from pier_vibe.ai import PINNScourForecaster, PINNFatigueForecaster, BSHICalculator governor = BridgeGovernor( bridge_config="configs/offshore_monopile.yaml", ai_modules={ "scour_pinn": PINNScourForecaster.from_pretrained("default"), "fatigue_pinn": PINNFatigueForecaster.from_pretrained("default"), "bshi": BSHICalculator.from_pretrained("default"), } ) result = governor.evaluate(forecast_hours=72) print(result.scour_forecast_72h) # Scour depth at T+72h (PINN) print(result.fatigue_forecast_72h) # Fatigue damage at T+72h (PINN) print(result.resonance_risk) # "normal" | "elevated" | "critical"
from pier_vibe import BridgeGovernor from pier_vibe.simulation import FloodScenario scenario = FloodScenario( peak_velocity_mps=3.5, duration_hours=72, bridge_config="configs/single_pier_sand.yaml" ) governor = BridgeGovernor(bridge_config="configs/single_pier_sand.yaml") results = governor.run_transient(scenario, dt_hours=0.5, T_max_hours=120) print(results.max_scour_depth) # 2.8 m (equilibrium depth) print(results.scour_warning_hours) # 48 hours before critical depth print(results.bshi_min) # Minimum BSHI during event
# Launch real-time Streamlit bridge safety dashboard # Live scour hole heatmap · BSHI evolution · Fatigue damage · 🔴🟠🟢 signals $ streamlit run examples/streamlit_live.py # Dashboard at: http://localhost:8501 # Panels: # · Scour hole evolution heatmap (SSSE live output) # · Natural frequency drift plot (HSCE with PINN forecast) # · Cumulative fatigue damage chart (EFGL with rainflow) # · BSHI time-series with 0.85 threshold line # · 🔴🟠🟢 governance signal status panel # · PINN scour + fatigue forecasts at 24/48/72h # · JSON/CSV archive with SHA-256 checksums
git clone https://github.com/gitdeeper12/PIER-VIBE.git
git clone https://gitlab.com/gitdeeper12/PIER-VIBE.git
git clone https://bitbucket.org/gitdeeper-12/PIER-VIBE.git
git clone https://codeberg.org/gitdeeper12/PIER-VIBE.git
@software{baladi2026piervibe_pypi,
author = {Baladi, Samir},
title = {{PIER-VIBE}: Predictive Intelligence Engine for Resonance,
Vibration, and Integrity in Bridge Environments},
year = {2026},
version = {1.0.0},
publisher = {Python Package Index},
url = {https://pypi.org/project/pier-vibe-engine},
note = {Python package, MIT License,
Systems Safety & Engineering (AI-augmented)}
}
@dataset{baladi2026piervibe_zenodo,
author = {Baladi, Samir},
title = {{PIER-VIBE}: Predictive Intelligence Engine for Resonance,
Vibration, and Integrity in Bridge Environments —
Research Paper and Simulation Data},
year = {2026},
publisher = {Zenodo},
version = {1.0.0},
doi = {10.5281/zenodo.20390646},
url = {https://doi.org/10.5281/zenodo.20390646},
note = {Bridge Engineering Core · FSI · Systems Safety}
}
@misc{baladi2026piervibe_osf,
author = {Baladi, Samir},
title = {{PIER-VIBE} Framework: Pre-registered Study Protocol for
AI-Augmented Structural Integrity Governance in
Offshore and Riverine Bridges},
year = {2026},
publisher = {Open Science Framework},
doi = {10.17605/OSF.IO/YKWEG},
url = {https://doi.org/10.17605/OSF.IO/YKWEG},
note = {OSF Preregistration}
}
@article{baladi2026piervibe,
author = {Baladi, Samir},
title = {{PIER-VIBE}: A Critical Framework for Subsurface Scour Mechanics,
Dynamic Wave-Structure Interaction, and Resonance Fatigue
Governance in Offshore and Riverine Bridges},
year = {2026},
month = {May},
version = {1.0.0},
doi = {10.5281/zenodo.20390646},
url = {https://doi.org/10.5281/zenodo.20390646},
note = {Ronin Institute / Rite of Renaissance,
Systems Safety & Engineering (AI-augmented)}
}
Baladi, S. (2026). PIER-VIBE: A Critical Framework for Subsurface Scour Mechanics, Dynamic Wave-Structure Interaction, and Resonance Fatigue Governance in Offshore and Riverine Bridges (Version 1.0.0). Zenodo. https://doi.org/10.5281/zenodo.20390646