Getting StartedΒΆ
Welcome to the NOAA NCEI/CIRES Coastal DEM Workshop.
In this module, we will get everyone into JupyterLab, confirm that the workshop tools are ready, and set up the workspace we will use for the exercises.
Goal: Get connected, open a terminal, confirm the tools, and prepare workshop data.
1. Open the workshop JupyterHubΒΆ
Open the Coastal Coupling Workshop JupyterHub.
Enter a username that is unique from other participants.
Use the workshop password shared by the instructors in the chat.
Start your JupyterHub server.
Wait for JupyterLab to open.
For more detail on signing in and starting your server, see Starting your server.
2. Open a terminalΒΆ
In JupyterLab:
Under Other, click Terminal.
You should now see a command prompt.
3. Confirm the workshop toolsΒΆ
The workshop environment already includes the four main tools we will use.
Run:
fetchez --version
transformez --version
globato --version
ivert --versionEach command should print a version number.
What are these tools?
| Tool | Role in the workshop |
|---|---|
| Fetchez | Orchestrate the workflow and discover and stream source data |
| Transformez | Support horizontal and vertical reference transformations |
| Globato | Provide elevation-specific tools for building the DEM |
| IVERT | Evaluate the DEM with independent observations |
We will see how these tools work together as we build and evaluate the DEMs.
If a command is not found
Do not try to fix the environment with pip install.
Let an instructor know which command failed in the chat.
4. Set up your workshop workspaceΒΆ
The workshop datasets have already been prepared so we can spend our time building and exploring DEMs rather than waiting for large downloads.
Run:
bash ~/shared/setup_workshop.shWhen setup finishes, check the workspace:
ls ~/workshopYou should see:
ivert
newport_data
newport_dem
reference_outputs
sarasota_data
sarasota_demDuring the workshop, use ~/workshop for the prepared data, DEM outputs, and reference outputs.
What is in each directory?
| Directory | Purpose |
|---|---|
~/workshop/newport_data | Prepared Newport source-data cache |
~/workshop/sarasota_data | Prepared Sarasota source-data cache |
~/workshop/ivert | Prepared IVERT data used later for DEM evaluation |
~/workshop/reference_outputs | Known-good Newport and Sarasota outputs available as workshop fallbacks |
~/workshop/newport_dem | Your Newport DEM outputs |
~/workshop/sarasota_dem | Your Sarasota DEM outputs |
About temporary workshop storage
~/workshop points to /tmp/workshop, which is temporary storage attached to your JupyterHub server.
If your server is stopped and recreated, rerun:
bash ~/shared/setup_workshop.shDownload or copy any DEM results you want to keep before ending your workshop server.
Quick troubleshooting
My JupyterHub server is still starting
If it does not open after several minutes, let an instructor know in the chat.
I cannot find Terminal
Open the JupyterLab Launcher with the + button and look under Other.
One of the version commands fails
Do not install or update the package yourself during the workshop.
The workshop setup script fails
Do not manually move or rebuild the workshop data directories unless an instructor asks you to. Show the error in the chat.
I am not sure which directory I am in
See the Linux Terminal Quick Reference.