|
1 | 1 | # ICESat-2 Cloud Access |
2 | 2 |
|
3 | 3 | ## Summary |
4 | | -This notebook demonstrates searching for cloud-hosted ICESat-2 data and directly accessing Land Ice Height (ATL06) granules from an Amazon Compute Cloud (EC2) instance using the `earthaccess` package. NASA data "in the cloud" are stored in Amazon Web Services (AWS) Simple Storage Service (S3) Buckets. **Direct Access** is an efficient way to work with data stored in an S3 Bucket when you are working in the cloud. Cloud-hosted granules can be opened and loaded into memory without the need to download them first. This allows you take advantage of the scalability and power of cloud computing. |
| 4 | +We provide several notebooks showcasing how to search and access ICESat-2 from the NASA Earthdata Cloud. NASA data "in the cloud" are stored in Amazon Web Services (AWS) Simple Storage Service (S3) Buckets. **Direct Access** is an efficient way to work with data stored in an S3 Bucket when you are working in the cloud. Cloud-hosted granules can be opened and loaded into memory without the need to download them first. This allows you take advantage of the scalability and power of cloud computing. |
| 5 | + |
| 6 | +### [Accessing and working with ICESat-2 data in the cloud](./ATL06-direct-access_rendered.ipynb) |
| 7 | +This notebook demonstrates searching for cloud-hosted ICESat-2 data and directly accessing Land Ice Height (ATL06) granules from an Amazon Compute Cloud (EC2) instance using the `earthaccess` package. |
| 8 | + |
| 9 | +#### Key Learning Objectives |
| 10 | +1. Use `earthaccess` to search for ICESat-2 data using spatial and temporal filters and explore search results; |
| 11 | +2. Open data granules using direct access to the ICESat-2 S3 bucket; |
| 12 | +3. Load a HDF5 group into an `xarray.Dataset`; |
| 13 | +4. Visualize the land ice heights using `hvplot`. |
| 14 | + |
| 15 | +### [UPDATE:IS2-CS2](./UPDATE-NOTEBOOK-FILENAME.ipynb) |
| 16 | +UPDATE: This notebook demonstrates... |
| 17 | + |
| 18 | +#### Key Learning Objectives |
| 19 | +UPDATE |
| 20 | +1. Objective 1 |
| 21 | +2. Objective 2 |
| 22 | +3. Objective 3 |
| 23 | +4. Objective 4 |
| 24 | + |
| 25 | +### [Processing Large-scale Time Series of ICESat-2 Sea Ice Height in the Cloud](./ATL10-h5coro_rendered.ipynb) |
| 26 | +This notebook utilizes several libraries to performantly search, access, read, and grid ATL10 data over the Ross Sea, Antarctica including `earthaccess`, `h5coro`, and `geopandas`. The notebook provides further guidance on how to scale this analysis to the entire continent, running the same workflow from a script that can be run from your laptop using [Coiled](https://www.coiled.io/). |
| 27 | + |
| 28 | +#### Key Learning Objectives |
| 29 | +1. Use earthaccess to authenticate with Earthdata Login, search for ICESat-2 data using spatial and temporal filters, and directly access files in the cloud. |
| 30 | +2. Open data granules using h5coro to efficiently read HDF5 data from the NSIDC DAAC S3 bucket. |
| 31 | +3. Load data into a geopandas.DataFrame containing geodetic coordinates, ancillary variables, and date/time converted from ATLAS Epoch. |
| 32 | +4. Grid track data to EASE-Grid v2 6.25 km projected grid using drop-in-the-bucket resampling. |
| 33 | +5. Calculate mean statistics and assign aggregated data to grid cells. |
| 34 | +6. Visualize aggregated sea ice height data on a map. |
5 | 35 |
|
6 | 36 | ## Set up |
7 | | -To run the notebook provided in this folder in the Amazon Web Services (AWS) cloud, there are a couple of options: |
8 | | -* An EC2 instance already set up with the necessary software installed to run a Jupyter notebook, and the environment set up using the provided environment.yml file. **Note:** If you are running this notebook on your own AWS EC2 instance using the environment set up using the environment.yml file in the NSIDC-Data-Tutorials/notebooks/ICESat-2_Cloud_Access/environment folder, you may need to run the following command before running the notebook to ensure the notebook executes properly: |
| 37 | +To run the notebooks provided in this folder in the Amazon Web Services (AWS) cloud, there are a couple of options: |
| 38 | +* An EC2 instance already set up with the necessary software installed to run a Jupyter notebook, and the environment set up using the provided environment.yml file. **Note:** If you are running these notebooks on your own AWS EC2 instance using the environment set up using the environment.yml file in the NSIDC-Data-Tutorials/notebooks/ICESat-2_Cloud_Access/environment folder, you may need to run the following command before running the notebook to ensure the notebook executes properly: |
9 | 39 |
|
10 | 40 | `jupyter nbextension enable --py widgetsnbextension` |
11 | 41 |
|
12 | 42 | You do NOT need to do this if you are using the environment set up using the environment.yml file from the NSIDC-Data-Tutorials/binder folder. |
13 | 43 |
|
14 | | -* Alternatively, if you have access to one, it can be run in a managed cloud-based Jupyter hub. Just make sure all the necessary libraries are installed (`earthaccess`,`xarray`, and `hvplot`). |
| 44 | +* Alternatively, if you have access to one, it can be run in a managed cloud-based Jupyter hub. Just make sure all the necessary libraries are installed (e.g. `earthaccess`,`xarray`,`hvplot`, etc.). |
15 | 45 |
|
16 | | -For further details on the prerequisites, see the 'Prerequisites' section in the notebook. |
| 46 | +For further details on the prerequisites, see the 'Prerequisites' section in each notebook. |
17 | 47 |
|
18 | | -## Key Learning Objectives |
19 | 48 |
|
20 | | -1. Use `earthaccess` to search for ICESat-2 data using spatial and temporal filters and explore search results; |
21 | | -2. Open data granules using direct access to the ICESat-2 S3 bucket; |
22 | | -3. Load a HDF5 group into an `xarray.Dataset`; |
23 | | -4. Visualize the land ice heights using `hvplot`. |
24 | 49 |
|
0 commit comments