| Name | pdemtools JSON |
| Version |
0.8.5
JSON |
| download |
| home_page | None |
| Summary | Conveniently search, download, and preprocess ArcticDEM and REMA products. |
| upload_time | 2024-10-15 18:19:56 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
geospatial
elevation
arcticdem
rema
dem
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# pDEMtools
__Conveniently search, download, and process ArcticDEM and REMA products__
[](https://anaconda.org/conda-forge/pdemtools) [](https://pypi.org/project/pdemtools/) [](https://pdemtools.readthedocs.io/en/latest/?badge=latest) [](https://github.com/trchudley/pdemtools/actions/workflows/unit_test.yml) [](https://joss.theoj.org/papers/2a10e67d2709a6cfb672538b4a21726e)
pDEMtool provides a convenient set of functions to explore, download, and preprocess high-resolution DEMs of the polar regions from the ArcticDEM (Porter _et al._ 2022; 2023) and Reference Elevation Model of Antarctica (REMA; Howat _et al._ 2022a, b) products, courtesy of the Polar Geospatial Center (PGC).
The first aim of pDEMtools is to enable access to ArcticDEM and REMA mosaics and multitemporal strips using the `search()` function and `load` module:
- **`search()`**: This function aims to replicate the kind of convenient catalogue searching available when querying a dynamic STAC catalogue (e.g. `pystac_client`), allowing users to easily find relevant ArcticDEM and REMA strips for their areas of interest.
- **`load`**: This module provides simple one-line functions to preview and download strips and mosaics from the relevant AWS bucket to an `xarray` Dataset.
The second aim is to provide (pre)processing functions _specific_ to the sort of uses that ArcticDEM and REMA users might want (e.g. a focus on ice sheet and cryosphere work), as well as the particular _strengths_ of ArcticDEM and REMA datasets (high-resolution and multitemporal). Tools include:
- Terrain attribute derivation (hillshade, slope, aspect, various curvatures) using a 5x5 polynomial fit suited for high-resolution data.
- Quick geoid correction using BedMachine source data.
- Simple coregistration for quick elevation change analysis.
- Identifying/masking sea level and icebergs.
Rather than introducing custom classes, pDEMtools will always try and return DEM data as an [`xarray`](https://docs.xarray.dev/en/stable/) DataArray with geospatial metadata via the [`rioxarray`](https://corteva.github.io/rioxarray/stable/) extension. The aim is to allow the user to quickly move beyond pDEMtools into their own analysis in whatever format they desire, be that `xarray`, `numpy` or `dask` datasets, DEM-specific Python packages such as [`xdem`](https://github.com/GlacioHack/xdem) for advanced coregistration or [`richdem`](https://github.com/r-barnes/richdem) for flow analysis, or exporting to geospatial file formats for analysis beyond Python.
Contact: thomas.r.chudley@durham.ac.uk
## Quick Install
The latest release of pdemtools can installed using `conda`:
```
$ conda install pdemtools -c conda-forge
```
Please visit the [pDEMtools readthedocs](https://pdemtools.readthedocs.io/) for more information on installing, using, and contributing to pDEMtools.
## Cite
<!--
Update when v.1.0 uploaded to Zendoo.
-->
A software paper is being prepared for the [Journal of Open Source Software](https://joss.theoj.org/). In the meantime, the use of the pDEMtools package can be cited as follows:
> Chudley, T. R. and Howat, I. M. (2024) pDEMtools: conveniently search, download, and process ArcticDEM and REMA products (vX.X.X). GitHub. https://github.com/trchudley/pDEMtools
or by using `bibtex`:
```
@software{pDEMtools
author = {Chudley, Thomas R. and Howat, Ian M.}, title = {pDEMtools: conveniently search, download, and process ArcticDEM and REMA products}, year = 2024, publisher = {GitHub}, version = {X.X.X}, url = {https://github.com/trchudley/pDEMtools}
}
```
When using ArcticDEM and REMA products, please [cite](#refererences) the datasets appropriately and [acknowledge](#acknowledgements) the PGC.
Several algorithms implemented in the library were developed by others. These will be highlighted in the documentation, and the original authors should be properly cited when used. For example:
> We masked sea ice and melange following the method of Shiggins _et al._ (2023) as implemented in pDEMtools (Chudley and Howat, 2024).
<!-- # To do
The tool is presented _as-is_, but requests/contributions to functionality are welcome (thomas.r.chudley@durham.ac.uk). Avenues for future work include the following:
- Quicker preview downloads of hillshades and DEMs through use of the GeoTIFF overviews and the `rxr.open_rasterio()` `overview_level` function. This can result in uneven x/y resolutions though, so perhaps another option for upsampling may be useful as an accessor utility.
- Implement Ian Howat's blunder filter algorithm. -->
# Refererences
Howat, I., _et al._ (2022a). The Reference Elevation Model of Antarctica – Strips, Version 4.1. _Harvard Dataverse_ https://doi.org/10.7910/DVN/X7NDNY
Howat, I., _et al._ (2022b). The Reference Elevation Model of Antarctica – Mosaics, Version 2, _Harvard Dataverse_ https://doi.org/10.7910/DVN/EBW8UC
Porter, C., _et al._ (2022). ArcticDEM - Strips, Version 4.1. _Harvard Dataverse_. https://doi.org/10.7910/DVN/OHHUKH
Porter, C., _et al._ (2023), ArcticDEM, Version 4.1, _Harvard Dataverse_. https://doi.org/10.7910/DVN/3VDC4W
# Acknowledgements
**ArcticDEM:** DEMs are provided by the Polar Geospatial Center under NSF-OPP awards 1043681, 1559691, and 1542736.
**REMA:** DEMs are provided by the Byrd Polar and Climate Research Center and the Polar Geospatial Center under NSF-OPP awards 1543501, 1810976, 1542736, 1559691, 1043681, 1541332, 0753663, 1548562, 1238993 and NASA award NNX10AN61G. Computer time provided through a Blue Waters Innovation Initiative. DEMs produced using data from Maxar.
Raw data
{
"_id": null,
"home_page": null,
"name": "pdemtools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "geospatial, elevation, arcticdem, rema, dem",
"author": null,
"author_email": "Tom Chudley <thomas.r.chudley@durham.ac.uk>",
"download_url": "https://files.pythonhosted.org/packages/c4/1d/479d03b9ff2f03efc48afe325087b2a9a65640a74d40f0e6523892900e27/pdemtools-0.8.5.tar.gz",
"platform": null,
"description": "# pDEMtools\n\n__Conveniently search, download, and process ArcticDEM and REMA products__\n\n\n[](https://anaconda.org/conda-forge/pdemtools) [](https://pypi.org/project/pdemtools/) [](https://pdemtools.readthedocs.io/en/latest/?badge=latest) [](https://github.com/trchudley/pdemtools/actions/workflows/unit_test.yml) [](https://joss.theoj.org/papers/2a10e67d2709a6cfb672538b4a21726e)\n\n\npDEMtool provides a convenient set of functions to explore, download, and preprocess high-resolution DEMs of the polar regions from the ArcticDEM (Porter _et al._ 2022; 2023) and Reference Elevation Model of Antarctica (REMA; Howat _et al._ 2022a, b) products, courtesy of the Polar Geospatial Center (PGC).\n\nThe first aim of pDEMtools is to enable access to ArcticDEM and REMA mosaics and multitemporal strips using the `search()` function and `load` module:\n\n - **`search()`**: This function aims to replicate the kind of convenient catalogue searching available when querying a dynamic STAC catalogue (e.g. `pystac_client`), allowing users to easily find relevant ArcticDEM and REMA strips for their areas of interest. \n - **`load`**: This module provides simple one-line functions to preview and download strips and mosaics from the relevant AWS bucket to an `xarray` Dataset.\n\nThe second aim is to provide (pre)processing functions _specific_ to the sort of uses that ArcticDEM and REMA users might want (e.g. a focus on ice sheet and cryosphere work), as well as the particular _strengths_ of ArcticDEM and REMA datasets (high-resolution and multitemporal). Tools include:\n\n - Terrain attribute derivation (hillshade, slope, aspect, various curvatures) using a 5x5 polynomial fit suited for high-resolution data.\n - Quick geoid correction using BedMachine source data.\n - Simple coregistration for quick elevation change analysis.\n - Identifying/masking sea level and icebergs.\n\nRather than introducing custom classes, pDEMtools will always try and return DEM data as an [`xarray`](https://docs.xarray.dev/en/stable/) DataArray with geospatial metadata via the [`rioxarray`](https://corteva.github.io/rioxarray/stable/) extension. The aim is to allow the user to quickly move beyond pDEMtools into their own analysis in whatever format they desire, be that `xarray`, `numpy` or `dask` datasets, DEM-specific Python packages such as [`xdem`](https://github.com/GlacioHack/xdem) for advanced coregistration or [`richdem`](https://github.com/r-barnes/richdem) for flow analysis, or exporting to geospatial file formats for analysis beyond Python.\n\nContact: thomas.r.chudley@durham.ac.uk\n\n## Quick Install\n\nThe latest release of pdemtools can installed using `conda`:\n\n```\n$ conda install pdemtools -c conda-forge\n```\n\nPlease visit the [pDEMtools readthedocs](https://pdemtools.readthedocs.io/) for more information on installing, using, and contributing to pDEMtools.\n\n## Cite\n\n<!-- \nUpdate when v.1.0 uploaded to Zendoo.\n -->\n\nA software paper is being prepared for the [Journal of Open Source Software](https://joss.theoj.org/). In the meantime, the use of the pDEMtools package can be cited as follows:\n\n> Chudley, T. R. and Howat, I. M. (2024) pDEMtools: conveniently search, download, and process ArcticDEM and REMA products (vX.X.X). GitHub. https://github.com/trchudley/pDEMtools\n\nor by using `bibtex`:\n\n```\n@software{pDEMtools\n author = {Chudley, Thomas R. and Howat, Ian M.}, title = {pDEMtools: conveniently search, download, and process ArcticDEM and REMA products}, year = 2024, publisher = {GitHub}, version = {X.X.X}, url = {https://github.com/trchudley/pDEMtools} \n}\n```\n\nWhen using ArcticDEM and REMA products, please [cite](#refererences) the datasets appropriately and [acknowledge](#acknowledgements) the PGC.\n\nSeveral algorithms implemented in the library were developed by others. These will be highlighted in the documentation, and the original authors should be properly cited when used. For example:\n\n> We masked sea ice and melange following the method of Shiggins _et al._ (2023) as implemented in pDEMtools (Chudley and Howat, 2024).\n\n<!-- # To do\n\nThe tool is presented _as-is_, but requests/contributions to functionality are welcome (thomas.r.chudley@durham.ac.uk). Avenues for future work include the following:\n\n - Quicker preview downloads of hillshades and DEMs through use of the GeoTIFF overviews and the `rxr.open_rasterio()` `overview_level` function. This can result in uneven x/y resolutions though, so perhaps another option for upsampling may be useful as an accessor utility.\n - Implement Ian Howat's blunder filter algorithm. -->\n\n\n\n# Refererences\n\nHowat, I., _et al._ (2022a). The Reference Elevation Model of Antarctica \u2013 Strips, Version 4.1. _Harvard Dataverse_ https://doi.org/10.7910/DVN/X7NDNY\n\nHowat, I., _et al._ (2022b). The Reference Elevation Model of Antarctica \u2013 Mosaics, Version 2, _Harvard Dataverse_ https://doi.org/10.7910/DVN/EBW8UC\n\nPorter, C., _et al._ (2022). ArcticDEM - Strips, Version 4.1. _Harvard Dataverse_. https://doi.org/10.7910/DVN/OHHUKH\n\nPorter, C., _et al._ (2023), ArcticDEM, Version 4.1, _Harvard Dataverse_. https://doi.org/10.7910/DVN/3VDC4W\n\n\n# Acknowledgements\n\n**ArcticDEM:** DEMs are provided by the Polar Geospatial Center under NSF-OPP awards 1043681, 1559691, and 1542736.\n\n**REMA:** DEMs are provided by the Byrd Polar and Climate Research Center and the Polar Geospatial Center under NSF-OPP awards 1543501, 1810976, 1542736, 1559691, 1043681, 1541332, 0753663, 1548562, 1238993 and NASA award NNX10AN61G. Computer time provided through a Blue Waters Innovation Initiative. DEMs produced using data from Maxar.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Conveniently search, download, and preprocess ArcticDEM and REMA products.",
"version": "0.8.5",
"project_urls": {
"Documentation": "https://pdemtools.readthedocs.io/",
"Homepage": "https://github.com/trchudley/pdemtools",
"Issues": "https://github.com/trchudley/pdemtools/issues",
"Repository": "https://github.com/trchudley/pdemtools"
},
"split_keywords": [
"geospatial",
" elevation",
" arcticdem",
" rema",
" dem"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "47e3183448aed7f24a5c0b8b59c09c16633944a3b7d9b977aef128c4b2fbcc4a",
"md5": "5eb3aac6d27a26b50e35275e2d3193c3",
"sha256": "f2afb0363722305cb4aedb08db8d5d9b9eae08ebd8725a1cfe07fa0302f91745"
},
"downloads": -1,
"filename": "pdemtools-0.8.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5eb3aac6d27a26b50e35275e2d3193c3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 2807861,
"upload_time": "2024-10-15T18:19:54",
"upload_time_iso_8601": "2024-10-15T18:19:54.267600Z",
"url": "https://files.pythonhosted.org/packages/47/e3/183448aed7f24a5c0b8b59c09c16633944a3b7d9b977aef128c4b2fbcc4a/pdemtools-0.8.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c41d479d03b9ff2f03efc48afe325087b2a9a65640a74d40f0e6523892900e27",
"md5": "64d09f3871ab531db5bceda69b82d86c",
"sha256": "08022ff55b9737168cc742bb83f32356e00b62f6091c56a199381ca7789dd3e2"
},
"downloads": -1,
"filename": "pdemtools-0.8.5.tar.gz",
"has_sig": false,
"md5_digest": "64d09f3871ab531db5bceda69b82d86c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 2783480,
"upload_time": "2024-10-15T18:19:56",
"upload_time_iso_8601": "2024-10-15T18:19:56.821909Z",
"url": "https://files.pythonhosted.org/packages/c4/1d/479d03b9ff2f03efc48afe325087b2a9a65640a74d40f0e6523892900e27/pdemtools-0.8.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-15 18:19:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "trchudley",
"github_project": "pdemtools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pdemtools"
}
