r.dsm.import - GRASS manual

NAME

r.dsm.import - Downloads DSM for specified federal state and aoi.

KEYWORDS

raster, import, DOM, DSM, open-geodata-germany

SYNOPSIS

r.dsm.import

r.dsm.import --help

r.dsm.import [-kr] [aoi=name] [federal_state=string[,string,...]] [federal_state_file=name] [local_data_dir=name] [download_dir=string] [alignment_raster=name] output=name [metadata=string] [metadata_file=string] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-k: Keep downloaded data in the download directory
-r: Use native data resolution
--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

aoi=name: Name of input vector map; Polygon of the area of interest to set region
federal_state=string[,string,...]: Federal state(s) related to the area of interest e.g.:"Nordrhein-Westfalen"; Options: Berlin, BE, Baden-Württemberg, BW, Bayern, BY, Brandenburg, BB, Hamburg, HB, Bremen, HH, Hessen, HE, NI, Niedersachsen, Sachsen, SN, Thüringen, TH
federal_state_file=name: Path to text file containing the federal state(s) related to the area of interest
local_data_dir=name: Directory with raster map of DSMs to import (e.g. VRT)
download_dir=string: Path to output folder; Path to download folder
alignment_raster=name: Name of raster map, used for raster alignment (if not given, dem extent and region resolution is used)
output=name [required]: Name for output raster map
metadata=string: Path to metadata output file (markdown format); Default:
metadata_file=string: Temporary file for metadata URLs (used by r.ndsm.import)

DESCRIPTION
EXAMPLE
- Use local DSM
AUTHORS

DESCRIPTION

r.dsm.import downloads and imports digital surface models (DSM, in German DOM) for specified federal state and area of interest.
Alternatively, local data can be imported. Implemented federal state options are:

Baden-Württemberg (BW): only local data import
Bayern (BY): only local data import
Brandenburg (BB)
Berlin (BE)
Bremen (HB)
Hamburg (HH)
Hessen (HE)
Sachsen (SN)
Thüringen (TH)

For local data import the parameter local_data_dir has to be given and the folder structure has to be as follows:

/path/to/DSMs/
├── BW/*.vrt
└── NW/*.tif
└── ...

In the federal state folders the addons searches for a vrt file or if none is given all tifs will be imported. If local data does not overlap with aoi, data will be downloaded from Open Data portals if federal state supports Open Data.

EXAMPLE

Use local DSM

Import local DSM with native resolution:

r.dsm.import fs=BW aoi=aoi_BW output=dsm_BW local_data_dir=/path/to/DSMs/ -r

AUTHORS

Veronica Koess, mundialis GmbH & Co. KG
Anika Weinmann, mundialis GmbH & Co. KG

SOURCE CODE

Available at: r.dsm.import source code (history)

Accessed: Monday Jul 27 12:28:20 2026