main.tex

\documentclass[usenames,dvipsnames]{beamer}

% Set commands for the document
\input{set_up.tex}
\input{math_setup.tex}



% Include the graphics path for the illustrations:
\graphicspath{{/home/sunnivin/Documents/tex/figures/}}

% Set frametitle in each slide
\setbeamertemplate{frametitle}{
  % \vspace{0.2cm}
  \insertframetitle
}


%   Define theorems
\setbeamertemplate{theorems}[numbered]
\theoremstyle{plain}
% \newtheorem{theorem}{Theorem}[section]
\theoremstyle{definition}
% \newtheorem{definition}{Definition}[section]
\newtheorem*{idea}{Conclusion}
\newtheorem*{idea2}{Definition}

% Allow automatic set of curly braces
\DeclarePairedDelimiter\set\{\}

% Allow tabels
\usepackage{multirow}

% Bibliographyci
\bibliographystyle{aipauth4-1}
%\bibliographystyle{apalike}
%\bibliography{bib/books,bib/articles}
\bibliography{bib/urls,bib/articles}

% Define the accents
\usepackage{selinput}
\SelectInputMappings{%
  adieresis={ä},
  eacute={é},
  Lcaron={Ľ},
}


\usepackage[T1]{fontenc}
\usefonttheme[onlymath]{serif}
\renewcommand\sfdefault{serif}




% \AtBeginSection[]
% {
%   {
%       \ifnum \value{framenumber}>1
%     \begin{frame}[noframenumbering]{Outline}
%    \setbeamertemplate{footline}{}
%    \tableofcontents[currentsection,hideallsubsections]
%  \end{frame}
%    \else
%     \fi
%   }
% }



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% The presentation content starts here:
\begin{document}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Title page information:
\title{How to be a 'good' git evangelist? }
 %\subtitle{\color{my_gray}   }
 \institute{
Nordic-RSE Unconference 
  % \color{my_lightgray}
  % \vspace{-0.2cm} \tiny  Institut des Nanosciences de Paris (INSP)
  % \hspace{1.0cm} Surface du Verre et Interfaces (SVI)}
 }

 \author{Sunniva Indrehus }


 \date{\scriptsize June 29, 2021}

 % Include all logos
 \vspace{-2.cm}
 \titlegraphic{
%\centering
   {\hspace*{3cm}
   \includegraphics[width=0.7\linewidth,keepaspectratio]{logos/UiO_Hovedlogo/English/UiO_Seal_A_ENG}
   }
 }
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \frame{
   \titlepage
   \thispagestyle{empty}
 }
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%





%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{Outline}
  \tableofcontents[hideallsubsections]
\end{frame}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


% -------------------------------------------------------------
\section{Why I want to answer this question}
\subsection{My experience}
% -------------------------------------------------------------


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{\setframetitle{}}
  
  \begin{columns}[t]
    \column{.5\textwidth}
    
    \begin{itemize}
      \item PhD in computational physics 
      \begin{itemize}
        \item Plasmonic and optics
      \end{itemize}
      
      \item Currently an RSE
      \begin{itemize}
        \item Meteorology and oceanography
      \end{itemize}
      
    \end{itemize}
    
    \column{.5\textwidth}

    \begin{figure}
      \captionsetup[subfigure]{justification=centering}
      \centering
      \subcaptionbox{An RSE in academia}
      {\myimageShift{width=0.8\linewidth}{illustrations/code_quality/git_evangelist}{Michele Rosenthal}}   
    \end{figure}
    
  \end{columns}
  
