Index: DamEngine/trunk/doc/Dam Engine - Functional Design/UseWBIPipingKernel.tex
===================================================================
diff -u -r1561 -r1585
--- DamEngine/trunk/doc/Dam Engine - Functional Design/UseWBIPipingKernel.tex	(.../UseWBIPipingKernel.tex)	(revision 1561)
+++ DamEngine/trunk/doc/Dam Engine - Functional Design/UseWBIPipingKernel.tex	(.../UseWBIPipingKernel.tex)	(revision 1585)
@@ -16,31 +16,33 @@
 The use by DAM of these functions is described in following paragraphs.
 
 \section{Uplift (uplift safety)}\label{sec:Uplift}
-This function of the kernel is decribed in paragraph 3.3 in \citep{PipingKernel_FunctionalDesign}.
+For the uplift calculation DAM uses the DAM uplift calculation described in \autoref{sec:UpliftCalculation}
 
-Input of the kernel consists of:
-
-\begin{table}[H]
-	\centering
-		\begin{tabular}{|p{20mm}|p{20mm}|p{50mm}|p{50mm}|} \hline
-\textbf{Symbol}& \textbf{Unit}  & \textbf{Description} & \textbf{Value in DAM}  \\ \hline
-h$_{exit}$		 & m	 & phreatic level at the exit point (above reference level NAP)     & calculated, see \autoref{sec:PiezHeadUpliftLocation}    \\ \hline
-$\Phi _{polder}$ & m & piezometric head in the hinterland (above reference level NAP) & \textit{\textcolor[rgb]{0.65,0.16,0}{HeadPl2}}\ \\ \hline
-$\Phi _{exit}$         & m     & piezometric head at the exit point (above reference level NAP)  & calculated, see \autoref{sec:PiezHeadUpliftLocation} \\  \hline
-r$_{exit}$               &       & damping factor at the exit point  &  calculated, see \autoref{sec:PiezHeadUpliftLocation}  \\ \hline
-m$_{u}$        & -   & model factor uplift &   ?    \\ \hline
-D$_{cover,i}$	    & m    & thickness of the cover sublayer i at the exit point &  calculated, see \autoref{sec:DeterminationSoilParameters}   \\ \hline
-$\sigma_{eff}$ &	kN/m$^{2}$ & effective vertical stress at the bottom of the cover layer & calculated, see \autoref{sec:DeterminationSoilParameters}  \\ \hline
-$\gamma_{eff,cover,i}$   & kN/m$^{3}$ & effective volumetric weight of cover sublayer i  & calculated, see \autoref{sec:DeterminationSoilParameters} \\ \hline
-$\gamma_{water}$  & kN/m$^{3}$  & volumetric weight of water &  9.81  \\ \hline
-$\gamma$          & m     & leakage length on the landside of the dike (hinterland)    & New input for DAM \\ \hline
-		\end{tabular}
-	\caption{Input paramaters}
-	\label{tab:InputParametersUplift}
-\end{table}
-
-Output of the kernel for the uplift safety calculation is:
-\begin{itemize}
+%This function of the kernel is decribed in paragraph 3.3 in \citep{PipingKernel_FunctionalDesign}.
+%
+%Input of the kernel consists of:
+%
+%\begin{table}[H]
+	%\centering
+		%\begin{tabular}{|p{20mm}|p{20mm}|p{50mm}|p{50mm}|} \hline
+%\textbf{Symbol}& \textbf{Unit}  & \textbf{Description} & \textbf{Value in DAM}  \\ \hline
+%h$_{exit}$		 & m	 & phreatic level at the exit point (above reference level NAP)     & calculated, see \autoref{sec:PiezHeadUpliftLocation}    \\ \hline
+%$\Phi _{polder}$ & m & piezometric head in the hinterland (above reference level NAP) & \textit{\textcolor[rgb]{0.65,0.16,0}{HeadPl2}}\ \\ \hline
+%$\Phi _{exit}$         & m     & piezometric head at the exit point (above reference level NAP)  & calculated, see \autoref{sec:PiezHeadUpliftLocation} \\  \hline
+%r$_{exit}$               &       & damping factor at the exit point  &  calculated, see \autoref{sec:PiezHeadUpliftLocation}  \\ \hline
+%m$_{u}$        & -   & model factor uplift &   ?    \\ \hline
+%D$_{cover,i}$	    & m    & thickness of the cover sublayer i at the exit point &  calculated, see \autoref{sec:DeterminationSoilParameters}   \\ \hline
+%$\sigma_{eff}$ &	kN/m$^{2}$ & effective vertical stress at the bottom of the cover layer & calculated, see \autoref{sec:DeterminationSoilParameters}  \\ \hline
+%$\gamma_{eff,cover,i}$   & kN/m$^{3}$ & effective volumetric weight of cover sublayer i  & calculated, see \autoref{sec:DeterminationSoilParameters} \\ \hline
+%$\gamma_{water}$  & kN/m$^{3}$  & volumetric weight of water &  9.81  \\ \hline
+%$\gamma$          & m     & leakage length on the landside of the dike (hinterland)    & New input for DAM \\ \hline
+		%\end{tabular}
+	%\caption{Input paramaters}
+	%\label{tab:InputParametersUplift}
+%\end{table}
+%
+%Output of the kernel for the uplift safety calculation is:
+%\begin{itemize}
 	\item Z$_u$ (limit state function value)
 	\item FoS$_{u}$ (factor of safety)
 	\item $\Delta \Phi _{c,u}$ (critical head difference for uplift)
@@ -54,34 +56,36 @@
 \section{Heave} \label{sec:Heave}
 This function of the kernel is decribed in paragraph 3.4 in \citep{PipingKernel_FunctionalDesign}.
 
-Input of the kernel consists of:
+In DAM is assumed that heave always occurs, until the connection to the WBI piping kernel is extended to the complete version (also adeptions in DAM UI)
 
-\begin{table}[H]
-	\centering
-		\begin{tabular}{|p{20mm}|p{20mm}|p{50mm}|p{50mm}|} \hline
-\textbf{Symbol}            & \textbf{Unit}  & \textbf{Description}    &\textbf{Value in DAM   }            \\ \hline
-i                 & -     & gradient at exit point & calculated based on the damping factor, see \autoref{sec:PipingWaterpressures} \\ \hline
-i$_{c,h}$                & -     & critical exit gradient & calculated based on the damping factor\\ \hline
-D$_{cover}$	    & m     & total thickness of the cover sublayer &  calulated, see \autoref{sec:DeterminationSoilParameters}   \\ \hline	
-h$_{exit}$ & m NAP & piezometric head at the exit point & output kernel 	\\ \hline	
-$\Phi _{polder}$ & m & piezometric head in the hinterland (above reference level NAP) & c\textit{\textcolor[rgb]{0.65,0.16,0}{HeadPl2}}\\ \hline	
-		\end{tabular}
-	\caption{Input paramaters Heave}
-	\label{tab:InputParametersHeave}
-\end{table}
+%Input of the kernel consists of:
+%
+%\begin{table}[H]
+	%\centering
+		%\begin{tabular}{|p{20mm}|p{20mm}|p{50mm}|p{50mm}|} \hline
+%\textbf{Symbol}            & \textbf{Unit}  & \textbf{Description}    &\textbf{Value in DAM   }            \\ \hline
+%i                 & -     & gradient at exit point & calculated based on the damping factor, see \autoref{sec:PipingWaterpressures} \\ \hline
+%i$_{c,h}$                & -     & critical exit gradient & calculated based on the damping factor\\ \hline
+%D$_{cover}$	    & m     & total thickness of the cover sublayer &  calulated, see \autoref{sec:DeterminationSoilParameters}   \\ \hline	
+%h$_{exit}$ & m NAP & piezometric head at the exit point & output kernel 	\\ \hline	
+%$\Phi _{polder}$ & m & piezometric head in the hinterland (above reference level NAP) & c\textit{\textcolor[rgb]{0.65,0.16,0}{HeadPl2}}\\ \hline	
+		%\end{tabular}
+	%\caption{Input paramaters Heave}
+	%\label{tab:InputParametersHeave}
+%\end{table}
+%
+%Output of the kernel for the heave calculation is:
+%\begin{itemize}
+	%\item Z$_h$ (limit state function value)
+	%\item FoS$_{h}$ (factor of safety)
+	%\item h$_{c,h}$(critical water level for heave)
+	%\item h$_{exit}$(piezometric head at the exit point)
+	%\item i (gradient at exit point)
+%\end{itemize}
 
-Output of the kernel for the heave calculation is:
-\begin{itemize}
-	\item Z$_h$ (limit state function value)
-	\item FoS$_{h}$ (factor of safety)
-	\item h$_{c,h}$(critical water level for heave)
-	\item h$_{exit}$(piezometric head at the exit point)
-	\item i (gradient at exit point)
-\end{itemize}
-
 \section{Internal erosion (backward erosion)}\label{sec:InternalErosion}
 
-The kernel facilitates the models Bligh, Sellmeijer both in original as revised (WTI2011)form. For now the use by DAM is restricted to Sellmeijer revised (WTI 2011)
+The WBI piping kernel facilitates the models Bligh, Sellmeijer both in original as revised (WTI2011)form. For now the use by DAM is restricted to Sellmeijer revised (WTI 2011)
 This function of the kernel is decribed in paragraph 3.5 in \citep{PipingKernel_FunctionalDesign}.
 
 Input of the kernel consists of:
@@ -115,28 +119,28 @@
 Output of the kernel for the internal erosion calculation is:
 
 \begin{itemize}
-	\item Z$_p$ (limit state function value)
+	%\item Z$_p$ (limit state function value)
 	\item FoS$_{p}$ (factor of safety)
-	\item h$_{c,p}$(critical water level for uplift)
-	\item $\Delta$ H$_{c}$ (critical head difference)
-	\item h - $_{exit}$- r$_{c}$D$_{cover}$(reduced head drop this the head drop which is reduced by the head drop over the exit channel)
+	%\item h$_{c,p}$(critical water level for uplift)
+	%\item $\Delta$ H$_{c}$ (critical head difference)
+	%\item h - $_{exit}$- r$_{c}$D$_{cover}$(reduced head drop this the head drop which is reduced by the head drop over the exit channel)
 \end{itemize}
 
 
 
-\section{Piezometric head and uplift location}\label{sec:PiezHeadUpliftLocation}
-The kernel needs the piezometric head in the aquifer. Herefore the demping factor r$_{toe}$ is required input. This is the damping factor defined by formula 3.1 in functional design kernel. In the WBI software this is an user defined input paramater. In DAM r$_{toe}$ can be calculated from the DAM input \textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl3}} (or \textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl4}} if PL4 is present): 
-
-\begin{align} \label{eq_dempingsfactor}
-% if PL2 and Phi polder are not the same r_{toe}= \frac{(h- (\textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl3}} * (h - \textit{\textcolor[rgb]{0.65,0.16,0}{HeadPl2}})))-\Phi _{polder}}{ h - \Phi _{polder}}
-r_{toe} = 1 - \textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl3}}
-\end{align}
-
-In the WBI piping kernel is an assumption made for the distribution ot the piezomeric head in the aquifer at different x locations. This requires a leakage length $\lambda$. This is a user defined parameter (new to DAM).
-Parameter used in DAM is \textit{\textcolor[rgb]{0.65,0.16,0}{SlopeDampingPiezometricHeightPolderSide}. remark Irene (2-5-2018): Perhaps it is an option to calculate the leakage length from this parameter to avoid adding new parameters to DAM. This belongs to the extended version of the WBI-piping connection, as adaption in the UI is needed.
-
-
-\section{Determination of soil parameters}\label{sec:DeterminationSoilParameters}
-DAM already provides soil related parameters such as thickness of cover layer, position aquifer,etc. for the DAM piping calculations.
-These schematisations are also used for the WBI-piping kernel.
-remark Irene (2-5-2018): still needs to be described in FO (MWDAM-1252-priority:minor).
+%\section{Piezometric head and uplift location}\label{sec:PiezHeadUpliftLocation}
+%The kernel needs the piezometric head in the aquifer. Herefore the demping factor r$_{toe}$ is required input. This is the damping factor defined by formula 3.1 in functional design kernel. In the WBI software this is an user defined input paramater. In DAM r$_{toe}$ can be calculated from the DAM input \textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl3}} (or \textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl4}} if PL4 is present): 
+%
+%\begin{align} \label{eq_dempingsfactor}
+%% if PL2 and Phi polder are not the same r_{toe}= \frac{(h- (\textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl3}} * (h - \textit{\textcolor[rgb]{0.65,0.16,0}{HeadPl2}})))-\Phi _{polder}}{ h - \Phi _{polder}}
+%r_{toe} = 1 - \textit{\textcolor[rgb]{0.65,0.16,0}{DampingFactorPl3}}
+%\end{align}
+%
+%In the WBI piping kernel is an assumption made for the distribution ot the piezomeric head in the aquifer at different x locations. This requires a leakage length $\lambda$. This is a user defined parameter (new to DAM).
+%Parameter used in DAM is \textit{\textcolor[rgb]{0.65,0.16,0}{SlopeDampingPiezometricHeightPolderSide}}. remark Irene (2-5-2018): Perhaps it is an option to calculate the leakage length from this parameter to avoid adding new parameters to DAM. This belongs to the extended version of the WBI-piping connection, as adaption in the UI is needed.
+%
+%
+%\section{Determination of soil parameters}\label{sec:DeterminationSoilParameters}
+%DAM already provides soil related parameters such as thickness of cover layer, position aquifer,etc. for the DAM piping calculations.
+%These schematisations are also used for the WBI-piping kernel.
+%remark Irene (2-5-2018): still needs to be described in FO (MWDAM-1252-priority:minor).
