Skip to content

Commit 123737b

Browse files
author
Andy Barrett
committed
update README
1 parent af8d785 commit 123737b

File tree

1 file changed

+8
-3
lines changed

1 file changed

+8
-3
lines changed

notebooks/SMAP/README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,16 @@
22

33
### Summary
44

5-
In this set of three tutorials we demonstrate how to search for, download and plot SMAP data. Tutorial 1 demonstrates how to search for and download SMAP data using the `earthaccess` library. The second tutorial demonstrates how to read in and plot the data downloaded in Tutorial 1. And Tutorial 3 provides information on the surface quality and retrieval quality flags.
5+
This set of three tutorials demonstrates how to search for, download and plot SMAP data using `xarray` and how to make the SMAP data into a georeferenced dataset.
66

77
We use the [SMAP L3 Radiometer Global Daily 36 km EASE-Grid Soil Moisture, Version 8](https://nsidc.org/data/SPL3SMP/versions/8) data set as an example.
88

9+
[working_with_smap_data_in_xarray](notebooks/SMAP/working_with_smap_in_xarray.ipynb) demonstrates how to search for and download SMAP data using `earthaccess`, and how to load a single group into an `xarray.Dataset` using `open_dataset`. It also shows how to add informative dimension names and geospatial coordinates to the dataset so that the data variables can be plotted and analyzed using the powerful `xarray` methods.
10+
11+
[working_with_smap_as_datatree](notebooks/SMAP/working_with_smap_as_datatree.ipynb) demonstrates how to load the full SMAP datafile as an `xarray.Datatree`. It also shows how to load a time series of SMAP files.
12+
13+
[create_geospatial_dataset_in_xarray](notebooks/SMAP/create_geospatial_dataset_in_xarray.ipynb) is essentially the same workflow as `working_with_smap_data_in_xarray` but provides more detail and the rationale behind the modifications.
14+
915
**NOTE** these notebooks are an updated version of the notebooks orginially published in this [repo](https://github.com/nsidc/smap_python_notebooks/tree/main). The notebooks are based on notebooks originally provided to NSIDC by Adam Purdy. Jennifer Roebuck of NSIDC applied the following updates:
1016
* Used `earthaccess` instead of `requests` for authentication, searching for and downloading the data. This reduced the code to just a few lines.
1117
* Used a more recent version of SPL3SMP (version 8).
@@ -21,5 +27,4 @@ To run the notebook provided in this folder, please see the [NSIDC-Data-Tutorial
2127
### Key Learning Objectives
2228

2329
1. Use the `earthaccess` library to search for and download SMAP data.
24-
2. Use the `h5py` library to read in the HDF5 files and plot the variables on a map using `cartopy` and `matplotlib`.
25-
3. Understand the surface quality and retrieval quality flag options.
30+
2. Use the `xarray` library to read in the HDF5 files and plot the variables on a map using `xarray` plotting methods and `cartopy`.

0 commit comments

Comments
 (0)