Skip to main content
Skip table of contents

How to Develop a Simple Interactive Add-on Tool using Seeq Data Lab

Overview

Seeq Data Lab uses Jupyter to write code and develop scripts. Jupyter is a web-based interactive computing platform that allows for the creation of documents that contain live code, equations, visualizations, and narrative text. These documents are called notebooks and are ideal for prototyping, data analysis, teaching, and more. Voila is the library that Seeq Data Lab uses that allows you to turn your Jupyter notebooks into an Add-on, making it easy to share your work with others.

In this document, we will show you how to develop a simple Add-on Tool that interacts with a Seeq Workbench. This Add-on Tool utilizes a Jupyter notebook, along with ipywidgets and ipyvuetify libraries, and it operates in Add-on Mode. All the packages used (ipywidgets and ipyvuetify) come preinstalled with Seeq Data Lab. More information on how to install packages can be found here — Seeq Data Lab | Installing-Python-Modules

Steps

  1. Create a Data Lab Project and Jupyter notebook

  2. Write the code for your Add-on Tool

  3. Launch your Notebook as an Add-on using Add-on Mode

1. Create a Data Lab Project and Jupyter Notebook

To create a Jupyter notebook, follow these steps:

  1. Open a new Data Lab Project.

  2. Select "New".

  3. Select "Notebook".

  4. Choose a programming language for your notebook (e.g. Python). If you are interested in using R please check out this article on how to add the R kernel to Seeq Data Lab - Enabling R Language Support in Data Lab

2. Write the Code for Your Add-on

In your Jupyter notebook, write the code for your Add-on using Python. For this example, we will create a simple Add-on Tool that retrieves the signals from a worksheet, allows the user to perform a couple basic arithmetic operations, and push the new signal back to the worksheet. The operations are broken up into multiple sections.

  • Import the packages

  • Define the widgets (This example uses ipyvuetify, but ipywidgets is a good alternative)

  • Perform some actions with the inputs

  • Output the results

The example notebook can be downloaded here:

Add-on with SPy interaction with workbench.ipynb

3. Launch Your Jupyter Notebook as an Add-on

To launch your Jupyter notebook as an Add-on, follow these steps:

  1. In Data Lab (Notebook or Advanced Mode), click the "Add-on Mode" button in the upper-right corner of the interface.

  2. Voila will convert your Jupyter notebook to a standalone web application.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.