Rename, edit and link notebooks

[Timo Cornelius Metzger (tcmetzger)]

This PR updates all tutorial notebooks that are currently in the tutorials folder of the main branch. Two notebooks (census and proximity) have not been merged yet and therefore are not included in this PR. I will update this PR to include those two notebooks once they have been merged.

All notebooks now follow a consistent file naming pattern. This includes numbering all notebooks in the following order:

1. Reprojecting and Resampling
2. Coregistration
3. Mosaicking
4. Geospatial Classification
5. Local Tools
6. Focal Statistics
7. Surface Tools
8. Proximity Tools [not yet included in this PR]
9. Zonal Statistics
10. Census Data [not yet included in this PR]
11. Landcover Classification

The basic thoughts behind this order:

• Notebooks 1 to 4 cover basic operations that are used in many of the subsequent notebooks
• Notebooks 5 to 9 cover operations that generally follow the categories of the Map Algebra Functions (Local Operations, Focal Operations, Global Operations, and Zonal Operations).
• The census data notebook (10) is similar to zonal statistics, as much of what happens there is defining and plotting zones and therefore fits in well right behind the Zonal Statistics notebook.
• The Landcover Classification notebook goes beyond the other notebooks since it introduces PyTorch.

Other than renaming and ordering notebooks, this PR includes the following updates:

• Add a "Click on this link to go to the next notebook" link at the bottom of each notebook.
• Check and update external and internal links
• Edit for stylistic consistency, orthography, and interpunctuation (based on the Microsoft Writing Style Guide).

Since the Landcover Classification was note created by makepath, this PR only changes the filename but leaves the file unchanged otherwise.

[Tom Augspurger (TomAugspurger)]

Thanks. I believe the README links to these notebooks. Can you make sure those links are updated?

[Tom Augspurger (TomAugspurger)]

And FYI, proximity has been merged now.

[Timo Cornelius Metzger (tcmetzger)]

Tom Augspurger (@TomAugspurger) Thanks for your feedback! My recent commits add the proximity notebook and also update the links in README.md.

[thuydotm]

Thanks Tom Augspurger (@TomAugspurger)

I'm noticing some error when searching for STAC items using pystac_client. Are there any changes with the API or with the set up on Planetary Computer?

bounds= [-57.151965, -2.530125, -55.710724, -1.179033]
catalog=pystac_client.Client.open(
"https://planetarycomputer-staging.microsoft.com/api/stac/v1"
)
jrc=catalog.search(collections=["jrc-gsw"], bbox=bounds)
items=list(jrc.get_items())
print(f"Returned {len(items)} Items")

---------------------------------------------------------------------------NotImplementedErrorTraceback (mostrecentcalllast)
/tmp/ipykernel_359/2968004645.pyin<module>4"https://planetarycomputer-staging.microsoft.com/api/stac/v1"5 )
---->6jrc=catalog.search(collections=["jrc-gsw"], bbox=bounds)
78items=list(jrc.get_items())
/srv/conda/envs/notebook/lib/python3.8/site-packages/pystac_client/client.pyinsearch(self, **kwargs)
166'No link with "rel" type of "search" could be found in this catalog')
167-->168returnItemSearch(search_link.target, stac_io=self._stac_io, client=self, **kwargs)
/srv/conda/envs/notebook/lib/python3.8/site-packages/pystac_client/item_search.pyin__init__(self, url, limit, bbox, datetime, intersects, ids, collections, query, sortby, fields, max_items, method, stac_io, client)
171else:
172self._stac_io=StacApiIO()
-->173self._stac_io.assert_conforms_to(ConformanceClasses.ITEM_SEARCH)
174175self._max_items=max_items/srv/conda/envs/notebook/lib/python3.8/site-packages/pystac_client/stac_api_io.pyinassert_conforms_to(self, conformance_class)
212 """
213 if not self.conforms_to(conformance_class):
--> 214 raise NotImplementedError(f"{conformance_class} not supported")
215else:
216returnTrueNotImplementedError: ConformanceClasses.ITEM_SEARCHnotsupported

[Tom Augspurger (TomAugspurger)]

The staging deployment is going through some changes. Does using https://planetarycomputer-staging.microsoft.com/api/stac/v1 work for you?

[thuydotm]

Thanks for the insights. The staging doesn't work. "https://planetarycomputer.microsoft.com/api/stac/v1 works though.

[Timo Cornelius Metzger (tcmetzger)]

Tom Malone (@tom) this PR should now be up to date with main. It now also includes the census notebook which I renamed to fit the pattern of the other notebooks. I also added a link to the next notebook at the end, as we have for all the other notebooks. I think this PR is now ready to merge!