NOTE: The jupyterhub web interface by default will only allow you to navigate to subdirectories of your home directory (see https://github.com/jupyter/notebook/issues/2032 for the reasoning behind this decision). If you want to navigate to another directory that is not underneath your home directory, run a script like this in your home directory to make a softlink that you can click on in the jupyterhub web interface:
Code Block
import os
os.symlink("/reg/d/psdm/xpp/xpptut15","xpptut15")
Available Kernels
When logging into JupyterHub a number of possible kernels are shown:
LCLS-I psana analysis kernels (both py2 and py3)
LCLS-II psana analysis kernel (py3 only)
A kernel for analyzing HDF5 files (py3 only) which should change at a slower rate than psana kernels (which must change to support new detectors, for example)
A few different deep-learning kernels
The psana kernels typically point to the latest version. See the next section for how to create a kernel for a particular version of psana.
Creating Your Own Jupyter Kernels
See https://jupyter-client.readthedocs.io/en/latest/kernels.html#kernelspecs. To create your own custom kernel (e.g. to select a particular version of psana) insert a kernel directory in your home directory~/.local/share/jupyter/kernels. You can copy one of the production kernel directories from /reg/g/psdm/sw/conda/jhub_config/prod-rhel7/kernels and modify as you see fit.
511 Error
If you try to start a server and see a "511 error" it is often an indication that your ssh keys are too old (or non-existent). When that happens you need to generate new keys by running this script:
NOTE: The jupyterhub web interface by default will only allow you to navigate to subdirectories of your home directory (see https://github.com/jupyter/notebook/issues/2032 for the reasoning behind this decision). If you want to navigate to another directory that is not underneath your home directory, run a script like this in your home directory to make a softlink that you can click on in the jupyterhub web interface:
import os os.symlink("/reg/d/psdm/xpp/xpptut15","xpptut15")Available Kernels
When logging into JupyterHub a number of possible kernels are shown:
The psana kernels typically point to the latest version. See the next section for how to create a kernel for a particular version of psana.
Creating Your Own Jupyter Kernels
See https://jupyter-client.readthedocs.io/en/latest/kernels.html#kernelspecs. To create your own custom kernel (e.g. to select a particular version of psana) insert a kernel directory in your home directory~/.local/share/jupyter/kernels. You can copy one of the production kernel directories from /reg/g/psdm/sw/conda/jhub_config/prod-rhel7/kernels and modify as you see fit.
511 Error
If you try to start a server and see a "511 error" it is often an indication that your ssh keys are too old (or non-existent). When that happens you need to generate new keys by running this script:
Upgrades