Skip to main content

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

nasa_csda-1.2.0.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

nasa_csda-1.2.0-py3-none-any.whl (15.4 kB view details)

Uploaded Python 3

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

Hashes for nasa_csda-1.2.0.tar.gz
Algorithm Hash digest
SHA256 c3cc40d6d05cb7abdf4148e983c07dc55904fab63cfd148f46e5e9cfadf40837
MD5 ea649f419e17deda82bf9c233d451c1e
BLAKE2b-256 08037d066465359b8a4698910d6dc8a410f49cece0a0c8f505fd19a378780d4a

See more details on using hashes here.

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

Hashes for nasa_csda-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 423109d1c71df8f0881a48c9d13b448c356b95c09ddbdf0202cde52f30fafbc9
MD5 e6bfe446e11175812e225f5e01f661d7
BLAKE2b-256 63b0ae772fced7db8ed1fd602eb74e2bc2eece53f94f9df9c66bdf5fda7d8a2a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page