GRASS logo

NAME

i.sentinel2.import - Imports Sentinel-2 satellite data downloaded from e.g. the Copernicus Data Space Ecosystem

KEYWORDS

imagery, satellite, Sentinel, import

SYNOPSIS

i.sentinel2.import
i.sentinel2.import --help
i.sentinel2.import [-ilfnopr] input=name product=string [unzip_dir=name] [bands=string] [file_pattern=string] [extent=string] [memory=integer] [register_output=name] [metadata=name] [color=style] [nprocs=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-i
Create also an imagery group with the imported raster maps (group names correspond to scene/tile names, e.g. S2A_MSIL2A_20250101T000000_N0511_R008_T32TQM_20250101T000000)
-l
Link the raster files using r.external
-f
Link the raster files in a fast way, without reading metadata using r.external
-n
Force unzipping of archive files
-o
Override projection check (use current project's projection)
Assume that the dataset has same projection as the current project
-p
Print raster data to be imported and exit
-r
Limit import to the computational region
--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 input directory with downloaded Sentinel data
product=string [required]
ID of the product type to import (default is S2_MSI_L2A)
Options: S2_MSI_L1C, S2_MSI_L2A
Default: S2_MSI_L2A
unzip_dir=name
Name of directory into which Sentinel zip-files are extracted (default=input)
bands=string
Comma separated list of bands to import (default is all bands)
file_pattern=string
File name pattern to import
extent=string
Output raster map extent
Options: input, region, intersection
Default: input
input: extent of input map
region: extent of current region
intersection: extent of intersection between current region and input map
memory=integer
Maximum memory to be used (in MB)
Cache size for raster rows
Default: 300
register_output=name
Name for output file to use with t.register
metadata=name
Name of directory into which Sentinel metadata JSON files are saved. Default is PROJECT/MAPSET/cell_misc/MAP_NAME/description.json
color=style
Name of color table
Options: aspect, aspectcolr, bcyr, bgyr, blues, byg, byr, celsius, corine, curvature, differences, elevation, etopo2, evi, fahrenheit, forest_cover, gdd, grass, greens, grey, grey.eq, grey.log, grey1.0, grey255, gyr, haxby, inferno, kelvin, magma, ndvi, ndwi, nlcd, oranges, plasma, population, population_dens, precipitation, precipitation_daily, precipitation_monthly, rainbow, ramp, random, reds, roygbiv, rstcurv, ryb, ryg, sepia, slope, soilmoisture, srtm, srtm_percent, srtm_plus, terrain, viridis, water, wave
aspect aspect: aspect oriented grey colors [range: map values]
aspectcolr aspectcolr: aspect oriented rainbow colors [range: 0 to 360]
bcyr bcyr: blue through cyan through yellow to red [range: map values]
bgyr bgyr: blue through green through yellow to red [range: map values]
blues blues: white to blue [range: map values]
byg byg: blue through yellow to green [range: map values]
byr byr: blue through yellow to red [range: map values]
celsius celsius: blue to red for degree Celsius temperature [range: -80 to 80]
corine corine: EU Corine land cover colors [range: 111 to 995]
curvature curvature: for terrain curvatures (from v.surf.rst and r.slope.aspect) [range: map values]
differences differences: differences oriented colors [range: map values]
elevation elevation: maps relative ranges of raster values to elevation color ramp [range: map values]
etopo2 etopo2: colors for ETOPO2 worldwide bathymetry/topography [range: -11000 to 8850]
evi evi: enhanced vegetative index colors [range: -1 to 1]
fahrenheit fahrenheit: blue to red for Fahrenheit temperature [range: -112 to 176]
forest_cover forest_cover: percentage of forest cover [range: 0 to 100]
gdd gdd: accumulated growing degree days [range: 0 to 6000]
grass grass: GRASS green (perceptually uniform) [range: map values]
greens greens: white to green [range: map values]
grey grey: grey scale [range: map values]
grey.eq grey.eq: histogram-equalized grey scale [range: map values]
grey.log grey.log: histogram logarithmic transformed grey scale [range: map values]
grey1.0 grey1.0: grey scale for raster values between 0.0-1.0 [range: 0 to 1]
grey255 grey255: grey scale for raster values between 0-255 [range: 0 to 255]
gyr gyr: green through yellow to red [range: map values]
haxby haxby: relative colors for bathymetry or topography [range: map values]
inferno inferno: perceptually uniform sequential color table inferno [range: map values]
kelvin kelvin: blue to red for temperature in Kelvin scale [range: 193.15 to 353.15]
magma magma: perceptually uniform sequential color table magma [range: map values]
ndvi ndvi: Normalized Difference Vegetation Index colors [range: -1 to 1]
ndwi ndwi: Normalized Difference Water Index colors [range: -200 to 200]
nlcd nlcd: US National Land Cover Dataset colors [range: 0 to 95]
oranges oranges: white to orange [range: map values]
plasma plasma: perceptually uniform sequential color table plasma [range: map values]
population population: color table covering human population classification breaks [range: 0 to 2e+09]
population_dens population_dens: color table covering human population density classification breaks [range: 0 to 1e+09]
precipitation precipitation: precipitation color table (0..2000mm) [range: 0 to 7000]
precipitation_daily precipitation_daily: precipitation color table (0..1000mm) [range: 0 to 10000]
precipitation_monthly precipitation_monthly: precipitation color table (0..1000mm) [range: 0 to 1000]
rainbow rainbow: rainbow color table [range: map values]
ramp ramp: color ramp [range: map values]
random random: random color table [range: map values]
reds reds: white to red [range: map values]
roygbiv roygbiv: [range: map values]
rstcurv rstcurv: terrain curvature (from r.resamp.rst) [range: map values]
ryb ryb: red through yellow to blue [range: map values]
ryg ryg: red through yellow to green [range: map values]
sepia sepia: yellowish-brown through to white [range: map values]
slope slope: r.slope.aspect-type slope colors for raster values 0-90 [range: 0 to 90]
soilmoisture soilmoisture: soilmoisture color table (0.0-1.0) [range: 0 to 1]
srtm srtm: color palette for Shuttle Radar Topography Mission elevation [range: -11000 to 8850]
srtm_percent srtm_percent: color palette for Shuttle Radar Topography Mission using relative elevation [range: map values]
srtm_plus srtm_plus: color palette for Shuttle Radar Topography Mission elevation (with seafloor colors) [range: -11000 to 8850]
terrain terrain: global elevation color table covering -11000 to +8850m [range: -11000 to 8850]
viridis viridis: perceptually uniform sequential color table viridis [range: map values]
water water: water depth [range: map values]
wave wave: color wave [range: map values]
nprocs=integer
Number of threads for parallel computing
0: use OpenMP default; >0: use nprocs; <0: use MAX-nprocs
Default: 0

Table of contents

DESCRIPTION

i.sentinel2.import imports Sentinel-2 imagery in SAFE format The module rescales reflectanse values according to quantification rules of the product metadata.

EXAMPLES

i.sentinel2.import

REQUIREMENTS

SEE ALSO

i.sentinel.import

REFERENCES

AUTHOR

Stefan Blumentrath

SOURCE CODE

Available at: i.sentinel2.import source code (history)

Accessed: Monday Jul 27 12:22:33 2026

Main index | Imagery index | Topics index | Keywords index | Graphical index | Full index

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