i.satskred - GRASS GIS manual

NAME

i.satskred - Run avalanche detection from Sentinel-1 imagery using satskred

KEYWORDS

raster, imagery, copernicus, sentinel, satellite, radar, satskred, avalanche, snow

SYNOPSIS

i.satskred

i.satskred --help

i.satskred input=name elevation=string [output_directory=name] mask_directory=name [mask_suffix=string] mask_exclude=integer[,integer,...] mask_min_valid=integer [start=string] [end=string] [--help] [--verbose] [--quiet] [--ui]

Flags:

--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

input=name [required]: Input directory with Sentinel-1 imagery
elevation=string [required]: Digital elevation model for geocoding (path to a GeoTiff or a linked raster map)
output_directory=name: Directory where satskred results are stored; Name for output directory where satskred results are stored (default: ./); Default: ./
mask_directory=name [required]: Directory where masks for avalanche detection are stored; Name for output directory where masks for avalanche detection are stored
mask_suffix=string: Suffix used for files with runout masks; Default: tif
mask_exclude=integer[,integer,...] [required]: Comma separated list of category values in mask to exclude from avalanche detection
mask_min_valid=integer [required]: Minimum number of valid pixels in mask
start=string: Start date of time frame to compute (required format: YYYY-MM-DD); Start date of time frame to compute (required format: YYYY-MM-DD)
end=string: End date of time frame to compute (required format: YYYY-MM-DD); End date of time frame to compute (required format: YYYY-MM-DD)

DESCRIPTION
NOTES
EXAMPLES
REQUIREMENTS
AUTHOR

DESCRIPTION

i.satkred runs avalanche detection from Sentinel-1 imagery using the satskred library. Main input is a directory containing a tme series of Sentinel-1 GRD imagery. In addition, a Digital Elevation Model (DEM) is required in the elevation option.

i.satkred creates configuration files for satskred, initializes the area to process and executes the satskred command line utility to run avalance detection. All results (geocoded Sentinel-1 images, RGB-change images, shape files of detected avalanches) are stored in the output_directory.

Further required input are a directory containing runout masks given in the mask_directory option, together with mask settings like mask_suffix, describing the suffix used for files with runout masks, a comma separated list of category values in the masks to exclude from avalanche detection given in the mask_exclude option and finally the minimum valid category value in the mask files mask_min_valid (values >= mask_min_valid are incuded in avalanche detection). Default settings for the mask options are chosen to match current settings for satskred production at NVE.

The user can choose to process only a specific time span defined by the start and stop option. The extent to process is taken from the computational region (set with g.region), and relevant images in the input directory are selected according to the user-provided spatial and temporal extent to process.

NOTES

Currently, the module expects the input Digital Elevation Model to be in UTM 33N Coordinate Reference System, and all output is generated in that CRS (EPSG:25833) as well.

EXAMPLES

i.satskred input="./Sentinel_1_raw" elevation="./dtm20m.tif" mask_directory="./runoutmasks/" \
  start="2019-11-24" end="2020-06-06" output_directory="./satskred_results"

REQUIREMENTS

i.satskred uses the following non-standard Python libraries:

The non-open satskred Python library
The proprietary GDAR Python library developed by NORCE (coming with own dependencies)
Python bindings for GDAL

AUTHOR

Stefan Blumentrath

SOURCE CODE

Available at: i.satskred source code (history)

Accessed: Monday Sep 16 09:38:00 2024