BSM BeamDump
Set of Mathematica code for generating cross sections involving BSM particle production at a high-energy beam dump.
Setup
Mathematica Setup
The generation of FeynArts and UFO files from the FeynRules .fr
file included in FeynRules/models/
is automated in FeynRules/model_generation/feynrules_to_models.nb
, and is designed with user-specified directories for Mathematica, FeynArts, and MadGraph5 in mind. In order use the automated setup, you will need to change The following directories to directories associated with your machine:
* The directories specified in setup/directories.m
in the "User-Specific Directories" section;
* the path Path/To/setup/directories.m
at the top of FeynRules/model_generation/feynrules_to_models.nb
(and similarly for the FeynArts/FeynCalc calculations in the calculations
folder, if you wish to use them);
* the path Path/To/FeynRules/UFO_output/combined_beamdump/vertices.py
in FeynRules/model_generation/add_formfactors_UFO_vertices.py
.
Generating Models
In order to generate the models we use for our beam dump analyses, simply run the notebook FeynRules/feynrules_to_models.nb
(after setting up the directories you are using in setup/directories.m
). This notebook uses the model combined_beamdump.fr
in the Feynrules/models/
folder to generate FeynArts and UFO files for use in computations; it also moves them to the FeynArts and MG5 directories designed for model storage automatically.
Additional Setup
If you want to use the UFO model files generated by FeynRules/feynrules_to_models.nb
in conjunction with MadGraph5 -- the relevant UFO files are moved to the specified MadGraph5 directories automatically -- you will need to convert the model from the default python2 format to the python3 format used by the most recent version of MadGraph5. I find it easiest to allow MadGraph to take care of this automatically:
./Path/to/MadGraph5/bin/mg5_aMC
set auto_convert_model True
Usage
Usage in FeynArts
- Folder
- Loading
- Computations
- Examples
Usage in MadGraph
- Folder
- Loading
- Examples
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.