Index: DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex =================================================================== diff -u -r1272 -r1928 --- DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex (.../DAM Engine - Technical Design.tex) (revision 1272) +++ DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex (.../DAM Engine - Technical Design.tex) (revision 1928) @@ -1,7 +1,6 @@ \documentclass[signature]{deltares_report} \usepackage{listings} \usepackage[titletoc]{appendix} -\usepackage{lipsum} %----------------------------------------------- \lstset{ % basicstyle=\footnotesize, % the size of the fonts that are used for the code listings @@ -34,8 +33,8 @@ \textbf{\footnotesize{Samenvatting}} \\ Dit document bevat het technisch ontwerp voor \ProgramName, een software module die een gebruiker in staat stelt om voor een dijktraject berekeningen uit te voeren voor verschillende faalmechanismen, waaronder macrostabiliteit en piping.} -\versioni{0.4} -\datei{Mar 2017} +\versioni{0.5} +\datei{Nov 2018} \authori{Tom The} \revieweri{John Bokma \newline Andr\'e Grijze} \approvali{Maya Sule} @@ -114,6 +113,13 @@ \item Added a chapter on adding a new Failure Mechanism. \end{itemize} +\subsection{Revision 0.5} +\label{sec:Revision05} +\begin{itemize} + \item Added a chapter on Failure Mechanism implementations. + \item Added description of the implementation of the WBI Macrsotability kernel. +\end{itemize} + %------------------------------------------------------------------------------ \chapter{System Architecture} \label{chapterSystemArchitecture} @@ -794,6 +800,138 @@ This is only needed when the data model has been changed (see \autoref{sec:AddFailureMechanismSpecificDataToDataModel}) to accommodate more output properties. To change the output XML definition, the DamOuput.xsd definition or one of its dependent xsd's has to be adapted (see \autoref{app:DamOutput}). Also the reader and writer routines have to be adapted. This can be done in the class \newline Deltares.DamEngine.Interface.FillXmlOutputFromDam. %------------------------------------------------------------------------------ +\chapter{Failure Mechanism Implementations} +\label{sec:FailureMechanismImplementations} + +\section{Piping Bligh} +\label{sec:PipingBligh} +TODO... + +\section{Piping Sellmeijer 4 Forces} +\label{sec:PipingSellmeijer4Forces} +TODO... + +\section{Piping Sellmeijer VNK} +\label{sec:PipingSellmeijerVNK} +TODO... + +\section{WBI Piping Sellmeijer Revised} +\label{sec:WBIPipingSellmeijerRevised} +TODO... + +\section{Macrostability Inwards} +\label{sec:MacrostabilityInwards} +TODO... + +\section{Macrostability Outwards} +\label{sec:MacrostabilityOutwards} +TODO... + +\section{Macrostability Horizontal Balance} +\label{sec:MacrostabilityHorizontalBalance} +TODO... + +\section{WBI Macrostability Inwards} +\label{sec:WbiMacrostabilityInwards} +For WBI a new macrostability kernel has been build. A functional design \citep{Zwan2017a} and a technical design \citep{MacroStabilityKernel_TechnicalDesign} is available. Currently this kernel only supports macrostability inwards for the model Uplift Van. +The API of this kernel is based on an XML file that contains all the necessary data for the inout of the kernel. The XML is defined with a set of XML schema's (XDS's). These XSD's can be found in chapter 2.3 of the Technical Design. + +\subsection{Mapping of the \ProgramName data} +\label{sec:MappingDamEngineDataWbiMacrostability} +The WBI macrostability kernel has to be filled with input, that can be obtained from the \ProgramName data. In the following tables a mapping of the needed data to the \ProgramName data is defined. +\begin{table}[H] + %\caption{xxx} + %\label{xxx} + \begin{tabular}{|p{60mm}|p{\textwidth-60mm-24pt}|} \hline + \textbf{WBI Macrostability} StabilityModel & \textbf{\ProgramName} DamInput.xsd \\ \hline + SoilModel->Soils & Input->Soils (See \autoref{table-MappingDamEngineSoilsWbiMacrostability})\\ \hline + SoilProfile & Input->Locations->Segment->SoilGeometryProbability->SoilProfile2D \\ \hline + SurfaceLine & Input->Locations->Segment->SurfaceLine \\ \hline + Location & Input->Locations (See \autoref{table-MappingDamEngineLocationWbiMacrostability})\\ \hline + PreconsolidationStresses & DO-NOT-IMPLEMENT \\ \hline + UniformLoads & generated (Location->StabilityOptions->Trafficload) \\ \hline + ConsolidationValues & DO-NOT-IMPLEMENT \\ \hline + MultiplicationFactorsCPhiForUplift & DO-NOT-IMPLEMENT \\ \hline + Waternets & generated \\ \hline + SpencerSlipPlanes & DO-NOT-IMPLEMENT \\ \hline + UpliftVanCalculationGrid & generated \\ \hline + SlipPlaneConstraints & (See \autoref{table-MappingDamEngineSlipPlaneConstraintsWbiMacrostability}) \\ \hline + GeneticAlgorithmOptions & DO-NOT-IMPLEMENT \\ \hline + LevenbergMarquardtOptions & DO-NOT-IMPLEMENT \\ \hline +\end{tabular} + \caption{\small Mapping of the WBI macrostability kernel data to the \ProgramName.} + \label{table-MappingDamEngineDataWbiMacrostability} +\end{table} +\begin{table}[H] + %\caption{xxx} + %\label{xxx} + \begin{tabular}{|p{70mm}|p{\textwidth-70mm-24pt}|} \hline + \textbf{WBI Macrostability} Soil & \textbf{\ProgramName} Soil \\ \hline + AbovePhreaticLevel & AbovePhreaticLevel \\ \hline + BelowPhreaticLevel & BelowPhreaticLevel \\ \hline + DilatancyType & DilatancyType \\ \hline + Cohesion & Cohesion \\ \hline + FrictionAngle & FrictionAngle \\ \hline + UsePop & UsePop \\ \hline + POP & POP \\ \hline + RatioCuPc & RatioCuPc \\ \hline + StrengthIncreaseExponent & StrengthIncreaseExponent \\ \hline + OCR & OCR \\ \hline + \end{tabular} + \caption{\small Mapping of the WBI macrostability kernel Soils to the \ProgramName Soils.} + \label{table-MappingDamEngineSoilsWbiMacrostability} +\end{table} +\begin{table}[H] + %\caption{xxx} + %\label{xxx} + \begin{tabular}{|p{65mm}|p{\textwidth-65mm-24pt}|} \hline + \textbf{WBI Macrostability} Location & \textbf{\ProgramName} Location \\ \hline + DikeSoilScenario & TO-BE-ADDED \\ \hline + WaterLevelRiver & Scenario->RiverLevel \\ \hline + WaterLevelRiverAverage & TO-BE-ADDED \\ \hline + WaterLevelRiverLow & Scenario->RiverLevelLow \\ \hline + WaterLevelPolder & PolderLevel \\ \hline + DrainageConstructionPresent & TO-BE-ADDED \\ \hline + XCoordMiddleDrainageConstruction & TO-BE-ADDED \\ \hline + ZCoordMiddleDrainageConstruction & TO-BE-ADDED \\ \hline + MinimumLevelPhreaticLineAtDikeTopRiver & TO-BE-ADDED \\ \hline + MinimumLevelPhreaticLineAtDikeTopRiver & TO-BE-ADDED \\ \hline + UseDefaultOffsets & TO-BE-ADDED \\ \hline + PlLineOffsetBelowPointBRingtoetsWti2017 & TO-BE-ADDED \\ \hline + PlLineOffsetBelowDikeTopAtPolder & Scenario->PlLineOffsetBelowDikeTopAtPolder \\ \hline + PlLineOffsetBelowShoulderBaseInside & Scenario->PlLineOffsetBelowShoulderBaseInside \\ \hline + PlLineOffsetBelowDikeToeAtPolder & Scenario->PlLineOffsetBelowShoulderBaseInside \\ \hline + HeadInPLLine2Inwards & HeadPl2 \\ \hline + HeadInPLLine3 & Scenario->HeadPl3 \\ \hline + HeadInPLLine4 & Scenario->HeadPl4 \\ \hline + AdjustPl3And4ForUplift & set to TRUE \\ \hline + PenetrationLength & ModelParametersForPlLines->PenetrationLength \\ \hline + LeakageLengthOutwardsPl3 & DO-NOT-IMPLEMENT \\ \hline + LeakageLengthInwardsPl3 & generate based on ModelParametersForPlLines->DampingFactorPl3 \\ \hline + LeakageLengthOutwardsPl4 & DO-NOT-IMPLEMENT \\ \hline + LeakageLengthInwardsPl4 & generate based on ModelParametersForPlLines->DampingFactorPl4 \\ \hline + \end{tabular} + \caption{\small Mapping of the WBI macrostability kernel Slip Plane Location to the \ProgramName Location.} + \label{table-MappingDamEngineLocationWbiMacrostability} +\end{table} +\begin{table}[H] + %\caption{xxx} + %\label{xxx} + \begin{tabular}{|p{70mm}|p{\textwidth-70mm-24pt}|} \hline + \textbf{WBI Macrostability} Constraints & \textbf{\ProgramName} Constraints \\ \hline + SlipPlaneMinDepth & Location->StabiltiyOptions->MinimumCircleDepth \\ \hline + SlipPlaneMinLength & TO-BE-ADDED \\ \hline + CreateZones & TO-BE-ADDED \\ \hline + AutomaticForbiddenZones & TO-BE-ADDED \\ \hline + XEntryMin & TO-BE-ADDED \\ \hline + XEntryMax & TO-BE-ADDED \\ \hline + MaxAllowedAngleBetweenSlices & TO-BE-ADDED \\ \hline + RequiredForcePointsInSlices & TO-BE-ADDED \\ \hline + \end{tabular} + \caption{\small Mapping of the WBI macrostability kernel Slip Plane Constraints to the \ProgramName data.} + \label{table-MappingDamEngineSlipPlaneConstraintsWbiMacrostability} +\end{table} +%------------------------------------------------------------------------------ \chapter{Literature} \label{chapterLiterature} \bibliography{../DAM_references/dam_references}