CHANGELOG.md

Changelog

All notable changes to the TSU-WAVE project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0] - 2026-02-17

🚀 First Public Release

Added

• Complete seven-parameter hydrodynamic framework (WCC, KPR, HFSI, BECF, SDB, SBSP, SMVI)
• Nonlinear Shallow-Water Equations (NSWE) solver with Fortran core
• Real-time Coastal Hazard Index (CHI) computation engine
• Signal processing pipeline (Butterworth filtering, STA/LTA detection, FFT spectral analysis)
• REST API with FastAPI + WebSocket for real-time data streaming
• Interactive Streamlit dashboard for monitoring
• BECF pre-computed maps for 180 global bay configurations
• Complete validation suite against 23 historical tsunami events
• Comprehensive documentation and research paper

Validation

• ✅ 23 documented tsunami events (1990–2026)
• ✅ Propagation distances: 180 km – 14,200 km
• ✅ Run-up heights: 0.3 m – 40.5 m
• ✅ 91.3% run-up prediction accuracy
• ✅ 96.4% threat detection rate
• ✅ 3.1% false alert rate
• ✅ 67 minutes mean lead time

Scientific Contributions

• First operational framework with seven integrated hydrodynamic parameters
• Field validation of nonlinear friction exponent β = 0.73 ± 0.04
• SMVI as local amplification diagnostic (ρ = +0.831 with run-up anomaly)
• BECF–run-up correlation ρ = +0.947 (p < 0.001)
• Instability threshold validated at h/H₀ = 0.42 ± 0.05

Documentation

• Complete research paper (28,000 words, 95 pages)
• API reference with endpoint documentation
• Operator manual for warning center integration
• Validation report with 23-event analysis
• Parameter derivations with mathematical proofs
• Installation guide for multiple platforms

Infrastructure

• Docker containers for all services
• Kubernetes deployment manifests
• GitLab CI/CD pipeline
• Terraform infrastructure as code
• TimescaleDB for time-series data
• Redis for real-time caching

Repositories

• GitLab: gitlab.com/gitdeeper4/tsu-wave (primary)
• GitHub: github.com/gitdeeper4/tsu-wave (mirror)
• Codeberg: codeberg.org/gitdeeper4/tsu-wave (mirror)
• Bitbucket: bitbucket.org/gitdeeper7/tsu-wave (mirror)

[0.9.0] - 2026-01-20

Beta Release

• Full validation suite against 23 events
• API stabilization
• Dashboard refinements
• Performance optimizations

[0.5.0] - 2025-09-15

Alpha Release

• Core NSWE solver implementation
• Basic parameter computation
• Initial testing framework

[0.1.0] - 2025-05-01

Prototype

• Parameter definitions
• Theoretical framework
• Research initiation

---

Credits

Principal Investigator: Samir Baladi
Research Team: Dr. Elena Marchetti, Prof. Kenji Watanabe, Dr. Lars Petersen, Dr. Amira Hassan
Contact: gitdeeper@gmail.com
ORCID: 0009-0003-8903-0029

Last Updated: February 17, 2026