= '''Standard Model Effective Field Theory  -- The SMEFTsim package''' =

== Authors ==

Ilaria Brivio, Yun Jiang and Michael Trott

{{{
ilaria.brivio@nbi.ku.dk, yunjiang@nbi.ku.dk, michael.trott@cern.ch
}}}

''NBIA and Discovery Center, Niels Bohr Institute, University of Copenhagen''

----

== The model description ==


The Standard Model Effective Field Theory (SMEFT) is constructed out of a series of SU(3),,C,, × SU(2),,L,, × U(1),,Y,, invariant higher dimensional operators L^(6)^, L^(7)^, ... built out of the SM fields.[[BR]]
The SMEFTsim package provides a complete implementation of the lepton and baryon number conserving dimension-6 Lagrangian adopting the Warsaw basis [https://arxiv.org/abs/1008.4884/ arXiv:1008.4884][[BR]]
The [http://feynrules.irmp.ucl.ac.be/wiki/StandardModel/ SM Lagrangian] is included and extended with the SM loop-induced  Higgs couplings to gg, γγ and Zγ. [[BR]]


The SMEFTsim package provides implementations for 3 different flavor symmetry assumptions and 2 input scheme choices.

The flavor symmetry assumptions adopted are (see [https://arxiv.org/abs/1709.06492/ arXiv:1709.06492] for a detailed description)
* The flavour general case
* The U(3)^5^ flavor symmetric case, with non-SM CP-violating phases
* A linear Minimal flavor violation (MFV) ansatz [https://arxiv.org/abs/hep-ph/0207036/ arXiv:0207036], in which non-SM CP-violating effects are neglected, but linear flavor-violating spurion insertions are allowed in quark currents

For each model it is free to choose between two input parameters sets for the electroweak sector, namely:
* α scheme: {α,,ew,,, m,,Z,, , G,,f,,} 
* m,,W,, scheme: {m,,W,,, m,,Z,, , G,,f,,} 

Importantly, field rotations required to have canonically normalized kinetic terms and parameter redefinitions following from the choice of an input parameters set are automatically applied in the Lagrangian.

Two independent models sets (A and B) are supplied. Each set contains a main file, a number of subroutines and restriction files. 
The two sets differ in the structure and in the technical implementation of L^(6)^, but they produce consistent results. The use of both sets is recommended for debugging and validation of the numerical results.[[BR]]
Pre-exported UFO files to be interfaced with MadGraph5_aMC@NLO can also be downloaded from this page (see Table below).


We would appreciate if you could report to us any inconsistency or bugs. 


'''Usage recommendations'''

The SMEFTsim package is designed to enable numerical studies of the LO interference of the SMEFT with the SM, while neglecting NLO corrections.
In this spirit, it has not been optimized for loop calculations in the SM or in the SMEFT. In particular:

* the Lagrangian assumes unitary gauge. Using it in R,,ξ,, or Feynman gauge may lead to inconsistent results, as the ghost Lagrangian has not been modified to account for L^(6)^ corrections.

* the UFO files are not equipped for NLO evaluation in MadGraph5_aMC@NLO


== Change log ==

v1.0 (20.09.2017) The first version released

v1.1 (20.10.2017) model set A 
                  - restriction cards topEFT added to each UFO and to the FeynRules source. They assume massless light fermions and set to 0 coefficients that are not relevant for top quark physics.
                  - bug with operators Q,,Hu,,, Q,,Hd,,, Q,,Hud,,, Q,,Hq,,^1^, Q,,Hq,,^3^ in the MFV UFO models fixed.

== References ==

* I. Brivio, Y. Jiang and M. Trott, ''The SMEFTsim package, theory and tools'', [https://arxiv.org/abs/1709.06492/ arXiv:1709.06492]

----

'''Model Set A'''

* [attachment:"SMEFTsim-setA.zip"] This archive contains all the FeynRules files.
* [attachment:"SMEFTsim-setA.nb"] Example of a Mathematica® notebook loading the model

'''Model Set B''

In the master code two flags are established: __Scheme__ and __Flavor__, which are used to identify the input scheme and flavor assumption being adopted in loading the model.

* [attachment:"SMEFTsim-setB.zip"] This archive contains all the model files. Should be expanded in the FR model directory. 
* [attachment:"SMEFTsim-setB.nb"] Example of a Mathematica® notebook loading the model. Should be stored in the SMEFTsim-setB model folder. 

----

== Pre-exported UFO files (include restriction cards) ==
 
||                          ||    Set A  ||  || Set B || ||
||   ||  α scheme || m,,W,, scheme ||  α scheme || m,,W,, scheme ||
|| Flavor general SMEFT  || [attachment:"SMEFTsim_A_general_alphaScheme_UFO.tar.gz"] || [attachment:"SMEFTsim_A_general_MwScheme_UFO.tar.gz"] || [attachment:"SMEFT_alpha_UFO.zip"] || [attachment:"SMEFT_mW_UFO.zip"] ||                            
|| MFV  SMEFT       || [attachment:"SMEFTsim_A_MFV_alphaScheme_UFO.tar.gz"] || [attachment:"SMEFTsim_A_MFV_MwScheme_UFO.tar.gz"] || [attachment:"SMEFT_alpha_MFV_UFO.zip"]  || [attachment:"SMEFT_mW_MFV_UFO.zip"] ||
|| U(3)^5^ SMEFT     || [attachment:"SMEFTsim_A_U35_alphaScheme_UFO.tar.gz"] || [attachment:"SMEFTsim_A_U35_MwScheme_UFO.tar.gz"] || [attachment:"SMEFT_alpha_FLU_UFO.zip"]  || [attachment:"SMEFT_mW_FLU_UFO.zip"] ||