Lectures/Deadlines.tex

@@ -4,12 +4,12 @@
 \frametitle{Administrative Details: Report Deadlines}
 ~\newline
 \begin{tabular}{l l l}
-\textbf{Problem Statement} & Week 02 & Jan ?19?\\
-\textbf{System Req.\ Spec.\ (SRS)} & Week 04 & ?Feb 2?\\
-\textbf{System VnV Plan} & Week 06 & Feb ?16?\\
-\textbf{MG + MIS} & Week 09 & Mar ?15?\\
-{Drasil Code} & Week 09 & Mar ?15?\\
-{Final Documentation} & Week 13 & Apr ?12?\\
+%{Problem Statement} & Week 02 & Jan 17\\
+%{System Req.\ Spec.\ (SRS)} & Week 04 & Feb 05\\
+%\textbf{System VnV Plan} & Week 06 & Feb 26\\
+%{MG + MIS} & Week 10 & Mar 19\\
+%{Drasil Code} & Week 09 & Mar 14\\
+{Final Documentation} & Week 13 & Apr 11\\
 \end {tabular}
 
 \bi
@@ -31,13 +31,13 @@ traditional SRS
 \frametitle{Administrative Details: Presentations}
 
 ~\newline
-\begin{tabular}{l l l}
-\textbf{SRS} & Week 03/04 & \textbf{Week of Jan 23, 30}?\\
-\textbf{Syst.\ VnV} & Week 06 & Week of Feb 12?\\
-\textbf{POC Demo} & Week 07 & Week of Feb 26?\\
-\textbf{MG + MIS} & Week 09 & Week of Mar 11?\\
-Drasil & Week 11 & Week of Mar 27?\\
-Unit VnV/Implement & Week 12 & Week of Apr 3?\\
+\begin{tabular}{l l}
+%{SRS} & Week 03/04\\
+%\textbf{Syst.\ VnV} & Week 06\\
+%{POC Demo} & Week 08\\
+%{MG + MIS} & Week 10\\
+%Drasil & Week 11 \\
+Unit VnV/Implement & Week 12 \\
 \end {tabular}
 
 \bi
@@ -59,32 +59,33 @@ take it personally
 \begin{frame}
 \frametitle{Presentation Schedule}
 
-%TBD
 %\bi
+
 % \item SRS Present (15 min)
 % \bi
-% %\item {Jan 26: Yiding, Adrian, Cynthia, Hunter, Valerie, Waqar}
-% %\item {Jan 30: Morteza, Gaofeng, Kim Ying, Seyed Ali, Fasil, Xinyu}
-% \item {Feb 2: Phil, Nada, Yi-Leng, Atiyeh, Tanya, Al}
-% \item {Feb 6: Waqar, Fatemeh}
+% \item {Jan 24: Uriel, Yasmin, Christopher, Baptiste, Kiran}
+% \item {Jan 28: Bo, Joe, Junwei, Aliyah, Ziyang}
+% \item {Jan 31: Yuanqi, Qianlin, Phillip, Hussein}
+% \item {Feb 4: Alaap, Yinying}
 % \ei
 
 %\item Syst V\&V Plan Present (L11, L12) (20 min)
-%\bi
-%\item {Feb 13: Fasil, Hunter, Phil, Adrian}
-%\item {Feb 16: Gaofeng, Al, Seyed Ali, Xinyu}
-%\ei
-% \item Proof of Concept Demonstrations (L14) (20 min)
 % \bi
-% \item {Mar 1: Cynthia, Valerie, Waqar, Yi-Leng}
+% \item {Feb 14: Qianlin, Junwei, Joe, Volunteer?}
+% \item {Feb 25: Yinying, Bo, Hussein, Volunteer?}
 % \ei
+%\item Proof of Concept Demonstrations (L14) (20 min)
+%\bi
+%\item {Mar 4:  Christopher, Uriel,  Volunteer?, Volunteer?}
+%\ei
 % \item MG+MIS Present (L17, L18) (20 minutes)  %(Drasil SRS Code)
 % \bi
-% \item {Mar 12: Nada, Morteza, Kim Ying, Atiyeh}
-% \item {Mar 15: Fatemeh, Yiding, Tanya, Volunteer?}
-% \ei
+% \item {Mar 14: Ziyang, Aliyah, Yuanqi, Alaap}
+% \item {Mar 18: Phillip, Baptiste, Kiran, Volunteer?}
 % \ei
 
