| Name | asfsmd JSON |
| Version |
1.4.1
JSON |
| download |
| home_page | |
| Summary | ASF Sentinel-1 Metadata Download tool |
| upload_time | 2023-11-19 17:49:19 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.7 |
| license | MIT License |
| keywords |
satellite
download
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
ASF Sentinel-1 Metadata Download tool
=====================================
Small Python tool (`asfsmd`) that allows to download XML files containing
Sentinel-1 products metadata from the ASF archive.
Sentinel-1 products are stored in the ASF arcive 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 samll annotation
files (in XML format) without downloading the entire ZIP archive.
`asfsmd` exploits Python packages like `fsspec` or `httpio` for reading HTTP
resources as random-access file-like objects. In order to do it the remote
server must support the `Range` header.
This approach allows to open the ZIP archive remotely, inspects contents, and
download only the pieces of data that are actually necessary to the user.
Performnces of this approach are quite poor but, in the specific case of
Sentinel-1 products, the entire process results to be faster than downloading
the entire ZIP archive and extracting only annotation files.
Command Line Interface
----------------------
::
$ python3 -m asfsmd --help
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]
INPUT [INPUT ...]
ASF Sentinel-1 Metadata Download tool. Small Python tool (`asfsmd`) that
allows to download XML files containing Sentinel-1 products metadata from
the ASF archive. Sentinel-1 products are stored in the ASF arcive as ZIP
files that are quite large because they comntain 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 '--file--list' 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 sub-folder 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 bytes (default: 1024)
-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.
-c, --cal Download calibration files.
-n, --noise Download noise calibration files.
-r, --rfi Download RFI files.
--data Download measurement files.
License
-------
Copyright (c) 2021-2023 Antonio Valentino
The `asfsmd` package is distributed under the MIT License.
Raw data
{
"_id": null,
"home_page": "",
"name": "asfsmd",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "satellite,download",
"author": "",
"author_email": "Antonio Valentino <antonio.valentino@tiscali.it>",
"download_url": "https://files.pythonhosted.org/packages/b0/b5/a53c3b8cc9f3fa5cacfe3e2ec3b3531b968576e10d74b79bbb6234c568d5/asfsmd-1.4.1.tar.gz",
"platform": null,
"description": "ASF Sentinel-1 Metadata Download tool\n=====================================\n\nSmall Python tool (`asfsmd`) that allows to download XML files containing\nSentinel-1 products metadata from the ASF archive.\n\nSentinel-1 products are stored in the ASF arcive as ZIP files that are\nquite large because they contain both the products annotations and the\nbinary image data.\n\nThe `asfsmd` tool is able to retrieve only the relatively samll annotation\nfiles (in XML format) without downloading the entire ZIP archive.\n\n`asfsmd` exploits Python packages like `fsspec` or `httpio` for reading HTTP\nresources as random-access file-like objects. In order to do it the remote\nserver must support the `Range` header.\n\nThis approach allows to open the ZIP archive remotely, inspects contents, and\ndownload only the pieces of data that are actually necessary to the user.\n\nPerformnces of this approach are quite poor but, in the specific case of\nSentinel-1 products, the entire process results to be faster than downloading\nthe entire ZIP archive and extracting only annotation files.\n\n\nCommand Line Interface\n----------------------\n\n::\n\n $ python3 -m asfsmd --help\n\n usage: asfsmd [-h] [--version]\n [--loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}]\n [-q] [-v] [-d]\n [-f] [--urls] [-o OUTDIR] [-u USERNAME] [-p PASSWORD]\n [--block-size BLOCK_SIZE]\n [-b {s1,s2,s3,s4,s5,s6,iw1,iw2,iw3,ew1,ew2,ew3,ew4,ew5,wv1,wv2}]\n [--pol {vv,vh,hv,hh}] [-c] [-n] [-r] [--data]\n INPUT [INPUT ...]\n\n ASF Sentinel-1 Metadata Download tool. Small Python tool (`asfsmd`) that\n allows to download XML files containing Sentinel-1 products metadata from\n the ASF archive. Sentinel-1 products are stored in the ASF arcive as ZIP\n files that are quite large because they comntain both the products\n annotations and the binary image data. The `asfsmd` tool is able to\n retrieve only the relatively small annotation files (in XML format) without\n downloading the entire ZIP archive.\n\n positional arguments:\n INPUT Sentinel-1 product name(s). If the '-f' flag is set\n then the argument is interpreted as the filename\n containing the list of products. If the '--urls'\n flag is set then the arguments are interpreted as\n URLs pointing to product on the ASF server.\n See '--file--list' and the '--urls' options for\n more details.\n\n options:\n -h, --help show this help message and exit\n --version show program's version number and exit\n --loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}\n logging level (default: WARNING)\n -q, --quiet suppress standard output messages, only errors are\n printed to screen\n -v, --verbose print verbose output messages\n -d, --debug print debug messages\n -f, --file-list read the list of products from a file. The file\n can be a JSON file (with '.json' extension) or a\n text file.The text file is expected to contain one\n product name per line.The json file can contain a\n list of products or a dictionary containing a list\n of products for each key.In this case the key is\n used as sub-folder name to store the corresponding\n products.Example: <OUTDIR>/<KEY>/<PRODUCT>\n --urls Indicate the inputs are a list of URLs from ASF.\n -o OUTDIR, --outdir OUTDIR\n path of the output directory (default='.')\n -u USERNAME, --username USERNAME\n username for ASF authentication. If not provided\n the tool attempts to retrieve the authentication\n parameters for the user's '.netrc' file looking\n for the host 'urs.earthdata.nasa.gov'\n -p PASSWORD, --password PASSWORD\n password for ASF authentication. If not provided\n the tool attempts to retrieve the authentication\n parameters for the user's '.netrc' file looking\n for the host 'urs.earthdata.nasa.gov'\n --block-size BLOCK_SIZE\n httpio block size in bytes (default: 1024)\n -b {s1,s2,s3,s4,s5,s6,iw1,iw2,iw3,ew1,ew2,ew3,ew4,ew5,wv1,wv2},\n --beam {s1,s2,s3,s4,s5,s6,iw1,iw2,iw3,ew1,ew2,ew3,ew4,ew5,wv1,wv2}\n Choose only one beam to download. If not provided\n all beams are downloaded.\n --pol {vv,vh,hv,hh} Choose only one polarization to download. If not\n provided both polarizations are downloaded.\n -c, --cal Download calibration files.\n -n, --noise Download noise calibration files.\n -r, --rfi Download RFI files.\n --data Download measurement files.\n\n\nLicense\n-------\n\nCopyright (c) 2021-2023 Antonio Valentino\n\nThe `asfsmd` package is distributed under the MIT License.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "ASF Sentinel-1 Metadata Download tool",
"version": "1.4.1",
"project_urls": {
"Changelog": "https://github.com/avalentino/asfsmd/blob/main/CHANGELOG.rst",
"Documentation": "https://github.com/avalentino/asfsmd/blob/main/README.rst",
"Homepage": "https://github.com/avalentino/asfsmd",
"Repository": "https://github.com/avalentino/asfsmd.git"
},
"split_keywords": [
"satellite",
"download"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "99d21f6177b281471142a88b9bf436c3f3dca17403713525d9023fe70397a4a5",
"md5": "6067890768af626020a859eff4e0c2d4",
"sha256": "549b2d5084099d50b77509c89d3b26e4bf2470bc548eb2d9db77d8a130fbede8"
},
"downloads": -1,
"filename": "asfsmd-1.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6067890768af626020a859eff4e0c2d4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 15453,
"upload_time": "2023-11-19T17:49:17",
"upload_time_iso_8601": "2023-11-19T17:49:17.050813Z",
"url": "https://files.pythonhosted.org/packages/99/d2/1f6177b281471142a88b9bf436c3f3dca17403713525d9023fe70397a4a5/asfsmd-1.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b0b5a53c3b8cc9f3fa5cacfe3e2ec3b3531b968576e10d74b79bbb6234c568d5",
"md5": "8d4c9bdc3ffe117c27ae3bc57c178cb9",
"sha256": "c89798c25b888288c3ee9f367540d785fc4e1c68336d2ee8400bb14b5672e695"
},
"downloads": -1,
"filename": "asfsmd-1.4.1.tar.gz",
"has_sig": false,
"md5_digest": "8d4c9bdc3ffe117c27ae3bc57c178cb9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 17836,
"upload_time": "2023-11-19T17:49:19",
"upload_time_iso_8601": "2023-11-19T17:49:19.393758Z",
"url": "https://files.pythonhosted.org/packages/b0/b5/a53c3b8cc9f3fa5cacfe3e2ec3b3531b968576e10d74b79bbb6234c568d5/asfsmd-1.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-19 17:49:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "avalentino",
"github_project": "asfsmd",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "asfsmd"
}
