Focal Plane Detector in NPTool

General Overview
This pages is intended as a guide (work in progress) to help NPTool users to analyse data from the Focal Plane Detector (FPD) at TAMU. The structure of the data branch and the convention used for the different "sub"-detectors of the FPD will be presented.

The Focal Plane Detector
There's four "sub"-detectors in the FPD, represented in the following table

Each one of this detector can be treated as a separate array of data[n][m]. The number of rows "n" increases from upstream to Downstream e.g. in the case of Delta the element [0][0] represents the pad closest to the MDM, [1][0] would be the second pad downstream and so on. The number of columns "m" increases from left to right where the experimenter is looking to the setup from above and looking downstream, example in case of Plast we only have one "row" but we have two readings from each end/side of the detector thus the structure would be data[0][0] (Left) and data[0][1] (right), where data could be time or energy.

Delta-E Ionisation Chamber

 * Measures energy loss
 * Number of pads: 3(4?), However currently only the upstream one is in use
 * Convention in NPTool: rows index = {0,..,-1}, column index = 0,
 * Note: could be also used for the cathode measurement

Avalanche Wires

 * Measures position,
 * Number of wires: 4
 * Note: Resistive, two measurement for each wire "Left" and "Right"
 * Convention in NPTool: rows index = {0,..,-1}, column index = {0,1} (Left and right)

MicroMega plate

 * Measures position, energy loss and residual energy depending on the case (mass, energy, gaz pressure...)
 * Number of pads: 4 rows x 7 columns = 28 pads
 * Convention in NPTool: rows index = {0,..,3}, column index = {0 (left most),..,6 (right most)}

Plastic scintillator

 * Measures residual energy, and position(?)
 * Number of detectors: 1
 * Note: Plastic Scintillator, two measurements from two PMTs on "Left" and "Right", respectively
 * Convention in NPTool: rows index = {0}, column index = {0,1} (Left and right)

Converting the Midas data to NPTool Format (in progress)
The data is unpacked using an auxiliary package midas2nptool (link-to-git). midas2nptool will convert the data from the midas format to a ROOT tree where every detector is unpacked in an individual folder in the ROOT file.



Setting the configuration file (in progress)
Give the format and a sample for the tiara

Running midas2nptool
How to run one file, or a collection of files

Analysis in the NPTool framework (in progress)

 * Analysis convention/philosophy
 * What is stored in the tree and what is not
 * What is done in the Analysed data (Physics class) and what is done in the outside program

Raw Data (in progress)
Brief description of the structure of data

Analysed Data (in progress)
List of the main functions used to get and set information (in progress)

Analysis functions (Add what you want!)
For now these functions are intended for the MicroMega
 * Energy from a specific pad
 * Energy from a specific group of pads (i.e. between rows 1-3 and cols 1-4)
 * Energy from a specific row
 * Energy from a specific col