Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

v1.0.0 #41

Merged
merged 18 commits into from
Jan 27, 2025
Prev Previous commit
Next Next commit
v1 minor code checks
trchudley committed Jan 27, 2025
commit b144268274efe5261979409b245fa5d55f4861c9
2 changes: 1 addition & 1 deletion docs/getting_started/supplementary_datasets.md
Original file line number Diff line number Diff line change
@@ -11,7 +11,7 @@ The appropriate versions of BedMachine, in netcdf format, can be downloaded from

## ArcticDEM/REMA strip index

As of `pdemtools v1.0.0`, the `pdt.search()` functions search the ArcticDEM and REMA strips by seamlessly quering to the online PGC dynamic STAC API. Prior to this, a local ArcticDEM or REMA strip index was required to be downloaded. The functionality to search a local copy of the index is still available within the `pdt.search()` function, and may be useful for those that do not wish to rely on an online connection to search the PGC catalogue.
As of `pdemtools` `v1.0.0`, the `pdt.search()` functions search the ArcticDEM and REMA strips by seamlessly quering to the online PGC dynamic STAC API. Prior to this, a local ArcticDEM or REMA strip index was required to be downloaded. The functionality to search a local copy of the index is still available within the `pdt.search()` function, and may be useful for those that do not wish to rely on an online connection to search the PGC catalogue.

ArcticDEM or REMA strip index GeoParquet files can be downloaded from the PGC ([Greenland](https://data.pgc.umn.edu/elev/dem/setsm/ArcticDEM/indexes/), [Antarctica](https://data.pgc.umn.edu/elev/dem/setsm/REMA/indexes/)). The appriate files to download are the `ArcticDEM_Strip_Index_s2s041_gpqt.zip` and `REMA_Strip_Index_s2s041_gpkg.zip` - note the __GeoParquet file format__ (ending `_gpqt.zip`), *not* the similarly named GeoPackage (ending `_gpkg.zip`). No mosaic files are necessary - these are included with `pdemtools`.

2 changes: 1 addition & 1 deletion docs/getting_started/why_pdemtools.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Why pDEMtools?

> This page is based on the 'Statement of Need' of the [_Journal of Open Source Software_ manuscript](http://dx.doi.org/10.21105/joss.07149) for `pdemtools`, and will be updated as both `pdemtools` and the ArcticDEM and REMA projects evolve. Last updated 2025-01-25 for `pdemtools v1.0.0`.
> This page is based on the 'Statement of Need' of the [_Journal of Open Source Software_ manuscript](http://dx.doi.org/10.21105/joss.07149) for `pdemtools`, and will be updated as both `pdemtools` and the ArcticDEM and REMA projects evolve. Last updated 2025-01-25 for `pdemtools` `v1.0.0`.
[ArcticDEM](https://www.pgc.umn.edu/data/arcticdem/) and [REMA](https://www.pgc.umn.edu/data/rema/) are high-resolution, time-stamped 2-metre-resolution DEMs of the polar regions provided by the Polar Geospatial Center (PGC). They are extracted by applying stereo auto-correlation techniques ([Noh & Howat, 2017](https://doi.org/10.1016/j.isprsjprs.2017.04.019)) to pairs of submetre Maxar satellite imagery. The data includes Worldview-1, Worldview-2, Worldview-3, and GeoEye-1, beginning in 2007 (ArcticDEM) or 2009 (REMA) and ongoing to the present day. Products are available as tens of thousands of time-stamped 'strips' ([Porter _et al._ 2022](ttps://doi.org/10.7910/DVN/OHHUKH); [Howat _et al._ 2022a](https://doi.org/10.7910/DVN/X7NDNY)) constructed from individual scene pairs, or as a single mosaic ([Porter _et al._ 2023](https://doi.org/10.7910/DVN/3VDC4W); [Howat _et al._ 2022a](https://doi.org/10.7910/DVN/EBW8UC)) compiled from the combined stack of strips. Strips allow users to perform change detection by comparing data from different seasons or years, whilst mosaics provide a consistent and comprehensive product over the entire polar regions.