Slice Test Software

Here you can find tarballs of the Slice Test Data Analysis software as well as examples.

Software

There are four software packages available on this site : CDFROOT, HTBDAQ_data, EMuCDFROOT, and SliceCDFROOT. If you are solely interested in looking at the EMu parts of events, you need only CDFROOT and EMuCDFROOT (even if you are looking at output files with HCAL data in them). If you are solely interested in HCAL data, see the normal HCAL TB site for information on HTBDAQ_data. If you want to look a coorelations between HCAL and EMu, then you need all four packages.

CDFROOT 1.4 -- This is an I/O library which stores and loads chunks of data formated in the CMS Common Data Format using ROOT I/O. It is the base library which loads the chunks for HTBDAQ_data and EMuCDFROOT.
HTBDAQ_data 2.5 -- HCAL data reading library. Note that this is not exactly the same bundle as is available on the HTBDAQ_data website. The main install bundle includes CDFROOT in the same source tree, while this bundle is just the HTBDAQ_data classes.
EMuCDFROOT 1.1 -- This package connects the files stored in CDFROOT format and the usual MuEnd[...] classes from ORCA which are used for unpacking EMu data. Note that a copy of the ORCA unpacking code is required to build this library. One may be found here, from October 10, 2004.
SliceCDFROOT 1.0 -- This package allows access to both the HCAL and EMu 'views' of the file at once in a single analysis. Building this library requires all of the above libraries, since this package merely adds two small classes to the system.

Configuring the packages for building

You will need a version of ROOT compiled with the compiler which you are using on your machine. You must set the ROOTSYS environment variable before beginning the install. You must also have ${ROOTSYS}/lib in your LD_LIBRARY_PATH for "rootcint" to function.

The CDFROOT package should compile with the given Makefile with no changes.
In the HTBDAQ_data package, you must update CDFROOT variable to point to the bottom of the CDFROOT tree on your system. You may either edit the Makefile or create a make.local file in the HTBDAQ_data/src directory containing the line "CDFROOT:=[path]"
In the EMuCDFROOT package, you must update the CDFROOT variable and also check that the EMUORCA variable points to a valid ORCA tree containing the EMu unpacking code. Again, you may edit the Makefile or use make.local
In the SliceCDFROOT package, you must update the CDFROOT, HTBDAQ_DATA, and EMUCDFROOT variable by editing the Makefile or using make.local

Each package should compile on its own and produce a library (.so). These (.so) libraries are appropriate for use in ROOT, so the libHTBDAQ_data.so library contains the CDFROOT library contents as does libEMuCDFROOT.so. Linking both libraries to a given application may give strange results, however, so the use of libSliceCDFROOT.so is suggested which contains all of CDFROOT, HTBDAQ_Data, and EMuCDFROOT.

Analysis Examples

Sample_CDFROOT.C -- an example showing how to use the CDFROOT classes alone to get access to the raw chunks as well as to print out the event data.
Sample_EMuCDFROOT.C -- an example showing how to use EMuCDFROOT to obtain the usual classes for EMu analysis.
Sample_Slice.C -- an example showing how to get the HCAL and EMu data from the Slice library. This example also requires the HE mapping file to map electrical to logical connections.