i.sentinel_1.download_asf

NAME

i.sentinel_1.download_asf - Searches and downloads SAR data from the Alaska Satellite Facility.

KEYWORDS

imagery, satellite, download, SAR, Sentinel

SYNOPSIS

i.sentinel_1.download_asf

i.sentinel_1.download_asf --help

i.sentinel_1.download_asf [-l] [output=string] credentials=string [start=string] [end=string] platform=string [processinglevel=string] [polarization=string] [flight_dir=string] [limit=integer] [granules=string[,string,...]] [--help] [--verbose] [--quiet] [--ui]

Flags:

-l: Only list available products and exit
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

output=string: Directory where to store downloaded data; Name for output directory where to store downloaded Sentinel data
credentials=string [required]: File has to contain NASA EARTHDATA credentials in the format 'http-user=<USER>\nhttp-passwd=<PW>'; Path to NASA EARTHDATA credentials file
start=string: Start date ('YYYY-MM-DD')
end=string: End date ('YYYY-MM-DD')
platform=string [required]: Currently only Sentinel-1 is supported; Satellite platform; Options: Sentinel-1; Default: Sentinel-1
processinglevel=string: Ground-Range-Detected (GRD) or Single-Look-Complex (SLC); SAR processing level; Options: GRD, SLC; Default: GRD
polarization=string: Vertical (VV), Horizontal (HH), and combinations (e.g. VH); SAR polarization; Options: VV, VH, VV+VH; Default: VV+VH
flight_dir=string: Satellite orbit direction during data acquisition; Satellite orbit direction during data acquisition; Options: ASCENDING, DESCENDING
limit=integer: Maximum results to display/download; Maximum results to display/download
granules=string[,string,...]: List of Sentinel-1 granules to download; Downloads granules regardless of computational region and time

DESCRIPTION
REQUIREMENTS
EXAMPLE
SEE ALSO
AUTHOR

DESCRIPTION

i.sentinel_1.download_asf searches and downloads SAR data from the Alaska Satellite Facility (ASF) using the ASF-API. The current GRASS GIS region is used to define the search area. Currently, i.sentinel_1.download_asf only allows the search and download of Sentinel-1 data. The benefit of this addon compared to i.sentinel.download is that the latter uses the Copernicus Open Access Hub, where Sentinel-1 data is consecutively moved into a long-term archive. Users need to trigger the re-upload of the data which can take up to 24 hours. ASF's Distributed Active Archive Center does not have these restrictions.

REQUIREMENTS

The download utility aria2 has to be installed on the system.
Login-credentials for NASA Earthdata have to be saved in a file in the format
```
      http-user=username
      http-passwd=password
    
```
Define a (thematic) study area in your NASA Earthdata profile settings.
Add Alaska Satellite Facility Data Access to your list of authorized applications in your NASA Earthdata profile settings.

EXAMPLE

# List all Sentinel-1 SLC data from June 2016 that intersect with the current region
i.sentinel_1.download_asf -l credentials=credentials start=2016-06-01 end=2016-06-30 processinglevel=SLC

# Download the first 5 Sentinel-1 GRD datasets from an ASCENDING orbit from June 2016
# that intersects with the current region
i.sentinel_1.download_asf output=output_folder credentials=credentials start=2016-06-01 end=2016-06-30 processinglevel=GRD flight_dir=ASCENDING limit=5

# Download a specific Sentinel-1 granule regardless of computational region
i.sentinel_1.download_asf output=output_folder credentials=credentials granules=S1A_IW_GRDH_1SDV_20201010T135633_20201010T135658_034735_040BF5_B2E9

AUTHOR

Guido Riembauer, mundialis, Germany

SOURCE CODE

Available at: i.sentinel_1.download_asf source code (history)

Accessed: Monday Jul 27 12:22:40 2026