No project description provided
Project description
nasa-csda-cli
This is a CLI and SDK for querying and downloading files from Spire's CSDA catalog.
Install it from PyPI
pip install nasa-csda
Using the CLI
See the command's help dialog for detailed usage information for all commands.
nasa-csda-cli --help
All of the commands require login information (the same username and password used to log into the web page). You can also set environment variables to provide these credentials.
export CSDA_USERNAME=<username>
export CSDA_PASSWORD=<password>
Bulk downloading files
The catalog's web page provides the ability to download a query configuration file that can be provided to the CLI to download all files matching the query created in the UI. To download all files using this configuration file,
nasa-csda-cli --username <username> --password <password> bulk-download download-config.json
Querying the catalog
You can also construct queries to perform custom tasks using the query
command.
nasa-csda-cli query --start-date 2020-01-01 --end-date 2020-01-02 \
--products opnGns,atmPhs \
--min-latitude -50 --max-latitude 50 --min-longitude -50 --max-longitude 50
By default, this will download all matching files in the same way that the bulk download does. There are two additional modes of operation this command supports.
Listing download links
In list
mode, a link to all files will be printed to STDOUT.
nasa-csda-cli query --start-date 2020-01-01 --end-date 2020-01-02 \
--products opnGns,atmPhs \
--min-latitude -50 --max-latitude 50 --min-longitude -100 --max-longitude 100 \
--mode list --no-progress --limit 10
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-56-00_FM104_R15_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-56-00_FM104_R15.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-55-05_FM105_R14_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-55-05_FM105_R14.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-54-35_FM105_G07_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-54-35_FM105_G07.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-54-12_FM104_G32_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-54-12_FM104_G32.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-53-50_FM105_G30_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-53-50_FM105_G30.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-52-32_FM085_G31_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-52-32_FM085_G31.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-52-07_FM105_G12_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-52-07_FM105_G12.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-51-38_FM106_G03_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-51-38_FM106_G03.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-51-35_FM105_E03_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-51-35_FM105_E03.nc
https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-51-32_FM104_G25_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-51-32_FM104_G25.nc
Getting raw GeoJSON objects
In raw
mode, the command will stream out GeoJSON objects conforming to the STAC spec.
nasa-csda-cli query --start-date 2020-01-01 --end-date 2020-01-02 \
--products opnGns,atmPhs \
--min-latitude -50 --max-latitude 50 --min-longitude -100 --max-longitude 100 \
--mode raw --no-progress --limit 1
Using the CLI to authenticate requests
Advanced users can use the token
command to generate authentication headers that allow
downloading files using other tools.
TOKEN="$(nasa-csda-cli token)"
curl -O -L -H "Authorization: Bearer ${TOKEN}" https://nasa-csda.wx.spire.com/download/spire/2020-01-01T23-56-00_FM104_R15_atmPhs/spire_gnss-ro_L1B_atmPhs_v06.01_2020-01-01T23-56-00_FM104_R15.nc
Using the SDK
The library can be directly for custom behavior. See the examples for information on how to use it.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file nasa_csda-1.2.0.tar.gz
.
File metadata
- Download URL: nasa_csda-1.2.0.tar.gz
- Upload date:
- Size: 13.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c3cc40d6d05cb7abdf4148e983c07dc55904fab63cfd148f46e5e9cfadf40837 |
|
MD5 | ea649f419e17deda82bf9c233d451c1e |
|
BLAKE2b-256 | 08037d066465359b8a4698910d6dc8a410f49cece0a0c8f505fd19a378780d4a |
File details
Details for the file nasa_csda-1.2.0-py3-none-any.whl
.
File metadata
- Download URL: nasa_csda-1.2.0-py3-none-any.whl
- Upload date:
- Size: 15.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 423109d1c71df8f0881a48c9d13b448c356b95c09ddbdf0202cde52f30fafbc9 |
|
MD5 | e6bfe446e11175812e225f5e01f661d7 |
|
BLAKE2b-256 | 63b0ae772fced7db8ed1fd602eb74e2bc2eece53f94f9df9c66bdf5fda7d8a2a |