r.import.ghs - GRASS manual

NAME

r.import.ghs - Downloads and imports Global Human Settlement data (provided by the JRC, European Commission).

KEYWORDS

raster, import, land cover, classification

SYNOPSIS

r.import.ghs

r.import.ghs --help

r.import.ghs [-r] [ghs_built=name] [ghs_built_s1=name] [ghs_built_s2=name] [directory=name] [memory=memory in MB] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-r: Use region resolution instead of input 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:

ghs_built=name: Output raster map name for GHS-BUILT map; Name for output raster map
ghs_built_s1=name: Output raster map name for GHS-BUILT-S1 map; Name for output raster map
ghs_built_s2=name: Output raster map name for GHS-BUILT-S2 map; Name for output raster map
directory=name: Directory path where to download and temporarily store the data. If not set the data will be downloaded to a temporary directory. The downloaded data will be removed after the import; Name of input directory
memory=memory in MB: Maximum memory to be used (in MB); Cache size for raster rows; Default: 300

DESCRIPTION
REQUIREMENTS
- wget from Python3
EXAMPLES
- Import the GHS-BUILT-S2 dataset for the current computational region:
- Import all datasets for the current computational region:
SEE ALSO
REFERENCES
AUTHOR

DESCRIPTION

r.import.ghs downloads and imports Global Human Settlement (GHS) data representing built-up area from the JRC-GHS website. Data will only be imported for the current computational region. Three datasets are currently supported for download and import:

GHS-BUILT, built-up areas derived from Landsat data, 30m resolution
GHS-BUILT-S1, built-up areas derived from Sentinel-1 data, 10m resolution
GHS-BUILT-S2, built-up area probability map derived from Sentinel-2 data, 10m resolution

See also the GHSL Data Package 2019 report for further information on the datasets.

REQUIREMENTS

wget from Python3

pip3 install wget

EXAMPLES

Import the GHS-BUILT-S2 dataset for the current computational region:

r.import.ghs ghs_built_s2=ghs_built_s2_map directory=some_tempdir

Import all datasets for the current computational region:

r.import.ghs ghs_built=ghs_built_map ghs_built_s1=ghs_built_s1_map ghs_built_s2=ghs_built_s2_map directory=some_tempdir

REFERENCES

AUTHOR

Guido Riembauer, mundialis, Germany

SOURCE CODE

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

Accessed: Monday Jul 27 12:29:29 2026