Skip to content

JupyterHub

Access Jupyter notebooks through the web interface for interactive Python analysis.

Access URL

https://jupyter.sdcc.bnl.gov/

Features

  • Web-based interface - No local software installation required
  • Multiple kernels - Python and custom environments
  • Persistent sessions - Work is automatically saved
  • File management - Upload, download, and organize notebooks

Setting Up Belle II (Basf2) Kernel

Temporary Workaround

We're working to make Basf2 available by default. This is a temporary setup process.

1. Create Kernel Directory

mkdir -p ~/.local/share/jupyter/kernels/belle2_light-2503-ceres/

2. Create Kernel Configuration

Create a file kernel.json in the directory above:

{
    "display_name": "Belle2 (light-2503-ceres)",
    "language": "python",
    "argv": [
        "/cvmfs/belle.cern.ch/tools/b2execute",
        "-x",
        "python3",
        "light-2503-ceres",
        "-m",
        "ipykernel_launcher",
        "-f",
        "{connection_file}"
    ]
}

3. Verify Installation

After setup, the kernel Belle2 (light-2503-ceres) will appear in the kernel selection dropdown at jupyter.sdcc.bnl.gov.

Storage Access

From Jupyter notebooks, you can access:

  • Home directory: Default working location
  • Scratch space: /gpfs/mnt/atlasgpfs01/belle2/users/USERNAME

But you can NOT access:

  • dCache storage: /pnfs/sdcc.bnl.gov/users/USERNAME

It requires special handling to access dCache files (in preparation).