Feat/cleanup book 2 (#18)

mariogiampieri · web-flow · commit 635ee1ea30ef · 2025-06-19T12:09:11.000-04:00
* wip reorganization

* update book metadata

* update reqs
diff --git a/Assignments/.gitignore b/Assignments/.gitignore
diff --git a/Assignments/01_EXPLORATION.ipynb b/Assignments/01_EXPLORATION.ipynb
diff --git a/Assignments/01_Loading_Visualizing.md b/Assignments/01_Loading_Visualizing.md
@@ -1,4 +1,4 @@
-# Loading and visualizing data
+# 01. Loading and visualizing data
 
 Load and visualize a dataset of interest, either from [NYC Open Data](https://opendata.cityofnewyork.us/) or elsewhere. (If you already have an idea of what your final colloquium project topic will be, this would be a good opportunity to get a head start on that).
 
diff --git a/Assignments/02_Geoprocessing.md b/Assignments/02_Geoprocessing.md
@@ -1,4 +1,4 @@
-# Geoprocessing
+# 02. Geoprocessing
 
 Create a dataset that expresses a narrative from part of your daily life, either now or in the past. This can be based on a mental map of your experience in New York / another city, based on geolocated map tracks (i.e. Google Maps history), or some other source. Based on the data type (point, line, polygon), consider how it would or could relate to other datasets that lend themselves to describing your mental image of the city- subway routes, the location of open space, your favorite coffee cart, etc. We will spend time in the next class relating these kinds of datasets together. 
 - Use https://geojson.io/, https://play.placemark.io/, QGIS, or another software  to create your dataset
diff --git a/Assignments/03_Networks.md b/Assignments/03_Networks.md
@@ -1,4 +1,4 @@
-# Networks
+# 03. Networks
 
 Define a network, and calculate the distance between different elements of it. Discuss the experiential differences between Euclidean and network distance for the objects in question. Bonus points (in the form of kudos) for quantitative exploration of the network as described in Xin et al. (2022).
 
diff --git a/Assignments/04_Web_Mapping.md b/Assignments/04_Web_Mapping.md
@@ -0,0 +1 @@
+# 04. Web Mapping
diff --git a/Assignments/readme.md b/Assignments/readme.md
diff --git a/README.md b/README.md
@@ -11,4 +11,4 @@ Repository for CDP Mapping Systems summer 2025 course
 
 ## Getting started
 
-Visit the [Getting Started](Tutorials/00_Getting_Started.md) tutorial notebook to set up your programming environment and get started with the course.
+Visit the [01. Setting up your environment](Tutorials/00_Getting_Started.md) tutorial notebook to set up your programming environment and get started with the course.
diff --git a/Syllabus/syllabus.md b/Syllabus/syllabus.md
@@ -127,7 +127,7 @@ Web mapping, interactive visualization, and crowd-sourced information
   - Schröder-Bergen, S., Glasze, G., Michel, B., Dammann, F., 2022. De/colonizing OpenStreetMap? Local mappers, humanitarian and commercial actors and the changing modes of collaborative mapping. GeoJournal 87, 5051–5066. https://doi.org/10.1007/s10708-021-10547-7
 
 #### Class 08: Web mapping (Tutorial)
-- Use `leafmap`, `ipyleaflet`, and `folium` to create interactive web maps
+- Use `leafleft`, and `maplibre` to create interactive web maps
 - Loading data via API 
 - Launching a basic web map
 **Exercise:** [04_Web Mapping](/Assignment_Descriptions/04_Web_Mapping.md)
diff --git a/Tutorials/00_Getting_Started.md b/Tutorials/00_Getting_Started.md
@@ -1,4 +1,4 @@
-# Getting started
+# 01. Setting up your environment
 
 1. Install [VSCode](https://code.visualstudio.com/)
 2. Create a new Python environment. I *strongly* recommend using [Conda](https://conda.io/projects/conda/en/latest/user-guide/install/index.html) for this, but you can also use virtualenv. This will protect our system Python installation from any changes we make.
diff --git a/Tutorials/00_Python_Basics.ipynb b/Tutorials/00_Python_Basics.ipynb
@@ -1,5 +1,17 @@
 {
  "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "bbb3b8a8",
+   "metadata": {
+    "vscode": {
+     "languageId": "plaintext"
+    }
+   },
+   "source": [
+    "# 02. Python Basics"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "4f27cd01",
@@ -108,6 +120,12 @@
     "result_builtin = sum(my_list)\n",
     "print(result_builtin)  # Output: 15"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "20306eb2",
+   "metadata": {},
+   "source": []
   }
  ],
  "metadata": {
diff --git a/Tutorials/02_geoprocessing.ipynb b/Tutorials/02_geoprocessing.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# 02: Geoprocessing\n"
+    "# 03: Geoprocessing\n"
    ]
   },
   {
diff --git a/Tutorials/03_networks.ipynb b/Tutorials/03_networks.ipynb
@@ -1,5 +1,12 @@
 {
     "cells": [
+        {
+            "cell_type": "markdown",
+            "metadata": {},
+            "source": [
+                "# 04. Networks"
+            ]
+        },
         {
             "cell_type": "code",
             "execution_count": 1,
@@ -27167,7 +27174,7 @@
         },
         {
             "cell_type": "code",
-            "execution_count": 40,
+            "execution_count": null,
             "metadata": {},
             "outputs": [
                 {
@@ -27340,7 +27347,7 @@
             "source": [
                 "mh_net_nodes\n",
                 "\n",
-                "74-76, 88-98"
+                "74 - 76, 88 - 98"
             ]
         },
         {
diff --git a/Tutorials/04_change.ipynb b/Tutorials/04_change.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Calculating change over time\n"
+    "# 05. Calculating change over time\n"
    ]
   },
   {
diff --git a/favicon.ico b/favicon.ico
diff --git a/logo.svg b/logo.svg
@@ -0,0 +1,19 @@
+<svg fill="none" height="25" viewBox="0 0 15 15" width="25" xmlns="http://www.w3.org/2000/svg"
+				><path
+					clip-rule="evenodd"
+					d="M7.49996 1.80002C4.35194 1.80002 1.79996 4.352 1.79996 7.50002C1.79996 10.648 4.35194 13.2 7.49996 13.2C10.648 13.2 13.2 10.648 13.2 7.50002C13.2 4.352 10.648 1.80002 7.49996 1.80002ZM0.899963 7.50002C0.899963 3.85494 3.85488 0.900024 7.49996 0.900024C11.145 0.900024 14.1 3.85494 14.1 7.50002C14.1 11.1451 11.145 14.1 7.49996 14.1C3.85488 14.1 0.899963 11.1451 0.899963 7.50002Z"
+					fill="currentColor"
+					fill-rule="evenodd"></path><path
+					clip-rule="evenodd"
+					d="M13.4999 7.89998H1.49994V7.09998H13.4999V7.89998Z"
+					fill="currentColor"
+					fill-rule="evenodd"></path><path
+					clip-rule="evenodd"
+					d="M7.09991 13.5V1.5H7.89991V13.5H7.09991zM10.375 7.49998C10.375 5.32724 9.59364 3.17778 8.06183 1.75656L8.53793 1.24341C10.2396 2.82218 11.075 5.17273 11.075 7.49998 11.075 9.82724 10.2396 12.1778 8.53793 13.7566L8.06183 13.2434C9.59364 11.8222 10.375 9.67273 10.375 7.49998zM3.99969 7.5C3.99969 5.17611 4.80786 2.82678 6.45768 1.24719L6.94177 1.75281C5.4582 3.17323 4.69969 5.32389 4.69969 7.5 4.6997 9.67611 5.45822 11.8268 6.94179 13.2472L6.45769 13.7528C4.80788 12.1732 3.9997 9.8239 3.99969 7.5z"
+					fill="currentColor"
+					fill-rule="evenodd"></path><path
+					clip-rule="evenodd"
+					d="M7.49996 3.95801C9.66928 3.95801 11.8753 4.35915 13.3706 5.19448 13.5394 5.28875 13.5998 5.50197 13.5055 5.67073 13.4113 5.83948 13.198 5.89987 13.0293 5.8056 11.6794 5.05155 9.60799 4.65801 7.49996 4.65801 5.39192 4.65801 3.32052 5.05155 1.97064 5.8056 1.80188 5.89987 1.58866 5.83948 1.49439 5.67073 1.40013 5.50197 1.46051 5.28875 1.62927 5.19448 3.12466 4.35915 5.33063 3.95801 7.49996 3.95801zM7.49996 10.85C9.66928 10.85 11.8753 10.4488 13.3706 9.6135 13.5394 9.51924 13.5998 9.30601 13.5055 9.13726 13.4113 8.9685 13.198 8.90812 13.0293 9.00238 11.6794 9.75643 9.60799 10.15 7.49996 10.15 5.39192 10.15 3.32052 9.75643 1.97064 9.00239 1.80188 8.90812 1.58866 8.9685 1.49439 9.13726 1.40013 9.30601 1.46051 9.51924 1.62927 9.6135 3.12466 10.4488 5.33063 10.85 7.49996 10.85z"
+					fill="currentColor"
+					fill-rule="evenodd"></path></svg
+			>
diff --git a/myst.yml b/myst.yml
@@ -2,7 +2,10 @@
 version: 1
 project:
   id: 8dfa6ad9-eebf-4b3c-9aaa-1b6a05876590
-  # title:
+  title: CDP Mapping Systems
+  description: |
+    This is the course repository for the CDP Mapping Systems course.
+    It contains assignments, tutorials, and a syllabus.
   # description:
   # keywords: []
   # authors: []
@@ -11,29 +14,32 @@ project:
   toc:
     # Auto-generated by `myst init --write-toc`
     - file: README.md
-    - title: Assignment Descriptions
-      children:
-        - file: Assignment_Descriptions/01_Loading_Visualizing.md
-        - file: Assignment_Descriptions/02_Geoprocessing.md
-        - file: Assignment_Descriptions/03_Networks.md
-    - title: Assignments
-      children:
-        - file: Assignments/readme.md
-        - file: Assignments/01_EXPLORATION.ipynb
     - title: Syllabus
       children:
         - file: Syllabus/syllabus.md
+    - title: Assignments
+      children:
+        - file: Assignments/01_Loading_Visualizing.md
+        - file: Assignments/02_Geoprocessing.md
+        - file: Assignments/03_Networks.md
+        - file: Assignments/04_Web_Mapping.md    
     - title: Tutorials
       children:
         - file: Tutorials/00_Getting_Started.md
+        - file: Tutorials/00_Python_Basics.ipynb
         - file: Tutorials/01_Clustering.ipynb
         - file: Tutorials/01_vector_data_apis.ipynb
         - file: Tutorials/02_geoprocessing.ipynb
         - file: Tutorials/03_networks.ipynb
         - file: Tutorials/04_change.ipynb
     
 site:
-  template: book-theme
-  # options:
-  #   favicon: favicon.ico
-  #   logo: site_logo.png
+  template: book-theme 
+  options:
+    favicon: favicon.ico
+    navbar_title: CDP Mapping Systems  # <- This controls the top-left title
+    footer: "© 2025 CDP Mapping Systems"  # <- This replaces the MyST footer text
+  nav:
+    - title: CDP Mapping Systems
+      url: https://mapping-systems.github.io/cdp-mapping-systems/
+    # logo: site_logo.png
diff --git a/requirements.txt b/requirements.txt
@@ -1,8 +1,11 @@
 affine==2.4.0
 annotated-types==0.7.0
+anyio==4.9.0
 anywidget==0.9.18
 appdirs==1.4.4
 appnope==0.1.4
+argon2-cffi==25.1.0
+argon2-cffi-bindings==21.2.0
 arro3-compute==0.5.1
 arro3-core==0.5.1
 arro3-io==0.5.1
@@ -11,9 +14,12 @@ astor==0.8.1
 asttokens==3.0.0
 attrs==25.3.0
 backoff==2.2.1
+beautifulsoup4==4.13.4
+bleach==6.2.0
 branca==0.8.1
 cachetools==6.0.0
 certifi==2025.4.26
+cffi==1.17.1
 charset-normalizer==3.4.2
 click==8.2.1
 click-plugins==1.1.1
@@ -24,25 +30,39 @@ cycler==0.12.1
 dateutils==0.6.12
 debugpy==1.8.14
 decorator==5.2.1
+defusedxml==0.7.1
 duckdb==1.3.0
 executing==2.2.0
+fastjsonschema==2.21.1
 folium==0.19.7
 fonttools==4.58.1
+fqdn==1.5.1
 geopandas==1.1.0
 greenlet==3.2.3
 gw_dsl_parser==0.1.49.1
 idna==3.10
 importlib_resources==6.5.2
 ipykernel==6.29.5
 ipylab==1.0.0
+ipyleaflet==0.20.0
 ipython==9.3.0
 ipython_pygments_lexers==1.1.1
 ipywidgets==8.1.7
+isoduration==20.11.0
 jedi==0.19.2
 Jinja2==3.1.6
 joblib==1.5.1
+jsonpointer==3.0.0
+jsonschema==4.24.0
+jsonschema-specifications==2025.4.1
+jupyter-book==2.0.0a3
+jupyter-events==0.12.0
+jupyter-leaflet==0.20.0
 jupyter_client==8.6.3
 jupyter_core==5.8.1
+jupyter_server==2.16.0
+jupyter_server_terminals==0.5.3
+jupyterlab_pygments==0.3.0
 jupyterlab_widgets==3.0.15
 kanaries_track==0.0.5
 kiwisolver==1.4.8
@@ -51,23 +71,32 @@ mapclassify==2.9.0
 MarkupSafe==3.0.2
 matplotlib==3.10.3
 matplotlib-inline==0.1.7
+mistune==3.1.3
 monotonic==1.6
+nbclient==0.10.2
+nbconvert==7.16.6
+nbformat==5.10.4
 nest-asyncio==1.6.0
 networkx==3.5
+nodeenv==1.9.1
 numpy==2.2.6
+overrides==7.7.0
 packaging==25.0
 palettable==3.3.3
 pandas==2.2.3
+pandocfilters==1.5.1
 parso==0.8.4
 pexpect==4.9.0
 pillow==11.2.1
 platformdirs==4.3.8
+prometheus_client==0.22.1
 prompt_toolkit==3.0.51
 psutil==7.0.0
 psygnal==0.13.0
 ptyprocess==0.7.0
 pure_eval==0.2.3
 pyarrow==20.0.0
+pycparser==2.22
 pydantic==2.11.5
 pydantic_core==2.33.2
 pydeck==0.9.1
@@ -77,31 +106,47 @@ pyogrio==0.11.0
 pyparsing==3.2.3
 pyproj==3.7.1
 python-dateutil==2.9.0.post0
+python-json-logger==3.3.0
 pytz==2025.2
+PyYAML==6.0.2
 pyzmq==26.4.0
 quickjs==1.19.4
 rasterio==1.4.3
+referencing==0.36.2
 requests==2.32.4
+rfc3339-validator==0.1.4
+rfc3986-validator==0.1.1
+rpds-py==0.25.1
 ruff==0.11.12
 scikit-learn==1.6.1
 scipy==1.15.3
 segment-analytics-python==2.2.3
+Send2Trash==1.8.3
 setuptools==78.1.1
 shapely==2.1.1
 six==1.17.0
+sniffio==1.3.1
+soupsieve==2.7
 SQLAlchemy==2.0.41
 sqlglot==26.26.0
 stack-data==0.6.3
+terminado==0.18.1
 threadpoolctl==3.6.0
+tinycss2==1.4.0
 tornado==6.5.1
 traitlets==5.14.3
+traittypes==0.2.1
 types-python-dateutil==2.9.0.20250516
 typing-inspection==0.4.1
 typing_extensions==4.13.2
 tzdata==2025.2
+uri-template==1.3.0
 urllib3==2.4.0
 wasmtime==33.0.0
 wcwidth==0.2.13
+webcolors==24.11.1
+webencodings==0.5.1
+websocket-client==1.8.0
 wheel==0.45.1
 widgetsnbextension==4.0.14
 xyzservices==2025.4.0

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Loading and visualizing data`
	`1`	`+# 01. Loading and visualizing data`
`2`	`2`
`3`	`3`	`Load and visualize a dataset of interest, either from [NYC Open Data](https://opendata.cityofnewyork.us/) or elsewhere. (If you already have an idea of what your final colloquium project topic will be, this would be a good opportunity to get a head start on that).`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Geoprocessing`
	`1`	`+# 02. Geoprocessing`
`2`	`2`
`3`	`3`	Create a dataset that expresses a narrative from part of your daily life, either now or in the past. This can be based on a mental map of your experience in New York / another city, based on geolocated map tracks (i.e. Google Maps history), or some other source. Based on the data type (point, line, polygon), consider how it would or could relate to other datasets that lend themselves to describing your mental image of the city- subway routes, the location of open space, your favorite coffee cart, etc. We will spend time in the next class relating these kinds of datasets together.
`4`	`4`	`- Use https://geojson.io/, https://play.placemark.io/, QGIS, or another software to create your dataset`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Networks`
	`1`	`+# 03. Networks`
`2`	`2`
`3`	`3`	`Define a network, and calculate the distance between different elements of it. Discuss the experiential differences between Euclidean and network distance for the objects in question. Bonus points (in the form of kudos) for quantitative exploration of the network as described in Xin et al. (2022).`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -11,4 +11,4 @@ Repository for CDP Mapping Systems summer 2025 course`
`11`	`11`
`12`	`12`	`## Getting started`
`13`	`13`
`14`		`-Visit the [Getting Started](Tutorials/00_Getting_Started.md) tutorial notebook to set up your programming environment and get started with the course.`
	`14`	`+Visit the [01. Setting up your environment](Tutorials/00_Getting_Started.md) tutorial notebook to set up your programming environment and get started with the course.`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Getting started`
	`1`	`+# 01. Setting up your environment`
`2`	`2`
`3`	`3`	`1. Install [VSCode](https://code.visualstudio.com/)`
`4`	`4`	`2. Create a new Python environment. I strongly recommend using [Conda](https://conda.io/projects/conda/en/latest/user-guide/install/index.html) for this, but you can also use virtualenv. This will protect our system Python installation from any changes we make.`