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:
_i and _q), the amplitude, the intensity, the
intensity in decibels or the phase;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.
The algorithms follow ESA SNAP (microwave toolbox), so that results can be compared with a SNAP TOPSAR-Split → Calibration → TOPSAR-Deburst chain:
firstValidSample, lastValidSample) are
null.value / A for the complex
components and amplitude, |DN|² / A² for the intensity,
where A is the sigmaNought, betaNought or gamma calibration
vector, interpolated bilinearly in range (pixel) and azimuth time. The
azimuth time used is the true zero-Doppler time of the source line in
its burst.N is the product of the range noise vector of the burst
(the one closest in time to the burst start, as SNAP does) and the
azimuth noise vector (IPF ≥ 2.9), both linearly interpolated.
|DN|² − N is clipped at 0 before calibration. It is not
defined for the complex and phase measures, which are refused.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.
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.
Product metadata are imported with every map:
S1_VV_I, S1_VV_INTENSITY,
S1_latitude) with r.support;$MAPSET/cell_misc/<map>/description.json with the
manifest information (mission, absolute and relative orbit, pass, IPF
version, footprint...), the sub-swath annotation (radar frequency,
wavelength, range sampling rate, PRF, slant range time, pixel spacings,
azimuth time interval, burst list with burst IDs, times and valid
samples, orbit state vectors, Doppler centroid and azimuth FM rate
polynomials, processing information, geolocation grid), the output
raster geometry (first line azimuth time, source lines, bursts,
debursting, and the segments giving the burst and burst
line of every row) and the measure, calibration and noise settings.These are the parameters needed by downstream processing such as coregistration and 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.
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.
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.
List the bursts of a product:
r.in.s1slc -l input=S1A_IW_SLC__1SDV_20230112T142507_20230112T142534_046752_059AD8_A55D.zipImport 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,longitudeCalibrated, 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=sigma0Geocode 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=10Import 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.40i.group, i.rectify, i.sar.coregistration, i.sar.interferometry, i.target, r.in.gdal, r.in.sentinel, r.support, r.timestamp
Yann Chemin
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