Knowledge Base

Invoke scripts for Jupyter notebooks

The Hubzero tool invoke script is located in the tool's middleware/ subdirectory. When you first create a tool, the basic invoke script provided must be edited to work with Jupyter notebook tools.

This writeup shows you how to create Jupyter tools with three different appearances: notebook, App, and Tool mode.

invoke_app and start_jupyter

To deploy a Jupyter notebook as a tool on Hubzero gateways, you call the invoke_app executable, which in turn calls start_jupyter. Each have their own arguments:

arguments for start_jupyter
    -d show debug (verbose) output
    -t run as a Tool with no notebook controls
    -A run in AppMode.    

arguments for invoke_app
    -C command to execute
    -r Rappture version to use (normally specify none for notebook tools)
    -u environment package(s) to use
    -t Tool name

invoke_app: starting point

The basic invoke script for Jupyter notebooks looks like this:

/usr/bin/invoke_app "$@" -t TOOLNAME 
    -C "start_jupyter -T @tool APP.ipynb" 
    -r none 
    -u anaconda-6    

Invoking a Jupyter tool this way gives a notebook with all its code cells displayed to the user.    


  •     TOOLNAME is the short name of the tool
  •     APP is the name of the main notebook that runs the tool
  •     anaconda-6 is the current anaconda installation

Notice that the script uses the -t, -C, -r, and -u invoke_app arguments.

start_jupyter arguments

Control the way the notebook appears when run as a tool, using the arguments passed to the start_jupyter executable.

You can run a Jupyter tool in three ways:

  •  notebook mode, in which all code cells are displayed to the user (shown above)
  •  app mode, in which code cells are initially hidden but can be displayed
  •  tool mode, in which code cells are hidden and cannnot be displayed

for App Mode

For a notebook tool that hides its code cells and shows only the UI and markdown elements on initial run, add the -A argument in the start_jupyter call:

/usr/bin/invoke_app "$@" -t TOOLNAME 
    -C "start_jupyter -A -T @tool APP.ipynb" 
    -u anaconda-6 
    -r none

The tool user can toggle the tool's "Edit App" button to show the underlying code cells, making this a great teaching/demo option.         
NOTE that this differs from the invoke_app -A argument for invoke_app.

for Tool Mode

To permanently hide code cells from the user in App Mode, specify the -A and -t arguments in the start_jupyter call:

/usr/bin/invoke_app "$@" -t TOOLNAME 
    -C "start_jupyter -A -t -T @tool APP.ipynb" 
    -u anaconda-6 
    -r none    

The Edit App button will not be displayed to the tool user.     
NOTE that this differs from the invoke_app -t argument for invoke_app.


specify no rappture

/usr/bin/invoke_app "$@" -t TOOLNAME 
    -C "start_jupyter -T @tool APP.ipynb" 
    -u anaconda-6 
    -r none

Running the tool's invoke script from the deb10 workspace, returns:

"could not find a rappture installation: RAPPTURE_PATH=,"

Be sure to supply the "-r none" argument in the invoke_app call, as above. No quotation marks are needed.


0 Dislike

Last updated

Comments on this entry

There are no comments on this entry.

Post a comment

Post a comment

Please keep comments relevant to this entry. Comments deemed offensive or inappropriate may be removed.