TCTAnalysisUserGuide

• Introduction
• Source Code
  • Supported platforms
  • GIT repository in bitBucket
  • Structure
  • Requirements
  • Compiling
• Running the code
• tctAna functions and tools
• tctAna results

Introduction

Documentation and examples of tctAnalysis framework. For use (currently) with data from RD50 TCT setup.

STATUS: Under development!

Source Code

Supported platforms

• Mac OSX

Developed in OSX, makes use of some BOOST filesystem functions that may not translate to Linux.

GIT repository in bitBucket

The source code can be found in this git repo:

• URL: https://rmdcarney@bitbucket.org/rmdcarney/tctana.git

Contact the author to get access.

Structure

• Makefile : Makefile to compile the code
• README : Textfile with hints and clues
• src/ : Folder for main programs
• bin/ : Folder for compiled executables
• build/ : Folder for compiled objects
• tools/ : Folder for tool source code
• ana/ : Folder for analysis source code

Requirements

The source code has several libray dependencies:

• ROOT : ROOT libraries must be compiled and findable ( http://root.cern.ch/drupal/content/downloading-root ) (tested with 5.34)
• Boost : Boost libs must be compiled and findable ( http://www.boost.org/users/download/ )

Compiling

If all requirements are satisfied, compiling is easy.

[tctAnalysis rebeccacarney]$ make clean
[Clean] … done!
[tctAnalysis rebeccacarney]$ make 
[Compiling] build/sort.o
[Compiling] build/usefulMaths.o
[Creating] build/librce_tools.a
[Compiling] build/dataContainer.o
[Compiling] build/tctAna.o
[Creating] build/librce_ana.a
....
[Compiling] build/sortingMain.o
[Linking] bin/sortingMain
[Compiling] build/takeData.o
[Linking] bin/takeData

To create a new main ensure it has a filename ending in .cxx and is saved in the src/ folder.
To create a new tool or analysis class, ensure the files have a class name ending in .cpp and are saved in tools/ or ana/ , respectively.

Running the code

Currently the main executable is:

• anaData

The programs needs command line arguments to import the necessary files and parameters. Try running it and the following will be displayed:

[tctAnalysis rebeccacarney]$ ./bin/anaData
Execute like: ./anaData [dataSet_to_analyse] [trapping_time_file] [fit_limit_file]

The command line arguments are enumerated below.
[dataSet_to_analyse]: TCT scans at various bias voltages over the same chip. Examples of these are saved in the dataSets folder, e.g.:

..................................................................................................................................................................

/Users/rebeccacarney/Dropbox/MPhys/code/tctAnalysis/../../tctData/1E13_voltageScan_pSide/1E13_-100_58.3_59.8_40.dat
/Users/rebeccacarney/Dropbox/MPhys/code/tctAnalysis/../../tctData/1E13_voltageScan_pSide/1E13_-105_58.3_59.8_40.dat
/Users/rebeccacarney/Dropbox/MPhys/code/tctAnalysis/../../tctData/1E13_voltageScan_pSide/1E13_-10_58.3_59.8_40.dat
/Users/rebeccacarney/Dropbox/MPhys/code/tctAnalysis/../../tctData/1E13_voltageScan_pSide/1E13_-110_58.3_59.8_40.dat
/Users/rebeccacarney/Dropbox/MPhys/code/tctAnalysis/../../tctData/1E13_voltageScan_pSide/1E13_-115_58.3_59.8_40.dat 

..................................................................................................................................................................

[trapping_time_file]: The trapping times to be considered for correcting the irradiated data. Examples of these files are saved in the tauValues folder, e.g.:

..................................................................................................................................................................

#===================================================
#  T R A P P I N G    T I M E S    T O    T E S T
#===================================================
# Number of trapping times:
8
#--------------------------------
#  Trapping times: 
#--------------------------------
0
4.0
6.0
20.
60.
100.
500.
100000.
..................................................................................................................................................................

[fit_limit_file]: The CCM correction fits the integrated charge plot above depletion, but depletion voltage varies per sensor and irradiation/annealing. As such, this file provides a range of fitting limits. The first argument is the highest depletion voltage, what follows are lower bound fit ranges to try. Consult the CCM page for more details. An example of this file is saved in the xHigh folder, e.g.:

..................................................................................................................................................................

#=================================================== 
#  F I T T I N G    L I M I T S    T O    T E S T 
#=================================================== 
# Number of fitting limits:
 3 
#-------------------------------- 
#  Fitting limits:  
#-------------------------------- 
-600 
-300 
-400 
-500
..................................................................................................................................................................

The main executable may change, so watch this space for edits!

tctAna functions and tools

Short description of some of the tools that can be used in an analysis. Click the hyperlinks for more details.

Name	Author	Command line parameter (optional)	Description
CCM	Rebecca	From anaData command line args: multiple tct waveforms @ various bias voltages, various trapping times to try, various fitting limits to try.	Corrects tctWaveforms for trapping defects by establishing the correct trapping time.
Depletion voltage (In progress!!)	Rebecca	multiple tct waveforms at various bias voltages, fit limits (optional)	Uses two linear fits on the relative charge collection efficiency graph to establish the depletion voltage

tctAna results

A link to the graphs from analysis

Sensor type	Irradiation (if any) and facility	Irradiation date (dd/mm/yy)	tct facility used	Description	Data added by	Date added (dd/mm/yy)	Trapping time picked	CCM Plots	Depletion voltage (CCE)	plots (CCE)
MCz n-in-n	70MeV protons, 1e13 neq/cm^2 fluence, Tohoku University Cyclotron and Radioisotope Centre (CYRIC) (Japan)	30/10/13	CERN SSD TCT+ setup	Sensor 1 of 3	Rebecca	22/07/14	No trapping time	MCz 1E13 p-side MCz 1E13 n-side	-255V	MCz 1E13 CCE fit
MCz n-in-n	70MeV protons, 1e14 neq/cm^2 fluence, Tohoku University Cyclotron and Radioisotope Centre (CYRIC) (Japan)	30/10/13	CERN SSD TCT+ setup	Sensor 2 of 3	Rebecca	22/07/14	16 [ns]	MCz 1E14 p-side MCz 1E14 n-side	-69V	MCz 1E14 CCE fit
MCz n-in-n	70MeV protons, 5e14 neq/cm^2 fluence, Tohoku University Cyclotron and Radioisotope Centre (CYRIC) (Japan)	30/10/13	CERN SSD TCT+ setup	Sensor 3 of 3	Rebecca	22/07/14	4.5 [ns]	MCz 5E14 p-side MCz 5E14 n-side	-321V	MCz 5E14 CCE fit
MCz n-in-n	Unirradiated	n/a	CERN SSD TCT+ setup	Sensor 1 of 1	Rebecca	22/07/14	No trapping time	MCz unirrad p-side MCz unirrad n-side	-353V	MCz unirradiated CCE fit
DOFZ n-in-n	70MeV protons, 5e14 neq/cm^2 fluence, Tohoku University Cyclotron and Radioisotope Centre (CYRIC) (Japan)	30/10/13	CERN SSD TCT+ setup	Sensor 1 of 1	Rebecca	22/07/14	4 [ns]	DOFZ unirrad p-side DOFZ unirrad n-side	-290V	DOFZ 5E14 CCE fit

---

Major updates:
-- RebeccaCarney - 16-July-2014

%RESPONSIBLE% RebeccaCarney
%REVIEW% Never reviewed