class THiRA: public TObject

 -- Copy constructor.

 -- Copy this method.

 -- Calculates all THiRA quantities.
 This method calls all calculate methods of any member classes of THiRA such
 as the Calculate() method of TFront, TTele, etc.  Any calculations related
 to this class, THiRA, are also done here.

 -- Calibrates THiRA components.
 Calibrates all elements in the THiRA class such as Si and CsI slopes and
 offsets.  Note that a calibration file must be loaded for any members that
 are to be calibrated.

 -- Clears data members.

 -- Clear all data members related to counting errors.

 -- Create HiRA related folders in the current root file.

 -- Draw an expression for multiple telescope.
 Many times when we wish to draw a histogram for HiRA we want to create it for
 all telescopes.  This method allows one to easily accomplish this task.

 1. varexp is the normal expression one would use EXCEPT without the tele#. prefix.
 2. selection is any condition put on the output.
 3. option is the typical Draw option such "colz","surf", etc.
 4. drawType must be set to "all" as this is the only option implemented.  This
    option produces a canvas with all telescopes drawn.

 -- Fill the telescope branches with data.
 The following operations occur,
     1. The CB and Hit sequences are set.
     2.

 -- Fill the telescope CsI branches with data.

 -- Get the index for the quadrant of silicon located behind a pixel.

 -- Get the TPad index corresponding to the physical position of a telescope.
 When drawing histograms for HiRA it is sometimes desireable to create a
 canvas containing pads corresponding to each detector.  It is also convenient
 to draw these histograms in the actual order of the setup.  This method returns
 the index of a TPad defined by the towerMatrix[][] in the rootDefine.h file.
 This pad number should be the physical position of the detector in the setup.

 -- Generate HiRA primary data tree.

 -- Gets the telescope index of a telescope with id.
 There are two main integer numbers that describe a telescope.  The first is
 what we call the telescope id.  This is the number that is typically located
 on the back of the detector box.  It is the label for the telescope.

 The second is the telescope index.  This is the postion in the tele[] array.
 The purpose of this array is that it allows us to easily loop over all
 telescopes using a for() loop.

 For example, if we have 16 telescopes then the tele[] array will have 16
 elements.  The telescope index then runs from 0-15.  However, we may be using
 telescopes 7,0,1,2,3,4,5,6,8,9,10,11,12,16,17,19.  These are not consecutive
 numbers that are difficult to loop over.

 NOTE:  While this is one way to loop over telescopes there is a more object
 oriented method.  This method involves using the TIter class and iterating
 over the elements in the THiRA TList or an additional TObjArray.

 --
 Initializes or creates all the branches and member branches for the THiRA
 class on the tree.  This is typically called after instanciating TTree and
 THiRA.  The branch structure will then be generated on the TTree.

 --
 Loads the chip/telescope mapping for the THiRA class as well as initializing
 class variables for THiRA.

 -- Initializes a tree containing THiRA branches.

 -- Load the adc mapping file.

 --

 --
 Loads and parses the .vdef file containing the HiRA CsI slopes and offset
 values.  The filepath argument is the location of the calibration file.

 -- Load the segment position vectors for all CsI crystals.

 --
 Loads and parses the .vdef file containing the HiRA CsI voltage calibration
 values.  The filepath argument is the location of the calibration file.

 -- Load a HiRA pixel file.
 This file should contain the DESIGN VECTORS of each pixel in the array.
 A script should be used later for calculations using the MEASURED VECTORS.

 -- Load the HiRA readout order shift parameters.

 This file contains the readout shifts for each channel in HiRA.

 The telescopes are ordered starting at the bottom left, increasing as we
 move up a tower.  The number continues at the bottom of the next tower
 proceeding until the upper right of the array.

 This file and the LoadReadoutShift() method should be modified if a
 more complicated shift id needed.  This file format should satisfy most
 basic needs.

 The shift can be set per channel, per face, or per chip.  It is assumed
 that the highest order if O(5).

 *** SIMPLE PER CHANNEL SHIFT ***
 The format is IF Complexity==2,
    teleIndex   teleID   face   Complexity
 	O(0)	O(1) 	O(2) 	O(3) 	O(4) 	O(5) 	//CH0
	O(0) 	O(1) 	O(2) 	O(3) 	O(4) 	O(5)    //CH1
 	O(0)	O(1) 	O(2) 	O(3) 	O(4) 	O(5) 	//CH2
	O(0) 	O(1) 	O(2) 	O(3) 	O(4) 	O(5)    //CH3
	.	.	.	.	.	.
	.	.	.	.	.	.
	.	.	.	.	.	.

       and so on . . .

 *** SIMPLE PER CHIP SHIFT ***
 The format is IF Complexity==1, (EVEN->Chip 0,ODD->Chip 1)
    teleIndex   teleID   face   Complexity
 	O(0)	O(1) 	O(2) 	O(3) 	O(4) 	O(5) 	//CHIP0
	O(0) 	O(1) 	O(2) 	O(3) 	O(4) 	O(5)    //CHIP1

       and so on . . .

 *** SIMPLE PER FACE SHIFT ***
 The format is IF Complexity==0,
    teleIndex   teleID   face   Complexity
 	O(0)	O(1) 	O(2) 	O(3) 	O(4) 	O(5) 	//FACE

 	and so on . . .

 -- Load a HiRA Si calibration file.
 Loads and parses the .vdef file containing the HiRA Si slopes and offset
 values.  The filepath argument is the location of the calibration file.

 --

 -- Print all set bad elements to the stdout.

 -- Set the path of the ASIC chip mapping file.

 -- Set the CsI mapping file.

 --

 -- Change (i.e. set) the name of the THiRA.

 -- Change (i.e. set) all the THiRA parameters (name and title).

 -- Change (i.e. set) the title of the THiRA.

 -- Unpack a HiRA event.
 This functions unpacks the raw data contained in a HiRA packet within
 an event data buffer.  The argument is a pointer which is the location of
 beginning of the packet.

 When unpacking data from an event file this function will typically be
 called whenever a HiRA packet tag is found.  (Packet id's are defined in
 the file packetID.h).

 There has been some confusion regarding the mapping of the strips to their
 respective chip and channel that is written to the event file.

 Typically,
 1.  The dE and EF strips are vertical.  The EB strips are horizontal.
 2.  Chip 0 is the first chip readout.
 3.  The chipboards are readout from the bottom slot on a MB to the top.
 4.  The convention is to have the upper left pixel of the detector to be (0,0)
     so that the detector pixels are elements of a matrix.
 5.  The dE detector is connected in the same way as the EF.  HOWEVER, when
     going through external preamps and the pinout is changed!!!  Therefore dE
     strips may map differently than below.

 Chip 0 is PIN #0 on chipboard (even PINS).
 Chip 1 is PIN #1 on chipboard (odd  PINS).

 Ch          15 15 14 14 13 13 12 12 11 11 10 10 09 09 08 08 07 07 06 06 05 05 04 04 03 03 02 02 01 01 00 00

    PIN      31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00

       strip 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
             __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 00  00  00 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 00  01  01 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 01  02  02 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 01  03  03 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 02  04  04 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 02  05  05 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 03  06  06 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 03  07  07 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 04  08  08 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 04  09  09 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 05  10  10 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 05  11  11 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 06  12  12 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|  ^
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 06  13  13 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|  |
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 07  14  14 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|  EB
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 07  15  15 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|  |
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 08  16  16 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|  V
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 08  17  17 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 09  18  18 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 09  19  19 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 10  20  20 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 10  21  21 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 11  22  22 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 11  23  23 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 12  24  24 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 12  25  25 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 13  26  26 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 13  27  27 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 14  28  28 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 14  29  29 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 15  30  30 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|
            |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
 15  31  31 |__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|__|

                                                <--- EF --->

 -- Unpack raw CsI data.

 -- Unpack the HiRA CsI energies.