Instructions how to save (beam) conditions data.


The conditions data can be saved with DIP loggers and/or with Timber. Here you can find user's instructions for the DIP loggers, Timber usage is discussed in what follows.

Do not forget to copy/move the DIP logs and Timber data files to the adequate location - see convetions for more information.

Saving data from Timber - manually

  1. Download Timber and run it (with javaws or any other adequate program).
  2. Set Time Zone to LOCAL_TIME and Data source preferences to MDB (PRO -> DEV) -> LDB (PRO -> TEST).
  3. Set Start time and End time.
  4. Save RP position data. Click on the Variable search tab and search for XRP[H, V]%MEAS_LVDT_[LU, RU]. Here, the [H, V] symbol means to use either H or V. Similarly for [LU, RU]. Repeat the search for all combinations and each time click Add all. Finally, go to the Query tab, click on the File radio button, select Comma delimited, check the Include metadata box (uncheck Group by timestamp box) and click Query button. Save the file as timber_rp.csv.
  5. Save BLM data. As for RP positions but search for variables BLM[E, Q]I.06%5%LOSS_RS0[8, 9]. Use timber_blm.csv file name.
  6. Save BPM data. Since Timber has problems to process large data, this needs to be done in several steps. If Timber still fails to retrieve the data, try to split the entire time period into several intervals.
    1. Save the following variables into timber_bpm1.csv:
    2. Save LHC_BOFSU:BPM_POSITIONS_H to timber_bpm2.csv.
    3. Save LHC_BOFSU:BPM_POSITIONS_v to timber_bpm3.csv.
    4. Save LHC_BOFSU:BPM_POS_ERR_H to timber_bpm4.csv.
    5. Save LHC_BOFSU:BPM_POS_ERR_v to timber_bpm5.csv.

Saving data from Timber - automatically


In SVN at /trunk/offline/timber/lhc2file/ you'll find a tool that automatically saves the desired timber data.

This tool polls data from the LHC Logging Measurement Production Database.

The result is saved in a CSV file in timber format.

Additionally it polls RP positions and saves them in an XML file in the appropriate format and mapping.



  • java 1.5 to run
  • javac and Apache Ant to build


To build the application, simply run:


this will compile the source files and package them in one lhc2file.jar file together with the dependent libraries.


The application can be configured by command line options:

  • -input input_file -> path to the input file with timber variable names
  • -output output_file -> path to the output file
  • -f fill_number -> fill number
  • -t "startTime" "endTime" -> time range

  • -rp -> polls RP positions and stores them in XML format
  • -sdl limit -> standard deviation limit for RP positions, default value: 0.001


To run the application you need the lhc2file.jar file.

Examples of usage:

to get specific timber variables by fill number
java -jar lhc2file.jar -input input/ -output BLM.out -f 31234
to get specific timber variables by time range
java -jar lhc2file.jar -input input/ -output BLM.out -t "Tue Aug 24 23:15:00 2010" "Wed Aug 25 03:15:00 2010"
to get RP positions and save them in XML file, with the default standard deviation limit of 0.001
java -jar lhc2file.jar -rp -input input/RPmappings.txt -output RP_Dist_Beam_Cent.xml -t "Tue Aug 24 23:15:00 2010" "Wed Aug 25 03:15:00 2010"
to get RP positions and save them in XML file, with user specified standard deviation limit
java -jar lhc2file.jar -rp -input input/RPmappings.txt -output RP_Dist_Beam_Cent.xml -t "Tue Aug 24 23:15:00 2010" "Wed Aug 25 03:15:00 2010" -sdl 0.05

In the ./input directory I provided sample input files with all:

  • BLM variables
  • BPM variables
  • RP variables
  • RP mappings


The tool can be extended on other options, such as different output file formats, scale algorithms, choice between local and utc time etc.

For an example, to change the output file format from CSV to TSV, one has to edit the and in the method save2file(...) change OutputFileFormat.CSV to OutputFileFormat.TSV. Other avaiable formats can be found here

To change other options, in the same file and method as above, you have to edit the line

TimeseriesDataFile timeseriesdataFile = new TimeseriesDataFile(LoggingTimeZone.LOCAL_TIME, true, null, null, false);

according to this

To add new command line options, you'd have to edit the and create new options similar to those in createOptions() method.


LHC Logging Software


Processing Timber data

There are scripts to convert Timber CSV files to ROOT files. They can be downloaded from TOTEM SVN from trunk/offline/timber. Source the environtmen file and build them with make. Use csvToRoot for RP and BLM data. Help can be obtained with --help parameter. For BPM data use arrayCSVToRoot. To save only "TOTEM" BPMs, you can use switch --filter BPMWT.

-- JanKaspar - 19-Aug-2010

Edit | Attach | Watch | Print version | History: r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r2 - 2010-08-27 - unknown
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    TOTEM All webs login

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.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback