Timber tools

These are tools related to the LHC logging data base. They can be downloaded from TOTEM SVN repository: svn+ssh://svn.cern.ch/reps/totem/trunk/offline/timber.

• lhc2file is an (obsolete) command line tool to download data from LHC LD. It is not maintained anymore and thus most likely not working.
• csvToRoot is a program to convert Timber csv files to ROOT graphs. When saving files from Timber, make sure that UNIX time stamps are used and the metadata are included. Do NOT check the option "Group By Timestamp". On contrary, you may use the multi-file feature (it is useful for array data like BPM measurements). csvToRoot supports both numerical and array data. For arrays, one may set a filter condition. For example to select only the Roman Pot BPMs, use --filter BPMWT option. Usage example: ./csvToRoot --output rp.root rp*.csv. This makes a ROOT file with RP movement data from all available rp*.csv files.
• makeOfflineGeometry creates the RP postion DDL file RP_Dist_Beam_Cent.xml for the offline software. Usage example: ./makeOfflineGeometry --time --offsets lvdt_offsets/2011_05 rp.root. This takes the RP position data from rp.root, evaluates the positions at , applies LVDT offsets from lvdt_offsets/2011_05 and prints the output to console.
• The lvdt_offsets directory (also in SVN) contains the results from collimation alignment excercises. The mapping between Mario's Excell sheets is the following. For example for the far-top offset, one shall assign -cT to RP_XXX_XXX_Det_Dist_4.

• makeRPPlots.cc is a simple ROOT script to make per-station plots from rp.root and saves them as rp_plots.root.

The tools are installed on AFS: /afs/cern.ch/exp/totem/scratch/data/RP/tools. To recompile/use them, log to LXPLUS, go to that directory, initialize the environment by bash --rcfile environment. To recompile, run make.

-- JanKaspar - 19-Oct-2011