A framework to create customised LHC analyses within CheckMATE

CheckMATE is a framework that allows the user to conveniently test simulated BSM physics events against current LHC data in order to derive exclusion limits. For this purpose, the data runs through a detector simulation and is then processed by a user chosen selection of experimental analyses. These analyses are all defined by signal regions that can be compared to the experimental data with a multitude of statistical tools. Due to the large and continuously growing number of experimental analyses available, users may quickly find themselves in the situation that the study they are particularly interested in has not (yet) been implemented officially into the CheckMATE framework. However, the code includes a rather simple framework to allow users to add new analyses on their own. This document serves as a guide to this. In addition, CheckMATE serves as a powerful tool for testing and implementing new search strategies. To aid this process, many tools are included to allow a rapid prototyping of new analyses. Website: http://checkmate.hepforge.org/ Program summary Program title: CheckMATE, AnalysisManager Catalogue identifier: AEUT_v1_1 Program summary URL: http://cpc.cs.qub.ac.uk/summaries/AEUT_vl_1.html Program obtainable from: CPC Program Library, Queen's University, Belfast, N. Ireland Licensing provisions: Standard CPC licence, http://cpc.cs.qub.ac.uk/licence/licence.html No. of lines in distributed program, including test data, etc.: 181436 No. of bytes in distributed program, including test data, etc.: 2169369 Distribution format: tar.gz Programming language: C++, Python. Computer: PC, Mac. Operating system: Linux, Mac OS. Catalogue identifier of previous version: AEUT v1_0 Journal reference of previous version: Comput. Phys. Comm. 187(2015)227 Classification: 11.9. External routines: ROOT, Python, Delphes (included with the distribution) Does the new version supersede the previous version?: Yes Nature of problem: The LHC has delivered a wealth of new data that is now being analysed. Both ATLAS and CMS have performed many searches for new physics that theorists are eager to test their model against. However, tuning the detector simulations, understanding the particular analysis details and interpreting the results can be a tedious and repetitive task. Furthermore, new analyses are being constantly published by the experiments and might be not yet included in the official CheckMATE distribution. Solution method: The AnalysisManager within CheckMATE framework allows the user to easily include new experimental analyses as they are published by the collaborations. Furthermore, completely novel analyses can be designed and added by the user in order to test models at higher centre-of-mass energy and/or luminosity. Reasons for new version: New features, bug fixes, additional validated analyses. Summary of revisions: New kinematic variables M_CT, M_T2b1, m_T, alpha_T, razor; internal likelihood calculation; missing energy smearing; efficiency tables; validated tau-tagging; improved AnalysisManager and code structure; new analyses; bug fixes. Restrictions: Only a subset of available experimental results have been implemented. Additional comments: Checkmate is built upon the tools and hard work of many people. If Checkmate is used in your publication it is extremely important that all of the following citations are included, Delphes 3 [1]. FastJet [2,3]. Anti-k(t) jet algorithm [4]. CL, prescription [5]. In analyses that use the M-T2 kinematical discriminant we use the Oxbridge Kinetics Library [6,7] and the algorithm developed by Cheng and Han [8] which also includes the M(T2)(b)l variable [9]. In analyses that use the M-CT. family of kinematical discriminants we use MctLib [10,11] which also includes the M-CT perpendicular to and Mall variables [12]. All experimental analyses that were used to set limits in the study. The Monte Carlo event generator that was used. Running time: The running time scales about linearly with the number of input events provided by the user. The detector simulation/analysis of 20000 events needs about 50s/ls for a single core calculation on an Intel Core i5-3470 with 3.2 GHz and 8 GB RAM. (C) 2015 Elsevier B.V. All rights reserved.