earthaccess

Search, download or stream NASA Earth science data with just a few lines of code.
https://github.com/nsidc/earthaccess

Category: Sustainable Development
Sub Category: Data Catalogs and Interfaces

Keywords

access climate-data cloud-computing cmr data gis nasa nasa-api nasa-data open-science openscience pangeo remote-sensing

Keywords from Contributors

icesat-2 glacier closember cryosphere zarr earth-observation transforms community-driven archiving observation

Last synced: about 5 hours ago
JSON representation

Repository metadata

Python Library for NASA Earthdata APIs

• Host: GitHub
• URL: https://github.com/nsidc/earthaccess
• Owner: nsidc
• License: mit
• Created: 2021-08-25T15:25:00.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-26T03:04:22.000Z (5 days ago)
• Last Synced: 2025-04-26T04:28:02.349Z (5 days ago)
• Topics: access, climate-data, cloud-computing, cmr, data, gis, nasa, nasa-api, nasa-data, open-science, openscience, pangeo, remote-sensing
• Language: Python
• Homepage: https://earthaccess.readthedocs.io/
• Size: 12.1 MB
• Stars: 483
• Watchers: 13
• Forks: 105
• Open Issues: 136
• Releases: 25
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt
  • Code of conduct: CODE_OF_CONDUCT.md
  • Citation: CITATION.cff

README.md

python -m pip install earthaccess

import earthaccess

# 1. Login
earthaccess.login()

# 2. Search
results = earthaccess.search_data(
    short_name='ATL06',  # ATLAS/ICESat-2 L3A Land Ice Height
    bounding_box=(-10, 20, 10, 50),  # Only include files in area of interest...
    temporal=("1999-02", "2019-03"),  # ...and time period of interest.
    count=10
)

# 3. Access
files = earthaccess.download(results, "/tmp/my-download-folder")

Citation (CITATION.cff)

cff-version: 1.2.0
message: |
  Please cite this software using these metadata.
  Authors are listed in alphabetical order.

title: "earthaccess"
doi: "10.5281/zenodo.8365009"
abstract: "Python Library for NASA Earthdata APIs"
contact:
  - name: "The earthaccess community"
    website: "https://github.com/nsidc/earthaccess/discussions"
  - name: "NSIDC"
    email: "nsidc@nsidc.org"
type: "software"
# NOTE: The CFF spec says `license` can be a list, but Zenodo is currently not
#       accepting lists for this key:
#       https://github.com/zenodo/zenodo/issues/2515
license: "MIT"
keywords:
  - "data"
  - "Remote sensing"
  - "Cloud computing"
  - "authentication"
  - "Earthdata Login"

url: "https://earthaccess.readthedocs.io"
repository-code: "https://github.com/nsidc/earthaccess"

version: "0.14.0"
date-released: "2025-02-11"

authors:
  - family-names: "Barrett"
    given-names: "Andrew"
    orcid: "https://orcid.org/0000-0003-4394-5445"
    website: "https://github.com/andypbarrett"
  - family-names: "Battisto"
    given-names: "Chris"
    orcid: "https://orcid.org/0000-0002-9608-3634"
    website: "https://github.com/battistowx"
  - family-names: "Bourbeau"
    given-names: "James"
    orcid: "https://orcid.org/0000-0003-2164-7789"
    website: "https://github.com/jrbourbeau"
  - family-names: "Fisher"
    given-names: "Matt"
    orcid: "https://orcid.org/0000-0003-3260-5445"
    website: "https://mfisher87.github.io/"
  - family-names: "Kaufman"
    given-names: "Daniel"
    orcid: "https://orcid.org/0000-0002-1487-7298"
    website: "https://github.com/danielfromearth"
  - family-names: "Kennedy"
    given-names: "Joseph"
    orcid: "https://orcid.org/0000-0002-9348-693X"
    website: "https://github.com/jhkennedy"
  - family-names: "Lopez"
    given-names: "Luis"
    orcid: "https://orcid.org/0000-0003-4896-3263"
    website: "https://github.com/betolink"
  - family-names: "Lowndes"
    given-names: "Julia"
    orcid: "https://orcid.org/0000-0003-1682-3872"
    website: "https://github.com/jules32"
  - family-names: "Scheick"
    given-names: "Jessica"
    orcid: "https://orcid.org/0000-0002-3421-4459"
    website: "https://github.com/JessicaS11"
  - family-names: "Steiker"
    given-names: "Amy"
    orcid: "https://orcid.org/0000-0002-3039-0260"
    website: "https://github.com/asteiker"



references:
  - type: "grant"
    title: "Openscapes: Supporting better science for future us"
    institution:
      name: "National Aeronautics and Space Administration"
    number: "20-TWSC20-2-0003"
    authors:
      - family-names: "Lowndes"
        given-names: "Julia"
        orcid: "https://orcid.org/0000-0003-1682-3872"
        website: "https://github.com/jules32"
      - family-names: "Robinson"
        given-names: "Erin"
        orcid: "https://orcid.org/0000-0001-9998-0114"
        website: "https://erinrobinson.info/"

Owner metadata

• Name: National Snow and Ice Data Center
• Login: nsidc
• Email: nsidc@nsidc.org
• Kind: organization
• Description: University of Colorado Boulder
• Website: http://www.nsidc.org/
• Location: Boulder, Colorado
• Twitter: NSIDC
• Company:
• Icon url: https://avatars.githubusercontent.com/u/1874284?v=4
• Repositories: 119
• Last ynced at: 2024-04-16T01:06:28.908Z
• Profile URL: https://github.com/nsidc

GitHub Events

Total

• Create event: 32
• Release event: 3
• Issues event: 78
• Watch event: 69
• Delete event: 25
• Issue comment event: 525
• Member event: 4
• Push event: 167
• Pull request event: 102
• Pull request review comment event: 159
• Pull request review event: 214
• Fork event: 23

Last Year

• Create event: 32
• Release event: 3
• Issues event: 78
• Watch event: 69
• Delete event: 25
• Issue comment event: 525
• Member event: 4
• Push event: 167
• Pull request event: 102
• Pull request review comment event: 159
• Pull request review event: 214
• Fork event: 23

Committers metadata

Last synced: 1 day ago

Committer domains:

• nasa.gov: 6
• nsidc.org: 4
• colorado.edu: 2
• esr.org: 1
• developmentseed.org: 1
• viasat.com: 1
• openscapes.org: 1
• vt.edu: 1
• jhkennedy.org: 1

Issue and Pull Request metadata

Last synced: 1 day ago

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 69,008 last-month
• Total docker downloads: 155
• Total dependent packages: 8
• Total dependent repositories: 7
• Total versions: 19
• Total maintainers: 1

Dependencies

Score: 21.310256428399462