<p align="center"> <img src="media/pyCoastal_logo.png" width="400"> </p>

A Python module for Coastal Engineering calculations, and to play around with numerics.

Copyright (c) 2025 Stefano Biondi Licensed under the MIT License. See LICENSE file for details.

Install via pip:

pip install pyCoastal

Or clone and Install in editable mode

git clone https://github.com/stebiondi/pyCoastal.git
cd pyCoastal
pip install -e .

---

Simulation Preview

circular wave propagation from a central disturbance:

<p align="center"> <img src="media/water_drop.gif" alt="2D Wave Animation" width="600"> </p>

📚 Citation

If you use pyCoastal in a scientific publication, please cite:

Biondi, S. (2025)
pyCoastal: a Python package for Coastal Engineering
GitHub: https://github.com/stebiondi/pyCoastal
Version: v0.1.1

You can also use this BibTeX entry:

@software{pyCoastal2025,
  author  = {Biondi, Stefano},
  title   = {{pyCoastal}: Modular Coastal Process Modeling in Python},
  year    = {2025},
  url     = {https://github.com/stebiondi/pyCoastal},
  version = {v0.1.1}
}