| Name | earthaccess JSON |
| Version |
0.13.0
JSON |
| download |
| home_page | None |
| Summary | Client library for NASA Earthdata APIs |
| upload_time | 2025-01-29 04:45:51 |
| maintainer | None |
| docs_url | None |
| author | earthaccess contributors |
| requires_python | >=3.10 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# _earthaccess_
<p align="center">
<img alt="earthaccess, a python library to search, download or stream NASA Earth science data with just a few lines of code" src="https://user-images.githubusercontent.com/717735/205517116-7a5d0f41-7acc-441e-94ba-2e541bfb7fc8.png" width="70%" align="center" />
</p>
<p align="center">
<a href="https://zenodo.org/badge/latestdoi/399867529" target="_blank">
<img src="https://zenodo.org/badge/399867529.svg" alt="DOI" />
</a>
<a href="https://twitter.com/allison_horst" target="_blank">
<img src="https://img.shields.io/badge/Art%20By-Allison%20Horst-blue" alt="Art Designer: Allison Horst">
</a>
<a href="https://pypi.org/project/earthaccess" target="_blank">
<img src="https://img.shields.io/pypi/v/earthaccess?color=%2334D058&label=pypi%20package" alt="Package version">
</a>
<a href="https://anaconda.org/conda-forge/earthaccess" target="_blank">
<img src="https://img.shields.io/conda/vn/conda-forge/earthaccess.svg" alt="Conda Versions">
</a>
<a href="https://pypi.org/project/earthaccess/" target="_blank">
<img src="https://img.shields.io/pypi/pyversions/earthaccess.svg" alt="Python Versions">
</a>
<a href='https://earthaccess.readthedocs.io/en/latest/?badge=latest'>
<img src='https://readthedocs.org/projects/earthaccess/badge/?version=latest' alt='Documentation Status' />
</a>
</p>
`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](https://earthaccess.readthedocs.io/en/latest) to learn more!
Try it in your browser without installing anything! [](https://mybinder.org/v2/gh/nsidc/earthaccess/main)
## 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!
```python
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](https://earthaccess.readthedocs.io/en/latest/quick-start/) for more details.
## Compatibility
The _minimum_ supported Python version is **3.10**.
## How to Contribute to `earthaccess`
If you want to contribute to `earthaccess` checkout the [Contributing Guide](https://earthaccess.readthedocs.io/en/latest/contributing/).
### Contributors
[](https://github.com/nsidc/earthaccess/graphs/contributors)
### [Project Board](https://github.com/nsidc/earthdata/discussions).
Raw data
{
"_id": null,
"home_page": null,
"name": "earthaccess",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Luis Lopez <betolin@gmail.com>, \"Joseph H. Kennedy\" <jhkennedy@alaska.edu>, James Bourbeau <james@coiled.io>, Matt Fisher <mfisher87@gmail.com>, Chuck Daniels <chuck@developmentseed.org>",
"keywords": null,
"author": "earthaccess contributors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/af/20/75a96e0c260221e86a960150ab174b326f3dad17830316d065b6ecf7173a/earthaccess-0.13.0.tar.gz",
"platform": null,
"description": "# _earthaccess_\n\n<p align=\"center\">\n<img alt=\"earthaccess, a python library to search, download or stream NASA Earth science data with just a few lines of code\" src=\"https://user-images.githubusercontent.com/717735/205517116-7a5d0f41-7acc-441e-94ba-2e541bfb7fc8.png\" width=\"70%\" align=\"center\" />\n</p>\n\n<p align=\"center\">\n\n<a href=\"https://zenodo.org/badge/latestdoi/399867529\" target=\"_blank\">\n <img src=\"https://zenodo.org/badge/399867529.svg\" alt=\"DOI\" />\n</a>\n\n<a href=\"https://twitter.com/allison_horst\" target=\"_blank\">\n <img src=\"https://img.shields.io/badge/Art%20By-Allison%20Horst-blue\" alt=\"Art Designer: Allison Horst\">\n</a>\n\n<a href=\"https://pypi.org/project/earthaccess\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/v/earthaccess?color=%2334D058&label=pypi%20package\" alt=\"Package version\">\n</a>\n\n<a href=\"https://anaconda.org/conda-forge/earthaccess\" target=\"_blank\">\n <img src=\"https://img.shields.io/conda/vn/conda-forge/earthaccess.svg\" alt=\"Conda Versions\">\n</a>\n\n<a href=\"https://pypi.org/project/earthaccess/\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/pyversions/earthaccess.svg\" alt=\"Python Versions\">\n</a>\n\n<a href='https://earthaccess.readthedocs.io/en/latest/?badge=latest'>\n <img src='https://readthedocs.org/projects/earthaccess/badge/?version=latest' alt='Documentation Status' />\n</a>\n\n</p>\n\n\n`earthaccess` is a python library to **search for**, and **download** or **stream** NASA Earth science data with just a few lines of code.\n\nVisit [our documentation](https://earthaccess.readthedocs.io/en/latest) to learn more!\n\nTry it in your browser without installing anything! [](https://mybinder.org/v2/gh/nsidc/earthaccess/main)\n\n## Why `earthaccess`\n\nDuring 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.\n\n\n## How to Get Started with `earthaccess`\n\n### How to install\n\nTo install `earthaccess` go to your terminal and install it using `pip`:\n\n```\npython -m pip install earthaccess\n```\n\n\n### How to access NASA Earth Science data\n\nWith _earthaccess_, data is 3 steps away!\n\n```python\nimport earthaccess\n\n# 1. Login\nearthaccess.login()\n\n# 2. Search\nresults = earthaccess.search_data(\n short_name='ATL06', # ATLAS/ICESat-2 L3A Land Ice Height\n bounding_box=(-10, 20, 10, 50), # Only include files in area of interest...\n temporal=(\"1999-02\", \"2019-03\"), # ...and time period of interest.\n count=10\n)\n\n# 3. Access\nfiles = earthaccess.download(results, \"/tmp/my-download-folder\")\n```\n\nVisit [our quick start guide](https://earthaccess.readthedocs.io/en/latest/quick-start/) for more details.\n\n\n## Compatibility\n\nThe _minimum_ supported Python version is **3.10**.\n\n\n## How to Contribute to `earthaccess`\n\nIf you want to contribute to `earthaccess` checkout the [Contributing Guide](https://earthaccess.readthedocs.io/en/latest/contributing/).\n\n\n### Contributors\n\n[](https://github.com/nsidc/earthaccess/graphs/contributors)\n\n\n### [Project Board](https://github.com/nsidc/earthdata/discussions).\n",
"bugtrack_url": null,
"license": null,
"summary": "Client library for NASA Earthdata APIs",
"version": "0.13.0",
"project_urls": {
"Bug Tracker": "https://github.com/nsidc/earthaccess/issues",
"Changelog": "https://github.com/nsidc/earthaccess/blob/main/CHANGELOG.md",
"Documentation": "https://earthaccess.readthedocs.io",
"Repository": "https://github.com/nsidc/earthaccess"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9e26ee1d5ed054bbff38e2cb35bdb88d6067fc20e3b623457567f829635b3e9c",
"md5": "24f429307c7f942af9abb08706cd4cd1",
"sha256": "8e66c59ab6444a6b9f4e62dd45de1dfd7b5f893e2b7b78da6ea9b885d56d2526"
},
"downloads": -1,
"filename": "earthaccess-0.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "24f429307c7f942af9abb08706cd4cd1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 64056,
"upload_time": "2025-01-29T04:45:48",
"upload_time_iso_8601": "2025-01-29T04:45:48.742433Z",
"url": "https://files.pythonhosted.org/packages/9e/26/ee1d5ed054bbff38e2cb35bdb88d6067fc20e3b623457567f829635b3e9c/earthaccess-0.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "af2075a96e0c260221e86a960150ab174b326f3dad17830316d065b6ecf7173a",
"md5": "465d2373b8b3846e24404391d7afd843",
"sha256": "40cf494b55afee953c50d41dfd232351b014112e382d2edd4f2583078a3f19d0"
},
"downloads": -1,
"filename": "earthaccess-0.13.0.tar.gz",
"has_sig": false,
"md5_digest": "465d2373b8b3846e24404391d7afd843",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 6276024,
"upload_time": "2025-01-29T04:45:51",
"upload_time_iso_8601": "2025-01-29T04:45:51.345237Z",
"url": "https://files.pythonhosted.org/packages/af/20/75a96e0c260221e86a960150ab174b326f3dad17830316d065b6ecf7173a/earthaccess-0.13.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-29 04:45:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nsidc",
"github_project": "earthaccess",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "earthaccess"
}
