ALPIDE-analysis

Framework for analysis of R3B & FRS EC experimental data involving the ALPIDE detectors. At the moment, written for a telescope arrangement of a single-sensor detectors. To start, clone the repo and run make in the main directory. Executables existing so far are

• **clusterise
• calibrate
• analyse**

Default arguments are in () brackets, and user arguments are in [].

./clusterize --file=FILE_IN.root --output=FILE_OUT.root --veto=[N](1) --firstEvent=[fE](0) --max-events=[mE](-1) --dets=[{x_i}]()

--file=FILE_IN.root         ..Input file.
--first-event=N             ..Start from N-th event. Default 0. 
--max-events=N              ..Specify maximum number of events. Default all entries.
--veto=N                    ..Only consider clusters with size>N. Default 0.
--output=FILE_OUT.root      ..Write clusterised data in this file. Default $(FILE_IN)_cl.root.
--dets=[d1,d2,..]           ..Condition to only write events which have clusters in every specified detectors.
      =all				    ..Equivalent to dets=1,2,..,ALPIDE_NUM. Every event must contain a cluster in all detectors.
--help                      ..Print this message to stdout.

The exe will cluster all the hits and write an output root file. A cluster is a connected region of fired pixels identified in a single event.

Branch description:

• CL_NUM : number of clusters in the event.
• ALPIDE_ID : detector ID for each individual cluster.
• CL_SIZE : cluster size for each cluster.
• CL_uCOL : mean column position of each cluster.
• CL_uROW : mean row position of each cluster.
• CL_uCOL_SIG : uncertainty of CL_uCOL, in units of col.
• CL_uROW_SIG : uncertainty of CL_uROW, in units of row.

Additional branches to show individual pixels clustered:

• _N : total number of pixels fired. Equals to sum of all CL_SIZE.
• _COLV : pixels fired which belong to a cluster. First CL_SIZE[0] elements belong to 0th cluster, next CL_SIZE[1] belong to 1st cluster, etc.
• _ROWV : same but for rows.

./calibrate --file=FILE_IN.root --output=FILE_OUT.root --firstEvent=[fE](0) --max-events=[mE](-1)
		
--file=FILE_IN.root         ..Input file.
--first-event=N             ..Start from N-th event. Default 0.
--max-events=N              ..Specify maximum number of events. Default all entries.
--output=FILE_OUT.root      ..Specify output file name. Default same as input file with 'calib' suffix.
--help                      ..Print this message to stdout.

The exe will calibrate the detectors offsets (dXi,dYi) relative to ALPIDE1 and write an output root file. Calibration of (dX,dY) for each alpide with reference to the first ALPIDE is stored in the aCol,bCol,aRow,bRow vector and corresponding sigma branches. a is the slope of the fit line and b the offset, in units of rows & columns.

./analyse --file=FILE_IN.root --output=FILE_OUT.root --firstEvent=[fE](0) --max-events=[mE](-1) --<OTHER_ARGS> 

--file=FILE_IN.root         ..Input file.
--first-event=N             ..Start from N-th event. Default 0 
--max-events=N	            ..Specify maximum number of events. Default all entries.

--hitmap=X                  ..Plots the hitmap of AlpideX. Works for files containing raw or clustered data.
--hitmap                    ..Plots the hitmaps of all Alpides. Works for files containing raw or clustered data.
--track                     ..Do the tracking.
	--cal=CAL_FILE.root     ..Pass calibration file to the tracker (OPTIONAL).
	--save=SAVE_FILE.root   ..Save the tracks into a rootfile. If not specified, only plots the data.
--help                      ..Print this message to stdout.

This exe can plot the hitmaps of all or specified detector(s). Works with either raw or clustered data. To do the tracking procedure pass --track --cal=CAL_FILE.root --save=SAVE_FILE.root flags. Works only for input files with clustered data. This will create a rootfile with X,Y,Z branches containing (calibrated) (x,y,z) hit positions that the algorithm recognized could form a track. Tracks are only formed with 3 or more correlated hit points from the clustered data in a single event.