diff --git a/docs/index.html b/docs/index.html index 1c2baafd..e52d9efe 100644 --- a/docs/index.html +++ b/docs/index.html @@ -352,44 +352,61 @@ -
-

What is earthaccess?

-

hexagonal artwork of a pixalated earth with the word earthaccess

+

hexagonal artwork of a pixalated earth with the word earthaccess

+
+

Welcome to earthaccess!

+

earthaccess is a Python library for searching, +downloading, and streaming NASA Earth science data.

+

Learn more through a recent poster, +slides +and video!

+
+

Get Started

+

Using your command line, install earthaccess from PyPI using pip:

+
python -m pip install earthaccess
+

Or from conda-forge using +mamba or conda:

+
mamba install earthaccess
+
+
+

Why earthaccess?

3-panel watercolor artwork of environmental data within mountains and streams with arrows labeled 'import' and 'earthaccess' that connect to a data analysis panel and then a communicate panel
NASA Earthdata using earthaccess for impactful science. Art by Allison Horst and Openscapes.
-

Learn more about earthaccess! poster -at 2024 AGU, slides -and video from -2024 NASA tech spotlight.

-

earthaccess is a python library to search -for, and download or stream -NASA Earth science data with just a few lines of code.

-

Open science only reaches its full potential if we have easy-to-use -workflows that facilitate research in an inclusive, efficient and -reproducible way. Unfortunately —as it stands today— scientists and -students alike face a steep learning curve adapting to systems that have -grown too complex and end up spending more time on the technicalities of -the tools, cloud and NASA APIs than focusing on their important -science.

-

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.

-

The library is an open source community effort under an MIT license. We welcome contributions to improve -earthaccess. Please see the Contributing Guide to learn how to get -involved.

-

earthaccess handles authentication with NASA’s Earthdata Login (EDL), -search using NASA’s CMR -and access through fsspec.

+


+

We can use earthaccess to do impactful science, +faster:

+
    +
  • Search Data: Explore NASA’s extensive collection of Earth science +data.
    • +
  • Access Data: Download data to your local machine or stream it +directly into your Python scripts.
    • +
  • Manage Credentials: Easily manage your Earthdata Login and Earthdata +Cloud credentials.
    • +
+
+
+

Community

+

Please join us! Contribute to our open-source community effort:

+
    +
  • Contributing Guide: Learn how to contribute to +earthaccess.
    • +
  • GitHub Repository: Explore the earthaccess +codebase.
    • +
  • Contact Us: Get in touch with the earthaccess +team.
    • +
+
+
+

Credit

+

earthaccess is a community-driven project, built on top +of several NASA APIs and libraries. This has been spearheaded by NASA Openscapes, an open +source community supporting users across the NASA Earth science data +centers (Distributed Active Archive Centers (DAACs)).

+
diff --git a/docs/index.md b/docs/index.md index 2df47aca..c8bfb9c5 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,45 +1,46 @@ - +![](images/earthaccesslogo.png){alt="hexagonal artwork of a pixalated earth with the word earthaccess" width="10%"} # Welcome to `earthaccess`! -![](images/earthaccesslogo.png){alt="hexagonal artwork of a pixalated earth with the word earthaccess" width="20%"} +`earthaccess` is a Python library for searching, downloading, and streaming NASA Earth science data. -![*NASA Earthdata using `earthaccess` for impactful science. Art by Allison Horst and Openscapes.*](images/earthaccess_environmental_horst.jpg){alt="3-panel watercolor artwork of environmental data within mountains and streams with arrows labeled 'import' and 'earthaccess' that connect to a data analysis panel and then a communicate panel" width="100%"} +Learn more through a recent [poster](https://docs.google.com/presentation/d/e/2PACX-1vT8BN1C4FkHrid_eVfOwJjZzKGn9Nomb6mnDj3Nld-nD0ekzoenxQIq6Xzo9VFQsXbixCNskadBwPwM/pub#slide=id.g317ff1cef8c_1_87), [slides](https://docs.google.com/presentation/d/1K5RbQj4OKWt49kznIF9ct-cmWADlvdYA0eI7dA7_fFg/edit#slide=id.g269ad4ab477_0_691) and [video](https://www.youtube.com/watch?v=EIr3j1_wDc0)! -Learn more about `earthaccess`! [poster](https://docs.google.com/presentation/d/e/2PACX-1vT8BN1C4FkHrid_eVfOwJjZzKGn9Nomb6mnDj3Nld-nD0ekzoenxQIq6Xzo9VFQsXbixCNskadBwPwM/pub#slide=id.g317ff1cef8c_1_87) at 2024 AGU, [slides](https://docs.google.com/presentation/d/1K5RbQj4OKWt49kznIF9ct-cmWADlvdYA0eI7dA7_fFg/edit#slide=id.g269ad4ab477_0_691) and [video](https://www.youtube.com/watch?v=EIr3j1_wDc0) from 2024 NASA tech spotlight. -`earthaccess` is a python library to **search for**, and **download** or **stream** NASA Earth science data with just a few lines of code. +## Get Started -Get started with exploring and accessing NASA's vast collection of Earth science data. `earthaccess` is a Python package designed to make it easy for you to find, download, and use NASA data. +Using your command line, install `earthaccess` from [PyPI](https://pypi.org) using `pip`: -## Get Started +``` +python -m pip install earthaccess +``` -Installation: - -`pip install earthaccess` - -Documentation: User Guide, Tutorials, Glossary, How-To Guides +Or from [conda-forge](https://conda-forge.org) using `mamba` or `conda`: -## What Can You Do with `earthaccess`? - - +``` +mamba install earthaccess +``` + +## Why `earthaccess`? -- **Search NASA Data**: Explore NASA's extensive collection of Earth science data. -- **Access Data Easily**: Download data to your local machine or stream it directly into your Python scripts. -- **Manage Your Credentials**: Easily manage your Earthdata Login and Earthdata Cloud credentials. +![*NASA Earthdata using `earthaccess` for impactful science. Art by Allison Horst and Openscapes.*](images/earthaccess_environmental_horst.jpg){alt="3-panel watercolor artwork of environmental data within mountains and streams with arrows labeled 'import' and 'earthaccess' that connect to a data analysis panel and then a communicate panel" width="100%"} -## Why Use `earthaccess`? +
+ +We can use `earthaccess` to do impactful science, faster: -- **Simplify Your Workflow**: Focus on your science, not on complex data workflows. -- **Increase Efficiency**: Easily access and manage large datasets. -- **Join a Community**: Contribute to an open-source community effort. +- Search Data: Explore NASA's extensive collection of Earth science data. +- Access Data: Download data to your local machine or stream it directly into your Python scripts. +- Manage Credentials: Easily manage your Earthdata Login and Earthdata Cloud credentials. ## Community -- **Contributing Guide**: Learn how to contribute to `earthaccess`. -- **GitHub Repository**: Explore the `earthaccess` codebase. -- **Contact Us**: Get in touch with the `earthaccess` team. +Please join us! Contribute to our open-source community effort: + +- Contributing Guide: Learn how to contribute to `earthaccess`. +- GitHub Repository: Explore the `earthaccess` codebase. +- Contact Us: Get in touch with the `earthaccess` team. ## Credit -`earthaccess` is a community-driven project, built on top of several NASA APIs and libraries. We thank the NASA Openscapes team for their support and guidance. +`earthaccess` is a community-driven project, built on top of several NASA APIs and libraries. This has been spearheaded by [NASA Openscapes](https://nasa-openscapes.github.io/), an open source community supporting users across the NASA Earth science data centers (Distributed Active Archive Centers (DAACs)).