earthdata 0.1.1a3

Client library for NASA Earthdata APIs

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.