search

wzeren / Displaced-Decay-Counter

Computes the predicted signal event numbers at different detectors for various colliders
https://wzeren.github.io/Displaced-Decay-Counter/
MIT License
5 stars 1 forks source link

readme

DDC: Displaced Decay Counter

By Florian Domingo, Julian Günther, Jong Soo Kim, and Zeren Simon Wang

arXiv license

Introduction

We develop a tool Displaced Decay Counter, DDC, for estimating the signal-event rates of different LLP models at various LHC far detectors. The input files can be LHEF, HepMC, or a CMND run card for Pythia8. It can be easily generalized to the cases of other collider types and detectors. One can also implement new detector's geometries in a straightforward manner into the code.

Paper

An accompanying paper of this tool can be accessed at arXiv. Any user of the tool is strongly suggested to read the paper carefully first, before starting to test the tool.

Compilation

The code is written in C++. There is a Makefile. In the first lines of Makefile, put in the path to your own Pythia8 and HepMC2 installation. Pythia8 should have been compiled with a link to zlib, in order to allow for reading *.lhe.gz files. If you do not use zlib, remove "-lz" in the line starting with "LDFLAGS". Run "make -jN" in the terminal to compile, where N is the number of CPU cores you want to use.

Run the program

One needs to run the program "main" within the folder "bin", with "./main" followed by arguments.

Relevant files for the benchmark models

We provide the input files, Python plotting scripts, the final sensitivity plots, as well as the data points, of the theoretical benchmark models considered in the paper, collectively in the folder "examples". If you want to test these examples, please do not forget to modify certain information in the input files, such as "input_file_path" in the "...Events.dat" files.

Doxygen documentation

An updated Doxygen documentation of the code can be accessed at doxygen.

New detector implementations

You are most welcome to submit a new detector implementation to this repository!

Questions and bug reports

If you have any questions, or would like to report any bug, you are welcome to write to any of us: