Datalore 2025.1 Help

Learn editor basics

Refer to the topics in this section to learn the basic features of the Datalore editor.

Explore Datalore editor at first glance

On the Home page, click one of your notebooks to open it in the editor. It will look similar to the image below.

Editor page

The editor interface consists of the following components:

Interface element

Description

Coding area

Area of the editor where you work on the content and structure of your notebook.

Main menu

Main menu

Menu in the upper right part of the editor that provides the following options:

  • File: to manage the notebook as a file or create a new one

  • Tools: to view and manage the notebook's attachments, history checkpoints, libraries, and variables

  • Kernel: to select a kernel and a machine (if available), and manage the selected kernel

  • View: to customize the look and the layout of the editor

  • Code: to refine selected code

  • Run: to manage computations and running options

  • Help: to access the shortcuts, command palette, and documentation

Notebook title

Used to rename the notebook (click the title) or mark it as favorite (click the bookmark icon).

Editor sidebar

Editor sidebar

Left-hand sidebar that provides the following options:

  • Notebooks: to quickly access other notebooks, search option available

  • Attached files: to manage attachments to the notebook and the associated workspace files

  • Environment: to view and manage packages

  • Computation tab: to manage kernels, machines, and notebook runs

  • Table of contents: to view the notebook sections and go directly to a specific one

  • Variable viewer: to manage the variables associated with this notebook

Share

Used to share the notebook.

Build report

Used to publish the notebook as a report.

Contact us

Used to contact the Datalore team.

Account settings

Used to manage account settings, running computations, and subscriptions.

Status panel

Status panel

Panel in the lower right corner of the editor that reports such current notebook status details as:

  • Kernel status

  • Computation resources use

  • Number of calculated cells

  • Cell in calculation process (clickable to locate in the code)

  • Number of errors (clickable to view details)

  • Machine information

  • Background computation information (if enabled)

  • Selected programming language

Manage

Used to change the editor settings.

In Datalore, a notebook is a sequence of cells in a linear order presented on one or several worksheets.

Cells

A cell is a basic structural unit of a notebook, created for a specific purpose and edited by specific rules. You can use the following types of cells in Datalore notebooks:

  • Code cells are used for coding in the programming language selected for the notebook.

  • Markdown cells are used to provide explanatory or descriptive texts to your code.

  • Interactive control cells are used to enable interactivity in your notebook, which allows customizing the output without manually changing the code. These cells are a crucial part of creating interactive reports.

  • Chart cells are used to build advanced charts based on DataFrames without manually writing the required code.

  • SQL cells are used to query attached databases and other data sources.

  • Metric cells are used to track numerical values in your code and compare them to others.

  • Export to database cells are used to append DataFrames to attached database tables.

When you create a notebook and open it in the Datalore editor, it is one empty code cell. This is where you start your work on the notebook. As you complete this cell, you will add and edit the next one, and so on.

This is how a Python code cell looks with its output displayed:

Code cell

A Markdown cell with its output looks like this:

Markdown cell

Worksheets

By default, every notebook is presented on one worksheet. This means you can see all your work on one scrollable page. If your notebook is big enough and has a large amount of data, you may want to organize its content into multiple worksheets. To create a new worksheet, click the + icon in the lower left corner of the editor.

All worksheets in a notebook share the same files, and newly created worksheets inherit the environment of those created earlier. For example, the notebook shown below consists of three worksheets: Code editor, Data analysis flow, and Team collaboration.

Notebook worksheets

Add and manage worksheets

  1. To create a worksheet, click the + icon in the lower left corner of the editor.

  2. For further options, right-click the worksheet you want to manage. This will open a popup menu.

    Worksheet menu
  3. Use the popup menu for the following options:

    • Rename worksheet: select the option, provide a new name in the Rename dialog, and click OK.

    • Duplicate worksheet: select the option to add a worksheet with the same content to the notebook.

    • Delete worksheet: select the option to delete the worksheet from the notebook. Click OK in the Confirmation dialog to confirm the action.

Last modified: 09 January 2025