Index: DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex =================================================================== diff -u -r5607 -r5740 --- DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex (.../DAM Engine - Technical Design.tex) (revision 5607) +++ DamEngine/trunk/doc/Dam Engine - Technical Design/DAM Engine - Technical Design.tex (.../DAM Engine - Technical Design.tex) (revision 5740) @@ -912,39 +912,76 @@ \subsection{Mapping of the \ProgramName data} \label{sec:MappingDamEngineDataMacrostability} -The \MacrostabilityKernel 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. The data is contained in the classes DamKernelInput and DamMacroStabilityInput. +The \MacrostabilityKernel 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. +The data is contained in the classes DamKernelInput and DamMacroStabilityInput. + \begin{table}[H] \small \begin{tabular}{|p{60mm}|p{\textwidth-60mm-24pt}|} \hline \textbf{Macrostability} StabilityModel & \textbf{\ProgramName} DamInput.xsd \\ \hline MoveGrid & Fixed value: TRUE (default) \\ \hline MaximumSliceWidth & Fixed value: 1.0 (default) \\ \hline - SearchAlgorithm & DamMacroStabilityInput -> FailureMechanismParametersMStab -> MStabParameters -> SearchMethod \\ \hline - ModelOption & DamMacroStabilityInput -> FailureMechanismParametersMStab -> MStabParameters -> Model \\ \hline - Orientation & DamMacroStabilityInput -> FailureMechanismParametersMStab -> MStabParameters -> GridPosition \\ \hline + SearchAlgorithm & DamMacroStabilityInput $\rightarrow$ FailureMechanismParametersMStab $\rightarrow$ MStabParameters $\rightarrow$ SearchMethod \\ \hline + ModelOption & DamMacroStabilityInput $\rightarrow$ FailureMechanismParametersMStab $\rightarrow$ MStabParameters $\rightarrow$ Model \\ \hline + Orientation & DamMacroStabilityInput $\rightarrow$ FailureMechanismParametersMStab $\rightarrow$ MStabParameters $\rightarrow$ GridPosition \\ \hline NumberOfRefinementsGrid & Fixed value: 2 \\ \hline NumberOfRefinementsTangentLines & Fixed value: 2 \\ \hline - \hline - SoilModel -> Soils & DamKernelInput -> Location -> SoilList (See \autoref{table-MappingDamEngineSoilsMacrostability})\\ \hline - SoilProfile & DamKernelInput -> SubSoilScenario -> SoilProfile2D \\ \hline - SurfaceLine & DamKernelInput -> Location -> SurfaceLine \\ \hline - Location & DamKernelInput -> Location (See \autoref{table-MappingDamEngineLocationMacrostability})\\ \hline + \hline + SoilModel $\rightarrow$ Soils & DamKernelInput $\rightarrow$ Location $\rightarrow$ SoilList (See \autoref{table-MappingDamEngineSoilsMacrostability})\\ \hline + SoilProfile & DamKernelInput $\rightarrow$ SubSoilScenario $\rightarrow$ SoilProfile2D \\ \hline + SurfaceLine & DamKernelInput $\rightarrow$ Location $\rightarrow$ SurfaceLine \\ \hline + Location & DamKernelInput $\rightarrow$ Location (See \autoref{table-MappingDamEngineLocationMacrostability})\\ \hline PreconsolidationStresses & DO-NOT-IMPLEMENT \\ \hline - UniformLoads & generated (based on Location -> StabilityOptions -> TrafficLoad) \\ \hline - ConsolidationValues & generated (based on DamKernelInput -> Location -> TrafficLoadDegreeOfConsolidations) \\ \hline + UniformLoads & generated (based on Location $\rightarrow$ StabilityOptions $\rightarrow$ TrafficLoad) \\ \hline + ConsolidationValues & generated (based on DamKernelInput $\rightarrow$ Location $\rightarrow$ TrafficLoadDegreeOfConsolidations) \\ \hline MultiplicationFactorsCPhiForUplift & DO-NOT-IMPLEMENT \\ \hline Waternets & generated \\ \hline SpencerSlipPlanes & DO-NOT-IMPLEMENT \\ \hline - UpliftVanCalculationGrid & generated \\ \hline + BishopCalculationCircle & generated (based on DamMacroStabilityInput $\rightarrow$ FailureMechanismParametersMStab $\rightarrow$ MStabParameters $\rightarrow$ SlipCircleDefinition) \\ \hline + UpliftVanCalculationGrid & generated (based on DamMacroStabilityInput $\rightarrow$ FailureMechanismParametersMStab $\rightarrow$ MStabParameters $\rightarrow$ SlipCircleDefinition) \\ \hline SlipPlaneConstraints & DO-NOT-IMPLEMENT (See \autoref{table-MappingDamEngineSlipPlaneConstraintsMacrostability}) \\ \hline - GeneticAlgorithmOptions & Only BeeSwarm for Uplift Van \\ \hline + BeeswarmAlgorithmOptions & Only for Uplift Van with Bee Swarm. \\ \hline + GeneticAlgorithmOptions & DO-NOT-IMPLEMENT \\ \hline LevenbergMarquardtOptions & DO-NOT-IMPLEMENT \\ \hline \end{tabular} \caption{\small Mapping of the \MacrostabilityKernel data to the \ProgramName.} - \label{table-MappingDamEngineDataMacrostability} + \label{tab:MappingDamEngineDataMacrostability} \end{table} + \begin{table}[H] \small + \begin{tabular}{|p{50mm}|p{\textwidth-50mm-24pt}|} \hline + \textbf{Macrostability} \newline PreprocessingInput & \textbf{DamKernelInput} \newline DamFailureMechanismeCalculationSpecification $\rightarrow$ + FailureMechanismParametersMStab $\rightarrow$ + MStabParameters $\rightarrow$ SlipCircleDefinition \\ \hline + \multicolumn{2}{|l|}{\textbf{\textit{SearchAreaConditions}}} \\ \hline + \quad AutoSearchArea & True if BishopSearchAreaDetermination or UpliftVanGridSizeDetermination is Automatic, False otherwise. \\ \hline + \quad AutoTangentLines & False for Bishop (see \textbf{Note} below). True if UpliftVanTangentLinesDefinition is Automatic or OnBoundaryLines, False otherwise. \\ \hline + \quad OnlyAbovePleistoceen & N.A. for Bishop. For Uplift-Van, True if UpliftVanTangentLinesDefinition = Automatic, False if UpliftVanTangentLinesDefinition = OnBoundaryLines. \\ \hline + \quad MaxSpacingBetweenBoundaries & 0.8 m. \\ \hline + \quad TangentLineZTop & Generated if TangentLinesDefinition is Specified, 0 otherwise (see \textbf{Note} below). \\ \hline + \quad TangentLineZBottom & Generated if TangentLinesDefinition is Specified, 0 otherwise (see \textbf{Note} below). \\ \hline + \quad TangentLineNumber & Generated if TangentLinesDefinition is Specified, 0 otherwise (see \textbf{Note} below). \\ \hline + \multicolumn{2}{|l|}{\textbf{\textit{PreConstructionStages}}} \\ \hline + \quad CreateWaternet & False (because is generated by DAM Engine, see \autoref{tab:MappingDamEngineDataMacrostability}). \\ \hline + \end{tabular} + \caption{\small Mapping of the \MacrostabilityKernel PreprocessingInput to the DAM Engine Input} + \label{tab:MappingDamEnginePreProcessMacrostability} +\end{table} + +\Note{Parameter \textit{AutoSearchArea} in \autoref{tab:MappingDamEnginePreProcessMacrostability} does not work as expected if this parameter is TRUE: \\ +For Bishop, the grid and tangent lines are both automatically determined +and if \textit{AutoTangentLines} is TRUE then the tangent lines will be overwritten by the tangent lines of the Uplift-Van model. \\ +For Uplift-Van, only the left and right grids are automatically determined, not the tangent lines.} + +\Note{The specified tangent lines settings \textit{TangentLineZTop}, \textit{TangentLineZBottom} and \textit{TangentLineNumber} +in \autoref{tab:MappingDamEnginePreProcessMacrostability} are not working correctly in Macrostability: +the Preprocessing Output object is empty for the tangent lines. +It is therefore needed to specified the tangent lines in the object StabilityModel $\rightarrow$ BishopCalculationCircle/UpliftVanCalculationGrid $\rightarrow$ TangentLines $\rightarrow$ BoundaryHeights, see \autoref{tab:MappingDamEngineDataMacrostability}.} + +\begin{table}[H] + \small \begin{tabular}{|p{70mm}|p{\textwidth-70mm-24pt}|} \hline \textbf{Macrostability} Soil & \textbf{\ProgramName} Soil \\ \hline AbovePhreaticLevel & AbovePhreaticLevel \\ \hline @@ -960,13 +997,14 @@ \caption{\small Mapping of the \MacrostabilityKernel Soils to the \ProgramName Soils.} \label{table-MappingDamEngineSoilsMacrostability} \end{table} + The parameters defined in the following table for Location are all parameters that are used by the waternet creator of the \MacrostabilityKernel. They will not yet be implemented (as explained above). \begin{table}[H] \small \begin{tabular}{|p{65mm}|p{\textwidth-65mm-24pt}|} \hline \textbf{Macrostability} Location & \textbf{\ProgramName} Location \\ \hline DikeSoilScenario & TO-BE-ADDED \\ \hline - WaterLevelRiver & Scenario -> RiverLevel \\ \hline + WaterLevelRiver & Scenario $\rightarrow$ RiverLevel \\ \hline WaterLevelRiverAverage & TO-BE-ADDED \\ \hline WaterLevelRiverLow & Scenario -> RiverLevelLow \\ \hline WaterLevelPolder & PolderLevel \\ \hline @@ -977,18 +1015,18 @@ 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 + PlLineOffsetBelowDikeTopAtPolder & Scenario $\rightarrow$ PlLineOffsetBelowDikeTopAtPolder \\ \hline + PlLineOffsetBelowShoulderBaseInside & Scenario $\rightarrow$ PlLineOffsetBelowShoulderBaseInside \\ \hline + PlLineOffsetBelowDikeToeAtPolder & Scenario $\rightarrow$ PlLineOffsetBelowShoulderBaseInside \\ \hline HeadInPLLine2Inwards & HeadPl2 \\ \hline - HeadInPLLine3 & Scenario -> HeadPl3 \\ \hline - HeadInPLLine4 & Scenario -> HeadPl4 \\ \hline + HeadInPLLine3 & Scenario $\rightarrow$ HeadPl3 \\ \hline + HeadInPLLine4 & Scenario $\rightarrow$ HeadPl4 \\ \hline AdjustPl3And4ForUplift & set to TRUE \\ \hline - PenetrationLength & ModelParametersForPlLines -> PenetrationLength \\ \hline + PenetrationLength & ModelParametersForPlLines $\rightarrow$ PenetrationLength \\ \hline LeakageLengthOutwardsPl3 & DO-NOT-IMPLEMENT \\ \hline - LeakageLengthInwardsPl3 & generate based on ModelParametersForPlLines -> DampingFactorPl3 \\ \hline + LeakageLengthInwardsPl3 & generate based on ModelParametersForPlLines $\rightarrow$ DampingFactorPl3 \\ \hline LeakageLengthOutwardsPl4 & DO-NOT-IMPLEMENT \\ \hline - LeakageLengthInwardsPl4 & generate based on ModelParametersForPlLines -> DampingFactorPl4 \\ \hline + LeakageLengthInwardsPl4 & generate based on ModelParametersForPlLines $\rightarrow$ DampingFactorPl4 \\ \hline \end{tabular} \caption{\small Mapping of the \MacrostabilityKernel Slip Plane Location to the \ProgramName Location.} \label{table-MappingDamEngineLocationMacrostability} @@ -998,7 +1036,7 @@ \small \begin{tabular}{|p{70mm}|p{\textwidth-70mm-24pt}|} \hline \textbf{Macrostability} Constraints & \textbf{\ProgramName} Constraints \\ \hline - SlipPlaneMinDepth & Location -> StabiltiyOptions -> MinimumCircleDepth \\ \hline + SlipPlaneMinDepth & Location $\rightarrow$ StabiltiyOptions $\rightarrow$ MinimumCircleDepth \\ \hline SlipPlaneMinLength & TO-BE-ADDED \\ \hline CreateZones & TO-BE-ADDED \\ \hline AutomaticForbiddenZones & TO-BE-ADDED \\ \hline @@ -1021,17 +1059,17 @@ Pl 1 becomes the phreatic line. \\ If Pl 2 exists it becomes a head line. If there is at least one aquifer, a waternet line is created along the top of the bottom aquifer + penetration length. \\ -If Pl 3 exists it becomes a head line. If there are at least two aquifers, a waternet line is created along the top of the in-between aquifer. \\ -If Pl 4 exists it becomes a head line. If there is at least one aquifer, a waternet line is created along the top of the bottom aquifer. \\ +If Pl 3 exists it becomes a head line. If there is at least one aquifer, a waternet line is created along the top of the bottom aquifer. \\ +If Pl 4 exists it becomes a head line. If there are at least two aquifers, waternet lines are created along the top and bottom of the in-between aquifer(s). \subsection{Mapping of the validation result} \label{sec:MappingValidationResultMacrostability} The \MacrostabilityKernel returns the validation result when the Validate function is called. In the following table a mapping of the validation result to the \ProgramName data is defined. \begin{table}[H] \small \begin{tabular}{|p{60mm}|p{\textwidth-60mm-24pt}|} \hline - \textbf{Macrostability} WTIStabilityModelValidation.xsd & \textbf{\ProgramName} DamDesignResult.xsd -> StabilityDesignResults \\ \hline - Validations -> ValidationsType & ResultMessage -> LogMessageType\\ \hline + \textbf{Macrostability} WTIStabilityModelValidation.xsd & \textbf{\ProgramName} DamDesignResult.xsd $\rightarrow$ StabilityDesignResults \\ \hline + Validations $\rightarrow$ ValidationsType & ResultMessage $\rightarrow$ LogMessageType\\ \hline \end{tabular} \caption{\small Mapping of the \MacrostabilityKernel validation result to the \ProgramName.} \label{table-MappingValidationResultMacrostability} @@ -1044,12 +1082,12 @@ \begin{table}[H] \small \begin{tabular}{|p{60mm}|p{\textwidth-60mm-24pt}|} \hline - \textbf{Macrostability} WTIStabilityModelResult.xsd -> WTIStabilityModelResult & \textbf{\ProgramName} DamDesignResult.xsd -> StabilityDesignResults \\ \hline + \textbf{Macrostability} WTIStabilityModelResult.xsd $\rightarrow$ WTIStabilityModelResult & \textbf{\ProgramName} DamDesignResult.xsd $\rightarrow$ StabilityDesignResults \\ \hline Calculated & CalculationResult\\ \hline SafetyFactor & SafetyFactor\\ \hline Messages & ResultMessage\\ \hline - MinimumSafetyCurve -> first Slice, TopLeftPoint X & CircleSurfacePointLeftXCoordinate\\ \hline - MinimumSafetyCurve -> last Slice, TopRightPoint X & CircleSurfacePointRightXCoordinate\\ \hline + MinimumSafetyCurve $\rightarrow$ first Slice, TopLeftPoint X & CircleSurfacePointLeftXCoordinate\\ \hline + MinimumSafetyCurve $\rightarrow$ last Slice, TopRightPoint X & CircleSurfacePointRightXCoordinate\\ \hline ModelOption & StabilityModelType\\ \hline \end{tabular} \caption{\small Mapping of the \MacrostabilityKernel validation result to the \ProgramName.}