Revisions to repo to accommodate L14 on into to MIS

Lectures/L13_ModularDesign/ModularDesign.tex

@@ -1127,314 +1127,6 @@ AC2 & M2\\
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\begin{frame}
-\frametitle{Solar Water Heating System Example}
-
-\bi
-\item \href{https://github.com/smiths/swhs}{https://github.com/smiths/swhs}
-\item Solve ODEs for temperature of water and PCM
-\item Solve for energy in water and PCM
-\item Generate plots
-\ei
-
-\begin{figure}
-{
-\includegraphics[width=0.5\textwidth]{../Figures/Tank.pdf}
-}
-\end{figure}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Anticipated Changes?}
-
-\structure{What are some anticipated changes?}\\
-~\newline
-Hint: the software follows the Input $\rightarrow$ Calculate $\rightarrow$
-Output design pattern
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Anticipated Changes}
-
-\bi
-\item The specific hardware on which the software is to run
-\item The format of the initial input data
-\item The format of the input parameters
-\item The constraints on the input parameters
-\item The format of the output data
-\item The constraints on the output results
-\item How the governing ODEs are defined using the input parameters
-\item How the energy equations are defined using the input parameters
-\item How the overall control of the calculations is orchestrated
-\item The implementation of the sequence data structure
-\item The algorithm used for the ODE solver
-\item The implementation of plotting data
-\ei
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Module Hierarchy by Secrets}
-\begin{table}[h!]
-\centering
-\begin{tabular}{p{0.3\textwidth} p{0.6\textwidth}}
-\toprule
-\textbf{Level 1} & \textbf{Level 2}\\
-\midrule
-
-{Hardware-Hiding Module} & ~ \\
-\midrule
-
-\multirow{6}{0.3\textwidth}{Behaviour-Hiding Module} & Input Format Module\\
-& Input Parameters Module\\
-& Output Format Module\\
-& Temperature ODEs Module\\
-& Energy Equations Module\\ 
-& Control Module\\
-\midrule
-
-\multirow{3}{0.3\textwidth}{Software Decision Module} & {Sequence Data Structure Module}\\
-& ODE Solver Module\\
-& Plotting Module\\
-\bottomrule
-
-\end{tabular}
-\caption{Module Hierarchy}
-\label{TblMH}
-\end{table}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Example Modules from SWHS}
-
-\textbf{Hardware Hiding Modules}
-
-\begin{description}
-\item[Secrets:]The data structure and algorithm used to implement the virtual
-  hardware.
-\item[Services:]Serves as a virtual hardware used by the rest of the
-  system. This module provides the interface between the hardware and the
-  software. So, the system can use it to display outputs or to accept inputs.
-\item[Implemented By:] OS
-\end{description}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Example Modules from SWHS}
-
-\textbf{Input Verification Module}
-
-\begin{description}
-\item[Secrets:] The rules for the physical and software constraints.
-\item[Services:] Verifies that the input parameters comply with physical and
-  software constraints. Throws an error if a parameter violates a physical
-  constraint. Throws a warning if a parameter violates a software constraint.
-\item[Implemented By:] SWHS
-\end{description}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Example Modules from SWHS}
-
-\textbf{ODE Solver Module}
-
-\begin{description}
-\item[Secrets:] The algorithm to solve a system of first order ODEs.
-\item[Services:] Provides solvers that take the governing equation, initial
-  conditions, and numerical parameters, and solve them.
-\item[Implemented By:] Matlab
-\end{description}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}[plain, fragile]
-
-\frametitle{SWHS Uses Hierarchy}
-
-\begin{center}
-\includegraphics[scale=0.55]{../Figures/UsesHierarchy.pdf}
-\end{center}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Mesh Generator Example}
-\vspace{-1cm}
-\begin{figure}[H]
-\includegraphics[scale=0.4, angle=0]{../Figures/ExampleMesh.pdf}
-\end{figure}\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Mesh Generator Complex Circular Geometry}
-\begin{figure}[H]
-\includegraphics[scale=0.25]{../Figures/magnetron1.pdf}
-\end{figure}\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Mesh Generator Example: Design Goals}
-\begin{itemize}
-\item Independent and flexible representation for each mesh entity
-\item Complete separation of geometric data from the topology
-\item The mesh generator should work with different coordinate systems
-\item A flexible data structure to store sets of vertices, edges and triangles
-\item Different mesh generation algorithms with a minimal amount of local changes
-\end{itemize}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Example Mesh Gen Modular Decomposition}
-
-%\vspace{-1.5cm}
-% \begin{center}
-% \includegraphics[width=0.5\textwidth]{DecompBySecretHierarchyExample.png}
-% \end{center}
-
-\href{https://gitlab.cas.mcmaster.ca/smiths/se2aa4_cs2me3/blob/master/Lectures/L14_ModuleDecompositionContinued/DecompBySecretHierarchyExample.png}{Link}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Another Mesh Generator Uses Hierarchy \cite{ElSheikhEtAl2004}}
-\begin{figure}[H]
-\includegraphics[scale=0.345]{../Figures/hierarchy_diagram.pdf}
-\end{figure}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Module Testing}
-
-\structure{Is it possible to begin testing before all of the modules have been
-  implemented when there is a use relation between modules?}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Module Testing \cite{GhezziEtAl2003}}
-
-\begin{itemize}
-
-\item Scaffolding needed to create the environment in which the module should be
-  tested
-\item Stubs - a module used by the module under test
-\item Driver - module activating the module under test
-\end{itemize}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Testing a Functional Module \cite{GhezziEtAl2003}}
-
-\includegraphics[scale=0.5]{../Figures/TestingAFunctModule.png}
-
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Integration Testing}
-
-\begin{itemize}
-\item Big-bang approach
-\begin{itemize}
-\item First test individual modules in isolation
-\item Then test integrated system
-\end{itemize}
-\item Incremental approach
-\begin{itemize}
-\item Modules are progressively integrated and tested
-\item Can proceed both top-down and bottom-up according to the USES relation
-\end{itemize}
-\end{itemize}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Integration Testing and USES relation}
-
-\begin{itemize}
-\item If integration and test proceed bottom-up only need drivers
-\item Otherwise if we proceed top-down only stubs are needed
-\end{itemize}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Example \cite{GhezziEtAl2003}}
-
-\begin{center}
-\includegraphics[scale=0.35]{../Figures/Example.png}
-\end{center}
-
-\begin{itemize}
-\item $M_1$ USES $M_2$ and $M_2$ IS\_COMPOSED\_OF \{$M_{2,1}$, $M_{2,2}$\}
-\item \structure{In what order would you test these modules?}
-\end{itemize}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{frame}
-\frametitle{Example \cite{GhezziEtAl2003}}
-
-\begin{center}
-\includegraphics[scale=0.35]{../Figures/Example.png}
-\end{center}
-
-\begin{itemize}
-\item $M_1$ USES $M_2$ and $M_2$ IS\_COMPOSED\_OF \{$M_{2,1}$, $M_{2,2}$\}
-\item Case 1
-\begin{itemize}
-\item Test $M_1$ providing a stub for $M_2$ and a driver for $M_1$
-\item Then provide an implementation for $M_{2,1}$ and a stub for $M_{2,2}$
-\end{itemize}
-\item Case 2
-\begin{itemize}
-\item Implement $M_{2,2}$ and test it by using a driver
-\item Implement $M_{2,1}$ and test the combination of $M_{2,1}$ and $M_{2,2}$
-  (i.e.\ $M_2$) by using a driver
-\item Finally implement $M_1$ and test it with $M_2$ using a driver for $M_1$
-\end{itemize}
-\end{itemize}
-\end{frame}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
 \begin{frame}[allowframebreaks]
 \frametitle{References}
 

