Using Jupyter notebooks

The main way of using the Jupyter Notebooks is through interactive app on the OpenOndemand portals.

You can create customized environments based on examples in /apps/portal/jupyter/ directory. Createing the directory ~/portal/jupyter/ and placing your customized environments there they will show up in the portal.

Extensions

jupyterlmod

jupyter-lmod is a Jupyter interactive notebook server extension that allows user to interact with environment modules (Lmod or Tmod) before launching kernels. This extension has been built as a module. Users can use it with the JupyterLab built in the same module tree.

For example, to use jupyterlmod/4.0.3-GCCcore-12.3.0, you can have your own portal runtime script having contents like:

module purge

module load jupyterlmod/5.2.1-GCCcore-13.2.0
module load JupyterLab/4.2.0-GCCcore-13.2.0

# You can launch jupyter notebook or lab, but you must specify the config file as below:
jupyter lab --config="${CONFIG_FILE}"

Once you launch this runtime from OnDemand portal, you can see a software button appearing in the sidebar (demonstration). You can dynamically load/unload module by clicking buttons there. However, the change is not applied immediately. Once you load/unload a module, you have to shutdown kernels and launch the kernel again to update the change.