+%\ei
+
 \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -92,16 +93,15 @@ take it personally
 \begin{frame}
 \frametitle{Presentation Sched Cont'd}
 
-%TBD
-% \bi
-% \item Implementation Present (15 min each)
-% \bi
-% \item 
-% % \item \textbf{Apr 2: Phil, Xinyu, Fasil, Yi-Leng}
-% % \item \textbf{Apr 5: Gaofeng, Morteza, Valerie, Hunter, Ali}
-% % \item \textbf{Apr 9: Cynthia, Adrian, Yiding, Kim Ying, Nada}
-% \ei
-% \ei
+\bi
+\item Implementation Present (L22 -- L25) (20 min each)
+\bi
+\item \textbf{Mar 28: Aliyah, Uriel, Ziyang, Yuanqi}
+\item \textbf{Apr 1: Christopher, Bo, Joe, Junwei}
+\item \textbf{Apr 4: Hussein, Kiran, Alaap, Qianlin}
+\item \textbf{Apr 8: Yinying, Baptiste, Phillip}
+\ei
+\ei
 
 \end{frame}
 
@@ -111,17 +111,12 @@ take it personally
 \frametitle{Presentation Schedule}
 
 \bi
-% \item Test or Impl.\ Present (25 min each)
-% \bi
-% \item Apr 5: Lesley, Deesha, Volunteer? 
-% \item Apr 6: Mina, Joachim, Maryam 
-% \ei
-\item 3 or 4 presentations each %(please check)
+\item 3 presentations each %(please check)
 \begin{itemize}
   \item SRS everyone
   \item VnV and POC subset of class
   \item Design subset of class
-  \item Implementation everyone
+  \item Implementation or testing results everyone
 \end{itemize}
 
 \item If you will miss a presentation, please trade with someone

Lectures/GitHubReviews.tex

@@ -6,7 +6,7 @@
 \bi
 \item Project owners
 \bi
-\item ``Domain Expert'' and ``Secondary Reviewer''
+\item ``Domain Expert''
 \item Find your reviewers in \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/blob/master/Repos.csv}
   {Repos.csv} 
 \item Add your reviewers as collaborators
@@ -15,6 +15,7 @@
 \ei
 \item Reviewers
 \bi
+\item Use the Peer Review issue template
 \item Provide at least 5 issues on the document
 \item Grading
 \bi

Lectures/L01_IntroToCourse/IntroToCourse.tex

