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.1a5.tar.gz
(37.0 kB
view hashes)
Built Distribution
Close
Hashes for earthdata-0.1.1a5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1f3e3e38128629a0f7e6079e357f84a3e51732bf9cc79dfaebbece75061dcccb |
|
MD5 | b4964454aa2ab922739123eca52af6c3 |
|
BLAKE2b-256 | e3130b75b0c68ad2129661bec3f454735f9625a075c9221c040806402473b0a0 |