1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
%% PGFPlots settings
%% -----------------
%
%% PGFPLOTS is a package in (La)TeX for making plots internally. It fits
%% nicely with the purpose of a reproducible project. But it isn't
%% mandatory. Therefore if you don't need it, just comment/delete the line
%% that includes this file in the top LaTeX source (`paper.tex').
%
%% However, TiKZ and PGFPlots are the recommended way to include figures
%% and plots in your paper. There are two main reasons: 1) it follows the
%% same LaTeX settings as the text of the paper, so the figures will be in
%% the exact same settings (for example font or lines) as the main body of
%% the papers. 2) It doesn't require any extra dependency (it is
%% distributed as part of TeX-live). Adding specific programs/libraries for
%% plots can greatly increase the number of dependencies for the
%% project. For example Python's Matplotlib library is indeed very good,
%% but it requires Python and Numpy. The latter is not easy to build from
%% source, so after a few years, installing the required version can be
%% very frustrating.
%
%% Keeping all BibLaTeX settings in a separate preamble was done in the
%% spirit of modularity to 1) easily managable, 2) If a similar BibLaTeX
%% configuration is necessary in another LaTeX compilation, this file can
%% just be copied there and used.
%
%% PGFPlots uses the (La)TeX TiKZ package to build plots. So we will first
%% do the settings that are necessary in TiKZ, and then go onto the actual
%% PGFPlots package.
%%
%% USAGE:
%
%% - All plots are made within a `tikz' directory (that must already be
%% present in the location LaTeX is run).
%
%% - Use `\includetikz{XXXX}' to make/use the figure. If a `makepdf' LaTeX
%% macro is not defined, then \includetikz will assume a `XXXX.pdf' file
%% exists in `tex/tikz' and simply import it. If `makepdf' is defined,
%% then TiKZ/PGFPlot will be called to (possibly) build the plot based
%% on `tex/XXXX.tex'. Note that if the contents of `tex/src/XXXX.tex'
%% hasn't changed since the last build. TiKZ/PGFPlots won't rebuild the
%% plot.
%
%% Copyright (C) 2018-2020 Mohammad Akhlaghi <mohammad@akhlaghi.org>
%
%% This LaTeX file is part of Maneage. Maneage is free software: you can
%% redistribute it and/or modify it under the terms of the GNU General
%% Public License as published by the Free Software Foundation, either
%% version 3 of the License, or (at your option) any later version.
%
%% Maneage is distributed in the hope that it will be useful, but WITHOUT
%% ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
%% FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
%% for more details. See <http://www.gnu.org/licenses/>.
%% Very general TiKZ settings. In particular, to allow faster processing
%% (not having to re-build the plots on every run), we are using the
%% externalization feature of TiKZ. With this option, TiKZ will build every
%% figure independently in a special directory afterwards it will include
%% the built figure in the final file. This has many advantages: 1) if the
%% code for the plot hasn't changed, then the plot won't be re-made (can be
%% slow with detailed plots). 2) You can use the PDFs of the individual
%% plots for other purposes (for example to include in slides) cleanly.
\usepackage{tikz}
\usetikzlibrary{graphs}
\usetikzlibrary{external}
\usetikzlibrary{positioning}
\tikzexternalize
\tikzsetexternalprefix{tikz/}
%% The following rule will cause the name of the files keeping a figure's
%% external PDF to be set based on the file that the TiKZ commands are
%% from. Without this, TiKZ will use numbers based on the order of
%% figures. These numbers can be hard to manage and they will also depend
%% on order in the final PDF, so it will be very buggy to manage them.
\newcommand{\includetikz}[2]{%
\ifdefined\makepdf%
\tikzsetnextfilename{#1}%
\input{tex/src/#1.tex}%
\else
\includegraphics[#2]{tex/tikz/#1.eps}
\fi
}
%% Uncomment the following lines for TiKZ external images to be saved as
%% EPS and PS images.
\tikzset{
external/system call={
rm -f "\image".eps "\image".ps "\image".dvi;
latex \tikzexternalcheckshellescape -halt-on-error
-interaction=batchmode -jobname "\image" "\texsource";
dvips -o "\image".ps "\image".dvi;
ps2eps "\image.ps"
}
}
%% Inport and configure PGFPlots.
\usepackage{pgfplots}
\pgfplotsset{compat=newest}
\usepgfplotslibrary{groupplots}
\pgfplotsset{
axis line style={thick},
tick style={semithick},
tick label style = {font=\footnotesize},
every axis label = {font=\footnotesize},
legend style = {font=\footnotesize},
label style = {font=\footnotesize}
}
%% Nodes in demo graphs
%% sub-Makefiles.
\tikzset{node-makefile/.style={
thick,
rectangle,
anchor=north,
minimum height=4.7cm,
minimum width=2.1cm,
draw=green!50!black!50,
fill=black!10!green!12!white}}
%% Input files (green, sharp-edged boxes).
\tikzset{node-nonterminal/.style={
rectangle,
very thick,
anchor=north,
text centered,
top color=white,
text width=1.7cm,
minimum height=4mm,
draw=green!50!black!50,
bottom color=green!80!black!50,
font=\ttfamily}}
\tikzset{node-terminal/.style={
rectangle,
very thick,
draw=blue!50,
text centered,
top color=white,
text width=1.7cm,
minimum height=4mm,
rounded corners=2mm,
bottom color=blue!20,
font=\ttfamily}}
%%%%%%%%%%%%%%%%%%%
\tikzset{node-nonterminal-thin/.style={
rectangle,
thick,
text centered,
top color=white,
text width=2cm,
minimum size=2mm,
draw=green!50!black!50,
bottom color=green!80!black!50,
font=\ttfamily\scriptsize}}
\tikzset{node-point/.style={
circle,
black!50,
inner sep=0pt,
minimum size=0pt,
fill=white}}
\tikzset{ bbox/.style={
rectangle,
minimum width=2.5cm,
rounded corners=2mm,
very thick,draw=blue!50,
top color=white,
bottom color=blue!20 } }
\tikzset{ rbox/.style={
rectangle,
dotted,
minimum width=2.5cm,
rounded corners=2mm,
very thick,draw=red!50!black!50,
top color=white,
bottom color=red!50!black!20 } }
\tikzset{ gbox/.style={
rectangle,
minimum width=2.5cm,
very thick,
draw=green!50!black!50,
top color=white,
bottom color=green!50!black!20 } }
\tikzset{ dirbox/.style={
thick,
rectangle,
anchor=north,
text centered,
font=\ttfamily,
minimum width=15cm,
minimum height=7.5cm,
draw=brown!50!black!50,
fill=brown!10!white }}
|
