``generic-tif`` Geospatial Dataset
==================================

In this file, the necessary technical details of the dataset is
explained.

Location of the ``generic-tif`` Dataset Files
---------------------------------------------

This dataset can process any GeoTIFF file and is designed to handle
those data bases without any specific structure. Current datasets that
can be processed by this recipe along with their HPC locations are
listed below. These paths can be used as values for the
``--dataset-dir`` argument:

.. code:: console

   # UCalgary ARC Cluster
   /work/comphyd_lab/data/geospatial-data/hawaii_dem/3mDEM # High resolution Hawaii DEM
   /work/comphyd_lab/data/geospatial-data/iceland_dem # High resolution Iceland DEM
   /work/comphyd_lab/data/geospatial-data/baker_creek_dem # High resolution Baker Creek DEM
   /work/comphyd_lab/data/geospatial-data/wolf_creek_dem # High resolution Wolf Creek DEM
   /work/comphyd_lab/data/geospatial-data/marmot_creek_dem # High resolution Marmot Creek DEM
   
   # DRAC Fir Allocation Cluster
   /project/rrg-alpie/data/geospatial-data/* # rrg-alpie allocation
   /project/rrg-alpie/data/geospatial-data/canelevation-dem/mrdem-30 # 30-meter MRDEM DSM and DTM layers

Dataset Variables
-----------------

This variables of this dataset are detailed in the table below:

+---+-----------+-----------------------------+---------------------+----------+
| # | Dataset   | Variable Name(s) (value for | Description         | Comments |
|   | Directory | ``--variables``)            |                     |          |
+===+===========+=============================+=====================+==========+
| 1 | Hawaii    | ``Big_Island.tif``,         | High-resolution DEM |  [1]_    |
|   | DEM       | ``Kahoolawe.tif``,          | of Hawaii islands   |          |
|   |           | ``Kauai_Puuwai.tif``,       |                     |          |
|   |           | ``Lanai.tif``,              |                     |          |
|   |           | ``Maui.tif``,               |                     |          |
|   |           | ``Molokai.tif``,            |                     |          |
|   |           | ``Oahu.tif``                |                     |          |
+---+-----------+-----------------------------+---------------------+----------+
| 2 | Iceland   | ``merged_iceland_dem.tif``  | High-resolution DEM |  [2]_    |
|   | DEM       |                             | of Iceland          |          |
+---+-----------+-----------------------------+---------------------+----------+
| 3 | Baker     | ``baker-creek-10m-DEM.tif`` | 10-m LiDAR DEM of   |  [3]_    |
|   | Creek DEM |                             | the Baker Creek     |          |
|   |           |                             | River Basin, NWT,   |          |
|   |           |                             | Canada              |          |
+---+-----------+-----------------------------+---------------------+----------+
| 4 | Wolf      | ``wolf-creek-30m-DEM.tif``  | 30-m LiDAR DEM of   |  [4]_    |
|   | Creek DEM |                             | the Wolf Creek      |          |
|   |           |                             | River Basin, YT,    |          |
|   |           |                             | Canada              |          |
+---+-----------+-----------------------------+---------------------+----------+
| 5 | Marmot    | ``marmot-creek-8m-DEM.tif`` | 8-m LiDAR DEM of    |  [5]_    |
|   | Creek DEM |                             | the Marmot Creek    |          |
|   |           |                             | River Basin, AB,    |          |
|   |           |                             | Canada              |          |
+---+-----------+-----------------------------+---------------------+----------+
| 6 | MRDEM     | ``mrdem-30-dsm.tif`` &      | 30m DSM and DTM     |  [6]_    |
|   |           | ``mrdem-30-dtm.tif``        | layers of Canada    |          |
|   |           |                             |                     |          |
|   |           |                             |                     |          |
+---+-----------+-----------------------------+---------------------+----------+

.. [1]
   NOAA National Centers for Environmental Information (NCEI). (2021).
   Continuously Updated Digital Elevation Model (CUDEM) – Ninth
   Arc-Second Resolution Bathymetric-Topographic Tiles: Hawaii Data set
   (Tile Cluster 9428; fileIdentifier gov.noaa.ngdc.mgg.dem:299919).
   NOAA. Retrieved September 12, 2024, from
   https://noaa-nos-coastal-lidar-pds.s3.amazonaws.com/dem/NCEI_ninth_Topobathy_Hawaii_9428/index.html

.. [2]
   National Land Survey of Iceland (Landmælingar Íslands). (2016).
   ÍslandsDEM v1.0 [Digital Elevation Model of Iceland, 10 m
   resolution]. License: CC BY 4.0. Available at
   https://atlas.lmi.is/dem or
   https://dem.lmi.is/mapview/?application=DEM.

.. [3]
   Spence, C., Hedstrom, N. (2018). Baker Creek Research Catchment
   Hydrometeorological and Hydrological Data. Federated Research Data
   Repository. https://doi.org/10.20383/101.026

.. [4]
   Rasouli, K., Pomeroy, J. W., Janowicz, J. R., Williams, T. J., &
   Carey, S. K. (2019). A long-term hydrometeorological dataset
   (1993–2014) of a northern mountain basin: Wolf Creek Research Basin,
   Yukon Territory, Canada. Earth System Science Data, 11(1), 89-100,
   https://doi.org/10.5194/essd-11-89-2019

.. [5]
   Fang, X., Pomeroy, J. W., DeBeer, C. M., Harder, P., and Siemens, E.
   (2019). Hydrometeorological data from Marmot Creek Research Basin,
   Canadian Rockies. Earth Syst. Sci. Data, 11, 455–471,
   https://doi.org/10.5194/essd-11-455-2019.

.. [6]
   H. McGrath et al., "Descriptor: Medium Resolution Digital Elevation
   Model From Natural Resources Canada’s CanElevation Series (MRDEM-30),"
   in IEEE Data Descriptions, vol. 2, pp. 211-217, 2025,
   doi: 10.1109/IEEEDATA.2025.3576318.