aboutsummaryrefslogtreecommitdiff
path: root/reproducible-paper.tex
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2019-08-20 01:48:39 +0530
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2019-08-20 01:48:39 +0530
commitd56184b4525453bc6157e212b0338a7e82d15b87 (patch)
tree5d7c3af3e88847355754cf082726b8210cc9e15a /reproducible-paper.tex
parent4844158b84de8ab029e1e2f6ce5bd617e823142d (diff)
Git commits in slide now have a checksum
The fact that we only displayed the Git checksum before showing it in the paper could be a little confusing to people not much familiar with Git. So a commit checksum (taken randomly from the history of these slides) was added to it. Also, some minor changes were done here and there.
Diffstat (limited to 'reproducible-paper.tex')
-rw-r--r--reproducible-paper.tex146
1 files changed, 77 insertions, 69 deletions
diff --git a/reproducible-paper.tex b/reproducible-paper.tex
index 413b72d..ca039ec 100644
--- a/reproducible-paper.tex
+++ b/reproducible-paper.tex
@@ -27,8 +27,8 @@
}
%% Set the date and insitutional logos.
-\date{\scriptsize \href{https://ifas5.sciencesconf.org}{5th
- Indo-French Astronomy School}, \href{http://www.iucaa.in}{IUCAA}, Pune (India),\\August 21st, 2019\\
+\date{\scriptsize August 21st, 2019\\\href{https://ifas5.sciencesconf.org}{5th
+ Indo-French Astronomy School}, \href{http://www.iucaa.in}{IUCAA}, Pune (India),\\
\vspace{0.1cm} Slides available at
\textcolor{blue}{\url{http://akhlaghi.org/pdf/reproducible-paper.pdf}}}
@@ -100,7 +100,7 @@
\newcommand{\imgtdir}{/home/mohammad/documents/personal/professional/astronomy/talks/in-prep/images}
- \begin{frame}{Reproducibility is critically important for astronomy}
+ \begin{frame}{Reproducibility is critically important in the sciences (example from astronomy)}
\small
\begin{columns}
\column{6cm} Example: Detecting outer regions of M51 in a
@@ -209,56 +209,6 @@
- \begin{frame}[t]{Types of reproducibility}
- \vspace{-5mm}
- \begin{columns}[t]
- \column{0.5\linewidth}
- \begin{center}
- \large\textbf{Hardware/Statistical reproducibility}
- \rule{0.5\linewidth}{1pt}
- \end{center}
- \begin{itemize}
- \setlength\itemsep{0.5em}
- \item Involves data \alert{collection}.
- \item Inherently includes \alert{measurements errors}\\(can
- never be exactly reproduced).
- \item Example: Raw telescope image/spectra.
- \item \alert{\textbf{NOT DISCUSSED HERE.}}
- \end{itemize}
-
- \vspace{3.5mm}
- \begin{center}
- \vspace{-5mm}
- \includegraphics[width=0.7\linewidth]{img/hale-prime-focus.jpg}\\
- \vspace{-0.6mm}
- \tiny \href{http://slittlefair.staff.shef.ac.uk/teaching/phy217/lectures/telescopes/L07/index.html}{http://slittlefair.staff.shef.ac.uk}
- \end{center}
-
- \column{0.5\linewidth}
- \begin{center}
- \large\textbf{Software/Deterministic reproducibility}
- \rule{0.5\linewidth}{1pt}
- \end{center}
- \begin{itemize}
- \setlength\itemsep{1em}
- \item Involves data \alert{analysis}, or simulations.
- \item Starts \alert{after} data is collected/digitized.
- \item Example: $2+2=4$ (i.e., sum of datasets).
- \item \textbf{\textcolor{green!50!black}{DISCUSSED HERE.}}
- \end{itemize}
-
- \centering
- \vspace{3mm}
- \includegraphics[width=0.8\linewidth]{img/digital-tunnel.jpg}\\
- \vspace{-0.6mm}
- \tiny \href{https://tsongas.com/newsletter_articles/the-new-electronic-version-of-the-advantage/digital-tunnel-wallpaper/}{https://tsongas.com}
- \end{columns}
- \end{frame}
-
-
-
-
-
%% Step-by-step slides.
\newcommand{\allopacity}{1}
\begin{frame}{General outline of a project} \include{tex/project-graph} \end{frame}
@@ -323,6 +273,8 @@
\begin{frame}{General outline of a project} \include{tex/project-graph} \end{frame}
\newcommand{\humanerr}{}
\begin{frame}{General outline of a project} \include{tex/project-graph} \end{frame}
+ \newcommand{\confirmbias}{}
+ \begin{frame}{General outline of a project} \include{tex/project-graph} \end{frame}
\newcommand{\depupdate}{}
\begin{frame}{General outline of a project} \include{tex/project-graph} \end{frame}
\newcommand{\coauth}{}
@@ -399,6 +351,57 @@
+
+ \begin{frame}[t]{Types of reproducibility}
+ \vspace{-5mm}
+ \begin{columns}[t]
+ \column{0.5\linewidth}
+ \begin{center}
+ \large\textbf{Hardware/Statistical reproducibility}
+ \rule{0.5\linewidth}{1pt}
+ \end{center}
+ \begin{itemize}
+ \setlength\itemsep{0.5em}
+ \item Involves data \alert{collection}.
+ \item Inherently includes \alert{measurements errors}\\(can
+ never be exactly reproduced).
+ \item Example: Raw telescope image/spectra.
+ \item \alert{\textbf{NOT DISCUSSED HERE.}}
+ \end{itemize}
+
+ \vspace{3.5mm}
+ \begin{center}
+ \vspace{-5mm}
+ \includegraphics[width=0.7\linewidth]{img/hale-prime-focus.jpg}\\
+ \vspace{-0.6mm}
+ \tiny \href{http://slittlefair.staff.shef.ac.uk/teaching/phy217/lectures/telescopes/L07/index.html}{http://slittlefair.staff.shef.ac.uk}
+ \end{center}
+
+ \column{0.5\linewidth}
+ \begin{center}
+ \large\textbf{Software/Deterministic reproducibility}
+ \rule{0.5\linewidth}{1pt}
+ \end{center}
+ \begin{itemize}
+ \setlength\itemsep{1em}
+ \item Involves data \alert{analysis}, or simulations.
+ \item Starts \alert{after} data is collected/digitized.
+ \item Example: $2+2=4$ (i.e., sum of datasets).
+ \item \textbf{\textcolor{green!50!black}{DISCUSSED HERE.}}
+ \end{itemize}
+
+ \centering
+ \vspace{3mm}
+ \includegraphics[width=0.8\linewidth]{img/digital-tunnel.jpg}\\
+ \vspace{-0.6mm}
+ \tiny \href{https://tsongas.com/newsletter_articles/the-new-electronic-version-of-the-advantage/digital-tunnel-wallpaper/}{https://tsongas.com}
+ \end{columns}
+ \end{frame}
+
+
+
+
+
\newcommand{\focusonpackages}{}
\begin{frame}{General outline of a project} \include{tex/project-graph} \end{frame}
\let\focusonpackages\undefined
@@ -847,6 +850,8 @@
+
+
\begin{frame}{New projects branch from template} \include{tex/git-branch} \end{frame}
\newcommand{\projinit}{}
\begin{frame}{New projects branch from template} \include{tex/git-branch} \end{frame}
@@ -860,22 +865,8 @@
\begin{frame}{New projects branch from template} \include{tex/git-branch} \end{frame}
\newcommand{\githappy}{}
\begin{frame}{New projects branch from template} \include{tex/git-branch} \end{frame}
-
-
-
-
- \begin{frame}{Project source and its execution}
- \begin{tcolorbox}
- Programs \textcolor{gray}{[here: Scientific projects]} must be
- written for \alert{people to read}...
-
- \hfill ...and only \emph{incidentally} for machines to
- \emph{execute}.
-
- \vspace{2mm}
- \hfill \footnotesize Harold Abelson, Structure and Interpretation of Computer Programs
- \end{tcolorbox}
- \end{frame}
+ \newcommand{\gitverified}{}
+ \begin{frame}{New projects branch from template} \include{tex/git-branch} \end{frame}
@@ -913,6 +904,23 @@
+ \begin{frame}{Project source and its execution}
+ \begin{tcolorbox}
+ Programs \textcolor{gray}{[here: Scientific projects]} must be
+ written for \alert{people to read}...
+
+ \hfill ...and only \emph{incidentally} for machines to
+ \emph{execute}.
+
+ \vspace{2mm}
+ \hfill \footnotesize Harold Abelson, Structure and Interpretation of Computer Programs
+ \end{tcolorbox}
+ \end{frame}
+
+
+
+
+
\begin{frame}{Future prospects...}
\large Adoption of reproducibility by many researchers will enable
the following: