diff options
| -rw-r--r-- | img/make-demo-1-raw.pdf | bin | 0 -> 6489 bytes | |||
| -rw-r--r-- | img/make-demo-10-texsources.pdf | bin | 0 -> 9826 bytes | |||
| -rw-r--r-- | img/make-demo-11-downloadtex.pdf | bin | 0 -> 9986 bytes | |||
| -rw-r--r-- | img/make-demo-12-analysis1tex.pdf | bin | 0 -> 10109 bytes | |||
| -rw-r--r-- | img/make-demo-13-analysis2tex.pdf | bin | 0 -> 10235 bytes | |||
| -rw-r--r-- | img/make-demo-14-analysis3tex.pdf | bin | 0 -> 10501 bytes | |||
| -rw-r--r-- | img/make-demo-15-initializetex.pdf | bin | 0 -> 10650 bytes | |||
| -rw-r--r-- | img/make-demo-16-projectex.pdf | bin | 0 -> 11078 bytes | |||
| -rw-r--r-- | img/make-demo-17-paper.pdf | bin | 0 -> 11266 bytes | |||
| -rw-r--r-- | img/make-demo-2-input1.pdf | bin | 0 -> 7268 bytes | |||
| -rw-r--r-- | img/make-demo-3-out1a.pdf | bin | 0 -> 7504 bytes | |||
| -rw-r--r-- | img/make-demo-4-out3a.pdf | bin | 0 -> 7787 bytes | |||
| -rw-r--r-- | img/make-demo-5-out2a.pdf | bin | 0 -> 8073 bytes | |||
| -rw-r--r-- | img/make-demo-6-out3b.pdf | bin | 0 -> 8305 bytes | |||
| -rw-r--r-- | img/make-demo-7-input2.pdf | bin | 0 -> 8517 bytes | |||
| -rw-r--r-- | img/make-demo-8-out1b.pdf | bin | 0 -> 8764 bytes | |||
| -rw-r--r-- | img/make-demo-9-out2b.pdf | bin | 0 -> 8949 bytes | |||
| -rw-r--r-- | reproducible-paper.tex | 81 |
18 files changed, 70 insertions, 11 deletions
diff --git a/img/make-demo-1-raw.pdf b/img/make-demo-1-raw.pdf Binary files differnew file mode 100644 index 0000000..ec9530b --- /dev/null +++ b/img/make-demo-1-raw.pdf diff --git a/img/make-demo-10-texsources.pdf b/img/make-demo-10-texsources.pdf Binary files differnew file mode 100644 index 0000000..9a57969 --- /dev/null +++ b/img/make-demo-10-texsources.pdf diff --git a/img/make-demo-11-downloadtex.pdf b/img/make-demo-11-downloadtex.pdf Binary files differnew file mode 100644 index 0000000..4277da7 --- /dev/null +++ b/img/make-demo-11-downloadtex.pdf diff --git a/img/make-demo-12-analysis1tex.pdf b/img/make-demo-12-analysis1tex.pdf Binary files differnew file mode 100644 index 0000000..46c75cb --- /dev/null +++ b/img/make-demo-12-analysis1tex.pdf diff --git a/img/make-demo-13-analysis2tex.pdf b/img/make-demo-13-analysis2tex.pdf Binary files differnew file mode 100644 index 0000000..38188d8 --- /dev/null +++ b/img/make-demo-13-analysis2tex.pdf diff --git a/img/make-demo-14-analysis3tex.pdf b/img/make-demo-14-analysis3tex.pdf Binary files differnew file mode 100644 index 0000000..a71a3ca --- /dev/null +++ b/img/make-demo-14-analysis3tex.pdf diff --git a/img/make-demo-15-initializetex.pdf b/img/make-demo-15-initializetex.pdf Binary files differnew file mode 100644 index 0000000..bc2570a --- /dev/null +++ b/img/make-demo-15-initializetex.pdf diff --git a/img/make-demo-16-projectex.pdf b/img/make-demo-16-projectex.pdf Binary files differnew file mode 100644 index 0000000..0d46859 --- /dev/null +++ b/img/make-demo-16-projectex.pdf diff --git a/img/make-demo-17-paper.pdf b/img/make-demo-17-paper.pdf Binary files differnew file mode 100644 index 0000000..888b299 --- /dev/null +++ b/img/make-demo-17-paper.pdf diff --git a/img/make-demo-2-input1.pdf b/img/make-demo-2-input1.pdf Binary files differnew file mode 100644 index 0000000..9b342fd --- /dev/null +++ b/img/make-demo-2-input1.pdf diff --git a/img/make-demo-3-out1a.pdf b/img/make-demo-3-out1a.pdf Binary files differnew file mode 100644 index 0000000..92189ad --- /dev/null +++ b/img/make-demo-3-out1a.pdf diff --git a/img/make-demo-4-out3a.pdf b/img/make-demo-4-out3a.pdf Binary files differnew file mode 100644 index 0000000..0f25649 --- /dev/null +++ b/img/make-demo-4-out3a.pdf diff --git a/img/make-demo-5-out2a.pdf b/img/make-demo-5-out2a.pdf Binary files differnew file mode 100644 index 0000000..52f0599 --- /dev/null +++ b/img/make-demo-5-out2a.pdf diff --git a/img/make-demo-6-out3b.pdf b/img/make-demo-6-out3b.pdf Binary files differnew file mode 100644 index 0000000..c429d6b --- /dev/null +++ b/img/make-demo-6-out3b.pdf diff --git a/img/make-demo-7-input2.pdf b/img/make-demo-7-input2.pdf Binary files differnew file mode 100644 index 0000000..aff99d9 --- /dev/null +++ b/img/make-demo-7-input2.pdf diff --git a/img/make-demo-8-out1b.pdf b/img/make-demo-8-out1b.pdf Binary files differnew file mode 100644 index 0000000..fe6f123 --- /dev/null +++ b/img/make-demo-8-out1b.pdf diff --git a/img/make-demo-9-out2b.pdf b/img/make-demo-9-out2b.pdf Binary files differnew file mode 100644 index 0000000..b25a4ea --- /dev/null +++ b/img/make-demo-9-out2b.pdf diff --git a/reproducible-paper.tex b/reproducible-paper.tex index 9543f6e..8cebe7b 100644 --- a/reproducible-paper.tex +++ b/reproducible-paper.tex @@ -101,7 +101,15 @@ top color=white, bottom color=green!50!black!20 } } - +%% 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). + \end{frame} + } @@ -883,10 +891,41 @@ - \begin{frame}{With Make, we can record the full data lineage} - \centering - \includegraphics[width=0.8\linewidth]{img/analysis-diagram.pdf} - \end{frame} + %% Make demo. + \makedemoslide{img/make-demo-1-raw.pdf} + {Source files (containing instructions and configuration parameters).} + \makedemoslide{img/make-demo-2-input1.pdf} + {First built/output file (downloaded dataset).} + \makedemoslide{img/make-demo-3-out1a.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 + a value in a configuration file.} + \makedemoslide{img/make-demo-5-out2a.pdf} + {First input is also used to build another file (using + two configuration parameters).} + \makedemoslide{img/make-demo-6-out3b.pdf} + {\texttt{out-bb.dat} is built after \texttt{out-2a.dat}.} + \makedemoslide{img/make-demo-7-input2.pdf} + {We now need a second input file, which is downloaded.} + \makedemoslide{img/make-demo-8-out1b.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} + {SUMMARY: The exact lineage of data is thus recorded in Makefiles.} + + + + + + + + + + + + + @@ -959,12 +998,32 @@ \end{center} \end{frame} - \begin{frame}{We have the full data lineage (raw input $\rightarrow$ every number and plot in paper's PDF)} - \centering - \includegraphics[width=0.8\linewidth]{img/analysis-diagram.pdf} - \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} + {Makefiles are also used to connect the analysis with with paper.} + \makedemoslide{img/make-demo-11-downloadtex.pdf} + {Information from the raw inputs is stored in \texttt{download.tex}.} + \makedemoslide{img/make-demo-12-analysis1tex.pdf} + {Values to report from the first analysis step are kept in + \texttt{analysis1.tex}.} + \makedemoslide{img/make-demo-13-analysis2tex.pdf} + {Values to report from the second analysis step are kept in + \texttt{analysis2.tex}.} + \makedemoslide{img/make-demo-14-analysis3tex.pdf} + {Values to report from the third analysis step are kept in + \texttt{analysis3.tex}.} + \makedemoslide{img/make-demo-15-initializetex.pdf} + {General project information are stored in \texttt{initialize.tex}.} + \makedemoslide{img/make-demo-16-projectex.pdf} + {All the \TeX{} macros are loaded into the single + \texttt{project.tex} (after the analysis is complete).} + \makedemoslide{img/make-demo-17-paper.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} + {Full data lineage (raw input $\leftrightarrow$ every + number/paragraph and plot in paper's PDF) is recorded.} |