Commit 0eee2698 authored by ulrich_y's avatar ulrich_y
Browse files

Added bare document

parent e2ae7b7c
%!TEX root=manual
% Packages
\usepackage[svgnames,x11names]{xcolor}
\definecolor{lightgray}{HTML}{D5D5D5}
\definecolor{lightergray}{HTML}{EEEEEE}
\usepackage[numbers,sort&compress]{natbib}
\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{upgreek}
\usepackage{bbm}
\usepackage{slashed}
\usepackage[T1]{fontenc}
\usepackage{multirow}
\usepackage[caption=false]{subfig}
\usepackage{mcmule}
\usepackage{longtable}
\usepackage{etoolbox}
\usepackage[procnames]{listings}
\usepackage{xcolor}
\usepackage{textcomp}
\lstset{upquote=true}
\lstset{language=[90]Fortran,
basicstyle=\ttfamily,
keywordstyle=\color{Aquamarine4},
numberstyle=\color{DarkOrange},
stringstyle=\color{SkyBlue4},
commentstyle=\color{Blue2},
morecomment=[l]{!\ },% Comment only with space after !
escapeinside={(*@}{@*)},
breaklines=true,
postbreak=\mbox{\textcolor{red}{$\hookrightarrow$}\space},
}
\lstdefinelanguage{vim}{
% list of keywords
morekeywords={
set, let
map, nmap,
filetype,
on, off,
autocmd,
Plugin,
call,
},
morecomment=[l]{"}, % l is for line comment
morestring=[b]' % defines that strings are enclosed in double quotes
}
\lstdefinelanguage{docker}{
keywords={FROM, RUN, COPY, ADD, ENTRYPOINT, CMD, ENV, ARG, WORKDIR, EXPOSE, LABEL, USER, VOLUME, STOPSIGNAL, ONBUILD, MAINTAINER},
%keywordstyle=\color{blue}\bfseries,
%identifierstyle=\color{black},
sensitive=false,
comment=[l]{\#},
%commentstyle=\color{purple}\ttfamily,
%stringstyle=\color{red}\ttfamily,
morestring=[b]',
morestring=[b]"
}
\lstdefinelanguage{makefile}{
morekeywords={include},
keywordstyle=\color{SkyBlue4},
sensitive=false,
literate=*{\ @}{{\textcolor{Purple1}{\ @}}}2
{\\} {{\textcolor{Purple1}{\textbackslash}}}1
{$<} {{\textcolor{Aquamarine4}{\$<}}}2
{$@} {{\textcolor{Aquamarine4}{\$@}}}2
{$^} {{\textcolor{Aquamarine4}{\$\^{}}}}2,
moredelim=*[s][\color{Aquamarine4}]{\$(}{)},
moredelim=[is][\color{Aquamarine4}]{/*}{*/},
moredelim=[is][\color{DarkOrange}]{/+}{+/}
}%stopzone
\usepackage[colorlinks=true
,urlcolor=blue
,anchorcolor=blue
,citecolor=blue
,filecolor=blue
,linkcolor=blue
,menucolor=blue
,linktocpage=true
,pdfproducer=medialab
]{hyperref}
% TikZ
\usepackage{tikz}
\usetikzlibrary{decorations.pathmorphing,positioning,decorations.pathreplacing,shapes,calc}
\usetikzlibrary{decorations.pathreplacing}
\usetikzlibrary{decorations.markings}
\usetikzlibrary{arrows}
\usetikzlibrary{calc}
\newcommand{\midarrow}{\tikz \draw[-triangle 45] (0,0) -- +(0.1,0);}
\tikzset{
photon/.style={decorate, decoration={snake,amplitude=1pt,segment length=6pt}},
zigzag it/.style={decorate, decoration=zigzag},
gluon/.style={decorate, draw=black,decoration={coil,amplitude=4pt, segment length=5pt}},
tightgluon/.style={decorate, draw=black,decoration={coil,amplitude=2pt, segment length=3pt}},
fermion/.style={postaction={decorate},
decoration={markings,mark=at position .55 with {\arrow{>}}}},
antifermion/.style={postaction={decorate},
decoration={markings,mark=at position .55 with {\arrow{<}}}},
% style to apply some styles to each segment of a path
on each segment/.style={
decorate,
decoration={
show path construction,
moveto code={},
lineto code={
\path [#1]
(\tikzinputsegmentfirst) -- (\tikzinputsegmentlast);
},
curveto code={
\path [#1] (\tikzinputsegmentfirst)
.. controls
(\tikzinputsegmentsupporta) and (\tikzinputsegmentsupportb)
..
(\tikzinputsegmentlast);
},
closepath code={
\path [#1]
(\tikzinputsegmentfirst) -- (\tikzinputsegmentlast);
},
},
},
% style to add an arrow in the middle of a path
mid arrow/.style={postaction={decorate,decoration={
markings,
mark=at position .5 with {\arrow[#1]{stealth}}
}}},
mfermion/.style={postaction={on each segment={mid arrow=black}}}
}
\def\centerarc[#1](#2,#3)(#4:#5:#6)% Syntax: [draw options] (center) (initial angle:final angle:radius)
{ \draw[#1] ({#2+#6*cos(#4)},{#3+#6*sin(#4)}) arc (#4:#5:#6); }
\newcommand\drawarrow[1]{
\draw ( #1 ) --+ (-0.25, 0) --+
(-0.25,-1 ) --+ (-0.5 ,-1) --+
( 0 ,-1.5) --+ ( 0.5 ,-1) --+
( 0.25,-1 ) --+ ( 0.25, 0) --+ (0,0);
}
% Dir tree
\usepackage{enumitem}
\makeatletter
\newcommand{\gettikzxy}[3]{%
\tikz@scan@one@point\pgfutil@firstofone#1\relax
\edef#2{\the\pgf@x}%
\edef#3{\the\pgf@y}%
}
\newdimen\yzero
\yzero = 0pt
\newlist{treelist}{itemize}{5}
\setlist[treelist]{label=\treelist@label}
\tikzset{treelist line/.style={thick, line cap=round, rounded corners}}
\def\treelist@label{%
\begin{tikzpicture}[remember picture, baseline={([yshift=-.6ex] treelist-bullet-\the\enit@depth.center)}]
\draw [treelist line] (0, 0) -- node (treelist-bullet-\the\enit@depth) {} ++(.5em, 0);
\end{tikzpicture}%
\ifnum\enit@depth>1
\tikz[remember picture, overlay] {
\tikz@scan@one@point\pgfutil@firstofone(treelist-bullet-\the\numexpr\enit@depth-1\relax.center)\relax
\ifdim\the\pgf@y>\yzero\relax
\draw [treelist line] (treelist-bullet-\the\numexpr\enit@depth-1\relax.center)
|- (treelist-bullet-\the\enit@depth.center);
\else
\gettikzxy{(treelist-bullet-\the\numexpr\enit@depth-1\relax.center)}{\bx}{\by}
\gettikzxy{(current page.north west)}{\ax}{\ay}
\draw [treelist line] (\bx,\ay)
|- (treelist-bullet-\the\enit@depth.center);
\fi
}
\fi
}
\makeatother
% Macros
\def\alphapi{\Big(\frac\alpha\pi\Big)}
\def\I{\mathrm{i}}
\def\D{\mathrm{d}}
\def\E{\mathrm{e}}
\def\tr{\mathrm{tr}}
\newcommand{\sg}[1]{#1_{[{\rm dim}]}}
\newcommand{\s}[2]{#2_{[#1]}}
\newcommand{\sd}[1]{#1_{[d]}}
\newcommand{\sds}[1]{#1_{[d_s]}}
\newcommand{\se}[1]{#1_{[n_\epsilon]}}
\newcommand{\sm}[1]{#1_{[-2\epsilon]}}
\def\neps{n_\epsilon}
\def\Sf{{\rm S}_{[4]}}
\def\QSs{{\rm QS}_{[d_s]}}
\def\QSd{{\rm QS}_{[d]}}
\def\QSe{{\rm QS}_{[n_\epsilon]}}
\def\QSm{{\rm QS}_{[-2\epsilon]}}
\def\cdr{\textsc{cdr}}
\def\fdh{\textsc{fdh}}
\def\fdf{\textsc{fdf}}
\def\hv{\textsc{hv}}
\def\dred{\textsc{dred}}
\def\dreg{\textsc{dreg}}
\def\rs{\textsc{rs}}
\def\BM{\textsc{bm}}
\def\AC{\textsc{ac}}
\def\MS{\overline{\text{MS}}}
\def\neqcd{$\neps\mathrm{QCD}$}
\def\neqed{$\neps\mathrm{QED}$}
\def\mev{{\rm MeV}}
\def\gev{{\rm GeV}}
\newcommand{\Einv}{E\hspace*{-6pt}/}
\newcommand{\Zjet}{Z_{q}}
\newcommand{\Zantijet}{\bar{Z}_{q}}
\newcommand{\den}[1]{\mathcal{D}_{#1}}
\renewcommand{\binom}[2]{\bigg(\genfrac{}{}{0pt}{0}{#1}{#2}\bigg)}
\newcommand{\mbinom}[2]{\bigg(\!\!\bigg(\genfrac{}{}{0pt}{0}{#1}{#2}\bigg)\!\!\bigg)}
\newcommand{\bit}[1]{\D\sigma^{(#1)}}
\newcommand{\bbit}[2]{\D\sigma^{(#1)}_{#2}}
\newcommand{\M}[2]{\mathcal{M}_{#1}^{(#2)}}
\newcommand{\fM}[2]{\mathcal{M}_{#1}^{(#2)f}}
\newcommand{\tM}[2]{\tilde{\mathcal{M}}_{#1}^{(#2)}}
\newcommand{\CT}[3]{\hat{\mathcal{S}}_{#1}(\M{#2}{#3})}
\newcommand\eik{\mathcal{E}}
\newcommand\ieik{\hat{\mathcal{E}}}
\def\xc{\xi_{c}}
\newcommand{\cdis}[2][c]{\left(\frac{1}{#2}\right)_{\hspace*{-3pt}#1}}
\newcommand{\cdisf}[2][\text{cut}]{\left(#2\right)_{#1}}
\newcommand{\A}[1]{\mathcal{A}^{(#1)}}
\newcommand{\dZ}[2][i]{\delta Z_{#1}^{(#2)}}
\newcommand{\Amp}[2]{\mathcal{A}_{#1}^{(#2)}}
\newcommand{\Al}[3]{\mathcal{A}_{#1,#2}^{(#3)}}
\newcommand{\Ah}[4]{\mathcal{A}_{#1,#2,#4}^{(#3)}}
\newcommand{\cA}{{\cal A}}
\def\pref#1{%
\ifnum0<0#1\relax
\newcount\foo%
\foo=0%
\loop
\advance\foo +1
\D\Upsilon_{\the\foo}
\ifnum\foo<#1
\repeat
\else
\prod_{i=1}^{#1}\D\Upsilon_i
\fi
\D \Phi_{n,#1}
}
\def\io{{\rm i0}^+}
\makeatletter
\def\thickhline{%
\noalign{\ifnum0=`}\fi\hrule \@height \thickarrayrulewidth \futurelet
\reserved@a\@xthickhline}
\def\@xthickhline{\ifx\reserved@a\thickhline
\vskip\doublerulesep
\vskip-\thickarrayrulewidth
\fi
\ifnum0=`{\fi}}
\makeatother
\newlength{\thickarrayrulewidth}
\setlength{\thickarrayrulewidth}{2\arrayrulewidth}
\setcounter{topnumber}{1}
\textheight=22.truecm
\textwidth=16.0truecm
\addtolength{\hoffset}{-1.2cm}
\addtolength{\voffset}{-1.5cm}
\setlength{\skip\footins}{20pt}
\footnotesep=10pt
\usepackage[auth-sc,affil-it]{authblk}
\newcommand*\samethanks[1][\value{footnote}]{\footnotemark[#1]}
\renewcommand\Authsep{, }
\renewcommand\Authand{, }
\renewcommand\Authands{, }
\newcommand\ac[1]{#1}
\newcommand\term[1]{#1}
\newcommand\aterm[2]{#1 (#2)}
\documentclass[11pt,a4paper]{article}
\input{headers}
\title{\mcmule{} manual}
\author[a ]{P.\,Banerjee\thanks{Member of the MMCT}}
\author[a,b ]{A.\,Gurgone}
\author[a,c ]{T.\,Engel\samethanks}
\author[a,d ]{\\N.\,Schalch}
\author[a,c ]{A.\,Signer\samethanks}
\author[a,c ]{Y.\,Ulrich\samethanks\thanks{Maintainer}}
\affil[a]{Paul Scherrer Institut, CH-5232 Villigen PSI, Switzerland}
\affil[b]{Universit\`a di Pisa, I-56100 Pisa, Italy}
\affil[c]{Physik-Institut, Universit\"at Z\"urich, Winterthurerstrasse 190, CH-8057 Z\"urich, Switzerland}
\affil[d]{ETH Z\"urich, Switzerland}
\begin{document}
\thispagestyle{empty}
\makeatletter
{\renewenvironment{tabular}[2][]{\begin{center}}
{\end{center}}
\begin{center}
\mcmulelogo
{\Large\bf \@title}
\vspace{1em}
{\sc The McMule Team}
\end{center}
\@author
\@thanks
\reset@font}
\vspace{1ex}
\makeatother
\begin{abstract}
\mcmule{} is a generic framework for higher-order QED calculations of
scattering and decay processes involving leptons. In this note we
describe all relevant details of the implementation and provide very
detailed instructions for running and analysing with
\mcmule{}.
{\noindent\it Author's note: please also refer to the official \mcmule{}
publication~\cite{Banerjee:mcmule} as well as the doctoral thesis it
is based on~\cite{Ulrich:2020phd} for detailed background information.}
\end{abstract}
\bibliographystyle{JHEP}
\bibliography{reference}
\end{document}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Background tools
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@article{Gomes:2017hct,
author = "Gomes, Jorge and Bagnaschi, Emanuele and Campos, Isabel
and David, Mario and Alves, Lu\'{i}s and Martins, Jo\~{a}o
and Pina, Jo\~{a}o and L\'{o}pez-Garc\'{i}a, Alvaro and Orviz,
Pablo",
title = "{Enabling rootless Linux Containers in multi-user environments: the $udocker$ tool}",
eprint = "1711.01758",
archivePrefix = "arXiv",
primaryClass = "cs.SE",
reportNumber = "DESY-17-096",
doi = "10.1016/j.cpc.2018.05.021",
journal = "Comput. Phys. Commun.",
volume = "232",
pages = "84--97",
year = "2018"
}
@article{Hunter:2007mp,
author = {Hunter, John D.},
title = {Matplotlib: A 2D Graphics Environment},
journal = {Computing in Science \& Engineering},
volume = {9},
number = {3},
pages = {90-95},
year = {2007},
doi = {10.1109/MCSE.2007.55}
}
@article{Merkel:2014,
author = {Merkel, Dirk},
title = {Docker: Lightweight Linux Containers for Consistent Development and Deployment},
year = {2014},
issue_date = {March 2014},
publisher = {Belltown Media},
address = {Houston, TX},
volume = {2014},
number = {239},
issn = {1075-3583},
journal = {Linux J.},
month = mar,
articleno = {2},
numpages = {1}
}
@article{Perez:2007ip,
author = {P{\'e}rez, Fernando and Granger, Brian E.},
title = {{IPython: A System for Interactive Scientific Computing}},
journal = {Computing in Science \& Engineering},
volume = {9},
number = {3},
pages = {21-29},
year = {2007},
doi = {10.1109/MCSE.2007.53}
}
@article{Walt:2011np,
author = {Walt, St{\'e}fan van der and Colbert, S. Chris and Varoquaux,Ga{\"e}l },
title = {The NumPy Array: A Structure for Efficient Numerical Computation},
journal = {Computing in Science \& Engineering},
volume = {13},
number = {2},
pages = {22-30},
year = {2011},
doi = {10.1109/MCSE.2011.37}
}
@InProceedings{Yoo:2003slurm,
author = "Yoo, Andy B. and Jette, Morris A. and Grondona, Mark",
title = {"SLURM: Simple Linux Utility for Resource Management"},
booktitle = {"Job Scheduling Strategies for Parallel Processing"},
year = {"2003"},
publisher = "Springer Berlin Heidelberg",
address = "Berlin, Heidelberg",
pages = "44--60",
isbn = "978-3-540-39727-4"
}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Other software
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@article{Denner:2016kdg,
author = "Denner, Ansgar and Dittmaier, Stefan and Hofer, Lars",
title = "{Collier: a fortran-based Complex One-Loop LIbrary in
Extended Regularizations}",
journal = "Comput. Phys. Commun.",
volume = "212",
year = "2017",
pages = "220-238",
doi = "10.1016/j.cpc.2016.10.013",
eprint = "1604.06792",
archivePrefix = "arXiv",
primaryClass = "hep-ph",
reportNumber = "FR-PHENO-2016-003, ICCUB-16-016",
}
@article{Lepage:1980jk,
author = {Lepage, G. Peter},
month = {Mar},
reportnumber = {CLNS-80/447},
slaccitation = {%%CITATION = CLNS-80/447 ETC.;%%},
title = {{VEGAS}: AN ADAPTIVE MULTIDIMENSIONAL INTEGRATION PROGRAM},
year = {1980}
}
@article{Patel:2015tea,
author = {Patel, Hiren H.},
doi = {10.1016/j.cpc.2015.08.017},
eprint = {1503.01469},
journal = {Comput. Phys. Commun.},
pages = {276-290},
primaryClass = {hep-ph},
archivePrefix = "arXiv",
title = {{Package-X: A Mathematica package for the analytic calculation of one-loop integrals}},
volume = {197},
year = {2015}
}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Applications of McMule
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@article{Pruna:2016spf,
archivePrefix = {arXiv},
author = {Pruna, G. M. and Signer, A. and Ulrich, Y.},
doi = {10.1016/j.physletb.2016.12.039},
eprint = {1611.03617},
journal = {Phys. Lett.},
pages = {280-284},
primaryClass = {hep-ph},
reportnumber = {PSI-PR-16-14, ZU-TH-41-16},
title = {{Fully differential NLO predictions for the rare muon decay}},
volume = {B765},
year = {2017}
}
@article{Pruna:2017upz,
archivePrefix = {arXiv},
author = {Pruna, G. M. and Signer, A. and Ulrich, Y.},
doi = {10.1016/j.physletb.2017.07.008},
eprint = {1705.03782},
journal = {Phys. Lett.},
pages = {452-458},
primaryClass = {hep-ph},
reportnumber = {PSI-PR-17-07, ZU-TH-11-17},
title = {{Fully differential NLO predictions for the radiative decay of muons and taus}},
volume = {B772},
year = {2017}
}
@article{Ulrich:2017adq,
author = "Ulrich, Y.",
title = "{Fully differential NLO predictions for rare and radiative lepton decays}",
booktitle = "{Proceedings, 2017 International Workshop on Neutrinos
from Accelerators (NuFact17): Uppsala University Main
Building, Uppsala, Sweden, September 25-30, 2017}",
journal = "PoS",
volume = "NuFact2017",
year = "2018",
pages = "124",
doi = "10.22323/1.295.0124",
eprint = "1712.05633",
archivePrefix = "arXiv",
primaryClass = "hep-ph",
reportNumber = "PSI-PR-17-20",
}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% teachnical background reading
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@article{Gkioulekas:2018,
author = {Eleftherios Gkioulekas},
title = {Using restrictions to accept or reject solutions of radical equations},
journal = {Int. J. of Mathematical Education in Science and Technology},
volume = {49},
number = {8},
pages = {1278-1292},
year = {2018},
publisher = {Taylor \& Francis},
doi = {10.1080/0020739X.2018.1458341},
}
@article {Marsaglia25,
author = {Marsaglia, George},
title = {RANDOM NUMBERS FALL MAINLY IN THE PLANES},
volume = {61},
number = {1},
pages = {25--28},
year = {1968},
doi = {10.1073/pnas.61.1.25},
publisher = {National Academy of Sciences},
issn = {0027-8424},
uRL = {https://www.pnas.org/content/61/1/25},
eprint = {https://www.pnas.org/content/61/1/25.full.pdf},
journal = {Proceedings of the National Academy of Sciences}
}
@article{Park:1988RNG,
author = {Park, S. K. and Miller, K. W.},
title = {{Random Number Generators: Good Ones Are Hard to Find}},
journal = {Commun. ACM},
issue_date = {Oct. 1988},
volume = {31},
number = {10},
month = oct,
year = {1988},
issn = {0001-0782},
pages = {1192--1201},
numpages = {10},
url = {http://doi.acm.org/10.1145/63039.63042},
doi = {10.1145/63039.63042},
acmid = {63042},
publisher = {ACM},
address = {New York, NY, USA}
}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Theoretical background reading
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@article{Banerjee:mcmule,
author = "Banerjee, P. and Engel, T. and Signer, A. and Ulrich, Y",
title = "{QED at NNLO with {\sc McMule}}",
journal = "in preparation",
year = {2020}
}
@article{Engel:2018fsb,
author = "Engel, T. and Gnendiger, C. and Signer, A. and Ulrich, Y.",
title = "{Small-mass effects in heavy-to-light form factors}",
year = "2018",
eprint = "1811.06461",
archivePrefix = "arXiv",
primaryClass = "hep-ph",
journal = "JHEP",
volume = "02",
pages = "118",
doi = "10.1007/JHEP02(2019)118",
reportNumber = "PSI-PR-18-13, ZU-TH 40/18",
}
@article{Engel:2019nfw,
author = "Engel, T. and Signer, A. and Ulrich, Y.",