t.sentinel.import - GRASS manual

NAME

t.sentinel.import - Downloads and imports multiple Sentinel-2 scenes in parallel and creates a STRDS.

KEYWORDS

temporal, satellite, Sentinel, download, import

SYNOPSIS

t.sentinel.import

t.sentinel.import --help

t.sentinel.import [-cifea] [settings=name] [clouds=integer] [producttype=string] [start=string] [end=string] [datasource=string] [limit=integer] [s2names=string[,string,...]] [sen2cor_path=string] [pattern=string] [strds_output=name] [stvds_clouds=string] [strds_clouds=string] [directory=string] [extent=string] [input_dir=string] [memory=memory in MB] [nprocs=integer] [offset=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-c: Import cloud masks as raster maps
-i: Resample 20/60m bands to 10m using r.resamp.interp
-f: Use footprint to set null values TODO!!!
-e: Use ESA-style scenename/s to download from USGS
-a: Run atmospheric correction with sen2cor before importing
--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:

settings=name: Full path to settings file (user, password); Name of input file
clouds=integer: Maximum cloud cover percentage for Sentinel-2 scene; Default: 100
producttype=string: Sentinel-2 product type to filter; Options: S2MSI1C, S2MSI2A, S2MSI2Ap; Default: S2MSI2A
start=string: Start date ('YYYY-MM-DD')
end=string: End date ('YYYY-MM-DD')
datasource=string: Default is ESA Copernicus Open Access Hub (ESA_COAH). Google Cloud Storage also offers the complete L1C and L2A archive. Sentinel-2 L1C data can also be acquired from USGS Earth Explorer (USGS_EE). Download from USGS is currently only available when used together with the scene_name option.; Data-Hub to download scenes from; Options: ESA_COAH, USGS_EE, GCS; Default: ESA_COAH
limit=integer: Maximum number of scenes to filter/download
s2names=string[,string,...]: List of Sentinel-2 names or file with this list
sen2cor_path=string: Path to sen2cor home directory; e.g. /home/user/sen2cor
pattern=string: Band name pattern to import
strds_output=name: Name of the output space time dataset
stvds_clouds=string: Name of the output cloudmask space time vector dataset. If not provided, it will be <strds_output>_clouds
strds_clouds=string: Name of the output cloudmask space time raster dataset. If not provided, it will be <strds_output>_clouds
directory=string: Directory to hold temporary files (they can be large)
extent=string: Data extent to use with i.sentinel.import; Options: region, input; Default: region
input_dir=string: Directory with locally stored S2-data. If this option is used, no downloading will be performed; If this option is used, no downloading will be performed.
memory=memory in MB: Maximum memory to be used (in MB); Cache size for raster rows; Default: 300
nprocs=integer: Number of parallel processes to use; Default: 1
offset=integer: Offset to add to the Sentinel-2 bands to due to specific processing baseline (e.g. -1000)

DESCRIPTION
EXAMPLE
SEE ALSO
REQUIREMENTS
AUTHOR

DESCRIPTION

t.sentinel.import is a GRASS GIS addon Python script to download and import the Sentinel-2 scenes and create a STRDS.

Since Sentinel-2 Processing Baseline 4.0.0, a systematic offset has been introduced to all reflectance values.
To account for this, the offset option allows the user to indicate how reflectance data should be corrected (e.g. -1000).

When using the -c flag to import cloud masks, the user may define the type and name of the
cloud STDS to be imported by the stvds_clouds/strds_clouds option. If only the -c flag is given, a cloud STVDS is imported and named [strds_output]_clouds

EXAMPLE

t.sentinel.import s2names=s2names2.txt settings=/mnt/pgpass/.sentinel.txt \
  nprocs=7 memory=8000 -c pattern='B0(4|8)_10m' strds_output=test

REQUIREMENTS

If atmospheric correction should be run using the -a flag, Sen2Cor needs to be installed. For additional information, see i.sentinel-2.sen2cor.

AUTHOR

Anika Weinmann, mundialis, Germany

SOURCE CODE

Available at: t.sentinel.import source code (history)

Accessed: Monday Jul 27 12:30:36 2026