pDEMtools

pDEMtools: conveniently search, download, and process ArcticDEM and REMA products - Published in JOSS (2024)

https://github.com/trchudley/pdemtools

Science Score: 100.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 18 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org
  • Committers with academic emails
    1 of 7 committers (14.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

arcticdem coregistration dem digital-elevation-model geospatial glaciers glaciology polar-geospatial-center python rema terrain-analysis

Scientific Fields

Engineering Computer Science - 40% confidence
Last synced: 4 months ago · JSON representation ·

Repository

Conveniently search, download, and process ArcticDEM and REMA products

Basic Info
Statistics
  • Stars: 29
  • Watchers: 3
  • Forks: 5
  • Open Issues: 0
  • Releases: 9
Topics
arcticdem coregistration dem digital-elevation-model geospatial glaciers glaciology polar-geospatial-center python rema terrain-analysis
Created over 2 years ago · Last pushed 4 months ago
Metadata Files
Readme License Citation

README.md

pDEMtools

Conveniently search, download, and process ArcticDEM and REMA products

conda-forge version PyPI version Documentation Status Unit Tests JOSS paper

pDEMtools 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 allow users to easily query the PGC STAC API to 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 DataArray with geospatial metadata via the rioxarray 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 for advanced coregistration or 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 for more information on installing, using, and contributing to pDEMtools.

Cite

A software paper for pdemtools is published in the Journal of Open Source Software, and can be cited as follows:

Chudley, T. R., and Howat, I. M. (2024). pDEMtools: conveniently search, download, and process ArcticDEM and REMA products. Journal of Open Source Software, 9(102), 7149, doi.org/10.21105/joss.07149

or by using bibtex:

@article{Chudley2024, title = {pDEMtools: conveniently search, download, and process ArcticDEM and REMA products}, volume = {9}, ISSN = {2475-9066}, url = {http://dx.doi.org/10.21105/joss.07149}, DOI = {10.21105/joss.07149}, number = {102}, journal = {Journal of Open Source Software}, publisher = {The Open Journal}, author = {Chudley, Thomas R. and Howat, Ian M.}, year = {2024}, pages = {7149} }

When using ArcticDEM and REMA products, please cite the datasets appropriately and acknowledge 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).

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.

Owner

  • Name: Tom Chudley
  • Login: trchudley
  • Kind: user
  • Location: Durham, UK
  • Company: Sea Level, Ice and Climate Research Cluster, Durham University

JOSS Publication

pDEMtools: conveniently search, download, and process ArcticDEM and REMA products
Published
October 23, 2024
Volume 9, Issue 102, Page 7149
Authors
Thomas R. Chudley ORCID
Department of Geography, Durham University, Durham, UK
Ian M. Howat ORCID
Byrd Polar and Climate Research Center, Ohio State University, Columbus, OH, USA, School of Earth Sciences, Ohio State University, Columbus, OH, USA
Editor
Adam R. Jensen ORCID
Tags
digital-elevation-models remote-sensing geomorphometry glaciology Greenland Antarctica arctic

Citation (CITATION.cff)

cff-version: "1.2.0"
authors:
- family-names: Chudley
  given-names: Thomas R.
  orcid: "https://orcid.org/0000-0001-8547-1132"
- family-names: Howat
  given-names: Ian M.
  orcid: "https://orcid.org/0000-0002-8072-6260"
contact:
- family-names: Chudley
  given-names: Thomas R.
  orcid: "https://orcid.org/0000-0001-8547-1132"
doi: 10.5281/zenodo.13936813
message: If you use this software, please cite our article in the
  Journal of Open Source Software.
preferred-citation:
  authors:
  - family-names: Chudley
    given-names: Thomas R.
    orcid: "https://orcid.org/0000-0001-8547-1132"
  - family-names: Howat
    given-names: Ian M.
    orcid: "https://orcid.org/0000-0002-8072-6260"
  date-published: 2024-10-23
  doi: 10.21105/joss.07149
  issn: 2475-9066
  issue: 102
  journal: Journal of Open Source Software
  publisher:
    name: Open Journals
  start: 7149
  title: "pDEMtools: conveniently search, download, and process
    ArcticDEM and REMA products"
  type: article
  url: "https://joss.theoj.org/papers/10.21105/joss.07149"
  volume: 9
title: "pDEMtools: conveniently search, download, and process ArcticDEM
  and REMA products"

GitHub Events

Total
  • Create event: 7
  • Release event: 3
  • Issues event: 5
  • Watch event: 12
  • Delete event: 2
  • Issue comment event: 10
  • Push event: 33
  • Pull request event: 6
  • Fork event: 2
Last Year
  • Create event: 7
  • Release event: 3
  • Issues event: 5
  • Watch event: 12
  • Delete event: 2
  • Issue comment event: 10
  • Push event: 33
  • Pull request event: 6
  • Fork event: 2

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 152
  • Total Committers: 7
  • Avg Commits per committer: 21.714
  • Development Distribution Score (DDS): 0.099
Past Year
  • Commits: 61
  • Committers: 3
  • Avg Commits per committer: 20.333
  • Development Distribution Score (DDS): 0.115
Top Committers
Name Email Commits
trchudley t****y 137
Adam R. Jensen 3****n 5
Tom Chudley t****m@t****k 3
jkingslake 4****e 2
Ian Howat i****t@g****m 2
Tom Chudley t****m@T****n 2
Adrien Wehrlé a****e@h****r 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 19
  • Total pull requests: 27
  • Average time to close issues: 2 days
  • Average time to close pull requests: about 9 hours
  • Total issue authors: 6
  • Total pull request authors: 5
  • Average comments per issue: 3.05
  • Average comments per pull request: 0.11
  • Merged pull requests: 25
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 16
  • Pull requests: 15
  • Average time to close issues: 2 days
  • Average time to close pull requests: about 13 hours
  • Issue authors: 3
  • Pull request authors: 3
  • Average comments per issue: 2.81
  • Average comments per pull request: 0.2
  • Merged pull requests: 13
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • AdamRJensen (9)
  • maiwinstrup (7)
  • geograFie (1)
  • mn5hk (1)
  • jkingslake (1)
Pull Request Authors
  • trchudley (25)
  • AdamRJensen (12)
  • ihowat (3)
  • AdrienWehrle (1)
  • jkingslake (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 43 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 10
  • Total maintainers: 1
pypi.org: pdemtools

Conveniently search, download, and preprocess ArcticDEM and REMA products.

  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 43 Last month
Rankings
Dependent packages count: 9.4%
Average: 35.8%
Dependent repos count: 62.2%
Maintainers (1)
Last synced: 4 months ago