Debian Codegraph @

texmf-dist/doc/latex/tikz-feynhand/tikz-feynhand.userguide.tex

raw
1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2 %
3 % TikZ-FeynHand
4 % Feynman Diagrams with TikZ (LaTex manual version)
5 % Copyright (C) 2019 Max Dohse
6 %
7 % available at https://ctan.org/pkg/tikz-feynhand
8 %
9 % This LaTeX file is free: you can redistribute it and/or modify it under the
10 % terms of the GNU General Public License as published by the Free Software
11 % Foundation, either version 3 of the License, or (at your option) any later
12 % version.
13 %
14 % This is distributed in the hope that it will be useful, but WITHOUT ANY
15 % WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
16 % A PARTICULAR PURPOSE. See the GNU General Public License for more details.
17 %
18 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
19
20 %
21 %
22 \pdfoutput=1
23 \pdfcompresslevel=9
24 % highest compression level for text and image (0, ..., 9)
25 %
26 \documentclass[10pt,letterpaper,twoside,notitlepage]{article}
27 %
28 % __________________________________________________________
29 %
30 \usepackage{amsfonts}
31 \usepackage[intlimits]{amsmath}
32 \usepackage{amssymb}
33 \usepackage{amsxtra}
34 \usepackage[dvipsnames]{xcolor}
35 \usepackage{colordvi}
36 \usepackage{colortbl}
37 \usepackage{float}
38 \usepackage{floatflt}
39 \usepackage{graphicx}
40 \usepackage{hhline}
41 \usepackage[compat=1.1.0]{tikz-feynhand}
42 \usepackage{xspace}
43 \usepackage[bookmarks=true,%
44 bookmarksnumbered=true,%
45 bookmarksopen=true,%
46 allbordercolors=lime!60!white]%
47 {hyperref}
48 %
49 % __________________________________________________________
50 %
51 \providecommand{\nc}{\newcommand}
52 \nc{\redcol}{\color{red!80!black}\,}
53 \nc{\vercol}{\color{green!24!black}\,}
54 \nc{\blucol}{\color{blue!40!black}\,}
55 \nc{\brocol}{\color{red!30!black}\,}
56 \nc{\txcol}{\color{black}\,\xspace}
57
58 \nc{\itembf}[1][+]{\item[\textbf{#1}]}
59
60 % __________________________________________________________
61 %
62 \setcounter{secnumdepth}{3}
63 % sections etc. are numerated down to level 3 = SUBSUBSECTION
64 \setcounter{tocdepth}{3}
65 % table of contents lists headlines down to level 3
66
67 \numberwithin{figure}{section}
68 % figure numbers are in format (#section.#figure)
69
70 %% ======= PAGE LAYOUT ===============================
71
72 %\usepackage{showframe} % shows frames for margins
73 \usepackage{geometry}
74 \geometry{letterpaper,
75 top=19mm, bottom=18mm,
76 inner=20mm, outer=20mm,
77 marginparsep=2mm, marginparwidth=12mm}
78
79 \setlength{\parindent}{5mm}
80 % width of indentation in the first line of paragraph
81 \setlength{\parskip}{0mm}
82 % vertical distance separating two paragraphs
83
84 %% ======= BEGIN DOCUMENT ============================
85 %
86 \tikzexternalize[prefix=tikzgraphics/]
87 %\tikzset{external/force remake} % forces refresh of all external TikZ graphics
88 %
89 \begin{document}%
90 %
91 %
92 % =====================================================================
93 % ===== TITLE STUFF ===========================================
94 %%
95 \thispagestyle{empty}
96 %
97 \begin{centering}
98 \Large\bfseries%
99 TikZ-FeynHand: Basic User Guide%
100 \vspace{1mm}\\
101 \large\mdseries%
102 Max Dohse%
103 \vspace{1mm}\\
104 \normalsize%
105 \today
106 \vspace{1mm}\\
107 \small\itshape
108 Written at Instituto de F\'isica y Matem\'aticas (IFM-UMSNH),
109 Universidad Michoacana de San Nicol\'as de Hidalgo,\\
110 Edificio C-3, Ciudad Universitaria,
111 58040 Morelia, Michoac\'an, M\'exico.
112 \vspace{1.5mm}\\
113 \end{centering}
114 %
115 % ===== QUICK REFERENCE =============================================
116 %
117 \hrule
118 \vspace{3mm}
119 {\centering\Large\bfseries Quick Reference\vspace{-2mm}\\}
120 %
121 \noindent
122 \textbf{Environment}\\
123 \vercol\verb!\begin{feynhand}... \end{feynhand}!\txcol
124 enclosed in \vercol\verb!\begin{tikzpicture}[OPTIONS] ... \end{tikzpicture}!\txcol\\
125 OPTIONS: \vercol\verb!baseline=1cm, baseline=(v.base), node distance = 2cm!\txcol,
126 no options are mandatory.
127 \vspace{1.5mm}\\
128 %
129 \noindent
130 \textbf{Vertices}\\
131 \blucol\verb!\vertex (v0) at (x0,y0);!\txcol\\
132 \blucol\verb!\vertex [particle] (v1) at (x1,y1) {e$^-$};!\txcol\\
133 \blucol\verb!\vertex [STYLE] (v2) at (x2,y2)! \redcol\verb!{}!\blucol\verb!;!\txcol\\
134 STYLE options: \blucol\verb!dot, ringdot, squaredot, crossdot, blob, blobring, blobgray, blobNW, blobNE!\txcol\\
135 If STYLE option omitted/empty: nothing is drawn, vertex only defined for later use (drawing propagators).
136 \vspace{1.5mm}\\
137 %
138 \noindent
139 \textbf{Propagators}\\
140 \vercol\verb!\propag [STYLE] (v1) to [EDGE] (v2);!\txcol\qquad\qquad
141 (If STYLE option omitted/empty: straight line is drawn.)\\
142 \vercol\verb!\graph {(v1) --[STYLE, EDGE] (v2) --[STYLE, EDGE] (v3) --[STYLE, EDGE] (v4)};!\txcol
143 \\[1mm]
144 Short STYLE options: \vercol\verb!fer, antfer, pho, bos, chabos, antbos, sca, chasca, antsca,!\\
145 \textcolor{white}{Short STYLE options:}
146 \verb!glu, gho, chagho, antgho, maj, antmaj, plain, mom, revmom!\txcol\\
147 EDGE options: \vercol\verb!edge label, in, out, looseness, half left, quarter right!\txcol
148 \\
149 Crossing propagators:\quad
150 STYLE option \redcol\verb!top!\txcol,
151 for example: \vercol\verb!\propag[fer,! \redcol\verb!top!\vercol\verb!] (a) to (b);!\txcol
152 \vspace{1.5mm}\\
153 %
154 \noindent
155 \textbf{Customize}\\
156 \blucol\verb!\setlength{\feynhanddotsize}{LENGTH}!\txcol\\
157 analogue:
158 \blucol\verb!\feynhandblobsize, \feynhandlinesize, \feynhandarrowsize, \feynhandtopsep!\txcol\\
159 \blucol\verb!\renewcommand{\feynhandtopsepcolor}{COLOR}!\txcol\\
160 \blucol\verb!\tikzfeynhandset{every STYLE={/tikz/color=COLOR},}!\txcol\\
161 \vspace{0mm}
162 %
163 % =====================================================================
164 \hrule
165 \vspace{2mm}
166
167 {\centering Version 1.1.0 -
168 available at\qquad \texttt{https://ctan.org/pkg/tikz-feynhand}\\}
169
170 \vspace{1mm}
171
172 \hrule
173 % ===== TABEL OF CONTENTS ===========================================
174 %
175 \vspace{-2mm}
176 \tableofcontents
177 %
178 % =====================================================================
179 %
180 % ===== MAIN PART ============================================
181 %
182 % =====================================================================
183 %
184 \section{Goals and related software}
185 \label{sec:_goals}
186 %
187 \noindent
188 \textbf{TikZ-FeynHand} is a low-end version of Joshua Ellis' original
189 \textbf{TikZ-Feynman} package \cite{tikzfeynman} (Version 1.1.0),
190 which has provided efficient new ways of drawing beautiful Feynman diagrams automatically
191 (and manually).
192 FeynHand is a modification for those users who want \textbf{easy access} to TikZ-Feynman's
193 drawing styles \textbf{in LaTex without any reference to LuaTex},
194 and who want to \textbf{customize the diagrams} more easily.
195 FeynHand thus aims to be an alternative way to access
196 the manual mode of its big brother TikZ-Feynman.
197
198 The drawing styles of TikZ-FeynHand are available through simple commands
199 following the \textbf{syntax conventions of TikZ,}
200 which uses Tex-like commands to create graphics.
201 Since there are still \textbf{journals} which do not yet support TikZ in submissions,
202 TikZ is capable of creating separate PDF graphic files,
203 which can then be submitted with the article.
204 This is called \textbf{externalizing the graphics} and is outlined in
205 Appendix~\ref{Apx_tikzbasics_externalize},
206 see also Section~50.4 in the TikZ/PGF Manual~\cite{tikz}.
207 \\[1.5mm]
208 %
209 \noindent
210 The \textbf{GENERAL WORKFLOW} for creating a diagram with TikZ-FeynHand is the following:
211 \begin{itemize}
212 \itembf[0.]
213 Initialize the \vercol\verb$feynhand$\txcol environment
214 inside the \vercol\verb$tikzpicture$\txcol environment\\
215 (in turn typically within a \vercol\verb$figure$\txcol or some math environment).
216 %
217 \itembf[1.]
218 Set the positions of the vertices and the styles they are drawn in.
219 %
220 \itembf[2.]
221 Insert the propagator lines between the vertices.
222 %
223 \itembf[x.]
224 Draw extra objects (like coordinate systems).
225 %
226 \end{itemize}
227 %
228 FeynHand offers additonal shorter versions of TikZ-Feynmans TikZ-keys,
229 because I find some of them quite long, e.g.~\vercol\verb$anti charged boson$\txcol.
230 With little practice and efficient use of copy and paste,
231 the ease of creating diagrams by hand is similar in both packages.
232 FeynHand contains a few tweaks that are handy for me and might be for others.
233 \\[1mm]
234 The other main \textbf{features of FeynHand that differ from TikZ-Feynman}
235 (Version 1.1.0) are listed below.
236 %
237 \begin{itemize}
238 %
239 \item
240 Package does neither load the Tex package \vercol\verb$ifluatex$\txcol,\\
241 nor TikZ-Feynman's Lua patches \vercol\verb$tikzfeynman.patch.x.x.x.lua$\txcol.
242 %
243 \item
244 No extra \vercol\verb$\diagram$\txcol environment is needed,
245 since everything is placed by hand.
246 %
247 \item
248 \vercol\verb$top$\txcol style option for crossing propagators introduced,
249 see Section~\ref{sec:_feynmandiagrams_propagators_top}.
250 %
251 \item
252 Some additional vertex and propagator styles are available,
253 see Sections~\ref{sec:_feynmandiagrams_vertices}
254 and \ref{sec:_feynmandiagrams_propagators}.
255 %
256 \item
257 Shortcut commands for quickly customizing the diagrams' look,
258 see Section~\ref{sec:_feynmandiagrams_customizing}.
259 %
260 \item
261 For brevity, we access/leave math mode via \$ instead of the \vercol\verb$\($\txcol
262 and \vercol\verb$\)$\txcol suggested in TikZ-Feynman's manual.\\
263 However, this is rather a personal preference and the opinions on this topic are divided.
264 %
265 \end{itemize}
266 %
267 This user guide just describes briefly \textbf{how to quickly use FeynHand.}
268 There is also a three-page introduction to TikZ in Appendix~\ref{Apx_tikzbasics}.
269 For more information on TikZ-Feynman's capabilities and commands,
270 we recommend its elaborate documentation \cite{tikzfeynman},
271 in particular Section~3, and also recommend the introduction
272 and extensive manual of TikZ \cite{tikz}.
273 %
274 In all commands and keys mentioned in \cite{tikzfeynmanArticle}
275 and the corresponding files, the string \vercol\verb$feynman$\txcol has been replaced
276 by \vercol\verb$feynhand$\txcol in the FeynHand package,
277 in order to prevent any clash of variable names,
278 if both TikZ-Feynman and FeynHand are used together in the same LaTex document.
279 %
280 % =====================================================================
281 %
282 \subsection*{Acknowledgments}
283 %
284 \noindent
285 I am grateful to Joshua Ellis for friendly advice
286 and for writing TikZ-Feynman in the first place.\\
287 I am also thankful to Till Tantau and all collaborators for writing TikZ/PGF.
288 %
289 %
290 % =====================================================================
291 %
292 \subsection*{Citations}
293 %
294 \noindent
295 If you use TikZ-FeynHand for any publication, please be so kind to\\
296 cite both Joshua Ellis' original manual \cite{tikzfeynmanArticle} as well as this userguide.
297 %
298 % =====================================================================
299 %
300 \subsection*{License}
301 %
302 \noindent
303 This PDF and the whole package are free: you can redistribute it and/or modify it under the
304 terms of the GNU General Public License as published by the Free Software
305 Foundation, either version 3 of the License, or (at your option) any later version.
306 %
307 % =====================================================================
308 %
309 \newpage
310 \section{Feynman diagrams with TikZ-FeynHand}
311 \label{sec:_feynmandiagrams}
312 %
313 % =====================================================================
314 %
315 \subsection{Environment}
316 \label{sec:_feynmandiagrams_environment}
317 %
318 \noindent
319 The \blucol\verb$feynhand$\txcol package is loaded as usual
320 with \blucol\verb$\usepackage{tikzfeynhand}$\txcol.
321 All FeynHand commands are used within the \blucol\verb$feynhand$\txcol
322 environment, which needs to be placed inside the \blucol\verb$tikzpicture$\txcol
323 environment%
324 \footnote{It is possible to define \texttt{feynhand} such that it includes \texttt{tikzpicture}.
325 We decide against this so that \texttt{feynhand}
326 can be used as a scope inside \texttt{tikzpicture}.
327 Further, doing so would make externalizing the graphics more difficult.}.
328 %
329 Of course, all \textbf{TikZ commands remain available} within \blucol\verb$feynhand$\txcol,
330 and TikZ commands can also be placed outside of \blucol\verb$feynhand$\txcol
331 inside the \blucol\verb$tikzpicture$\txcol enclosing it.
332
333 The \textbf{coordinate system} used by TikZ is the usual cartesian (x,y)-plane,
334 with the x-axis pointing horizontally to the right
335 and the y-axis pointing vertically upwards on the page.
336 The default coordinate unit is centimeters.
337 We recall that all TikZ and/or FeynHand commands must \textbf{end with
338 a \;;\; (semicolon).}
339
340 When we want to use captions and labels, we enclose \blucol\verb$feynhand$\txcol
341 in the \blucol\verb$figure$\txcol environment as below.
342 %
343 \blucol\begin{verbatim}
344 \begin{figure}
345 \centering
346 \begin{tikzpicture}
347 \begin{feynhand}
348
349 ... FeynHand and/or TikZ commands ...
350
351 \end{feynhand}
352 \end{tikzpicture}
353 \caption{A diagram drawn with TikZ.}
354 \label{Fig:_diagram1}
355 \end{figure}
356 \end{verbatim}\txcol
357 %
358 % ---------------------------------------------------------------
359 \vspace{-5mm}
360 \subsection{Equations involving Feynman diagrams}
361 %
362 The \vercol\verb$feynhand$\txcol environment can also be used directly
363 in math environments. For example, the code below produces the (nonsense) equation below it.
364 For the \vercol\verb$baseline$\txcol option of the
365 \vercol\verb$tikzpicture$\txcol environment, see Section~12.2.1
366 in the TikZ/PGF Manual \cite{tikz}.
367 In the first diagram we have set it to the y-coordinate of the vertex (o),
368 and in the second we have set it to the value y=-0.3cm.
369 That is, in each diagram the corresponding horizontal lines of constant y-coordinate
370 are aligned with the baseline of the math environment.
371 %
372 \vercol\begin{verbatim}
373 \begin{align*}
374 \int dx\; f(x) = \alpha
375 \begin{tikzpicture}[baseline=(o.base)]
376 \begin{feynhand}
377 \vertex (a) at (-1,-1); \vertex (b) at (1,-1); \vertex (c) at (0,1);
378 \vertex [dot, Blue] (o) at (0,0) {}; \propag [fermion, Blue] (a) to (o);
379 \propag [anti fermion, Blue] (b) to (o); \propag [fermion, Blue] (c) to (o);
380 \end{feynhand}
381 \end{tikzpicture}
382 - 2i\,e
383 \begin{tikzpicture}[baseline=-0.3cm]
384 \begin{feynhand}
385 \vertex (a) at (-1,-1); \vertex (b) at (1,-1); \vertex (c) at (0,1);
386 \vertex [dot, Orange] (o) at (0,0) {}; \propag [photon, Orange] (a) to (o);
387 \propag [photon, Orange] (b) to (o); \propag [photon, Orange] (c) to (o);
388 \end{feynhand}
389 \end{tikzpicture}
390 \end{align*}
391 \end{verbatim}\txcol
392 %
393 \vspace{-13mm}
394 %
395 \begin{align*}
396 \int\!\! dx\; f(x) = \alpha
397 \tikzsetnextfilename{baseline_obase}
398 %\tikzset{external/force remake}
399 \begin{tikzpicture}[baseline=(o.base)]
400 \begin{feynhand}
401 \vertex (a) at (-1,-1); \vertex (b) at (1,-1); \vertex (c) at (0,1);
402 \vertex [dot, blue] (o) at (0,0) {}; \propag [fermion, Blue] (a) to (o);
403 \propag [anti fermion, Blue] (b) to (o); \propag [fermion, Blue] (c) to (o);
404 \end{feynhand}
405 \end{tikzpicture}
406 - 2i\,e
407 \tikzsetnextfilename{baseline_03cm}
408 \begin{tikzpicture}[baseline=-0.3cm]
409 \begin{feynhand}
410 \vertex (a) at (-1,-1); \vertex (b) at (1,-1); \vertex (c) at (0,1);
411 \vertex [dot, orange] (o) at (0,0) {}; \propag [photon, Orange] (a) to (o);
412 \propag [photon, Orange] (b) to (o); \propag [photon, Orange] (c) to (o);
413 \end{feynhand}
414 \end{tikzpicture}
415 \end{align*}
416 %
417 % =====================================================================
418 %
419 \subsection{Vertices}
420 \label{sec:_feynmandiagrams_vertices}
421 %
422 \noindent
423 The \vercol\verb$\vertex$\txcol command is the same as in TikZ-Feynman,
424 and essentially consists of the command \vercol\verb$node$\txcol of TikZ.
425 By declaring a vertex, we mean defining its name and its position
426 in the coordinate system, and specifying how the vertex is to be drawn,
427 see below for examples.
428 The vertices' names are mere labels for later reference
429 (just like equation labels in Latex)
430 and don't show up anywhere in the graph.
431 The idea is now to use the vertices' names as a reference for their
432 coordinates. This makes their use and modification much easier.
433 For example, we can draw a line from vertex (a) to (b) by
434 \vercol\verb$\draw (a) to (b);$\txcol
435 see Section~\ref{sec:_feynmandiagrams_propagators}.
436
437 Below we list the available vertex styles.
438 Some users like to draw a gap in propagator lines which cross each other
439 without any interaction being implied there.
440 This can be done using gap vertices,
441 see Section~\ref{sec:_feynmandiagrams_propagators_top}.
442 %
443 % ------------------------------------------------------
444 \subsubsection*{Bare vertex}
445 %
446 \noindent
447 This is the basic vertex: nothing is drawn at the vertex itself,
448 it merely connects propagator lines.
449 Note that we do not put an empty argument \redcol\verb${}$\txcol at the end.
450 \vspace{2mm}\\
451 %
452 \begin{minipage}{0.7\linewidth}
453 \vercol\begin{verbatim}
454 \begin{tikzpicture}
455 \begin{feynhand}
456 \vertex (a) at (0,0); \vertex (b) at (2,0);
457 \vertex (c1) at (4,0.5); \vertex (c2) at (4,-0.5);
458 \propag [plain] (a) to (b);
459 \propag [plain] (b) to (c1);
460 \propag [plain] (b) to (c2);
461 \end{feynhand}
462 \end{tikzpicture}
463 \end{verbatim}\txcol
464 \end{minipage}
465 %
466 \begin{minipage}{0.25\linewidth}
467 \tikzsetnextfilename{vertex_bare}
468 %\tikzset{external/force remake}
469 \begin{tikzpicture}
470 \begin{feynhand}
471 \vertex (a) at (0,0);
472 \vertex (b) at (2,0);
473 \vertex (c1) at (4,0.5);
474 \vertex (c2) at (4,-0.5);
475 \propag [plain] (a) to (b);
476 \propag [plain] (b) to (c1);
477 \propag [plain] (b) to (c2);
478 \end{feynhand}
479 \end{tikzpicture}
480 \end{minipage}
481 %
482 % ------------------------------------------------------
483 \subsubsection*{Particle vertex}
484 %
485 \noindent
486 Particle vertices are usually used only for incoming
487 and outgoing particles. \\
488 For intermediate particles, see propagator edge labels in
489 Section~\ref{sec:_feynmandiagrams_proplabelsmomentum}.
490 \vspace{2mm}\\
491 %
492 \begin{minipage}{0.7\linewidth}
493 \vercol\begin{verbatim}
494 ...
495 \vertex [particle] (a) at (0,0) {e$^-$};
496 ...
497 \end{verbatim}\txcol
498 \end{minipage}
499 %
500 \begin{minipage}{0.25\linewidth}
501 \tikzsetnextfilename{vertex_particle}
502 %\tikzset{external/force remake}
503 \begin{tikzpicture}
504 \begin{feynhand}
505 \vertex [particle] (a) at (0,0) {e$^-$};
506 \vertex (b) at (2,0);
507 \vertex (c1) at (4,0.5);
508 \vertex (c2) at (4,-0.5);
509 \propag [plain] (a) to (b);
510 \propag [plain] (b) to (c1);
511 \propag [plain] (b) to (c2);
512 \end{feynhand}
513 \end{tikzpicture}
514 \end{minipage}
515 %
516 % ------------------------------------------------------
517 \subsubsection*{Dot vertex}
518 %
519 \noindent
520 Some users like to place dots on vertices in order to emphasize
521 that an interaction occurs there.\\
522 Note the empty argument \redcol\verb${}$\txcol at the end -
523 without the dots/blobs will not appear!
524 \vspace{2mm}\\
525 %
526 \begin{minipage}{0.7\linewidth}
527 \vercol\begin{verbatim}
528 ...
529 \vertex [dot] (b) at (2,0) {};
530 ...
531 \end{verbatim}\txcol
532 \end{minipage}
533 %
534 \begin{minipage}{0.25\linewidth}
535 \tikzsetnextfilename{vertex_dot}
536 %\tikzset{external/force remake}
537 \begin{tikzpicture}
538 \begin{feynhand}
539 \vertex (a) at (0,0);
540 \vertex [dot] (b) at (2,0) {};
541 \vertex (c1) at (4,0.5);
542 \vertex (c2) at (4,-0.5);
543 \propag [plain] (a) to (b);
544 \propag [plain] (b) to (c1);
545 \propag [plain] (b) to (c2);
546 \end{feynhand}
547 \end{tikzpicture}
548 \end{minipage}
549 %
550 % ------------------------------------------------------
551 \subsubsection*{Ring dot vertex}
552 %
553 \begin{minipage}{0.7\linewidth}
554 \vercol\begin{verbatim}
555 ...
556 \vertex [ringdot] (b) at (2,0) {};
557 ...
558 \end{verbatim}\txcol
559 \end{minipage}
560 %
561 \begin{minipage}{0.25\linewidth}
562 \tikzsetnextfilename{vertex_ringdot}
563 %\tikzset{external/force remake}
564 \begin{tikzpicture}
565 \begin{feynhand}
566 \vertex (a) at (0,0);
567 \vertex [ringdot] (b) at (2,0) {};
568 \vertex (c1) at (4,0.5);
569 \vertex (c2) at (4,-0.5);
570 \propag [plain] (a) to (b);
571 \propag [plain] (b) to (c1);
572 \propag [plain] (b) to (c2);
573 \end{feynhand}
574 \end{tikzpicture}
575 \end{minipage}
576 %
577 % ------------------------------------------------------
578 \subsubsection*{Square dot vertex}
579 %
580 \begin{minipage}{0.7\linewidth}
581 \vercol\begin{verbatim}
582 ...
583 \vertex [squaredot] (b) at (2,0) {};
584 ...
585 \end{verbatim}\txcol
586 \end{minipage}
587 %
588 \begin{minipage}{0.25\linewidth}
589 \tikzsetnextfilename{vertex_squaredot}
590 %\tikzset{external/force remake}
591 \begin{tikzpicture}
592 \begin{feynhand}
593 \vertex (a) at (0,0);
594 \vertex [squaredot] (b) at (2,0) {};
595 \vertex (c1) at (4,0.5);
596 \vertex (c2) at (4,-0.5);
597 \propag [plain] (a) to (b);
598 \propag [plain] (b) to (c1);
599 \propag [plain] (b) to (c2);
600 \end{feynhand}
601 \end{tikzpicture}
602 \end{minipage}
603 %
604 % ------------------------------------------------------
605 \subsubsection*{Crossed dot vertex}
606 %
607 \begin{minipage}{0.7\linewidth}
608 \vercol\begin{verbatim}
609 ...
610 \vertex [crossdot] (b) at (2,0) {};
611 ...
612 \end{verbatim}\txcol
613 \end{minipage}
614 %
615 \begin{minipage}{0.25\linewidth}
616 \tikzsetnextfilename{vertex_crossdot}
617 %\tikzset{external/force remake}
618 \begin{tikzpicture}
619 \begin{feynhand}
620 \vertex (a) at (0,0);
621 \vertex [crossdot] (b) at (2,0) {};
622 \vertex (c1) at (4,0.5);
623 \vertex (c2) at (4,-0.5);
624 \propag [plain] (a) to (b);
625 \propag [plain] (b) to (c1);
626 \propag [plain] (b) to (c2);
627 \end{feynhand}
628 \end{tikzpicture}
629 \end{minipage}
630 %
631 % ------------------------------------------------------
632 \subsubsection*{Blob vertex}
633 %
634 \begin{minipage}{0.7\linewidth}
635 \vercol\begin{verbatim}
636 ...
637 \vertex [blob] (b) at (2,0) {};
638 ...
639 \end{verbatim}\txcol
640 \end{minipage}
641 %
642 \begin{minipage}{0.25\linewidth}
643 \tikzsetnextfilename{vertex_blob}
644 %\tikzset{external/force remake}
645 \begin{tikzpicture}
646 \begin{feynhand}
647 \vertex (a) at (0,0);
648 \vertex [blob] (b) at (2,0) {};
649 \vertex (c1) at (4,0.5);
650 \vertex (c2) at (4,-0.5);
651 \propag [plain] (a) to (b);
652 \propag [plain] (b) to (c1);
653 \propag [plain] (b) to (c2);
654 \end{feynhand}
655 \end{tikzpicture}
656 \end{minipage}
657 %
658 % ------------------------------------------------------
659 \subsubsection*{Ring blob vertex}
660 %
661 \begin{minipage}{0.7\linewidth}
662 \vercol\begin{verbatim}
663 ...
664 \vertex [ringblob] (b) at (2,0) {};
665 ...
666 \end{verbatim}\txcol
667 \end{minipage}
668 %
669 \begin{minipage}{0.25\linewidth}
670 \tikzsetnextfilename{vertex_ringblob}
671 %\tikzset{external/force remake}
672 \begin{tikzpicture}
673 \begin{feynhand}
674 \vertex (a) at (0,0);
675 \vertex [ringblob] (b) at (2,0) {};
676 \vertex (c1) at (4,0.5);
677 \vertex (c2) at (4,-0.5);
678 \propag [plain] (a) to (b);
679 \propag [plain] (b) to (c1);
680 \propag [plain] (b) to (c2);
681 \end{feynhand}
682 \end{tikzpicture}
683 \end{minipage}
684 %
685 % ------------------------------------------------------
686 \subsubsection*{Gray blob vertex}
687 %
688 \begin{minipage}{0.7\linewidth}
689 \vercol\begin{verbatim}
690 ...
691 \vertex [grayblob] (b) at (2,0) {};
692 ...
693 \end{verbatim}\txcol
694 \end{minipage}
695 %
696 \begin{minipage}{0.25\linewidth}
697 \tikzsetnextfilename{vertex_grayblob}
698 %\tikzset{external/force remake}
699 \begin{tikzpicture}
700 \begin{feynhand}
701 \vertex (a) at (0,0);
702 \vertex [grayblob] (b) at (2,0) {};
703 \vertex (c1) at (4,0.5);
704 \vertex (c2) at (4,-0.5);
705 \propag [plain] (a) to (b);
706 \propag [plain] (b) to (c1);
707 \propag [plain] (b) to (c2);
708 \end{feynhand}
709 \end{tikzpicture}
710 \end{minipage}
711 %
712 % ------------------------------------------------------
713 \subsubsection*{NorthWest blob vertex}
714 %
715 \begin{minipage}{0.7\linewidth}
716 \vercol\begin{verbatim}
717 ...
718 \vertex [NWblob] (b) at (2,0) {};
719 ...
720 \end{verbatim}\txcol
721 \end{minipage}
722 %
723 \begin{minipage}{0.25\linewidth}
724 \tikzsetnextfilename{vertex_NWblob}
725 %\tikzset{external/force remake}
726 \begin{tikzpicture}
727 \begin{feynhand}
728 \vertex (a) at (0,0);
729 \vertex [NWblob] (b) at (2,0) {};
730 \vertex (c1) at (4,0.5);
731 \vertex (c2) at (4,-0.5);
732 \propag [plain] (a) to (b);
733 \propag [plain] (b) to (c1);
734 \propag [plain] (b) to (c2);
735 \end{feynhand}
736 \end{tikzpicture}
737 \end{minipage}
738 %
739 % ------------------------------------------------------
740 \subsubsection*{NorthEast blob vertex}
741 %
742 \begin{minipage}{0.7\linewidth}
743 \vercol\begin{verbatim}
744 ...
745 \vertex [NEblob] (b) at (2,0) {};
746 ...
747 \end{verbatim}\txcol
748 \end{minipage}
749 %
750 \begin{minipage}{0.25\linewidth}
751 \tikzsetnextfilename{vertex_NEblob}
752 %\tikzset{external/force remake}
753 \begin{tikzpicture}
754 \begin{feynhand}
755 \vertex (a) at (0,0);
756 \vertex [NEblob] (b) at (2,0) {};
757 \vertex (c1) at (4,0.5);
758 \vertex (c2) at (4,-0.5);
759 \propag [plain] (a) to (b);
760 \propag [plain] (b) to (c1);
761 \propag [plain] (b) to (c2);
762 \end{feynhand}
763 \end{tikzpicture}
764 \end{minipage}
765 %
766 % ------------------------------------------------------
767 \subsubsection{Relative vertex placement}
768 \label{sec:_feynmandiagrams_vertices_relative}
769 %
770 \noindent
771 Above we have always placed the vertices using absolute coordinate values.
772 Relative placement is done using the keys
773 \blucol\verb$above, below, left, right$\txcol.
774 When combined, the vertical key must come first, as in
775 \blucol\verb$above right$\txcol.\\
776
777 \noindent
778 \begin{minipage}{0.75\linewidth}
779 \blucol\begin{verbatim}
780 \vertex [dot] (a1) {};
781 \vertex [ringdot] (a2) [above right = of a1] {};
782 \propag [plain] (a1) to (a2);
783 \end{verbatim}\txcol
784 \end{minipage}
785 %
786 \begin{minipage}{0.2\linewidth}
787 \tikzsetnextfilename{vertex_relative_1}
788 %\tikzset{external/force remake}
789 \begin{tikzpicture}
790 \begin{feynhand}
791 \vertex [dot] (a1) {};
792 \vertex [ringdot] (a2) [above right = of a1] {};
793 \propag [plain] (a1) to (a2);
794 \end{feynhand}
795 \end{tikzpicture}
796 \end{minipage}
797 \\
798
799 \noindent
800 The node distance used by these keys can be set
801 by calling \blucol\verb$\begin{tikzpicture}[node distance = 2cm]$\txcol
802 or \blucol\verb$\begin{feynhand}[node distance = 2cm]$\txcol.
803 Moreover, we can specify the absolute distances relative to a vertex:\\
804
805 \noindent
806 \begin{minipage}{0.75\linewidth}
807 \blucol\begin{verbatim}
808 \vertex [dot] (a1) {};
809 \vertex [dot] (a2) [right = 1.5cm of a1] {};
810 \propag [gluon] (a1) to (a2);
811 \end{verbatim}\txcol
812 \end{minipage}
813 %
814 \begin{minipage}{0.2\linewidth}
815 \tikzsetnextfilename{vertex_relative_2}
816 %\tikzset{external/force remake}
817 \begin{tikzpicture}
818 \begin{feynhand}
819 \vertex [dot] (a1) {};
820 \vertex [dot] (a2) [right = 1.5cm of a1] {};
821 \propag [gluon] (a1) to (a2);
822 \end{feynhand}
823 \end{tikzpicture}
824 \end{minipage}
825 \\
826 \begin{minipage}{0.75\linewidth}
827 \blucol\begin{verbatim}
828 \vertex [ringdot] (a1) {};
829 \vertex [ringdot] (a2) [above right = 0.5cm and 2cm of a1] {};
830 \propag [photon] (a1) to (a2);
831 \end{verbatim}\txcol
832 \end{minipage}
833 %
834 \begin{minipage}{0.2\linewidth}
835 \tikzsetnextfilename{vertex_relative_3}
836 %\tikzset{external/force remake}
837 \begin{tikzpicture}
838 \begin{feynhand}
839 \vertex [ringdot] (a1) {};
840 \vertex [ringdot] (a2) [above right = 0.5cm and 2cm of a1] {};
841 \propag [photon] (a1) to (a2);
842 \end{feynhand}
843 \end{tikzpicture}
844 \end{minipage}
845
846
847
848 %
849 % =====================================================================
850 %
851 \subsection{Propagators}
852 \label{sec:_feynmandiagrams_propagators}
853 %
854 \noindent
855 You can draw propagators between vertices with FeynHand's \vercol\verb$\propag$\txcol command,
856 whose long version \vercol\verb$\propagator$\txcol also works.
857 Both are just TikZ' \vercol\verb$\draw$\txcol command,
858 and thus can access all styles defined in TikZ-Feynman.
859 The minimal example \vercol\verb$\propag[fer] (a) to (b);$\txcol
860 draws a fermion propagator from vertex (a) and (b).
861 Below we list all propagator styles and draw examples.
862 FeynHand uses intuitive 3/6-letter versions, but also keeps TikZ-Feynman's longer ones:
863 %
864 \setlength{\extrarowheight}{3pt}
865 \begin{table}[H]
866 \centering
867 \begin{tabular}{r>{\qquad} r}
868 \hline
869 Short Version & Long Version
870 \\
871 \hhline{==}
872 \verb$\propag$ & \verb$\propagator$\\
873 \hline
874 \verb$fer$ & \verb$fermion$\\
875 \verb$antfer$ & \verb$anti fermion$\\
876 \hline
877 \verb$pho$ & \verb$photon$\\
878 \hline
879 \verb$bos$ & \verb$boson$\\
880 \verb$chabos$ & \verb$charged boson$\\
881 \verb$antbos$ & \verb$anti charged boson$\\
882 \hline
883 \verb$glu$ & \verb$gluon$\\
884 \hline
885 %
886 \end{tabular}
887 \qquad\qquad\qquad
888 \begin{tabular}{r>{\qquad} r}
889 \hline
890 Short Version & Long Version
891 \\
892 \hhline{==}
893 \verb$sca$ & \verb$scalar$\\
894 \verb$chasca$ & \verb$charged scalar$\\
895 \verb$antsca$ & \verb$anti charged scalar$\\
896 \hline
897 \verb$gho$ & \verb$ghost$\\
898 \verb$chagho$ & \verb$charged ghost$\\
899 \verb$antgho$ & \verb$anti charged ghost$\\
900 \hline
901 \verb$maj$ & \verb$majorana$\\
902 \verb$antmaj$ & \verb$anti majorana$\\
903 \hline
904 %
905 \end{tabular}
906 \end{table}
907 %
908 %
909 % ------------------------------------------------------
910 \subsubsection*{Fermions}
911 %
912 \begin{minipage}{0.7\linewidth}
913 \vercol\begin{verbatim}
914 \vertex (a) at (0,0); \vertex (b) at (2,0);
915 \propag[fer] (a) to (b);
916 \end{verbatim}\txcol
917 \end{minipage}
918 %
919 \begin{minipage}{0.25\linewidth}
920 \tikzsetnextfilename{propag_fermion}
921 %\tikzset{external/force remake}
922 \begin{tikzpicture}
923 \begin{feynhand}
924 \vertex (a) at (0,0); \vertex (b) at (2,0);
925 \propag[fer] (a) to (b);
926 \end{feynhand}
927 \end{tikzpicture}
928 \end{minipage}
929 %
930 \\
931 \begin{minipage}{0.7\linewidth}
932 \vercol\begin{verbatim}
933 \vertex (a) at (0,0); \vertex (b) at (2,0);
934 \propagator[antfer] (a) to (b);
935 \end{verbatim}\txcol
936 \end{minipage}
937 %
938 \begin{minipage}{0.25\linewidth}
939 \tikzsetnextfilename{propag_antfer}
940 %\tikzset{external/force remake}
941 \begin{tikzpicture}
942 \begin{feynhand}
943 \vertex (a) at (0,0); \vertex (b) at (2,0);
944 \propagator[antfer] (a) to (b);
945 \end{feynhand}
946 \end{tikzpicture}
947 \end{minipage}
948 %
949 % ------------------------------------------------------
950 \subsubsection*{Gluons}
951 %
952 \begin{minipage}{0.7\linewidth}
953 \vercol\begin{verbatim}
954 \vertex (a) at (0,0); \vertex (b) at (2,0);
955 \propag[glu] (a) to (b);
956 \end{verbatim}\txcol
957 \end{minipage}
958 %
959 \begin{minipage}{0.25\linewidth}
960 \tikzsetnextfilename{propag_gluon}
961 %\tikzset{external/force remake}
962 \begin{tikzpicture}
963 \begin{feynhand}
964 \vertex (a) at (0,0); \vertex (b) at (2,0);
965 \propag[glu] (a) to (b);
966 \end{feynhand}
967 \end{tikzpicture}
968 \end{minipage}
969 \\
970 %
971 \begin{minipage}{0.7\linewidth}
972 \vercol\begin{verbatim}
973 \vertex (a) at (0,0); \vertex (b) at (2,1);
974 \propag[glu] (a) to [out=0, in=180] (b);
975 \end{verbatim}\txcol
976 \end{minipage}
977 %
978 \begin{minipage}{0.25\linewidth}
979 \tikzsetnextfilename{propag_gluon_out_in}
980 %\tikzset{external/force remake}
981 \begin{tikzpicture}
982 \begin{feynhand}
983 \vertex (a) at (0,0); \vertex (b) at (2,1);
984 \propag[gluon] (a) to [out=0, in=180] (b);
985 \end{feynhand}
986 \end{tikzpicture}
987 \end{minipage}
988 \\
989 %
990 % ------------------------------------------------------
991 \subsubsection*{Bosons (photons are just bosons)}
992 %
993 \begin{minipage}{0.7\linewidth}
994 \vercol\begin{verbatim}
995 \vertex (a) at (0,0); \vertex (b) at (2,0);
996 \propag[bos] (a) to (b);
997 \end{verbatim}\txcol
998 \end{minipage}
999 %
1000 \begin{minipage}{0.25\linewidth}
1001 \tikzsetnextfilename{propag_boson}
1002 %\tikzset{external/force remake}
1003 \begin{tikzpicture}
1004 \begin{feynhand}
1005 \vertex (a) at (0,0); \vertex (b) at (2,0);
1006 \propag[bos] (a) to (b);
1007 \end{feynhand}
1008 \end{tikzpicture}
1009 \end{minipage}
1010 \\
1011 %
1012 \begin{minipage}{0.7\linewidth}
1013 \vercol\begin{verbatim}
1014 \vertex (a) at (0,0); \vertex (b) at (2,0);
1015 \propag[pho] (a) to (b);
1016 \end{verbatim}\txcol
1017 \end{minipage}
1018 %
1019 \begin{minipage}{0.25\linewidth}
1020 \tikzsetnextfilename{propag_photon}
1021 %\tikzset{external/force remake}
1022 \begin{tikzpicture}
1023 \begin{feynhand}
1024 \vertex (a) at (0,0); \vertex (b) at (2,0);
1025 \propag[pho] (a) to (b);
1026 \end{feynhand}
1027 \end{tikzpicture}
1028 \end{minipage}
1029 \\
1030 \begin{minipage}{0.7\linewidth}
1031 \vercol\begin{verbatim}
1032 \vertex (a) at (0,0); \vertex (b) at (2,-1);
1033 \propag[bos] (a) to [out=0, in=90] (b);
1034 \end{verbatim}\txcol
1035 \end{minipage}
1036 %
1037 \begin{minipage}{0.25\linewidth}
1038 \tikzsetnextfilename{propag_boson_out_in}
1039 %\tikzset{external/force remake}
1040 \begin{tikzpicture}
1041 \begin{feynhand}
1042 \vertex (a) at (0,0); \vertex (b) at (2,-1);
1043 \propag[bos] (a) to [out=0, in=90] (b);
1044 \end{feynhand}
1045 \end{tikzpicture}
1046 \end{minipage}
1047 \\
1048 %
1049 % ------------------------------------------------------
1050 \subsubsection*{Charged bosons}
1051 %
1052 \begin{minipage}{0.7\linewidth}
1053 \vercol\begin{verbatim}
1054 \vertex (a) at (0,0); \vertex (b) at (2,0);
1055 \propag[chabos] (a) to (b);
1056 \end{verbatim}\txcol
1057 \end{minipage}
1058 %
1059 \begin{minipage}{0.25\linewidth}
1060 \tikzsetnextfilename{propag_chabos}
1061 %\tikzset{external/force remake}
1062 \begin{tikzpicture}
1063 \begin{feynhand}
1064 \vertex (a) at (0,0); \vertex (b) at (2,0);
1065 \propag[chabos] (a) to (b);
1066 \end{feynhand}
1067 \end{tikzpicture}
1068 \end{minipage}
1069 \\
1070 %
1071 \begin{minipage}{0.7\linewidth}
1072 \vercol\begin{verbatim}
1073 \vertex (a) at (0,0); \vertex (b) at (2,0);
1074 \propag[antbos] (a) to (b);
1075 \end{verbatim}\txcol
1076 \end{minipage}
1077 %
1078 \begin{minipage}{0.25\linewidth}
1079 \tikzsetnextfilename{propag_antbos}
1080 %\tikzset{external/force remake}
1081 \begin{tikzpicture}
1082 \begin{feynhand}
1083 \vertex (a) at (0,0); \vertex (b) at (2,0);
1084 \propag[antbos] (a) to (b);
1085 \end{feynhand}
1086 \end{tikzpicture}
1087 \end{minipage}
1088 \\
1089 %
1090 % ------------------------------------------------------
1091 \newpage
1092 \subsubsection*{Scalars}
1093 %
1094 \begin{minipage}{0.7\linewidth}
1095 \vercol\begin{verbatim}
1096 \vertex (a) at (0,0); \vertex (b) at (2,0);
1097 \propag[sca] (a) to (b);
1098 \end{verbatim}\txcol
1099 \end{minipage}
1100 %
1101 \begin{minipage}{0.25\linewidth}
1102 \tikzsetnextfilename{propag_scalar}
1103 %\tikzset{external/force remake}
1104 \begin{tikzpicture}
1105 \begin{feynhand}
1106 \vertex (a) at (0,0); \vertex (b) at (2,0);
1107 \propag[sca] (a) to (b);
1108 \end{feynhand}
1109 \end{tikzpicture}
1110 \end{minipage}
1111 \\
1112 %
1113 \begin{minipage}{0.7\linewidth}
1114 \vercol\begin{verbatim}
1115 \vertex (a) at (0,0); \vertex (b) at (2,1);
1116 \propag[sca] (a) to [out=0, in=180] (b);
1117 \end{verbatim}\txcol
1118 \end{minipage}
1119 %
1120 \begin{minipage}{0.25\linewidth}
1121 \tikzsetnextfilename{propag_scalar_out_in}
1122 %\tikzset{external/force remake}
1123 \begin{tikzpicture}
1124 \begin{feynhand}
1125 \vertex (a) at (0,0); \vertex (b) at (2,1);
1126 \propag[sca] (a) to [out=0, in=180] (b);
1127 \end{feynhand}
1128 \end{tikzpicture}
1129 \end{minipage}
1130 \\
1131 %
1132 % ------------------------------------------------------
1133 \vspace{-6mm}
1134 \subsubsection*{Charged scalars}
1135 %
1136 \begin{minipage}{0.7\linewidth}
1137 \vercol\begin{verbatim}
1138 \vertex (a) at (0,0); \vertex (b) at (2,0);
1139 \propag[chasca] (a) to (b);
1140 \end{verbatim}\txcol
1141 \end{minipage}
1142 %
1143 \begin{minipage}{0.25\linewidth}
1144 \tikzsetnextfilename{propag_chasca}
1145 %\tikzset{external/force remake}
1146 \begin{tikzpicture}
1147 \begin{feynhand}
1148 \vertex (a) at (0,0); \vertex (b) at (2,0);
1149 \propag[chasca] (a) to (b);
1150 \end{feynhand}
1151 \end{tikzpicture}
1152 \end{minipage}
1153 \\
1154 %
1155 \begin{minipage}{0.7\linewidth}
1156 \vercol\begin{verbatim}
1157 \vertex (a) at (0,0); \vertex (b) at (2,0);
1158 \propag[antsca] (a) to (b);
1159 \end{verbatim}\txcol
1160 \end{minipage}
1161 %
1162 \begin{minipage}{0.25\linewidth}
1163 \tikzsetnextfilename{propag_antsca}
1164 %\tikzset{external/force remake}
1165 \begin{tikzpicture}
1166 \begin{feynhand}
1167 \vertex (a) at (0,0); \vertex (b) at (2,0);
1168 \propag[antsca] (a) to (b);
1169 \end{feynhand}
1170 \end{tikzpicture}
1171 \end{minipage}
1172 \\
1173 %
1174 % ------------------------------------------------------
1175 \subsubsection*{Ghosts}
1176 %
1177 \begin{minipage}{0.7\linewidth}
1178 \vercol\begin{verbatim}
1179 \vertex (a) at (0,0); \vertex (b) at (2,0);
1180 \propag[gho] (a) to (b);
1181 \end{verbatim}\txcol
1182 \end{minipage}
1183 %
1184 \begin{minipage}{0.25\linewidth}
1185 \tikzsetnextfilename{propag_ghost}
1186 %\tikzset{external/force remake}
1187 \begin{tikzpicture}
1188 \begin{feynhand}
1189 \vertex (a) at (0,0); \vertex (b) at (2,0);
1190 \propag[gho] (a) to (b);
1191 \end{feynhand}
1192 \end{tikzpicture}
1193 \end{minipage}
1194 \\
1195 %
1196 \begin{minipage}{0.7\linewidth}
1197 \vercol\begin{verbatim}
1198 \vertex (a) at (0,0); \vertex (b) at (2,1);
1199 \propag[gho] (a) to [out=0, in=180] (b);
1200 \end{verbatim}\txcol
1201 \end{minipage}
1202 %
1203 \begin{minipage}{0.25\linewidth}
1204 \tikzsetnextfilename{propag_ghost_out_in}
1205 %\tikzset{external/force remake}
1206 \begin{tikzpicture}
1207 \begin{feynhand}
1208 \vertex (a) at (0,0); \vertex (b) at (2,1);
1209 \propag[gho] (a) to [out=0, in=180] (b);
1210 \end{feynhand}
1211 \end{tikzpicture}
1212 \end{minipage}
1213 %
1214 % ------------------------------------------------------
1215 \subsubsection*{Charged ghosts}
1216 %
1217 %
1218 \begin{minipage}{0.7\linewidth}
1219 \vercol\begin{verbatim}
1220 \vertex (a) at (0,0); \vertex (b) at (2,0);
1221 \propag[chagho] (a) to (b);
1222 \end{verbatim}\txcol
1223 \end{minipage}
1224 %
1225 \begin{minipage}{0.25\linewidth}
1226 \tikzsetnextfilename{propag_chaghost}
1227 %\tikzset{external/force remake}
1228 \begin{tikzpicture}
1229 \begin{feynhand}
1230 \vertex (a) at (0,0); \vertex (b) at (2,0);
1231 \propag[chagho] (a) to (b);
1232 \end{feynhand}
1233 \end{tikzpicture}
1234 \end{minipage}
1235 \\
1236 %
1237 \begin{minipage}{0.7\linewidth}
1238 \vercol\begin{verbatim}
1239 \vertex (a) at (0,0); \vertex (b) at (2,0);
1240 \propag[antgho] (a) to (b);
1241 \end{verbatim}\txcol
1242 \end{minipage}
1243 %
1244 \begin{minipage}{0.25\linewidth}
1245 \tikzsetnextfilename{propag_antghost}
1246 %\tikzset{external/force remake}
1247 \begin{tikzpicture}
1248 \begin{feynhand}
1249 \vertex (a) at (0,0); \vertex (b) at (2,0);
1250 \propag[antgho] (a) to (b);
1251 \end{feynhand}
1252 \end{tikzpicture}
1253 \end{minipage}
1254 \\
1255 %
1256 % ------------------------------------------------------
1257 \subsubsection*{Majorana}
1258 %
1259 \begin{minipage}{0.7\linewidth}
1260 \vercol\begin{verbatim}
1261 \vertex (a) at (0,0); \vertex (b) at (2,0);
1262 \propag[maj] (a) to (b);
1263 \end{verbatim}\txcol
1264 \end{minipage}
1265 %
1266 \begin{minipage}{0.25\linewidth}
1267 \tikzsetnextfilename{propag_major}
1268 %\tikzset{external/force remake}
1269 \begin{tikzpicture}
1270 \begin{feynhand}
1271 \vertex (a) at (0,0); \vertex (b) at (2,0);
1272 \propag[maj] (a) to (b);
1273 \end{feynhand}
1274 \end{tikzpicture}
1275 \end{minipage}
1276 \\
1277 %
1278 \begin{minipage}{0.7\linewidth}
1279 \vercol\begin{verbatim}
1280 \vertex (a) at (0,0); \vertex (b) at (2,0);
1281 \propag[antmaj] (a) to (b);
1282 \end{verbatim}\txcol
1283 \end{minipage}
1284 %
1285 \begin{minipage}{0.25\linewidth}
1286 \tikzsetnextfilename{propag_antmaj}
1287 %\tikzset{external/force remake}
1288 \begin{tikzpicture}
1289 \begin{feynhand}
1290 \vertex (a) at (0,0); \vertex (b) at (2,0);
1291 \propag[antmaj] (a) to (b);
1292 \end{feynhand}
1293 \end{tikzpicture}
1294 \end{minipage}
1295 \\
1296 %
1297 % ------------------------------------------------------
1298 \subsubsection*{Linked propagators}
1299 %
1300 \noindent
1301 We can also draw "chains" of propagators from one vertex to the next to the next etc.~using
1302 TikZ' \blucol\verb$\graph$\txcol command.
1303 Then, all style options are attached to the connector \blucol\verb$--$\txcol
1304 as in the following example.
1305 \\
1306
1307 %
1308 \begin{minipage}{0.75\linewidth}
1309 \blucol\begin{verbatim}
1310 \graph {(a0) --[fer,green!50!black]
1311 (a1) --[glu,red]
1312 (a2) --[chabos,blue] (a3)};
1313
1314 \graph {(b0) --[fer, red, in=180, out=270, insertion=0.8]
1315 (b1) --[glu, edge label =$k$]
1316 (b2) --[chabos, blue, mom={[arrow style=blue] $q$}] (b3)};
1317 \end{verbatim}\txcol
1318 \end{minipage}
1319 %
1320 %
1321 \begin{minipage}{0.23\linewidth}
1322 \tikzsetnextfilename{propag_chain}
1323 %\tikzset{external/force remake}
1324 \begin{tikzpicture}
1325 \begin{feynhand}
1326 \vertex (a0) at (0,2); \vertex (a1) at (1,2);
1327 \vertex (a2) at (2,2); \vertex (a3) at (3,2);
1328 \vertex (b0) at (0,1); \vertex (b1) at (1,0);
1329 \vertex (b2) at (2,0); \vertex (b3) at (3,1);
1330 \graph {(a0) --[fer, green!50!black] (a1) --[glu, red] (a2) --[chabos, blue] (a3)};
1331 \graph {(b0) --[fer, red, in=180, out=270, insertion=0.8]
1332 (b1) --[glu, edge label =$k$] (b2) --[chabos, blue, mom={[arrow style=blue] $q$}] (b3)};
1333 \end{feynhand}
1334 \end{tikzpicture}
1335 \end{minipage}
1336 %
1337 % --------------------------------------------------------------------------------
1338 \subsubsection{Keys: In, Out, Looseness, Left/Right, Half/Quarter}
1339 \label{sec:_feynmandiagrams_keysinoutetc}
1340 %
1341 \noindent
1342 The keys \vercol\verb$in, out$\txcol specify the angle
1343 at which the line leaves and enters the vertices.
1344 The angle is with respect to the coordinate system:
1345 0 degrees is right, 90 up, 180 left, 270 down.
1346 \vspace{2mm}\\
1347 %
1348 \begin{minipage}{0.7\linewidth}
1349 \vercol\begin{verbatim}
1350 \vertex (a) at (0,0); \vertex (b) at (2,0);
1351 \propag[fer] (a) to [out=90, in=90] (b);
1352 \end{verbatim}\txcol
1353 \end{minipage}
1354 %
1355 \begin{minipage}{0.25\linewidth}
1356 \tikzsetnextfilename{propag_keys_out_in}
1357 %\tikzset{external/force remake}
1358 \begin{tikzpicture}
1359 \begin{feynhand}
1360 \vertex (a) at (0,0); \vertex (b) at (2,0);
1361 \propag[fer] (a) to [out=90, in=90] (b);
1362 \end{feynhand}
1363 \end{tikzpicture}
1364 \end{minipage}
1365 \\
1366 The key \vercol\verb$looseness$\txcol specifies
1367 how loose (distant) the arc is bending away
1368 from the straight line connecting the vertices.
1369 Its default value is 1.
1370 \vspace{2mm}\\
1371 %
1372 \begin{minipage}{0.7\linewidth}
1373 \vercol\begin{verbatim}
1374 \vertex (a) at (0,0); \vertex (b) at (2,0);
1375 \vertex (c) at (3,0); \vertex (d) at (5,0);
1376 \propag[fer] (a) to [in=90, out=90] (b);
1377 \propag[fer] (c) to [in=90, out=90, looseness=1.5] (d);
1378 \end{verbatim}\txcol
1379 \end{minipage}
1380 %
1381 \begin{minipage}{0.25\linewidth}
1382 \tikzsetnextfilename{propag_keys_looseness}
1383 %\tikzset{external/force remake}
1384 \begin{tikzpicture}
1385 \begin{feynhand}
1386 \vertex (a) at (0,0); \vertex (b) at (2,0);
1387 \vertex (c) at (3,0); \vertex (d) at (5,0);
1388 \propag[fer] (a) to [in=90, out=90] (b);
1389 \propag[fer] (c) to [in=90, out=90, looseness=1.5] (d);
1390 \end{feynhand}
1391 \end{tikzpicture}
1392 \end{minipage}
1393 \\
1394 The keys \vercol\verb$half left, half right, quarter left, quarter right$\txcol
1395 specify that the line is a half/quarter circle bending to the left/right
1396 with respect to the line's direction.
1397 \vspace{2mm}\\
1398 %
1399 \begin{minipage}{0.7\linewidth}
1400 \vercol\begin{verbatim}
1401 \vertex (a) at (0,0); \vertex (b) at (2,0);
1402 \vertex (c) at (3,1); \vertex (d) at (5,1);
1403 \propag[fer] (a) to [half left] (b);
1404 \propag[fer] (c) to [half right, looseness=1.5] (d);
1405 \end{verbatim}\txcol
1406 \end{minipage}
1407 %
1408 \begin{minipage}{0.25\linewidth}
1409 \tikzsetnextfilename{propag_keys_half}
1410 %\tikzset{external/force remake}
1411 \begin{tikzpicture}
1412 \begin{feynhand}
1413 \vertex (a) at (0,0); \vertex (b) at (2,0);
1414 \vertex (c) at (3,1); \vertex (d) at (5,1);
1415 \propag[fer] (a) to [half left] (b);
1416 \propag[fer] (c) to [half right, looseness=1.5] (d);
1417 \end{feynhand}
1418 \end{tikzpicture}
1419 \end{minipage}
1420 \\
1421 \begin{minipage}{0.7\linewidth}
1422 \vercol\begin{verbatim}
1423 \vertex (a) at (0,0); \vertex (b) at (2,0);
1424 \vertex (c) at (3,1); \vertex (d) at (4,0);
1425 \propag[fer] (a) to [quarter left] (b);
1426 \propag[fer] (c) to [quarter right, looseness=1.5] (d);
1427 \end{verbatim}\txcol
1428 \end{minipage}
1429 %
1430 \begin{minipage}{0.25\linewidth}
1431 \tikzsetnextfilename{propag_keys_quarter}
1432 %\tikzset{external/force remake}
1433 \begin{tikzpicture}
1434 \begin{feynhand}
1435 \vertex (a) at (0,0); \vertex (b) at (2,0);
1436 \vertex (c) at (3,1); \vertex (d) at (4,0);
1437 \propag[fer] (a) to [quarter left] (b);
1438 \propag[fer] (c) to [quarter right, looseness=1.5] (d);
1439 \end{feynhand}
1440 \end{tikzpicture}
1441 \end{minipage}
1442 %
1443 % --------------------------------------------------------------------------------
1444 \vspace{-6mm}
1445 \newpage\subsubsection{Propagator labels and momentum arrows}
1446 \label{sec:_feynmandiagrams_proplabelsmomentum}
1447 %
1448 \noindent
1449 In order to include a label to a propagator line,
1450 we can use TikZ's \blucol\verb!edge label!\txcol key,
1451 see Section~14.13 in the TikZ/PGF Manual \cite{tikz}.
1452 \blucol\verb!edge label!\txcol sets a propagator label
1453 to the left of the propagator line, and the primed version
1454 \blucol\verb!edge label'!\txcol sets one to its right,
1455 see the following example.
1456 Left and right are relative with respect to the line's direction.
1457 \vspace{2mm}\\
1458 %
1459 \begin{minipage}{0.83\linewidth}
1460 \blucol\begin{verbatim}
1461 \vertex (a1) at (0,0); \vertex (a2) at (1,1.5);
1462 \vertex (b1) at (1.5,1.5); \vertex (b2) at (2.5,0);
1463 \propag [fer, Orange] (a1) to [edge label = $k$] (a2);
1464 \propag [fer, Blue] (b1) to [edge label'= $p'$] (b2);
1465 \end{verbatim}\txcol
1466 \end{minipage}
1467 %
1468 \begin{minipage}{0.16\linewidth}
1469 \tikzsetnextfilename{propag_label}
1470 %\tikzset{external/force remake}
1471 \begin{tikzpicture}
1472 \begin{feynhand}
1473 \vertex (a1) at (0,0); \vertex (a2) at (1,1.5);
1474 \vertex (b1) at (1.5,1.5); \vertex (b2) at (2.5,0);
1475 \propag [fer, RedOrange] (a1) to [edge label = $k$] (a2);
1476 \propag [fer, Blue] (b1) to [edge label'= $p'$] (b2);
1477 \end{feynhand}
1478 \end{tikzpicture}
1479 \end{minipage}
1480 \\
1481 In order to add arrows indicating the momentum's direction to a propagator line,
1482 we can use the key \blucol\verb!momentum!\txcol.
1483 The key \blucol\verb!reversed momentum!\txcol draws the arrow in the reverse direction,
1484 and a prime changes the side on which the arrow appears, as above.
1485 FeynHand also offers the 3/6-letter shorthands \blucol\verb!mom!\txcol
1486 and \blucol\verb!revmom!\txcol.
1487 The momentum arrows \emph{do not} inherit the drawing style of the propagator line,
1488 and hence their style can be specified by an extra argument.
1489 \vspace{2mm}\\
1490 %
1491 \begin{minipage}{0.83\linewidth}
1492 \blucol\begin{verbatim}
1493 \vertex (a1) at (0,0); \vertex (a2) at (1,1.5);
1494 \vertex (b1) at (1.5,1.5); \vertex (b2) at (2.5,0);
1495 \propag [fer, Orange, mom={[arrow style=Orange] $k$}] (a1) to (a2);
1496 \propag [fer, Blue, revmom'={[arrow style=Blue] $p'$}] (b1) to (b2);
1497 \end{verbatim}\txcol
1498 \end{minipage}
1499 %
1500 \begin{minipage}{0.16\linewidth}
1501 \tikzsetnextfilename{propag_arrows}
1502 %\tikzset{external/force remake}
1503 \begin{tikzpicture}
1504 \begin{feynhand}
1505 \vertex (a1) at (0,0); \vertex (a2) at (1,1.5);
1506 \vertex (b1) at (1.5,1.5); \vertex (b2) at (2.5,0);
1507 \propag [fer, RedOrange, mom={[arrow style=RedOrange] $k$}] (a1) to (a2);
1508 \propag [fer, Blue, revmom'={[arrow style=Blue] $p'$}] (b1) to (b2);
1509 \end{feynhand}
1510 \end{tikzpicture}
1511 \end{minipage}
1512 \\
1513 Note that \blucol\verb!edge label!\txcol
1514 is an option of the \blucol\verb!to!\txcol key,
1515 whereas \blucol\verb!momentum!\txcol is an option
1516 of the \blucol\verb!\propag!\txcol command.
1517 %
1518 % -------------------------------------------------------------------------------------------------------
1519 \vspace{-3mm}
1520 \subsubsection{Insertions}
1521 \label{sec:_feynmandiagrams_propagators_insertions}
1522 %
1523 \noindent
1524 Insertions can be placed on propagator lines as in the examples below.
1525 The values indicate the fraction of the propagator line's length
1526 at which the insertion marks are drawn.
1527 \\
1528 %
1529 \begin{minipage}{0.83\linewidth}
1530 \vercol\begin{verbatim}
1531 \vertex [dot] (a1) at (0,0) {}; \vertex [dot] (a2) at (2,0) {};
1532 \propag [chabos, red, insertion=0.25, insertion=0.75] (a1) to (a2);
1533 \end{verbatim}\txcol
1534 \end{minipage}
1535 %
1536 \begin{minipage}{0.16\linewidth}
1537 \tikzsetnextfilename{propag_insertion_1}
1538 %\tikzset{external/force remake}
1539 \begin{tikzpicture}
1540 \begin{feynhand}
1541 \vertex [dot] (a1) at (0,0) {};
1542 \vertex [dot] (a2) at (2,0) {};
1543 \propag [chabos, red, insertion=0.25, insertion=0.75] (a1) to (a2);
1544 \end{feynhand}
1545 \end{tikzpicture}
1546 \end{minipage}
1547 \\
1548 \begin{minipage}{0.83\linewidth}
1549 \vercol\begin{verbatim}
1550 \vertex [ringdot] (a1) at (0,0) {}; \vertex [ringdot] (a2) at (2,0) {};
1551 \propag [chabos, red, insertion={[size=6pt,style=Green]0.25}] (a1) to (a2);
1552 \end{verbatim}\txcol
1553 \end{minipage}
1554 %
1555 \begin{minipage}{0.16\linewidth}
1556 \tikzsetnextfilename{propag_insertion_2}
1557 %\tikzset{external/force remake}
1558 \begin{tikzpicture}
1559 \begin{feynhand}
1560 \vertex [ringdot] (a1) at (0,0) {};
1561 \vertex [ringdot] (a2) at (2,0) {};
1562 \propag [chabos, red, insertion={[size=6pt,style=Green]0.25}] (a1) to (a2);
1563 \end{feynhand}
1564 \end{tikzpicture}
1565 \end{minipage}
1566 %
1567 % -------------------------------------------------------------------------------------------------------
1568 \vspace{-3mm}
1569 \subsubsection{Slashes and backslashes}
1570 \label{sec:_feynmandiagrams_propagators_slashes}
1571 %
1572 \noindent
1573 Back/slashes work like insertions:
1574 \\
1575 %
1576 \begin{minipage}{0.83\linewidth}
1577 \vercol\begin{verbatim}
1578 \vertex [dot] (a1) at (0,0) {}; \vertex [dot] (a2) at (2,0) {};
1579 \propag [chabos, red, slash=0.25, slash=0.75] (a1) to (a2);
1580 \end{verbatim}\txcol
1581 \end{minipage}
1582 %
1583 \begin{minipage}{0.16\linewidth}
1584 \tikzsetnextfilename{propag_slash_1}
1585 %\tikzset{external/force remake}
1586 \begin{tikzpicture}
1587 \begin{feynhand}
1588 \vertex [dot] (a1) at (0,0) {};
1589 \vertex [dot] (a2) at (2,0) {};
1590 \propag [chabos, red, slash=0.25, slash=0.75] (a1) to (a2);
1591 \end{feynhand}
1592 \end{tikzpicture}
1593 \end{minipage}
1594 \\
1595 \begin{minipage}{0.83\linewidth}
1596 \vercol\begin{verbatim}
1597 \vertex [ringdot] (a1) at (0,0) {}; \vertex [ringdot] (a2) at (2,0) {};
1598 \propag [chabos, red, backslash={[size=6pt,style=Green]0.25}] (a1) to (a2);
1599 \end{verbatim}\txcol
1600 \end{minipage}
1601 %
1602 \begin{minipage}{0.16\linewidth}
1603 \tikzsetnextfilename{propag_slash_2}
1604 %\tikzset{external/force remake}
1605 \begin{tikzpicture}
1606 \begin{feynhand}
1607 \vertex [ringdot] (a1) at (0,0) {};
1608 \vertex [ringdot] (a2) at (2,0) {};
1609 \propag [chabos, red, backslash={[size=6pt,style=Green]0.25}] (a1) to (a2);
1610 \end{feynhand}
1611 \end{tikzpicture}
1612 \end{minipage}
1613
1614 %
1615 % -------------------------------------------------------------------------------------------------------
1616 \newpage\subsubsection{Crossing propagators (one on top of the other)}
1617 \label{sec:_feynmandiagrams_propagators_top}
1618 %
1619 \noindent
1620 Crossings often indicate that the propagators merely cross on paper
1621 without any physical interaction being implied.
1622 First, draw the propagator line to become crossed/interrupted,
1623 then draw the crossing propagator on top of it by specifying
1624 the additional style key \blucol\verb$top$\txcol.
1625 For more intricate networks of crossing propagators, you can place auxiliary vertices
1626 to break the propagators into parts if necessary,
1627 and then place the respective parts on top of each other.
1628
1629 If due to the crossings you wish to move the arrows of charged particles,
1630 specify \blucol\verb$with arrow=VALUE$\txcol,
1631 respectively \blucol\verb$with reversed arrow=VALUE$\txcol for antiparticles.
1632 \blucol\verb$VALUE$\txcol must be a number between 0 and 1,
1633 and indicates the fraction of propagator length at which TikZ inserts the arrow.
1634 The default value of \blucol\verb$VALUE$\txcol is 0.5.
1635 \vspace{-1mm}\\
1636 %
1637 \begin{minipage}{0.8\linewidth}
1638 \blucol\begin{verbatim}
1639 \vertex (a) at (0,0); \vertex (b) at (2,1);
1640 \vertex (c) at (0,1); \vertex (d) at (2,0);
1641 \propag [chabos, Orange, with arrow=0.25] (c) to (d);
1642 \propag [fer, Blue, top] (a) to (b);
1643 \end{verbatim}\txcol
1644 \end{minipage}
1645 %
1646 \begin{minipage}{0.15\linewidth}
1647 \tikzsetnextfilename{propag_gap_up}
1648 %\tikzset{external/force remake}
1649 \begin{tikzpicture}
1650 \begin{feynhand}
1651 \vertex (a) at (0,0); \vertex (b) at (2,1);
1652 \vertex (c) at (0,1); \vertex (d) at (2,0);
1653 \propag [chabos, Orange, with arrow=0.25] (c) to (d);
1654 \propag [fer, Blue, top] (a) to (b);
1655 \end{feynhand}
1656 \end{tikzpicture}
1657 \end{minipage}
1658 \vspace{-5mm}
1659 \\
1660 %
1661 \begin{minipage}{0.8\linewidth}
1662 \blucol\begin{verbatim}
1663 ...
1664 \propag[gluon, blue] (a) to [out=0, in=180] (b);
1665 \propag[gluon, top] (c) to [out=0, in=180] (d);
1666 \end{verbatim}\txcol
1667 \end{minipage}
1668 %
1669 \begin{minipage}{0.15\linewidth}
1670 \tikzsetnextfilename{propag_gluon_gap}
1671 %\tikzset{external/force remake}
1672 \begin{tikzpicture}
1673 \begin{feynhand}
1674 \vertex (a) at (0,0); \vertex (b) at (2,1);
1675 \vertex (c) at (0,1); \vertex (d) at (2,0);
1676 \propag[gluon, blue] (a) to [out=0, in=180] (b);
1677 \propag[gluon, top] (c) to [out=0, in=180] (d);
1678 \end{feynhand}
1679 \end{tikzpicture}
1680 \end{minipage}
1681 \vspace{-3mm}
1682 %
1683 %
1684 % =====================================================================
1685 %
1686 \subsection{Customizing styles}
1687 \label{sec:_feynmandiagrams_customizing}
1688 %
1689 FeynHand provides the following shortcuts for quickly modifying styles.
1690 Note that any change of these lengths at some point in the code
1691 affects all diagrams that come after this point.
1692 Also recall that if you externalize graphics (see Sec.~\ref{Apx_tikzbasics_externalize}),
1693 then TikZ refreshes pictures \emph{only} when their source code is changed.
1694 Hence to see the effect of such length changes,
1695 delete the external PDF-files or use \vercol\verb$\tikzset{external/force remake}$\txcol.
1696 %
1697 \begin{itemize}
1698 \item
1699 \vercol\verb$\setlength{\feynhanddotsize}{2mm}$\txcol
1700 sets the diameter of the dots to 2mm (default: 1.5mm).
1701 %
1702 \item
1703 \vercol\verb$\setlength{\feynhandblobsize}{10mm}$\txcol
1704 sets the diameter of the blobs to 10mm (default: 7.5mm).
1705 %
1706 \item
1707 \vercol\verb$\setlength{\feynhandlinesize}{2pt}$\txcol
1708 sets the thickness of the propagator lines to 2pt (default: 0.5pt).\\
1709 Also the lines of dots and blobs use this thickness.\\
1710 The momentum arrows' line thickness scales as 0.64 times this value.
1711 Also the amplitudes\\
1712 and section lengths of the boson and photon waves
1713 and of the gluon curls scale with this value.
1714 %
1715 \item
1716 \vercol\verb$\setlength{\feynhandarrowsize}{8pt}$\txcol
1717 sets the size of the arrows to 8pt (default: 6pt)\\
1718 on all charged propagator lines
1719 \vercol\verb$(fer, antfer, chabos, antbos, chasca, antsca, chagho, antgho)$\txcol\\
1720 and majorana lines \vercol\verb$(maj, antmaj).$\txcol
1721 The momentum arrows' tip size scales as 0.8 times this value.
1722 %
1723 \item
1724 \vercol\verb$\setlength{\feynhandtopsep}{8pt}$\txcol
1725 sets the width of the crossing gap for propagators on top of each other.
1726 The default value is \vercol\verb$18\feynhandlinesize$\txcol.
1727 %
1728 \item
1729 \vercol\verb$\renewcommand{\feynhandtopsepcolor}{yellow}$\txcol
1730 sets the color of the crossing gap (default is white).
1731 %
1732 \end{itemize}
1733 %
1734 \noindent
1735 \begin{minipage}{0.6\linewidth}
1736 Example diagram drawn with default values:
1737 \end{minipage}
1738 %
1739 \begin{minipage}{0.38\linewidth}
1740 \tikzsetnextfilename{tikz_customize_default}
1741 %\tikzset{external/force remake}
1742 \begin{tikzpicture}
1743 \begin{feynhand}
1744 \vertex [ringdot] (a) at (0,0) {};
1745 \vertex [NWblob] (b) at (2,0) {};
1746 \vertex [crossdot] (c1) at (4,0.5) {};
1747 \vertex [dot] (c2) at (5,-0.5) {};
1748 \vertex [dot] (d) at (3,-0.5) {};
1749 \propag [chasca, Green] (a) to (b);
1750 \propag [gluon, Blue] (b) to (c2);
1751 \propag [fer, top] (d) to (c1);
1752 \propag [chabos, RedOrange, momentum={[arrow style=RedOrange] $k$}] (b) to (c1);
1753 \end{feynhand}
1754 \end{tikzpicture}
1755 \end{minipage}
1756 \\
1757 \noindent
1758 \begin{minipage}{0.6\linewidth}
1759 Same diagram (same TikZ/FeynHand code) drawn after setting:
1760 \vercol\begin{verbatim}
1761 \setlength{\feynhanddotsize}{2mm}
1762 \setlength{\feynhandblobsize}{10mm}
1763 \setlength{\feynhandlinesize}{1pt}
1764 \setlength{\feynhandarrowsize}{9pt}
1765 \setlength{\feynhandtopsep}{3mm}
1766 \renewcommand{\feynhandtopsepcolor}{yellow}
1767 \end{verbatim}\txcol
1768 \end{minipage}
1769 %
1770 \setlength{\feynhanddotsize}{2mm}
1771 \setlength{\feynhandblobsize}{10mm}
1772 \setlength{\feynhandlinesize}{1pt}
1773 \setlength{\feynhandarrowsize}{9pt}
1774 \setlength{\feynhandtopsep}{3mm}
1775 \renewcommand{\feynhandtopsepcolor}{yellow}
1776 %
1777 \begin{minipage}{0.38\linewidth}
1778 \tikzsetnextfilename{tikz_customize_big}
1779 %\tikzset{external/force remake}
1780 \begin{tikzpicture}
1781 \begin{feynhand}
1782 \vertex [ringdot] (a) at (0,0) {};
1783 \vertex [NWblob] (b) at (2,0) {};
1784 \vertex [crossdot] (c1) at (4,0.5) {};
1785 \vertex [dot] (c2) at (5,-0.5) {};
1786 \vertex [dot] (d) at (3,-0.5) {};
1787 \propag [chasca, Green] (a) to (b);
1788 \propag [gluon, Blue] (b) to (c2);
1789 \propag [fer, top] (d) to (c1);
1790 \propag [chabos, RedOrange, momentum={[arrow style=RedOrange] $k$}] (b) to (c1);
1791 \end{feynhand}
1792 \end{tikzpicture}
1793 \end{minipage}
1794 %
1795 % set again the default values
1796 \setlength{\feynhanddotsize}{1.5mm}
1797 \setlength{\feynhandblobsize}{7.5mm}
1798 \setlength{\feynhandlinesize}{0.5pt}
1799 \setlength{\feynhandarrowsize}{6pt}
1800 \setlength{\feynhandtopsep}{18\feynhandlinesize}
1801 \renewcommand{\feynhandtopsepcolor}{white}
1802 \vspace{-4mm}
1803 \\
1804 The color of a vertex/propagator style can be set for all subsequent diagrams
1805 in the current local Tex group (e.g. document or equation, figure, minipage environment)
1806 by the command \vercol\verb$\tikzfeynhandset$\txcol with the key \vercol\verb$every$\txcol:
1807 %
1808 \vercol\begin{verbatim}
1809 \tikzfeynhandset{every particle={/tikz/color=blue}, every dot={/tikz/color=red},}
1810 \tikzfeynhandset{every fermion={/tikz/color=green},}
1811 \end{verbatim}\txcol
1812
1813 %
1814 % =====================================================================
1815 % =====================================================================
1816 % ===== APPENDICES ============================================
1817 %
1818 %\newpage
1819 \appendix
1820 %
1821 \section{TikZ Basics}
1822 \label{Apx_tikzbasics}
1823 %
1824 This appendix summarizes a few things that can be done with TikZ,
1825 just enough for getting started quickly.\\
1826 You can discover much more, and I recommend
1827 becoming familiar with the TikZ/PGF Manual \cite{tikz} bit by bit.
1828
1829 % =====================================================================
1830 \subsection{Environment}
1831 \label{Apx_tikzbasics_environment}
1832 %
1833 \noindent
1834 All TikZ commands are used within the
1835 \brocol\verb$tikzpicture$\txcol environment.
1836 All TikZ commands that we mention are understood
1837 as appearing in this environment.
1838 When we want to use captions and labels, we enclose it in the
1839 \brocol\verb$figure$\txcol environment, but it can be called
1840 anywhere in the text or math of a Tex document:\\
1841
1842 \noindent
1843 \begin{minipage}{0.6\linewidth}
1844 \brocol\begin{verbatim}
1845 \begin{figure}
1846 \centering
1847 %\tikzset{external/force remake}
1848 \begin{tikzpicture}
1849
1850 ... TikZ commands ...
1851
1852 \end{tikzpicture}
1853 \caption{A diagram drawn with TikZ.}
1854 \label{Fig:_diagram1}
1855 \end{figure}
1856 \end{verbatim}\txcol
1857 \end{minipage}
1858 %
1859 \begin{minipage}{0.39\linewidth}
1860 \brocol\begin{verbatim}
1861 \begin{align*}
1862 \int dx\; f(x) =
1863 \alpha
1864 %\tikzset{external/force remake}
1865 \begin{tikzpicture}
1866
1867 ... TikZ commands ...
1868
1869 \end{tikzpicture}
1870 \end{align*}
1871 \end{verbatim}\txcol
1872 \end{minipage}
1873 %
1874 % =====================================================================
1875 \subsection{Layers}
1876 \label{Apx_tikzbasics_layers}
1877 %
1878 \noindent
1879 In general, objects that are drawn later in the code appear
1880 on top of objects that are drawn earlier (if they overlap).
1881 If we need to declare explicitly which objects
1882 we want to appear on top of other objects,
1883 then we can use layers.
1884
1885 Layers are first declared with \brocol\verb$\pgfdeclarelayer$\txcol
1886 as in the following example, and then their order is set up
1887 from backmost to foremost with \brocol\verb$\pgfsetlayers$\txcol.
1888 The layer \brocol\verb$main$\txcol is predefined and does not need
1889 to be declared, but it must always be included in the order setup,
1890 for example:
1891 %
1892 \brocol\begin{verbatim}
1893 \pgfdeclarelayer{background}
1894 \pgfdeclarelayer{foreground}
1895 \pgfsetlayers{background,main,foreground}
1896 \end{verbatim}\txcol
1897 %
1898 All drawing commands by default are placed on the layer
1899 \brocol\verb$main$\txcol.
1900 For placing them on other layers, they must be enclosed in the
1901 \brocol\verb$\pgfonlayer$\txcol environment as in the following example
1902 (the \brocol\verb$opacity$\txcol option is optional).\\
1903
1904 \noindent
1905 \begin{minipage}{0.83\linewidth}
1906 \brocol\begin{verbatim}
1907 \begin{pgfonlayer}{foreground}
1908 \filldraw[fill=Orange, draw=Red, opacity=0.7] (1,0) circle [radius=6mm];
1909 \end{pgfonlayer}
1910 \filldraw[fill=Blue, draw=black] (1,0) circle [radius=9mm];
1911 \end{verbatim}\txcol
1912 \end{minipage}
1913 %
1914 \begin{minipage}{0.16\linewidth}
1915 \tikzsetnextfilename{tikz_layers}
1916 %\tikzset{external/force remake}
1917 \begin{tikzpicture}
1918 \pgfdeclarelayer{foreground}
1919 \pgfsetlayers{main,foreground}
1920 \begin{pgfonlayer}{foreground}
1921 \filldraw[fill=Orange,draw=Red, opacity=0.7] (1,0) circle [radius=6mm];
1922 \end{pgfonlayer}
1923 \filldraw[fill=Yellow,draw=black] (0,0) circle [radius=8mm];
1924 \end{tikzpicture}
1925 \end{minipage}
1926 %
1927 % =====================================================================
1928 \subsection{Drawing objects}
1929 \label{Apx_tikzbasics_drawing}
1930 %
1931 \noindent
1932 All drawing commands must end with a \;;\; (semicolon).
1933 %
1934 % =====================================================================
1935 \subsubsection{Text and formulas}
1936 %
1937 \noindent
1938 Plain text and LaTex math formulas can be inserted anywhere
1939 in the graphic with TikZ' \brocol\verb$node$\txcol command.
1940 The text is centered at the node's coordinates:\\
1941
1942 \noindent
1943 \begin{minipage}{0.83\linewidth}
1944 \brocol\begin{verbatim}
1945 \filldraw[fill=Yellow, draw=Red] (0,0) circle [radius=1cm];
1946 \node at (-0.8,-0.3) {\textcolor{Blue}{\bfseries Yes! $\alpha^2$}};
1947 \end{verbatim}\txcol
1948 \end{minipage}
1949 %
1950 \begin{minipage}{0.16\linewidth}
1951 \tikzsetnextfilename{tikz_text_math}
1952 %\tikzset{external/force remake}
1953 \begin{tikzpicture}
1954 \filldraw[fill=Yellow, draw=Red] (0,0) circle [radius=1cm];
1955 \node at (-0.8,-0.3) {\textcolor{Blue}{\bfseries Yes! $\alpha^2$}};
1956 \end{tikzpicture}
1957 \end{minipage}
1958 %
1959 %
1960 % =====================================================================
1961 \subsubsection{Lines: straight and smooth}
1962 %
1963 \noindent
1964 A straight line from node (a) to node (b) is drawn by\\
1965
1966 \noindent
1967 \begin{minipage}{0.83\linewidth}
1968 \brocol\begin{verbatim}
1969 \draw [Red, line width = 2pt] (a1) to (a2);
1970 \draw (b1) to [Blue] (b2);
1971 \end{verbatim}\txcol
1972 \end{minipage}
1973 %
1974 \begin{minipage}{0.16\linewidth}
1975 \tikzsetnextfilename{tikz_lines_straight}
1976 %\tikzset{external/force remake}
1977 \begin{tikzpicture}
1978 \node (a1) at (0,0) {};
1979 \node (a2) at (1,0.5) {};
1980 \node (b1) at (2,0) {};
1981 \node (b2) at (3,0.5) {};
1982 \draw [Red, line width = 2pt] (a1) to (a2);
1983 \draw (b1) to [Blue] (b2);
1984 \end{tikzpicture}
1985 \end{minipage}
1986 %
1987 A smooth curve which leaves (a) at an angle of 45 degrees
1988 and enters (b) at 180 degrees is drawn by\\
1989
1990 \noindent
1991 \begin{minipage}{0.83\linewidth}
1992 \brocol\begin{verbatim}
1993 \draw [Green, line width=1mm] (a1) to [out=45, in=180] (a2);
1994 \end{verbatim}\txcol
1995 \end{minipage}
1996 %
1997 \begin{minipage}{0.16\linewidth}
1998 \tikzsetnextfilename{tikz_lines_in_out}
1999 %\tikzset{external/force remake}
2000 \begin{tikzpicture}
2001 \node (a1) at (0,0) {};
2002 \node (a2) at (1,0.5) {};
2003 \draw [Green, line width=1mm] (a1) to [out=45, in=180] (a2);
2004 \end{tikzpicture}
2005 \end{minipage}
2006 \\
2007 \noindent
2008 The angles are with respect to the coordinate system, that is:
2009 0 degrees points right, 90 up, 180 left and 270 down.
2010 %
2011 %
2012 % =====================================================================
2013 \subsubsection{Lines with arrows}
2014 %
2015 Lines can be equipped with arrows by specifying this
2016 in the options of \brocol\verb$\draw$\txcol as inthe examples below.
2017 The most basic arrow styles are:
2018 \brocol\verb$>, Latex, Stealth, Circle, Bar$\txcol.
2019 Note the extra curly braces!\\
2020
2021 \noindent
2022 \begin{minipage}{0.87\linewidth}
2023 \brocol\begin{verbatim}
2024 \draw [->] (a1) to (a2);
2025 \draw [<->,Red, line width = 1pt] (b1) to [out=45, in=135] (b2);
2026 \draw [{Circle[width=5pt,length=5pt]}-{Latex[length=8pt,width=6pt]}] (c1) to (c2);
2027 \draw [{Bar[Red,width=8pt]}-{Stealth[length=8pt, width=6pt]}] (d1) to (d2);
2028 \end{verbatim}\txcol
2029 \end{minipage}
2030 %
2031 \begin{minipage}{0.12\linewidth}
2032 \tikzsetnextfilename{tikz_arrows}
2033 %\tikzset{external/force remake}
2034 \begin{tikzpicture}
2035 \node (a1) at (0,0) {};
2036 \node (a2) at (2,0) {};
2037 \node (b1) at (0,-0.7) {};
2038 \node (b2) at (2,-0.7) {};
2039 \node (c1) at (0,-1) {};
2040 \node (c2) at (2,-1) {};
2041 \node (d1) at (0,-1.5) {};
2042 \node (d2) at (2,-1.5) {};
2043 \draw [->] (a1) to (a2);
2044 \draw [<->,Red, line width = 1pt] (b1) to [out=45, in=135] (b2);
2045 \draw [{Circle[width=5pt,length=5pt]}-{Latex[length=8pt, width=6pt]}] (c1) to (c2);
2046 \draw [{Bar[Red,width=8pt]}-{Stealth[length=8pt, width=6pt]}] (d1) to (d2);
2047 \end{tikzpicture}
2048 \end{minipage}
2049 %
2050 % =====================================================================
2051 \subsection{Externalizing graphics}
2052 \label{Apx_tikzbasics_externalize}
2053 %
2054 \noindent
2055 Externalizing means that TikZ creates a separate PDF file
2056 for each \brocol\verb$tikzpicture$\txcol environment
2057 which it encounters in the document.
2058 That is, when a \brocol\verb$tikzpicture$\txcol is encountered,
2059 TikZ checks whether there is already a corresponding PDF,
2060 and if so, then it includes this PDF with \brocol\verb$\includegraphics$\txcol
2061 and ignores the code in the \brocol\verb$tikzpicture$\txcol,
2062 else it creates the corresponding PDF such that it can be used
2063 in the next LaTex run.
2064 Using the external PDFs can speed up the LaTex runs significantly.
2065 TikZ also takes care of vertically positioning the externalized PDFs
2066 according to the \brocol\verb$baseline$\txcol option
2067 when it is used with \brocol\verb$tikzpicture$\txcol
2068 (this is what the .dpth files are for).
2069 TikZ recognizes automatically when the TikZ code of a graphic has been modified,
2070 and generates fresh PDFs \emph{only} for these modified graphics in the next LaTex run.
2071
2072 In order to activate externalizing, we need to load the library with
2073 \brocol\verb$\usetikzlibrary{external}$\txcol
2074 (which both TikZ-Feynman and FeynHand do automatically)
2075 and put a \brocol\verb$\tikzexternalize[prefix=graphics/tikz/]$\txcol
2076 somewhere above the \brocol\verb$\begin{document}$\txcol command.
2077 Here, we use the \brocol\verb$prefix$\txcol option
2078 for telling TikZ that we want the external files to be created
2079 in the subdirectory \brocol\verb$graphics/tikz/$\txcol of the current dirctory.
2080 It may come in handy to have the TikZ-generated files
2081 in a subfolder separate from the other external graphic files.
2082 For example, in order to assure that the final document contains
2083 the final version of all graphics, we can force TikZ to refresh them
2084 by deleting all external PDFs created by TikZ.
2085 Having these in the separate subfolder avoids deleting graphics from other sources.
2086 Alternatively, we can include \brocol\verb$\tikzset{external/force remake}$\txcol
2087 in the document's preamble to force refresh all external PDFs.
2088 Including \brocol\verb$\tikzset{external/force remake}$\txcol
2089 in a local Tex group force refreshes all external PDFs in this group
2090 (e.g.~an equation, figure or minipage environment).
2091
2092 We also have to tell LaTex to use shell escaping
2093 in order to enable it to create the external files.
2094 TexLive ships with the TexWorks editor, in which this can be achieved
2095 by going to the Edit menu and selecting Preferences.
2096 Next choose the Typesetting rider, select PdfLatex in
2097 the Processing Tools window, and add the argument
2098 -shell-escape by clicking on the + button.
2099 Then, move it to the top of the list by clicking on the up-arrow button.
2100 This should look somewhat like Figure~\ref{Fig:_shell_escape}.
2101 %
2102 \begin{figure}
2103 \centering
2104 \includegraphics[width=0.7\linewidth]{shell_escape.jpg}
2105 \caption{TexWorks screenshot.}
2106 \label{Fig:_shell_escape}
2107 \end{figure}
2108
2109 TikZ creates filenames automatically for the externalized PDFs.
2110 For later use of these, it is often preferrable
2111 to specify these filenames by hand with the
2112 \brocol\verb$\tikzsetnextfilename$\txcol command,
2113 which needs to be placed right above
2114 the \brocol\verb$\begin{tikzpicture}$\txcol
2115 of the corresponding graphic.
2116 For example, \brocol\verb$\tikzsetnextfilename{scatter}$\txcol
2117 tells TikZ to store the next graphic as \brocol\verb$scatter.pdf$\txcol
2118
2119 Apart from speeding up LaTex runs, the external files can also be used
2120 for submissions to journals which do not support TikZ.
2121 One way of doing this works without modifying the graphics' code:
2122 Instead of \brocol\verb$\usepackage{tikz}$\txcol
2123 respectively \brocol\verb$\usepackage{feynhand}$\txcol
2124 we put \brocol\verb$\usepackage{tikzexternal}$\txcol
2125 and include the file \brocol\verb$tikzexternal.sty$\txcol
2126 in our submissions. It basically tells LaTex to ignore
2127 the code in the \brocol\verb$tikzpicture$\txcol environments
2128 and to use the external PDFs instead.
2129 %
2130 If this does not work, then another way is to replace the figures'
2131 \brocol\verb$tikzpicture$\txcol environments by
2132 \brocol\verb$\includegraphics{tikz/filename.pdf}$\txcol
2133 and the equations' \brocol\verb$tikzpicture$\txcol environments
2134 by \brocol\verb$\vcenterbox{\includegraphics{tikz/filename.pdf}}$\txcol
2135 commands, having defined in the preamble:
2136 %
2137 \brocol
2138 \begin{verbatim}
2139 \graphicspath{{graphics/}} % mind the double brackets!
2140 \newcommand{\vcenterbox}[2][0.5]{\raisebox{-#1\height}{#2}}
2141 % \vcenterbox centers the box's content (argument #2) vertically on the baseline.
2142 % The optional argument #1 is for fine adjustment:
2143 % values between 0 and 0.5 raise the box's center above the baseline,
2144 % values between 0.5 and 1 push the box's center below the baseline.
2145 \end{verbatim}
2146 \txcol
2147 %
2148 % =====================================================================
2149 % =====================================================================
2150 % ===== BIBLIOGRAPHY ==========================================
2151 %
2152 \begin{thebibliography}{}
2153 %
2154 \bibitem{tikz} J.~Cr{\'emer}: A very minimal introduction to TikZ,\;
2155 T.~Tantau et al.: TikZ {\&} PGF Manual,\newline
2156 both available at \texttt{https://www.ctan.org/pkg/pgf}
2157 %
2158 \bibitem{tikzfeynman} J.~Ellis: TikZ-Feynman package documentation,%\newline
2159 available at \texttt{https://www.ctan.org/pkg/tikz-feynman}
2160 %
2161 \bibitem{tikzfeynmanArticle} J.~Ellis: TikZ-Feynman: Feynman diagrams with TikZ,
2162 Computer Physics Comm. \textbf{210}, p.103-123, 2017.\newline
2163 \texttt{https://doi.org/10.1016/j.cpc.2016.08.019}\newline
2164 \texttt{http://arxiv.org/abs/1601.05437}
2165 %
2166 \end{thebibliography}{}
2167 %
2168 %
2169 % =====================================================================
2170 %
2171 \end{document}
2172 %
2173 %
2174