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

READMEs for arctic dem add-on #800

Merged
merged 3 commits into from
Aug 31, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions qgreenland/addons-readme.txt
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file contains text that can replace what's currently on our website for ArcticDEM:

32-meter resolution ArcticDEM (digital elevation model): The Polar Geospatial Center has provided a custom Greenland 32-m resolution ArcticDEM for added detail. Download this add-on package and place it in a suitable location in your filesystem. Unzip the package and then follow the directions in the 'README.txt' file included.

Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
32-meter resolution ArcticDEM (digital elevation model): The Polar Geospatial
Center has provided a custom Greenland 32m resolution ArcticDEM for added
detail. Two download packages are provided for the v4.1 ArcitcDEM:

* arcticdem_v4.1_32m_greenland_dem_only.zip: A ~4.1GB package containing only
the 32-m resolution DEM.

* arcticdem_v4.1_32m_greenland_dem_full.zip: A ~9.5GB package containing the
32-m resolution DEM and ancillary datasets (e.g., a "count" dataset giving the
number of contributing DEMs for each pixel).

Download one of these add-on packages and place it in a suitable location in your
filesystem. Unzip the package and then follow the directions in the 'README.txt'
file included.
54 changes: 54 additions & 0 deletions qgreenland/arctic-dem-dem-only-readme.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
-------------------
Getting Started:
-------------------

This package consists of many small raster images (tiles) which together make up
a larger 32m resolution Arctic DEM mosaic of Greenland. To add this data to
QGIS, navigate in the **Menu Bar** to **Layer -> Add Layer -> Add Raster Layer**
and browse to and select the included .vrt file as the layer source. This .vrt
file references all of the individual tiles in the `tiles/` subdirectory, and
allows them all to be loaded as a single mosaiced raster layer in QGIS. More
information about VRTs can be found here:
https://gdal.org/drivers/raster/vrt.html.


-------------------
Building Overviews:
-------------------

Because this dataset is large and consists of many smaller files, performance of
the layer after initially loading it into QGIS may be slow. We recommend that
users build raster overviews for this data, which will increase the rendering
speed when zooming in/out with the 32m Arctic DEM enabled.

To build overviews in QGIS, navigate in the **Menu Bar** to **Raster ->
Miscellaneous -> Build Overviews (Pyramids)** . Select the 32m Arctic DEM as the
input layer, and then click **Run** (leave the rest of the parameters as their
defaults). This process will take several minutes and produce a new `.ovr` file
in the data directory. The new `.ovr` file is expected to be ~5.5GB in size, and
there is no need to interact with this new file.


-------------------
Styling this data:
-------------------

For information on changing the symbology of raster layers in QGIS, see:

* QGIS lesson on changing raster symbology:
https://docs.qgis.org/3.28/en/docs/training_manual/rasters/changing_symbology.html

* QGIS documentation on raster symbology properties:
https://docs.qgis.org/3.28/en/docs/user_manual/working_with_raster/raster_properties.html#symbology-properties


-------------------
Citing this data:
-------------------

The ArcticDEM dataset should be cited as follows:

Porter, C., Howat, I., Noh, M.J., Husby, E., Khuvis, S., Danish, E., Tomko, K.,
Gardiner, J., Negrete, A., Yadav, B., Klassen, J., Kelleher, C., Cloutier, M.,
Bakker, J., Enos, J., Arnold, G., Bauer, G., and Morin, P., 2023, "ArcticDEM
- Mosaics, Version 4.1", https://doi.org/10.7910/DVN/3VDC4W
76 changes: 76 additions & 0 deletions qgreenland/arctic-dem-full-package-readme.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
-------------------
Getting Started:
-------------------

This package contains the 32m Arctic DEM and ancillary data:

* arcticdem_v4.1_32m_dem_greenland.vrt: 32-bit floating point elevation
raster. This is the primary DEM tile datafile.

* arcticdem_v4.1_32m_browse_greenland.vrt: 32m DEM hillshade.

* arcticdem_v4.1_32m_datamask_greenland.vrt: Raster indicating DEM pixels with
heights purely sourced from SETSM output (1) versus those that have been
filled/merged with another dataset or mask out as NoData in quality control
steps (0).

* arcticdem_v4.1_32m_count_greenland.vrt: Number of contributing DEMs.

* arcticdem_v4.1_32m_mad_greenland.vrt: Median absolute deviation of
contributing DEMs.

* arcticdem_v4.1_32m_maxdate_greenland.vrt: Latest date of contributing DEMs in
days since Jan 1, 2000.

* arcticdem_v4.1_32m_mindate_greenland.vrt: Earliest date of contributing DEMs
in days since Jan 1, 2000.

Many small raster images (tiles) make up each of these layers to make a mosaic
of Greenland. To add this data to QGIS, navigate in the **Menu Bar** to **Layer
-> Add Layer -> Add Raster Layer** and browse to and select one of the included
.vrt files as the layer source. This .vrt file references all of the individual
tiles in the layer's associated `tiles/` subdirectory, and allows them all to be
loaded as a single mosaiced raster layer in QGIS. More information about VRTs
can be found here: https://gdal.org/drivers/raster/vrt.html.


-------------------
Building Overviews:
-------------------

Because each layer is large and consists of many smaller files, performance of
each layer after initially loading it into QGIS may be slow. We recommend that
users build raster overviews for each layer, which will increase the rendering
speed when zooming in/out.

To build overviews for a layer in QGIS, navigate in the **Menu Bar** to **Raster
-> Miscellaneous -> Build Overviews (Pyramids)** . Select the layer as the input
trey-stafford marked this conversation as resolved.
Show resolved Hide resolved
layer, and then click **Run** (leave the rest of the parameters as their
defaults). This process will take several minutes and produce a new `.ovr` file
in the data directory. The new `.ovr` file is expected to be several GB in size,
and there is no need to interact with this new file.


-------------------
Styling this data:
-------------------

For information on changing the symbology of raster layers in QGIS, see:

* QGIS lesson on changing raster symbology:
https://docs.qgis.org/3.28/en/docs/training_manual/rasters/changing_symbology.html

* QGIS documentation on raster symbology properties:
https://docs.qgis.org/3.28/en/docs/user_manual/working_with_raster/raster_properties.html#symbology-properties


-------------------
Citing this data:
-------------------

The ArcticDEM dataset should be cited as follows:

Porter, C., Howat, I., Noh, M.J., Husby, E., Khuvis, S., Danish, E., Tomko, K.,
Gardiner, J., Negrete, A., Yadav, B., Klassen, J., Kelleher, C., Cloutier, M.,
Bakker, J., Enos, J., Arnold, G., Bauer, G., and Morin, P., 2023, "ArcticDEM
- Mosaics, Version 4.1", https://doi.org/10.7910/DVN/3VDC4W