process various elevation datasets.
dlim [ -acdghijnquwEJPRT [ args ] ] DATALIST,FORMAT,WEIGHT,UNCERTAINTY ...
dlim is the elevation data processing tool using various dataset modules (Table 1). dlim's native dataset format is a "datalist". A datalist is similar to an MBSystem datalist; it is a space-delineated file containing the following columns:
data-path data-format data-weight data-uncertainty data-name data-source data-date data-resolution data-type data-horz data-vert data-url
Minimally, data-path (column 1) is all that is needed.
An associated inf and geojson file will be gerenated for each datalist while only an associated inf file will be genereated for individual datasets
Parse various dataset types by region/increments and yield data as xyz or array recursive data-structures which point to datasets (datalist, zip, fetches, etc) are negative format numbers, e.g. -1 for datalist
-R, --region
Restrict processing to the desired REGION
Where a REGION is xmin/xmax/ymin/ymax[/zmin/zmax[/wmin/wmax/umin/umax]]
Use '-' to indicate no bounding range; e.g. -R -/-/-/-/-10/10/1/-/-/-
OR an OGR-compatible vector file with regional polygons.
Where the REGION is /path/to/vector[:zmin/zmax[/wmin/wmax/umin/umax]].
If a vector file is supplied, will use each region found therein.
-E, --increment
Block data to INCREMENT in native units.
Where INCREMENT is x-inc[/y-inc]
-X, --extend
Number of cells with which to EXTEND the output DEM REGION and a
percentage to extend the processing REGION.
Where EXTEND is dem-extend(cell-count)[:processing-extend(percentage)]
e.g. -X6:10 to extend the DEM REGION by 6 cells and the processing region by 10
percent of the input REGION.
-J, --s_srs
Set the SOURCE projection.
-P, --t_srs
Set the TARGET projection. (REGION should be in target projection)
-D, --cache-dir
CACHE Directory for storing temp and output data.
-Z, --z-precision
Set the target precision of dumped z values. (default is 4)
-A, --stack-mode
Set the STACK MODE to 'mean', 'min', 'max' or 'supercede' (with -E and -R)
-T, --stack_filter
FILTER the data stack using one or multiple filters.
Where FILTER is fltr_name[:opts] (see grits --modules for more information)
The -T switch may be set multiple times to perform multiple filters.
Available FILTERS: blur, grdfilter, outliers, flats
-F, --point_filter
FILTER the POINT data using one or multiple filters.
Where FILTER is fltr_name[:opts]
The -F switch may be set multiple times to perform multiple filters.
Available FILTERS: bin_z
--mask
MASK the datalist to the given REGION/INCREMENTs
--spatial-metadata
Generate SPATIAL METADATA of the datalist to the given REGION/INCREMENTs
--archive
ARCHIVE the datalist to the given REGION[/INCREMENTs]
--glob
GLOB the datasets in the current directory to stdout
--info
Generate and return an INFO dictionary of the dataset
--weights
Output WEIGHT values along with xyz
--uncertainties
Output UNCERTAINTY values along with xyz
--stack-node
Output stacked x/y data rather than pixel
--quiet
Lower the verbosity to a quiet
--modules
Display the datatype descriptions and usage
--help
Print the usage text
--version
Print the version information
Table 1. Dataset modules available in the CUDEM software tool "dlim"
| Name | dlim dataset module code | Description |
|---|---|---|
| datalist | -1 | An extended MB-System style datalist containting dlim-compatible datasets |
| zip | -2 | A zipfile containing dlim-compatible datasets |
| scratch | -3 | A scratch dataset, including a python list of dlim-compatible datasets |
| yxz | 167 | An ascii DSV datafile formatted as y,x,z |
| xyz | 168 | An ascii DSV datafile formatted as x,y,z |
| gdal | 200 | A gdal-compatible raster dataset |
| bag | 201 | A BAG bathymetry dataset |
| swot_pixc | 202 | An HDF5 SWOT PIXC datafile |
| swot_hr_raster | 203 | an HDF5 SWOT HR Raster datafile |
| las | 300 | An las or laz lidar datafile |
| mbs | 301 | An MB-System-compatible multibeam datafile |
| ogr | 302 | An ogr-compatible vector datafile |
| icesat2_atl | 303 | An HDF5 IceSat2 ATL03 datafile |
| https | -100 | a URL pointing to a dlim-compatible datafile |
| gmrt | -101 | The GMRT fetches module |
| gebco | -102 | The GEBCO fetches module |
| copernicus | -103 | The Copernicus fetches module |
| fabdem | -104 | The FABDEM fetches module |
| nasadem | -105 | The NASADEM fetches module |
| mar_grav | -106 | The mar_grav fetches module |
| srtm_plus | -107 | The srtm_plus fetches module |
| charts | -200 | The charts fetches module |
| multibeam | -201 | The multibeam fetches module |
| hydronos | -202 | The hydronos fetches module |
| ehydro | -203 | The ehydro fetches module |
| bluetopo | -204 | The bluetopo fetches module |
| ngs | -205 | The ngs fetches module |
| tides | -206 | The tids fetches module |
| digital_coast | -207 | The digital_coast fetches module |
| ncei_thredds | -208 | The ncei_thredds fetches module |
| tnm | -209 | The TNM fetches module |
| CUDEM | -210 | The CUDEM fetches module |
| CoNED | -211 | The CoNED fetches module |
| SLR | -212 | The SLR fetches module |
| waterservies | -213 | The waterservices fetches module |
| icesat2 | -214 | The IceSat2 fetches module |
| ned | -215 | The NED fetches module |
| swot | -216 | The SWOT fetches module |
| csb | -217 | the CSB fetches module |
| emodnet | -300 | The emodnet fetches module |
| chs | -301 | The chs fetches module |
| hrdem | -302 | The hrdem fetches module |
| arcticdem | -303 | The arcticdem fetches module |
| vdatum | -500 | The vdatum fetches module |
| hydrolakes | -600 | The hydrolakes fetches module |