@@ -80,6 +80,10 @@
 \item Publication resources available at:
   \url{https://gitlab.cas.mcmaster.ca/smiths/pub} (CAS)
 \end{itemize}
+\item Course schedule is available as a
+\href{https://calendar.google.com/calendar/embed?src=ck33dc9ulk4baddq46pdfmnbu0\%40group.calendar.google.com&ctz=America\%2FToronto}
+{google calendar}
+
 \end{itemize}
 
 \end{frame}
@@ -855,7 +859,7 @@ slides
 \item
   \href{https://gitlab.cas.mcmaster.ca/smiths/pub/-/blob/master/ParnasAndClements1986.pdf}
   {\bibentry{ParnasAndClements1986}}
-\item \href{https://github.com/smiths/swhs}{Solar Water Heating System Example}
+\item \href{https://jacquescarette.github.io/Drasil/examples/swhsnopcm/SRS/HTML/SWHSNoPCM_SRS.html}{Solar Water Heating System Example}
 \item
   \href{https://jacquescarette.github.io/Drasil/examples/swhs/SRS/srs/SWHS_SRS.html}
   {Solar Water Heating System Example SRS (Generated by Drasil)}

Lectures/L02_GettingStarted/GettingStarted.tex

@@ -103,6 +103,10 @@ request} to modify
 network
 \item Participation grades will be posted before the end of the term, providing
   an opportunity to improve
+\item Course schedule is available as a
+\href{https://calendar.google.com/calendar/embed?src=ck33dc9ulk4baddq46pdfmnbu0\%40group.calendar.google.com&ctz=America\%2FToronto}
+{google calendar}
+
 \ei
 
 \end{frame}
@@ -595,7 +599,7 @@ First either init repo or clone (git init, git clone), then typical workflow is
 \item
   \href{https://gitlab.cas.mcmaster.ca/smiths/pub/-/blob/master/ParnasAndClements1986.pdf}
   {{ParnasAndClements1986}~\cite{ParnasAndClements1986}}
-\item \href{https://github.com/smiths/swhs}{Solar Water Heating System Example}
+\item \href{https://jacquescarette.github.io/Drasil/examples/swhsnopcm/SRS/HTML/SWHSNoPCM_SRS.html}{Solar Water Heating System Example}
 
 \end{itemize}
 

Lectures/L03_Requirements/Requirements.tex

@@ -28,7 +28,8 @@
 
 \useoutertheme{split} %so the footline can be seen, without needing pgfpages
 
-%\pgfpagesuselayout{resize to}[letterpaper,border shrink=5mm,landscape]  %if this is uncommented, the hyperref links do not work
+%\pgfpagesuselayout{resize to}[letterpaper,border shrink=5mm,landscape]  %if
+%this is uncommented, the hyperref links do not work
 
 \mode<presentation>{}
 
@@ -85,7 +86,7 @@ create a new repo
 request} to modify
 \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/blob/master/Repos.csv}
 {Repos.csv} with your project details
-\item Only two projects in Repos.csv so far
+\item No projects in Repos.csv so far
 \item \structure{Is anyone still considering dropping the course?}
 \ei
 
@@ -599,11 +600,31 @@ Draw a diagram showing the relationships between the various software qualities
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+\begin{frame}
+\frametitle{Requirements for Projectile}
+\vspace{-1.0cm}
+\begin{center}
+\includegraphics[scale=0.55]{../Figures/Launch.jpg}
+\end{center}
+\vspace{-1.0cm}
+\begin{itemize}
+  \item Simplifying assumptions? (scope decisions, modelling decisions)
+  \item Kinematic theories for translational motion?
+  \item Data constraints on input? output?
+  \item Types?
+  \item Rationale?
+  \item \href{https://github.com/smiths/caseStudies/blob/master/CaseStudies/projectile/projectileSRS_RefinedTheories/Projectile_SRS.pdf}
+  {Refined Theories Projectile SRS}
+\end{itemize}
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 \begin{frame}
 \frametitle{Goal Statements for SWHS}
 
 \structure{What are the goal statement for the Solar Water Heating System?
-(\href{https://jacquescarette.github.io/Drasil/examples/nopcm/SRS/srs/NoPCM_SRS.html}
+(\href{https://jacquescarette.github.io/Drasil/examples/swhsnopcm/SRS/HTML/SWHSNoPCM_SRS.html}
 {NoPCM SRS})} 
 
 ~\\
@@ -634,8 +655,8 @@ temperature of the water, and material properties, the goal statements are:
 \begin{itemize}
   \item Consider using names instead of numbers for labels.
   \item For
-\href{https://jacquescarette.github.io/Drasil/examples/swhs/SRS/srs/SWHS_SRS.html}
-{SWHS} add goals related to the Phase Change Material
+\href{https://github.com/smiths/swhs/blob/master/docs/SRS/PCM_SRS.pdf}
+{SWHS} adds goals related to the Phase Change Material
 \end{itemize}
 
 \end{frame}
@@ -748,15 +769,15 @@ Also Goal Statements and Requirements
 \begin{itemize}
 
 \item
-  \href{https://jacquescarette.github.io/Drasil/examples/projectile/SRS/srs/Projectile_SRS.html}
+  \href{https://jacquescarette.github.io/Drasil/examples/projectile/SRS/HTML/Projectile_SRS.html}
   {Projectile Example}
 \item \href{https://github.com/smiths/caseStudies/blob/master/CaseStudies/projectile/projectileSRS_RefinedTheories/Projectile_SRS.pdf}
 {Refined Theories Projectile SRS}
 \item
-  \href{https://jacquescarette.github.io/Drasil/examples/glassbr/SRS/srs/GlassBR_SRS.html}
-  {GlassBR Example}
+  \href{https://jacquescarette.github.io/Drasil/examples/glassbr/SRS/mdBook/book/title.html}
+  {GlassBR Example (mdBook)}
 \item
-  \href{https://jacquescarette.github.io/Drasil/examples/swhs/SRS/srs/SWHS_SRS.html}
+  \href{https://jacquescarette.github.io/Drasil/examples/swhsnopcm/SRS/HTML/SWHSNoPCM_SRS.html}
   {SWHS Example}
 \item
 \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/blob/master/Examples/aorta/SRS.pdf?ref_type=heads}
@@ -776,26 +797,6 @@ Also Goal Statements and Requirements
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\begin{frame}
-\frametitle{Requirements for Projectile}
-\vspace{-1.0cm}
-\begin{center}
-\includegraphics[scale=0.55]{../Figures/Launch.jpg}
-\end{center}
-\vspace{-1.0cm}
-\begin{itemize}
-  \item Simplifying assumptions? (scope decisions, modelling decisions)
-  \item Kinematic theories for translational motion?
-  \item Data constraints on input? output?
-  \item Types?
-  \item Rationale?
-  \item \href{https://github.com/smiths/caseStudies/blob/master/CaseStudies/projectile/projectileSRS_RefinedTheories/Projectile_SRS.pdf}
-  {Refined Theories Projectile SRS}
-\end{itemize}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
 \begin{frame}[allowframebreaks]
 \frametitle{References}
 

Lectures/L04_ReqContinued/ReqContinued.tex

@@ -52,7 +52,8 @@
 \item Questions?
 %\item Wrap up software qualities topic
 %\item Commonality Analysis versus Software Requirements Spec
-\item Some advice
+\item Finish example goal statements
+\item Some advice on developing your SRS
 \item Requirements documentation for scientific computing
 \item A new requirements template
 \item Advantages of new template and examples
@@ -74,11 +75,11 @@
 \item Name your repo something other than \texttt{cas741}
 \item Assign me an issue to review your problem statements
 \bi
-\item Clearly state that you would like me to review your problem statement
+\item State that you would like a review
 \item Include a link to your problem statement
 \ei
 \item Do not put generated files under version control
-\item Create a \texttt{.gitignore} file
+\item Understand your \texttt{.gitignore} file
 \item Keep your tex files to 80 character width (easier for change tracking)
 \ei
 
@@ -109,12 +110,26 @@
   \item Modify \texttt{Repos.csv}, \texttt{git add}, \texttt{git commit}
   \item Check your diff
   \item Merge request
+  \item Note: do a fresh pull first, monitor other \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/merge_requests} {merge requests}
+\end{itemize}
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}
+\frametitle{Questions? Continued}
+\begin{itemize}
+\item Does anyone need help with \LaTeX{}?
+\begin{itemize}
+  \item Suggest using VSCode with LTeX
 \end{itemize}
 \item Questions about project choices?
 \item Questions about software tools?
 \item Questions about problem statements?
-%\item Questions about software qualities?
 \end{itemize}
+
 \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -175,6 +190,81 @@
 % \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\begin{frame}
+\frametitle{Goal Statements for GlassBR}
+
+For
+\href{https://jacquescarette.github.io/Drasil/examples/glassbr/SRS/srs/GlassBR_SRS.html}
+{GlassBR}:
+
+~\\
+
+Given the dimensions of the glass plane, glass type, the characteristics of the
+explosion, and the tolerable probability of breakage, the goal statements are:
+\begin{itemize}
+\item[GS1:] Analyze and predict whether the glass slab under consideration will
+  be able to withstand the explosion of a certain degree which is calculated
+  based on user input.
+\end{itemize}  
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}[plain]
+\frametitle{Goal Statements for Game Physics}
+
+\noindent For
+\href{https://jacquescarette.github.io/Drasil/examples/gamephysics/SRS/srs/GamePhysics_SRS.html}
+{Game Physics}:
+
+\begin{itemize}
+	
+\item[G\_linear:] Given the physical properties, initial positions and
+  velocities, and forces applied on a set of rigid bodies, determine their new
+  positions and velocities over a period of time (IM-IM\_FT).
+
+\item[G\_ang:] Given the physical properties, initial orientations and
+  angular velocities, and forces applied on a set of rigid bodies, determine
+  their new orientations and angular velocities over a period of
+  time. (IM-IM\_FR).
+
+\item[G\_dtcCol:] Given the initial positions and velocities of a set
+  of rigid bodies, determine if any of them will collide with one another over a
+  period of time.
+
+\item[G\_Col:] Given the physical properties, initial linear and angular
+  positions and velocities, determine the new positions and velocities over a
+  period of time of rigid bodies that have undergone a collision (IM-IM\_C).
+
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}
+\frametitle{Goal Statements for Linear Solver}
+
+\structure{What would be a good goal statement for a library of linear solvers?}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}
+\frametitle{Goal Statements for Linear Solver}
+
+\begin{itemize}
+	
+\item[G1] Given a system of $n$ linear equations represented by matrix $A$ and
+  column vector $b$, return $x$ such that $Ax = b$, if possible
+
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \begin{frame}
 \frametitle{Major Conceptual Parts of SRS/CA}
@@ -235,7 +325,7 @@ Also Goal Statements and Requirements
 % \frametitle{Goal Statements for SWHS}
 
 % \structure{What are the goal statement for the
-% \href{https://jacquescarette.github.io/Drasil/examples/swhs/SRS/srs/SWHS_SRS.html}
+% \href{https://jacquescarette.github.io/Drasil/examples/swhsnopcm/SRS/HTML/SWHSNoPCM_SRS.html}
 % {Solar Water Heating System}?}
 % \begin{center}
 %  \includegraphics[width=0.5\textwidth]{../Figures/Tank.pdf}
@@ -390,11 +480,11 @@ Also Goal Statements and Requirements
   \href{https://jacquescarette.github.io/Drasil/examples/glassbr/SRS/srs/GlassBR_SRS.html}
   {GlassBR Example}
 \item
-  \href{https://jacquescarette.github.io/Drasil/examples/swhs/SRS/srs/SWHS_SRS.html}
-  {SWHS Example}
+  \href{https://jacquescarette.github.io/Drasil/examples/swhsnopcm/SRS/HTML/SWHSNoPCM_SRS.html}
+  {SWHS Example} (Let's go through this one)
 \item
   \href{https://github.com/smiths/capTemplate/blob/main/docs/SRS/SRS.pdf}
-  {Blank SRS from Template}
+  {Blank SRS from Template} (Let's look at the advice/hints)
 \item
   \href{https://github.com/smiths/capTemplate/blob/main/docs/Checklists/SRS-Checklist.pdf} {Checklist}
 \end{itemize}
@@ -1060,6 +1150,38 @@ to improve reliability
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+\begin{frame}
+\frametitle{Feedback From Previous Years}
+\begin{itemize}
+\item Remember that you are writing the document for someone other than yourself
+\item Introduction section gives the name for the software/library
+\item Use \texttt{citep} and \texttt{citet} for \texttt{natbib}
+\item When the assumptions are listed, traceability is given to where they are
+used
+\item If assumptions are not used, then they may not be necessary, or they might
+be scope decisions
+\item For NFRs, specify what you want, not how to achieve it
+\item NFRs can point to the VnV plan for details (to make them unambiguous)
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}
+\frametitle{Feedback From Previous Years}
+\begin{itemize}
+\item For reader/user characteristics, give the target course and what level it is taught.  (Use a generic name, not a specific course name.)
+\item Rationale provided for assumptions, scope decisions and constraints
+\item Include a reference to the source of the template you are using
+\item Requirements should trace to IMs
+\item Define all symbols in table of contents and in Description field
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 \begin{frame}[allowframebreaks]
 \frametitle{References}
 

Lectures/L05_ProgramFamilies/ProgramFamilies.tex

@@ -66,7 +66,7 @@
 \bi
 \item Administrative details
 \item Motivating a document driven design process %including documentation
-\item Finish up SRS
+\item Finish up SRS Example
 \item Requirements specification qualities 
 \item Motivation for families
 \item Proposed family methods
@@ -88,7 +88,7 @@
 \item Not all projects approved
 (\href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/blob/master/Repos.csv?ref_type=heads}
 {Repos.csv})
-
+\item All rubrics available on Avenue (please verify you can see them)
 %\item 80 columns in tex files
 %\item Spell check
 %\item Replace ``in order to'' by ``to''
@@ -215,6 +215,32 @@ Water Heating System}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+\begin{frame}
+
+\frametitle{Examples, Checklist and Template}
+
+\begin{itemize}
+
+\item
+  \href{https://jacquescarette.github.io/Drasil/examples/projectile/SRS/srs/Projectile_SRS.html}
+  {Projectile Example}
+\item
+  \href{https://jacquescarette.github.io/Drasil/examples/glassbr/SRS/srs/GlassBR_SRS.html}
+  {GlassBR Example}
+\item
+  \href{https://jacquescarette.github.io/Drasil/examples/swhsnopcm/SRS/HTML/SWHSNoPCM_SRS.html}
+  {SWHS Example} (Let's go through this one)
+\item
+  \href{https://github.com/smiths/capTemplate/blob/main/docs/SRS/SRS.pdf}
+  {Blank SRS from Template} (Let's look at the advice/hints)
+\item
+  \href{https://github.com/smiths/capTemplate/blob/main/docs/Checklists/SRS-Checklist.pdf} {Checklist}
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 % \begin{frame}
 % \frametitle{More Example Projects}
 % \bi
@@ -256,6 +282,24 @@ Water Heating System}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+\begin{frame}
+\frametitle{Software Requirements Activities}
+\begin{itemize}
+\item A software requirement is a description of how the system should behave,
+  or of a system property or attribute
+\item Requirements should be \textbf{abstract}, \textbf{unambiguous},
+\textbf{complete}, \textbf{consistent}, \textbf{modifiable}, \textbf{verifiable}
+and \textbf{traceable}
+\item Requirements should express ``What'' not ``How''
+\item Formal versus informal specification
+\item Functional versus nonfunctional requirements
+\item Software requirements specification (SRS)
+\item Requirements template
+\end{itemize}
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 % \begin{frame}
 % \frametitle{Kreyman and Parnas Five Variable Model}
 % \begin{itemize}
@@ -607,7 +651,8 @@ PS1.a & $L$ &  & &... & &...  & & & $\surd$  & ... & & ... & ... \\
 }
 ~\newline
 ~\newline
-\textbf{A10}. The deflection of the beam is caused by bending moment only, the shear does not contribute.\\
+\textbf{A10}. The deflection of the beam is caused by bending moment only, the
+shear does not contribute.\\
 %\textbf{A15}. The beam behaves as a rigid body
 \end{frame}
 
@@ -1236,10 +1281,12 @@ at the end of a word.}
 
 \begin{itemize}
 
-\item Program family idea since the 1970s (Dijkstra, Parnas, Weiss, Pohl, ...) - variabilities are often from a finite
-set of simple options \cite{Parnas1976, Parnas1979, Dijkstra1972}
-\item Families of algorithms and code generation in SC (Carette, ATLAS, Blitz++, ...) - not much emphasis on
-requirements \cite{Carette2006, WhaleyEtAl2001, Veldhuizen1998, Blitz2010}
+\item Program family idea since the 1970s (Dijkstra, Parnas, Weiss, Pohl, ...) --
+variabilities are often from a finite set of simple options \cite{Parnas1976,
+Parnas1979, Dijkstra1972}
+\item Families of algorithms and code generation in SC (Carette, ATLAS, Blitz++,
+...) -- not much emphasis on requirements \cite{Carette2006, WhaleyEtAl2001,
+Veldhuizen1998, Blitz2010}
 %\item Problem Solving Environments (PSEs)
 \item Work on requirements for SC
 \begin{itemize}
@@ -1520,10 +1567,11 @@ $n: \mathbb{N}$ & number of linear equations/number of unknowns\\
 $A: \mathbb{R}^{n \times n}$ & $n \times n$ real matrix\\
 $x: \mathbb{R}^{n \times 1}$ & $n \times 1$ real column vector\\
 $b: \mathbb{R}^{n \times 1}$ & $n \times 1$ real column vector\\
-$I: \mathbb{R}^{n \times n}$ & an $n \times n$ matrix where all entries are $0$, except for the diagonal entries, which
-are $1$\\
+$I: \mathbb{R}^{n \times n}$ & an $n \times n$ matrix where all entries are $0$,
+except for the diagonal entries, which are $1$\\
 $|| v || $ & the norm (estimate of magnitude) of vector $v$\\
-$A^{-1}: \mathbb{R}^{n \times n}$ & the inverse matrix, with the property that $A^{-1} A = I$\\
+$A^{-1}: \mathbb{R}^{n \times n}$ & the inverse matrix, with the property that
+$A^{-1} A = I$\\
 singular & matrix $A$ is singular if $A^{-1}$ does not exist\\
 residual & $|| b - A x ||$\\
 \end{tabular}
@@ -1539,7 +1587,8 @@ residual & $|| b - A x ||$\\
 
 \begin{itemize}
 	
-\item \structure{What would be the most general binding time for the variabilities?}
+\item \structure{What would be the most general binding time for the
+variabilities?}
     
 \end{itemize}
 

Lectures/L09_VerificationAndValidation/VerificAndValid.tex

@@ -43,10 +43,10 @@
 \frametitle{Verification and Validation}
 
 \bi
-\item TO DO - cite
+\item 
 \href{https://ideas-productivity.org/assets/artifacts/hpcbp/hpcbp-083-gettingitright.pdf}
 {Cohen2024} presentation ``Getting it Right: System Testing of Scientific
-Software''
+Software'' (similar content to these slides)
 \item Administrative details
 \item Questions?
 \item 741 workflow
@@ -68,11 +68,11 @@ template}
 \frametitle{Administrative Details}
 
 \bi
-\item SRS Presentation grades on Avenue
+\item SRS Presentation grades on Avenue (well done!)
 \item Create GitHub issues for your colleagues (see next slide)
 \item Go ahead and address the colleague created issues
 \item No classes for Reading week %(Feb 20 -- Feb 24)
-\item Go over final rubric, especially challenge level and extras
+%\item Go over final rubric, especially challenge level and extras
 \item First submission of docs is formative (feedback, not highly weighted),
 final submission is summative
 \ei
@@ -490,7 +490,7 @@ From \cite{GhezziEtAl2003}
 
 \item \structure{If our code passes all test cases, is it now guaranteed to be
     error free?}
-\item \structure{Are 5000 random tests always better than 5 carefully selected
+\item \structure{Are 5000 random tests always better than 15 carefully selected
     tests?}
 
 \end{itemize}

Lectures/L10_VnVContinued/VnVContinued.tex

@@ -93,7 +93,8 @@
 \begin{itemize}
 \item
 \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/commit/0bdea9edc7464bb57c2f3524bebfd4f3b59cdc80}
-{Some Domain Expert and Secondary Expert assignments have changed}
+{Some Domain Expert assignments have changed}
+\item Yasmin dropped the course, so Bo will need to find another project to evaluate
 \end{itemize}
 \end{frame}
 
@@ -111,6 +112,71 @@
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+\begin{frame}
+\frametitle{Goals of Testing}
+
+\begin{itemize}
+
+\item \structure{If our code passes all test cases, is it now guaranteed to be
+    error free?}
+\item \structure{Are 5000 random tests always better than 15 carefully selected
+    tests?}
+
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}
+\frametitle{Goals of Testing}
+
+\begin{itemize}
+
+\item To show the \structure{presence} of bugs (Dijkstra, 1972)
+\item If tests do not detect failures, we cannot conclude that software is defect-free
+\item Still, we need to do testing - driven by sound and systematic principles
+\begin{itemize}
+\item Random testing is often not a systematic principle to use
+% look at the example from the text, or divide by zero within a circular range
+\item Need a test plan
+\end{itemize}
+\item Should help isolate errors - to facilitate debugging
+
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}
+\frametitle{Goals of Testing Continued}
+
+\begin{itemize}
+\item Should be repeatable
+\begin{itemize}
+\item Repeating the same experiment, we should get the same results
+\item Repeatability may not be true because of the effect of the execution
+  environment on testing
+\item Repeatability may not occur if there are uninitialized variables
+\item Repeatability may not happen when there is nondeterminism
+\end{itemize}
+
+\item Should be accurate
+\begin{itemize}
+\item Accuracy increases reliability
+\item Part of the motivation for formal specification
+\end{itemize}
+
+\item \structure{Is a \structure{successful} test case one that passes the test, or one
+  that shows a failure?}
+
+\end{itemize}
+
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 \begin{frame}
 \frametitle{Test (V\&V) Plan}
 
@@ -1015,6 +1081,7 @@ Summary of most points below in \cite{Smith2016}
 \href{https://www.evoketechnologies.com/code-review-checklist-perform-effective-code-reviews/}{Sample
 checklists}
 \ei
+\item \href{https://gitlab.cas.mcmaster.ca/SEforSC/se4sc/-/blob/git-svn/GradStudents/Cynthia/M.EngReport/Thesis_Main.pdf?ref_type=heads} {Cynthia Liu's SC Requirements Validation Techniques}
 \end{itemize}
 \end{frame}
 

Lectures/L13_ModularDesign/ModularDesign.tex

@@ -64,6 +64,7 @@
 \bi
 \item For the design documentation you do not have to use the MG and 
 MIS templates
+\item No lecture on Friday, March 21
 %\item GitHub issues
 %\bi
 % \item When closing issues give the hash for the corresponding commit
@@ -89,44 +90,44 @@ MIS templates
 \input{../Deadlines.tex}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\begin{frame}
-\frametitle{Feedback on SRS}
-\begin{itemize}
-\item
-\href{https://github.com/smiths/capTemplate/blob/main/docs/Checklists/SRS-Checklist.pdf}
-{SRS checklist}
-\begin{itemize}
-  \item Follow the template
-  \item Filename for SRS from template (new)
-  \item All symbols are in the table of contents
-  \item Project is given a name
-  \item Characteristics with courses and level (clarified)
-  \item Goal statements are functional (new)
-  \item Each assumption is used at least once
-  \item All chunks are used at least once (new)
-  \item IMs are referenced by requirements
-\end{itemize}
-\end{itemize}
-\end{frame}
+% \begin{frame}
+% \frametitle{Feedback on SRS}
+% \begin{itemize}
+% \item
+% \href{https://github.com/smiths/capTemplate/blob/main/docs/Checklists/SRS-Checklist.pdf}
+% {SRS checklist}
+% \begin{itemize}
+%   \item Follow the template
+%   \item Filename for SRS from template (new)
+%   \item All symbols are in the table of contents
+%   \item Project is given a name
+%   \item Characteristics with courses and level (clarified)
+%   \item Goal statements are functional (new)
+%   \item Each assumption is used at least once
+%   \item All chunks are used at least once (new)
+%   \item IMs are referenced by requirements
+% \end{itemize}
+% \end{itemize}
+% \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\begin{frame}
-\frametitle{Feedback on SRS}
-\begin{itemize}
-\item
-\href{https://github.com/smiths/capTemplate/blob/main/docs/Checklists/Writing-Checklist.pdf}
-{Writing checklist}
-\begin{itemize}
-  \item Opening and closing ``quotes''
-  \item Periods that do not end sentences are followed by only one space
-  \item Long names in math mode use either mathit or text
-  \item Document is spell checked
-  \item Symbols formatted the same way in every context %inside and outside equations
-\end{itemize}
-\item Types information very helpful
-\end{itemize}
-\end{frame}
+% \begin{frame}
+% \frametitle{Feedback on SRS}
+% \begin{itemize}
+% \item
+% \href{https://github.com/smiths/capTemplate/blob/main/docs/Checklists/Writing-Checklist.pdf}
+% {Writing checklist}
+% \begin{itemize}
+%   \item Opening and closing ``quotes''
+%   \item Periods that do not end sentences are followed by only one space
+%   \item Long names in math mode use either mathit or text
+%   \item Document is spell checked
+%   \item Symbols formatted the same way in every context %inside and outside equations
+% \end{itemize}
+% \item Types information very helpful
+% \end{itemize}
+% \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
@@ -242,12 +243,12 @@ MIS templates
 \begin{frame}
 \frametitle{SWHS MG Example}
 ~\\
-\href{https://github.com/smiths/swhs/tree/master/docs/Design/MG}
-{https://github.com/smiths/swhs/tree/master/docs/Design/MG}
+
+\href{https://github.com/smiths/swhs/blob/master/docs/Design/MG/PCM_MG.pdf} {Module Guide for Solare Water Heating System Incorporating Phase Change Material (PCM)} 
+
 \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
 \begin{frame}
 \frametitle{What is Design?}
 \begin{itemize}

Lectures/L15_MIS/MIS.tex

@@ -47,8 +47,8 @@
 \bi
 \item Administrative details
 \item Questions?
-%\item Finish previous day slides
-\item Module guide example
+%\item Module guide example
+\item Mathematical fundamentals
 \item MIS example
 \item Integration testing
 \item MIS overview
@@ -66,28 +66,12 @@
 \frametitle{Administrative Details}
 
 \bi
-% \item When developing your code, remember that your goal is for someone else to
-%   be able to compile and run it
-% \item Upcoming classes
-% \bi
-% \item L15 - Module Interface Specification
-% \item L16 - Math Review + MIS
-% \item L17 - POC + MG Presentations
-% \item L18 - MIS Presentations
-% \ei
-\item Friday's class in ITB/201
-\item Mathematical review
-\begin{itemize}
-  \item \cite{HoffmanAndStrooper1995}
-  \item \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/tree/master/Lectures/MathReviewPlusExample} {Review Slides}
-  \item \href{https://gitlab.cas.mcmaster.ca/smiths/se2aa4_cs2me3/-/blob/master/MISFormat/MISFormat.pdf} {MIS Format}
-\end{itemize}
 \item Potential software for drawing figures
 \bi
 \item \href{https://app.diagrams.net/} {draw.io}
 \item \href{https://www.bu.edu/math/files/2013/08/tikzpgfmanual.pdf} {Tikz} 
 \ei
-\item Go over final grading rubric, traceability Rev0 to Rev1
+%\item Go over final grading rubric, traceability Rev0 to Rev1
 \ei
 
 \end{frame}
@@ -141,10 +125,29 @@
 \begin{frame}
 \frametitle{Emphasis}
 \begin{itemize}
-\item Math notation (stoichiometry example on Friday)
-\item GUI modules (environment variables)
+\item Math notation
+\item Modules with external interaction (environment variables)
 \item Types of modules
 \item Abstract Data Types (graph example)
+\item Qualities of an interface
+\item Design patterns
+\begin{itemize}
+  \item Adapter (Wrapper) pattern
+  \item Strategy pattern
+\end{itemize}
+\end{itemize}
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}
+\frametitle{Mathematical review}
+
+\begin{itemize}
+  \item Hoffman and Strooper (1995) \cite{HoffmanAndStrooper1995}
+  \item \href{https://gitlab.cas.mcmaster.ca/smiths/se2aa4_cs2me3/-/blob/master/MISFormat/MISFormat.pdf} {MIS Format}
+  \item \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/-/tree/master/Lectures/MathReviewPlusExample} {Stoichiometry Example} %not a great approach, can tell by bad names
+  \item MoleculeT = seq[108] of $\mathbb{N}$
 \end{itemize}
 \end{frame}
 
@@ -167,7 +170,7 @@
 \frametitle{Solar Water Heating System Example}
 
 \bi
-\item \href{https://github.com/smiths/swhs}{https://github.com/smiths/swhs}
+\item \href{https://github.com/smiths/swhs/tree/master} {https://github.com/smiths/swhs/tree/master}
 \item Solve ODEs for temperature of water and PCM
 \item Solve for energy in water and PCM
 \item Generate plots
@@ -586,7 +589,7 @@ are isolated to their own access programs (like submodules). %    This, combined
 \frametitle{MIS Example: SWHS}
 
 \bi
-\item \href{https://github.com/smiths/swhs}{https://github.com/smiths/swhs}
+\item \href{https://github.com/smiths/swhs/tree/master}{https://github.com/smiths/swhs/tree/master}
 \item Has some constant values
 \item Input parameters
 \item Solve ODEs for temperature of water and PCM