EUTelescope And IBL Testbeam pages


Glasgow work on ATLAS Inner B-Layer (IBL) testbeam data. Both Reconstruction and Analysis aspects of the work involve EUTelescope software. Please see the official pages pages for more details. A communal area with installed software and testfiles can be found: /data/detdev01/FEI4_testbeam_construction.

Information on finding data is given below.

NB This page is a work in progress.

Testbeam Reconstruction

A working version of the reconstruction code can be found: /data/detdev01/FEI4_testbeam_construction/reconstruction.

If you want to install your own code then follow the instructions here.

This is a short recipe for running.

* First set the environment.

> ILCSOFT=/data/detdev01/FEI4_testbeam_construction/reconstruction/v01-17-01/Eutelescope/v00-08-02
> source

To check the environment has been set correctly check the EUTELESCOPE parameter has been set: > echo $EUTELESCOPE
This should be something like /PATH_TO_SOFTWARE/v01-16-02/Eutelescope/v00-08-02

* Next, go to the jobsub directory:

> cd $EUTELESCOPE/jobsub

You are now ready to run the reconstruction chain. There are five steps or "tasks" to transform raw data into analysis ready data: converter, clustering, hitmaker, alignment and filter. Each task is performed using the script and requires a configuration file to set basic steering parameters such as input file, output directories and beam energy. The basic execution format is


* Now you can proceed to run the reconstruction. Here is an example reconstruction chain:

> ./ --config=$EUTELESCOPE/jobsub/examples/datura-noDUT/config.cfg -csv $EUTELESCOPE/jobsub/examples/datura-noDUT/runlist.csv converter 97
> ./ --config=$EUTELESCOPE/jobsub/examples/datura-noDUT/config.cfg -csv $EUTELESCOPE/jobsub/examples/datura-noDUT/runlist.csv clustering 97
> ./ --config=$EUTELESCOPE/jobsub/examples/datura-noDUT/config.cfg -csv $EUTELESCOPE/jobsub/examples/datura-noDUT/runlist.csv hitmaker 97
> ./ --config=$EUTELESCOPE/jobsub/examples/datura-noDUT/config.cfg -csv $EUTELESCOPE/jobsub/examples/datura-noDUT/runlist.csv align 97
> ./ --config=$EUTELESCOPE/jobsub/examples/datura-noDUT/config.cfg -csv $EUTELESCOPE/jobsub/examples/datura-noDUT/runlist.csv fitter 97
For ease of running a bash script called is in /data/detdev01/FEI4_testbeam_construction/reconstruction which will run the chain for you. Please edit the parameters at the top of the file.

The output of each step should include a root file (only the first three are inspectable) and lcio files. The final output, "SOMERUN-tracking.root" is used as the input for analysis.

For more details see the official pages here.

Link to CustomReconstruction.

Testbeam Analysis

The testbeam analysis software is called tbmon and can be found /data/detdev01/FEI4_testbeam_construction/analysis/tbmon.

The software has three main configuration files: siteconfig.h, and, which are all found in the trunk directory. The siteconfig.h file is where default parameters such as run numbers and configuration settings can be defined, though these can be overwritten on the commandline. After any editting of the files the make command must be rerun.

NB Be sure the version of root you are using includes libraries for TFitResult and TFitResultPtr i.e. version >=5.26. If needed do

> source /data/ppe01/sl5x/x86_64/root/5.34.00/

The basic execution format is


Here is an example analysis chain:

> cd PATH_TO_ANALYSIS/tbmon/trunk
> make
> ./tbmon -s 61527 -a hotpixelfinder -c eudetIBLsep2011
> cp OUTPUT_PATH/run61527-hotpixelfinder-*txt IBLcalibs/
edit to set bool masknoisyanddeadpixels = true in relevant subroutine (e.g. here eudetIBLsep2011)

> make
> ./tbmon -s 61527 -a checkalign -c eudetIBLsep2011
> cp OUTPUT_PATH/run61527-checkalign-*txt IBLcalibs/
no need to edit or make here

> ./tbmon -s 61527 -a getetacorr -c eudetIBLsep2011
> cp OUTPUT_PATH/run61527-getetacorr-*txt IBLcalibs/
edit to set bool applyetacorr = true and bool applytranslation = false

> make
> ./tbmon -s 61527 -a checkalign -c eudetIBLsep2011
edit to set bool applytranslation = true and comment out hotpixelfinder, getetacorr and checkalign analysis objects from the allAnalyses function at the top of the file.

> make

for ease of use these steps are combined in the file. In it the common tbmon command without a specified task (i.e. ./tbmon -s/r/l RUN_NUMBER(s)/RUN_LIST -c CONFIGURATION_SET) is set at the top to the basicCommand variable. This should be editted to refer to the correct and run set and siteconfig file. Also an uneditted file should be copied to to avoid any uneccessary file changes to the original file. Once this is done the previous steps can be run in serial using the sole command > source

At this point any additional analyses can be run without further make commands. E.g. to perform residuals analysis:

> ./tbmon -s 61527 -a residuals -c eudetIBLsep2011
All standard analysis code resides in trunk/analysis/src. If no analysis is specified on the commandline then all analyses in the allAnalyses function of are run.

The output of analyses are root files and pictures (in a format which can be specified in siteconfig.h or on the commandline with -e option).

For more details see some useful slides on tbmon commands and software.

Link to CustomAnalysis.

Testbeam Data

Data can be found at Dortmund, DESY and CERN.


Test data can be run directly over AFS from DESY. The address is /afs/


Data at Dortmund must be copied locally and can only be accessed once an account has been set up on the Dortmund server. To do this you will need to contact .

Here is a spreadsheet on data sample and important parameters such as bias, theta and threshold.

Here is a link to ATLAS twiki. In the Testbeams there are links to the pages of each testbeam. Then on each page there is a link to a spreadsheet with run information hosted on google docs. You may need to ask for permission to view the data (just log-in to google, click to ask permission and wait for someone to add you, no questions asked).


Data can be found at CERN by first logging on to lxplus then sourcing the necessary EOS build: source /afs/

EOS can then be launched vai the eos command.

A list of testbeam data can be found: /eos/atlas/atlascerngroupdisk/pixel-upgrade/pps/BeamTest/ .

-- KennyWraight - 2013-05-24

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatxlsx PPS_March2012_BatchSummary.xlsx r1 manage 90.4 K 2013-06-18 - 11:36 KennyWraight Spreadsheet with description of testbeam runs
PDFpdf TBmon_Introduction_CERN_2012.pdf r1 manage 146.3 K 2013-05-29 - 09:46 KennyWraight Slides on tbmon analysis
PNGpng eutel-strategy.png r1 manage 106.6 K 2013-05-24 - 11:33 KennyWraight Schematic of EUTelescope strategy
PDFpdf howtoTBmon.pdf r1 manage 61.0 K 2013-05-29 - 10:00 KennyWraight full list of analysis options
PNGpng recon_chain.png r1 manage 58.4 K 2013-05-28 - 11:00 KennyWraight reconstruction chain flowchart
Edit | Attach | Print version | History: r30 | r16 < r15 < r14 < r13 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r14 - 2013-06-25 - KennyWraight
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2021 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback