-
Notifications
You must be signed in to change notification settings - Fork 14
Home
CutLang is an analysis description language (ADL) and runtime interpreter for high energy collider physics data analyses. The analysis description language aims to express all elements of a data analysis in an easy and unambiguous way. The runtime interpreter reads and interprets the analysis operations directly and runs the analysis on event data.
CutLang aims to serve as a regular tool for the high energy community in general: from experimental analysts and phenomenologists to educators in areas from analysis design to preservation.
CutLang ADL is a declarative domain-specific language customized to express physics analysis-specific concepts. The current CutLang ADL is based on the Les Houches Analysis Description Accord proposal (sections 15 and 16). The ADL in particular focuses on event processing operations. Its core includes:
- simple and composite object definitions (jets, muons, Ws, RPV stops, …)
- object and event variable definitions (isolation variables, transverse mass, aplanarity, angular variables, BDTs, ...)
- event selection definitions (signal, control, validation, ... regions)
- standard histogtaming operations, in order to direct its runtime interpreter.
Further operations with selected events (background estimation methods, scale factor derivations, etc.) can vary greatly, and thus may not easily be considered within the ADL scope.
The ADL consists of:
- a plain text file describing the analysis using a HEP specific language with syntax rules that include standard mathematical and logical operations and 4-vector algebra.
- a library of self-contained functions encapsulating variables that are nontrivial to express with the ADL syntax
Current ADL syntax is capable of describing the majority of generic event processing operations, however work is in progress to further improve and generalize the scope.
ttbar events in CMS opendata format for testing are here for downloading . fully hadronic ttbar events in ATLAS opendata for testing are here for downloading .
A recent user manual can be found here: User Manual V2.
A recent dedicated school on CutLang bases analyses can be found here: indico page.
-- more to be written--
A number of LHC analyses have been converted to ADL format. These ADL files, together with the associated papers have now their own repository:here .
If you use CutLang in your work, you can cite it using: CutLang: A Particle Physics Analysis Description Language and Runtime Interpreter, G. Unel and S.Sekmen, Computer Physics Communications, volume 233, P215-236, 2018.