{"id":23648,"library":"earthaccess","title":"earthaccess","description":"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.","status":"active","version":"0.17.0","language":"python","source_language":"en","source_url":"https://github.com/earthaccess-dev/earthaccess","tags":["nasa","earthdata","data-access","s3","auth"],"install":[{"cmd":"pip install earthaccess","lang":"bash","label":"Default install"}],"dependencies":[],"imports":[{"note":"The library is imported as a module; no submodule import needed.","symbol":"earthaccess","correct":"import earthaccess"},{"note":"Use earthaccess.login() directly; the old auth submodule is deprecated.","wrong":"from earthaccess import auth; auth.login()","symbol":"earthaccess.login"},{"note":"open_files() was renamed to open() in a previous version.","wrong":"earthaccess.open_files()","symbol":"earthaccess.open"}],"quickstart":{"code":"import earthaccess\n\nauth = earthaccess.login()\nresults = earthaccess.search_data(\n    short_name='ATL06',\n    bounding_box=(-180, -90, 180, 90),\n    count=10\n)\nfiles = earthaccess.open(results)\n","lang":"python","description":"Authenticate, search for ICESat-2 ATL06 granules, and open remote file handles."},"warnings":[{"fix":"Wrap in try/except: try: earthaccess.login() except Exception: print('Login failed')","message":"In v0.14.0, earthaccess.login() now raises an exception on rejected credentials instead of printing a warning. Code that ignored login failures will break.","severity":"breaking","affected_versions":">=0.14.0"},{"fix":"Use .virtualize() on the store object instead.","message":"earthaccess.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.","severity":"deprecated","affected_versions":">=0.17.0"},{"fix":"Use xarray.open_dataset(earthaccess.open(results)[0]) to get an xarray Dataset.","message":"earthaccess.open() returns fsspec file objects, not xarray Datasets. You must pass them to xarray.open_dataset() or use .virtualize().","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use earthaccess.open() instead.","cause":"The function was renamed from open_files to open in an earlier version.","error":"AttributeError: module 'earthaccess' has no attribute 'open_files'"},{"fix":"Check your .netrc file or environment variables (EARTHDATA_USERNAME, EARTHDATA_PASSWORD). Or call earthaccess.login(strategy='netrc') to force netrc usage.","cause":"Credentials are invalid or expired. Since v0.14.0, this raises an exception.","error":"earthaccess.exceptions.AuthenticationError: Earthdata Login credentials rejected"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}