Index: DamEngine/trunk/doc/Dam Engine - Functional Design/FO.tex =================================================================== diff -u -r1005 -r1031 --- DamEngine/trunk/doc/Dam Engine - Functional Design/FO.tex (.../FO.tex) (revision 1005) +++ DamEngine/trunk/doc/Dam Engine - Functional Design/FO.tex (.../FO.tex) (revision 1031) @@ -63,6 +63,8 @@ \subsection{REQ Data.Content}\label{sec:REQDataContent} The \ProgramName has a defined content for the data input, so DAM Clients know how to arrange the input data. +The required data is described in xsd-files in https://repos.deltares.nl/repos/dam/DamEngine/trunk/xsd. +An overview of the required data for the engine in relation to DAM UI data is described in https://repos.deltares.nl/repos/dam/DamOverall/trunk/doc/DAM General/OverviewDataUIAndEngine.xlsx \section{Calculation} @@ -123,7 +125,7 @@ \item Shoulder development \end{enumerate} -The design of this geometry adeption is worked out in \autoref{sec:DesignGeometryAdaption} +The design of this geometry adeption is described in \autoref{sec:DesignGeometryAdaption} \subsection{REQ Calc.Design.Excavation}\label{sec:REQDesignExcavation} This will not be part of the implementation of DAM Engine and therefor this paragraph has Index: DamEngine/trunk/doc/Dam Engine - Functional Design/UseStabKernel.tex =================================================================== diff -u -r1005 -r1031 --- DamEngine/trunk/doc/Dam Engine - Functional Design/UseStabKernel.tex (.../UseStabKernel.tex) (revision 1005) +++ DamEngine/trunk/doc/Dam Engine - Functional Design/UseStabKernel.tex (.../UseStabKernel.tex) (revision 1031) @@ -17,58 +17,67 @@ For these models a calculation grid must be generated. The user defines the dimensions; number of gridpoints and distance between the points. The DAM engine defines the position of the grid depending on the characteristic points: For Bishop and for the left grid of LiftVan the left bottom corner is situated at the surfaceline in the middle of the crest (distance between outer- and innercrest). The right bottom corner of the right grid of LiftVan is situated above the most right x co-ordinate where uplift occurs. With the restriction that the left bottom corner can not be situated left of the x co-ordinate of the DikeToePolder. + +\subsection{Tangent lines generation} +\label{sec:TangentLinesGeneration} +For Bishop calcuations the tangent lines are always situated at the layer boundaries (automatic). For LiftVan the tangent lines can either be situated automatic or specified. This is user-defined. +When specified, the user (client of DAM-Engine) must provide the distance between the tangent lines. \section{Shear strength model}\label{sec:ShearStrengthModel} The DAM engine must be able to make stability calculations with following shear strength models: \begin{itemize} \item C-Phi \item Stress tables - \item Cu calculated (with default inital surface level of D-Geostability; toplayer) + \item Cu calculated (with default inital surface level of D-Geo Stability; toplayer) \item Cu measured \item Cu gradient \item Pseudo values - \end{itemize} - -\subsection{Tangent lines generation} -\label{sec:TangentLinesGeneration} -The tangent lines can either be situated (automatic) at the layer boundaries or specified. This is user-defined. -When specified, + \end{itemize} - +\section{Zone Plot} +\label{sec:Zoneplot} +The option of zone plot in D-Geo Stability is defined as the distinction of the slip circles in different zones; 1a, 1b, 2a, 2b, 3a and 3b.\newline +DAM only uses zone 1 and zone 2. -\section{Zone types}\label{sec:ZoneTypes} -The DAM engine can provide different zone types: +The following settings for the Zone plot of D-Geo Stability are used by DAM:\newline + \begin{itemize} - \item No zones - \item Zone area (named Zone plot in D-Geostability) - \item Forbidden zones + \item Dike table heigth: user defined + \item Dike table width: 3 m + \item Start x co-ordinate restprofile: Xlocal;DikeTopAtRiver + \item Boundary of design level influence at x: Xlocal;DSurfaceLevelInside + \item Boundary of design level influence at y: maximal Y co-ordinate of surface line + \item Required safety in zones: safety factor stability inner slope \end{itemize} +Calculation with zone areas is only possible for inward stability calculations. -\subsection{Zone area} -\label{sec:ZoneArea} -The option of zone area is defined as the distinction of the slip circles in different zones; 1a, 1b, 2a and 2b conform the zones in D-Geostability. -The following settings of D-Geostability are used: -Dike table heigth: user defined -Dike table width: 3 m -Start x co-ordinate restprofile: x co-ordinate characteristic point DikeTopAtRiver -Boundary of design level influence at x: x co-ordinate characteristic point SurfaceLevelInside -Boundary of design level influence at y: maximal y co-ordinate of surface line -Required safety in zones: safety factor stability inner slope -Calculation with zone areas is only possible for inward stability calculations. +\section{Calculation options}\label{sec:CalculationOptions} +D-Geostability offers different following calculation options. DAM uses the following settings: -\subsection{Forbidden zone } -\label{sec:ZoneArea} -Forbidden zone is an option to define a forbidden zone for the entry point of the slip plane. -The forbidden zone is situated to the rigth side of a certain x co-ordinate. This x co-ordinate is defined by the ForbiddenZoneFactor. When the ForbiddenZoneFactor is 0, the x co-ordinate is equal to the x co-ordinate of the characteristic point DikeTopAtPolder. -When the ForbiddenZoneFactor is 0 + +\begin{itemize} + \item Requested number of slices: default D-Geo Stability + \item Minimum circle depth: user defined + \item Minimum slip plan length: default D-Geo Stability + \item Start value safety factor: default D-Geo Stability + \item Minimum x-entrance used: default D-Geo Stability + \item Maximum x-entrance used: user defined +\end{itemize} +The maximum x-entrance used is not directly user defined, but via Forbidden zones. + +\subsubsection{Forbidden zone } +\label{sec:Forbidden zone} +Forbidden zone is an option to define a forbidden zone for the entrance point of the slip plane. +The forbidden zone is situated to the rigth side of a certain x co-ordinate. This x co-ordinate is defined by the ForbiddenZoneFactor. Xlocal;forbidden zone WF =(Xlocal;DikeTopAtPolder) + ForbiddenZoneFactor*(Xlocal;DikeToeAtPolder - Xlocal;DikeTopAtPolder) + \begin{table*}[h] \centering \begin{tabular}{|p{35mm}|p{75mm}|} \hline - ForbiddenZonefactor & x co-ordinate Forbidden zone\\ \hline + ForbiddenZonefactor & maximum x-entrance\\ \hline 0 & x co-ordinate DikeTopAtPolder\\ \hline - 1 & middle of x co-ordinate DikeToeAtPolder and x co-ordinate DikeTopAtPolder\\ \hline + 1 & x co-ordinate DikeToeAtPolder\\ \hline \end{tabular} \caption{Forbidden zone factor} \label{tab:ForbiddenZoneFactor} @@ -81,4 +90,4 @@ \includegraphics[width=0.95\textwidth]{pictures/ForbiddenZoneFactor.png} \caption{Forbidden zone factor} \label{fig:ForbiddenZoneFactor} -\end{figure} +\end{figure} \ No newline at end of file