GRASS logo

NAME

t.rast.wetsnow - Detect wet snow from Sentinel-1 GRDH IW time series and reference data.

KEYWORDS

temporal, raster, wetsnow, Sentinel-1

SYNOPSIS

t.rast.wetsnow
t.rast.wetsnow --help
t.rast.wetsnow [-e] input=name output=name basename=string reference_pattern=string [size=integer] [detection_thresholds=float[,float,...]] [nodata_threshold=float] [k=float] [mode_size=integer] method=string [memory=memory in MB] [nprocs=integer] [where=sql_query] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-e
Extend to existing output STRDS (requires overwrite flag)
--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:

input=name [required]
Name of the input space time raster dataset
output=name [required]
Name of the output space time raster dataset
basename=string [required]
Basename of the new generated output maps
Either a numerical suffix or the start time (s-flag) separated by an underscore will be attached to create a unique identifier
reference_pattern=string [required]
Pattern to find groups with reference data
Pattern to find groups with reference data, may include mapset (e.g. "Sentinel_1_reference_*@Sentinel_1_reference")
size=integer
Neighborhood size for noise filtering
Neighborhood size for noise filtering (must be odd, default: 3)
Default: 5
detection_thresholds=float[,float,...]
Lower and upper threshold for wet snow detection in DBi backscatter difference
Lower and upper threshold for wet snow detection in DBi backscatter difference (default: -12.0,-1.4)
Default: -12.0,-1.4
nodata_threshold=float
Nodata threshold
Lowest value for valid backscatter data (default: -30.0)
Default: -30.0
k=float
Weight factor for local incidence angle
Weight factor for local incidence angle, only used if reference data do not contain weight raster (default: 0.5)
Default: 0.5
mode_size=integer
Neighborhood size for mode filtering of the final result
Neighborhood size for mode filtering of the final result (must be odd, default: 3)
Default: 3
method=string [required]
Method to be used for noise filtering
Method to be used for noise filtering (default: median)
Options: average, median, quart1, quart3, perc90
Default: median
memory=memory in MB
Maximum memory to be used (in MB)
Cache size for raster rows
Default: 2048
nprocs=integer
Number of threads for parallel computing
0: use OpenMP default; >0: use nprocs; <0: use MAX-nprocs
Default: 0
where=sql_query
WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework
Example: start_time > '2001-01-01 12:30:00'

Table of contents

DESCRIPTION

t.rast.wetsnow detects wet snow in dBi-scaled backscatter data from Sentinel-1 C-band SAR. It is based on an algorithm by Nagler et al. (2016) for wet snow detection (https://doi.org/10.3390/rs8040348).

input is a time series of geocoded Sentinel-1 C-band SAR backscatter data scaled to dbi values, where polarization and track information are part of the semantic labels of the maps in the input SpaceTimeRasterDataset (STRDS).

Time steps are skipped when either the VV or VH input raster contains no backscatter values at or above nodata_threshold. All backscatter pixels with values below the threshold are considered as no data.

output is a SpaceTimeRasterDataset (STRDS) where wet snow detection results will be registered. It will be created or extended if the e-flag is set. Resulting raster maps within the STRDS contain a binary classification where the value 1 represents "wet snow" and 0 represents "no wet snow". All input pixels considered as no data are also marked as no data in the output.

Reference data are expected to be provided as imagery group(s) for each track that can be found using the reference_pattern. The pattern may include the mapset name where the reference data is stored. The group-name pattern must contain exactly one * wildcard marking the portion containing the track number, for example Sentinel_1_reference_*. Other wildcard syntax such as ? or character classes is not supported. The wildcard-matched portion should contain only one number, the one-to-three-digit track number. Avoid years, dates, or other numbers in this portion: extraction uses the first sequence of up to three digits. For example, Sentinel_1_reference_2026_110 matched by Sentinel_1_reference_* is interpreted as track 202, not 110. Use Sentinel_1_reference_2026_* instead. If the reference_pattern includes the @mapset suffix, reference data is read only from the specified mapset. Ensure that only one valid reference group matches each track. If several do, a warning is issued and the last group returned by g.list is used.

The raster maps in the reference data groups are expected to have the following semantic labels:

  1. VH: Average backscatter in VH polarization (required)
  2. VV: Average backscatter in VV polarization (required)
  3. linc: Local incidence angle (optional if linc_weight is present)
  4. linc_weight: Weight for the local incidence angle (optional)
  5. mask_high_resolution: High-resolution binary mask indicating valid pixels (combination of landcover and layover shadow) (required)
  6. mask: Binary mask resampled to target resolution (optional)

EXAMPLES

t.rast.wetsnow \
  input="Sentinel_1_GRDH_20m_daily_backscatter_intensity@Sentinel_1_GRDH_20m_daily_backscatter_intensity" \
  output="Sentinel_1_WetSnow" \
  basename="Sentinel_1_WetSnow" \
  reference_pattern="Sentinel_1_*" \
  size=5 \
  mode_size=3 \
  k=0.5 \
  nodata_threshold=-30.0 \
  detection_threshold=-12.0,-1.4 \
  memory=2048 \
  method=median \
  nprocs=8 \
  where="start_time >= '2026-04-01 00:00:00' AND start_time <= '2026-05-31 00:00:00'" \
  --overwrite --verbose

REFERENCES

SEE ALSO

r.mapcalc, t.rast.mapcalc

Temporal data processing Wiki

AUTHOR

Stefan Blumentrath (NVE)

SOURCE CODE

Available at: t.rast.wetsnow source code (history)

Accessed: Sunday Nov 15 11:08:03 2026


Main index | Temporal index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual