i.asf.download - GRASS manual

NAME

i.asf.download - Searches and downloads SAR data from the Alaska Satellite Facility.

KEYWORDS

imagery, satellite, download, SAR, Sentinel

SYNOPSIS

i.asf.download

i.asf.download --help

i.asf.download [-lsw] [output_directory=string] [aoi=name] [token=string] start=string [end=string] platform=string beam_mode=string [processinglevel=string] [check_scenes=string] [nprocs=integer] [scenes=string] [--help] [--verbose] [--quiet] [--ui]

Flags:

-l: Only list scenes available
-s: Skip downloading existing scenes
-w: Write log file with download results
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

output_directory=string: Directory where to store downloaded data; Name for output directory where to store downloaded Sentinel data
aoi=name: Path to GeoJSON file with the Area Of Interest (aoi); Path to GeoJSON file with the Area Of Interest (aoi) (defaults to computational region)
token=string: File has to contain ASF token; Path to ASF token file
start=string [required]: 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
beam_mode=string [required]: Currently only IW is supported; Satellite beam mode; Options: IW; Default: IW
processinglevel=string: Ground-Range-Detected (GRD) or Single-Look-Complex (SLC); SAR processing level; Options: GRD_HD, SLC; Default: GRD_HD
check_scenes=string: Perform checksum / modification time test for the given set of scenes; Perform checksum / modification time test; Options: existing, downloaded, all
nprocs=integer: Number of threads for parallel computing; 0: use OpenMP default; >0: use nprocs; <0: use MAX-nprocs; Default: 0
scenes=string: Selected scenes to download from ASF; Comma separated list of scenes or file with scenes (one per row)

DESCRIPTION
EXAMPLES
REFERENCES
AUTHOR

DESCRIPTION

i.asf.download for search and download of products available from Alaska Satellite Facility (ASF) https://asf.alaska.edu/. The module supports parallel downloads using the nprocs option which defines the maximum number of parallel processes.

Users can only use a limited set of query parameters from the underlying API. The rest will be implemented when needed. The following filter parameters are so far supported:

Platform

In the platform option, users can choose which product types to download.

Sentinel-1

BeamMode

In the beamMode option, users can choose which product types to download. Currently only IW is supported.

Processinglevel

In the processinglevel option, users can choose which product types to download. Currently supported are:

GRD_HD
SLC

EXAMPLES

List scenes matching geo-search

i.asf.download --v -l start="2020-12-01" end="2020-12-14" \
    aoi=./aoi.geojson

Parallel download with token file

# Skip existing files
    i.asf.download --v -s start="2020-12-01" end="2020-12-14" \
    output_directory=./ token=./asf.token nprocs=5

Parallel download with checksum / modification time test

export ASF_TOKEN=my_long_and_complicated_token_string
i.asf.download --v -s start="2020-12-01" end="2020-12-14" \
    output_directory=./ nprocs=5 check_scenes=all

REFERENCES

asf_search Basics

AUTHOR

Yngve Antonsen,
Stefan Blumentrath (parallelization and additional checks)

SOURCE CODE

Available at: i.asf.download source code (history)

Accessed: Monday Jul 27 12:22:30 2026