asfsmd(1) · carta

NAME

asfsmd - ASF Sentinel-1 Metadata Download tool

DESCRIPTION

usage: asfsmd [-h] [--version]

: [--loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [-q] [-v] [-d] [-f] [--urls] [-o OUTDIR] [-u USERNAME] [-p PASSWORD] [--block-size BLOCK_SIZE] [-b {s1,s2,s3,s4,s5,s6,iw1,iw2,iw3,ew1,ew2,ew3,ew4,ew5,wv1,wv2}] [--pol {vv,vh,hv,hh}] [-c] [-n] [-r] [--data] [--noprogress] INPUT [INPUT ...]

Small Python tool (`asfsmd`) that allows one to download XML files containing Sentinel-1 products metadata from the ASF archive. Sentinel-1 products are stored in the ASF archive as ZIP files that are quite large because they contain both the products annotations and the binary image data. The `asfsmd` tool is able to retrieve only the relatively small annotation files (in XML format) without downloading the entire ZIP archive.

positional arguments:

INPUT: Sentinel-1 product name(s). If the '-f' flag is set then the argument is interpreted as the filename containing the list of products. If the '--urls' flag is set then the arguments are interpreted as URLs pointing to product on the ASF server. See '--filelist' and the '--urls' options for more details.

options:

-h, --help: show this help message and exit

--version: show program's version number and exit

--loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}: logging level (default: WARNING)

-q, --quiet: suppress standard output messages, only errors are printed to screen

-v, --verbose: print verbose output messages

-d, --debug: print debug messages

-f, --file-list: read the list of products from a file. The file can be a JSON file (with '.json' extension) or a text file.The text file is expected to contain one product name per line.The json file can contain a list of products or a dictionary containing a list of products for each key.In this case the key is used as subfolder name to store the corresponding products.Example: <OUTDIR>/<KEY>/<PRODUCT>

--urls: Indicate the inputs are a list of URLs from ASF.

-o OUTDIR, --outdir OUTDIR: path of the output directory (default='.')

-u USERNAME, --username USERNAME: username for ASF authentication. If not provided the tool attempts to retrieve the authentication parameters for the user's '.netrc' file looking for the host 'urs.earthdata.nasa.gov'

-p PASSWORD, --password PASSWORD: password for ASF authentication. If not provided the tool attempts to retrieve the authentication parameters for the user's '.netrc' file looking for the host 'urs.earthdata.nasa.gov'

--block-size BLOCK_SIZE: httpio block size in MB (default: 16)

-b {s1,s2,s3,s4,s5,s6,iw1,iw2,iw3,ew1,ew2,ew3,ew4,ew5,wv1,wv2}, --beam {s1,s2,s3,s4,s5,s6,iw1,iw2,iw3,ew1,ew2,ew3,ew4,ew5,wv1,wv2}: Choose only one beam to download. If not provided all beams are downloaded.

--pol {vv,vh,hv,hh}: Choose only one polarization to download. If not provided both polarizations are downloaded.