ReferenceMaterial/References.bib

@@ -2,13 +2,42 @@
 %% http://bibdesk.sourceforge.net/
 
 
-%% Created for Spencer Smith at 2017-10-23 16:59:05 -0400 
+%% Created for Spencer Smith at 2017-10-26 23:38:10 -0400 
 
 
 %% Saved with string encoding Unicode (UTF-8) 
 
 
 
+@inproceedings{CaretteEtAl2011,
+	Abstract = {We present the design and implementation of a generative geometric kernel. The kernel generator is generic, type-safe, parametrized by many design-level choices and extensible.  The resulting code has minimal traces of the design abstractions.  We achieve genericity through a layered design deriving concepts from affine geometry, linear algebra and abstract algebra.  We achieve parametrization and type-safety by using OCaml's module system, including higher order modules. The cost of abstraction is removed by using MetaOCaml's support for code generation coupled with some annotations atop the code type.},
+	Author = {Jacques Carette and Mustafa ElSheikh and W. Spencer Smith},
+	Booktitle = {ACM SIGPLAN 2011 Workshop on Partial Evaluation and Program Manipulation (PEPM'11)},
+	Date-Added = {2017-10-27 03:26:58 +0000},
+	Date-Modified = {2017-10-27 03:26:58 +0000},
+	Keywords = {MetaOCaml, Geometry, Generative, Generic},
+	Month = {January},
+	Pages = {53--62},
+	Title = {A Generative Geometric Kernel},
+	Year = {2011},
+	Bdsk-File-1 = {YnBsaXN0MDDUAQIDBAUGJCVYJHZlcnNpb25YJG9iamVjdHNZJGFyY2hpdmVyVCR0b3ASAAGGoKgHCBMUFRYaIVUkbnVsbNMJCgsMDxJXTlMua2V5c1pOUy5vYmplY3RzViRjbGFzc6INDoACgAOiEBGABIAFgAdccmVsYXRpdmVQYXRoWWFsaWFzRGF0YV8QOi4uLy4uL09MRF9TVk4vbWdnT0xEL3RydW5rL2RvY3MvcGVwbTExL3BlcG0yOHAtY2FyZXR0ZS5wZGbSFwsYGVdOUy5kYXRhTxEB4gAAAAAB4gACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAAzpdzg0grAAABF0zjE3BlcG0yOHAtY2FyZXR0ZS5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEXTW/Paa7RAAAAAAAAAAAAAgAGAAAJIAAAAAAAAAAAAAAAAAAAAAZwZXBtMTEAEAAIAADOl6vDAAAAEQAIAADPaecRAAAAAQAgARdM4wEXSn8BF0p9ARdKbwkx/qcAEhWnAAj3ZgACZI4AAgBcTWFjaW50b3NoIEhEOlVzZXJzOgBzbWl0aHM6AFJlcG9zOgBPTERfU1ZOOgBtZ2dPTEQ6AHRydW5rOgBkb2NzOgBwZXBtMTE6AHBlcG0yOHAtY2FyZXR0ZS5wZGYADgAoABMAcABlAHAAbQAyADgAcAAtAGMAYQByAGUAdAB0AGUALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEdVc2Vycy9zbWl0aHMvUmVwb3MvT0xEX1NWTi9tZ2dPTEQvdHJ1bmsvZG9jcy9wZXBtMTEvcGVwbTI4cC1jYXJldHRlLnBkZgAAEwABLwAAFQACAA3//wAAgAbSGxwdHlokY2xhc3NuYW1lWCRjbGFzc2VzXU5TTXV0YWJsZURhdGGjHR8gVk5TRGF0YVhOU09iamVjdNIbHCIjXE5TRGljdGlvbmFyeaIiIF8QD05TS2V5ZWRBcmNoaXZlctEmJ1Ryb290gAEACAARABoAIwAtADIANwBAAEYATQBVAGAAZwBqAGwAbgBxAHMAdQB3AIQAjgDLANAA2AK+AsACxQLQAtkC5wLrAvIC+wMAAw0DEAMiAyUDKgAAAAAAAAIBAAAAAAAAACgAAAAAAAAAAAAAAAAAAAMs}}
+
+@article{SmithAndYu2009,
+	Author = {W. Spencer Smith and Wen Yu},
+	Date-Added = {2017-10-27 03:25:31 +0000},
+	Date-Modified = {2017-10-27 03:25:31 +0000},
+	Doi = {http://dx.doi.org/10.1016/j.advengsoft.2009.05.003},
+	Journal = {Advances in Engineering Software},
+	Local-Url = {/Users/smiths/Work/Research/Papers/SmithAndYu2008_AdvEngSoft/SmithAndYu2008_ResubmissionToAdvEngSoft.pdf},
+	Month = {November},
+	Number = {11},
+	Pages = {1155--1167},
+	Title = {A Document Driven Methodology for Improving the Quality of a Parallel Mesh Generation Toolbox},
+	Volume = {40},
+	Year = {2009},
+	Bdsk-File-1 = {YnBsaXN0MDDUAQIDBAUGJCVYJHZlcnNpb25YJG9iamVjdHNZJGFyY2hpdmVyVCR0b3ASAAGGoKgHCBMUFRYaIVUkbnVsbNMJCgsMDxJXTlMua2V5c1pOUy5vYmplY3RzViRjbGFzc6INDoACgAOiEBGABIAFgAdccmVsYXRpdmVQYXRoWWFsaWFzRGF0YV8QNi4uLy4uL3NlNHNjL1NjaUNvbXBBbmRTb2Z0RW5nUGFwZXJzL1NtaXRoQW5kWXUyMDA5LnBkZtIXCxgZV05TLmRhdGFPEQHcAAAAAAHcAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADOl3ODSCsAAAkx/Q0SU21pdGhBbmRZdTIwMDkucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACTH9DtNvBNAAAAAAAAAAAAACAAMAAAkgAAAAAAAAAAAAAAAAAAAAF1NjaUNvbXBBbmRTb2Z0RW5nUGFwZXJzAAAQAAgAAM6Xq8MAAAARAAgAANNvPRAAAAABABQJMf0NCTHuxwASFacACPdmAAJkjgACAFVNYWNpbnRvc2ggSEQ6VXNlcnM6AHNtaXRoczoAUmVwb3M6AHNlNHNjOgBTY2lDb21wQW5kU29mdEVuZ1BhcGVyczoAU21pdGhBbmRZdTIwMDkucGRmAAAOACYAEgBTAG0AaQB0AGgAQQBuAGQAWQB1ADIAMAAwADkALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAENVc2Vycy9zbWl0aHMvUmVwb3Mvc2U0c2MvU2NpQ29tcEFuZFNvZnRFbmdQYXBlcnMvU21pdGhBbmRZdTIwMDkucGRmAAATAAEvAAAVAAIADf//AACABtIbHB0eWiRjbGFzc25hbWVYJGNsYXNzZXNdTlNNdXRhYmxlRGF0YaMdHyBWTlNEYXRhWE5TT2JqZWN00hscIiNcTlNEaWN0aW9uYXJ5oiIgXxAPTlNLZXllZEFyY2hpdmVy0SYnVHJvb3SAAQAIABEAGgAjAC0AMgA3AEAARgBNAFUAYABnAGoAbABuAHEAcwB1AHcAhACOAMcAzADUArQCtgK7AsYCzwLdAuEC6ALxAvYDAwMGAxgDGwMgAAAAAAAAAgEAAAAAAAAAKAAAAAAAAAAAAAAAAAAAAyI=},
+	Bdsk-Url-1 = {http://dx.doi.org/10.1016/j.advengsoft.2009.05.003}}
+
 @article{ElSheikhEtAl2004,
 	Author = {Ahmed H. ElSheikh and W. Spencer Smith and Samir E. Chidiac},
 	Date-Added = {2017-10-23 20:58:24 +0000},