Client library for NASA Earthdata APIs
Project description
earthdata
A NASA CMR/EDL client library
A summary phrase to catch attention!
Overview
Installing earthdata
Install the latest release:
pip install earthdata
Or you can clone earthdata
and get started locally
# ensure you have Poetry installed
pip install --user poetry
# install all dependencies (including dev)
poetry install
# test
poetry run pytest
# develop!
Example Usage
from earthdata import Auth, DataGranules, DataCollections, Accessor
auth = Auth() # if we want to access NASA DATA in the cloud
collections = DataCollections(auth).keyword('MODIS').get(10)
collections
granules = DataGranules(auth).concept_id('C1711961296-LPCLOUD').bounding_box(-10,20,10,50).get(5)
granules
# We provide some convenience functions for each result
data_links = [granule.data_links() for granule in granules]
data_links
# The Acessor class allows to get the granules from on-prem locations with get()
# if you're in a AWS instance (us-west-2) you can use open() to get a fileset!
# NOTE: Some datasets require users to accept a Licence Agreement before accessing them
access = Accessor(auth)
# This works with both, on-prem or cloud based collections**
access.get(granules[0:10], './data')
# If we are running in us-west-2 we can use open !!
fileset = accessor.open(granules[0:10])
xarray.open_mfdataset(fileset, combine='by_coords')
Only Python 3.7+ is supported as required by the black, pydantic packages
Contributing Guide
Welcome! 😊👋
Please see the Contributing Guide.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
earthdata-0.1.1a1.tar.gz
(14.6 kB
view hashes)
Built Distribution
Close
Hashes for earthdata-0.1.1a1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4cf0add36c8f31e2ec9ca59912ccf9c68f5774c1a62834b7a17e9c0295b7214f |
|
MD5 | 57f4f0abc5c3b48df6e1e0b1495afc28 |
|
BLAKE2b-256 | 453ec2b58d2a0584e55603e508071599c70a0368b667bc51745d82e872dcef4a |