Run your first notebook

Now that you know your way around, let’s get your first notebook on screen.

Creating a notebook

There are 3 ways to create notebooks:

  1. From the Explore gallery.

  2. Via the New Notebook button in the top-right corner of the landing page.

  3. By duplicating an existing notebook. Click the three-dot menu on a notebook card, then select Duplicate.

For this guide, we will create a new notebook from the Explore gallery.

  1. In the top navigation bar, click Explore.

  2. Browse the gallery and click a sample dataset that interests you.

  3. In the details that open, click Open as notebook.

Tip

Hover over a sample dataset to see a quick animated preview.

Open the dataset details and switch to the Explore dataset tab. From there, you can view the individual frames in the dataset.

You will be redirected to the notebook editor, where you can start running and editing the notebook.

Working in the notebook editor

The notebook editor is the main workspace for running and editing notebooks. It is divided into 2 main areas:

  • The viewport - This is the live 3D view of the world. As you run code, what you build appears here.

  • The notebook - This is the code editor for the notebook. This is where your code lives, organized into cells that you can run one at a time.

Attention

Below the notebook, you will find a bottom drawer. This is where you can browse Bifrost assets, environment presets and sensor presets.

If you created your notebook from the Explore gallery, the sample dataset code will already be waiting for you.

Let’s run it and watch the world appear in the viewport.

To run a notebook, you can

  1. Run all cells at once using the Run all cells button at the top-right of the notebook.

  2. Run a single cell at a time by clicking the play button at the left of each cell.

Tip

Try editing a value in one of the cells, then run it again. The viewport will update to match your changes. This is the core loop of building with notebooks on the platform.

That’s it! You’ve gone from opening the platform to running your first notebook.