Client library for NASA Earthdata APIs
Project description
earthdata 🌍
Client library for NASA CMR and EDL APIs
Overview
A Python library to search and access NASA datasets.
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.1a4.tar.gz
(36.4 kB
view hashes)
Built Distribution
Close
Hashes for earthdata-0.1.1a4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5247653c773f688ddf85f3f19575d27906060df7e0435c34104a9480486b4986 |
|
MD5 | 09e25790181fc4d5d1df084ebbbbc127 |
|
BLAKE2b-256 | 55be9e71ca632e08d5e8b8f8136f7868925947336aeb2e33e3936c89321c138e |