Index: DamEngine/trunk/doc/Dam Engine - Functional Design/pictures/piping3.png =================================================================== diff -u -r1084 -r6137 Binary files differ Index: DamEngine/trunk/doc/Dam Engine - Functional Design/pictures/piping7.png =================================================================== diff -u -r1084 -r6137 Binary files differ Index: DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex =================================================================== diff -u -r5881 -r6137 --- DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex (.../DAM Engine - Technical Design.tex) (revision 5881) +++ DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex (.../DAM Engine - Technical Design.tex) (revision 6137) @@ -811,21 +811,52 @@ \chapter{Failure Mechanism Implementations} \label{sec:FailureMechanismImplementations} -\section{Piping Bligh} +\section{Piping Bligh (WBI)} \label{sec:PipingBligh} -TODO... +The WBI Piping kernel is used to support this failure mechanism. -\section{Piping Sellmeijer 4 Forces} -\label{sec:PipingSellmeijer4Forces} -TODO... +\subsection{Mapping of the DAM Engine data} +The Bligh Calculator of the WBI Piping kernel has to be filled with input, that can be obtained from the \ProgramName data. +In \autoref{tab:MappingDamEngineDataBlighCalculator} a mapping of the needed data to the \ProgramName data is defined. -\section{Piping Sellmeijer VNK} -\label{sec:PipingSellmeijerVNK} -TODO... +\begin{table}[H] + \small + \begin{tabular}{|p{35mm}|p{\textwidth-35mm-24pt}|} \hline + \textbf{WBI Piping} BlighCalculator.cs & \textbf{\ProgramName} DamKernelInput \\ \hline + HRiver & RiverLevelHigh \\ \hline + HExit & Max(Location.CurrentScenario.PolderLevel, surfaceLevel$^{a}$) \\ \hline + Rc & Fixed value: 0.3 \\ \hline + DTotal & calculated using WtiPipingHelper.DetermineHeightCoverLayer, based on surfaceLevel$^{1}$ and the top level of the aquifer where uplift occurs. \\ \hline + SeepageLength & xExit$^{b}$ - xEntry, where xEntry is the X co-ordinate of the characteristic point DikeToeAtRiver of Location.SurfaceLine \\ \hline + D50 & 0.81 $\times$ D70 where D70 is the soil property Soil.DiameterD70 of the layer where uplift occurs.\\ \hline + ModelFactorPiping & Fixed value: 1.0 \\ \hline + \multicolumn{2}{p{\textwidth-12pt}}{$^{a}$ surfaceLevel is the Z location along Location.SurfaceLine at xExit$^{b}$.} \\ + \multicolumn{2}{p{\textwidth-12pt}}{$^{b}$ xExit is the X-location where uplift occurs, calculated using UpliftLocationDeterminator.GetLocationAndResult.} \\ +\end{tabular} + \caption{Mapping of the Bligh Calculator input data of the WBI Piping kernel to the \ProgramName.} + \label{tab:MappingDamEngineDataBlighCalculator} +\end{table} +\subsection{Mapping of the calculation result} +The Bligh Calculator of the WBI Ping kernel returns the calculation result when the Calculate function is called. +In the following table a mapping of the calculation result to the \ProgramName data is defined. + +\begin{table}[H] + \small + \begin{tabular}{|p{60mm}|p{\textwidth-60mm-24pt}|} \hline + \textbf{\ProgramName} WtiPipingBlighOutput.cs & \textbf{WBI Piping} BlighCalculator.cs \\ \hline + CalculationResult & When the calculation throws an exception the CalculationResult is UnexpectedError. + When no uplift occurs, the CalculationResult is NoRun, otherwise Succeeded. \\ \hline + FoSp & FoSp \\ \hline + Hc & Hc \\ \hline +\end{tabular} + \caption{Mapping of the Bligh Calculator result of the WBI Piping kernel to the \ProgramName.} +\end{table} + \section{Piping Sellmeijer Revised (WBI)} \label{sec:WBIPipingSellmeijerRevised} -TODO... +The WBI Piping kernel is used to support this failure mechanism. +\todo{Describe mapping of WBI piping kernel} \section{Macrostability Inwards/Outwards} \label{sec:MacrostabilityInwards} Index: DamEngine/trunk/doc/Dam Engine - Functional Design/pictures/piping1.png =================================================================== diff -u -r1084 -r6137 Binary files differ Index: DamEngine/trunk/doc/Dam Engine - Functional Design/pictures/piping5.png =================================================================== diff -u -r1084 -r6137 Binary files differ Index: DamEngine/trunk/doc/Dam Engine - Functional Design/pictures/piping2.png =================================================================== diff -u -r1084 -r6137 Binary files differ Fisheye: Tag 6137 refers to a dead (removed) revision in file `DamEngine/trunk/doc/Dam Engine - Functional Design/FODAMPipingKernel.tex'. Fisheye: No comparison available. Pass `N' to diff? Index: DamEngine/trunk/doc/Dam Engine - Functional Design/FO.tex =================================================================== diff -u -r5424 -r6137 --- DamEngine/trunk/doc/Dam Engine - Functional Design/FO.tex (.../FO.tex) (revision 5424) +++ DamEngine/trunk/doc/Dam Engine - Functional Design/FO.tex (.../FO.tex) (revision 6137) @@ -114,26 +114,18 @@ The \ProgramName provides calculations with the following stability and piping kernels: \begin{enumerate} \item Stability; \MacroStabilityKernel - \item Piping; DAM-kernel piping \item Piping; WBI-kernel piping \end{enumerate} -\subsubsection{REQ Calc.Kernel22}\label{sec:REQ CalcKernel22} +\subsubsection{REQ Calc.Kernel}\label{sec:REQ CalcKernel} The DAM engine can make stability calculations with the \MacroStabilityKernel. The options used by the DAM engine are a subset of the use of that kernel and are described in \autoref{sec:UseStabKernel}. -% ToDo ToDo MWDAM-1719 {sec:FODAMPipingKernel} is defined in FOWBIPipingKernel.tex but this LaTeX-file is never included. -% Investigate if this subsection is relevant. -\subsubsection{REQ Calc.DAMPiping}\label{sec:REQ CalcDAMPiping} -The DAM engine can make piping calculations with the DAM-piping kernel. -% The functional design of the DAM piping kernel is described in \autoref{sec:FODAMPipingKernel}. - \subsubsection{REQ Calc.WBIPiping}\label{sec:REQ CalcWBIPiping} The DAM engine can make piping calculations with the WBI-piping kernel. -The functional design of the DAM piping kernel is described in \autoref{sec:UseWBIPipingKernel}. +The functional design of the WBI piping kernel is described in \autoref{sec:UseWBIPipingKernel}. - \subsection{REQ Calc.Design.Geometry}\label{sec:REQDesignGeometry} The DAM engine must be able to generate new profiles (surfacelines) based on a desired Dike table heigth (DTH) and/or Factor of safety. This can be done by: \begin{enumerate} Index: DamEngine/trunk/doc/Dam Engine - Functional Design/pictures/piping4.png =================================================================== diff -u -r1084 -r6137 Binary files differ Index: DamEngine/trunk/doc/Dam Engine - Functional Design/pictures/piping6.png =================================================================== diff -u -r1084 -r6137 Binary files differ Index: DamEngine/trunk/doc/Dam Engine - Functional Design/UseWBIPipingKernel.tex =================================================================== diff -u -r2664 -r6137 --- DamEngine/trunk/doc/Dam Engine - Functional Design/UseWBIPipingKernel.tex (.../UseWBIPipingKernel.tex) (revision 2664) +++ DamEngine/trunk/doc/Dam Engine - Functional Design/UseWBIPipingKernel.tex (.../UseWBIPipingKernel.tex) (revision 6137) @@ -1,60 +1,34 @@ \chapter{Use of WBI piping kernel} \label{sec:UseWBIPipingKernel} -The WBI use of the piping kernel consists of three sub failure mechanisms: uplift, heave and backward erosion. +The WBI use of the piping kernel consists of three sub failure mechanisms: +\begin{itemize} + \item \nameref{sec:Uplift} + \item \nameref{sec:Heave} + \item \nameref{sec:InternalErosion} +\end{itemize} + The complete calculation is done by: \begin{enumerate} \item The calculation of the uplift safety by determining the vertical balance of weight of the subsoil and the waterpressure at the top of the aquifer. -\item The calculation of heave by checking the maximal gradient over the vertical waterflow at the uplift location. Heave is the vertical sand transport through the horizontal pipes towards the location of uplift breaching (the exit location.)The thickness layer is the distance where over heave occurs. -\item The calculation of internal erosion with Sellmeijer revised. -\item Checking the presence of sufficient horizontal seepage length (kwelweglengte) -\item Determiniation of the piping safety factor by dividing the required seepage length by the present seepage length. + \item The calculation of heave by checking the maximal gradient over the vertical waterflow at the uplift location. Heave is the vertical sand transport through the horizontal pipes towards the location of uplift breaching (the exit location.)The thickness layer is the distance where over heave occurs. + \item The calculation of internal erosion with Sellmeijer revised. + \item Checking the presence of sufficient horizontal seepage length (kwelweglengte) + \item Determination of the piping safety factor by dividing the required seepage length by the present seepage length. \end{enumerate} -Note that the seepage length is calculated by (XExit - XEntry) + DistanceToEntryPoint. XExit is the exit point (point where the uplift is located), XEntry is the location of the dike toe at riverside and DistanceToEntryPoint is an optional user defined value, default 0. +\Note{The seepage length is calculated by (X$_{Exit}$ - X$_{Entry}$) + DistanceToEntryPoint. \\ +X$_{Exit}$ is the exit point (point where the uplift is located), +X$_{Entry}$ is the location of the dike toe at riverside and DistanceToEntryPoint is an optional user defined value, default 0.} The use by DAM of these functions is described in following paragraphs. \section{Uplift (uplift safety)}\label{sec:Uplift} For the uplift calculation DAM uses the DAM uplift calculation described in \autoref{sec:UpliftCalculation} -%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) & \\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) - %\item h$_{c,u}$(critical water level for uplift) - %\item D$_{cover,i}$ (effective thickness of the cover layer at exit point) - %\item $\gamma _{eff}$(effective stress at the exit point) - %\item h$_{exit}$(piezometric head at the exit point) -%\end{itemize} - \section{Heave}\label{sec:Heave} -This function of the kernel is decribed in paragraph 3.4 in \citep{PipingKernel_FunctionalDesign}. +This function of the kernel is described in paragraph 3.4 in \citep{PipingKernel_FunctionalDesign}. -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) +In DAM is assumed that heave always occurs, until the connection to the WBI piping kernel is extended to the complete version (also adaptions in DAM UI) Input of the kernel consists of: @@ -64,11 +38,11 @@ \textbf{Symbol} & \textbf{Unit} & \textbf{Description} &\textbf{Value in DAM } \\ \hline i & - & gradient at exit point & calculated based on the damping factor \\ \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 \\ \hline +D$_{cover}$ & m & total thickness of the cover sublayer & calculated, see \\ \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) & {\textcolor[rgb]{0.65,0.16,0}{HeadPl2}}\\ \hline \end{tabular} - \caption{Input paramaters Heave} + \caption{Input parameters Heave} \label{tab:InputParametersHeave} \end{table} @@ -83,8 +57,8 @@ \section{Internal erosion (backward erosion)}\label{sec:InternalErosion} -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}. +The WBI piping kernel facilitates the models Bligh, Sellmeijer both in original as revised (WTI2011) form. +This function of the kernel is described in paragraph 3.5 in \citep{PipingKernel_FunctionalDesign}. Input of the kernel consists of: @@ -102,16 +76,16 @@ $\gamma_{sub,particals}$ & kN/m$^{3}$ & submerged volumetric weight of sand particles & 16.5 \\ \hline $\theta_{Sellmeijer,rev.}$ & deg & bedding angle for Sellmeijer original & 37 \\ \hline $\eta$ & - & White’s drag coefficient & 0.25 \\ \hline -d$_{70}$ & m & 70\%-fractile of the aquifer’s grain size distribution & from soilmaterials.mdb \\ \hline +d$_{70}$ & m & 70\%-fractile of the aquifer’s grain size distribution & from soils.csv \\ \hline d$_{70m}$ & m & d70-reference value in Sellmeijer, revised & 2.08E-4 \\ \hline $\kappa$ & m$^{2}$ & intrinsic permeability & calculated with k, $\nu_{water}$ and g \\ \hline -k & m/s & hydraulic conductivity (Darcy) & from soilmaterials.mdb \\ \hline +k & m/s & hydraulic conductivity (Darcy) & from soils.csv \\ \hline $\nu_{water}$ & m$^{2}$ /s & kinematic viscosity of water at 10 degrees Celsius & 1.33 E-6 \\ \hline g & m/s$^{2}$ & gravitational constant & 9.81 \\ \hline D & m & thickness of the aquifer & calculated \\ \hline L & m & seepage length & calculated \\ \hline \end{tabular} - \caption{Input paramaters Internal erosion} + \caption{Input parameters Internal erosion} \label{tab:InputParametersInternalErosion} \end{table} @@ -122,7 +96,7 @@ \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 - 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}