From 9bd207b2dd844b2e91e5c35b5add697b53175e2f Mon Sep 17 00:00:00 2001 From: Ou Ku Date: Thu, 9 Apr 2026 14:41:25 +0200 Subject: [PATCH 1/3] integrate instructor notes inside the episode --- episodes/05-access-data.md | 16 +++++++++++++++- instructors/instructor-notes.md | 7 ------- 2 files changed, 15 insertions(+), 8 deletions(-) diff --git a/episodes/05-access-data.md b/episodes/05-access-data.md index 00f2410b..1f77b790 100644 --- a/episodes/05-access-data.md +++ b/episodes/05-access-data.md @@ -17,11 +17,14 @@ exercises: 15 - Open satellite imagery as raster data and save it to disk. ::: +::::::::::::::::::::::::::::::::::::: instructor -## Considerations for the position of this episode in the workshop +### Considerations for the position of this episode in the workshop *When this workshop is taught to learners with limited prior knowledge of Python, it might be better to place this episode after episode 11 and before episode 12. This episode contains an introduction to working with APIs and dictionaries, which can be perceived as challenging by some learners. Another consideration for placing this episode later in the workshop is when it is taught to learners with prior GIS knowledge who want to perform GIS-like operations with data they have already collected or for learners interested in working with raster data but less interested in satellite images.* +::::::::::::::::::::::::::::::::::::: + ## Introduction A number of satellites take snapshots of the Earth's surface from space. The images recorded by these remote sensors @@ -197,6 +200,17 @@ print(search.matched()) You will notice that more than 500 scenes match our search criteria. We are however interested in the period right before and after the wildfire of Rhodes. In the following exercise you will therefore have to add a time filter to our search criteria to narrow down our search for images of that period. +::::::::::::::: instructor + +### Extra attention for the following exercise + +- The exercise **Exercise: Search satellite scenes using metadata filters** needs extra attention. Its output `search.json` is required for the later episodes. Therefore we recommend: + - Do not skip this exercise; + - Think twice when you would like to change the query arguments in this exercise; + - Make sure all the audience have the output `search.json` before continuing. + +:::::::::::::::: + ::: challenge ## Exercise: Search satellite scenes with a time filter diff --git a/instructors/instructor-notes.md b/instructors/instructor-notes.md index 894063fe..70d217b2 100644 --- a/instructors/instructor-notes.md +++ b/instructors/instructor-notes.md @@ -4,13 +4,6 @@ title: Instructor Notes ## Instructor notes -### Episode 1 - -- The exercise **Exercise: Search satellite scenes using metadata filters** needs extra attention. Its output `search.json` is required for the later episodes. Therefore we recommend: - - Do not skip this exercise; - - Think twice when you would like to change the query arguments in this exercise; - - Make sure all the audience have the output `search.json` before continuing. - ### Episode 3 - `brpgewaspercelen_definitief_2020_small.gpkg` was created because the original file was too large to download and load. Original file, which was ~500Mb could take several minutes to load, and could crash the Jupyter terminal. From c7c1d43c05abc99b4e65ab6d182787a34cf76e5e Mon Sep 17 00:00:00 2001 From: Ou Ku Date: Thu, 9 Apr 2026 15:56:25 +0200 Subject: [PATCH 2/3] update callout for accessing protected data --- episodes/05-access-data.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/episodes/05-access-data.md b/episodes/05-access-data.md index 1f77b790..ef59f29f 100644 --- a/episodes/05-access-data.md +++ b/episodes/05-access-data.md @@ -581,11 +581,14 @@ The authentication procedure for dataset with restricted access might differ dep NASA CMR, follow these steps in order to access data using Python: * Create a NASA Earthdata login account [here](https://urs.earthdata.nasa.gov); -* Set up a netrc file with your credentials, e.g. by using [this script](https://git.earthdata.nasa.gov/projects/LPDUR/repos/daac_data_download_python/browse/EarthdataLoginSetup.py); -* Define the following environment variables: +* Set up a netrc file with your credentials, e.g. by using [earthaccess](https://earthaccess.readthedocs.io/en/latest/user/authenticate/), which can be executed interactively in a Jupyter session, and creates a `.netrc` file in your home directory; +* Define the following environment variables in your Jupyter session: ```python import os +# Note that the cookies.txt file does not exist at this stage +# It is needed by rasterio.open_rasterio function, which calls GDAL in the background +# GDAL needs the path to the cookies.txt to store cookies os.environ["GDAL_HTTP_COOKIEFILE"] = "./cookies.txt" os.environ["GDAL_HTTP_COOKIEJAR"] = "./cookies.txt" ``` From fbf93e36a0034b9938f174a0982f8fc89e7b518f Mon Sep 17 00:00:00 2001 From: Ou Ku Date: Mon, 13 Apr 2026 14:34:04 +0200 Subject: [PATCH 3/3] Update episodes/05-access-data.md Co-authored-by: Francesco Nattino <49899980+fnattino@users.noreply.github.com> --- episodes/05-access-data.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/episodes/05-access-data.md b/episodes/05-access-data.md index ef59f29f..a3bcd615 100644 --- a/episodes/05-access-data.md +++ b/episodes/05-access-data.md @@ -586,9 +586,8 @@ NASA CMR, follow these steps in order to access data using Python: ```python import os -# Note that the cookies.txt file does not exist at this stage -# It is needed by rasterio.open_rasterio function, which calls GDAL in the background -# GDAL needs the path to the cookies.txt to store cookies +# These variables are needed by rasterio.open_rasterio function, which calls GDAL in the background +# GDAL needs the path where to store cookies os.environ["GDAL_HTTP_COOKIEFILE"] = "./cookies.txt" os.environ["GDAL_HTTP_COOKIEJAR"] = "./cookies.txt" ```