A First Superscan Tutorial

First, you'll need an account on the physics Linux cluster. You'll need to be a member of the neutrino group.


Superscan is an event display program that allows visual display of Super-K events. It's not the only existing SK event display, but it's one of the nicest-looking and easiest-to-use ones. Event display programs are sometimes called "scanners" and looking at events with them is often referred to as "scanning".


Put the following in your .tcshrc file (you will need to change to tcsh if you do not have it; on the Physics machines this can be done using ypchsh):

setenv PROJECT /var/phy/project/hep/neutrino
source $PROJECT/soft-SL6/SK-Duke.login
What this does is to set up various SK-related Unix environment variables for you.

Data Files

Super-K data files that can be read by superscan are in a format known as "ZBS". File extensions for ZBS files are often ".zbs" or sometimes ".dat" (but can be anything). ZBS makes use of a godawful (yet still quite prevalent) Fortran-based data structure management package called Zebra. Information is stored in "banks"; superscan knows how to read various different kinds of banks.

A few example data files can be found in

The ones to look at for this tutorial are

Running Superscan

Next, you'll want to run superscan. The superscan executable is
Type this on the command line to start it. You can select a data file to look at by either using the pull-down menu and typing in the filename, or by specifying the filename on the command line, e.g.
$SKOFL_ROOT/examples/superscan/superscan -f yummy_events.zbs

Stuff to Try