Next Page Previous Page First Page

Appendix

Support Files

XSNOED requires a number of files to run. Some of the files are optional, and when present enable certain XSNOED features. A list of the XSNOED support files is given below.
XSnoed Default XSnoed resource file
geodesic.geo PSUP geometry file
polar.geo Polar wire frame geometry
vessel.geo Acrylic vessel geometry file
flat.geo Flat Map geometry file
database.dat Default PMT position database file
NCDTubeMap.dat Default NCD position database file
db_list.dat 1 List of PMT/NCD database files to use based on run number
fitter.dat [optional] Fitter configuration file to override defaults (fitter version only)
<cal_file> 2 [optional] PMT calibration constants to enable calibrated data display (calibrated version only)
<oca_file> 2 [optional] Optical calibration constants to enable calibrated hit display (OCA version only)
ascii_window_menu.dat [optional] Definition for optional menu in ASCII window. See the ASCII Output window section for details.

1 If this file doesn't exist or if a database is not specified for the current run number, then the default PMT or NCD database is used.

2 The names of cal_file and oca_file are obtained from the XSnoed resource file.

XSNOED will generate binary versions of the PMT position database and the PMT calibration constants when they are loaded, and save them to disk with a ".bin" added to the filename if write privileges are available in the directory where these files are kept. These binary files load much more quickly, and will be used (if available) the next time they are needed. Note that these binary files are not portable to different platforms, and therefore are not provided as part of the standard XSNOED release.

XSNOED searches the following directories in order when looking for the support files:

  1. The current directory.
  2. The directory of the XSNOED executable.
  3. The directories specified by file_path in the XSnoed resource file. The file_path resource string may contain the names of multiple directories separated by colons.
  4. Directories specified by the PATH environment variable.


X Window Notes

On some systems, the backspace key will delete characters to the right of the cursor. To change this to delete characters to the left of the cursor, enter the following command or put it in the .xinitrc file before starting your X session: xmodmap -e "keysym Delete = BackSpace".


XSNOED as a Helper Application for Netscape

The X-Windows version of Netscape can be configured to use XSNOED as a helper application to display ZDAB files used in html links. Follow these steps to configure XSNOED as a helper application in Netscape:
  1. Select Edit/Preferences from the Netscape menu.
  2. Select Navigator/Applications from the Category list.
  3. Click the New... button to add a new helper application.
  4. Set the Description to "ZDAB File".
  5. Set the MIME Type to "www/unknown" (see note below).
  6. Set the Suffixes to "zdab".
  7. Select Handled By Application.
  8. Enter the command line "xsnoed %s -n > /dev/null".
  9. Click on OK.

Note: The SNO manhattan web server sets the MIME type of ZDAB files to "www/unknown". Other web servers may have different defaults, so the MIME type in step 5 above may be different. If the web server can be configured, the preferred MIME type for ZDAB files would be "application/xsnoed". To determine the MIME type for a page loaded by Netscape, select "View/Page Info" from the Netscape menus.


XSNOED Versions

XSNOED can be compiled with various features enabled or disabled. Information about the specific version you are running is printed to the console when XSNOED is run. The version is defined with the XSNOED_OPTIONS environment variable when compiling xsnoed.
(ie. setenv XSNOED_OPTIONS "-UFITTR -DSNOPLUS")
LOAD_CALIBRATION Enables calibrated data display. This version reads a calibration data file to obtain charge/time calibrations for each cell. This version requires a calibration database file to display calibrated values (name determined by the resource variable 'cal_file').
FITTR Online fitter enabled (calibrated display also enabled). This version requires a fitter configuration file (fitter.dat) for initialization of fitter constants.
USE_PTHREAD Does all dispatcher calls from a separate program thread. This version is useful to improve the GUI response when connecting to a dispatcher through a slow connection. Do not use this version if a fast dispatcher connection is available, because the dispatcher performance will be somewhat degraded.
ROOT_FILE Enables the ability to read ROOT files. To run this version, the ROOT libraries must exist and be set in the LD_LIBRARY_PATH.
OPTICAL_CAL Enables optical calibration option. With this option enabled, the calibrated Hit Count display shows hits relative to calculated occupancy. This version requires database of optical calibration constants (name determined by the resource variable 'oca_file').
NO_DISPATCH No dispatcher connection capabilities. This version is provided to allow compilation on systems where the dispatcher libraries are not available.
DEMO_VERSION Demo version of XSNOED. This version is fully functional, but has an additional password protect feature that disables certain features allowing XSNOED to be used as an interactive demonstration for the general public.
SNOPLUS SNO+ version of the event display. Supports CAEN data instead of NCD.