Skip to content

ro-sanda/Z--explorer-2.0

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 

Repository files navigation

A QUICK START USER GUIDE

Víctor Martín Lozano, Rosa María Sandá Seoane, José Zurita

SET UP

Download main directory /Z'-explorer-2.0/ into your system. To start, set on /lib/ folder and run make. No additional steps are required.

The script runs in C++.

If changes in source code are done, set on /lib/ folder again and repeat the above before running.

SET MODEL:

Information about the Z' model must be provided through an incard text file, that must be stored as /incard/card_1.dat. For each benchmark point in the New Physics parameter space, the following information must be provided in columns (separated by spaces, no tabs):

MZ'  guL guR  gdL  gdR  gcL  gcR  gsL  gsR  gbL  gbR  gtL  gtR  geL  geR  gμL  gμR  gτL  gτR  Γνν  Γww  ΓZh mχ gχL gχR Γxx

where MZ' is the Z' mass (in TeV), gfL/R is the Z' coupling to the corresponding Left/Right visible fermion, and Γνν, Γww, ΓZh are the partial widths to neutrinos, WW and Zh, and is the fermionic DM mass (and gχL/R its Left/Right coupling to Z'). The total width to other non-SM particles can be added as Γxx. If not, leave Γxx as 0.

Every benchmark point in parameter space should be set in a different row. There is no limit in the number of signal points (i.e. rows) that can be explored.

In /incard/example/ATLAS-DM-Simplified-VEC-gq=0.25-gx=1 can be found an incard example for the vector mediator case presented in ATLAS results (arXiv:2102.10874) to perform a test run and check the output card which will be placed at /output/1.dat .

RUN

After providing an incard, set on the main directory and enter ./program.out .

EXPLORATION RESULTS:

The generated output file is saved in /output/1.dat . The output contains the following information for each benchmark point set in incard:

MZ'  guL guR  gdL  gdR  gcL  gcR  gsL  gsR  gbL  gbR  gtL  gtR  geL  geR  gμL  gμR  gτL  gτR  Γνν  Γww  ΓZh mχ gχL gχR Γxx  Sjj  Sbb  Stt  See  Sμμ  Sττ  Sνν  SWW  SZh  Sχχ Sxx   ΓZ'   WARNING:ΓZ'>5%

where S (defined as σpredlim) is the strength of the signal in each possible Z' decay channel, ΓZ' is the Z' total width and the warning displays 1 when ΓZ'>5% and 0 otherwise.

More information about calculation can be found in /extra/ folder:

  • 2.dat contains the estimated decay widths to all channels.
  • 3.dat contains the estimated branching ratios to all channels.
  • 4.dat contains the estimated σpred for visible channels.
  • 5.dat contains the extracted σlim from experimental data for visible channels.

EXPERIMENTAL INFORMATION:

For visible channels:

Available experimental data from LHC to all possible Z' decay channels is stored in /cards/ folder as experimental cards. Data is specified in two columns, where the first one is the corresponding MZ' (in TeV) and the second one is the corresponding σlim (in pb):

User can update the experimental information just by replacing the corresponding experimental card. No other step is required.

For invisible channels:

  • exp_card_7.dat-> νν -
  • exp_card_10.dat-> xx -

Note that Sνν and Sxx in /output/1.dat are left as dummy variables for future updates.

For the Dirac DM (χχ) channel, in /cards/ folder also can be found

Data is specified in three columns in this case, where the first one is the corresponding MZ' (in TeV), the second one is the corresponding mχ (in TeV), and the third one is the σlim (in pb). In this particular case, results are set for the leptophobic axial-vector mediator case with gq=0.25 and gχ=1 (as in ATLAS results in 2102.10874), so bounds are properly re-scale during program execution for arbitrary coupling structure.

RECORDED SIMULATIONS USED BY Z'-EXPLORER:

For visible channels:

For computing Z' production cross-section, previously generated and recorded production cross-section with MadGraph5_aMC@NLO (arXiv:1405.0301) is stored in /cards/ folder as simulation cards. These simulations were generated with a tailored Z' model which couples with unity to only one quark in the proton each time, at √ s = 13 TeV, and for MZ' between 0.4 and 8 TeV (the range of masses that can be scanned with Z'-explorer).

  • sim_card_1.dat-> uuZ'
  • sim_card_2.dat-> ddZ'
  • sim_card_3.dat-> ccZ'
  • sim_card_4.dat-> ssZ'
  • sim_card_5.dat-> bbZ'

These simulations are combined with the incard data to calculate σpred for visible channels.

For invisible χχ channel:

In this case, since this channel is associated with the mono-jet search, for computing Z' production cross-section, previously generated and recorded production cross-section plus ISR with MadGraph5_aMC@NLO is stored in /cards/ folder, also as simulation cards. These simulations were generated with a tailored Z' model which couples with unity to only one quark in the proton each time, at √ s = 13 TeV, and for MZ' between 0.001 and 2.5 TeV (the range of masses that are explored in the mono-jet results), for the vector and the axial-vector mediators cases.

  • AXIAL_Zpj_1.dat-> ppZ'A j

  • AXIAL_Zpj_2.dat-> ppZ'A j

  • AXIAL_Zpj_3.dat-> ppZ'A j

  • AXIAL_Zpj_4.dat-> ppZ'A j

  • VEC_Zpj_1.dat-> ppZ'V j

  • VEC_Zpj_2.dat-> ppZ'V j

  • VEC_Zpj_3.dat-> ppZ'V j

  • VEC_Zpj_4.dat-> ppZ'V j

These simulations are combined with the incard data and properly turn into right and left chiralities contributions to calculate σpred for χχ channel.

For more information, please visit the associated publication "Z'-explorer 2.0: reconnoitering the dark matter landscape".

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published