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 pre-configured JupyterLab instance 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 the runtime

1
Log in to Wherobots Cloud.
2
Click Getting Started
Start Notebook
A new window will open. Once your runtime has loaded, your Jupyter Instance will appear in this window.

​
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 the JupyterLab instance 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

Set Up Agentic Tools

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

AI-Assisted Notebook Development

Create Jupyter notebooks with AI assistance and connect them to remote Wherobots compute.

Browse Your Data

Browse catalogs, schemas, and tables in the Data Hub sidebar.

Workspaces & Usage

Create, start, stop, and manage notebook workspaces.