ASFSMD(1)

🎀 NAME 🎀

asfsmd — the ASF Sentinel-1 Metadata Download tool 💅 (yes bestie, that's literally the whole name, we love a concise queen)

✨ DESCRIPTION ✨

okay so, here's the vibe. The usage is giving:

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 ...]

So asfsmd is this small Python tool that lets you download XML files holding Sentinel-1 product metadata straight from the ASF archive. Here's the tea tho: Sentinel-1 products live in the ASF archive as ZIP files, and those ZIPs are huge because they're carrying BOTH the product annotations AND the binary image data. 🙈

But wait — the asfsmd tool is built different. It can pull only the relatively small annotation files (in XML format) without dragging the entire ZIP archive down with it. No cap, that's the whole point. 👑

🫶 positional arguments: 🫶

• INPUT — the Sentinel-1 product name(s), bestie. And listen, this one's a shape-shifter depending on your flags: if the '-f' flag is set then the argument gets interpreted as the filename containing the list of products. If the '--urls' flag is set then the arguments get interpreted as URLs pointing to a product on the ASF server. Wanna know more? Go peek at the '--filelist' and the '--urls' options, they spill all the details. 💖

🌸 options: 🌸

• -h, --help — show this help message and exit. classic. the "help me" button. 🆘
• --version — show program's version number and exit. ✨
• --loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL} — the logging level (default: WARNING). pick your chaos level.
• -q, --quiet — suppress standard output messages, only errors are printed to screen. shhh era.
• -v, --verbose — print verbose output messages. she's chatty now 💬
• -d, --debug — print debug messages. full detective mode 🔍
• -f, --file-list — read the list of products from a file. And ooh, 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 that case the key is used as subfolder name to store the corresponding products. Example: <OUTDIR>/<KEY>/<PRODUCT> — cute, organized, main character energy. 🗂️
• --urls — Indicate the inputs are a list of URLs from ASF. 🌐
• -o OUTDIR, --outdir OUTDIR — path of the output directory (default='.'). where the goodies land 📦
• -u USERNAME, --username USERNAME — username for ASF authentication. If you don't provide it, 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. Same deal: 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. pick a lane, babe 🎯
• --pol {vv,vh,hv,hh} — Choose only one polarization to download. If not provided, both polarizations are downloaded. 💫
• -c, --cal — Download calibration files. 📐
• -n, --noise — Download noise calibration files. 📡
• -r, --rfi — Download RFI files. 🛰️
• --data — Download measurement files. 📊
• --noprogress — Disable the progress bar. for the girlies who like a surprise 🙈

ngl bestie, that's the whole page. every flag, every default, every file path — nothing skipped, nothing invented, we keep the facts and just serve them cute. 💖

and that's a wrap on asfsmd v1.4.1, brought to you by February 2024 — slay, goodbye, drink water 🦋