Skip to main content
Notebook
There are two ways to run a Wherobots notebook. Pick whichever fits how you like to work — both execute on the same Wherobots compute.

Run notebooks in Wherobots Cloud

Start a Notebook Runtime, a pre-configured JupyterLab environment, in your browser. Nothing to install.

Run notebooks in VS Code

Keep notebooks local in VS Code, Cursor, Windsurf, or Kiro and run them against a remote runtime.
Wherobots Cloud offers: No installation, scalable processing, enhanced collaboration, pre-built geospatial tools, cost-effectiveness, and easy S3 data integration.

​
What will you learn?

This notebook offers a hands-on guide to geospatial analysis using Apache Sedona within Wherobots. You’ll learn how to:
  1. Load vector (NYC buildings) and raster (Central Park elevation) data from S3.
  2. Perform SQL-based analyses, like calculating building elevations using zonal statistics.
  3. Visualize your findings with SedonaKepler.

​
Before you start

You will need a Wherobots Organization to follow this tutorial. You can start with a free Professional Edition trial. For more information on setting up your Organization, see Register for a Professional Edition trial.

​
Run the Introducing Wherobots Notebook

Let’s open the Introducing Wherobots Notebook – your initial hands-on guide to Wherobots.

​
Start a Notebook Runtime

1
Log in to Wherobots Cloud. The Code page opens.
2
Under Solution Notebooks, click Getting started.
Solution Notebooks on the Code page
Wherobots Cloud starts a Notebook Runtime right away and opens it in a new browser tab. When the Notebook Runtime is ready, JupyterLab opens in that tab.
Clicking the card starts a Tiny Notebook Runtime in your Organization’s default region, with no dialog. To choose the size and region yourself, see Start a Notebook Runtime. When you’re done, destroy the Notebook Runtime to stop billing.

​
Run the example notebook

1
A new Jupyter Notebook tab will open, displaying Part_1_Loading_Data.ipynb.
If the notebook doesn’t open automatically, use the file browser to find and open /examples/Getting_Started/Part_1_Loading_Data.ipynb.
2
Click (Play) to run each cell indiviudally.
Run the selected cells

​
Run notebooks from VS Code

You aren’t limited to Notebook Runtimes in Wherobots Cloud. With the Wherobots VS Code Extension, you can keep your notebooks on your local machine and run them against remote Wherobots compute — in VS Code and other Code OSS editors, including Cursor, Windsurf, and Kiro.
Organization Availability: Available to all Wherobots Organization Editions (Professional, Innovation, and Enterprise).
The extension includes an Example Notebooks browser, so you can run the same Wherobots Cloud Example Notebook without leaving your editor.

Open the Example Notebooks view

In the Wherobots sidebar, expand Example Notebooks to browse the Wherobots example notebooks.
Wherobots sidebar showing the Example Notebooks browser with the Getting_Started folder expanded

The Example Notebooks browser in the Wherobots sidebar.

Open Part 1 Loading Data

Under Getting Started, click Part 1 Loading Data.

Create a runtime

Click Create a workspace, then click Create & Start to initiate a Wherobots runtime.A pop-up window will appear notifying you once your runtime is ready.
Starting a runtime begins the provisioning process. Once a runtime has been provisioned, a billable event is occurring.
Creating a workspace and starting a Wherobots runtime in VS Code

Create a workspace for a notebook in VS Code.

Select the Wherobots kernel

Click the icon on the left-side of the screen and select either the Python or Scala kernel.
Selecting the Wherobots kernel and running all cells

Selecting the Wherobots kernel source for a local notebook in VS Code.

Run the notebook cells

Click Run All. Cells run on the runtime, and results appear inline in your editor.
If the list is empty, run Wherobots: Refresh Examples from the Command Palette.
For installation and the complete walkthrough, see AI-Assisted Notebook Development.

​
Next steps

Continue the Beginner Learning Path

Read spatial files, speed up large datasets, and run spatial joins in the next three example notebooks.

Connect Your Data

Connect external data sources and browse catalogs in Data Catalogs.

Query Overture Maps Tables

Reference Overture tables correctly, filter on nested fields, and limit results to a country or region.

Set Up Agentic Tools

Install the Wherobots VS Code Extension for VS Code, Cursor, Windsurf, Kiro, and other editors.