From 1c7b440fc20148675a5091c53d5d89b0ac3acefd Mon Sep 17 00:00:00 2001 From: Mohammad Akhlaghi Date: Sat, 7 Dec 2019 23:01:06 +0000 Subject: 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. --- img/analysis-diagram.pdf | Bin 9788 -> 0 bytes img/make-demo-1-empty.pdf | Bin 5615 -> 0 bytes img/make-demo-1.pdf | Bin 0 -> 5173 bytes img/make-demo-10-texsources.pdf | Bin 10091 -> 0 bytes img/make-demo-10.pdf | Bin 0 -> 9378 bytes img/make-demo-11-downloadtex.pdf | Bin 10341 -> 0 bytes img/make-demo-11.pdf | Bin 0 -> 9632 bytes img/make-demo-12-analysis1tex.pdf | Bin 10469 -> 0 bytes img/make-demo-12.pdf | Bin 0 -> 9760 bytes img/make-demo-13-analysis2tex.pdf | Bin 10596 -> 0 bytes img/make-demo-13.pdf | Bin 0 -> 9886 bytes img/make-demo-14-analysis3tex.pdf | Bin 10861 -> 0 bytes img/make-demo-14.pdf | Bin 0 -> 10150 bytes img/make-demo-15-initializetex.pdf | Bin 11009 -> 0 bytes img/make-demo-15.pdf | Bin 0 -> 10297 bytes img/make-demo-16-projecttex.pdf | Bin 11429 -> 0 bytes img/make-demo-16.pdf | Bin 0 -> 10727 bytes img/make-demo-17-paper.pdf | Bin 11670 -> 0 bytes img/make-demo-17.pdf | Bin 0 -> 10968 bytes img/make-demo-2-input1.pdf | Bin 7580 -> 0 bytes img/make-demo-2.pdf | Bin 0 -> 7137 bytes img/make-demo-3-out1a.pdf | Bin 7829 -> 0 bytes img/make-demo-3.pdf | Bin 0 -> 7388 bytes img/make-demo-4-out3a.pdf | Bin 8329 -> 0 bytes img/make-demo-4.pdf | Bin 0 -> 7803 bytes img/make-demo-5-out2a.pdf | Bin 8756 -> 0 bytes img/make-demo-5.pdf | Bin 0 -> 8268 bytes img/make-demo-6-out3b.pdf | Bin 8995 -> 0 bytes img/make-demo-6.pdf | Bin 0 -> 8458 bytes img/make-demo-7-input2.pdf | Bin 9190 -> 0 bytes img/make-demo-7.pdf | Bin 0 -> 8655 bytes img/make-demo-8-out1b.pdf | Bin 9489 -> 0 bytes img/make-demo-8.pdf | Bin 0 -> 8956 bytes img/make-demo-9-out2b.pdf | Bin 9674 -> 0 bytes img/make-demo-9.pdf | Bin 0 -> 9138 bytes reproducible-paper.tex | 45 +++++++++++++++++++------------------ tex/preamble.tex | 9 ++++---- 37 files changed, 28 insertions(+), 26 deletions(-) delete mode 100644 img/analysis-diagram.pdf delete mode 100644 img/make-demo-1-empty.pdf create mode 100644 img/make-demo-1.pdf delete mode 100644 img/make-demo-10-texsources.pdf create mode 100644 img/make-demo-10.pdf delete mode 100644 img/make-demo-11-downloadtex.pdf create mode 100644 img/make-demo-11.pdf delete mode 100644 img/make-demo-12-analysis1tex.pdf create mode 100644 img/make-demo-12.pdf delete mode 100644 img/make-demo-13-analysis2tex.pdf create mode 100644 img/make-demo-13.pdf delete mode 100644 img/make-demo-14-analysis3tex.pdf create mode 100644 img/make-demo-14.pdf delete mode 100644 img/make-demo-15-initializetex.pdf create mode 100644 img/make-demo-15.pdf delete mode 100644 img/make-demo-16-projecttex.pdf create mode 100644 img/make-demo-16.pdf delete mode 100644 img/make-demo-17-paper.pdf create mode 100644 img/make-demo-17.pdf delete mode 100644 img/make-demo-2-input1.pdf create mode 100644 img/make-demo-2.pdf delete mode 100644 img/make-demo-3-out1a.pdf create mode 100644 img/make-demo-3.pdf delete mode 100644 img/make-demo-4-out3a.pdf create mode 100644 img/make-demo-4.pdf delete mode 100644 img/make-demo-5-out2a.pdf create mode 100644 img/make-demo-5.pdf delete mode 100644 img/make-demo-6-out3b.pdf create mode 100644 img/make-demo-6.pdf delete mode 100644 img/make-demo-7-input2.pdf create mode 100644 img/make-demo-7.pdf delete mode 100644 img/make-demo-8-out1b.pdf create mode 100644 img/make-demo-8.pdf delete mode 100644 img/make-demo-9-out2b.pdf create mode 100644 img/make-demo-9.pdf diff --git a/img/analysis-diagram.pdf b/img/analysis-diagram.pdf deleted file mode 100644 index bc052ea..0000000 Binary files a/img/analysis-diagram.pdf and /dev/null differ diff --git a/img/make-demo-1-empty.pdf b/img/make-demo-1-empty.pdf deleted file mode 100644 index 3a4669b..0000000 Binary files a/img/make-demo-1-empty.pdf and /dev/null differ diff --git a/img/make-demo-1.pdf b/img/make-demo-1.pdf new file mode 100644 index 0000000..b0cfd86 Binary files /dev/null and b/img/make-demo-1.pdf differ diff --git a/img/make-demo-10-texsources.pdf b/img/make-demo-10-texsources.pdf deleted file mode 100644 index c854ba6..0000000 Binary files a/img/make-demo-10-texsources.pdf and /dev/null differ diff --git a/img/make-demo-10.pdf b/img/make-demo-10.pdf new file mode 100644 index 0000000..17f5b06 Binary files /dev/null and b/img/make-demo-10.pdf differ diff --git a/img/make-demo-11-downloadtex.pdf b/img/make-demo-11-downloadtex.pdf deleted file mode 100644 index a36b45e..0000000 Binary files a/img/make-demo-11-downloadtex.pdf and /dev/null differ diff --git a/img/make-demo-11.pdf b/img/make-demo-11.pdf new file mode 100644 index 0000000..40ebda3 Binary files /dev/null and b/img/make-demo-11.pdf differ diff --git a/img/make-demo-12-analysis1tex.pdf b/img/make-demo-12-analysis1tex.pdf deleted file mode 100644 index 69c3487..0000000 Binary files a/img/make-demo-12-analysis1tex.pdf and /dev/null differ diff --git a/img/make-demo-12.pdf b/img/make-demo-12.pdf new file mode 100644 index 0000000..a203d6f Binary files /dev/null and b/img/make-demo-12.pdf differ diff --git a/img/make-demo-13-analysis2tex.pdf b/img/make-demo-13-analysis2tex.pdf deleted file mode 100644 index e93637f..0000000 Binary files a/img/make-demo-13-analysis2tex.pdf and /dev/null differ diff --git a/img/make-demo-13.pdf b/img/make-demo-13.pdf new file mode 100644 index 0000000..402e39f Binary files /dev/null and b/img/make-demo-13.pdf differ diff --git a/img/make-demo-14-analysis3tex.pdf b/img/make-demo-14-analysis3tex.pdf deleted file mode 100644 index d5d49aa..0000000 Binary files a/img/make-demo-14-analysis3tex.pdf and /dev/null differ diff --git a/img/make-demo-14.pdf b/img/make-demo-14.pdf new file mode 100644 index 0000000..bdb23be Binary files /dev/null and b/img/make-demo-14.pdf differ diff --git a/img/make-demo-15-initializetex.pdf b/img/make-demo-15-initializetex.pdf deleted file mode 100644 index 46a3389..0000000 Binary files a/img/make-demo-15-initializetex.pdf and /dev/null differ diff --git a/img/make-demo-15.pdf b/img/make-demo-15.pdf new file mode 100644 index 0000000..208ed3a Binary files /dev/null and b/img/make-demo-15.pdf differ diff --git a/img/make-demo-16-projecttex.pdf b/img/make-demo-16-projecttex.pdf deleted file mode 100644 index e399b7c..0000000 Binary files a/img/make-demo-16-projecttex.pdf and /dev/null differ diff --git a/img/make-demo-16.pdf b/img/make-demo-16.pdf new file mode 100644 index 0000000..c94ae94 Binary files /dev/null and b/img/make-demo-16.pdf differ diff --git a/img/make-demo-17-paper.pdf b/img/make-demo-17-paper.pdf deleted file mode 100644 index 7c474ec..0000000 Binary files a/img/make-demo-17-paper.pdf and /dev/null differ diff --git a/img/make-demo-17.pdf b/img/make-demo-17.pdf new file mode 100644 index 0000000..58532c0 Binary files /dev/null and b/img/make-demo-17.pdf differ diff --git a/img/make-demo-2-input1.pdf b/img/make-demo-2-input1.pdf deleted file mode 100644 index f820ed9..0000000 Binary files a/img/make-demo-2-input1.pdf and /dev/null differ diff --git a/img/make-demo-2.pdf b/img/make-demo-2.pdf new file mode 100644 index 0000000..0a4ac54 Binary files /dev/null and b/img/make-demo-2.pdf differ diff --git a/img/make-demo-3-out1a.pdf b/img/make-demo-3-out1a.pdf deleted file mode 100644 index af903de..0000000 Binary files a/img/make-demo-3-out1a.pdf and /dev/null differ diff --git a/img/make-demo-3.pdf b/img/make-demo-3.pdf new file mode 100644 index 0000000..504d021 Binary files /dev/null and b/img/make-demo-3.pdf differ diff --git a/img/make-demo-4-out3a.pdf b/img/make-demo-4-out3a.pdf deleted file mode 100644 index 0fc659e..0000000 Binary files a/img/make-demo-4-out3a.pdf and /dev/null differ diff --git a/img/make-demo-4.pdf b/img/make-demo-4.pdf new file mode 100644 index 0000000..c67bfc9 Binary files /dev/null and b/img/make-demo-4.pdf differ diff --git a/img/make-demo-5-out2a.pdf b/img/make-demo-5-out2a.pdf deleted file mode 100644 index e2d606e..0000000 Binary files a/img/make-demo-5-out2a.pdf and /dev/null differ diff --git a/img/make-demo-5.pdf b/img/make-demo-5.pdf new file mode 100644 index 0000000..1b547dd Binary files /dev/null and b/img/make-demo-5.pdf differ diff --git a/img/make-demo-6-out3b.pdf b/img/make-demo-6-out3b.pdf deleted file mode 100644 index ea63f6e..0000000 Binary files a/img/make-demo-6-out3b.pdf and /dev/null differ diff --git a/img/make-demo-6.pdf b/img/make-demo-6.pdf new file mode 100644 index 0000000..20a104a Binary files /dev/null and b/img/make-demo-6.pdf differ diff --git a/img/make-demo-7-input2.pdf b/img/make-demo-7-input2.pdf deleted file mode 100644 index 21c9a7e..0000000 Binary files a/img/make-demo-7-input2.pdf and /dev/null differ diff --git a/img/make-demo-7.pdf b/img/make-demo-7.pdf new file mode 100644 index 0000000..ad7e38a Binary files /dev/null and b/img/make-demo-7.pdf differ diff --git a/img/make-demo-8-out1b.pdf b/img/make-demo-8-out1b.pdf deleted file mode 100644 index 120d8d2..0000000 Binary files a/img/make-demo-8-out1b.pdf and /dev/null differ diff --git a/img/make-demo-8.pdf b/img/make-demo-8.pdf new file mode 100644 index 0000000..825b3b1 Binary files /dev/null and b/img/make-demo-8.pdf differ diff --git a/img/make-demo-9-out2b.pdf b/img/make-demo-9-out2b.pdf deleted file mode 100644 index 6b5e6a0..0000000 Binary files a/img/make-demo-9-out2b.pdf and /dev/null differ diff --git a/img/make-demo-9.pdf b/img/make-demo-9.pdf new file mode 100644 index 0000000..9e4e7a1 Binary files /dev/null and b/img/make-demo-9.pdf 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} } -- cgit v1.2.1