[![image](https://img.shields.io/pypi/v/sandpyper.svg)](https://pypi.python.org/pypi/sandpyper)
[![Contributors][contributors-shield]][contributors-url]
[![image](https://github.com/npucino/sandpyper/workflows/build/badge.svg)](https://github.com/npucino/sandpyper/actions/workflows/build.yml/badge.svg)
[![image](https://github.com/npucino/sandpyper/workflows/docs/badge.svg)](https://github.com/npucino/sandpyper/actions/workflows/docs.yml/badge.svg)
[![image](https://github.com/npucino/sandpyper/workflows/pypi/badge.svg)](https://github.com/npucino/sandpyper/actions/workflows/pypi.yml/badge.svg)
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
<!-- PROJECT logo -->
<br />
<p align="center">
<a href="https://github.com/npucino/sandpyper/">
<img src="images/sandpiper1-01.png" alt="Logo" width="50%" height="50%">
</a>
<h3 align="center">- Tools for automatic UAV-SfM beach volumetric and behavioural analysis -</h3>
<p align="justify">
Sandpyper performs an organised and automatic extraction of elevation profiles from as many DSM and orthophotos as you like. It is thought to be used when a considerable number of DSMs and orthohpotos from many different locations and coordinate reference systems need to be processed.
Then, computes volumetric and behavioural analysis of beachfaces, speeding up an otherwise long and difficult to handle (big rasters) job.
It has some specialised functions to deal with the common limitations found in beach environments:
<ol>
<li>Swash zone: the water motion as waves wash in and out of the swash zone prevent Structure from Motion algorithm to find matches, thus, model elevation.</li>
<li>Vegetation: both dune vegetation and beach wracks (macroalgae, woody debris) should be removed or filetered as can compromise sediment volumetric computation.</li>
<li>File size: a few km long beach surveyed with a Phantom 4-Advanced at 100m altitude create roughly 10 Gb (uncompressed) of data, which can be cumbersome for some GIS to handle.</li>
</ol>
From user-defined cross-shore transects, you can clean profiles from unwanted non-sand points, detect significant hotspots/coldspots (cluster) of beach change, compute volumetric dynamics at the site and transect levels, plot alongshore change and model beachface behaviour using the Beachface Cluster Dynamics indices.
Plus, some outils functions that can come at hand, like automatic transect creation from a vector line, grid creation along a line and subsequent tiles extraction and others.
Follow the Jupyter Notebook tutorials (IN PREPARATION) to understand how it works!
>**This code has supported the analysis and publication of the article ["Citizen science for monitoring seasonal-scale beach erosion and behaviour with aerial drones"](https://rdcu.be/cfgvu "link to paper"), in the open access Nature Scientific Report journal.**
<br />
<a href="https://github.com/npucino/sandpyper"><strong>Explore the docs »</strong></a>
<br />
<a href="https://github.com/npucino/sandpyper">View Demo</a>
·
<a href="https://github.com/npucino/sandpyper/issues">Report Bug</a>
·
<a href="https://github.com/npucino/sandpyper/issues">Request Feature</a>
</p>
</p>
<!-- TABLE OF CONTENTS -->
<details open="open">
<summary><h2 style="display: inline-block">Table of Contents</h2></summary>
<ol>
<li>
<a href="#about-the-project">About The Project</a>
<ul>
<li><a href="#Background">Background</a></li>
<li><a href="#Modules">Modules</a></li>
</ul>
</li>
<li>
<a href="#getting-started">Getting Started</a>
<ul>
<li><a href="#prerequisites">Prerequisites</a></li>
<li><a href="#Installation">Installation</a></li>
</ul>
</li>
<li><a href="#usage">Usage</a></li>
<li><a href="#roadmap">Roadmap</a></li>
<li><a href="#contributing">Contributing</a></li>
<li><a href="#license">License</a></li>
<li><a href="#contact">Contact</a></li>
<li><a href="#publications">Publications</a></li>
<li><a href="#acknowledgements">Acknowledgements</a></li>
</ol>
</details>
<!-- ABOUT THE PROJECT -->
## About The Project
<img src="images/banner3.png" alt="banner" width="100%" height="50%">
<!-- Background -->
### Background
This code has been developed to ease the analysis of big data coming from more than 300 Unnmanned Aerial Vehicles (UAV) surveys, performed by Citizen Scientist in Victoria, Australia. This is the [Eureka Award Winning](https://www.deakin.edu.au/about-deakin/media-releases/articles/eureka-prize-win-for-world-first-citizen-science-program) World-first [beach monitoring program powered by volunteers](https://www.marinemapping.org/vcmp-citizen-science "info on the Citizen Science project"), who autonomously fly UAVs on 15 sensitive sites (erosional hotspots) across the Victorian coast, every 6 weeks for 3 years, since 2018. This project is part of a broader marine mapping program called The [Victorian Coastal Monitoring Program (VCMP)](https://www.marineandcoasts.vic.gov.au/coastal-programs/victorian-coastal-monitoring-program "VCMP website"), funded by the [Victorian Department of Environment, Land, Water and Planning](https://www.delwp.vic.gov.au/ "DELWP website"), co-funded by [Deakin University](https://www.deakin.edu.au/ "Deakin Uni website") and [The University of Melbourne](https://www.unimelb.edu.au/ "UniMelb website").
Each survey creates Digital Surface Models and orthophotos of considerable size (5-10 Gb uncompressed), which can be troublesome for some GIS to render, let alone perform rster-based computations.
<!-- modules -->
### Modules
* **.outils**: main storage of useful functions.
* **.profile**: extract elevation and colour information across profiles from a folder of rasters.
* **.labels**: use KMean and Silhouette analysis to help clean the extracted elevation data from unwanted non-sand points.
* **.hotspot**: use Local Moran's I to disscard spatial outliers and obtain significant hot/cold spots of beach change at site and transect levels.
* **.dynamics**: compute Beachface CLuster Dynamics indices at the site and transect levels.
* **.volumetrics**: compute volumetric timeseries of sand-only points and create plots.
* **.space** (under development): simple satellite and UAV instantaneous waterlines tidal-correction and shoreline shifts/error metrics.
<!-- GETTING STARTED -->
## Getting Started
To get a local copy up and running follow these simple steps.
### Prerequisites
* [Install Conda] in your local machine. We need it to create the **"sandpyper_env"** virtual environment.
* then, if you do not have it already, install **Visual Studio C++ build tools** in your local machine, which is needed to install the [richdem](https://pypi.org/project/richdem/ "richdem pypi page") package. You can download it [here](https://visualstudio.microsoft.com/visual-cpp-build-tools/ "standalone VS c++ build tools").
* now, in the Anaconda Prompt terminal, create the environment **sandpyper_env** and install the required packages by typing:
```sh
conda create --name sandpyper_env geopandas=0.8.2 matplotlib=3.3.4 numpy=1.20.1 pandas=1.2.2 tqdm pysal=2.1 rasterio=1.2.0 richdem=0.3.4 scikit-image=0.18.1 scikit-learn=0.24.1 scipy=1.6 seaborn=0.11.1 tqdm=4.56.2
```
### Installation
1. ```sh
conda activate sandpyper_env
```
2. ```sh
pip install sandpyper
```
2. Install Jupyter Notebooks:
```sh
conda install jupyter notebook
```
3. Once you open a Jupyter Notebook with the sandpyper_env, import it to test it works.
```sh
import sandpyper
```
<!-- USAGE EXAMPLES -->
## Usage
TO DO.
_For more examples, please refer to the [Documentation](https://npucino.github.io/sandpyper/)_
<!-- ROADMAP -->
## Roadmap
See the [open issues](h
没有合适的资源?快使用搜索试试~ 我知道了~
UAV-SfM数据集中监测海滩体积和行为动力学的python工具.zip
共39个文件
md:13个
py:11个
ipynb:6个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 172 浏览量
2023-11-03
12:13:11
上传
评论
收藏 1.12MB ZIP 举报
温馨提示
1.版本:matlab2014/2019a/2021a,内含运行结果,不会运行可私信 2.附赠案例数据可直接运行matlab程序。 3.代码特点:参数化编程、参数可方便更改、代码编程思路清晰、注释明细。 4.适用对象:计算机,电子信息工程、数学等专业的大学生课程设计、期末大作业和毕业设计。 5.作者介绍:某大厂资深算法工程师,从事Matlab算法仿真工作10年;擅长智能优化算法、神经网络预测、信号处理、元胞自动机等多种领域的算法仿真实验,更多仿真源码、数据集定制私信+。
资源推荐
资源详情
资源评论
收起资源包目录
UAV-SfM数据集中监测海滩体积和行为动力学的python工具.zip (39个子文件)
UAV-SfM数据集中监测海滩体积和行为动力学的python工具
setup.py 2KB
tests
__init__.py 40B
test_sandpyper.py 389B
examples
Profile_Extraction.ipynb 119KB
Sand_KMeans_labeling.ipynb 399KB
Sand_No_Sand_classification_beachface.ipynb 43KB
docs
profile.md 23B
outils.md 22B
overrides
main.html 274B
faq.md 7B
installation.md 620B
space.md 21B
usage.md 73B
contributing.md 3KB
hotspot.md 23B
labels.md 21B
dynamics.md 24B
volumetrics.md 27B
index.md 4KB
notebooks
Profile_Extraction.ipynb 119KB
Sand_KMeans_labeling.ipynb 399KB
Sand_No_Sand_classification_beachface.ipynb 43KB
requirements.txt 201B
MANIFEST.in 129B
setup.cfg 393B
images
sandpiper1-01.png 103KB
sandpiper2-01.png 101KB
banner3.png 765KB
sandpyper
__init__.py 144B
dynamics.py 21KB
volumetrics.py 41KB
profile.py 20KB
outils.py 16KB
space.py 63KB
labels.py 13KB
hotspot.py 5KB
requirements_dev.txt 157B
README.md 11KB
mkdocs.yml 2KB
共 39 条
- 1
资源评论
Matlab科研辅导帮
- 粉丝: 1w+
- 资源: 7474
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功