Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/TomasBeuzen/pybeach
A Python package for locating the dune toe on cross-shore beach profile transects.
https://github.com/TomasBeuzen/pybeach
Last synced: 3 months ago
JSON representation
A Python package for locating the dune toe on cross-shore beach profile transects.
- Host: GitHub
- URL: https://github.com/TomasBeuzen/pybeach
- Owner: TomasBeuzen
- License: mit
- Created: 2019-10-05T05:36:03.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-01T00:29:50.000Z (6 months ago)
- Last Synced: 2024-07-05T16:59:52.954Z (4 months ago)
- Language: Jupyter Notebook
- Size: 10.3 MB
- Stars: 17
- Watchers: 6
- Forks: 10
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-coastal - TomasBeuzen/pybeach
README
[](https://www.repostatus.org/#active)
[](https://opensource.org/licenses/MIT)
[](https://pybeach.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/gh/TomasBeuzen/pybeach)
[](https://joss.theoj.org/papers/8b211e45c6919ea8057946484e757c28)
[](https://badge.fury.io/py/pybeach)
>As of 2021 this repo is currently not actively maintained. I do hope to make time for it in the future as there's lots of room for improvement - PRs welcome any time.
# **pybeach**: A Python package for locating the dune toe on cross-shore beach profile transects.
## Background
**pybeach** is a Python package for identifying dune toes on 2D beach profile transects. It includes the following methods:
- Machine learning;
- Maximum curvature (Stockdon et al, 2007);
- Relative relief (Wernette et al, 2016); and,
- Perpendicular distance.
In addition, **pybeach** contains methods for identifying the shoreline position and dune crest position on 2D beach profile transects. See the [*pybeach* paper](paper.md) for more details about **pybeach**.
## Installation
`pip install pybeach`
## Usage
```python
from pybeach.beach import Profile
# example data
x = np.arange(0, 80, 0.5)
z = np.concatenate((np.linspace(4, 5, 40),
np.linspace(5, 2, 10),
np.linspace(2, 0, 91)[1:],
np.linspace(0, -1, 20)))
# instantiate
p = Profile(x, z)
# predict dune toe, dune crest, shoreline location
toe_ml, prob_ml = p.predict_dunetoe_ml('wave_embayed_clf') # predict toe using machine learning model
toe_mc = p.predict_dunetoe_mc() # predict toe using maximum curvature method (Stockdon et al, 2007)
toe_rr = p.predict_dunetoe_rr() # predict toe using relative relief method (Wernette et al, 2016)
toe_pd = p.predict_dunetoe_pd() # predict toe using perpendicular distance method
crest = p.predict_dunecrest() # predict dune crest
shoreline = p.predict_shoreline() # predict shoreline
```
See the [example notebook](https://github.com/TomasBeuzen/pybeach/blob/master/example/example.ipynb) for more details.
## Documentation
Read the **pybeach** documentation [here](https://pybeach.readthedocs.io/en/latest/).
## Dependencies
A list of **pybeach** dependencies can be found in [pyproject.toml](https://github.com/TomasBeuzen/pybeach/blob/master/pyproject.toml). Currently, **pybeach** depends on the following:
- python = "^3.7"
- numpy = "1.17.2"
- scipy = "1.3.1"
- pandas = "0.25.1"
- scikit-learn = "0.21.2"
- joblib = "0.13.2"
## Questions, Comments, Suggestions
Do you have a question that needs answering? Have you found an issue with the code and need to get it fixed? Or perhaps you're looking to contribute to the code and have ideas for how it could be improved. In all cases, please see the [Issues](https://github.com/TomasBeuzen/pybeach/issues) page.
## References
Stockdon, H. F., Sallenger Jr, A. H., Holman, R. A., & Howd, P. A. (2007). A simple model for the spatially-variable coastal response to hurricanes. Marine Geology, 238, 1-20. https://doi.org/10.1016/j.margeo.2006.11.004
Wernette, P., Houser, C., & Bishop, M. P. (2016). An automated approach for extracting Barrier Island morphology from digital elevation models. Geomorphology, 262, 1-7. https://doi.org/10.1016/j.geomorph.2016.02.024