\end{frame}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{\setframetitle{}}
\begin{center}
  \begin{figure}
    \captionsetup[subfigure]{justification=centering}
    \centering
    \subcaptionbox{\centering Computational science}
    {\myimage{width=0.5\linewidth}{illustrations/code_quality/computational_science}{https://computingstudy.wordpress.com/scientific-computing/}}
  \end{figure}
\end{center}

\end{frame}



\section{Good scientific software}
\subsection{Question}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{\setframetitle{}}
  \only<1>
  {
    \centering \Large What is good scientific software?
    \newline 
    \footnote{\fullcite{wilson2014best}}, \footnote{\fullcite{academiaCode}}, \footnote{\fullcite{industryLesson2}}, \footnote{\fullcite{industryLesson3}}, \footnote{\fullcite{academiaCodeQuality}}
  }
\end{frame}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%




\subsection{My answer}



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{\setframetitle{}}
  \only<1>
  {
    \begin{columns}[t]
      \column{.5\textwidth}
      \begin{itemize}
      \item Something that works
      \item Standardized
      \item Understandable
      \item Reproducible \footnote{\fullcite{reproducibility}}
      \item
\renewcommand{\thefootnote}{\fnsymbol{footnote}}
Maintainable \footnote{Common estimate: spending 20\% of the developing time
        for maintenance work }
      \end{itemize}
      %
      \column{.5\textwidth}
 \begin{figure}
        \captionsetup[subfigure]{justification=centering}
        \centering
        \subcaptionbox{}
        {\includegraphics[width=\linewidth]{illustrations/code_quality/wtf}}
      \end{figure}
    \end{columns}
}


\end{frame}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


\subsection{Tools} 

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{\setframetitle{}}
  %General tools \footnote{\fullcite{wilson2014best}}, \footnote{\fullcite{bigTech}}:
  \vspace{-0.5cm}
  \begin{columns}[t]
    \column{.5\textwidth}
   \begin{figure}
      \captionsetup[subfigure]{justification=centering}
      \centering
      \subcaptionbox{Version control }
    {\includegraphics[width=0.6\linewidth]{illustrations/code_quality/git}}%
    \hfill
      \subcaptionbox{Documentation}
      {\includegraphics[width=0.6\linewidth]{illustrations/code_quality/comment-your-code}}
    \end{figure}
      \\
      \column{.5\textwidth}
      \begin{figure}
        \captionsetup[subfigure]{justification=centering}
        \centering
        \subcaptionbox{Containerization}
        {\myimageShift{width=0.7\linewidth}{illustrations/code_quality/cloud_computing}{https://www.pinterest.co.uk/pin/536209899356890025/}}
        \hfill
        \subcaptionbox{(Modern) editor}
        {\myimageShift{width=0.85\linewidth}{illustrations/code_quality/editor_fight}{https://i.redd.it/798myjzkwmjz.jpg}}
      \end{figure}
     %
  \end{columns}
  
\end{frame}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{'Good enough' scientific software}
\subsection{Tools \footnote{\fullcite{wilson2017good}}} 

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{\setframetitle{}}
  %General tools \footnote{\fullcite{wilson2014best}}, \footnote{\fullcite{bigTech}}:
  \vspace{-0.5cm}
  \begin{columns}[t]
    \column{.5\textwidth}
   \begin{figure}
      \captionsetup[subfigure]{justification=centering}
      \centering
      \subcaptionbox{Version control }
      {\color{my_raspberry}\setlength{\fboxrule}{2pt}%
\fbox{\includegraphics[width=0.6\linewidth]{illustrations/code_quality/git}}}%
    \hfill 
      \subcaptionbox{Documentation}
      {\includegraphics[width=0.6\linewidth]{illustrations/code_quality/comment-your-code}}
    \end{figure}
      \\
      \column{.5\textwidth}
      \begin{figure}
        \captionsetup[subfigure]{justification=centering}
        \centering
        \subcaptionbox{Containerization}
        {\myimageShift{width=0.7\linewidth}{illustrations/code_quality/cloud_computing}{https://www.pinterest.co.uk/pin/536209899356890025/}}
        \hfill
        \subcaptionbox{(Modern) editor}
        {\myimageShift{width=0.85\linewidth}{illustrations/code_quality/editor_fight}{https://i.redd.it/798myjzkwmjz.jpg}}
      \end{figure}
     %
  \end{columns}
  
\end{frame}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


\section{Discussion}
\subsection{How to be a 'good' git evangelist? }


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{frame}{\setframetitle{}}
\begin{columns}%[t]
  \column{.7\textwidth}
 
  \begin{itemize}
    \setlength\itemsep{1em}
    \item Is version control the most important tool for a scientific developer?  
    \begin{itemize}
      \setlength\itemsep{0.5em}
      \item Are there other tools that are more important? (i.e. debugger, containers )
    \end{itemize}
    \item How can we motivate scientists to learn to use version control? 
    \item Do all code projects need version control? 
    \item When should the scientific developer learn to use version control? 
    \item How and who should teach version control's best practices?
  \end{itemize}
  
    \column{.5\textwidth}
    \begin{figure}
      \captionsetup[subfigure]{justification=centering}
      \centering
      \subcaptionbox{Git usage in a nutshell}
      {\myimageShift{width=0.8\linewidth}{illustrations/code_quality/git_xkcd}{https://xkcd.com/1597/}}   
    \end{figure}
   %
\end{columns}
\end{frame}

\end{document}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%