Skip to content
Daniel Savoiu edited this page Aug 19, 2017 · 4 revisions

This Wiki is still under construction, so some information may be incomplete or inaccurate

Excalibur is a high energy physics analysis tool for performing studies using Z+Jets data recorded at the CMS experiment at CERN, and in particular for deriving part of the residual corrections needed for calibrating the jet energy scale. It is built on top of the event data processing framework Artus.

Repository structure

This repository hosts the source code and configuration files for Excalibur and the associated plotting tool, Merlin. The directory structure is as follows:

  • Compile (Excalibur source code)
  • Plotting (Merlin plotting tool source code and configs)
  • cfg (configuration files for Excalibur)
  • data (correction factors, weight files, etc.)
  • docs (Excalibur documentation)
  • scripts (init scripts and other useful tools)
  • test (test scripts)

The following directories are created when running Merlin (merlin.py):

  • plots (ouput files created by Merlin)
  • websync (temporary folder for web sync when running with --www)

Input Format

Both Artus and Excalibur make use of event data stored in ROOT files. These files contain event data extracted from CMS EDM data sets by the ĸappa framework in a process known as "skimming".

The format of Kappa ROOT files is different from that of the original EDM formats (RECO, AOD, MINIAOD, etc.). The interface for accessing the event data stored in these files is defined in the ĸappa and KappaTools packages.

See also

The predecessor of this framework was also named excalibur and can be found here (protected).

Please also have a look at the documentation for Artus and HarryPlotter.