From bbb5a8b0ea10951d30063ed5f4252614a1f78d2b Mon Sep 17 00:00:00 2001 From: trchudley Date: Tue, 23 Apr 2024 22:25:37 +0100 Subject: [PATCH] update readme for pip packaging --- .gitignore | 24 ++++++++++++++++++------ README.md | 33 +++------------------------------ 2 files changed, 21 insertions(+), 36 deletions(-) diff --git a/.gitignore b/.gitignore index c7f4bdf..53b0419 100644 --- a/.gitignore +++ b/.gitignore @@ -1,11 +1,23 @@ -*.egg-info/ +# Python __pycache__/ .ipynb_checkpoints -gitignore* -.vscode + +# Data example_data/ -.DS_Store *.tif -docs/_build/ -.coverage + +# Distribution / packaging dist/ +build/ +*.egg-info/ + +# Coverage reports +.coverage + +# Documentation +docs/_build/ + +# OS / other +.DS_Store +.vscode +gitignore* diff --git a/README.md b/README.md index 8f1cb56..3246b4a 100644 --- a/README.md +++ b/README.md @@ -24,34 +24,7 @@ Rather than introducing custom classes, pDEMtools will always try and return DEM Please visit the [pDEMtools ReadTheDocs](https://pdemtools.readthedocs.io/en/latest/index.html) for more information on installing and using pDEMtools. -# Examples - -Quickly download and filter the ArcticDEM/REMA mosaic, and generate various terrain attributes such as hillshade and curvatures ([see notebook](./notebooks/mosaic_and_terrain.ipynb)): - -

- - An example of various terrain attributes derived from a filtered ArcticDEM mosaic - -

- -Search and download ArcticDEM/REMA strips, with easy coregistration to assess elevation change ([see notebook](./notebooks/strip_search_and_dem_difference.ipynb)): - -

- - Vertical elevation change between multitemporal ArcticDEM strips - -

- -Easy filtering of ocean/mélange, allowing for assessment of calving fronts and icebergs ([see notebook](./notebooks/get_icebergs.ipynb)): - -

- - Iceberg height above the ocean extracted from an ArcticDEM strip - -

- -An example batch download and coregistration script is also included in the `batch` directory as a jumping-off point for large-scale projects. - +Contact: thomas.r.chudley@durham.ac.uk # Cite @@ -62,13 +35,13 @@ Update when v.1.0 uploaded to Zendoo. The use of the pDEMtools package can be cited as follows: -> Chudley, T. R. (2023) pDEMtools (v0.6). GitHub. https://github.com/trchudley/pDEMtools +> Chudley, T. R. (2023) pDEMtools (vX.X). GitHub. https://github.com/trchudley/pDEMtools or by using `bibtex`: ``` @software{pDEMtools - author = {Chudley, Thomas Russell}, title = {pDEMtools}, year = 2023, publisher = {GitHub}, version = {0.6}, url = {https://github.com/trchudley/pDEMtools} + author = {Chudley, Thomas Russell}, title = {pDEMtools}, year = 2023, publisher = {GitHub}, version = {X.X}, url = {https://github.com/trchudley/pDEMtools} } ```