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 closember glacier cryosphere zarr community-driven 2023-hackweek jupyterbook data-access earth-observation
Last synced: about 16 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 4 years ago)
- Default Branch: main
- Last Pushed: 2025-10-14T17:46:32.000Z (2 months ago)
- Last Synced: 2025-10-25T18:17:54.618Z (2 months 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: 15.4 MB
- Stars: 556
- Watchers: 11
- Forks: 131
- Open Issues: 119
- Releases: 27
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Governance: docs/governance/decisions/231-aws-us-west-2-checking-method.md
README.md
earthaccess
earthaccess is a python library to search for, and download or stream NASA Earth science data with just a few lines of code.
Visit our documentation to learn more!
Try it in your browser without installing anything!
Why earthaccess
During several workshops organized by NASA Openscapes, the need to provide easy-to-use tools to our users became evident. Open science is a collaborative effort; it involves people from different technical backgrounds, and the data analysis to solve the pressing problems we face cannot be limited by the complexity of the underlying systems. Therefore, providing easy access to NASA Earthdata regardless of the data storage location (hosted within or outside of the cloud) is the main motivation behind this Python library.
How to Get Started with earthaccess
How to install
To install earthaccess go to your terminal and install it using pip:
python -m pip install earthaccess
How to access NASA Earth Science data
With earthaccess, data is 3 steps away!
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")
Visit our quick start guide for more details.
Help!
We're here for you!
Before you open a new issue/discussion/topic, please search to see if anyone else has
opened a similar one.
🐛 If you've found a bug or mistake, please use
GitHub issues.
💡 If you'd like to request a feature or ask a question, please use
GitHub discussions.
🗨️ If you prefer real-time chat, please visit us in our
Zulip chat space!
We'd love to see you there! 👐
Compatibility
The minimum supported Python version is 3.11.
How to Contribute to earthaccess
If you want to contribute to earthaccess checkout the Contributing Guide.
Contributors
Project Board.
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.15.1"
date-released: "2025-09-16"
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"
- family-names: "Varghese"
given-names: "Sherwin"
orcid: "https://orcid.org/0009-0005-7030-213X"
website: "https://github.com/Sherwin-14"
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
- Fork event: 39
- Discussion event: 2
- Create event: 53
- Release event: 4
- Issues event: 120
- Watch event: 106
- Delete event: 45
- Issue comment event: 804
- Member event: 5
- Push event: 242
- Pull request event: 177
- Pull request review comment event: 280
- Pull request review event: 379
Last Year
- Fork event: 38
- Discussion event: 2
- Create event: 53
- Release event: 4
- Issues event: 101
- Watch event: 101
- Delete event: 45
- Member event: 4
- Issue comment event: 745
- Push event: 240
- Pull request review event: 373
- Pull request review comment event: 276
- Pull request event: 176
Committers metadata
Last synced: about 2 months ago
Total Commits: 1,112
Total Committers: 49
Avg Commits per committer: 22.694
Development Distribution Score (DDS): 0.756
Commits in past year: 331
Committers in past year: 29
Avg Commits per committer in past year: 11.414
Development Distribution Score (DDS) in past year: 0.749
| Name | Commits | |
|---|---|---|
| betolink | b****n@g****m | 271 |
| Matt Fisher | m****7@g****m | 174 |
| Andy Barrett | a****t@n****g | 81 |
| Joseph H Kennedy | me@j****g | 66 |
| Sherwin Varghese | 1****4 | 63 |
| danielfromearth | d****n@n****v | 53 |
| James Bourbeau | j****u@g****m | 51 |
| Chuck Daniels | c****k@d****g | 39 |
| betolink:w | l****z@n****g | 30 |
| Ian Carroll | i****l@n****v | 30 |
| doug-newman-nasa | d****n@n****v | 25 |
| jennifer | j****k@c****u | 24 |
| pre-commit-ci[bot] | 6****] | 23 |
| Andy Barrett | a****t@g****m | 21 |
| ayushnag | 3****g | 17 |
| dependabot[bot] | 4****] | 17 |
| Matt Fisher | m****r@n****g | 14 |
| Chris Battisto | 3****x | 10 |
| karthik venkataramani | k****t@v****u | 10 |
| Hailiang Zhang | h****g@n****v | 9 |
| Owen Littlejohns | o****s@n****v | 8 |
| Kevin Grimes | K****s@j****v | 7 |
| Trey Stafford | t****d@c****u | 6 |
| Doug Newman | d****n@n****v | 6 |
| Amy Steiker | 4****r | 6 |
| asteiker | a****r@g****m | 6 |
| Jessica Scheick | j****k@g****m | 5 |
| alex | a****v@n****v | 5 |
| Tyler Sutterley | t****l@u****u | 4 |
| Aimee Barciauskas | a****e@d****g | 3 |
| and 19 more... | ||
Committer domains:
- nasa.gov: 8
- colorado.edu: 3
- nsidc.org: 3
- developmentseed.org: 2
- esr.org: 1
- viasat.com: 1
- openscapes.org: 1
- uw.edu: 1
- jpl.nasa.gov: 1
- vt.edu: 1
- jhkennedy.org: 1
Issue and Pull Request metadata
Last synced: about 2 months ago
Total issues: 411
Total pull requests: 709
Average time to close issues: 4 months
Average time to close pull requests: 16 days
Total issue authors: 111
Total pull request authors: 72
Average comments per issue: 2.4
Average comments per pull request: 3.02
Merged pull request: 373
Bot issues: 15
Bot pull requests: 265
Past year issues: 74
Past year pull requests: 188
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 22 days
Past year issue authors: 27
Past year pull request authors: 33
Past year average comments per issue: 0.61
Past year average comments per pull request: 3.77
Past year merged pull request: 123
Past year bot issues: 10
Past year bot pull requests: 38
Top Issue Authors
- mfisher87 (88)
- betolink (36)
- andypbarrett (18)
- github-actions[bot] (15)
- itcarroll (15)
- chuckwondo (15)
- jrbourbeau (14)
- danielfromearth (13)
- asteiker (10)
- MattF-NSIDC (9)
- alrolfchamberlin3 (5)
- JessicaS11 (5)
- jules32 (4)
- scottyhq (4)
- alrolfchamberlin2 (3)
Top Pull Request Authors
- dependabot[bot] (235)
- mfisher87 (74)
- Sherwin-14 (47)
- betolink (46)
- chuckwondo (38)
- jhkennedy (36)
- pre-commit-ci[bot] (30)
- jrbourbeau (24)
- itcarroll (22)
- danielfromearth (15)
- asteiker (12)
- JessicaS11 (9)
- andypbarrett (9)
- weiji14 (6)
- jules32 (5)
Top Issue Labels
- enhancement (31)
- bug (30)
- documentation (22)
- good first issue (22)
- type: enhancement (20)
- impact: documentation (20)
- type: bug (19)
- metrics (13)
- automation (12)
- question (8)
- needs: feedback requested (7)
- needs: decision (6)
- needs: triage (6)
- impact: automation (6)
- needs: help (5)
- feedback requested (4)
- help wanted (3)
- hackathon (2)
- impact: governance (2)
- type: experience report (2)
- github_actions (1)
- dependencies (1)
- wontfix (1)
- impact/governance (1)
Top Pull Request Labels
- dependencies (224)
- python (29)
- github_actions (29)
- hackathon (13)
- impact: dependencies (11)
- help wanted (6)
- impact: documentation (6)
- enhancement (2)
- documentation (2)
- automation (2)
- impact: governance (2)
- needs: help (1)
- impact: automation (1)
- type: enhancement (1)
- type: decision record (1)
Package metadata
- Total packages: 2
-
Total downloads:
- pypi: 80,447 last-month
- Total docker downloads: 155
- Total dependent packages: 8 (may contain duplicates)
- Total dependent repositories: 7 (may contain duplicates)
- Total versions: 57
- Total maintainers: 1
pypi.org: earthaccess
Client library for NASA Earthdata APIs
- Homepage:
- Documentation: https://earthaccess.readthedocs.io
- Licenses: MIT License
- Latest release: 0.15.1 (published 3 months ago)
- Last Synced: 2025-10-29T20:43:46.440Z (about 2 months ago)
- Versions: 21
- Dependent Packages: 8
- Dependent Repositories: 7
- Downloads: 80,447 Last month
- Docker Downloads: 155
-
Rankings:
- Docker downloads count: 2.317%
- Dependent packages count: 2.377%
- Stargazers count: 4.196%
- Average: 4.412%
- Dependent repos count: 5.533%
- Downloads: 5.775%
- Forks count: 6.275%
- Maintainers (1)
proxy.golang.org: github.com/nsidc/earthaccess
- Homepage:
- Documentation: https://pkg.go.dev/github.com/nsidc/earthaccess#section-documentation
- Licenses: mit
- Latest release: v0.15.1 (published 3 months ago)
- Last Synced: 2025-10-29T20:43:45.887Z (about 2 months ago)
- Versions: 36
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.395%
- Average: 5.576%
- Dependent repos count: 5.758%
Dependencies
- autoflake >=1.3 develop
- black >=21.11b0 develop
- flake8 >=3.7 develop
- ipywidgets ^7.7.0 develop
- isort >=5 develop
- jupyterlab >=3 develop
- markdown-include >=0.6 develop
- mkdocs >=1.2 develop
- mkdocs-jupyter =0.19.0 develop
- mkdocs-material >=7.1,<9.0 develop
- mkdocstrings >=0.18 develop
- mypy >=0.812 develop
- pre-commit >=2.4 develop
- pygments =2.11.1 develop
- pymdown-extensions =9.2 develop
- pytest >=6.0 develop
- pytest-cov >=2.8 develop
- pytest-watch >=4.2 develop
- responses >=0.14 develop
- types-requests >=0.1 develop
- types-setuptools >=0.1 develop
- widgetsnbextension ^3.6.0 develop
- pqdm >=0.1
- python >=3.8,<4.0
- python-benedict >=0.25
- python-cmr >=0.7
- requests >=2.26
- s3fs >=2021.11, <2024
- tinynetrc ^1.3.1
- tiangolo/issue-manager master composite
- JRubics/poetry-publish v1.8 composite
- actions/checkout v2 composite
- actions/cache v1 composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- codecov/codecov-action v1 composite
- actions/cache v1 composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- codecov/codecov-action v1 composite
- 194 dependencies
- readthedocs/actions/preview v1 composite
- actions/checkout v4 composite
- actions/setup-python v4 composite
- actions/checkout v4.1.1 composite
- codecov/codecov-action v1 composite
- conda-incubator/setup-miniconda v2.2.0 composite
- cartopy >=0.18.0
- dask >=2022.1
- geopandas >=0.9
- h5netcdf >=0.11
- h5py >=3.2
- holoviews
- hvplot
- ipyleaflet >=0.15
- jupyterlab >=3
- matplotlib-base >=3.3
- netcdf4 >=1.5
- panel
- python 3.9.*
- rioxarray >=0.3
- xarray >=0.19
- zarr >=2.9.5
Score: 21.704035025654314