Registry / data / earthaccess

earthaccess

JSON →
library0.17.0pypypi✓ verified 34d ago

Client library for NASA Earthdata APIs. Provides authenticated search, access, and streaming of NASA Earth science data via Earthdata Login. Current version: 0.17.0. Releases on a monthly cadence.

data
Install & Compatibility
Where this runs
tested against v0.14.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 1.612s · 64.6MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 7.7s · import 1.476s · 67MB
81MB installed
● package 81MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

The library is imported as a module; no submodule import needed.

import earthaccess

Use earthaccess.login() directly; the old auth submodule is deprecated.

open_files() was renamed to open() in a previous version.

Authenticate, search for ICESat-2 ATL06 granules, and open remote file handles.

import earthaccess auth = earthaccess.login() results = earthaccess.search_data( short_name='ATL06', bounding_box=(-180, -90, 180, 90), count=10 ) files = earthaccess.open(results)
Debug
Known footguns
breakingIn v0.14.0, earthaccess.login() now raises an exception on rejected credentials instead of printing a warning. Code that ignored login failures will break.
deprecatedearthaccess.open_virtual_dataset() and open_virtual_mfdataset() are deprecated in v0.17.0 ahead of v1.0. They are replaced by the unified .virtualize() method.
gotchaearthaccess.open() returns fsspec file objects, not xarray Datasets. You must pass them to xarray.open_dataset() or use .virtualize().
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
22 hits · last 30 days
claudebot
5
gptbot
4
amazonbot
4
ahrefsbot
3
script
1
bingbot
1
Resources