Introduction

Basic introduction and sorting philosophy

There are three phases:

1. Convert the raw data into a time ordered root tree
2. Event building
3. Histogramming

The first two steps are run on each raw data file independently, while the histogramming combines all the runs and subruns into a single output file.

These need three input files:

• the settings file, which describes what hardware configuration we have (how many modules, what channel a given signal is on, etc.)
• the calibration file, which has the energy calibrations, time offsets and thresholds for each channel
• the reaction file, which is used to build the histograms

Additionally, the reaction file sets up cuts on the ejectile, recoil or transfer particles (energy vs. angle banana cuts). These are root files containing a TCut instance, that is normally called "CUTG" (though this can be changed in the reaction file). To create these, open the histogram root file and look at the 2-D histogram "ParticleSpectra/pE_theta", activate the toolbar in the "View" menu, click on the scissors and define a cut by clicking around the particles you want to select (you may need to zoom out a bit to make sure you include the first and last angle bin) and double click to close the path. Then right click on one of the lines of the cut and select SaveAs and give it a filename with a .root extension. This filename then needs to be set in the reaction file.

You will also need some SRIM files so the code can calculate the energy losses. These should be run up to 10 GeV and have to be in the srim directory of the sorting code source. Many examples are provided within the source code already and may already exist for your case. In case you create new ones, please submit them to the repository for future use.

After the first step you have a raw root file with calibrated and uncalibrated histograms for each channel and trees of time ordered hits, but with no events built.

The second step produces an event root file.

The final step produces the final histograms.