coincident.io.xarray.load_ncalm_dem#

coincident.io.xarray.load_ncalm_dem(aoi, dataset_id, product, res=1, clip=True)#

Load NCALM DEM (DTM or DSM) tiles directly from OpenTopography S3 and return as xarray DataArray.

NCALM provides:
  • DTM (bare-earth) with file code GEG in folder suffix ‘_be’

  • DSM (first-return) with file code GEF in folder suffix ‘_hh’

Parameters:
  • aoi (geopandas.GeoDataFrame) – Area of interest geometries (in EPSG:4326).

  • dataset_id (str or int) – NCALM dataset identifier (e.g., ‘WA18_Wall’).

  • product (str) – ‘dtm’ for bare-earth, ‘dsm’ for first-return.

  • res (int, optional) – Factor to coarsen the DEM (default 1 = no coarsening).

  • clip (bool, optional) – Whether to clip final mosaic to the AOI (default True).

Returns:

DEM tile arrays or merged mosaic with name ‘elevation’.

Return type:

xarray.DataArray or list of xarray.DataArray