Skip to content

Commit 02c038d

Browse files
betolinkbetolink
authored
Merge pull request #85 from nsidc/is2-cryo2
New is2-cs2 tutorial
2 parents a35203f + 528dde2 commit 02c038d

7 files changed

+625
-52
lines changed

‎README.md

+34-25
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,33 @@ This combined repository includes tutorials and code resources provided by the N
1111

1212
## Tutorials
1313

14+
### [ICESat-2_Cloud_Access Notebooks](./notebooks/ICESat-2_Cloud_Access)
15+
16+
These notebooks demonstrate how to search and access ICESat-2 from the NASA Earthdata Cloud:
17+
18+
**Accessing and working with ICESat-2 Data in the Cloud**
19+
20+
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.
21+
22+
**Plotting ICESat-2 and CryoSat-2 Freeboards**
23+
24+
This notebook demonstrates plotting ICESat-2 and CryoSat-2 data in the same map from within an AWS ec2 instance. ICESat-2 data are accessed via "direct S3 access" using `earthaccess`. CryoSat-2 data are downloaded to our cloud instance from their ftp storage lcoation and accessed locally.
25+
26+
**Processing Large-scale Time Series of ICESat-2 Sea Ice Height in the Cloud**
27+
28+
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/).
29+
30+
### [MEaSUREs](./notebooks/measures)
31+
32+
**Download, crop, resample, and plot multiple GeoTIFFs**
33+
34+
This tutorial guides you through programmatically accessing and downloading GeoTIFF files from the NSIDC DAAC to your local computer. We then crop and resample one GeoTIFF based on the extent and pixel size of another GeoTIFF, then plot one on top of the other.
35+
36+
We will use two data sets from the NASA [MEaSUREs](https://nsidc.org/data/measures) (Making Earth System data records for Use in Research Environments) program as an example:
37+
38+
* [MEaSUREs Greenland Ice Mapping Project (GrIMP) Digital Elevation Model from GeoEye and WorldView Imagery, Version 2 (NSIDC-0715)](https://nsidc.org/data/nsidc-0715/versions/2)
39+
* [MEaSUREs Greenland Ice Velocity: Selected Glacier Site Velocity Maps from InSAR, Version 4 (NSIDC-0481)](https://nsidc.org/data/nsidc-0481/versions/4)
40+
1441
### [SnowEx_ASO_MODIS_Snow](./notebooks/SnowEx_ASO_MODIS_Snow)
1542

1643
**Snow Depth and Snow Cover Data Exploration**
@@ -23,6 +50,13 @@ Originally demonstrated through the NASA Earthdata Webinar "Let It Snow! Accessi
2350

2451
Originally presented during the 2019 AGU Fall Meeting, this tutorial demonstrates the NSIDC DAAC's data discovery, access, and subsetting services, along with basic open source resources used to harmonize and analyze data across multiple products. The tutorial is provided as a series of Python-based Jupyter Notebooks, focusing on sea ice height and ice surface temperature data from NASA’s ICESat-2 and MODIS missions, respectively, to characterize Arctic sea ice.
2552

53+
### [ITS_LIVE](./notebooks/itslive)
54+
55+
**Global land ice velocities.**
56+
The Inter-mission Time Series of Land Ice Velocity and Elevation (ITS_LIVE) project facilitates ice sheet, ice shelf and glacier research by providing a globally comprehensive and temporally dense multi-sensor record of land ice velocity and elevation with low latency. Scene-pair velocities were generated from satellite optical and radar imagery.
57+
58+
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.
59+
2660
### [IceFlow](./notebooks/iceflow)
2761

2862
> [!CAUTION]
@@ -37,31 +71,6 @@ Originally presented during the 2019 AGU Fall Meeting, this tutorial demonstrate
3771
**Harmonized data for pre-IceBridge, ICESat and IceBridge data sets.**
3872
These Jupyter notebooks are interactive documents to teach students and researchers interested in cryospheric sciences how to access and work with airborne altimetry and related data sets from NASA’s [IceBridge](https://www.nasa.gov/mission_pages/icebridge/index.html) mission, and satellite altimetry data from [ICESat](https://icesat.gsfc.nasa.gov/icesat/) and [ICESat-2](https://icesat-2.gsfc.nasa.gov/) missions using the NSIDC **IceFlow API**
3973

40-
41-
### [ITS_LIVE](./notebooks/itslive)
42-
43-
**Global land ice velocities.**
44-
The Inter-mission Time Series of Land Ice Velocity and Elevation (ITS_LIVE) project facilitates ice sheet, ice shelf and glacier research by providing a globally comprehensive and temporally dense multi-sensor record of land ice velocity and elevation with low latency. Scene-pair velocities were generated from satellite optical and radar imagery.
45-
46-
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.
47-
48-
### [ICESat-2_Cloud_Access](./notebooks/ICESat-2_Cloud_Access)
49-
50-
**Accessing and working with ICESat-2 Data in the Cloud**
51-
52-
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.
53-
54-
### [MEaSUREs](./notebooks/measures)
55-
56-
**Download, crop, resample, and plot multiple GeoTIFFs**
57-
58-
This tutorial guides you through programmatically accessing and downloading GeoTIFF files from the NSIDC DAAC to your local computer. We then crop and resample one GeoTIFF based on the extent and pixel size of another GeoTIFF, then plot one on top of the other.
59-
60-
We will use two data sets from the NASA [MEaSUREs](https://nsidc.org/data/measures) (Making Earth System data records for Use in Research Environments) program as an example:
61-
62-
* [MEaSUREs Greenland Ice Mapping Project (GrIMP) Digital Elevation Model from GeoEye and WorldView Imagery, Version 2 (NSIDC-0715)](https://nsidc.org/data/nsidc-0715/versions/2)
63-
* [MEaSUREs Greenland Ice Velocity: Selected Glacier Site Velocity Maps from InSAR, Version 4 (NSIDC-0481)](https://nsidc.org/data/nsidc-0481/versions/4)
64-
6574
## Usage with Binder
6675

6776
The Binder button above allows you to explore and run the notebook in a shared cloud computing environment without the need to install dependencies on your local machine. Note that this option will not directly download data to your computer; instead the data will be downloaded to the cloud environment.

‎notebooks/ICESat-2_Cloud_Access/ATL06-direct-access.ipynb

+14-17
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22
"cells": [
33
{
44
"cell_type": "markdown",
5-
"id": "c91169d7",
5+
"id": "e0754304-7036-4530-83ec-86cec0f9886b",
66
"metadata": {
77
"tags": []
88
},
99
"source": [
10-
"<center>\n",
11-
"<img src='./img/nsidc_logo.png'/>\n",
12-
" \n",
10+
"\n",
11+
"\n",
1312
"# **Accessing and working with ICESat-2 data in the cloud**\n",
14-
" \n",
15-
"</center>\n",
16-
" \n",
13+
"\n",
14+
"\n",
15+
"<div align=\"left\"><img src='https://raw.githubusercontent.com/nsidc/NSIDC-Data-Tutorials/is2-cryo2/notebooks/ICESat-2_Cloud_Access/img/nsidc_logo.png'/></div>\n",
16+
" \n",
1717
"\n",
1818
"## **1. Tutorial Overview**\n",
1919
"\n",
@@ -44,18 +44,15 @@
4444
"\n",
4545
"### **Prerequisites**\n",
4646
"\n",
47-
"1. An Amazon Web Services (AWS) account. You will be accessing data in Amazon Web Services (AWS) Simple Storage Service (S3) buckets. This requires an AWS account, for details on how to set one up see [here](https://nsidc.org/data/user-resources/help-center/nasa-earthdata-cloud-data-access-guide#anchor-1).\n",
48-
"2. An EC2 instance in the us-west-2 region is set up. **NASA cloud-hosted data is in Amazon Region us-west2. So you also need an EC2 instance in the us-west-2 region.** An EC2 instance is a virtual computer that you create to perform processing operations in place of using your own desktop or laptop. Details on how to set up an instance can be found [here](https://nsidc.org/data/user-resources/help-center/nasa-earthdata-cloud-data-access-guide#anchor-1).\n",
49-
"3. An Earthdata Login is required for data access. If you don't have one, you can register for one [here](https://urs.earthdata.nasa.gov/).\n",
50-
"4. A .netrc file, that contains your Earthdata Login credentials, in your home directory. The current recommended practice for authentication is to create a .netrc file in your home directory following [these instructions](https://nsidc.org/support/how/how-do-i-programmatically-request-data-services) (Step 1) and to use the .netrc file for authentication when required for data access during the tutorial.\n",
51-
"5. The *nsidc-tutorials* environment is setup and activated. This [README](https://github.com/nsidc/NSIDC-Data-Tutorials/blob/main/README.md) has setup instructions.\n",
47+
"1. An EC2 instance in the us-west-2 region. **NASA cloud-hosted data is in Amazon Region us-west2. So you also need an EC2 instance in the us-west-2 region.** An EC2 instance is a virtual computer that you create to perform processing operations in place of using your own desktop or laptop. Details on how to set up an instance can be found [here](https://nsidc.org/data/user-resources/help-center/nasa-earthdata-cloud-data-access-guide#anchor-1).\n",
48+
"2. An Earthdata Login is required for data access. If you don't have one, you can register for one [here](https://urs.earthdata.nasa.gov/).\n",
49+
"3. A .netrc file, that contains your Earthdata Login credentials, in your home directory. The current recommended practice for authentication is to create a .netrc file in your home directory following [these instructions](https://nsidc.org/support/how/how-do-i-programmatically-request-data-services) (Step 1) and to use the .netrc file for authentication when required for data access during the tutorial.\n",
50+
"4. The *nsidc-tutorials* environment is setup and activated. This [README](https://github.com/nsidc/NSIDC-Data-Tutorials/blob/main/README.md) has setup instructions.\n",
5251
"\n",
5352
"### **Example of end product** \n",
5453
"At the end of this tutorial, the following figure will be generated:\n",
55-
"<center>\n",
56-
"<img src='./img/atl06_example_end_product.png'/>\n",
57-
"</center>\n",
58-
"\n",
54+
" \n",
55+
"![ATL06 land ice heights](./img/atl06_example_end_product.png)\n",
5956
"### **Time requirement**\n",
6057
"\n",
6158
"Allow approximately 20 minutes to complete this tutorial."
@@ -397,7 +394,7 @@
397394
"name": "python",
398395
"nbconvert_exporter": "python",
399396
"pygments_lexer": "ipython3",
400-
"version": "3.9.15"
397+
"version": "3.10.14"
401398
}
402399
},
403400
"nbformat": 4,

0 commit comments

Comments
 (0)