aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2019-12-07 23:01:06 +0000
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2019-12-07 23:01:06 +0000
commit1c7b440fc20148675a5091c53d5d89b0ac3acefd (patch)
tree944383d441cf3acc8d6761cb4b22d4aac6cdc446
parent52ccebefe0a91636ec154e7a9339588d185ae36c (diff)
Analysis demo graph using sharp-edged boxes for source files
As Raul pointed out, to avoid confusion for a color-blind audience, or when its printed in black-and-white, its best to not just base the source-build distinction in the graph based on color. With this commit, the source files have sharp edges and the built files have round edges.
-rw-r--r--img/analysis-diagram.pdfbin9788 -> 0 bytes
-rw-r--r--img/make-demo-1.pdf (renamed from img/make-demo-1-empty.pdf)bin5615 -> 5173 bytes
-rw-r--r--img/make-demo-10-texsources.pdfbin10091 -> 0 bytes
-rw-r--r--img/make-demo-10.pdfbin0 -> 9378 bytes
-rw-r--r--img/make-demo-11-downloadtex.pdfbin10341 -> 0 bytes
-rw-r--r--img/make-demo-11.pdfbin0 -> 9632 bytes
-rw-r--r--img/make-demo-12-analysis1tex.pdfbin10469 -> 0 bytes
-rw-r--r--img/make-demo-12.pdfbin0 -> 9760 bytes
-rw-r--r--img/make-demo-13-analysis2tex.pdfbin10596 -> 0 bytes
-rw-r--r--img/make-demo-13.pdfbin0 -> 9886 bytes
-rw-r--r--img/make-demo-14-analysis3tex.pdfbin10861 -> 0 bytes
-rw-r--r--img/make-demo-14.pdfbin0 -> 10150 bytes
-rw-r--r--img/make-demo-15-initializetex.pdfbin11009 -> 0 bytes
-rw-r--r--img/make-demo-15.pdfbin0 -> 10297 bytes
-rw-r--r--img/make-demo-16-projecttex.pdfbin11429 -> 0 bytes
-rw-r--r--img/make-demo-16.pdfbin0 -> 10727 bytes
-rw-r--r--img/make-demo-17-paper.pdfbin11670 -> 0 bytes
-rw-r--r--img/make-demo-17.pdfbin0 -> 10968 bytes
-rw-r--r--img/make-demo-2.pdf (renamed from img/make-demo-2-input1.pdf)bin7580 -> 7137 bytes
-rw-r--r--img/make-demo-3.pdf (renamed from img/make-demo-3-out1a.pdf)bin7829 -> 7388 bytes
-rw-r--r--img/make-demo-4-out3a.pdfbin8329 -> 0 bytes
-rw-r--r--img/make-demo-4.pdfbin0 -> 7803 bytes
-rw-r--r--img/make-demo-5-out2a.pdfbin8756 -> 0 bytes
-rw-r--r--img/make-demo-5.pdfbin0 -> 8268 bytes
-rw-r--r--img/make-demo-6-out3b.pdfbin8995 -> 0 bytes
-rw-r--r--img/make-demo-6.pdfbin0 -> 8458 bytes
-rw-r--r--img/make-demo-7-input2.pdfbin9190 -> 0 bytes
-rw-r--r--img/make-demo-7.pdfbin0 -> 8655 bytes
-rw-r--r--img/make-demo-8-out1b.pdfbin9489 -> 0 bytes
-rw-r--r--img/make-demo-8.pdfbin0 -> 8956 bytes
-rw-r--r--img/make-demo-9-out2b.pdfbin9674 -> 0 bytes
-rw-r--r--img/make-demo-9.pdfbin0 -> 9138 bytes
-rw-r--r--reproducible-paper.tex45
-rw-r--r--tex/preamble.tex9
34 files changed, 28 insertions, 26 deletions
diff --git a/img/analysis-diagram.pdf b/img/analysis-diagram.pdf
deleted file mode 100644
index bc052ea..0000000
--- a/img/analysis-diagram.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-1-empty.pdf b/img/make-demo-1.pdf
index 3a4669b..b0cfd86 100644
--- a/img/make-demo-1-empty.pdf
+++ b/img/make-demo-1.pdf
Binary files differ
diff --git a/img/make-demo-10-texsources.pdf b/img/make-demo-10-texsources.pdf
deleted file mode 100644
index c854ba6..0000000
--- a/img/make-demo-10-texsources.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-10.pdf b/img/make-demo-10.pdf
new file mode 100644
index 0000000..17f5b06
--- /dev/null
+++ b/img/make-demo-10.pdf
Binary files differ
diff --git a/img/make-demo-11-downloadtex.pdf b/img/make-demo-11-downloadtex.pdf
deleted file mode 100644
index a36b45e..0000000
--- a/img/make-demo-11-downloadtex.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-11.pdf b/img/make-demo-11.pdf
new file mode 100644
index 0000000..40ebda3
--- /dev/null
+++ b/img/make-demo-11.pdf
Binary files differ
diff --git a/img/make-demo-12-analysis1tex.pdf b/img/make-demo-12-analysis1tex.pdf
deleted file mode 100644
index 69c3487..0000000
--- a/img/make-demo-12-analysis1tex.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-12.pdf b/img/make-demo-12.pdf
new file mode 100644
index 0000000..a203d6f
--- /dev/null
+++ b/img/make-demo-12.pdf
Binary files differ
diff --git a/img/make-demo-13-analysis2tex.pdf b/img/make-demo-13-analysis2tex.pdf
deleted file mode 100644
index e93637f..0000000
--- a/img/make-demo-13-analysis2tex.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-13.pdf b/img/make-demo-13.pdf
new file mode 100644
index 0000000..402e39f
--- /dev/null
+++ b/img/make-demo-13.pdf
Binary files differ
diff --git a/img/make-demo-14-analysis3tex.pdf b/img/make-demo-14-analysis3tex.pdf
deleted file mode 100644
index d5d49aa..0000000
--- a/img/make-demo-14-analysis3tex.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-14.pdf b/img/make-demo-14.pdf
new file mode 100644
index 0000000..bdb23be
--- /dev/null
+++ b/img/make-demo-14.pdf
Binary files differ
diff --git a/img/make-demo-15-initializetex.pdf b/img/make-demo-15-initializetex.pdf
deleted file mode 100644
index 46a3389..0000000
--- a/img/make-demo-15-initializetex.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-15.pdf b/img/make-demo-15.pdf
new file mode 100644
index 0000000..208ed3a
--- /dev/null
+++ b/img/make-demo-15.pdf
Binary files differ
diff --git a/img/make-demo-16-projecttex.pdf b/img/make-demo-16-projecttex.pdf
deleted file mode 100644
index e399b7c..0000000
--- a/img/make-demo-16-projecttex.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-16.pdf b/img/make-demo-16.pdf
new file mode 100644
index 0000000..c94ae94
--- /dev/null
+++ b/img/make-demo-16.pdf
Binary files differ
diff --git a/img/make-demo-17-paper.pdf b/img/make-demo-17-paper.pdf
deleted file mode 100644
index 7c474ec..0000000
--- a/img/make-demo-17-paper.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-17.pdf b/img/make-demo-17.pdf
new file mode 100644
index 0000000..58532c0
--- /dev/null
+++ b/img/make-demo-17.pdf
Binary files differ
diff --git a/img/make-demo-2-input1.pdf b/img/make-demo-2.pdf
index f820ed9..0a4ac54 100644
--- a/img/make-demo-2-input1.pdf
+++ b/img/make-demo-2.pdf
Binary files differ
diff --git a/img/make-demo-3-out1a.pdf b/img/make-demo-3.pdf
index af903de..504d021 100644
--- a/img/make-demo-3-out1a.pdf
+++ b/img/make-demo-3.pdf
Binary files differ
diff --git a/img/make-demo-4-out3a.pdf b/img/make-demo-4-out3a.pdf
deleted file mode 100644
index 0fc659e..0000000
--- a/img/make-demo-4-out3a.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-4.pdf b/img/make-demo-4.pdf
new file mode 100644
index 0000000..c67bfc9
--- /dev/null
+++ b/img/make-demo-4.pdf
Binary files differ
diff --git a/img/make-demo-5-out2a.pdf b/img/make-demo-5-out2a.pdf
deleted file mode 100644
index e2d606e..0000000
--- a/img/make-demo-5-out2a.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-5.pdf b/img/make-demo-5.pdf
new file mode 100644
index 0000000..1b547dd
--- /dev/null
+++ b/img/make-demo-5.pdf
Binary files differ
diff --git a/img/make-demo-6-out3b.pdf b/img/make-demo-6-out3b.pdf
deleted file mode 100644
index ea63f6e..0000000
--- a/img/make-demo-6-out3b.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-6.pdf b/img/make-demo-6.pdf
new file mode 100644
index 0000000..20a104a
--- /dev/null
+++ b/img/make-demo-6.pdf
Binary files differ
diff --git a/img/make-demo-7-input2.pdf b/img/make-demo-7-input2.pdf
deleted file mode 100644
index 21c9a7e..0000000
--- a/img/make-demo-7-input2.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-7.pdf b/img/make-demo-7.pdf
new file mode 100644
index 0000000..ad7e38a
--- /dev/null
+++ b/img/make-demo-7.pdf
Binary files differ
diff --git a/img/make-demo-8-out1b.pdf b/img/make-demo-8-out1b.pdf
deleted file mode 100644
index 120d8d2..0000000
--- a/img/make-demo-8-out1b.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-8.pdf b/img/make-demo-8.pdf
new file mode 100644
index 0000000..825b3b1
--- /dev/null
+++ b/img/make-demo-8.pdf
Binary files differ
diff --git a/img/make-demo-9-out2b.pdf b/img/make-demo-9-out2b.pdf
deleted file mode 100644
index 6b5e6a0..0000000
--- a/img/make-demo-9-out2b.pdf
+++ /dev/null
Binary files differ
diff --git a/img/make-demo-9.pdf b/img/make-demo-9.pdf
new file mode 100644
index 0000000..9e4e7a1
--- /dev/null
+++ b/img/make-demo-9.pdf
Binary files differ
diff --git a/reproducible-paper.tex b/reproducible-paper.tex
index a0a72f0..7776dfd 100644
--- a/reproducible-paper.tex
+++ b/reproducible-paper.tex
@@ -846,27 +846,28 @@
%% Make demo.
- \makedemoslide{img/make-demo-1-empty.pdf}
+ \makedemoslide{img/make-demo-1.pdf}
{Makefiles (\texttt{\*.mk}) keep contextually separate parts of the project, all imported into \texttt{top-make.mk}}
- \makedemoslide{img/make-demo-2-input1.pdf}
+ \makedemoslide{img/make-demo-2.pdf}
{First built/output file (downloaded dataset), managed in \texttt{download.mk}.}
- \makedemoslide{img/make-demo-3-out1a.pdf}
+ \makedemoslide{img/make-demo-3.pdf}
{Downloaded file is used to build analysis-1's first output.}
- \makedemoslide{img/make-demo-4-out3a.pdf}
- {Second built file is for analysis-3, also depends on
+ \makedemoslide{img/make-demo-4.pdf}
+ {Third built file is for analysis-3, also depends on
a value in a configuration file.}
- \makedemoslide{img/make-demo-5-out2a.pdf}
+ \makedemoslide{img/make-demo-5.pdf}
{First input is also used to build another file (using
two configuration parameters).}
- \makedemoslide{img/make-demo-6-out3b.pdf}
+ \makedemoslide{img/make-demo-6.pdf}
{\texttt{out-3b.dat} is automatically built after (depends on) \texttt{out-2a.dat}.}
- \makedemoslide{img/make-demo-7-input2.pdf}
+ \makedemoslide{img/make-demo-7.pdf}
{We now need a second input file, which is downloaded.}
- \makedemoslide{img/make-demo-8-out1b.pdf}
+ \makedemoslide{img/make-demo-8.pdf}
{\texttt{out-1b.dat} depends on \texttt{out-1a.dat},
\texttt{input2.dat} and \texttt{param-1.conf}.}
- \makedemoslide{img/make-demo-9-out2b.pdf}
- {Final hypothetical output file is also built.}
+ \makedemoslide{img/make-demo-9.pdf}
+ {Final hypothetical output file (of the analysis phase) is
+ also built.}
\begin{frame}{Benefits of using Make for storing data lineage}
\Large
@@ -977,30 +978,30 @@
\end{center}
\end{frame}
- \makedemoslide{img/make-demo-9-out2b.pdf}
- {Recall that the data lineage was already recorded in Makefiles.}
- \makedemoslide{img/make-demo-10-texsources.pdf}
+ \makedemoslide{img/make-demo-9.pdf}
+ {Let's start from the end of the analysis phase (same graph as before).}
+ \makedemoslide{img/make-demo-10.pdf}
{Makefiles are also used to connect the analysis with with paper.}
- \makedemoslide{img/make-demo-11-downloadtex.pdf}
+ \makedemoslide{img/make-demo-11.pdf}
{Information from the raw inputs is stored in \texttt{download.tex}.}
- \makedemoslide{img/make-demo-12-analysis1tex.pdf}
+ \makedemoslide{img/make-demo-12.pdf}
{Values to report from the first analysis step are kept in
\texttt{analysis1.tex}.}
- \makedemoslide{img/make-demo-13-analysis2tex.pdf}
+ \makedemoslide{img/make-demo-13.pdf}
{Values to report from the second analysis step are kept in
\texttt{analysis2.tex}.}
- \makedemoslide{img/make-demo-14-analysis3tex.pdf}
+ \makedemoslide{img/make-demo-14.pdf}
{Values to report from the third analysis step are kept in
\texttt{analysis3.tex}.}
- \makedemoslide{img/make-demo-15-initializetex.pdf}
+ \makedemoslide{img/make-demo-15.pdf}
{General project information are stored in \texttt{initialize.tex}.}
- \makedemoslide{img/make-demo-16-projecttex.pdf}
+ \makedemoslide{img/make-demo-16.pdf}
{All the \LaTeX{} macros are loaded into the single
\texttt{project.tex} (after the analysis is complete).}
- \makedemoslide{img/make-demo-17-paper.pdf}
+ \makedemoslide{img/make-demo-17.pdf}
{With the paper's \LaTeX{} source, \texttt{project.tex} is
used to build the final PDF paper.}
- \makedemoslide{img/make-demo-17-paper.pdf}
+ \makedemoslide{img/make-demo-17.pdf}
{Full data lineage (raw input $\leftrightarrow$ every
number/paragraph and plot in paper's PDF) is recorded.}
diff --git a/tex/preamble.tex b/tex/preamble.tex
index 91466be..8cfd71e 100644
--- a/tex/preamble.tex
+++ b/tex/preamble.tex
@@ -39,10 +39,11 @@
%% For the make demo
\newcommand{\makedemoslide}[2] {
\begin{frame}{#2}
- \begin{center}\includegraphics[width=0.8\linewidth]{#1}\end{center}
- \footnotesize \textcolor{green!50!black}{Green boxes} are \emph{source}
- files (hand-written), \textcolor{blue}{Blue boxes} are \emph{built}
- files (automatically generated).
+ \begin{center}\includegraphics[width=0.8\linewidth]{#1}\end{center}\par \vspace{-5mm}
+ \footnotesize \textcolor{green!50!black}{Green boxes} with sharp
+ corners: \emph{source} files (hand written).\\\textcolor{blue}{Blue
+ boxes} with rounded corners: \emph{built} files (automatically
+ generated).
\end{frame}
}