@@ -7,7 +7,7 @@ title: "Module 1: Collaborating in JupyterHub"
77
88* Jupyter is much more than Notebooks
99* Interact with geospatial data in JupyterLab
10- * Interact with GitHub
10+ * Save our work to GitHub
1111:::
1212
1313
@@ -22,7 +22,22 @@ title: "Module 1: Collaborating in JupyterHub"
2222
2323## 💪 Exercise
2424
25- ### Step 0: Create and clone a new repository for this workshop's exercises
25+ ### Step 0: Log in to the JupyterHub
26+
27+ 1 . Visit < https://hub.cryointhecloud.com > .
28+ You may want to bookmark this page!
29+ 1 . ** Select the last option, "Bring your own image"** .
30+ * Copy/paste ` ghcr.io/geojupyter/geojupyter:latest ` into the "custom image" field.
31+ * Leave "Resource Allocation" as default (1.9GB RAM).
32+ 1 . ** Click "Start"** !
33+ * It may take a moment for the server to start.
34+ When it's done, ** place a green sticky on the corner of your laptop screen** so
35+ instructors know you're ready!
36+ * If startup takes longer than a couple of minutes, put up a red sticky and we'll
37+ take a look!
38+
39+
40+ ### Step 1: Create and clone a new repository for this workshop's exercises
2641
27421 . Create a new repository in GitHub from our
2843 [ workshop template repository] ( https://github.com/geojupyter/workshop-csdms2025-template ) .
@@ -32,11 +47,11 @@ title: "Module 1: Collaborating in JupyterHub"
3247 repository".
3348 :::
3449
35- 1 . Leave all the settings as default: your username should be the "owner", and the repo
36- should be public. Set the "Repository name" to ` workshop-csdms2025-exercises ` -- this
37- will make it easier for us to find it!
50+ 1 . Leave most of the settings as default: your username should be the "owner", and the
51+ repo should be public. ** Set the "Repository name" to
52+ ` workshop-csdms2025-exercises ` ** -- this will make it easier for us to find it!
3853
39- 1 . In JupyterHub, clone the new repository you just created from the template.
54+ 1 . ** In JupyterHub** , clone the new repository you just created from the template.
4055 We'll be working here from now on! ** Run the command below, replacing ` MY-USERNAME `
4156 with your GitHub account username** .
4257
@@ -45,7 +60,30 @@ title: "Module 1: Collaborating in JupyterHub"
4560 ```
4661
4762
48- # ## Step 1: Set up GitHub authentication in JupyterHub (WIP)
63+ # ## Step 2: Explore the example data
64+
65+ 1. Navigate to the newly cloned repository in the JupyterLab file browser on the left
66+ panel.
67+ If the left panel isn' t open, click the topmost icon in the far left column.
68+ 1. Navigate to the `exercises/module-1` directory.
69+ 1. Double-click the GeoJSON file `seec.json` to view it with the JupyterLab viewer.
70+
71+
72+ ### Step 3: Open our example Notebook and create some new data (WIP)
73+
74+ 1. Open `example-1.ipynb` by double-clicking it in the file browser in the left panel.
75+ 1. This notebook is pre-populated with some code.
76+ **Run all the cells** by pressing `SHIFT+ENTER` repeatedly until you reach the end.
77+ 1. Add a new cell which adds more data into the GeoDataFrame (_TODO_: Prompt and empty
78+ space in notebook).
79+ Start with the address of a location that is meaningful to you:
80+ Your favorite coffee shop?
81+ The shelter where you adopted your pet?
82+ The town where you grew up?
83+ 1. Add another new cell which saves the GeoDataFrame with a new filename.
84+
85+
86+ ### Step 4: Set up GitHub authentication in JupyterHub (WIP)
4987
5088In order to push changes from the JupyterHub, you need credentials.
5189Since the JupyterHub is a shared cloud service, saving credentials there can be
@@ -61,27 +99,7 @@ This configuration is valid for 8 hours.
6199If you need to refresh your access, please re-do the final step in the list above.
62100
63101
64- # ## Step 2: Explore the example data (WIP)
65-
66- 1. Navigate to the newly cloned repository in the JupyterLab file browser.
67- 1. Enter the ` exercises/module-1` directory.
68- 1. Double-click the GeoJSON file to view it with the JupyterLab viewer.
69-
70-
71- # ## Step 3: Open our example Notebook and create some new data (WIP)
72-
73- This Notebook is pre-populated with some code.
74-
75- 1. Run all the cells (_TODO: Details_).
76- 1. Add a new cell which adds more data into the GeoDataFrame.
77- Start with the address of a location that is meaningful to you:
78- Your favorite coffee shop?
79- The shelter where you adopted your pet?
80- The town where you grew up?
81- 1. Add another new cell which saves the GeoDataFrame with a new filename.
82-
83-
84- # ## Step 4: Push to GitHub (WIP)
102+ ### Step 5: Push to GitHub (WIP)
85103
861041. `git add .`
871051. `git commit --message="Add new data to GeoJSON"`
0 commit comments