Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

1 - Getting Started

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.

  1. Enter a username that is unique from other participants.

  2. Use the workshop password shared by the instructors in the chat.

  3. Start your JupyterHub server.

  4. 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 --version

Each command should print a version number.

What are these tools?
ToolRole in the workshop
FetchezOrchestrate the workflow and discover and stream source data
TransformezSupport horizontal and vertical reference transformations
GlobatoProvide elevation-specific tools for building the DEM
IVERTEvaluate 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.sh

When setup finishes, check the workspace:

ls ~/workshop

You should see:

ivert
newport_data
newport_dem
reference_outputs
sarasota_data
sarasota_dem

During the workshop, use ~/workshop for the prepared data, DEM outputs, and reference outputs.

What is in each directory?
DirectoryPurpose
~/workshop/newport_dataPrepared Newport source-data cache
~/workshop/sarasota_dataPrepared Sarasota source-data cache
~/workshop/ivertPrepared IVERT data used later for DEM evaluation
~/workshop/reference_outputsKnown-good Newport and Sarasota outputs available as workshop fallbacks
~/workshop/newport_demYour Newport DEM outputs
~/workshop/sarasota_demYour 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.sh

Download 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.