🐍Create a notebook-based tool
Convert a Jupyter notebook into a tool that can run from the Ontologic Tools interface. This example uses a simple Python script that plots a line with a given slope, intercept, and title.
Last updated
Convert a Jupyter notebook into a tool that can run from the Ontologic Tools interface. This example uses a simple Python script that plots a line with a given slope, intercept, and title.
Last updated
From the Tools page, click the "+ New Tool" button with a Conda environment.
On the "Develop" tab, click "Launch IDE" to start up the environment, and click "Open" to open VSCode in a new tab.
In VSCode, create a notebook by making a new file that ends in .ipynb
.
Add a code cell and paste the following. These variables will be used in a later step to allow for user input.
Run the cell, let VSCode install Jupyter and Python extensions.
Once the extensions are installed, hover over the cell to the "..." icon.
Add a cell tag called parameters
to this cell.
In a new cell, paste the following:
Now try running these cells. It should complain about numpy not being installed. Open a terminal (shortcut: ctrl
+`
) and run:
Once these are done installing, the notebook should run with no errors.
From the Tool Details tab, click the "Stop" button to shut down the IDE. Wait for it to complete. The shutdown step takes about 90 seconds.
In the Script & Parameters section, paste the following:
Replace all the capitalized parameters with parameters in the GUI by highlighting and right-clicking to show the "+ Replace with Parameter" button.
Make sure to specify the correct data type for each variable. Parameters that can receive user input will be highlighted purple.
Save these changes so that the script can be run from the Tools page with user input.
Go back to the tools page and click "Run" on the new tool.
Configure the parameters as desired and start the run by clicking the "Run Tool" button. It should complete successfully in about 30 seconds.
The tool will generate a result titled result.html
. From the Output tab, you can preview and download and the file created by your notebook.
Congratulations! Your notebook is now able to be run as a tool that accepts user input, and users do not have to interact with code in order to run your analyses.
If you don't see console error messages under the cell, or if the plot renders badly, open the VSCode command palette with ctrl
+ shift
+ p
and type "Reload window" to reset VSCode.
All tools need to specify outputs into a folder called outputs
, and a run will fail if nothing is specified. Use the following example for a simple output in bash, where {{yourInput}}
is a user-definable parameter: