Pheno

This is the program used for the collider analysis in "Exotic Lepton-Flavor Violating Higgs Decays" project.

Info

Exotic Lepton-Flavor Violating Higgs Decays\ Jared A. Evans, Philip Tanedo, and Mohammadreza Zakeri\ http://arxiv.org/abs/arXiv:1910.07533\

If you use this package please cite: Mohammadreza Zakeri. (2020, January 9). ZAKI1905/Pheno v1.0.1 (Version v1.0.1). Zenodo. http://doi.org/10.5281/zenodo.3603138

For BibTeX style citation use: @software{mohammadreza_zakeri_2019_3482349, author = {Mohammadreza Zakeri}, title = {ZAKI1905/Pheno: Beta-Release}, month = oct, year = 2019, publisher = {Zenodo}, version = {v1.0.0-beta}, doi = {10.5281/zenodo.3482349}, url = {https://doi.org/10.5281/zenodo.3482349} }

-Last updated January 3, 2020

Python Modules

You can setup the python program following these steps: 1. Add the C++ pythia script file into "~/main/" 2. Compile the C++ pythia script following the procedure below 3. Move your model file ("UFO") inside "~/python/ModelFiles/" 4. Edit "~/python/interface.py" to input a new channel, and define the directories for MadGraph, etc. 5. Edit "~/python/runpar.py" for changing the MadGraph run parameters. 6. You can also edit the work directory, and other settings in "~/python/pheno.py"

You can then run the program by running "python ~/python/pheno.py"

Compiling the C++ files

To make the binary files: 1. Choose the main c++ file (which is inside "~/main") to be compiled, by typing it in front of "MAIN" & "LINK_TARGET" in the make file. 2. Run "make"

For makefile help run: "make help"

Running the C++ binaries (stand-alone)

You can also run the C++ binaries by themselves, if you already have lhe files and want to run pythia and fastjet.

To run the binaries: 1. Put the LHE file(s) in the desired directory, with the following naming scheme: {"XYZ0.lhe", "XYZ1.lhe", "XYZ2.lhe", ...} where all "XYZ.lhe" files are from the same process, but chopped for parallel computing by OMP. Note: If there is only one LHE file, still add "0.lhe" to its name.

Step 2 depends on the main c++ file format, for the ones inside "~/main" do

1. run ./bin/[BINARY] [LHE_FILE] [NUM_EVENTS] [OMP_THREADS] [REPORT_BOOL] where:

   "BINARY" stands for the name of the binary file (inside ~/bin) "LHEFILE" is the path+name of the LHE file compared to the current path in terminal Note that the extra extensions {"0", "_1", ...} should be omitted.

   "NUMEVENTS" is the number of events in the LHE file "OMPTHREADS" is the number of threads to be requested from OMP "REPORT_BOOL" can be '0' (no cut, etc. reporting) or '1' (reports cuts, etc. in .txt files)

Example: run ./bin/cms_8TeV lhe_dir/my_model.lhe 1000 2 0 in terminal, where the lhedir contains 2 lhe files each having 500 events named as: {mymodel0.lhe, mymodel_1.lhe}

To add your own main c++ file: 1. write a c++ file with a main() function and put it inside "~/main". 2. Add the name of the main file in the make file for compiling. 3. Compile using "make" command 4. A binary with the same name will be created inside "~/bin" 5. Run as explained above.

References

This package uses PYTHIA-8 and FastJet.

PYTHIA-8: - T. Sjöstrand, S. Mrenna and P. Skands, JHEP05 (2006) 026, Comput. Phys. Comm. 178 (2008) 852.

FastJet: - M. Cacciari, G.P. Salam and G. Soyez, Eur.Phys.J. C72 (2012) 1896 [arXiv:1111.6097].