Next Page

X-Windows SNO Event Display (XSNOED) User Guide


Introduction

Version 5.0.2 - Nov. 7, 2012
By Phil Harvey, Queen's University

XSNOED is a graphical display tool used to view live SNO events from the dispatcher, or stored events from ZDAB or ROOT files. It runs under X Windows using the Motif widget set. Currently supported platforms are PC/Linux, Macintosh/OSX, Sun/Solaris (Sparc and x86), Alpha/OSF, HP-UX and VAX/VMS.

If you are running an X-Windows web browser and have it configured to use XSNOED as a helper application, you can click here or on the animated image to the right to run XSNOED and display an event. If this doesn't work for you, look at the section called XSNOED as a Helper Application for Netscape for instructions on configuring your X-Windows Netscape.

Use the Text Index, or the Clickable Window Index to help navigate through this user guide.


Where to Find XSNOED

XSNOED is available for use by any SNO collaboration member, and can be found in the following locations:

Note: XSNOED requires a number of support files to run. These files can be found in any of the above directories, and are included in the source code tar file.


Running XSNOED

Syntax:xsnoed [filename] [resources] [-dnps]

filenameName of ZDAB or ROOT (ROOT_FILE version only) file to be opened, or dispatcher address to be connected when XSNOED is started. ROOT files are recognized by the string "root" in the filename, otherwise a ZDAB file is assumed. If no matching file is found, <filename> is assumed to be a dispatcher address.
resources            Optional resource settings to override settings in the XSnoed resource file. See the section on the XSnoed resource file for more information about available resources.
-d#Sets "Dump Record Info" flag to specified value (#): 0=off, 1=normal, 2=hex dump all but ZDAB records, 3=hex dump all including ZDAB records. The "#" is optional, and defaults to 1 if not specified (ie. "-d" is equivalent to "-d1").
-nDo not load XSnoed settings from settings file.
-pStarts XSNOED in protected mode (DEMO_VERSION only).
-s settings_fileSpecifies name of settings file to use. This allows different people on the same account to have individual XSNOED preferences. If not specified, the default settings file name is "~/.XSnoed".
-R periodRotates the XSNOED display with the specified period. Used for demonstration purposes.


Compiling XSNOED

Before attempting to compile XSNOED, make sure you have a recent version of Motif (or Lesstif) installed on your system. (Linux users can now download the Open Group Motif for free.) Then follow these steps to compile XSNOED:
  1. Make a directory for the xsnoed source code, and copy "xsnoed.tar.gz" into this directory.
  2. Type "gunzip xsnoed.tar.gz" and "tar -xf xsnoed.tar" in the xsnoed directory to extract the source code.
  3. If you do NOT require XSNOED to be able to read live dispatched data go to step 8), otherwise continue with step 4).
  4. [Compiling for dispatcher] -- Copy the file "disp.tar.gz" (available from surf:/usr/local/ph) into the parent directory of the xsnoed source code.
  5. Type "gunzip disp.tar.gz" and "tar -xf disp.tar" to extract the dispatcher libraries. This will create a directory called "disp" parallel to the xsnoed source code directory.
  6. In the "disp" directory, change the "lib" soft link to point to the library directory for your specific OS type.
  7. Change back to the xsnoed source code directory, and advance to step 9).
  8. [No dispatcher] -- Edit "Makefile.$OSTYPE_$MACHTYPE" for your specific OS/machine type, and make the following changes:
    a) Add "-DNO_DISPATCH" to the "PROJFLAGS".
    b) Remove "-lconthost" from the "DISPLIBS" definition.
  9. Type "make".
With any luck, you will now be the proud owner of a freshly compiled XSNOED -- type "./xsnoed" to run it.

See the README file included with the XSNOED source code for more information about compiling XSNOED.