GRASS logo

NAME

r.in.s1slc - Imports Sentinel-1 SLC (Single Look Complex) SAFE products in radar geometry.

KEYWORDS

raster, import, imagery, SAR, radar, Sentinel-1, SLC, TOPS, metadata

SYNOPSIS

r.in.s1slc
r.in.s1slc --help
r.in.s1slc [-bnl] input=name output=basename [swath=string[,string,...]] [polarization=string[,string,...]] [bursts=range[,range,...]] [bbox=west,south,east,north[,west,south,east,north,...]] [measure=string[,string,...]] [calibration=string] [geometry=string[,string,...]] [target=name] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-b
Keep bursts separate (do not deburst)
Writes one map per burst with the full burst line count
-n
Remove thermal noise
Subtracts the annotated noise power; not defined for the complex and phase measures
-l
List sub-swaths and bursts with their footprints and exit
--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]
Sentinel-1 SLC product
SAFE product as .zip archive, .SAFE directory or its manifest.safe file
output=basename [required]
Name prefix for output raster maps and imagery groups
swath=string[,string,...]
Sub-swaths to import
Default: all sub-swaths present in the product
Options: IW1, IW2, IW3, EW1, EW2, EW3, EW4, EW5, S1, S2, S3, S4, S5, S6
polarization=string[,string,...]
Polarizations to import
Default: all polarizations present in the product
Options: VV, VH, HH, HV
bursts=range[,range,...]
Bursts to import (1-based indices or ranges, e.g. 3-5)
Applied to each selected sub-swath
bbox=west,south,east,north[,west,south,east,north,...]
Import only bursts intersecting this WGS84 longitude/latitude box
Burst footprints come from the annotation geolocation grid
measure=string[,string,...]
Quantities to write for each sub-swath and polarization
complex writes two maps (_i, _q)
Options: complex, amplitude, intensity, db, phase
Default: complex
complex: In-phase and quadrature components (maps _i and _q)
amplitude: Amplitude |z|
intensity: Intensity |z|^2 (linear power)
db: Intensity in decibels 10*log10(|z|^2)
phase: Interferometric phase atan2(q, i) in radians
calibration=string
Radiometric calibration applied to the measures
Uses the calibration LUT of the product (ESA S1-TN-MDA-52-7448)
Options: none, sigma0, beta0, gamma0
Default: none
none: Digital numbers
sigma0: Sigma nought
beta0: Beta nought
gamma0: Gamma (ellipsoid)
geometry=string[,string,...]
Geolocation layers to write in radar geometry
Bilinear interpolation of the annotation geolocation grid
Options: latitude, longitude, height, incidence_angle, elevation_angle
target=name
Name of the target project for the ground control points
GCPs are reprojected to its CRS and it becomes the imagery group target (default: GCPs in WGS84 longitude/latitude, no target)

Table of contents

DESCRIPTION

r.in.s1slc imports Sentinel-1 TOPS (IW, EW) Single Look Complex (SLC) products in their native radar geometry (azimuth lines × slant-range samples). The product can be given as the downloaded .zip archive (read in place, without extraction), as the .SAFE directory or as its manifest.safe file.

For every selected sub-swath and polarization the module can:

Radar geometry has no map projection: the current project must be unprojected (XY). Create one with grass -c XY <path_to_project> -e. The module fails otherwise.

Processing

The algorithms follow ESA SNAP (microwave toolbox), so that results can be compared with a SNAP TOPSAR-Split → Calibration → TOPSAR-Deburst chain:

Output naming

Maps are named {output}_{swath}_{pol}_{measure}, e.g. s1_iw2_vv_i, s1_iw2_vv_q, s1_iw2_vv_intensity. With the -b flag a burst tag is added: s1_iw2_vv_b04_i. Geolocation layers do not depend on the polarization: s1_iw2_latitude, s1_iw2_b04_latitude.

Uncalibrated complex components are integer maps (CELL) holding the original 16-bit digital numbers; all other outputs are FCELL.

