Skip to content

Commit a039b09

Browse files
author
asteiker
committed
readme updates in prep for new is2-cs2 tutorial
1 parent a35203f commit a039b09

File tree

2 files changed

+46
-11
lines changed

2 files changed

+46
-11
lines changed

README.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,12 +45,22 @@ The Inter-mission Time Series of Land Ice Velocity and Elevation (ITS_LIVE) proj
4545

4646
The notebooks on this project demonstrate how to search and access ITS_LIVE velocity pairs and provide a simple example on how to build a data cube.
4747

48-
### [ICESat-2_Cloud_Access](./notebooks/ICESat-2_Cloud_Access)
48+
### [ICESat-2_Cloud_Access Notebooks](./notebooks/ICESat-2_Cloud_Access)
49+
50+
These notebooks demonstrate how to search and access ICESat-2 from the NASA Earthdata Cloud:
4951

5052
**Accessing and working with ICESat-2 Data in the Cloud**
5153

5254
Originally presented to the UWG (User Working Group) in May 2022, this tutorial demonstrates how to search for ICESat-2 data hosted in the Earthdata Cloud and how to directly access it from an Amazon Web Services (AWS) Elastic Compute Cloud (EC2) instance using the `earthaccess` package.
5355

56+
**UPDATE: IS2-CS2 NOTEBOOK TITLE**
57+
58+
UPDATE: Description
59+
60+
**Processing Large-scale Time Series of ICESat-2 Sea Ice Height in the Cloud**
61+
62+
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/).
63+
5464
### [MEaSUREs](./notebooks/measures)
5565

5666
**Download, crop, resample, and plot multiple GeoTIFFs**
Lines changed: 35 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,49 @@
11
# ICESat-2 Cloud Access
22

33
## 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.
535

636
## 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:
939

1040
`jupyter nbextension enable --py widgetsnbextension`
1141

1242
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.
1343

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.).
1545

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.
1747

18-
## Key Learning Objectives
1948

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`.
2449

0 commit comments

Comments
 (0)