i.sentinel_1.forest.mask

NAME

i.sentinel_1.forest.mask - Creates Sentinel-1 monthly mosaic based forest mask

KEYWORDS

SYNOPSIS

i.sentinel_1.forest.mask

i.sentinel_1.forest.mask --help

i.sentinel_1.forest.mask [aoi=name] sar_img_vv=name sar_img_vh=name [vh_thresh=string] [vv_vh_ratio_thresh=string] [rvi_thresh=string] [seg_threshold=string] [seg_iterations=string] [seg_minsize=string] forest_mask=name [forest_mask_vect=name] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

--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 computational region
sar_img_vv=name [required]: Raster map containing VV gamma0 SAR image (db)
sar_img_vh=name [required]: Raster map containing VH gamma0 SAR image (db)
vh_thresh=string: Threshold marking lower border of forest-representing VH backscatter values to create core forest mask; Default: -28.0
vv_vh_ratio_thresh=string: Thresholds of forest-representing VV/VH ratio interval to create core forest mask; Default: 10.0,20.0
rvi_thresh=string: Threshold marking lower border of forest-representing RVI values to create core forest mask; Default: 0.2
seg_threshold=string: Distinction threshold used for image segmentation; Default: 0.017
seg_iterations=string: Maximum number of iteratons used for image segmentation; Default: 30
seg_minsize=string: Minimum cell number in a segment used for image segmentation
forest_mask=name [required]: Name of output raster map containing the forest mask
forest_mask_vect=name: Name of output vector map containing the forest mask

DESCRIPTION
EXAMPLES
- Create Forest Mask
AUTHORS

DESCRIPTION

i.sentinel_1.forest.mask creates a forest mask using a combination of image segmentation and a rule-based classificaton. Therefore Sentinel-1 monthly mosaics should be used as input SAR images, which can be downloaded in the Copernicus Browser. For classifying segments as forest VH backscatter, the VV/VH ratio and the Radar Vegetation Index is used. Due to local vegetation conditions and the SAR acquisition time the resulting forest mask can be incomplete. Check and may modify used thresholds!

EXAMPLES

Create Forest Mask

i.sentinel_1.forest.mask aoi=aoi_ireland sar_img_vv=vv_ireland sar_img_vh=vh_ireland forest_mask=forest_ireland

AUTHORS

Johannes Halbauer, mundialis GmbH & Co. KG

SOURCE CODE

Available at: i.sentinel_1.forest.mask source code (history)

Accessed: Monday Jul 27 12:22:40 2026