Each map covers 0..cols east and 0..rows north, one cell per sample and line (like r.in.gdal for non-georeferenced data): use g.region raster=<map> before working with it.

Imagery groups and geocoding

One imagery group {output}_{swath}_{pol} (plus the burst tag with -b) is created for each image, containing its maps and the geolocation layers of the sub-swath. Its POINTS file holds ground control points taken from the annotation geolocation grid, mapped to the output lines through their azimuth time: image coordinates are cell centres, target coordinates are WGS84 longitude/latitude, or the CRS of the target project, which then also becomes the group target (see i.target). i.rectify can then geocode the maps; the thin plate spline method (-t) follows the grid best.

The geolocation grid is given on the ellipsoid plus the annotated terrain height; in relief, terrain correction with a DEM is needed for accurate geocoding.

Metadata

Product metadata are imported with every map:

These are the parameters needed by downstream processing such as coregistration and interferometry.

Interferometry

For interferometric processing import the complex signal of each acquisition with the -b flag. Every burst is then kept whole, including the lines it shares with its neighbours: i.sar.coregistration needs both bursts of each overlap to refine the azimuth coregistration by enhanced spectral diversity (ESD). Debursted images can still be coregistered, from the orbits alone.

Subsetting

A full IW SLC product holds three sub-swaths of nine bursts each, about 1.2 GB per sub-swath and polarization. Use swath, polarization and either bursts (1-based indices or ranges) or bbox (bursts intersecting a longitude/latitude box) to import only the area of interest. The -l flag lists the bursts of each sub-swath with their burst ID, azimuth time and footprint, and exits. A bursts index beyond the number of bursts of a selected sub-swath is an error.

NOTES

Merging the sub-swaths (TOPSAR-Merge) is not done: each sub-swath has its own slant range origin and is written separately.

The module requires the GDAL Python bindings and NumPy.

EXAMPLES

List the bursts of a product:

r.in.s1slc -l input=S1A_IW_SLC__1SDV_20230112T142507_20230112T142534_046752_059AD8_A55D.zip

Import the debursted complex signal of the bursts over Sharjah (UAE) from the IW2 VV image, with latitude and longitude layers:

grass -c XY $HOME/grassdata/s1slc_sharjah -e
grass $HOME/grassdata/s1slc_sharjah/PERMANENT --exec \
    r.in.s1slc input=S1A_IW_SLC__1SDV_20230112T142507_20230112T142534_046752_059AD8_A55D.zip \
        output=s1_20230112 swath=IW2 polarization=VV bbox=55.35,25.25,55.50,25.40 \
        measure=complex geometry=latitude,longitude

Calibrated, noise-free sigma0 in dB of burst 5 of each sub-swath:

r.in.s1slc -n -b input=S1A_IW_SLC__1SDV_20230112T142507_20230112T142534_046752_059AD8_A55D.zip \
    output=s1 bursts=5 measure=db calibration=sigma0

Geocode the result into a UTM project with the GCPs:

r.in.s1slc input=... output=s1 swath=IW2 bursts=4-6 measure=db \
    calibration=sigma0 target=sharjah_utm40n
i.rectify -t group=s1_iw2_vv extension=_utm resolution=10

Import the same bursts of two acquisitions, burst by burst, for interferometry with i.sar.coregistration and i.sar.interferometry:

r.in.s1slc -b input=S1A_IW_SLC__1SDV_20230112T142507_20230112T142534_046752_059AD8_A55D.zip \
    output=s1_20230112 swath=IW2 polarization=VV bbox=55.35,25.25,55.50,25.40
r.in.s1slc -b input=S1A_IW_SLC__1SDV_20230124T...zip \
    output=s1_20230124 swath=IW2 polarization=VV bbox=55.35,25.25,55.50,25.40

REFERENCES

SEE ALSO

i.group, i.rectify, i.sar.coregistration, i.sar.interferometry, i.target, r.in.gdal, r.in.sentinel, r.support, r.timestamp

AUTHORS

Yann Chemin

SOURCE CODE

Available at: r.in.s1slc source code (history)

Accessed: Sunday Nov 15 11:07:41 2026


Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

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