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
Create a Data Lab Project and Jupyter notebook
Write the code for your Add-on Tool
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:
Open a new Data Lab Project.
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
Perform some actions with the inputs
Output the results
The example notebook can be downloaded here:
3. Launch Your Jupyter Notebook as an Add-on
To launch your Jupyter notebook as an Add-on, follow these steps:
In Data Lab (Notebook or Advanced Mode), click the "Add-on Mode" button in the upper-right corner of the interface.
Voila will convert your Jupyter notebook to a standalone web application.