\documentclass[dutch]{deltares_manual}
\usepackage{enumitem}
\usepackage{xcolor}
\usepackage{colortbl}
\usepackage{color}
\usepackage{wrapfig}
\usepackage{float}
\usepackage{amsmath}
\usepackage{amssymb}
\usepackage{pifont}
\usepackage{lscape}
\newcommand{\dgeostability}{\textit{D\nobreakdash-Geo~Stability}\xspace}
\newcommand{\FingerPointing}[1]{
	\begin{tabular}{p{10mm}p{\textwidth-24pt-10mm}}
	\Huge{\ding{43}} 	
	& #1 
	\end{tabular}
}
\definecolor{gris}{RGB}{150,150,150}
\newcommand{\ghline}{\arrayrulecolor{gris}\hline\arrayrulecolor{black}}
\newcommand{\includebutton}[1]{\raisebox{-6pt}{\includegraphics[height=6mm]{#1}}}

%------------------------------------------------------------------------------
\hypersetup
{
    pdfauthor   = {Deltares},
    pdftitle    = {DAM User Manual},
    pdfkeywords = {Deltares User Manual DAM},
    pdfcreator  = {LaTeX hyperref},
    pdfproducer = {ps2pdf}
}

%------------------------------------------------------------------------------
\begin{document}

\pagestyle{empty}
\cleardoublepage

\title{\scalebox{.9}[1.0]{\textsc{DAM}}}
\subtitle{Dijksterkte Analyse Module}
\manualtype{Gebruikershandleiding}
\version{23.2}
\maketitle
\manualtitle


%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{Versie informatie}
Versie 1-6: Initiële beschrijving van DAM

Versie 7: Het gebruik van MSoilBase is vervangen door het inlezen van een csv-file.

%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{Reference}
\section{Modelconcept DAM}
Voor het uitvoeren van een analyse van de dijksterkte kunnen vier hoofdstappen worden onderscheiden (\autoref{fig:SterkteAnalyseDijk}). 
Deze stappen worden altijd, onafhankelijk van het type vraag, doorlopen. 
De eerste stap is het verzamelen van basisgegevens. 
Onder basisgegevens wordt de ruwe data uit landmeetkundig-, geohydrologisch- en grondmechanisch onderzoek verstaan. 
In de tweede stap wordt de data geschematiseerd en klaargezet voor de berekeningen. 
De schematisering is sterk afhankelijk van de vraag.
Daarnaast geldt hoe meer informatie aanwezig is, hoe nauwkeuriger de schematisering. 
In de derde stap worden de berekeningen uitgevoerd. 
In de laatste stap vindt een analyse van de rekenresultaten plaats, waarna deze kan worden gevisualiseerd en gecommuniceerd. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.50\textwidth]{Pictures/Reference/SterkteAnalyseDijk.png}
	\caption{Sterkte analyse dijk}
	\label{fig:SterkteAnalyseDijk}
\end{figure}

Deze vier stappen worden voor elke toepassing gezet, zie \autoref{fig:SterkteAnalyseDijk}. 
Voor toetsing, ten tijde van calamiteiten, voor beleidsvraagstukken 
en voor beheerszaken wordt veelal gebruik gemaakt van dezelfde basisgegevens en eventueel van dezelfde schematiserings. 
Het werkproces kan efficiënter gemaakt worden door de basisdata en schematiserings op een handige manier aan elkaar te koppelen en vervolgens te ‘hergebruiken’. 
Hiertoe is de Dijksterkte Analyse Module (DAM) ontwikkeld. 
DAM betreft een platform waarmee automatisch stabiliteitsberekeningen van grote dijkstrekkingen kunnen worden uitgevoerd, zie \autoref{fig:ModelconceptDAM}. 
DAM rationaliseert en automatiseert de derde stap (berekeningen) en een groot gedeelte van de tweede stap (schematisering). 

Een belangrijk element binnen de werking van DAM en het bijbehorende concept is de koppeling met de (ruimtelijk vastgelegde) gegevens bij de waterschappen. 
De visie op het datamanagement, dat verder rijkt dan DAM alleen, wordt beschreven in \autoref{sec:DatamanagementWaterkeringen}.

Voor het uitvoeren van de stabiliteitsberekeningen maakt DAM gebruik van het rekenhart van \dgeostability (modellen: Bishop, UpliftVan en Horizontal Balance). 

\FingerPointing{Om stabiliteitsberekeningen met DAM te kunnen uitvoeren is een licentie voor \dgeostability \citep{UserManualDGeoStability18-2} nodig.
Deze kan aangeschaft worden bij Deltares Systems.}

De werking en het gebruik van \dgeostability valt buiten deze handleiding. 
Voor meer informatie wordt verwezen naar de gebruikersdocumenten behorende bij \dgeostability.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Reference/ModelconceptDAM.png}
	\caption{Modelconcept DAM}
	\label{fig:ModelconceptDAM}
\end{figure}

Voor het uitvoeren van de piping berekeningen wordt gebruik gemaakt van de piping modellen (zie \autoref{sec:PipingRekeninstellingen}). 
In de toekomst is het mogelijk om ook andere (nieuw te ontwikkelen) rekenmodellen met DAM aan te sturen. 
Zo wordt momenteel in een laboratorium-opstelling DAM gekoppeld met DgFlow voor het berekenen van (tijdsafhankelijke) waterspanningen.

\section{Inleiding visie datamanagement}
Binnen Deltares wordt software voor de bepaling van de sterkte van waterkeringen modulair ontwikkeld. 
Hierbij is het streven om zoveel mogelijk componenten te delen. 
\Autoref{fig:ModulaireOntwikkelstrategieSoftware} geeft schematisch de onderlinge samenhang tussen de verschillende componenten weer en rekenplatformen, bijvoorbeeld DAM en Ringtoets. 
Het delen van componenten heeft verschillende voordelen. 
Zo kan de dijkbeheerder zijn bron data gebruiken voor verschillende toepassingen. 
Daarnaast geldt dat door het delen van goed geteste bibliotheken de betrouwbaarheid vergroot wordt. 
Delen van faalmechanismebibliotheken leidt tot directe vergelijkbaarheid van resultaten voor verschillende toepassingen. 
Door de herkenbaarheid van de User Interface (UI) componenten wordt het voor de gebruiker makkelijker de software te bedienen en daarmee wordt de drempel verlaagd voor gebruik van de software. 
Voor de ontwikkelaar zijn gedeelde bibliotheken beter en goedkoper te onderhouden.

Een belangrijk component bij de ontwikkeling van de software is de koppeling met de ‘Data’, zie \autoref{fig:ModulaireOntwikkelstrategieSoftware}, punt A.
Het uitvoeren van berekeningen met DAM staat of valt met eenduidig gedefinieerde datastromen en een eenduidig beheer van (geschematiseerde) gegevens. 

\begin{figure}[H]
	\centering
	 \includegraphics[width=1.00\textwidth]{Pictures/Reference/ModulaireOntwikkelstrategieSoftware.png}
 \caption{Modulaire ontwikkelstrategie software}
 \label{fig:ModulaireOntwikkelstrategieSoftware}
\end{figure}

\section{Gebruikte definities}
In de navolgende paragraven worden verschillende definities gebruikt. 
Ter verduidelijking worden drie termen nader gedefinieerd:
\begin{enumerate}
	\item Kerngegevens: Onder kerngegeven worden de gegevens bedoeld zo als (gedeeltelijk) aanwezig in de verschillende databases van waterkeringbeheerders. 
	Te denken valt aan polderpeilen, maaiveldhoogtes etc. 
	De feitelijke waarde(n) van een kerngegeven is de data. 
	De gegevens zijn dus een omschrijving van de data. 
	Ter illustratie; polderpeil is een kerngegeven, de waarde (bijvoorbeeld) NAP -0,5m is de data.	
	\item Geschematiseerde gegevens: Onder geschematiseerde gegevens worden gegevens bedoeld welke het gevolg zijn van een schematisering. 
	Bijvoorbeeld de ondergrond schematiserings op basis van boringen, sonderingen en geologische kennis. 
	Of een profiel schematisering op basis van laseraltimetrie gegevens.
	\item Basisgegevens: Onder basisgegevens wordt het totaal van kern- en geschematiseerde gegevens verstaan voor zover dit invoer voor analyses van de sterkte van waterkeringen betreft. 
	\item ‘Instellingen’: Onder ‘instellingen’ worden default gegevens verstaan die specifiek zijn voor een specifiek (mechanisme) model beschrijving\footnote{Voorbeelden van instellingen zijn modelfactoren.}. 
\end{enumerate}

\section{Datamanagement waterkeringen}
\label{sec:DatamanagementWaterkeringen}
\subsection{Algemeen}
\label{sec:DWAlgemeen}
Voor het uitvoeren van geotechnische berekeningen is een aanzienlijke hoeveelheid data nodig. 
Zo heeft elk model zijn eigen databehoefte. 
De data vraag is onafhankelijk van de wijze van uitvoering, handmatig of (grotendeels) geautomatiseerd. 
Veel van de benodigde kerngegevens zijn locatie specifieke gegevens. 
Sommige gegevens worden gebruikt voor de beoordeling van verschillende faalmechanismen. 
Deze gegevens zijn generiek van aard. Voorbeelden hiervan zijn profiellijnen, polderpeilen en stijghoogten. 
Andere gegevens worden gebruikt voor de beoordeling van een specifiek mechanismen met een specifiek rekenmodel. 
Deze gegevens zijn model specifiek. Een voorbeeld hiervan is de aanwezigheid en grootte van verkeersbelasting.

Als gekeken wordt naar de traditionele aanpak en beschikbare tools dan valt op dat de applicaties los van elkaar ontwikkeld zijn en voor verschillende doelen. 
Er is geen sprake van een uniforme ontwikkelstrategie, architectuur of programmeertaal.
De invoer voor de tools kan (bijvoorbeeld) bestaan uit het importeren van tekstbestanden, of doormiddel van een geavanceerde User Interface (UI). 
Wat de meeste tools onderling gemeen hebben is dat alleen gegevens voor specifieke locaties nodig zijn (dwarsprofiel niveau). 
De benodigde gegevens zijn meestal relatief, dat wil zeggen dat ze niet gerelateerd zijn aan RD-coördinaten. 
De kerngegevens zijn afkomstig uit een GIS van de waterkeringbeheerder, losse bestanden of analoge bronnen. 
Er is altijd een (handmatige) tussenstap nodig om de gegevens te importeren/invoeren in de benodigde applicatie. 
Daarnaast zijn de gegevens niet (één op één) onderling uitwisselbaar tussen de verschillende tools.

Binnen DAM, maar ook het Wettelijk toetsinstrumentarium (WTI) 2017, wordt uitgegaan dat het bronhouderschap van de data bij de waterkeringbeheerder. 
Hierbij wordt gestreefd naar (centraal) digitaal databeheer bij de waterkeringbeheerders (\autoref{fig:Kerngegevens}). 
Hierdoor wordt de toegankelijkheid van de gegevens vergroot en onderlinge uitwisseling vergemakkelijkt ten behoeve van de verschillende processen 
en applicaties binnen een waterschap en Rijkswaterstaat, of tussen verschillende waterschappen en/of Rijkswaterstaat of andere delen van de Rijksoverheid. 
Daarnaast wordt zo (eenvoudiger) voorkomen dat verschillende versies van de gegevens bestaan. 

Het beheren van de gegevens gebeurt en zal naar verwachting steeds meer gebeuren in een Geografisch Informatiesysteem (GIS). 
Binnen een GIS kunnen gegevens ruimtelijk vastgelegd worden. 
Dit biedt grote voordelen. 
Hier zal verder op in gegaan worden in onderstaande paragrafen. 
In \autoref{sec:RuimtelijkeVastleggingKerngegevens} wordt stil gestaan bij het principe van het ruimtelijk vastleggen van de gegevens. 
Opmerkingen ten aanzien van het beheer van de gegevens zijn opgenomen in \autoref{sec:BeheerKerngegevens}. 
In \autoref{sec:KwaliteitKerngegevens} wordt een opmerking gemaakt over de kwaliteit van de gegevens. 
De data uitwisseling wordt beschreven in \autoref{sec:GegevensUitwisseling}. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.8\textwidth]{Pictures/Reference/Kerngegevens.png}
	\caption{Centraal beheer kerngegevens binnen het waterschap voor de verschillende processen en taken}
	\label{fig:Kerngegevens}
\end{figure}

\subsection{Ruimtelijke vastlegging van (kern)gegevens}
\label{sec:RuimtelijkeVastleggingKerngegevens}
Binnen de software ontwikkeling wordt gestreefd om te komen tot een eenduidige faalmechanisme bibliotheek, aangeroepen vanuit het rekenplatform, bijvoorbeeld DAM. 
Dit is schematisch weergegeven in \autoref{fig:ModulaireOntwikkelstrategieSoftware}. 
Doordat de applicaties dezelfde rekenmodellen gebruiken zullen ze ook in sterke mate dezelfde gegevensbehoefte hebben. 
Daarnaast kan de databehoefte tussen de verschillende modellen (gedeeltelijk) hetzelfde zijn. 
Te denken valt aan de hoogteligging van de profielen (NAP hoogtes) en karakteristieke-lijnen, bijvoorbeeld de kruin- en teenlijnen. 

Het ligt voor de hand om de kerngegevens eenduidig en ruimtelijk vast te leggen. 
Dit vergoot meervoudig gebruik van de gegevens.
Hier zou de parallel getrokken kunnen worden met een straat welke eerst open ligt om de stroomkabels te vervangen en een maand later weer open gemaakt moet worden om de glasvezelkabel aan te brengen. 
Dit is een ongewenste situatie. 
Dit zou ook gesteld kunnen worden voor het opslaan en beheer van de gegevens. 
Door de coherentie in databehoefte tussen verschillende modellen en toepassingen zal het streven moeten zijn om te komen tot een eenduidig gedefinieerde dataopslag en formaten, 
zodat de gegevens voor verschillende doelen en toepassingen gebruikt kunnen worden, 
zonder met allemaal verschillende (dubbele) gegevens te gaan werken, welke allemaal opgeslagen zijn in verschillende onafhankelijke databases. 
Dus niet telkens weer de ‘weg openbreken’, maar een gecoördineerde vastlegging van gegevens.

Het gebruik van GIS bij het vastleggen van kerngegevens is daarbij gewenst. 
Zoals reeds aangegeven in \autoref{sec:DWAlgemeen} maken de waterschappen in sterke mate gebruik van GIS. 
Echter, hier wordt vanuit de rekenmodellen nauwelijks op aangesloten. 
Dit is bij de ontwikkeling van DAM als een tekortkoming bestempelt. 
Het werken met een GIS kent namelijk verschillende voordelen. 
Een belangrijk element hierin is het Spatial Thinking. 
Daarnaast beschikken GIS pakketten over zeer krachtige tools om data te bewerken en te analyseren \citep{Gomez2010}. 

In de basis is een GIS eenvoudig te omschrijven als een database waarin informatie gekoppeld wordt aan een ruimtelijk object. 
Dit kunnen zijn; punten, lijnen of vlakken. 
In het GIS ‘tekent’ de gebruiker (bijvoorbeeld) een lijn en koppelt daar gegevens aan. 
Deze gegevens worden opgeslagen in een tabel. 
Ook wel de attributen genoemd. 
Deze tabel kan één, bijvoorbeeld polderpeil binnen een bepaald gebied, of meerdere attributen bevatten, bijvoorbeeld gegevens van een dijkbekledingsvak. 
\Autoref{fig:VoorbeeldGIS} toont een screen-dump van een GIS. 
Hierin is de rode lijn een door de gebruiker geselecteerde lijn. 
In het geopende scherm wordt de tabel getoond met daarin de attribuut. 
Hier genaamd CODE met de waarde 203, refererend naar een ondergrondsegment met referentienummer (CODE) 203. 
Alle locaties (de groene bolletjes) vallende binnen de strekking van het geselecteerde lijnelement vallen binnen het ondergrondsegment 203.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Reference/VoorbeeldGIS.png}
	\caption{Voorbeeld van een GIS waar de attributentabel getoond wordt voor de geselecteerde lijn (met rood weergegeven)}
	\label{fig:VoorbeeldGIS}
\end{figure}

Door gegevens ruimtelijk vast te leggen in een GIS worden ze niet meer locatie specifiek, maar gelden ze voor een gebied (zie \autoref{fig:GegevensPerLocatieVsPerGebied}).
De betreffende gegevens zijn dan van kracht voor alle locaties vallende binnen het gebied. 
Het voordeel hiervan is dat feitelijk op elke locatie gegevens beschikbaar zijn. 
Stel dat in de toekomst het maatgevende dwarsprofiel niet meer op dezelfde locatie ligt (nieuwe locatie) als tijdens een eerdere (toets)ronde, 
dan zou in het geval van locatie vastgelegde gegevens de koppeling tussen de bestaande gegevens en de nieuwe dwarsprofiellocatie niet meer van kracht zijn. 
Immers, het is niet eenvoudig aan te geven of dezelfde uitgangspunten (gegevens) ook gelden voor de nieuwe locatie. 
Bijvoorbeeld de aanwezige dijkbekleding. 
In het geval van ruimtelijke vastlegging per gebied maakt het niet uit. 
In dit geval wordt namelijk gekeken in welk gebied een bepaalde locatie valt. 

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Reference/GegevensPerLocatieVsPerGebied.png}
	\caption{Gegevens vastleggen per locatie (linker figuur) versus per gebied (rechter figuur). De rode stippen zijn bijvoorbeeld dwarsprofiel locaties.}
	\label{fig:GegevensPerLocatieVsPerGebied}
\end{figure}

Het ruimtelijk vastleggen van gegevens ondersteunt de werkwijze  ‘van grof naar fijn’. 
Dit komt overheen met de aanpak uit ondere andere het toetsproces. 
Ter illustratie, voor een stabiliteitssom zijn de stijghoogtes van belang. 
Als eerste stap kunnen conservatieve uitgangspunten gekozen worden binnen een gebied. 
Als tijdens het rekenproces blijkt dat een deel van de waterkering hierdoor niet goedgekeurd kan worden, 
dan kan voor deze locatie gedetailleerder naar de uitgangspunten gekeken worden. 
Bijvoorbeeld door het uitvoeren van veldmetingen of geavanceerdere modellen te gebruiken. 
De gevonden waarden kunnen dan ingevoerd worden in het GIS voor het gebied waarvoor de aangescherpte gegevens van kracht zijn (zie \autoref{fig:VerfijningKerngegevens}, gebied 2). 
Via deze methode wordt feitelijke een gebiedsverbeterend systeem gecreëerd, waarbij het uitgangspunt is werken van globaal naar fijn (op maat). 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.8\textwidth]{Pictures/Reference/VerfijningKerngegevens.png}
	\caption{Verfijning kerngegevens binnen een gebied waarbij gewerkt wordt van globaal naar fijn}
	\label{fig:VerfijningKerngegevens}
\end{figure} 

\subsection{Beheer van kerngegevens}
\label{sec:BeheerKerngegevens}
Voor het in voorgaande paragraaf beschreven databeheer is het van belang om te weten welke gegevens nodig zijn voor het uitvoeren van een toetsing, 
maar ook voor andere toepassingen (beleid, dagelijks beheer, calamiteitenbestrijding en versterken). 
Voor DAM zijn alle benodigde parameters (per spoor) beschreven en opgenomen in \autoref{app:LocationParameters}. 
Door de databehoefte duidelijk te definiëren vanuit de rekenplatformen (bijvoorbeeld DAM en Ringtoets) kan de inwinstrategie van gegevens daarop ook aangepast worden 
en vertaald worden naar protocollen en standaardisatie in uitvragen van waterkeringbeheerders. 

Ten aanzien van Iris dient de opmerking geplaatst te worden dat niet alle parameters benodigd voor het uitvoeren van DAM berekeningen aanwezig zijn in de database. 
Daarnaast verschilt het gebruik van Iris sterk per waterschap. 
Door wel de gegevens op te nemen in een GIS (Iris is ook een GIS database) zijn gegevens altijd relatief makkelijk te muteren als, bijvoorbeeld, Iris uitgebreid zal worden.
Of in het geval overgestapt zou worden naar een nieuwe database.

In ieder geval creëert de beschreven databehoefte van DAM en/of Ringtoets geen afhankelijkheid voor het gebruik van de software. 
Immers, het betreft basisgegevens welke ruimtelijk vastgelegd zijn binnen het GIS van het waterschap. 
Deze gegevens kunnen ook gebruikt worden door andere applicaties en toepassingen.

\subsection{Kwaliteit van kerngegevens}
\label{sec:KwaliteitKerngegevens}
Een goed databeheer zegt veel, maar niet alles over de juistheid van de uitgevoerde berekeningen. 
De kwaliteit van de berekeningen is sterk afhankelijk van de kwaliteit van de gegevens. 
Het borgen van de kwaliteit van de gegevens binnen het datamanagement is de verantwoordelijkheid van de bronhouder. 
Daarbij maakt het niet uit of de gegevens gebruikt worden binnen een meer traditioneel ingericht werkproces of een proces dat gekenmerkt wordt door een hoge mate van automatisering (DAM en/of Ringtoets). 
De kwaliteit van de gegevens moet goed zijn.

\cite{Popering2004} stelt op basis van zijn uitgevoerde onderzoek dat bij de door hem onderzochte instanties gebleken is dat in veel gevallen de werkelijke kwaliteit van geo-informatie niet getoetst wordt 
en dat er geen normen gesteld worden. 
Aangezien gebleken is dat er een aanzienlijk verschil bestaat tussen de werkelijke en gewenste/veronderstelde kwaliteit van de attribuutnauwkeurigheid van de geo-informatie, 
mag er niet aangenomen worden dat dit bij niet-getoetste kwaliteitsparameters wel overeen zal komen. 
Hierdoor wordt het belang van het stellen en toetsen van normen van kwaliteit van geo-informatie zeer hoog geacht. 
Door inzicht in de kwaliteit van geo-informatie is het ook mogelijk om het inwin- of beheersproces te verbeteren en hiermee de kwaliteit te verhogen.

Als hoofconclusie stelt \cite{Popering2004} dat de kwaliteit van geo-informatie nog niet op een dusdanige wijze gewaarborgd wordt zodat deze aansluit op de nominale grondslag 
of op de vereiste kwaliteit ten behoeve van het bedrijfsproces. 
Wel worden er aanbevelingen gedaan om hierin verbeteringen aan te brengen. 

\subsection{Gegevens uitwisseling tussen DAM en databases waterschappen}
\label{sec:GegevensUitwisseling}
Door alle gegevens centraal op te slaan en duidelijke uitwisselingsformaten tussen de verschillende applicaties in de vorm van Application Programming Interfaces (API’s) 
voor te schrijven kunnen dezelfde (up to date) kerngegevens gebruikt worden voor de verschillende sporen binnen DAM, 
maar ook voor ander applicaties en processen bij waterkeringbeheerders. 
Hiermee wordt eenduidigheid gecreëerd in de uitgangspunten.

Op hoofdlijnen zal de uitwisseling tussen het GIS van de waterschappen en DAM gebeuren doormiddel van gestandaardiseerde formaten als shape files en *.csv bestanden. 
Hiervoor is gekozen om te voorkomen dat afhankelijkheid gecreëerd wordt van (dure) commerciële oplossingen. 
Dit zou bijvoorbeeld het geval zijn als direct gekoppeld zou worden met de Oracle Databases. 
Overigens blijft deze mogelijkheid wel open als blijkt dat dit in de toekomst wel gewenst is. 

Als binnen DAM een nieuw project gestart wordt zal een snapshot gemaakt worden van de actuele gegevens bij het desbetreffende waterschap 
(zie \autoref{chp:Projectdata}). 
Met andere woorden, er wordt een kopie gemaakt van de actuele data en opgeslagen in de projectdatabase van DAM (*.damx). 
Lopende het project kan het detail niveau van de gegevens, afhankelijk van de tussenresultaten, uitgebreid en verfijnd worden om tot een zo scherp mogelijk oordeel/uitkomsten te komen. 
Tijdens het Werken met DAM zal dan ook in veel gevallen spraken zijn van een continue data uitwisseling tussen de database van het waterschap en DAM.
Overigens is dit geen automatisch proces, maar geïnitieerd door de gebruiker.
Dit om te voorkomen dat er ongewenste updates van de gegevens het werkproces verstoren.

\section{DAM Systeemvereisten}

\begin{table}[H]
\begin{tabular}{|p{45mm}|p{40mm}|p{\textwidth-36pt-85mm}|} \hline 
\textbf{Kenmerk} & \textbf{Geadviseerd} & \textbf{Minimaal} \\ \hline
Processor & Intel Core i7 of beter & Intel Core i5 \\ \hline
Kloksnelheid & 2.4 GHz & 2.4 GHz \\ \hline
Geheugen (RAM) & 8 GB of meer & 4 GB \\ \hline
Vrije harde schijfruimte & 100 GB of meer & 20 GB \\ \hline
Monitor & Twee keer 22 inch monitor, resolutie 1920$\times$1080 & Eén keer 22 inch monitor, resolutie 1920$\times$1080 \\ \hline
Operating systeem & \multicolumn{2}{p{\textwidth-24pt-45mm}|}{Windows 10 \newline
Windows 2008 \newline
Windows 7- 32 bits \newline
Windows 7- 64 bits} \\ \hline
Toegangsrechten & \multicolumn{2}{p{\textwidth-24pt-45mm}|}{Schrijfrechten op een door de gebruiker aan te wijzen directory voor databases.} \\ \hline
Admin rechten & \multicolumn{2}{p{\textwidth-24pt-45mm}|}{Alleen nodig voor installatie, 
indien gewenste installatie directory in Program Files is, 
hetgeen gebruikelijk is, maar kan dus ook op een andere locatie.} \\ \hline
Microsoft DotNet framework & \multicolumn{2}{p{\textwidth-24pt-45mm}|}{Versie 4.5} \\ \hline
\end{tabular}
\end{table}

\chapter{DAM User interface}
Het hoofdscherm van de user interface van DAM kent verschillende (sub)schermen of vensters:
\begin{itemize}[noitemsep, nolistsep]
	\item \nameref{sec:Hoofdvenster}
	\item \nameref{sec:Navigatorvenster}
	\item \nameref{sec:Kaartvenster}
	\item \nameref{sec:Tabellenvenster}
	\item \nameref{sec:Eigenschappenvenster}
\end{itemize}

Bij het aanmaken van een nieuw project verschijnt een pop-up scherm \nameref{sec:NieuwProject}.

De vensters kunnen versleept worden en zijn, in het engels genaamd ‘dockable’. 
Tijdens het slepen is een verkleinde indeling van het scherm te zien en door met de muis naar een bepaald gebied te gaan, wordt het te verslepen venster in dat gebied geplaatst. 
Het gebied wordt op het scherm, ter verduidelijking, blauw gearceerd. 
Niet alleen de vensters zijn te verslepen en ‘dockable’, ook de afzonderlijke tabbladen kunnen verplaatst worden. 
Dit kan vooral handig zijn, indien er op meerdere beeldschermen wordt gewerkt. 
Indien de gebruiker terug wil naar de default instellingen, kan dit met de reset-knop in de menubalk.

Elk venster kent een menubalk met verschillende knoppen.

\section{Hoofdvenster}
\label{sec:Hoofdvenster}
Wanneer DAM is opgestart, verschijnt het hoofdscherm (\autoref{fig:Hoofdvenster}).
Dit scherm bevat een menubalk, een icon bar en meerdere vensters.
DAM kan met een leeg project starten of met het laatst geopende project, afhankelijk van de instellingen.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/UserInterface/HoofdVenster.png}
	\caption{Hoofdvenster}
	\label{fig:Hoofdvenster}
\end{figure}

De menubalk bevat diverse knoppen. 
Hieronder volgt een uitleg per knop.
\begin{longtable}{p{7mm}p{\textwidth-24pt-7mm}} \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-Nieuw.png} & 
\textbf{Nieuw}: Maak een nieuw bestand. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-Openen.png} & 
\textbf{Openen}: Open een bestaand bestand. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-Opslaan.png} & 
\textbf{Opslaan}: Sla het huidige bestand op. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-OngedaanMaken.png} & 
\textbf{Ongedaan maken}: Maak meeste recente actie ongedaan. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-Opnieuw.png} & 
\textbf{Opnieuw}: Herhaal de laatst ongedane actie. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-Start.png} & 
\textbf{Start}: Start de berekening (F9). \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-Afbreken.png} & 
\textbf{Afbreken}: Stopt de berekening. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Menu-Herstel.png} & 
\textbf{Herstel}: Plaats alle schermen op hun standaard positie. \\ \ghline
\end{longtable}


\section{Navigatorvenster}
\label{sec:Navigatorvenster}
De boomstructuur in het navigator venster kan gebruikt worden om door de invoer en de  berekeningen te navigeren. 
Wanneer er geen project open staat, heeft dit venster geen functie.

Nadat een project is geopend, met Bestand-Openen of Bestand-Nieuw, toont het venster in een boomstructuur de beschikbare dijkringen, trajecten met dwarsprofielen. 
Navigeren is mogelijk door op een dwarsprofiel te klikken. 
De andere vensters laten dan ook de gegevens van het betreffende profiel zien. 
Met dit navigatievenster wordt ook aangegeven welke dwarsprofielen doorgerekend gaan worden door middel van aanvinken. 
Dat kan door of afzonderlijke dwarsprofielen of het betreffende niveau  (traject)  aan te vinken. \\
Er kan maar 1 dijkstrekking in een DAM-project worden doorgerekend.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.4\textwidth]{Pictures/UserInterface/NavigatorVenster.png}
	\caption{Navigatorvenster}
	\label{fig:NavigatorVenster}
\end{figure}

\section{Kaartvenster}
\label{sec:Kaartvenster}
Dit venster heeft de volgende tabbladen:
\begin{enumerate}[noitemsep, nolistsep]
	\item \nameref{sec:Dwarsdoorsnede}
	\item \nameref{sec:Afbeelding}
	\item \nameref{sec:Kaart}
\end{enumerate}

\subsection{Dwarsdoorsnede}
\label{sec:Dwarsdoorsnede}
In dit scherm is de geselecteerde locatie te zien met op de hoogte geometrie de karakteristieke punten. 
Deze zijn niet versleepbaar, maar wel aan te passen via het \nameref{sec:Eigenschappenvenster}. \\
Indien de ondergrond uit een 1Dprofiel bestaat is, zijn de grondlagen zichtbaar. \\
In de menubalk zijn de verschillende ondergrondprofielen selecteerbaar.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.5\textwidth]{Pictures/UserInterface/DwarsdoorsnedeMenubalkProfiel.png}
	\caption{Dwarsdoorsnede - Menubalk profiel}
	\label{fig:DwarsdoorsnedeMenubalkProfiel}
\end{figure}

\begin{longtable}{p{7mm}p{\textwidth-24pt-7mm}} \ghline
\includebutton{Pictures/UserInterface/Knoppen/Dwarsdoorsnede-Selectie.png} & 
\textbf{Selectie}: Selecteer geometrie objecten. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Dwarsdoorsnede-Verschuif.png} & 
\textbf{Verschuif}: Verschuif beeld. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Dwarsdoorsnede-ZoomNaarLimietenEnBehoudAspectRatio.png} & 
\textbf{Zoom naar limieten en behoud aspect ratio}: Zoom tot alle inhoud op het scherm past met behoud van de verhoudingen. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Dwarsdoorsnede-ZoomNaarLimietenEnHerstelAspectRatio.png} & 
\textbf{Zoom naar limieten en herstel aspect ratio}: Zoom tot alle inhoud op het scherm past en herstel de X- en Z-verhoudingen. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Dwarsdoorsnede-ZoomPerRechthoek.png} & 
\textbf{Zoom per rechthoek}: Klik en verplaats muis van top-links naar bodem-rechts om in te zoomen.
Verplaats de muis in tegengestelde richting om uit te zoomen. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Dwarsdoorsnede-Opties.png} & 
\textbf{Opties}: Instellingen beeld. \\ \ghline
\end{longtable}

\subsection{Afbeelding}
\label{sec:Afbeelding}
Dit tabblad laat de afbeelding zien van de geselecteerde stabiliteitsberekening. 
Het selecteren van de locatie is niet voldoende, omdat een locatie veelal meerdere stabiliteitsberekeningen kent. 
Berekeningen kunnen geselecteerd worden in het tabellen venster, tab Tabellen, tab Berekeningen. 

\subsection{Kaart}
\label{sec:Kaart}
Dit tabblad laat de kaart zien van het gebied en de ligging van de dwarsprofielen. 
Er kunnen kaartlagen toegevoegd worden om deze in te zien.

\begin{longtable}{p{7mm}p{\textwidth-24pt-7mm}} \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-Selectie.png} & 
\textbf{Selectie}: Selectie. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-ZoomNaarAlleKaartlagen.png} & 
\textbf{Zoom naar alle kaartlagen}: Zoom naar alle kaartlagen, behalve een web laag. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-ZoomNaarGegevens.png} & 
\textbf{Zoom naar gegevens}: Zoom tot alle inhoud op het scherm past. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-ZoomTotGeselecteerdeDataOpDeKaart.png} & 
\textbf{Zoom tot geselecteerde data op de kaart}: Zoom in op geselecteerde data op de kaart. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-ZoomNaarRechthoek.png} & 
\textbf{Zoom naar rechthoek}: Zoom naar rechthoek. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-ToonLegenda.png} & 
\textbf{Toon legenda}: Toon legenda. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-OpenenLaagVanBestand.png} & 
\textbf{Openen laag van bestand}: Opent een kaartlaag uit een bestand. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-ExporteerKaartlagen.png} & 
\textbf{Exporteer kaartlagen}: Exporteer kaartlagen. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Kaart-SlaatDeKaart.png} & 
\textbf{Slaat de kaart zoals nu zichtbaar als afbeelding op}: Slaat de kaart zoals nu zichtbaar als afbeelding op. \\ \ghline
\end{longtable}

\section{Tabellenvenster}
\label{sec:Tabellenvenster}
Dit venster bestaat uit meerdere tabbladen, die elk ook weer tabbladen bevatten:
\begin{itemize}[noitemsep, nolistsep]
	\item Tabellen	
	\begin{itemize}[noitemsep, nolistsep]
		\item Materialen
		\item Locaties		
		\begin{itemize}[noitemsep, nolistsep]
			\item Scenarios
		\end{itemize}
		\item Ontwerpberekeningen
	\end{itemize}
	\item Validatie
	\item Log
\end{itemize}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/UserInterface/TabellenVenster.png}
	\caption{Tabellenvenster}
	\label{fig:TabellenVenster}
\end{figure}

\todo{Add also a picture where Materialen tab is present (input) and add a cross-reference in bullets above.}

\begin{longtable}{p{7mm}p{\textwidth-24pt-7mm}} \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-Toevoegen.png} & 
\textbf{Toevoegen}: Voeg rij toe. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-Verwijderen.png} & 
\textbf{Verwijderen}: Verwijder rij. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-Kopieren.png} & 
\textbf{Kopiëren}: Kopieer. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-Plakken.png} & 
\textbf{Plakken}: Plakken. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-Aanpassen.png} & 
\textbf{Aanpassen}: Pas alle kolommen aan zodat alle inhoud past. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-Wijzig.png} & 
\textbf{Wijzig}: Bewerk. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-WijzigEenheid.png} & 
\textbf{Wijzig eenheid}: Wijzig de eenheid voor het gebuikte type. \\ \ghline
\includebutton{Pictures/UserInterface/Knoppen/Tabellen-TabelExporteren.png} & 
\textbf{Tabel exporteren}: Tabel exporteren naar bestand. \\ \ghline
\end{longtable}

\section{Eigenschappenvenster}
\label{sec:Eigenschappenvenster}
De inhoud van het eigenschappenvenster hangt af van de selectie in de andere vensters.

Indien een locatie geselecteerd wordt in een van de andere vensters, verschijnen de tabbladen Locatie, Locatiescenario's en Hoogtegeometrie. \\
In het tabblad Locatie zijn dezelfde gegevens te zien als in het tabellenvenster, maar nu overzichtelijker gerangschikt.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.6\textwidth]{Pictures/UserInterface/EigenschappenVensterLocatieTab.png}
	\caption{Eigenschappenvenster - Tabblad Locatie}
	\label{fig:EigenschappenVensterLocatieTab}
\end{figure}

Het tabblad locatiescenario's laat alle rekenscenario's voor deze locatie zien. 
De gegevens zijn wel aan te passen, maar er kunnen (nog) geen scenario's toegevoegd worden.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.7\textwidth]{Pictures/UserInterface/EigenschappenVensterLocatieScenariosTab.png}
	\caption{Eigenschappenvenster - Tabblad Locatie scenario's}
\end{figure}

Het tabblad hoogtegeometrie laat alle punten van de hoogtegeometrie zien. 
In de kolom karakteristiek punt kan aangegeven welk karakteristiek punt het betreft. 
Deze dienen wel aan voorwaarden te voldoen, zie \nameref{sec:KarakteristiekePunten}.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.4\textwidth]{Pictures/UserInterface/EigenschappenVensterHoogtegeometrieTab.png}
	\caption{Eigenschappenvenster - Tabblad Hoogtegeometrie}
	\label{fig:TabbladHoogtegeometrie}
\end{figure}

Indien in het menu voor berekening-opties wordt gekozen, verschijnt het berekeningentabblad in het eigenschappenscherm. 
Hier kunnen de rekeninstellingen opgegeven worden, zoals type faalmechanisme, model met bijbehorende opties.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.6\textwidth]{Pictures/UserInterface/EigenschappenVensterBerekeningTab.png}
	\caption{Eigenschappenvenster - Tabblad Berekening}
\end{figure}

Nadat een berekening is uitgevoerd, verandert het tabblad Berekening zodat de resultaten zichtbaar zijn.

\section{Nieuw project}
\label{sec:NieuwProject}
DAM werkt aan de hand van projecten. 
Deze worden aangemaakt door basisdata in te lezen.
Wanneer in DAM gestart wordt met een nieuw project (keuze menubak Bestand-Nieuw), verschijnt het volgende pop-up window.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.6\textwidth]{Pictures/UserInterface/BestandNieuw.png}
	\caption{Nieuwe project}
	\label{fig:BestandNieuw}
\end{figure}

\textbf{Project specificatie} \\
Bij \nameref{sec:Berekeningstype} kan gekozen worden voor:
\begin{itemize}[noitemsep, nolistsep]
	\item Ontwerp (rekenen met of zonder geometrie aanpassing)
	\item Calamiteit (rekenen met tijdreeks)
	\item DAMLive configuratie (aanmaken project bestand voor DAMLive, dus met monitoringsgegevens)
\end{itemize}

En dienen de volgende bestanden te worden benoemd:
\begin{itemize}
	\item \textbf{DAM Databron bestand (*.defx)} \\
	Het \nameref{sec:DAMDatabronbestand} vertelt welke basisdata wordt ingelezen en waar deze basisdata vandaan komt. 
	Feitelijk is dit een kruisverwijzing tabel (mapping table).
	\item \textbf{DAM Project bestand (*.damx)} \\
	Het project wordt opgeslagen als een \nameref{sec:DAMProjectbestand}, de naam hiervan is standaard gelijk aan de defx-naam, maar kan aangepast worden door de gebruiker.
	Standaard krijgt deze dezelfde locatie en naam als het databron bestand, maar de gebruiker kan dat hier veranderen.
	Aangeraden wordt om wel dezelfde locatie te hanteren.
	\item \textbf{Sensor gegevens bestand} \\
	Bij een DAMLive configuratie dienen de sensor gegevens in een Excel bestand (*.xls) beschikbaar te zijn. 
	Hier wordt de locatie aangewezen
\end{itemize}

\textbf{Selecteer dijkringen} \\
Indien de brondata meerdere dijkringen bevatten, kan hier de gewenste dijkring(en) worden opgegeven. \\
Opmerking: het inlezen van meerdere dijkringen kan fouten opleveren, daarom wordt geadviseerd met 1 dijkring per DAM-project te werken.

\todo{Text above must be updated because if several dijringen are present, only one can be selected. 
Selecting several one leads to an error message. \\
Text below (in ``Dijkringen'') can be removed or merged.}

\textbf{Dijkringen} \\
Vervolgens verschijnen er meerdere dijkringen, wanneer er meerdere dijkringen in de bronbestanden aanwezig zijn. 
Anders zal de keuze beperkt zijn tot 1 dijkring.

\textbf{Projectie} \\
Wanneer er gebruikt wordt gemaakt van een andere GIS projectie dan Rijksdriehoekstelsel (Nieuw-Amersfoort), kan dat hier worden aangegeven.

\textbf{Ok/Cancel} \\
Nadat Ok is geselecteerd, wordt de data geïmporteerd en het DAM-projectbestand aangemaakt. 
Bij Cancel wordt opstart van een nieuw project geannuleerd.

\chapter{Projectdata}
\label{chp:Projectdata}
\section{Inleiding}
De eerste stap in de DAM systematiek is het vergaren/importeren van de benodigde gegevens. 
DAM heeft een diversiteit aan gegevens nodig. 
Sommige gegevens zijn verplicht, andere zijn optioneel. 
In dit hoofdstuk wordt ingegaan op de benodigde gegevens, als wel het formaat. 
Met het oog op het dagelijks gegevensbeheer wordt bij voorkeur (zie \autoref{sec:DatamanagementWaterkeringen}) de projectdata zoveel mogelijk in shape bestanden beschikbaar gesteld, 
maar alle gegeven importeren in *.csv bestanden is ook mogelijk. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.6\textwidth]{Pictures/Projectdata/Stap1DAMConcept.png}
	\caption{Stap 1 in het DAM concept is het vergaren/importeren van de benodigde gegevens}
	\label{fig:Stap1DAMConcept}
\end{figure}

Op globaal niveau kunnen de benodigde gegevens onderverdeeld worden:
\begin{itemize}[noitemsep, nolistsep]
	\item \nameref{sec:Locatiedefinitie}
	\item \nameref{sec:Dwarsprofielgeometrie}
	\item \nameref{sec:Ondergrondmodel}
	\item \nameref{sec:Locatiegegevens}
	\item \nameref{sec:Waterstandgegevens}
	\item \nameref{sec:Rekenscenarios}
\end{itemize}

Voor alle data geldt dat de volgende karakters geaccepteerd worden:
\begin{verbatim}
ABCDEFGHIJKLMNOPQRSTUVWXYZ
abcdefghijklmnopqrstuvwxyz
01234567879
!#%$ &()*+,-.
:;<=>?@
[\]^_`" "{|}~
" " (space)
\end{verbatim}

\section{Locatiedefinitie}
\label{sec:Locatiedefinitie}
DAM voert berekeningen uit per locatie (dwarsprofielniveau), dus niet per vak. 
Overigens wordt een locatie wel representatief geacht voor een bepaalde strekking van de waterkering. 
Echter, binnen dit document wordt hier niet verder op ingegaan en wordt doorverwezen naar de vigerende handreikingen, technische rapportages et cetera.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.8\textwidth]{Pictures/Projectdata/VoorbeeldLocatie.png}
	\caption{Voorbeeld van een locatie, inclusief attribuuttabel, binnen het DAM concept}
	\label{fig:VoorbeeldLocatie}
\end{figure}

Binnen DAM wordt de ligging van een dwarsprofiel vastgelegd door de ‘Locatie’ (zie \autoref{fig:VoorbeeldLocatie}). 
Een locatie is een punt en wordt ruimtelijk gedefinieerd door een XY-coördinaat. 
Als gewerkt wordt met shape bestanden, dan bevat de attribuut tabel voor de locatie shape de volgende (hard gedefinieerde) attributen:
\begin{enumerate}
	\item LOCATIONID; de naam van de locatie, bijvoorbeeld dijkring\_hectometrering
	\item DIKERING\_ID; de naam van de dijkring. 
	Dijkring wordt hier meestal in de zin van projectgebied gebruikt en niet zozeer de dijkringindeling van de primaire keringen.
	Overigens is deze keuze geheel vrij.
	\item DAMTYPE; Geeft aan of het een primaire kering (primary), dan wel regionale kering (regional) betreft.
\end{enumerate}

De LOCATIONID, net als andere naamgeving binnen DAM, mag geen leestekens bevatten (\#, -, \& of :).
Dit kan problemen opleveren in de verdere verwerking van de bestanden. 
Daarnaast mogen spaties ook niet, hiervoor kan een underscore (\_) gebruikt worden als koppelteken.


Naast de locaties dient ook de ligging van de cross-sections geïmporteerd te worden. 
De cross-sections zijn gedefinieerd van de buitenwaartse zijde van het dijklichaam richting de binnenwaartse zijde. 
De lengte van de cross-sections hoeft niet gelijk te zijn aan de lengte van de geometrie (zie \autoref{sec:Dwarsprofielgeometrie}).

De koppeling tussen de locaties en de cross-sections, als wel de dwarsprofielgeometrie, gebeurt met behulp van de LOCATIONID. 
De attribuuttabel van de cross-section shape bevat daarom de verplichte attribuut LOCATIONID (zie \autoref{fig:VoorbeeldCrossSection}). 
Voor een correcte koppeling dienen de namen dus exact hetzelfde te zijn. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.8\textwidth]{Pictures/Projectdata/VoorbeeldCrossSection.png}
	\caption{Voorbeeld van een cross-section, inclusief attribuuttabel, binnen het DAM concept}
	\label{fig:VoorbeeldCrossSection}
\end{figure}

De locaties en cross-sections worden gebruikt om bij het importeren van gegevens uit shapes de gegevens te koppelen aan de juiste locatie. 
Afhankelijk van het type shape; lijnen of vlakken, worden de cross-sections of locaties gebruikt.
Zie \autoref{sec:DataExtractie}.

\subsection{Data extractie}
\label{sec:DataExtractie}
De locaties en cross-sections worden gebruikt om bij het importeren van gegevens uit shapes de gegevens te koppelen aan de juiste locatie. 
Afhankelijk van het type shape; lijnen of vlakken, worden de cross-sections of locaties gebruikt. \\
Locatie: punt (X,Y coördinaten) die het te berekenen dwarsprofiel aangeeft. \\
Cross-section: lijn (in X,Y coördinaten) op de kaart van het te berekenen dwarsprofiel. \\

\subsubsection{Data-extractie uit lijnen-shape}
\label{sec:DataExtractieUitLijnen}
In een shape-bestand, genaamd crosssections.shp (verplichte naam), 
worden de cross sections opgegeven met een (verplicht) attribuut LocationID om de koppeling tussen de locaties (punten) 
en cross sections (lijnen) aan te geven. 
Wanneer een parameter opgenomen is in een lijnen-shape, dan zal DAM tijdens het importeren per cross-section nagaan of de cross-section snijdt met de geïmporteerde lijnen-shape. 
Ter verduidelijking is in \autoref{fig:VoorbeeldDataExtractieUitLijnenShape} een voorbeeld opgenomen waarbij een cross-section snijdt (binnen de groene cirkel) met de lijn waarin het dijksmateriaal van de regionale kering is opgenomen. 
In dit geval ‘Klei’. \\
Het mogen duidelijk zijn dat een cross-section niet mag snijden met meerdere lijnen per locatie. 
Dit om meerduidigheid te voorkomen. 
Als DAM tijdens het importeren vaststelt dat de cross-section meerdere snijpunten vindt, of geen enkele, 
dan wordt voor deze specifieke locatie een foutmelding gegenereerd. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.8\textwidth]{Pictures/Projectdata/VoorbeeldDataExtractieUitLijnenShape.png}
	\caption{Voorbeeld dataextractie uit een lijnen-shape}
	\label{fig:VoorbeeldDataExtractieUitLijnenShape}
\end{figure}

\subsubsection{Data-extractie uit vlakken-shape}
\label{sec:DataExtractieUitVlakken}
Als een parameter opgenomen is in een vlakken-shape, dan zal DAM tijdens het importeren per locatie nagaan of de locatie in een vlak valt binnen de vlakken-shape. 
In \autoref{fig:VoorbeeldDataExtractieUitVlakkenShape} is een voorbeeld weergegeven waar een specifieke locatie valt in het vlak waarin de polderpeilen hoog (PLHigh = -0,5 m) 
en laag (PLLow = -0,5 m) opgenomen zijn.

Als alleen gewerkt wordt met *.csv bestanden, dan dienen de locatie en cross-line shape niet aangemaakt te worden.
De ligging van de locaties wordt dan vastgelegd in de \textit{locations.csv} (zie \autoref{sec:CsvFilesGebruiken}).

\begin{figure}[H]
	\centering
		\includegraphics[width=0.8\textwidth]{Pictures/Projectdata/VoorbeeldDataExtractieUitVlakkenShape.png}
	\caption{Voorbeeld dataextractie uit een vlakken-shape}
	\label{fig:VoorbeeldDataExtractieUitVlakkenShape}
\end{figure} 

\section{Dwarsprofielgeometrie}
\label{sec:Dwarsprofielgeometrie}
De hoogte ligging van een dijkprofiel wordt beschreven door een opeenvolgende reeks van punten welke onderling verbonden worden met rechte lijnstukken. 
De DAM systematiek gaat uit van een schematisering gebaseerd op X, Y, Z coördinaten. 
Voor toepassingen in Nederland worden (bij voorkeur) voor de X en Y coördinaat Rijksdriehoeksmeting (RD) coördinaten gebruikt. 
De hoogte wordt uitgedrukt ten opzichte van het referentievlak Normaal Amsterdams Peil (NAP). 
De gebruikte profielen dienen lang genoeg te zijn om een verantwoorde stabiliteitsanalyse of automatische profielaanpassing te kunnen uitvoeren (DAM Beleid spoor) 
en dienen de punten op een rechte lijn te liggen. 
Als dit niet het geval is klopt de geschematiseerde geometrie niet meer en zullen taludhellingen niet meer integer zijn. 
Dit heeft invloed op de resultaten van de stabiliteitsanalyse. 

Tegenwoordig worden steeds meer dijkstrekkingen ingemeten met behulp van laseraltimetrie, 
ook wel aangeduid onder de verzamelnaam remote sensing. 
Deze meettechniek levert grote hoeveelheden data op en geeft een goed en voldoende nauwkeurig beeld van de geometrie van grote strekkingen dijk. 
\Autoref{fig:VoorbeeldLaseraltimetrie} toont een voorbeeld van een boezemkade ‘ingevlogen’ met behulp van laseralitimetrie. 
In de figuur is ook te zien dat de waterbodem niet gemeten is. 
Dit wordt veroorzaakt door het reflecteren van de laserstraal op het wateroppervlak, waardoor de laserstralen niet de bodem bereiken. 
Voor de stabiliteitsanalyse is de ligging van de waterbodem wel van belang. 
Daarnaast heeft de ligging ook invloed op mechanismen als piping (locatie intredepunt onderwater). 
De ontbrekende geometrie van de waterbodem, buiten en binnendijks, dient dan ook meegenomen te worden in de beschrijving van het profiel. 
De ligging kan bepaald worden door het uitvoeren van bathymetrische metingen.
Dit kan met behulp van een positioneringsysteem en een echolood. 
Overigens wordt er ook wel voor gekozen om de baggerdiepte, theoretisch profiel van de waterbodem aan te houden, hier zijn (buiten DAM) tools voor beschikbaar. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.8\textwidth]{Pictures/Projectdata/VoorbeeldLaseraltimetrie.png}
	\caption{Voorbeeld laseraltimetrie data van een ingemeten boezemkade}
	\label{fig:VoorbeeldLaseraltimetrie}
\end{figure}

Vaak wordt in combinatie met laser altimetrie en een (stochastisch) ondergrondmodel elke 100m een dwarsprofiel genomen. 
Overigens kunnen in plaats van laseraltimetrie gegevens ook tachymetrische of GPS inmetingen gebruikt worden. 
Daarnaast kunnen ook synthetische profielen ingelezen worden (bijvoorbeeld bij scenariostudies). 
De enige voorwaarde is dat ze moeten voldoen aan het hieronder beschreven formaat. 

De dwarsprofielgeometrie wordt binnen DAM beschreven door twee *.csv bestanden:
\begin{enumerate}[noitemsep, nolistsep]
	\item \nameref{sec:Hoogtegeometrie}
	\item \nameref{sec:KarakteristiekePunten}
\end{enumerate}

Deze namen zijn hard en mogen dus niet vrij gekozen worden.

NB: de dwarsprofielgeometrie staat los van cross sections. 
De cross sections is een shape bestand om per locatie aan te geven welke data uit lijnenshapes gehaald moet worden, 
zie \nameref{sec:DataExtractie}.

\subsection{Hoogtegeometrie (surface lines)}
\label{sec:Hoogtegeometrie}
Het \textit{surfacacelines.csv} bevat de volledige geometrie informatie, dus alle X, Y en Z coördinaten. 
Profielen kunnen worden gegenereerd uit bijvoorbeeld AHN-bestanden. 
Voor stabiliteitsberekeningen dient wel gelet te worden op het aantal geometriepunten. 
In pre-processen en visualisaties (bepaling grens/waterspanningen) worden berekeningen per profielpunt uitgevoerd, 
dus onnodig veel punten vertraagt het systeem. 
De naam surfacelines.csv is hard en mag niet aangepast worden.

\paragraph*{Voorwaarden}
De \textit{surfacelines.csv} zijn sequentiële bestanden. 
Hiermee wordt bedoeld dat de punten opeenvolgend langs een rechte op het profiel liggen. 
Met het inlezen van de punten wordt de afstand tussen het eerste punt van het profiel en het ingelezen punt steeds groter. 
Daarnaast mogen geen dubbele punten (coördinaten) voorkomen in het bestand. 
Bij een niet-sequentiële oppervlaktelijn zal DAM een foutmelding genereren.

Er mogen geen verticale lijnen voorkomen in de surfaceline. 
DAM rondt af op 3 decimalen. 
Punten kunnen dus in het bronbestand verschillend zijn, maar na afronding in DAM hetzelfde.

Om vergissingen in de oriëntatie van profielen te voorkomen worden de profielen altijd aangeleverd van de \underline{buitenkant, naar de binnenkant}. 
Dus van de zee/rivier/boezemzijde naar de landzijde. 
De punten in het profiellijnenbestand lopen dan ook van “buiten” naar “binnen”. 

De eerste kolom \textit{surfacacelines.csv} is de LOCATIONID, gevolgd door alle punten van het profiel achter elkaar; X1,Y1, Z1,…, Xn, Yn, Zn. 
Elke locatie staat op een nieuwe regel. 
De eerste regel in het bestand is de header regel. 
In de header regel dient “LOCATIONID” opgenomen te zijn. 
De naamgeving van de overige kolommen is vrij. 
In \autoref{tab:VoorbeeldSurfaceLinesCsv} is een voorbeeld weergegeven.

\begin{table}[H]
\begin{scriptsize}
\begin{tabular}{|l|l|l|l|l|l|l|l|l|l|} \hline
\textbf{LOCATIONID} & X1 & Y1 & Z1 & X2 & Y2 & Z2 & X3 & Y3 & Etc. \\ \hline
VDP4 & 82891.68 & 447137   & -1.3 & 82891.12 & 447137.7 & -2.2 & 2884.04  & 447146.8 & ... \\ \hline
VDP5 & 82816.16 & 447367.4 & -1.3 & 82815.42 & 447366.9 & -2.2 & 82812.22 & 447364.7 & ... \\ \hline
VDP6 & 82882.06 & 447278.1 & -1.3 & 82881.34 & 447277.6 & -2.2 & 82877.1  & 447274.5 & ... \\ \hline
\end{tabular}
\caption{Voorbeeld van surfacelines.csv}
\label{tab:VoorbeeldSurfaceLinesCsv}
\end{scriptsize}
\end{table}

\FingerPointing{Wanneer gebruik gemaakt wordt van bestaande \dgeostability sommen dan dient de surface-line uit de \dgeostability invoer gehaald te worden (valt buiten de scope van dit document). 
Echter, \dgeostability maakt gebruik van een 2 dimensionale schematisering; Lengte (X) en hoogte (Z). 
Om deze invoer toch te gebruiken in DAM kan voor Y de waarde 0 ingevoerd worden in de \textit{surfacelines.csv}. 
Echter, het is natuurlijk ook mogelijk om (buiten DAM) de 2D coördinaten door middel van een datumtransformatie om te zetten naar RD coördinaten 
en NAP hoogtes op basis van een bekend punt en de kaarthoek van de geometrie (cross-section).}

\subsection{Karakteristieke punten (characteristic points)}
\label{sec:KarakteristiekePunten}

Op basis van de profiellijnen worden de karakteristieke punten gedefinieerd. 
Denk hierbij aan de ligging van de kruinlijnen, teenlijnen, berm, sloot etc. (zie \autoref{fig:KarakteristiekePunten}). 
De karakteristieke punten zijn feitelijk kenmerkende punten op het profiel. 
Deze punten worden gebruikt voor het sturen van de algoritmes in DAM. 
Het definiëren van de punten dient dan ook zorgvuldig te gebeuren.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Projectdata/KarakteristiekePunten.png}
	\caption{Karakteristieke punten weergegeven in het dwarsprofiel}
	\label{fig:KarakteristiekePunten}
\end{figure}

Het \textit{characteristicpoints.csv} kan op diverse wijzen gegenereerd worden. \\ 
Een mogelijkheid is om de tool \href{https://www.twisq.nl/site/dijkbeoordeling/}{Kliktool/qDAMEdit} te gebruiken.
Let op: hier wordt nog LOCATIONID gebruikt. 
Dit wordt nog wel ondersteund door DAM maar kan verwarrend zijn met Location\_id uit de \textit{locations.csv}. 
Dit kunnen dus twee verschillende parameters zijn. \\
Een andere mogelijkheid is om de tool DAM Edit Design te gebruiken (zie \autoref{fig:ScreendumpDAMEditDesign}). \\
Voor diverse tools, mogelijke werkwijzen en ervaringsgegevens wordt verwezen naar de \href{https://publicwiki.deltares.nl/display/DAM/Tools+en+hulpmiddelen}{DAM website (Tools en hulpmiddelen)}.

Niet alle karakteristieke punten komen voor in elk profiel, zo kunnen sloten en/of bermen ontbreken, 
daarom zijn daaraan gerelateerde punten niet verplicht.
Deze, niet-aanwezige, karakteristieke punten worden wel vermeld in het bestand (\textit{characteristicpoints.csv}), 
waarbij de X, Y, Z-coördinaat voor alle drie -1 is. 
DAM interpreteert deze punten dan als niet aanwezig.

Nadat er een DAM-project is aangemaakt en de karakteristieke punten zijn ingelezen, 
kan de ligging van de karakteristieke punten nog aangepast worden.
Zie \autoref{fig:TabbladHoogtegeometrie2}.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.5\textwidth]{Pictures/UserInterface/EigenschappenVensterHoogtegeometrieTab2.png}
	\caption{Eigenschappenvenster - Tabblad Hoogtegeometrie}
	\label{fig:TabbladHoogtegeometrie2}
\end{figure}

Verschuiven is mogelijk door bij een punt 'Geen' aan te passen naar een punt, mits aan de voorwaarden voldaan blijft worden. 
DAM controleert op de geldigheid van de invoergegevens en geeft een foutmelding als niet aan de voorwaarden wordt voldaan.

\textbf{Voorwaarden:}
\begin{itemize}

	\item De naam ``characteristicpoints.csv'' mag niet aangepast worden. 

	\item Verplichte karakteristieke punten moeten aanwezig zijn. 
	Dit zijn: Maaiveld buiten- en binnenwaarts, Teen dijk buiten- en binnenwaarts, Kruin buitentalud en Kruin binnentalud.
	In \autoref{app:CharacteristicPoints} zijn de kolomnamen (karakteristieke punten) opgenomen welke aanwezig moeten zijn in de \textit{characteristicpoints.csv}. 
	Daarnaast is aangegeven welke punten verplicht zijn en welke niet.
	
	\item Karakteristieke punten (m.u.v. verkeersbelasting) mogen niet samenvallen. 
	Daarnaast mag de teen nooit hoger liggen dan de kruinlijn.
	
	\item Verkeersbelastingspunten mogen in de \textit{characteristicpoints.csv} wel samenvallen met andere karakteristieke punten; 
	het punt op de maaiveldlijn komt dan twee keer voor in de tabel, zie \autoref{fig:TabbladHoogtegeometrie2}. 
	Bij het verschuiven is het echter niet mogelijk om een verkeersbelastingspunt samen te laten vallen met een ander karakteristiek punt 
	omdat elk punt op de maaiveldlijn maar 1 keer in de tabel voorkomt. \\
	Tip: zorg voor voldoende punten op de hoogtegeometrie (\textit{surfacelines.csv}) om het verschuiven van de verkeersbelasting 
	naar elke gewenst punt mogelijk te maken.
	
	\item De karakteristieke punten dienen op volgorde te liggen, zie \autoref{fig:KarakteristiekePunten}, m.u.v. de verkeersbelasting.
	
	\item Sets van karakteristieke punten dienen compleet te zijn. 
	Sets zijn: bermen, sloot en verkeersbelasting. 
	Deze punten zijn niet verplicht, maar wanneer 1 van de punten aanwezig is, dienen ook de overige punten van de set aanwezig te zijn. 
	Bijvoorbeeld: insteek binnenberm wordt opgegeven, dan dient ook de kruin binnenberm aanwezig te zijn.
	
	\item De X-, Y- en Z-waarden van de karakteristiekenpunten dienen in \textit{characteristicpoints.csv} achter elkaar 
	en op dezelfde regel te worden geplaatst. 
	Per regel één dwarsprofiel (Profielnaam, oud: LOCATIONID).
	Daarnaast dienen de karakteristieke punten ook voor te komen in de \textit{surfacelines.csv}. 
	Met andere woorden de X, Y, Z-coördinaat van een karakteristiekpunt dient \underline{exact} hetzelfde voor te komen 
	in de \textit{surfacelines.csv}. 
	Let hierbij op de afronding van de getallen.
	
	\item De gebruikte LOCATIONID’s (profielnamen) dienen gelijk te zijn aan de LOCATIONID’s in de \textit{surfaceline.csv}, 
	maar ook aan de LOCATIONID’s in de \textit{locatie.shp} en \textit{cross-section.shp} (zie \autoref{fig:DAMLocatieBestanden}).
	DAM koppelt namelijk de gegevens in deze bestanden met elkaar op basis van de LOCATIONID. 
	Dit is schematisch weergegeven in \autoref{fig:DAMLocatieBestanden}.
	
\end{itemize}

\begin{figure}[H]
	\centering
		\includegraphics[width=0.7\textwidth]{Pictures/Projectdata/DAMLocatieBestanden.png}
	\caption{Om een DAM locatie aan te maken worden de gegevens uit verschillende bestanden aan elkaar gekoppeld op basis van de LOCATIONID}
	\label{fig:DAMLocatieBestanden}
\end{figure}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Projectdata/ScreendumpDAMEditDesign.png}
	\caption{Screendump van de tool DAM Edit Design}
	\label{fig:ScreendumpDAMEditDesign}
\end{figure}

\section{Ondergrondmodel}
\label{sec:Ondergrondmodel}
\subsection{Inleiding ondergrondmodel}
\label{sec:InleidingOndergrondmodel}
Een schematisering van de ondergrond voor het beoordelen van de sterkte of faalkans van een waterkering dient voor geotechnische beschouwingen (berekeningen) in kwantitatieve termen vast te leggen. 
De ruimtelijke variatie in soortelijk gewicht, doorlatendheid, sterkte-eigenschappen en eventueel stijfheid in de ondergrond, moet representatief geschematiseerd worden. 
Een dergelijke schematisering wordt vaak in termen van de verticale laagopbouw gegeven, 
waarbij het accent vaak op het voorkomen van mogelijk ongunstige omstandigheden wordt gelegd.

In hoeverre individuele grondeenheden onderscheiden moeten worden hangt af van de betrokken soorten grond en van de vereiste en mogelijke nauwkeurigheid 
en de mate van zekerheid over de resultaten. 
De mogelijke en vereiste nauwkeurigheid en zekerheid hangt mede af van de berekeningsmethode en het doel van de beschouwing: 
bijvoorbeeld een algemene beoordeling van de sterkte of faalkans van een waterkering (globale toetsing) of bijvoorbeeld het versterken van een kering (ontwerp). 
De schematisering van de gehele grondopbouw in grondeenheden met bijbehorende grondeigenschappen 
en (eventuele) kansen van voorkomen moet vanuit het perspectief van de toepassing de werkelijke grondopbouw omvatten.

DAM gaat uit van een gebiedsindeling waarbij het beschouwde gebied in segmenten (dijkstrekkingen) wordt opgedeeld (zie \autoref{fig:VoorbeeldGebiedsindeling}).
Deze indeling is afhankelijk van de ondergrondschematisering. 
Elk segment bestaat uit een aantal (n) eendimensionale (1D) of tweedimensionale (2D) grondopbouw profielen (zie \autoref{fig:RelatieSegment1DProfielen}). 
Van elk 1D/2D profiel wordt aangegeven met welke kans de relevante typen ondergrond aanwezig zijn op een willekeurige locatie in het segment. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.7\textwidth]{Pictures/Projectdata/VoorbeeldGebiedsindeling.png}
	\caption{Voorbeeld gebiedsindeling op basis van ondergrond segmenten}
	\label{fig:VoorbeeldGebiedsindeling}
\end{figure}

\begin{figure}[H]
	\centering
		\includegraphics[width=0.7\textwidth]{Pictures/Projectdata/RelatieSegment1DProfielen.png}
	\caption{Relatie segment en 1D profielen grondopbouw. In bovenstaande figuur kan waar 1D staat ook 2D gelezen worden.}
	\label{fig:RelatieSegment1DProfielen}
\end{figure}

Voor de toetsing van regionale keringen met behulp van DAM is in de meeste gevallen een stochastisch ondergrondmodel opgesteld. 
Bij deze schematiseringmethode wordt onderscheid gemaakt tussen enerzijds weten welke grondlagen in de ondergrond aanwezig zijn of kunnen zijn in een bepaald gebied 
en weten waar die grondlagen dan eventueel zitten of kunnen zitten in dat gebied. 
Bij het schematiseren wordt voor beide gebruik gemaakt van inzicht in de opbouw van een gebied en van grondgegevens van een locatie en de directe omgeving ervan (sonderingen en boringen).

De typen ondergrond die in de methode benoemd worden, bestaan elk uit een stapel van grondeenheden, meestal komen deze overeen met de grondlagen. 
Afhankelijk van de vraagstelling wordt een grondeenheid relevant geacht en opgenomen in de stapel. 
Elke grondeenheid onderscheidt zich van de onderliggende of bovenliggende eenheid door de grondeigenschappen (sterkte, doorlatendheid, etc.). 
Verder worden alle grondeenheden horizontaal geschematiseerd, ook al zullen er in werkelijkheid soms grondlagen zijn die uitwiggen of scheefgesteld zijn. 
Elke grondeenheid in de stapel heeft een bepaalde kans van voorkomen op een locatie. 
Omdat grondeenheid dus mogelijk wel of niet aanwezig zijn op een bepaalde locatie, zijn er meerdere soorten stapels mogelijk voor de locatie. 
Op elke locatie kunnen dus meerdere soorten stapels, typen ondergrond, voorkomen, met een bepaalde kans die volgt uit de kansen van voorkomen van de verschillende grondeenheden in de stapels. 
De kans op het type ondergrond wordt berekend uit de combinatie van de kansen van voorkomen van de eenheden in elk van de mogelijke stapels. 
De methode maakt gebruik van de omstandigheid dat er voldoende bekend is over de opbouw van een gebied om een gefundeerde uitspraak te doen 
over de kans dat bepaalde grondeenheden in een bepaalde strekking van de waterkering voorkomen.

Indien na het gereedkomen van een eerste schematisering voor een locatie grondonderzoek wordt uitgevoerd waarmee meer definitief wordt vastgesteld welke opbouw daar voorkomt, 
kunnen de kansen voor de omgeving van die, dan bekende, locatie worden aangepast en wordt de schematisering nauwkeuriger. 
Door middel van gericht grondonderzoek in strekkingen die meer zekerheid vergen, 
kunnen de in een eerder stadium vastgestelde kansen van voorkomen dan nader gespecificeerd worden evenals de detaillering van de opbouw.

Het op bovengenoemde wijze opgebouwde ondergrondmodel, waarin aan verschillende soorten grondopbouw kansen worden toegedicht, wordt een stochastisch ondergrondmodel genoemd.

\FingerPointing{Bij een volledige deterministische benadering bestaat een segment uit één 1D of 2D grondopbouw met een kans van voorkomen van 100\%. 
In deze situatie zal meestal één segment het gebied bestrijken van één dwarsprofiel.}

Het ondergrondmodel binnen DAM bestaat uit een aantal verschillende componenten (zie \autoref{fig:OndergrondmodelDAM}):
\begin{enumerate}[noitemsep, nolistsep]
	\item \nameref{sec:Ondergrondsegmenten}
	\item \nameref{sec:Ondergrondopbouw}, 1D of 2D
	\item \nameref{sec:LocatieOndergrondsegmenten}
	\item \nameref{sec:Grondeigenschappen}
\end{enumerate}

\begin{figure}[H]
	\centering
		\includegraphics[width=0.7\textwidth]{Pictures/Projectdata/OndergrondmodelDAM.png}
	\caption{Samenhang tussen de verschillende elementen welke een ondergrondmodel vormen in DAM}
	\label{fig:OndergrondmodelDAM}
\end{figure} 

\subsection{Ondergrondsegmenten}
\label{sec:Ondergrondsegmenten}
Het bestand \textit{segments.csv} bevat per ondergrondsegment een kansverdeling op een bepaalde ondergrondprofiel, relevant voor piping of voor stabiliteit. 
Dit bestand koppelt dus de segmenten aan de ondergrondprofielen, inclusief kans van voorkomen. 
In \autoref{tab:VoorbeeldSegmentsCsvBestand} is een voorbeeld opgenomen van \textit{segments.csv}. 
Het bestand \textit{segments.csv} dient altijd aanwezig te zijn als gegevens in DAM geïmporteerd worden.

\begin{table}[H]
\begin{tabular}{|p{25mm}|p{30mm}|p{25mm}|p{\textwidth-48pt-80mm}|} \hline
\textbf{segment\_id} & \textbf{soilprofile\_id} & \textbf{probability} & \textbf{calculation\_type} \\ \hline
1 & Ondergrond\_1 & 15 & Stability \\ \hline
1 & Ondergrond\_1 & 15 & Piping \\ \hline
1 & Ondergrond\_2 & 85 & Stability \\ \hline
1 & Ondergrond\_2 & 85 & Piping \\ \hline
2 & Ondergrond\_3 & 30 & Stability \\ \hline
2 & Ondergrond\_3 & 30 & Piping \\ \hline
2 & Ondergrond\_4 & 70 & Stability \\ \hline
2 & Ondergrond\_4 & 70 & Piping \\ \hline
3 & ...etc... & ...  & ... \\ \hline
\end{tabular}
\caption{Voorbeeld segments.csv bestand}
\label{tab:VoorbeeldSegmentsCsvBestand}
\end{table}

\textit{Segment\_id} is de nummering van de segmenten. 
Deze dient overeen te komen met de naamgeving in de \textit{LocationSegment.shp} (zie \autoref{sec:LocatieOndergrondsegmenten}) en uniek te zijn. 
De \textit{Soilprofile\_id} is de naam van een specifieke ondergrondopbouw, oftewel het 1D ondergrondprofiel in het bestand \textit{soilprofiles.csv} en dient ook uniek te zijn (zie \autoref{sec:Ondergrondopbouw}).

In het geval gewerkt wordt met 2D geometrieën (alleen geldig voor stabiliteitsberekeningen) dan dient de kolom \textit{soilprofile\_id} vervangen te worden door de kolomnaam \textit{soilgeometry2D}.
In deze kolom worden dan de bestandsnamen van \dgeostability (*.sti) geometrieën opgenomen.

In de kolom \textit{probability} wordt de kans van voorkomen van het ondergrondschematisering opgenomen. 
De som van de kansen is per faalmechanisme, per segment altijd 100\%. 

In de kolom \textit{calculation\_type} wordt aangegeven of de desbetreffende ondergrondopbouw gebruikt moet worden voor het uitvoeren van een piping of een stabiliteit (stability) analyse.

\subsection{Ondergrondopbouw}
\label{sec:Ondergrondopbouw}
DAM kan gebruik maken van \nameref{sec:1DOndergrondschematiserings} of \nameref{sec:2DOndergrondschematiserings}. \\
Een 1D-ondergrondopbouw is een ondergrondopbouw in lagen. 
Deze worden opgegeven in meters ten opzichte van NAP. 
Er is geen koppeling met een geometrie: de lagen lopen oneindig door. 
De bovenkant wordt dus weergegeven door het aantal meters tov NAP en is dus een oneindig vlak. 
Pas wanneer de 1D-ondergrond wordt gecombineerd met een maaiveldlijn ontstaat er een ondergrondprofiel met begin en eind: een 2D-ondergrondopbouw. \\
Een 2D-ondergrondopbouw bestaat uit ondergrondlagen, 
al dan niet met schuine en/of verticale laagscheidingen en een bovenkant ondergrond, 
weergegeven door een lijn met variabele hoogte (veelal de maaiveldlijn).
Deze maaiveldlijn kan een ruimtelijke ligging hebben (geografisch georiënteerd door RD-coördinaten), 
maar deze wordt vertaald naar een lokaal assenstelsel.

Vooralsnog is het niet mogelijk om binnen één project 1D en 2D ondergrondschematiserings door elkaar te gebruiken voor het uitvoeren van stabiliteitsberekeningen.

\subsubsection{1D ondergrondschematiserings}
\label{sec:1DOndergrondschematiserings}
1D ondergrondschematiserings worden opgenomen in het bestand \textit{soilprofiles.csv}. 
Het bestand bestaat uit tenminste drie kolommen, waarbij de naam vastgelegd is in de header regel:
\begin{itemize}
	\item \textit{soilprofile\_id}: de unieke naam van het 1D ondergrondprofiel. 
	In het bestand segments.csv wordt gekoppeld op deze naam (zie \autoref{sec:Ondergrondsegmenten}).
	\item \textit{top\_level}: dit is de bovenkant van de grondlaag ten opzichte van het referentievlak (meestal NAP).
	\item \textit{soil\_name}: de naam van de grondsoort in desbetreffende laag. 
	Deze naam dient ook terug te komen in de grondeigenschappendatabase (zie \autoref{sec:Grondeigenschappen}).
\end{itemize}

In \autoref{app:VoorbeeldSoilprofilesCsv} is een beschrijving opgenomen van een \textit{soilprofiles.csv}.

DAM gaat er altijd vanuit dat de laatste laag in een 1D profiel een watervoerende laag is, bijvoorbeeld het pleistoceen. 
De schematisering moet dan ook doorlopen tot en met een watervoerende laag. 

In principe hoeft de onderkant van de laatste laag niet opgegeven te worden, DAM zal dan zelf een dikte aanhouden van 20m. 
Echter, bijvoorbeeld met het oog op het uitvoeren van pipingberekeningen, kan de onderkant wel opgegeven worden. 
Dit kan door in de laatste regel van het 1D profiel als \textit{soil\_name} “DummyForBottomLevel” op te nemen. 
De \textit{top\_level} wordt voor deze regel dan gezien als onderkant van de laag.

In \autoref{tab:VoorbeeldSoilProfilesCsvBestand} is een voorbeeld opgenomen van een een \textit{soilprofiles.csv}, 
met daar in opgenomen twee 1D ondergrondschematiserings. 
Bij het eerste 1D profiel (Profiel\_1) is de onderkant van de onderste watervoerende laag opgenomen (\textcolor[rgb]{0,0,1}{blauw gearceerd}). 
Bij het tweede 1D profiel (Profiel\_2) is dit achterwege gelaten. 
De dikte van het Pleistoceen zal hier 20 meter zijn.

Alle 1D ondergrondprofielen worden daaraanvolgend, onder elkaar, in het bestand gezet.

\begin{table}[H]
\begin{tabular}{|p{35mm}|p{35mm}|p{\textwidth-36pt-70mm}|} \hline
\textbf{soilprofile\_id} & \textbf{top\_level} & \textbf{soil\_name} \\ \hline
Profiel\_1 & 5 & Veen \\ \hline
Profiel\_1 & -2 & Klei1 \\ \hline
Profiel\_1 & -5 & Veen2 \\ \hline
Profiel\_1 & -5.5 & Klei1 \\ \hline
Profiel\_1 & -12 & Pleistoceen \\ \hline
\textcolor[rgb]{0,0,1}{Profiel\_1} & \textcolor[rgb]{0,0,1}{-18} & \textcolor[rgb]{0,0,1}{DummyForBottomLevel} \\ \hline
Profiel\_2 & 5 & Veen \\ \hline
Profiel\_2 & -2.5 & Klei2 \\ \hline
Profiel\_2 & -6 & Klei1 \\ \hline
Profiel\_2 & -11.3 & Pleistoceen \\ \hline
\end{tabular}
\caption{Voorbeeld van een soilprofiles.csv bestand}
\label{tab:VoorbeeldSoilProfilesCsvBestand}
\end{table}

\paragraph*{Verschuiven van de 1D-ondergrondlagen}
Het is mogelijk om de 1D ondergrondlagen op te geven ten opzichte van het maaiveld. 
Hiertoe wordt in het databronbestand (*.defx) een karakteristiek punt opgegeven ter referentie van de bovenkant van de 1D ondergrondprofielen.

In het databronbestand wordt de volgende regel toegevoegd boven de DataSourceList:\\
\begin{scriptsize}
\texttt{<DatasourceContainer Key="1" SoilProfileCharacteristicPointReference="SurfaceLevelInside" IsImportAsRelativeProfiles="True">}
\end{scriptsize}

Dit houdt in dat alle 1D-ondergrondprofielen ten opzichte van het karakteristiek punt Maaiveld binnenwaarts (SurfaceLevelInside) worden geschematiseerd. 
Boven dit niveau wordt het ondergrondprofiel opgevuld met het materiaal, opgeven als ophoogmateriaaldijk. 
In \autoref{fig:Samenstelling2DGeometrie} wordt maaiveld binnenwaarts als referentie gebruikt.\\
Boven wordt het Ophoogmateriaal Dijk gebruikt, onder de laagscheidingen conform soilprofiles.csv.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Projectdata/Samenstelling2DGeometrie.png}
	\caption{Verschuiving van 1D ondergrondprofiel}
	\label{fig:Samenstelling2DGeometrie}
\end{figure}

Let op: Deze functionaliteit is alleen getest met het maaiveld binnenwaarts als referentie 
en de soilprofiles.csv waarbij alle profielen een bovengrens van 0~m kennen. 
Afwijken van deze uitgangspunten kan mogelijk tot ongewenste geometrieën leiden en dienen goed gecontroleerd te worden.

\subsubsection{2D ondergrondschematiserings}
\label{sec:2DOndergrondschematiserings}
Alleen voor macrostabiliteit (Bishop/UpliftVan) kunnen 2D profielen gebruikt worden. 
2D ondergrondschematiserings dienen gemaakt te zijn met \dgeostability (of MStab). 
De bestandsnaam van de \dgeostability geometrie (*.sti) wordt opgegeven in de \textit{segments.csv}, 
in de kolom \textit{soilgeometry2D} (zie \autoref{sec:Ondergrondsegmenten}).
De hele invoer in de sti-bestanden moeten geldig zijn om deze binnen DAM te kunnen gebruiken 
(ofwel je moet er mee kunnen rekenen binnen \dgeostability zelf en geen foutmeldingen geven als je dat probeert te doen).

Binnen DAM wordt er vanuit gegaan dat de linkerkant van de ondergrondschematisering gelijk ligt met het eerste punt van de dwarsprofielgeometrie (zie \autoref{sec:Dwarsprofielgeometrie}). 

Als binnen DAM uiteindelijk de dwarsprofielgeometrie gecombineerd wordt met de 2D ondergrondschematisering, 
dan vallen alle grondlagen die boven de dwarsprofielgeometrie ligt weg. 
Als de dwarsprofielgeometrie hoger ligt dan de 2D ondergrondschematisering, 
dan worden de open ruimtes opgevuld met het opgegeven dijksmateriaal (zie \autoref{sec:Locatiegegevens}). 
Dit geldt overigens ook als gewerkt wordt met 1D ondergrondschematiserings.

De in de \dgeostability geometrieën gebruikte grondnamen dienen ook aanwezig te zijn in de grondeigenschappendatabase (zie \autoref{sec:Grondeigenschappen}). 
De namen dienen exact overeen te komen. 

Evenals de dwarsprofielgeometrieën (zie \autoref{sec:Dwarsprofielgeometrie}), dienen ook de ondergrondschematiserings lang genoeg te zijn. 
Als deze even lang zijn als de profiellijnen is er geen probleem. 
Als ze langer zijn, dan worden ze automatisch op de randen afgekapt. 
Als de profiellijnen te kort zijn, dan worden de lagen horizontaal verlengd tot de boundaries, opgelegd door de lengte van de dwarsprofielgeometrieën. 
Daarnaast moet de schematisering van de ondergrond ver genoeg doorlopen in de verticaal. 
Dus naar boven voor de dijkgeometrie en naar beneden om een (eventuele) diepe glijcirkel te kunnen vinden. 

\subsection{Locatie ondergrondsegmenten}
\label{sec:LocatieOndergrondsegmenten}
De ruimtelijke ligging van de segmenten wordt vastgelegd in de \textit{LocationSegments.csv}. 
Overigens is dit een vrij te kiezen naam. 
Net als alle shapes, geschikt voor DAM, kan dit een lijnen- of vlakkenbestand zijn. 
In veel gevallen wordt de dijklijn/referentielijn als basis gebruikt om de \textit{LocationSegments.csv} aan te maken. 
Deze lijn wordt dan opgeknipt overeenkomstig met de door de geoloog en/of geotechnisch ingenieur gedefinieerde ondergrond segmenten (zie \autoref{sec:InleidingOndergrondmodel} en \autoref{sec:Ondergrondsegmenten}). 
Vervolgens wordt per opgeknipt lijnstuk het \textit{segment\_id} ingevuld in de daartoe gedefinieerde attribuut (bijvoorbeeld SEGMENT). 
In \autoref{fig:VoorbeeldShapefileMetSegmenten} is een voorbeeld opgenomen. 
In dit voorbeeld is gekozen om de shape \textit{ondergrondsegmentlijnen.shp} te noemen. 
De \textit{segment\_id} is terug te vinden in de attribuut Lijnnummer (rood omkaderd). 
De waarde (\textit{segment\_id}) is voor dit betreffende lijnstuk 36.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.9\textwidth]{Pictures/Projectdata/VoorbeeldShapefileMetSegmenten.png}
	\caption{Voorbeeld shapefile met segmenten}
	\label{fig:VoorbeeldShapefileMetSegmenten}
\end{figure}

\subsection{Grondeigenschappen}
\label{sec:Grondeigenschappen}

\paragraph*{soils.csv}
De grondeigenschappen worden vastgelegd in \textit{soils.csv}. 
In de csv-file worden alle grondsoorten inclusief eigenschappen defineerd, welke benodigd zijn voor het uitvoeren van bishop/upliftvan en piping berekeningen. 

Hierdoor zijn sommige parameters verplicht en andere niet.
Voor niet verplichte parameters worden default waardes gehanteerd als er geen waarde opgegeven is in de invoer.
\Autoref{app:VoorbeeldSoilsCsv} geeft een overzicht van alle mogelijke gegevens, inclusief omschrijving.

De namen van grondsoorten dienen overeen te komen met de namen van de grondsoorten in de 1D en/of 2D geometrieën. 
DAM koppelt namelijk de grondeigenschappen op grondsoortnaam. 
De naam van de grondeigenschappen database is altijd \textit{soils.csv}. 

\paragraph*{Aquifer}
Voor de correcte werking van de schematisering algoritme in DAM is er de eigenschap 'Is Aquifer' nodig. 
Hoewel dit een laageigenschap is en geen materiaaleigenschap is deze toch opgenomen in de MSoilbase. 
Alle overige parameters zijn model specifiek en terug te vinden in de handleiding van D-Geo Stability.

Met 'Is aquifer' wordt aangegeven of het een watervoerende laag betreft. 
DAM zal hier een PL lijn aan toekennen.
Een aangevinkte ‘check box’ betekent dat het een watervoerende laag betreft.

Indien gebruik wordt gemaakt van reeds uitgevoerde D-Geostability berekeningen, 
is het raadzaam om in de *.sti bestanden de grondsoortnamen van watervoerende lagen uit te breiden met de toevoeging wl\_ (watervoerende laag),
zodat deze grondlaag in de database direct herkenbaar is en aangevinkt kan worden als aquifer (watervoerend).

\paragraph*{Schuifsterktemodel}
Per materiaal wordt het schuifsterktemodel opgegeven. 
Deze worden verder toegelicht in \nameref{sec:Schuifsterktemodellen}.

\paragraph*{D-Soil Model}
Indien gebruik wordt gemaakt van D-Soil Model dient men D-Soil Model versie XX (nog uit te brengen) te gebruiken.\\
Hier zijn in de materiaal tabel de volgende filters mogelijk:
\begin{itemize}[noitemsep, nolistsep]
	\item Alles
	\item Macrostabiliteit - WBI
	\item Macrostabiliteit - DGeostability2019
	\item Macrostabiliteit - DAM	
	\item Piping
	\item Piping - DAM
	\item Zettingsvloeiing
\end{itemize}

Voor het gebruik in DAM, dienen de parameters bij Macrostabiliteit - DAM en/of Piping - DAM ingevuld te zijn.

\subsection{Inlezen in D-Soil Model}
Het is mogelijk om de ondergrondbestanden,samen met de geometriegegevens 
(\textit{surfaceline.csv} en \textit{characteristicpoints.csv}) in te lezen in D-Soil Model en op te slaan.\\
Het *.soil bestand is vervolgens te importeren in DAM middels het volgende databronbestand:\\
Naast de ondergrond en geometriegegevens zijn nog wel de locatiegevens 
(hetzij in een csv bestand, hetzij in een combinatie csv-bestand en shapefiles) en scenario gegevens nodig.

\section{Locatiegegevens}
\label{sec:Locatiegegevens}
Naast de bovenbeschreven gegevens heeft DAM nog een aantal parameters nodig. 
Deze zijn afhankelijk van de toepassing. 
Daarnaast zijn sommige parameters verplicht en andere niet.
Voor niet verplichte parameters worden default waardes gehanteerd als er geen waarde opgegeven is in de invoer. 
Default waardes zijn binnen DAM eenvoudig te herkennen aan de licht geel gekleurde cellen in de diverse tabellen. \\
In \autoref{app:LocationParameters} is een beschrijving opgenomen van een \textit{locations.csv}.

\section{Waterstandgegevens}
\label{sec:Waterstandgegevens}
Afhankelijk van het gekozen berekeningstype verwacht DAM een bepaald bestand met waterstanden. 
De volgende berekeningstypen worden onderscheiden:
\begin{enumerate}[noitemsep, nolistsep]
	\item Calamiteiten
	\item Toetsing
	\item Ontwerp 
\end{enumerate}

\textbf{Ad 1 \quad Calamiteiten} \\
In de calamiteiten mode wordt gebruik gemaakt van een *.xml bestand. 
Dit bestand bestaat uit een LOCATIONID, een tijdstip en bijbehorende waterhoogte voor de desbetreffende locatie op het aangegeven tijdstip. 
De koppeling van de waterstandsverlopen gebeurd op basis van de LOCATIONID.

Voor een locatie ziet het *.xml bestand er als volgt uit:

\begin{scriptsize}
<series> \\
<header> \\
\quad <type>instantaneous</type> \\
\quad <locationid>\textcolor[rgb]{1,0,0}{Vul hier de LOCATIONID in}</locationid> \\
\quad <parameterid>Waterlevel</parameterid> \\
\quad <timeStep unit="hour" divider="1" multiplier="1" /> \\
\quad <startDate date="\textcolor[rgb]{1,0,0}{Vul hier de startdatum in}" time="\textcolor[rgb]{1,0,0}{Vul hier het starttijd in}" /> \\
\quad <endDate date=" \textcolor[rgb]{1,0,0}{Vul hier de einddatum in} " time=" \textcolor[rgb]{1,0,0}{Vul hier de eindtijd in} " /> \\
\quad <missVal>NaN</missVal> \\
\quad </header> \\
<event date=" \textcolor[rgb]{1,0,0}{Vul hier de datum in}" time=" \textcolor[rgb]{1,0,0}{Vul hier de tijd}" value="\textcolor[rgb]{1,0,0}{Vul hier de waterhoogte in}" flag="0" /> \\
event date=" \textcolor[rgb]{1,0,0}{Vul hier de datum in}" time=" \textcolor[rgb]{1,0,0}{Vul hier de tijd}" value="\textcolor[rgb]{1,0,0}{Vul hier de waterhoogte in}" flag="0" /> \\
event date=" \textcolor[rgb]{1,0,0}{Vul hier de datum in}" time=" \textcolor[rgb]{1,0,0}{Vul hier de tijd}" value="\textcolor[rgb]{1,0,0}{Vul hier de waterhoogte in}" flag="0" /> \\
<series> \\
</TimeSeries>
\end{scriptsize}


In \autoref{app:VoorbeeldCalamiteit} is een uitgewerkt voorbeeld opgenomen.

\textbf{Ad 2 \quad Toetsing} \\
De rekenoptie toetsing kan alleen geselecteerd worden voor regionale keringen. 
De toetsing voor primaire keringen valt onder het Wettelijk Toetsinstrumentarium (WTI). 

Voor de toetsingsmodule in DAM wordt gebruik gemaakt van de RRD-scenarioselectie. 
De waterstanden liggen hier vast en worden per locatie opgegeven en zijn bij voorkeur afkomstig uit shape bestanden.

\textbf{Ad 3 Ontwerp} \\
De rekenoptie ontwerp maakt gebruik van scenario’s welke opgegeven worden in de \textit{scenarios.csv} (deze naam is hard). 
In \autoref{app:VoorbeeldScenariosCsv} zijn alle gegevens en omschrijving van de gegevens van een \textit{scenarios.csv} bestand opgenomen.

\section{Rekenscenario's}
\label{sec:Rekenscenarios}
DAM kan, per locatie, meerdere rekenenscenario's doorrekenen, 
waarbij gevarieerd kan worden met de parameters uit \autoref{tab:OverzichtParamScenarios}. 
Deze parameter worden opgegeven in een \textit{scenarios.csv} bestand (deze naam is hard). \\
Er is minimaal 1 rekenscenario nodig. \\
Een groot aantal parameters heeft betrekking op de waternetcreator. \\
NB: Niet alle parameters zijn verplicht; dit staat in de derde kolom vermeld.

In \autoref{app:VoorbeeldScenariosCsv} is een uitgewerkt voorbeeld opgenomen.

\begin{footnotesize}
\begin{longtable}{|p{45mm}|p{10mm}|p{10mm}|p{12mm}|p{\textwidth-60pt-77mm}|}
\caption{Overzicht van de parameters van het \textit{scenarios.csv} bestand} \\ \hline
\label{tab:OverzichtParamScenarios}
\textbf{Kolomnaam} & \textbf{Type} & \textbf{Eenheid} & \textbf{Verplicht} & \textbf{Omschrijving} \\ \hline
\endfirsthead
\hline
\textbf{Kolomnaam} & \textbf{Type} & \textbf{Eenheid} & \textbf{Verplicht} & \textbf{Omschrijving} \\
\endhead
location\_id & StringId & - & ja & Referentie naar locatie (in locations.csv). NB Moet gelijk zijn! \\ \hline 
location\_scenario\_id & Integer & - & ja & Volgordenummer voor de scenarios \\ \hline 
water\_height & Float & m & ja & Buitenwaterstand \\ \hline 
water\_height\_low & Float & m & nee & Buitenwaterstand voor stabiliteit buitenwaarts, indien niet aanwezig wordt de water\_height gebruikt bij een berekening van Stabiliteit buitenwaarts \\ \hline 
polderlevel & Float & m & nee$^{\text{(1)}}$ & Stijghoogte freatische lijn in de polder. Indien sloot aanwezig: gelijk aan slootpeil. \\ \hline 
dike\_table\_height & Float & m & ja & Dijktafelhoogte; naar deze hoogte wordt het profiel aangepast. Indien geen aanpassing gewenst is, Z-waarde van buitenkruin nemen \\ \hline 
safety\_factor\_piping & Float & - & nee & Benodigde veiligheidsfactor piping; veiligheidsfactor waaraan getoetst wordt bij geometrie aanpassing \\ \hline 
safety\_factor\_stability\_inner\_slope & Float & - & nee & Benodigde veiligheidsfactor binnenwaartse stabiliteit; veiligheidsfactor waaraan getoetst wordt bij geometrie aanpassing \\ \hline 
safety\_factor\_stability\_outer\_slope & Float & - & nee & Benodigde veiligheidsfactor buitenwaartse stabiliteit; veiligheidsfactor waaraan getoetst wordt bij geometrie aanpassing \\ \hline 
uplift\_criterion\_piping & Float & - & nee & Opdrijfveiligheidsfactor voor piping \\ \hline 
uplift\_criterion\_stability & Float & - & nee & Opdrijfveiligheidsfactor voor stabiliteit \\ \hline 
PLLineOffsetBelowDikeTopAtRiver & Float & m & nee & Offset van PL1 onder buitenkruin t.o.v. buitenwaterstand \\ \hline 
PLLineOffsetBelowDikeTopAtPolder & Float & m & nee & Offset van PL1 onder binnenkruin t.o.v. buitenwaterstand \\ \hline 
PLLineOffsetBelowShoulderBase Inside & Float & m & nee & Offset van PL1 onder insteek binnenberm [m] t.o.v. maaiveld \\ \hline 
PLLineOffsetBelowDikeToeAtPolder & Float & m & nee & Offset van PL1 onder binnenteen t.o.v. maaiveld \\ \hline 
UsePLLineOffsetBelowDikeCrest Middle & Boolean & - & nee & Gebruik van offset van PL1 onder midden van kruin t.o.v. maaiveld \\ \hline 
PLLineOffsetBelowDikeCrestMiddle & Float & m & nee & Offset van PL1 onder midden van kruin t.o.v. maaiveld \\ \hline 
UsePLLineOffsetFactorBelow ShoulderCrest & Boolean & - & nee & Gebruik van offset van PL1 onder kruin binnenberm t.o.v. maaiveld \\ \hline 
PLLineOffsetFactorBelowShoulder Crest & Float & - & nee & Offset van PL1 onder kruin binnenberm t.o.v. maaiveld \\ \hline 
Head PL2 & Float & m & nee & Stijghoogte PL2 \\ \hline 
Head\_PL3 & Float & m & nee & Stijghoogte PL3 (NB: demping wordt in locations.csv opgegeven) \\ \hline 
Head\_PL4 & Float & m & nee & Stijghoogte PL4 (NB: demping wordt in locations.csv opgegeven) \\ \hline 
\multicolumn{5}{l}{$^{\text{(1)}}$ het polderlevel is WEL verplicht indien data voor DamLive wordt klaargezet!}
\end{longtable}
\end{footnotesize}

Let op: Er wordt bij macrostabiliteit één 'Benodigde veiligheidsfactor' opgegeven. 
Deze blijft gelijk, wanneer er gewisseld wordt tussen de rekenmodellen Bishop en UpliftVan.

\section{Comma separated files gebruiken}
\label{sec:CsvFilesGebruiken}
Indien geen shape bestanden beschikbaar zijn kan DAM ook gebruik maken van enkel *.csv bestanden. 
In een *.csv bestand zijn de gegevens al gekoppeld aan de LOCATIONID.

Alle parameters welke in shapes worden aangeleverd kunnen in *.csv worden opgenomen in \textit{locations.csv}. 
In \autoref{app:LocationParameters} zijn alle parameters weergegeven. 
Deze namen dienen gebruikt te worden als header in de *.csv file. 
Let op dat deze namen exact overeen moeten komen, tijdens het importeren van de gegevens wordt namelijk op de aanwezigheid van de kolommen gecontroleerd, 
hiervoor worden de kolomnamen in de header regel gebruikt. 
Daarnaast is in \autoref{app:LocationParameters} opgenomen of de kolom verplicht is of niet. 

Een project bestaande uit alleen *.csv bestanden bevat minimaal (afhankelijk van de toepassing) de volgende bestanden:
\begin{itemize}[noitemsep, nolistsep]
	\item locations.csv (zie \autoref{sec:Locatiegegevens})
	\item surfacelines.csv (zie \autoref{sec:Dwarsprofielgeometrie})
	\item characteristicpoints.csv (zie \autoref{sec:Dwarsprofielgeometrie})
	\item segments.csv (zie \autoref{sec:Ondergrondsegmenten})
	\item soilprofiles.csv of 2D geometrieën (zie \autoref{sec:Ondergrondopbouw})
	\item soils.csv (zie \autoref{sec:Grondeigenschappen})
\end{itemize}

Daarnaast dient voor de ontwerp mode het bestand \textit{scenarios.csv} (zie \autoref{sec:Rekenscenarios}) aanwezig te zijn.

Tot slot dienen alle bestanden in dezelfde map te staan.

\chapter{Configureren DAM}
In dit hoofdstuk wordt ingegaan op de wijze waarop DAM de invoer van de data georganiseerd heeft. 
DAM werkt aan de hand van projecten. 
Deze worden aangemaakt door basisdata in te lezen (zie \autoref{chp:Projectdata}).

De informatie over welke basisdata wordt ingelezen en waar deze basisdata vandaan komt, is vastgelegd in een \nameref{sec:DAMDatabronbestand}. 
Feitelijk is dit een kruisverwijzing tabel (mapping table). 
Een compleet voorbeeld van een  databronbestand (*.defx) is in \autoref{app:VoorbeeldDefx} opgenomen. 

Nadat DAM, aan de hand van het DAM databronbestand (*.defx), de basisdata heeft ingelezen, kan het project worden opgeslagen. 
Dit gebeurt in de vorm van een \nameref{sec:DAMProjectbestand}.
Het project kan op een later tijdstip of door een andere gebruiker worden geopend door het project bestand (*.damx) te openen. 
De originele \nameref{sec:Databronnen} of bronbestanden (shape bestanden en *.csv) dienen dan niet meegestuurd te worden. 
De ondergrond gegevens worden opgeslagen in de soildatabase (*.mdb), zie \nameref{sec:Grondeigenschappen}. 
Na het importeren wordt de projectnaam aan dit bestand gegeven. 
Bij het doorsturen naar iemand anders dient dit bestand ook meegestuurd te worden. 
Indien 2D geometrieën tot de bronbestanden horen, dient ook het mapje met de 2D (Projectnaam.geometries2D.0) meegestuurd te worden.

\section{DAM-databronbestand (*.defx)}
\label{sec:DAMDatabronbestand}
De DAM databronbestand (*.defx) is feitelijk een *.xml bestand en legt vast waar de bronbestanden staan en welke basisdata uit deze bronbestanden gehaald moet worden.
Het bestaat dan ook uit twee gedeeltes:
\begin{enumerate}[noitemsep, nolistsep]
	\item DataSourceList waarin de locaties van de \nameref{sec:Databronnen} gedefinieerd worden
	\item DataAttributes waarin per parameter (benodigd voor DAM) wordt aangeven in welke shape bestand en in welke attribuut kolom deze zich bevindt (\nameref{sec:VerwijzenNaarAttibuten}). 
\end{enumerate}

Overigens hoeven niet al deze elementen aanwezig te zijn. 
Als alleen gewerkt wordt met *.csv bestanden dan kan de achtergrondkaart en shape bestanden achterwege gelaten worden.

\subsection{Databronnen}
\label{sec:Databronnen}
DAM kent de volgende databronnen:
\begin{enumerate}[noitemsep, nolistsep]
	\item \nameref{sec:CommaSeparatedBestanden}
	\item \nameref{sec:Achtergrondkaart}
	\item \nameref{sec:ShapeBestanden}
\end{enumerate}

Overigens hoeven niet al deze elementen aanwezig te zijn. 
Als alleen gewerkt wordt met *.csv bestanden dan kan de achtergrondkaart en shape bestanden achterwege gelaten worden.

\FingerPointing{DAM maakt gebruik van een hiërarchische inleesstructuur. 
De *.csv bestanden hebben hierbij de laagste rangorde en de shape bestanden de hoogste. 
Het gevolg hiervan is dat wanneer, bijvoorbeeld, het polderpeil gegeven is in het *.csv bestand, 
maar ook in een shape bestand dan zal de waarde opgenomen in het *.csv bestand overruled worden bij de waarde in het shape bestand. 
Het voordeel hiervan is dat wanneer in eerste instantie alleen *.csv bestanden voorhanden zijn, per gegeven overgegaan kan worden naar shape bestanden.}

In de DataSourceList in het DAM databronbestand (*.defx) staat de locatie van deze bronbestanden aangegeven. 
Onderstaand wordt verder ingezoomd op het DAM databron bestand (*.defx), waarbij een voorbeeld mapstructuur gehanteerd wordt.

\subsubsection{Comma separated bestanden (*.csv)}
\label{sec:CommaSeparatedBestanden}
Tekst in databronbestand (*.defx): \\
\begin{scriptsize}
\texttt{DataSourceType="CsvFiles" DataLocation="csvfiles\" /}
\end{scriptsize}

Hierbij wordt aangegeven dat de csv-bestanden in een map genaamd ‘csvfiles’ bevinden en dat deze map zich op hetzelfde niveau bevindt als het DAM databronbestand (*.defx). \\
Zie ook \nameref{sec:CsvFilesGebruiken}.

\subsubsection{Achtergrondkaart}
\label{sec:Achtergrondkaart}
Tekst in databronbestand (*.defx): \\
\begin{scriptsize}
\texttt{DataSourceType="BackgroundShapeFiles" DataLocation="..$\backslash$shapefiles$\backslash$Top50.shp" /}
\end{scriptsize}

Hierbij wordt aangegeven dat de shape ‘Top50’ gebruikt moet worden als achtergrond en dat deze in een map genaamd ‘shapefiles’ zit en dat deze map zich een niveau hoger bevindt dan het DAM databronbestand (*.defx). Deze data source hoeft niet aanwezig te zijn.

\subsubsection{Shape bestanden}
\label{sec:ShapeBestanden}
Tekst in databronbestand (*.defx): \\
\begin{scriptsize}
\texttt{DataSourceType="DataShapeFiles" DataLocation="..$\backslash$shapefiles$\backslash$" /}
\end{scriptsize}

Hierbij wordt aangegeven dat de shape bestanden zich in de map, genaamd ‘shapefiles’, bevinden en dat deze shapefile-map in een niveau hoger zit dan het DAM databron bestand (*.defx).

Deze \textit{data source} hoeft niet aanwezig te zijn wanneer alleen csv-bestanden worden gebruikt. \\
Bij het gebruik van shape bestanden dient er een \textit{crosssections.shp} bestand aanwezig te zijn voor de \nameref{sec:DataExtractie}. \\
Dit geldt ook voor de X- en Y-coordinaten van de locations; 
deze dienen óf in de \textit{locations.csv} vermeld te zijn óf in een shape bestand.

\subsection{Verwijzen naar attributen}
\label{sec:VerwijzenNaarAttibuten}
Het DAM databronbestand omschrijft de naam van de parameters zoals in DAM wordt gebruikt, gekoppeld aan het bronbestand en het ‘attribuut’ in de shape-file. 
De naam van de parameter is vastgelegd en kan niet aangepast worden. 
Het bronbestand en de attributes zijn door de gebruiker zelf te definiëren.

Voorbeeld \\
\begin{scriptsize}
\texttt{Id="PolderLevel" DataSource="PolderLevel.shp" Name="PLHIGH" /}
\end{scriptsize}

Hiermee wordt aangegeven dat de invoerparameter ‘Polderlevel’ uit de shapefile ‘Polderlevel.shp’ gehaald dient te worden. Een shape file kan meerdere attributen bevatten, daarom is er nog een verwijzing naar het attribuut nodig: ‘PLHIGH’.

De naam (id) van de parameter ligt vast in DAM en kan niet aangepast worden (rood), bronbestand en attribute wel (groen): \\
\begin{scriptsize}
\texttt{Id="\textcolor[rgb]{1,0,0}{PolderLevel}" DataSource="\textcolor[rgb]{0,0.58,0}{PolderLevel.shp}" Name="\textcolor[rgb]{0,0.58,0}{PLHIGH}" /}
\end{scriptsize}

Een overzicht met alle parameter id's wordt weergegeven in \cite{DAMInputXlsx}.

\FingerPointing{Om snel te kunnen starten met DAM is een handige ingang om het databronbestand (*.defx) uit \autoref{app:VoorbeeldDefx} aan te passen 
zodat de naamgeving van de te gebruiken shape bestanden overeenkomen met de namen bij het waterschap; 
dat wil zeggen DataSource en Name moet overeenkomen met de namen van de shape bestanden.}

\section{DAM-projectbestand (*.damx)}
\label{sec:DAMProjectbestand}
Nadat DAM, aan de hand van het \nameref{sec:DAMDatabronbestand}, de basisdata heeft ingelezen, kan het project worden opgeslagen. 
Dit gebeurt in de vorm van een DAM projectbestand (*.damx). 
Het project kan op een later tijdstip of door een andere gebruiker worden geopend door het project bestand (*.damx) te openen. 
De originele \nameref{sec:Databronnen} of bronbestanden (shape bestanden en *.csv) dienen dan niet meegestuurd te worden. 
Na het importeren wordt de projectnaam aan dit bestand gegeven.
Bij het doorsturen naar iemand anders dient dit bestand ook meegestuurd te worden.
Indien 2D geometrieën tot de bronbestanden horen, dient ook het mapje met de 2D (Projectnaam.geometries2D.0) meegestuurd te worden.

Wanneer een DAM Project berekend is met een oudere versie dan waar het project wordt ingelezen, worden de berekeningen NIET getoond.
De reden hiervoor is dat in een nieuwe versie andere resultaten mogelijk zijn omdat er ook andere versies reken kernels worden gebruikt.

\chapter{Schematisering algoritmen DAM}
De tweede globale stap binnen het DAM concept is de schematisering van de modelinvoer, zoals weergegeven in \autoref{fig:Stap2DAMConcept}.
DAM maakt gebruik van verschillende schematiseringalgoritmen. 
Deze zijn opgenomen in verschillende modules welke los, of in combinatie met elkaar, gebruikt worden. 
Op hoofdlijnen betreft het de volgende modules: 
\begin{enumerate}[noitemsep, nolistsep]
	\item \nameref{sec:DAMWaternetCreator}	
	\item \nameref{sec:GeometrieAanpassen}
\end{enumerate}

\FingerPointing{Binnen diverse onderzoeksporen wordt gewerkt aan nieuwe modulen welke geschikt gemaakt worden voor toekomstige versies van DAM.}

\begin{figure}[H]
	\centering
		\includegraphics[width=0.6\textwidth]{Pictures/SchematiseringAlgoritmenDAM/Stap2DAMConcept.png}
	\caption{Stap 2 in het DAM concept is de schematisering van de modelinvoer}
	\label{fig:Stap2DAMConcept}
\end{figure}

\section{DAM Waternet Creator (Waterspanningen generatie)}
\label{sec:DAMWaternetCreator}
Voor de generatie van de waterspanningen maakt DAM gebruik van een aantal stappen.
\begin{enumerate}[noitemsep, nolistsep]
	\item Schematisering freatisch vlak (zie \autoref{sec:SchematiseringPL1}).
	\item Initiële schematisering stijghoogtes (zie \autoref{sec:SchematiseringPL234}).
	\item Controle op opdrijven (zie \autoref{sec:ControleOpOpdrijven}).
	\item Definitieve schematisering waterspanningen (zie \autoref{sec:DefinitieveSchematiseringStijghoogtes}).
\end{enumerate}

Dit is grafisch weergegeven in \autoref{fig:SchematiseringsstappenWaterspanningen}. 
De beschrijving van de verschillende piezometrische lijnen is samengevat in \autoref{tab:PiezoLijnen}.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringsstappenWaterspanningen.png}
	\caption{Schematisering weergave schematiseringsstappen waterspanningen DAM}
	\label{fig:SchematiseringsstappenWaterspanningen}
\end{figure}

\begin{table}[H]
\begin{tabular}{|p{15mm}|p{\textwidth-24pt-15mm}|} \hline
\textbf{Piëzolijn} & \textbf{Omschrijving} \\ \hline
PL1 & Freatische lijn. 
Voor stabiliteitsberekeningen met stationair freatisch vlak. 
De DAM schematisering van PL1 wordt beschreven in \autoref{sec:SchematiseringPL1}. \\ \hline

PL2 & De waterspanning aan de bovenkant van de indringingszone.
De PL2 wordt niet beïnvloedt door de stijghoogte in het onderliggende watervoerende pakket en is constant (geen demping) over de gehele breedte van het dwarsprofiel. 
De waarde van PL2 wordt door de gebruiker ingevoerd (attribuut: HeadPL2), evenals de dikte van de indringingslaag. 
DAM gebruikt alleen de PL2 als de laagdikte van de indringingslaag > 0 m.  \\ \hline

PL3 & Waterspanning in de onderste watervoerende laag. 
De waarde kan opgegeven worden (attribuut: HeadPL3). 
Als er geen waarde opgegeven is dan wordt PL3 gelijkgesteld aan de buitenwaterstand opgegeven in de scenario’s (zie \autoref{sec:Waterstandgegevens}). 
\newline
\newline
Ter plaatse van de binnenteen (zie \autoref{fig:DemingsfactorEnReductiePiezolijn}) hangt de waarde van PL3 af van de opgegeven dempingsfactor (attribuut: DampingPL3).
Deze dempingsfactor, waarbij 0 betekent geen demping (PL3 is constant). 
De waarde 1 suggereert  volledige demping tot PL2 (attribuut: PL2). 
Als PL2 niet opgegeven is, dan wordt voor PL2 de polderwaterstand gebruikt (attribuut: PolderLevel). 
Na de binnenteen reduceert de PL3 tot polderpeil onder een op te geven helling (attribuut: SlopeDampingPiezometricHeightPolderSide). 
Daarna loopt de PL3 gelijk met polderpeil. 
De helling van deze PL reductie kan worden opgegeven. 
De default waarde is 0. 
Dit betekent dat er geen reductie plaatsvindt. \\ \hline

PL4 & Waterspanning in een watervoerende tussenlaag (indien aanwezig). 
De schematisering van PL4 is analoog aan hetgeen beschreven onder PL3.
Echter met dien verstande dat overal waar PL3 staat dit vervangen moet worden door PL4. \newline
Note: Zowel PL3 en PL4 gebruiken dezelfde heling voor de reductie van de PL lijn aan de polderzijde. \\ \hline
\end{tabular}
\caption{Omschrijving verschillende piezometrische lijnen}
\label{tab:PiezoLijnen}
\end{table}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/DemingsfactorEnReductiePiezolijn.png}
	\caption{Gebruik van dempingsfactor (f) en reductie piëzolijn aan de polderzijde (X) voor schematisering horizontaal stijghoogte verloop}
	\label{fig:DemingsfactorEnReductiePiezolijn}
\end{figure}

\subsection{Schematisering freatisch vlak (PL1)}
\label{sec:SchematiseringPL1}
In DAM zijn momenteel twee verschillende methoden beschikbaar om de ligging van het freatisch vlak te schematiseren:  
\begin{enumerate}[noitemsep, nolistsep]
	\item ExpertKnowledgeRRD
	\item ExpertKnowledgeLinearInDike
\end{enumerate}

De schematisering wijze is door de gebruiker op te geven bij de kerngegevens (attribuut: PLLineCreationMethod) 
en is makkelijk binnen DAM te wijzigen om zo (bijvoorbeeld) het effect van de verschillende schematisering keuzes op de berekeningsresultaten te onderzoeken. 
De schematisering wijze, als wel de bijbehorende waardes, zijn op locatieniveau te definiëren.

Binnen DAM wordt het freatisch vlak aangeduid als Piëzo Line 1 (PL1).  

\textbf{Ad 1 \quad ExpertKnowledgeRRD} \\
Bij de expertKnoledgeRDD methode wordt de ligging van het freatisch vlak vastgelegd ter plaatse van (maximaal) 8 punten, A tot en met H. 
Deze locaties zijn weergegeven in \autoref{fig:SchematiseringFreatischVlak}. 
De hoogteligging van het freatisch vlak wordt gedefinieerd door het opgeven van een aantal verticale offsets ten opzichte van de buitenwaterstand of maaiveld ligging. 
Voor het punt onder de kruin van de binnenberm wordt een factor (F) van de hoogte van de berm ten opzichte van de binnenteen aangehouden. 
In \autoref{tab:PuntenFreatischVlak} is per punt weergegeven hoe deze bepaald/vastgelegd wordt. 
Tussen  de punten wordt de ligging van het freatisch vlak bepaald met behulp van lineaire interpolatie. 
Het gebruik van de punten C en F is optioneel; 
het gebruiken of niet gebruiken van deze punten kan worden in- en uitgeschakeld met de booleans “Gebruik PL1-kruin midden” en “Gebruik PL1-factor kruin binnenberm”.
In oude projecten staan deze opties standaard op False. 

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringFreatischVlak.png}
	\caption{Schematisering freatisch vlak binnenwaartse stabiliteit bij gebruik ExpertKnowledgeRRD}
	\label{fig:SchematiseringFreatischVlak}
\end{figure}

\begin{table}[H]
\begin{tabular}{|p{10mm}|p{\textwidth-24pt-10mm}|} \hline
\textbf{Punt} & \textbf{Hoogte ligging bepaald door} \\ \hline
A & Snijpunt buitenwaterstand met buitentalud (wordt automatisch bepaald) \\ \hline
B & Buitenwaterstand – opgegeven offset \\ \hline
C & Buitenwaterstand – opgegeven offset \\ \hline
D & Buitenwaterstand – opgegeven offset \\ \hline
E & Hoogteligging maaiveld ter plaatse van insteek binnenkruin – opgegeven offset \\ \hline
F & Hoogte binnenberm (= Hoogte kruin binnenberm – Hoogte binnenteen)  ten opzichte van binnenteen * opgegeven factor \\ \hline
G & Hoogteligging maaiveld ter plaatse van binnenteen – opgegeven offset \\ \hline
H & Snijpunt polderpeil met teensloot (wordt automatisch bepaald). \\ \hline
\end{tabular}
\caption{Parameters per schematisering-punt voor het vastleggen van het freatisch vlak binnen de schematisering optie ExpertKnwoledgeRRD}
\label{tab:PuntenFreatischVlak}
\end{table}

Verlagingen ten opzichte van het referentiepunt/vlak worden uitgedrukt met een positieve waarde. 
Voor het schematiseren van een opbolling dient de offset opgegeven te worden als een negatief getal. 

DAM controleert of het freatisch vlak niet uit het talud treedt. 
Als dit het geval is dan wordt de ligging automatisch aangepast, zodat het maaiveld gevolgd wordt met een verlaging van 1 cm. 

In het geval geen berm aanwezig is wordt punt E overgeslagen. 
In het geval er geen sloot aanwezig is wordt het maaiveld aan de binnenzijde (vanaf punt G) gevolgd met een verlaging van 1 cm. 
De aanname is hier dat onder maatgevende omstandigheden het achterland erg nat kan zijn en door deze schematisering dit meegenomen wordt. 
Bij erg lange profielen is het de vraag of dit waar is, 
echter zal de invloed van deze keuze niet/nauwelijks doorwerken in de juistheid van de stabiliteitsanalyse.
In ieder geval zal het niet leiden tot te optimistische resultaten. 

DAM controleert of de ligging van het freatisch als gevolg van de opgegeven offsets niet onder het opgegeven polderpeil komt te liggen ter plaatse van punt E, F en G.
Als dit wel het geval is zal DAM automatisch de ligging van het freatisch vlak gelijk maken aan het polderpeil. 
Daarnaast corrigeert DAM of het freatisch vlak ter plaatse van punt E, F en G niet hoger ligt dan de voorgaande punten (zie \autoref{fig:SchematiseringFreatischVlakMetCorrectie}).
Punt C en D mogen wel hoger liggen dan punt B. 

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringFreatischVlakMetCorrectie.png}
	\caption{Schematisering freatisch vlak binnenwaartse stabiliteit bij gebruik ExpertKnowledgeRRD}
	\label{fig:SchematiseringFreatischVlakMetCorrectie}
\end{figure}

De buitenwaterstand voor de bepaling van punt A, B en C komt uit de scenario’s (zie \autoref{sec:Waterstandgegevens} Ad 3). 
In het geval van de analyse voor binnenwaartse macrostabiliteit wordt de parameter \textit{Water\_height} (buitenwaterstand) gebruikt. 

Voor het berekenen van de buitenwaartse stabiliteitsanalyse wordt de hoogteligging van het freatisch vlak ter plaatse van punt B en C de \textit{water\_height} als referentievlak gebruik.
Voor de bepaling van punt A (en verdere schematisering) wordt de \textit{water\_height\_low} (beschouwde buitenwaterstand) gebruikt (zie \autoref{fig:SchematiseringFreatischVlakBuitenwaartse}).

Door deze aanpak is het mogelijk om een val van hoog water naar lager water te schematiseren. 
Als dit niet gewenst is kan de gebruiker de \textit{water\_height} gelijkstellen aan de \textit{water\_height\_low}. 
DAM gebruikt namelijk altijd de \textit{water\_heigth\_low} voor het bepalen van punt A bij het uitvoeren van een buitenwaartse stabiliteitsanalyse.
 
\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringFreatischVlakBuitenwaartse.png}
	\caption{Schematisering freatisch vlak buitenwaartse stabiliteit bij gebruik ExpertKnowledgeRRD}
	\label{fig:SchematiseringFreatischVlakBuitenwaartse}
\end{figure}

Mocht de opgegeven \textit{water\_height\_low} lager liggen dan het maaiveld aan de buitenzijde (‘links’ van de buitenteen), 
dan wordt de ligging van het freatischvlak gelijk gesteld aan de hoogte van het maaiveld. 
De gedachte hier achter is dat wanneer sprake is van een val van hoog naar laag water de grond nog verzadigd is.

\FingerPointing{Als gekozen wordt voor de analyse optie “Toetsing regionale keringen” dan wordt voor de buitenwaterstand geen gebruik gemaakt van waterstand scenario’s.}

\textbf{Ad 2 \quad ExpertKnowledgeLinearInDike} \\
Hier verloopt het freatisch vlak van het snijpunt van de beschouwde buitenwaterstand (Punt A in \autoref{fig:SchematiseringFreatischVlakBuitenwaartseExpertKnowledgeLineairInDike}) 
met het buitentalud lineair naar punt E en vervolgens naar punt F. 

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringFreatischVlakBuitenwaartseExpertKnowledgeLineairInDike.png}
	\caption{Schematisering freatisch vlak buitenwaartse stabiliteit bij gebruik ExpertKnowledgeLineairInDike}
	\label{fig:SchematiseringFreatischVlakBuitenwaartseExpertKnowledgeLineairInDike}
\end{figure}

\begin{table}[H]
\begin{tabular}{|p{10mm}|p{\textwidth-24pt-10mm}|} \hline
\textbf{Punt} & \textbf{Hoogte ligging bepaald door} \\ \hline
A & Snijpunt buitenwaterstand met buitentalud (wordt automatisch bepaald) \\ \hline
G & Hoogteligging maaiveld ter plaatse van binnenteen – opgegeven offset \\ \hline
H & Snijpunt polderpeil met teensloot (wordt automatisch bepaald). \\ \hline
\end{tabular}
\caption{Parameters per schematisering-punt voor het vastleggen van het freatisch vlak binnen de schematisering optie ExpertKnowledgeLinearInDike}
\end{table}

Evenals bij \textit{ExpertKnowledgeRRD} (zie Ad 1) wordt  voor de bepaling van punt A de waterstand gebruikt uit de opgegeven scenario’s (zie \autoref{sec:Waterstandgegevens}). 
In het geval van de analyse voor binnenwaartse macrostabiliteit wordt de parameter \textit{Water\_height} (buitenwaterstand) gebruikt. 
Voor het uitvoeren van buitenwaartse stabiliteitsberekeningen wordt voor het bepalen van punt A \textit{water\_height\_low} (beschouwde buitenwaterstand) gebruikt uit de gedefinieerde scenario(‘s).

DAM controleert of het freatisch vlak niet uit het (binnen)talud treedt. 
Als dit het geval is wordt het freatisch vlak ter plaatse verlaagd tot 1 cm onder het maaiveld.

In het geval er geen sloot aanwezig is dan bestaat punt F niet (zie \autoref{fig:SchematiseringFreatischVlakBuitenwaartseExpertKnowledgeLineairInDike}). 
DAM trekt dan het freatischvlak recht door, op de hoogte gelijk aan de hoogteligging van het freatisch vlak ter plaatse van de binnenteen. 
Dit geldt voor beide schematisering keuzes beschreven onder Ad1 en Ad2.

\subsection{Schematisering stijghoogtes (PL3, PL2, PL4)}
\label{sec:SchematiseringPL234}
DAM kan overweg met maximaal twee watervoerende lagen (aquifers, zie \autoref{sec:Grondeigenschappen}). 
Er is er altijd minimaal 1 nodig.
Voor (stabiliteits)berekeningen kunnen in DAM verschillende opties worden gekozen om het verloop van de stijghoogte in verticale richting te schematiseren.
\begin{enumerate}[noitemsep, nolistsep]
	\item DAM Standaard
	\item Lineair
	\item Hydrostatisch
	\item Volledig hydrostatisch
	\item Semi-tijdsafhankelijk
\end{enumerate}

\textbf{Ad 1 \quad Verloop waterspanning DAM Standaard} \\
Standaard schematiseert DAM de stijghoogten in verticale richting middels lineaire interpolatie in de slappe lagen. 
In het dijklichaam, de grondlagen waarin het freatisch vlak ligt en de watervoerende lagen wordt uitgegaan van een hydrostatisch verloop, zie \autoref{fig:SchematiseringWaterspanningenDAMStandaard}.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringWaterspanningenDAMStandaard.png}
	\caption{Schematisering van waterspanningen DAM Standaard}
	\label{fig:SchematiseringWaterspanningenDAMStandaard}
\end{figure}

\textbf{Ad 2 \quad Volledig lineair verloop watersspanningen}\\
Deze schematisatie wijze ligt het dichtst bij de huidige schematisering in DAM.
In deze variant zullen de waterspanningen in de lagen waar het freatisch vlak doorloopt niet meer hydrostatisch verlopen, maar lineair. 
In \dgeostability betekent dit dat de bovenkant van de laag waar het freatisch vlak doorloopt (PL)1 toegekend wordt en de onderkant 99. 
Voor de rest is de schematisatie gelijk aan de huidige aanpak in DAM. 
Dus de aquifers krijgen het juiste PL lijn nummer en alle andere lagen 99, \autoref{fig:SchematiseringWaterspanningenVolledigLineair}.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringWaterspanningenVolledigLineair.png}
	\caption{Schematisering van waterspanningen Volledig lineair}
	\label{fig:SchematiseringWaterspanningenVolledigLineair}
\end{figure}

\textbf{Ad 3 \quad Hydrostatisch verloop waterspanning} \\
In geval van één aquifer zullen de waterspanningen van het freatisch vlak (PL1) tot de stijghoogte (PL3) in de aquifer, hydrostatisch verlopen. 
In \dgeostability zullen dan alle lagen (PL) 1 toegekend krijgen, met uitzondering van de aquifer. 
Hier wordt (PL3) toegekend. 
In geval van twee, niet op elkaar liggende, aquifers zal het verloop van het freatisch vlak tot de eerste aquifer, hydrostatisch verlopen. 
Dus idem als het geval met één aquifer. 
Vervolgens zullen de waterspanningen tussen de verschillende aquifers lineair verlopen, 

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringWaterspanningenHydrostatisch.png}
	\caption{Schematisering van waterspanningen Hydrostatisch}
	\label{fig:SchematiseringWaterspanningenHydrostatisch}
\end{figure}

\textbf{Ad 4 \quad Volledig hydrostatisch} \\
Deze schematisering is identiek als Ad 3 Hydrostatisch, met het verschil dat de aquifer ook de stijghoogte van het freatisch vlak toegewezen krijgt (PL1).
Alle PL3 en PL4 toewijzingen vervallen hier. 
Opdrijven zal dan nooit voorkomen.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringWaterspanningenVolledigHydrostatisch.png}
	\caption{Schematisering van waterspanningen Volledig hydrostatisch}
	\label{fig:SchematiseringWaterspanningenVolledigHydrostatisch}
\end{figure}

\textbf{Ad 5 \quad Semi-tijdsafhankelijk} \\
Voor het waterspanningsverloop semi-tijdsafhankelijk moet een indringingslengte (penetratielengte) worden opgegeven. 
In de schematisering worden alle lagen waarvan de bovenkant van de laag binnen (of gelijk is aan) de indringingsafstand ligt (bovenkant (onderste) aquifer + indringingslengte uit DAM), 
aangemerkt als indringingslaag. 
Dit is grafisch weergegeven in \autoref{fig:DefinitieIndringingslaagDAM}. 
Wanneer een laag een variërende dikte heeft, zal de laag meegenomen worden als indringingslaag als op een of meerder locaties de bovenkant binnen de opgegeven indringingslengte valt.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.50\textwidth]{Pictures/SchematiseringAlgoritmenDAM/DefinitieIndringingslaagDAM.png}
	\caption{Definitie indringingslaag in DAM}
	\label{fig:DefinitieIndringingslaagDAM}
\end{figure}

Voor het waterspanningsverloop wordt de huidige schematisering van DAM aangehouden, 
maar over de indringslaag verloopt de stijghoogte van PL2 naar PL3 (lineair), \autoref{fig:SchematiseringWaterspanningenSemiTijdsafhankelijk}. 
Als er ook een tussenzandlaag is gedefinieerd, kan de situatie optreden dat er een indringingslengte wordt opgegeven, 
waarbij de tussenzandlaag als indringingslaag wordt gekenmerkt. 
Dit duidt op een slechte schematisering en in deze situatie zal de berekening met een foutmelding worden afgebroken.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematiseringWaterspanningenSemiTijdsafhankelijk.png}
	\caption{Schematisering van waterspanningen Semi-tijdsafhankelijk}
	\label{fig:SchematiseringWaterspanningenSemiTijdsafhankelijk}
\end{figure}

\textbf{\underline{Algemeen}} \\
DAM definieert de watervoerende lagen vanaf onder naar boven (richting maaiveld). 
Aan de onderste laag (altijd een watervoerende laag) wordt piëzolijn (PL) 3 toegekend. 
De waterspanningen in de indringingslaag worden geschematiseerd met behulp van PL2. 
In het geval een watervoerende tussenlaag aanwezig is, dan wordt hier PL4 aan toe gewezen. 

Als er meerdere watervoerende lagen aaneengesloten boven elkaar liggen (stapeling), 
dan zal DAM aan al deze lagen dezelfde PL toekennen, 
uitgaande van een hydrostatische verloop van de waterspanningen.
De scheiding tussen de watervoerende laag en cohesieve laag wordt dan bepaald door de bovenkant van de hoogst gelegen watervoerende laag in de stapeling.

\subsection{Controle op opdrijven}
\label{sec:ControleOpOpdrijven}
Vanaf de binnenteen tot midden slootbodem, wordt door DAM berekeningen gemaakt of er opdrijven optreedt. 
Hiervoor wordt de formule uit het VTV \citep{VTV2006} gebruikt en de initiële schematisering van de stijghoogten): 
\begin{align}
\textit{opdrukveiligheid} = \frac{\sigma_g}{\sigma_w}
\end{align}

Als er geen sloot aanwezig is, worden de berekeningen tot de grens van het dwarsprofiel uitgevoerd. 
Indien er opdrijven wordt berekend, reduceert DAM de PL3 of PL4 naar een waarde waarbij opdrijven net niet meer optreedt, 
oftewel labiel evenwicht (zie \autoref{fig:ReductieStijghoogteBijOpdrijven}). 

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/ReductieStijghoogteBijOpdrijven.png}
	\caption{Reductie stijghoogte bij opdrijven. DAM controleert van de binnenteen tot het midden van de sloot op opdrijven en past daarop de stijghoogte aan tot labiel evenwicht}
	\label{fig:ReductieStijghoogteBijOpdrijven}
\end{figure}

Indien er wel een sloot aanwezig is, wordt op opdrijven van PL3/PL4 gecontroleerd 
zoals beschreven in Bijlage 1 van het Technisch Rapport Waterspanningen bij dijken \citep{TAW2004} aangehouden met daarop 1 uitzondering dat de laatste bullet niet meegenomen is. 
De beslisboom in \autoref{fig:BeslisboomOpdrijven} zal doorlopen worden binnen de opdrijfberekening, om te bepalen of ook opdrijven bij de sloot wordt meegenomen. 
\Autoref{fig:OpdrijfberekeningSloot} verduidelijkt de beslisboom. 
De opdrijfberekening geldt zowel voor primaire, als wel, regionale keringen. 

\begin{figure}[H]
	\centering
		\includegraphics[width=0.9\textwidth]{Pictures/SchematiseringAlgoritmenDAM/BeslisboomOpdrijven.png}
	\caption{Beslisboom opdrijven}
	\label{fig:BeslisboomOpdrijven}
\end{figure}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/OpdrijfberekeningSloot.png}
	\caption{Opdrijfberekening ter plaatse van de sloot}
	\label{fig:OpdrijfberekeningSloot}
\end{figure}

Een opmerking dient gemaakt te worden ten aanzien van het geval dat er wel een opdrijfberekening uitgevoerd wordt ter plaatse van de sloot. 
Het kan dan namelijk zijn dat door het weggooien van de voorliggende punten feitelijk weer opdrijven kan ontstaan tussen de binnenteen en de sloot. 
Dit is weergegeven in \autoref{fig:OpdrijfberekeningSlootNa}. 
Om dit te corrigeren wordt een controlestap uitgevoerd, zoals weergegeven in het schema. 
Met de aangepaste PL lijn voor PL3/4 wordt de opdrijfberekening nog een keer uitgevoerd.

\begin{figure}[H]
	\centering
		\includegraphics[width=0.70\textwidth]{Pictures/SchematiseringAlgoritmenDAM/OpdrijfberekeningSlootNa.png}
	\caption{Opdrijfberekening ter plaatse van de sloot na opdrijfberekening in de sloot}
	\label{fig:OpdrijfberekeningSlootNa}
\end{figure}

\FingerPointing{Het mag duidelijk zijn dat de ligging van de karakteristieke punten van groot belang is voor het schematiseren. 
Het vastleggen van deze punten is dan ook een belangrijk onderdeel binnen het spoor “data op orde”.}

\subsection{Definitieve schematisering stijghoogtes}
\label{sec:DefinitieveSchematiseringStijghoogtes}
Op basis van de initiële generatie van de waterspanningen en controle op opdrijven wordt de definitieve schematisering van de waterspanningen aangemaakt.
Hierbij wordt in horizontale richting lineair geïnterpoleerd tussen de verschillende (berekende) knikpunten in de PL lijnen.

\section{Geometrie aanpassen}
\label{sec:GeometrieAanpassen}
Ten behoeve van beleidsstudies of het vaststellen van de invloedsgrenzen, of noodmaatregelen kan het handig zijn om een profiel te kunnen genereren die voldoet aan opgegeven veiligheidsfactor. 
Hiervoor is DAM in staat om automatisch profielaanpassing te doen, op basis van een aantal uitgangspunten.

De automatische profielaanpassing in DAM bestaat uit de volgende stappen:
\begin{enumerate}[noitemsep, nolistsep]
	\item \nameref{sec:Kruinverhoging}
	\item \nameref{sec:Taludverflauwing}
	\item \nameref{sec:Bermontwikkeling}
\end{enumerate}

Na de aanpassing van de kruinhoogte naar DTH (indien nodig), zal DAM eerst een stabiliteitssom uitvoeren. 
Indien de veiligheidsfactor niet voldoet aan de opgegeven norm, zal DAM de geometrie aanpassen tot deze wel voldoet. 
Hier zijn twee opties mogelijk:
\begin{enumerate}
	\item Optimaal taludverflauwing en bermaanleg \\
	Als blijkt dat het uittredepunt van de glijcirkel op het binnentalud ligt én de berekende veiligheidsfactor kleiner is dan de opgegeven veiligheidsfactors, 
	dan zal DAM (mits de optie profiel adaptie aanstaat) overgaan tot taludverflauwing totdat de berekende veiligheidsfactor $\geq$ benodigde veiligheidsfactor 
	en het uittredepunt van de glijcirkel op het binnentalud ligt (zie \autoref{fig:IteratieveTaludverflauwingBinnentalud}).
	Als het uittredepunt niet meer op het binnentalud ligt en de berekende veiligheidsfactor niet voldoet aan de gewenste veiligheidsfactor, 
	dan zal DAM overgaan tot het genereren van een stabiliteitsberm (zie \autoref{sec:Bermontwikkeling}).
	\item Eerst taludverflauwwing en daarna bermaanleg \\
	Indien (vanwege ontwerpredenen) het onwenselijk is om een berm aan te leggen, kan voor deze optie gekozen worden. 
	Dit betekent dat als de veiligheidsfactor kleiner is dan de opgegeven veiligheidsfactor, een geometrieaanpassing altijd gedaan wordt door het toepassen van taludverflauwing (\autoref{sec:Taludverflauwing}). 
	Pas nadat de “taludverflauwing eind cotangent” bereikt is en het profiel nog niet aan de gestelde veiligheidsfactor voldoet zal een berm worden ontworpen. 
\end{enumerate}

\subsection{Kruinverhoging}
\label{sec:Kruinverhoging}
Tijdens deze stap controleert DAM of de aanwezige kruinhoogte voldoet aan de benodigde (opgegeven) dijktafelhoogte (DTH, attribuut: DikeTableHeight). 

Indien de kruinhoogte (Z-waarde van karakteristiek punt ‘Buitenkruin’) gelijk of hoger is dan de opgeven DTH dan wordt het profiel niet aangepast. 
Indien het profiel lager is dan de opgegeven DTH dan past DAM de geometrie aan en creëert een nieuwe oppervlaktelijn (surface line). 
De nieuwe geometrie kan 
\begin{enumerate}[noitemsep, nolistsep]
	\item op basis van de oorspronkelijk taludhellingen ($\alpha$ en $\beta$) en de oorspronkelijke kruinbreedte (B) (zie \autoref{fig:AangepasteGeometrieDTH}) worden bepaald of
	\item op basis van vooraf opgegeven waarden.
\end{enumerate}

\textbf{Ad 1} \\
De taludhellingen, als wel de kruinbreedte, worden vastgesteld op basis van de karakteristieke punten:
\begin{itemize}
	\item De buitentaludhelling ($\alpha$) volgt uit de berekende helling op basis van de buitenteen en de buitenkruinlijn. 
	In geval een buitenberm aanwezig is wordt de buitentaludhelling bepaald op basis van de insteek van de buitenberm en de buitenkruinlijn. 
	\item De kruinbreedte (B) volgt uit de afstand tussen de karakteristieke punten buitenkruinlijn en binnekruinlijn.
	\item De binnentaludhelling ($\beta$) volgt uit de berekende helling op basis van de binnenteen en de binnenkruinlijn. 
	In geval een binnenberm aanwezig is wordt de binnentaludhelling bepaald op basis van de insteek van de binnenberm en de binnenkruinlijn.
\end{itemize}

\textbf{Ad 2} \\
Er kan door de gebruiker een nieuwe waarde voor profielaanpassingen gegeven worden door het bijbehorende vakje aan of uit te vinken. 
De parameters die handmatig gekozen worden staan onderstaand opgesomd. Indien een vakje uitgevinkt staat, wordt de standaardoptie conform Ad 1 gebruikt. 
\begin{itemize}[noitemsep, nolistsep]
	\item Kruinbreedte (UseNewDikeTopWidth, NewDikeTopWidth)
	\item Helling binnenzijde (UseNewDikeSlopeInside, NewDikeSlopeInside)
	\item Helling buitenzijde (UseNewDikeSlopeOutside, NewDikeSlopeOutside)
\end{itemize}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/AangepasteGeometrieDTH.png}
	\caption{Aangepaste geometrie voor DTH}
	\label{fig:AangepasteGeometrieDTH}
\end{figure}

De aangepaste geometrie heeft als startpunt de buitenteen van het initiële profiel (zie \autoref{fig:AangepasteGeometrieMetStartpuntAanpassingBuitenteen}). 
In het geval er geen binnenberm aanwezig is zal de binnenteen van het aangepaste profiel verder weg liggen langs het profiel dan de oorspronkelijke binnenteen (zie \autoref{fig:AangepasteGeometrieDTH}). 
Als de situatie zich voordoet dat de aangepaste geometrie snijdt met een aanwezig binnenberm, 
dan zal de insteek van de binnenberm opschuiven (zie \autoref{fig:AangepasteGeometrieMetStartpuntAanpassingBuitenteen}). 

Voor alle aangepaste profielen geldt dat de geometriepunten vallend binnen het aangepaste profiel verwijderd worden. 
De karakteristieke punten schuiven mee met de geometrie aanpassing.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/AangepasteGeometrieMetStartpuntAanpassingBuitenteen.png}
	\caption{Aangepaste geometrie met startpunt geometrie aanpassing in de buitenteen}
	\label{fig:AangepasteGeometrieMetStartpuntAanpassingBuitenteen}
\end{figure}

In het geval sprake is van een buitenberm zal de aangepaste geometrie starten vanuit de insteek van de buitenberm (zie \autoref{fig:AangepasteGeometrieMetStartpuntAanpassingBuitenberm}). 

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/AangepasteGeometrieMetStartpuntAanpassingBuitenberm.png}
	\caption{Aangepaste geometrie met startpunt geometrie aanpassing buitenberm}
	\label{fig:AangepasteGeometrieMetStartpuntAanpassingBuitenberm}
\end{figure}

Als door de geometrie aanpassing de nieuwe dijkbasis dusdanig breed wordt dat de gehele initiële geometrie binnen het aangepaste profiel valt, 
dan worden alle tussenliggende geometriepunten, inclusief de karakteristieke punten van de binnenberm, verwijderd (zie \autoref{fig:AangepasteGeometrieToegenomenDijkbasis}).
 
\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/AangepasteGeometrieMetStartpuntAanpassingBuitenteenEnToegenomenDijkbasis.png}
	\caption{Aangepaste geometrie met startpunt geometrie buitenteen en toegenomen dijkbasis}
	\label{fig:AangepasteGeometrieToegenomenDijkbasis}
\end{figure}

Als een sloot aanwezig is in het profiel zal DAM de sloot opschuiven 
in het geval de ligging van de aangepaste binnenteen verder ligt dan de ligging van de binnenteen in het initiële profiel
(zie \autoref{fig:AangepasteGeometrieToegenomenDijkbasis}). 
De sloot schuift langs het niet aangepast deel van het initiële profiel. 
Bij de verschuiving van de sloot houdt DAM de oorspronkelijke afstand van de binnenteen tot de insteek sloot ($\Delta$) gelijk. 
Daarbij houdt de sloot zijn oorspronkelijke afmetingen. 
Zie \autoref{fig:VerschuivingTeensloot}. 
Daarnaast kan de gebruiker nieuwe gewenste parameters voor de sloot opgeven:
\begin{itemize}[noitemsep, nolistsep]
	\item Toegestane afstand binnenteen-sloot
	\item Nieuwe definitie sloot:	
	\begin{itemize}
		\item Breedte slootbodem (UseNewMinDistanceDikeToeStartDitch, NewMinDistanceDikeToeStartDitch)
		\item Helling sloot (UseNewDitchDefinition, NewWidthDitchBottom)
		\item Diepte sloot (NewDepthDitch, NewSlopeAngleDitch)
	\end{itemize}
\end{itemize}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/VerschuivingTeensloot.png}
	\caption{Verschuiving teensloot}
	\label{fig:VerschuivingTeensloot}
\end{figure}

\subsection{Taludverflauwing}
\label{sec:Taludverflauwing}
De taludverflauwing wordt stapsgewijs uitgevoerd. De stappen zijn gedefinieerd ten opzichte van het snijpunt (S) van het aangepaste profiel met het initiële profiel. 
Feitelijk geeft de gebruiker op hoeveel dit snijpunt opschuift per rekenstap (attribuut: StabilitySlopeAdaptionDeltaX). 
De opgegeven waarde ($\Delta_s$) is de horizontale afstand (in meters) van het snijpunt (S) langs het profiel. 
Het maximaal aantal iteraties is begrensd op 200. 
Dit om te voorkomen dat DAM in een oneindige lus komt als de opgegeven veiligheidsfactor niet bereikt kan worden.

\FingerPointing{Des te kleiner $\Delta_s$ gedefinieerd is, des te meer de oplossing (geometrie aanpassing) in de buurt zal liggen van de opgegeven veiligheidsfactor. 
Echter, dit zal de rekentijd (afhankelijk van het aantal iteratieslagen) wel doen toenemen. 
Als default waarde wordt 1 m aangehouden.}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/IteratieveTaludverflauwingBinnentalud.png}
	\caption{Iteratieve taludverflauwing binnentalud op basis van uittredepunt glijcirkel}
	\label{fig:IteratieveTaludverflauwingBinnentalud}
\end{figure}

De gebruiker kan nieuwe gewenste parameters voor de taludontwikkeling opgeven:
\begin{itemize}[noitemsep, nolistsep]
	\item Taludverflauwing start cotangent 
	\item Taludverflauwing eind cotangent
	\item Taludvervlauwing stap cotantent
\end{itemize}

\subsection{Bermontwikkeling}
\label{sec:Bermontwikkeling}
DAM ontwikkelt iteratief een stabiliteitsberm zolang de opgegeven veiligheid nog niet bereikt wordt.
Het maximaal aantal iteratiestappen is 200. 
Deze limiet voorkomt dat DAM in een oneindige iteratielust terecht komt als het opgegeven veiligheidsniveau niet gehaald wordt.

Het gebruikte algoritme is gebaseerd op het verleggen van de kruin binnenberm over een rechte lijn met een hellingshoek ($\alpha$), 
zie \autoref{fig:IteratieveBermontwikkelingMacrostabiliteit}.
De standaardwaarde is 0,33 (1:3), maar is ook door de gebruiker op te geven (attribuut ‘StabilityShoulderGrowSlope’).

Het aanpassen gaat in stappen met een opgegeven horizontale stap grootte van verlegging van de binnenteen ($\Delta_s$). 
De stapgrootte staat standaard op 1 m, maar is aan te passen (attribuut ‘StabilityShoulderGrowDeltaX’). 
De bermontwikkeling stopt als de berekende veiligheidsfactor van het aangepaste profiel $\geq$ de opgegeven veiligheidsfactor.

Voor het startpunt van de bermontwikkeling wordt de binnenteen gebruikt. 
Als er in het oorspronkelijke dwarsprofiel al een berm aanwezig is, wordt het punt ‘Kruin binnenberm’ als oorsprong gebruikt. 
Tijdens de bermontwikkeling blijft de kruin van de berm horizontaal, vergelijkbaar met de kruinverhoging, zie \autoref{sec:Kruinverhoging}.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/IteratieveBermontwikkelingMacrostabiliteit.png}
	\caption{Iteratieve bermontwikkeling bij macrostabiliteit}
	\label{fig:IteratieveBermontwikkelingMacrostabiliteit}
\end{figure}

De bermtaludhelling ($\beta$) volgt uit de berekende helling op basis van de binnenteen en de binnenkruinlijn. 
In geval een binnenberm aanwezig is wordt de binnentaludhelling bepaald op basis van de insteek van de binnenberm en de binnenkruinlijn.

De hoogte van de berm is begrensd tot $\frac{2}{3}$kruinhoogte, dat wil zeggen het verschil in hoogte tussen binnenteen en kruin binnentalud. 
Wanneer deze bermhoogte is bereikt, wordt de berm uitsluitend in horizontale richting ontwikkeld polder.

In het geval een sloot aanwezig is wordt hier hetzelfde mee omgegaan als beschreven bij Taludverflauwing (zie \autoref{sec:Taludverflauwing}).

De iteratieve bermontwikkeling gaat door totdat het opgegeven veiligheidsniveau is bereikt. \\
De aangepaste geometrie bestaat uit rechte lijnen. 
Alle profielpunten liggende tussen de insteek binnenberm en binnenteen worden verwijderd. 

\Autoref{fig:VergelijkInitieelProfielGeometrieAdaptatie} toont een mogelijke geometrie aanpassing waarbij eerst een dijkverhoging uitgevoerd is, 
vervolgens een taludverflauwing en tot slot een bermontwikkeling. 
Al deze stappen worden door DAM automatisch doorlopen. 
In \autoref{fig:SchematischeWeergaveUiteindelijkeAangepasteProfiel} is het profiel geschematiseerd weergegeven waarbij alleen het aangepaste profiel weergegeven is. 
DAM heeft de optie om dit aangepaste profiel en karakteristieke punten te exporteren naar een CSV bestand.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/VergelijkInitieelProfielGeometrieAdaptatie.png}
	\caption{Vergelijk initieel profiel en geometrie adaptatie in DAM}
	\label{fig:VergelijkInitieelProfielGeometrieAdaptatie}
\end{figure}

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/SchematischeWeergaveUiteindelijkeAangepasteProfiel.png}
	\caption{Schematische weergave van het uiteindelijke aangepaste profiel  waarbij de initiële profiel punten verwijderd zijn}
	\label{fig:SchematischeWeergaveUiteindelijkeAangepasteProfiel}
\end{figure}

DAM biedt de mogelijkheid om in de ontwerpmodule het Bishop en/of UpliftVan model te gebruiken. 
In beide gevallen verloopt de geometrie adaptie idem. 

Daarnaast biedt DAM de mogelijkheid om de geometrie aan te passen aan het ontwerp. 
De gebruiker kan volgende gewenste parameters voor de berm(ontwikkeling) opgeven. 
Deze worden alleen gebruikt indien het vinkje van de desbetreffende eigenschap is aangevinkt. 
\begin{itemize}[noitemsep, nolistsep]
	\item Helling bovenkant berm (UseNewShoulderTopSlope,NewShoulderTopSlope)
	\item Helling berm (UseNewShoulderBaseSlope, NewShoulderBaseSlope)
	\item Maximaal toegestane hoogte berm (UseNewMaxHeightShoulderAsFraction, NewMaxHeightShoulderAsFraction)
\end{itemize}

Als gekozen wordt voor piping dan zal eerst, indien nodig, de dijk verhoogd worden (zie \autoref{sec:Kruinverhoging}). 
Vervolgens controleert DAM of opdrijven langs het profiel kan optreden. 
Hierbij wordt begonnen in de binnenteen, richting de polder. 
De maximale zoekruimte is beperkt tot de maximale pipinglengte bij een theoretische deklaagdikte van 0 meter 
en het bepaalde potentiaalverschil tussen de buitenwaterstand en de binnenwaartse ligging van het freatisch vlak (L$_{\text{max}}$).

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/SchematiseringAlgoritmenDAM/IteratieveBermontwikkelingPiping.png}
	\caption{Iteratieve bermontwikkeling bij piping}
	\label{fig:IteratieveBermontwikkelingPiping}
\end{figure}

Als de opdrijfveiligheid in het beschouwde punt kleiner, of gelijk is aan de opgegeven veiligheidsfactor voor opdrijven (default 1,2), 
dan wordt voor deze uittreedlocatie een pipingsom gemaakt. 
Als de veiligheidsfactor voor piping lager is dan de opgegeven veiligheidsfactor voor piping dan wordt een berm aangemaakt, 
waarvan de hoogte (H$_{\text{berm}}$) dusdanig is dat exact voldaan wordt aan de opgegeven opdrijfveiligheidsfactor. 
Vervolgens wordt het volgende punt beschouwd. 
Deze locatie wordt bepaald aan de hand van de opgegeven bermstapgrootte. 
Op de locatie van het beschouwde punt wordt wederom gecontroleerd op opdrijven en piping. 
Als ook hier piping kan optreden wordt weer de benodigde hoogte (H) van de pipingberm bepaald. 
Deze hoogte wordt vergeleken met de eerder bepaalde hoogte (H$_{\text{berm}}$) van de pipingberm. 
Als de berekende bermhoogte (H) lager of gelijk ligt dan H$_{\text{berm}}$, dan blijft H$_{\text{berm}}$ ongewijzigd. 
Als de berekende bermhoogte (H) hoger ligt dan H$_{\text{berm}}$, dan wordt H$_{\text{berm}}$ = H. 
Deze rekenslagen worden herhaald totdat het punt L$_{\text{max}}$ bereikt is. 
De pipingberm loopt door tot het laatste punt waar de veiligheid tegen piping niet voldoet. 
De bovenkant van de berm is altijd horizontaal en is gelijk aan H$_{\text{berm}}$.

\FingerPointing{De geometrie adaptie vindt binnen DAM plaats per geselecteerd rekenmodel. 
Dit zijn Bishop, UpliftVan en piping. De bepaalde geometrie geldt dus voor het geselecteerde model. 
Daarnaast biedt DAM de mogelijkheid om te kiezen voor de optie Bishop/UpliftVan. 
Als voor deze rekenoptie gekozen wordt zal DAM zowel voor Bishop als UpliftVan de berekeningen uitvoeren, 
met de toevoeging dat per gebruikt model de resultaten gepresenteerd worden ook de grootste geometrie (breedste dijkbasis, gedefinieerd als buitenteen tot binnenteen) van beide gepresenteerd wordt. 
Dit kan handig zijn bij verdere bewerkingsslagen.}
 
\chapter{Rekenen}
\label{chp:Rekenen}
DAM kent een voorbewerking, namelijk het genereren van de waterspanningen, zie \nameref{sec:DAMWaternetCreator}.

DAM kent meerdere (faalmechanisme) modellen:
\begin{itemize}[noitemsep, nolistsep]
	\item binnen- en buitenwaartse stabiliteit (zie \nameref{sec:MacrostabiliteitRekeninstellingen})
	\item piping (zie \nameref{sec:PipingRekeninstellingen})
\end{itemize}

En DAM maakt onderscheid in \nameref{sec:Berekeningstype}:
\begin{itemize}[noitemsep, nolistsep]
	\item \nameref{sec:Ontwerp}, zie ook \nameref{sec:GeometrieAanpassen}
	\item \nameref{sec:Calamiteit}
	\item \nameref{sec:DAMLiveConfiguratie}
\end{itemize}

\section{Berekeningstype}
\label{sec:Berekeningstype}

DAM kent drie berekeningstypen:
\begin{itemize}[noitemsep, nolistsep]
	\item \nameref{sec:Ontwerp}
	\item \nameref{sec:Calamiteit}
	\item \nameref{sec:DAMLiveConfiguratie}
\end{itemize}

\subsection{Ontwerp}
\label{sec:Ontwerp}
Bij het berekeningstype ontwerp zijn er twee analyes mogelijk:
\begin{itemize}
	\item Geen aanpassing \\
	Er wordt 1 berekening (per locatie, per ondergrondprofiel, per rekenscenario) uitgevoerd. 
	De uitkomst is een veiligheidsfactor in het tabblad tabellen-ontwerpberekeningen en een gekleurde locatie op de kaart:
	\begin{itemize}
		\item rood: voldoet niet aan opgegeven veiligheidsfactor
		\item groen: voldoet aan opgegeven veiligheidsfactor
		\item grijs: berekening heeft niet plaatsgevonden
	\end{itemize}
	\item Geometrieaanpassing \\
	Er worden meerdere rekenslagen (iteraties) gemaakt totdat het aangepaste profiel een veiligheidsfactor behaald gelijk of hoger dan de opgegeven benodigde veiligheidsfactor. 
	Zie \nameref{sec:GeometrieAanpassen}.
\end{itemize}

De globale rekeninstellingen kunnen worden ingesteld op projectniveau; 
oftewel het faalmechanisme (macrostabiliteit binnenwaarts/buitenwaarts en piping) en het te gebruiken model, bijvoorbeeld Bishop en/of UpliftVan.
Op te geven via menu-berekeningen-opties. \\
De instellingen verschillen per faalmechanisme: macrostabilteit en piping.

\subsection{Calamiteit}
\label{sec:Calamiteit}
\todo{Calamiteit under construction \\
\\
Commentaar Kin Sun: Hier was Bernard en John mee bezig. 
Niet helemaal duidelijk of deze optie het doet of niet. 
Daarnaast ook niet duidelijk wat het precies doet. 
Het lijkt erop dat het alleen een reeks (buiten)waterstanden kan doorrekenen. 
Dan kan nu met scenario's ook. 
Dus lijkt dan geen meerwaarde te hebben.\\
\\
In paragraaf 4.6 wordt ook naar calamiteit verwezen.
\\
Als optie het doet, dan kunnen we hier aangeven dat er een tijdreeks wordt doorgerekend.}

\subsection{DAMLive configuratie}
\label{sec:DAMLiveConfiguratie}
\todo{DAM live configuration under construction. \\
\\
Commentaar Kin Sun: Hier was Bernard en John mee bezig. 
Dit deel staat deels op wiki onder Gebruikshandleiding DAM-Live: \\
\url{https://publicwiki.deltares.nl/display/DAM/Gebruikershandleiding+DAMLive?src=contextnavpagetreemode}\\
\\
Maar ik zie dat dat ook niet helemaal volledig is.
Ik weet dus niet of het handig is om dit hier op te nemen. 
Misschien verwijzen naar wiki voor dit deel totdat het wel voldoende goed is.}

\section{Macrostabiliteit rekeninstellingen}
\label{sec:MacrostabiliteitRekeninstellingen}

\subsection{Macrostabiliteit rekeninstellingen op projectniveau}
In de mode calamiteiten en ontwerp kunnen globale rekeninstellingen worden ingesteld (op waterschapsniveau). 

\paragraph*{Glijvlakmodel}
DAM kan gebruik maken van de volgende rekenmodellen:
\begin{itemize}[noitemsep, nolistsep]
	\item Bishop
	\item Uplift Van
	\item Bishop/Uplift Van
\end{itemize}

\paragraph*{Gridinstellingen}
Er zijn verschillende opties mogelijk:
\begin{itemize}[noitemsep, nolistsep]
	\item Zoekmethode: rekengrid of BeeSwarm algorithme 
	(de laatste alleen voor binnenwaartse stabiliteit in combinatie met UpliftVan of Bishop/UpliftVan\footnote{Indien is gekozen voor Bishop/UpliftVan als Glijvlakmodel met zoekmethode BeeSwarm, 
	wordt de BeeSwarm methode alleen gehanteerd voor het UpliftVan deel. Het Bishop-deel gebruikt altijd het rekengrid.});
	\item Bepaling tangentlijnen (alleen voor Uplift Van): op laagscheidingen of naar opgave afstand; \\
	Bij 'opgave afstand' verdeelt DAM de tangentlijnen tussen onderkant passieve grid en 0.5 m onder laagscheiding aquifer.	
	\item Bepaling grid: automatisch of naar opgave afstand
	Indien gekozen voor ‘opgave afstand’, moet deze vervolgens worden.
\end{itemize}


\subsection{Macrostabiliteit rekeninstellingen op locatieniveau}
\begin{itemize}
	\item \textbf{Zoneringstype} \\
	DAM biedt de mogelijkheid om zonering toe te passen op de volgende manieren. 
	De optie is te kiezen in de locatietabel
	\begin{enumerate}
		\item \textbf{Geen zone} \\
		Bij deze optie wordt het glijvlak met de laagste veiligheidsfactor als uitkomt gegeven. 
		\item \textbf{Zone gebieden} \\
		Bij deze optie wordt de zonering uit \dgeostability gebruikt. 
		Er zijn meerdere zonegebieden, welke afhankelijk zijn van het minimaal benodigde restprofiel. 
		Het resultaat is het glijvlak met de laagste veiligheidsfactor in een bepaald zonegebied. 
		Glijcirkels die hierbuiten liggen worden genegeerd.
		\item \textbf{Verboden zone} \\
		Deze optie geeft de mogelijkheid om handmatig een bepaalde verboden zone op te geven voor het intredepunt van het glijvlak, zie \autoref{fig:VerbodenZoneFactor}. 
		Het gebied wordt opgegeven aan de hand van de grens die tussen de binnenkruin en de binnenteen (of insteek binnenberm, indien aanwezig) ligt. 
		De factor f geeft aan hoever deze grens ligt; f=0 voor op de binnenkruin f=1 voor op de binnenteen/insteek binnenberm. 
		Het intredepunt moet dus links van deze grens liggen.
	\end{enumerate}
	\item \textbf{Minimale glijcirkel diepte}
\end{itemize}

\begin{figure}[H]
	\centering
		\includegraphics[width=0.70\textwidth]{Pictures/Berekeningen/VerbodenZoneFactor.png}
	\caption{Verboden zone factor}
	\label{fig:VerbodenZoneFactor}
\end{figure}

\subsection{Schuifsterktemodellen (op materiaalniveau)}
\label{sec:Schuifsterktemodellen}
DAM kan met de volgende schuifsterktemodellen rekenen:
\begin{itemize}
	\item \textbf{C-Phi model} \\
	Opgeven in soils.csv:
	\begin{itemize}
		\item cohesie
		\item hoek van inwendige wrijving
	\end{itemize}
	\item \textbf{Su-berekend model} \\
	Opgeven in soils.csv:
	\begin{itemize}
		\item Schuifsterkte ratio
		\item Sterkte toename exponent m
		\item POP
	\end{itemize}
\end{itemize}

\section{Piping rekeninstellingen}
\label{sec:PipingRekeninstellingen}
Voor piping kan gekozen worden uit 2 opties:
\begin{enumerate}[noitemsep, nolistsep]
	\item \nameref{sec:Bligh}
	\item \nameref{sec:SellmeijerRevisedWBI}
\end{enumerate}

\subsection{Bligh}
\label{sec:Bligh}
DAM biedt de mogelijkheid om te rekenen met de standaard piping regel van Bligh:
\begin{equation}
L \geq H \; C_{\text{creep}}
\end{equation}
waarbij:
\begin{longtable}{p{10mm}p{\textwidth-24pt-10mm}}
$L$ & is de kwelweglengte (in DAM gedefinieerd als de afstand tussen Teen dijk buitenwaarts en Teen dijk binnenwaarts); \\
$H$ & is het toegestaan hoogteverschil; \\
$C_{\text{creep}}$ & is de creep factor: $C_{\text{creep}}$ = 18.
\end{longtable}

\subsection{Sellmeijer Revised (WBI)}
\label{sec:SellmeijerRevisedWBI}
Bij Sellmeijer revised (WBI) maakt DAM gebruik van de DAM-opdrijfberekening (zie \nameref{sec:ControleOpOpdrijven}) om de uittredelocatie te bepalen. 
Voor het bepalen van de waterspanningen wordt de \nameref{sec:DAMWaternetCreator} gebruikt.
Vervolgens wordt voor deze uittredelocatie een berekening gemaakt voor opbarsten, heave en voorschrijdende erosie (piping) op basis van de lagenopbouw ter plaatse.

\subsubsection{Opbarsten}
De veiligheidsfactor voor opbarsten wordt bepaald a.h.v.:
\begin{equation}
FoS_u = \frac{m_u \; \Delta \phi_{c,u}}{\phi_{\text{exit}} - h_{\text{exit}}}
\end{equation}
waarbij
\begin{equation*}
\Delta \phi_{c,u} = \frac{\sigma_{\text{eff}}}{\gamma_{\text{water}}}
\end{equation*}
\begin{longtable}{p{10mm}p{\textwidth-24pt-10mm}}
$m_u$ & modelfactor opbarsten (uplift) (=1) \\
$\sigma_{\text{eff}}$ & effectieve spanning onderkant deklaag (kN/m$^{\text{3}}$).
Hierbij wordt rekening gehouden met de effectieve deklaag in geval van een sloot \\
$\gamma_{\text{water}}$ & volumiek gewicht water (= 9.81 kN/m$^{\text{3}}$) \\
$\phi_{\text{exit}}$ & waterspanning bij uittredepunt \\
$h_{\text{exit}}$ & freatische waterstand bij uittredepunt \\
\end{longtable}

\subsubsection{Heave}
De veiligheidsfactor voor heave wordt bepaald a.h.v.:
\begin{equation}
FoS_h = \frac{i_{c,h}}{i}
\end{equation}
waarbij
\begin{longtable}{p{10mm}p{\textwidth-24pt-10mm}}
$i_{c,h}$ & kritieke heave gradient (=0.3) \\
$i$ & gradient uittredepunt, zie grenstoestandsfunctie \autoref{eq:grenstoestandsfunctie}.
\end{longtable}

\begin{equation}
\label{eq:grenstoestandsfunctie}
Z_h = i_{c,h} - i = i_{c,h} - \left(\phi_{\text{exit}} - h_{\text{exit}}\right) / D_{\text{deklaag}}
\end{equation}
waarin
\begin{longtable}{p{10mm}p{\textwidth-24pt-10mm}}
$D_{\text{deklaag}}$ & laagdikte van de deklaag [m] \\
$h_{\text{exit}}$ & freatische waterstand bij uittredepunt \\
\end{longtable}

\subsubsection{Terugschrijdende erosie}
De veiligheidsfactor voor terugschrijdende erosie wordt bepaald a.h.v.:
\begin{equation}
FoS_p = \frac{m_p \; H_c}{h - h_{\text{exit}} - r_c\; D_{\text{deklaag}}}
\end{equation}
waarbij
\begin{longtable}{p{10mm}p{\textwidth-24pt-10mm}}
$H_c$ & critical head (potential) difference over the structure between entry and exit point [m] \\
$m_p$ & modelfactor for the respective piping model ($m_p = 1$) \\
$h$ & outside water level [m] \\
$h_{\text{exit}}$ & freatische waterstand bij uittredepunt [m] \\
$r_c$ & readuction factor providing the fraction of the blanket thickness by which the total head difference is reduced due to hydraulic resistance in the vertical exit channels (defult value: 0.3) \\
$D_{\text{deklaag}}$ & laagdikte van de deklaag bij uittredepunt [m]\\
\end{longtable}
$H_c$ in bovenstaande formule komt overeen met onderstaande $\Delta H_c$ 
\begin{equation}
\frac{\Delta H_c}{L} = F_{\text{resistance}} \; F_{\text{scale}} \; F_{\text{geometry}}
\end{equation}
waarbij
\begin{align*}
&F_{\text{resistance}} = \eta \frac{\gamma_{\text{sub.particles}}}{\gamma_{\text{water}}} \tan \theta \\
&F_{\text{scale}} = \frac{d_{70.m}}{\sqrt[3]{\kappa L}} \left(\frac{d_{70}}{d_{70.m}}\right)^{0.4} , \quad \kappa = \frac{\nu_{\text{water}}}{g} k \\
&F_{\text{geometry}} = 0.91 \left(\frac{D}{L}\right)^{\frac{0.28}{\left(\frac{D}{L}\right)^{2.8} - 1} + 0.04}
\end{align*}
waarin
\begin{longtable}{p{15mm}p{\textwidth-24pt-15mm}}
$L$ & kwelweglengte van in- tot uittredepunt: $L = x_{\text{exit}} - x_{\text{entry}}$ [m] \\
$\gamma_{\text{sub.particles}}$ & volumegewicht van zandkorrels onder water (= 16.5) [kN/m$^{\text{3}}$] \\
$\eta$ & coefficient van White (sleepkrachtfactor) (= 0.25) [-] \\
$d_{70}$ & 70-percentielwaarde van de korrelverdeling van de piping-gevoelige laag [m] \\
$\kappa$ & intrinsieke doorlatenheid van de zandlaag [m$^{\text{2}}$] \\
$k$ & Darcy doorlatenheid [m/s] \\
$\nu$ & kinematische viscositeit van water (voor grondwater van 10$\degr$ Celsius: 1.33~$\cdot$~10$^{\text{-6}}$) [m$^{\text{2}}$/s] \\
$g$ & zwaartekrachteversnelling (= 9.81) [m/s$^{\text{2}}$] \\
$D$ & dikte van de zandlaag [m] \\
$d_{70.m}$ & referentie $d_{70}$-waarde (= 20.8 $\cdot$ 10$^{\text{-4}}$ [m] \\
$\theta$ & rolweerstandshoek van zandkorrels van de aangepaste Sellmeijer regel (= 37) [$\degr$] \\
\end{longtable}

Het intredepunt is standaard in DAM het karakteristiek punt 'Teen dijk buitenwaarts'. 
Dit kan per locatie aangepast worden door de afstand tot intredepunt (kolomnaam: distance\_to\_entry\_point)' op te geven in \textit{locations.csv}.

\subsubsection{Piping}
Om piping te bepalen, dienen bovenstaande drie deelmechanismen in deze volgorde uitgerekend te worden. 
Bij het falen van een van deze berekeningen, berekent DAM de volgende deelmechanismen ook niet.
Dus wanneer er geen opbarstberekening gemaakt kan worden, dan worden heave en terugschrijdende erosie ook niet berekend.
Wanneer alledrie deelmechanismen berekend zijn wordt de hoogste veiligheidsfactor getoond als Piping veiligheidsfactor, samen met het kritieke verval ($H_c$) van dit deelmechamisme. 
Niet te verwarren met de $H_c$'s van de andere deelmechanismen.

Alle  resultaten worden getoond in het Tabellenvenster/Ontwerpberekeningen, zie Resultaten.


%%%%%%%%%%%%%%%%%
\chapter{Uitvoer}
\section{Berekeningen inzien}
Nadat de berekening is uitgevoerd, zijn de resultaten middels meerdere vensters in te zien:
\begin{itemize}[noitemsep, nolistsep]
	\item Dwarsdoorsnede	
	\begin{itemize}[noitemsep, nolistsep]
		\item Afbeelding (\autoref{fig:VensterAfbeeldingTabbladAfbeelding})
		\item Kaart
	\end{itemize}
	\item Eigenschappen	
	\begin{itemize}[noitemsep, nolistsep]
		\item Berekening (\autoref{fig:VensterEigenschappenTabbladBerekening})\\
		Middels dit tabblad is het mogelijk om een (stabiliteits)berekening te openen in \dgeostability.
	\end{itemize}
	\item Tabellen	
	\begin{itemize}[noitemsep, nolistsep]
		\item Tabblad Ontwerpberekeningen (\autoref{fig:VensterTabellenTabbladBerekeningen})
	\end{itemize}
\end{itemize}

Allereerst laat de DAM User Interface de resultaten zien in het tabel-venster, zie \autoref{fig:VensterTabellenTabbladBerekeningen}.
Door een berekening in dit venster te selecteren, verschijnt in het Eigenschappenvenster een extra tabblad: Berekening, zie \autoref{fig:VensterEigenschappenTabbladBerekening}.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Uitvoer/VensterTabellenTabbladBerekeningen.png}
	\caption{Voorbeeld venster Tabellen tabblad Berekeningen}
	\label{fig:VensterTabellenTabbladBerekeningen}
\end{figure}

\begin{landscape}

\begin{footnotesize}
\begin{longtable}{|p{45mm}|p{45mm}|p{40mm}|p{75mm}|}
\caption{Overzicht van de parameters van tabblad Ontwerpberekeningen} \\ \hline
\label{tab:OverzichtOntwerpberekeningen}
\textbf{Kolomnaam (NL) met eenheid} & \textbf{Kolomnaam (ENG)} & \textbf{Faalmechanisme/model} & \textbf{Toelichting} \\ \hline
\endfirsthead
\hline
\textbf{Kolomnaam (NL) met eenheid} & \textbf{Kolomnaam (ENG)} & \textbf{Faalmechanisme/model} & \textbf{Toelichting} \\
\endhead
Locatie & Location & Algemeen &  \\ \hline
Scenario & Scenario & Algemeen &  \\ \hline
Berekeningsresultaat & Calculation result & Algemeen &  \\ \hline
X (RD) [m] & Global X-coordinate [m] & Algemeen &  \\ \hline
Y (RD) [m] & Global Y-coordinate [m] & Algemeen &  \\ \hline
Analyse & Analysis & Algemeen & Met of zonder geometrieaanpassing \\ \hline
Probabilistisch & Probabilistic & Algemeen &  \\ \hline
Opdrijven & Uplift & Algemeen & Is aangevinkt indien opdrijven voorkomt (uitgerekend met DAM methode, niet WBI) \\ \hline
Profielnaam & Profile & Algemeen & Naam ondergrondprofiel \\ \hline
Probabiliteit profiel [÷] & Profile probability [÷] & Algemeen & Kans van aantreffen ondergrondprofiel \\ \hline
Stabiliteitsfactor [-] & Safety factor [-] & Macrostabiliteit & Veiligheidsfactor macrostabiliteit (let op: in DAM 18.1 voor LiftVan inclusief veiligheidsfactor, dus nog vermenigvuldigen met 1.05 voor stabiliteitsfactor zonder model factor) \\ \hline
Bermhoogte [m] & Shoulder height [m] & Algemeen &  \\ \hline
X polderteen [m] & Toe polder [m] & Algemeen &  \\ \hline
Z polderteen [m] & Height toe polder [m] & Algemeen &  \\ \hline
Vereiste veiligheidsfactor [-] & Required safety factor [-] & Algemeen & Veiligheidsfactor waaraan het ontwerp (indien geometrie aanpassing) getoetst wordt \\ \hline
Buitenwaterstand & River level & Algemeen &  \\ \hline
Lage buitenwaterstand & River level low & Macrostabiliteit-buitenwaarts &  \\ \hline
DTH & Dike table height & Algemeen & Dijktafelhoogte, optie voor geometrieaanpassing \\ \hline
Helling demping PL3/PL4 & Slope damping factor & DAM Waternetcreator &  \\ \hline
X-lokaal intredepunt zone 1 [m] & Zone 1 entry point (X-local) [m] & Macrostabiliteit &  \\ \hline
Y-globaal intredepunt zone 1 [m] & Zone 1 entry point (Y-global) [m] & Macrostabiliteit &  \\ \hline
Zone 1 uittredepunt glijcirkel (X-lokaal) [m] & Zone 1 exit point (X-local) [m] & Macrostabiliteit &  \\ \hline
Zone 1 uittredepunt glijcirkel (Y-globaal) [m] & Zone 1 exit point (Y-global) [m] & Macrostabiliteit &  \\ \hline
X-lokaal intredepunt zone 2 [m] & Zone 2 entry point (X-local) [m] & Macrostabiliteit &  \\ \hline
Y-globaal intredepunt zone 2 [m] & Zone 2 entry point (Y-global) [m] & Macrostabiliteit &  \\ \hline
Zone 2 uittredepunt glijcirkel (X-lokaal) [m] & Zone 2 exit point (X-local) [m] & Macrostabiliteit &  \\ \hline
Zone 2 uittredepunt glijcirkel (Y-globaal) [m] & Zone 2 exit point (Y-global) [m] & Macrostabiliteit &  \\ \hline
Dijklengte [m] & Dike length [m] & Algemeen & Afstand tussen buitenteen en binnenteen \\ \hline
PL3 opdrijven [-] & PL3 Min uplift [-] & DAM Waternetcreator &  \\ \hline
PL3 stijghoogte aangepast[m] & PL3 Head adjusted[m] & DAM Waternetcreator &  \\ \hline
PL3 locatie opdrijven (X-lokaal) [m] & PL3 Min uplift (X-local) [m] & DAM Waternetcreator &  \\ \hline
PL3 locatie opdrijven (X-globaal) [m] & PL3 Min uplift (X-global) [m] & DAM Waternetcreator & x-coördinaat van het eerste punt waar opdrijven optreedt, m.b.t PL3 \\ \hline
PL3 locatie opdrijven (Y-globaal) [m] & PL3 Min uplift (Y-global) [m] & DAM Waternetcreator & y-coördinaat van het eerste punt waar opdrijven optreedt, m.b.t. PL3 \\ \hline
PL4 opdrijven [-] & PL4 Min uplift [-] & DAM Waternetcreator &  \\ \hline
PL4 stijghoogte aangepast [m] & PL4 Head adjusted[m] & DAM Waternetcreator &  \\ \hline
PL4 locatie opdrijven (X-lokaal) [m] & PL4 Min uplift (X-local) [m] & DAM Waternetcreator &  \\ \hline
PL4 locatie opdrijven (X-globaal) [m] & PL4 Min uplift (X-global) [m] & DAM Waternetcreator & x-coördinaat van het eerste punt waar opdrijven optreedt, m.b.t PL4 \\ \hline
PL4 locatie opdrijven (Y-globaal) [m] & PL4 Min uplift (Y-global) [m] & DAM Waternetcreator & y-coördinaat van het eerste punt waar opdrijven optreedt, m.b.t. PL4 \\ \hline
Model piping[-] & Piping model [-] & Piping & Het gebruikte model voor piping \\ \hline
Factor piping[-] & Piping factor [-] & Piping & Veiligheidsfactor piping indien model Bligh, Sellmeijer VNK of Sellmeijer 4-krachten is gekozen \\ \hline
Intredepunt piping x lokaal [m] & Piping entry point (X-local) [m] & Piping &  \\ \hline
Intredepunt piping x globaal [m] & Piping entry point (X-global) [m] & Piping &  \\ \hline
Intredepunt piping y globaal [m] & Piping entry point (Y-global) [m] & Piping &  \\ \hline
Uittredepunt piping x lokaal [m] & Piping exit point (X-local) [m] & Piping &  \\ \hline
Uittredepunt piping x globaal [m] & Piping exit point (X-global) [m] & Piping &  \\ \hline
Uittredepunt piping y globaal [m] & Piping exit point (Y-global) [m] & Piping &  \\ \hline
Kwelweglengte piping [m] & Seepage length piping [m] & Piping &  \\ \hline
Kritische hoogte[m] & H critical[m] & Piping &  \\ \hline
Veiligheidsfactor opdrijven [-] & Uplift safety factor [-] & DAM Waternetcreator & Verhouding tussen gewicht grond en waterdruk bovenkant aquifer op de uittredelocatie, zie \nameref{sec:DAMWaternetCreator}. \newline 
NB: verschilt dus van Opbarsten veiligheidsfactor (WBI) \\ \hline
Opbarsten veiligheidsfactor (WBI) [-] & Uplift safety factor (WBI) [-] & Piping (Sellmeijer Revised (WBI)) & Verhouding effectieve spanning en waterspanning, zie \nameref{sec:SellmeijerRevisedWBI}. \newline 
NB: Verschilt dus van Veiligheidsfactor opdrijven \\ \hline
Opbarsten DeltaHc (WBI) [m] & Uplift DeltaHc (WBI) [m] & Piping (Sellmeijer Revised (WBI)) & Kritiek verval voor opbarsten, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Opbarsten hc (WBI) [m] & Uplift hc (WBI) [m] & Piping (Sellmeijer Revised (WBI)) & Kritieke waterstand voor opbarsten, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Opbarsten effectieve laagdikte (WBI) [m] & Effective cover layer (WBI) [m] & Piping (Sellmeijer Revised (WBI)) & Effectieve laagdikte deklaag uittredepunt, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Opbarsten effectieve spanning (WBI) [kN/m²] & Effective stress exit point (WBI) [kN/m²] & Piping (Sellmeijer Revised (WBI)) & Effectieve spanning uittredepunt, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Heave veiligheidsfactor (WBI) [-] & Heave safety factor (WBI) [-] & Piping (Sellmeijer Revised (WBI)) & Veiligheidsfactor voor heave, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Heave hc (WBI) [m] & Heave hc (WBI) [m] & Piping (Sellmeijer Revised (WBI)) & Kritieke waterstand voor heave, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Heave gradiënt (WBI) [-] & Heave gradient (WBI) [-] & Piping (Sellmeijer Revised (WBI)) & De optredende verticale gradiënt in het opbarstkanaal, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Terugschrijdende erosie veiligheidsfactor (WBI) [-] & Backward erosion safety factor (WBI) [-] & Piping (Sellmeijer Revised (WBI)) & Veiligheidsfactor voor terugschrijdende erosie, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Terugschrijdende erosie hc (WBI) [m] & Backward erosion hc (WBI) [m] & Piping (Sellmeijer Revised (WBI)) & Kritieke waterstand voor terugschrijdende ersosie, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Terugschrijdende erosie DeltaHc (WBI) [m] & Backward erosion DeltaHc (WBI) [m] & Piping (Sellmeijer Revised (WBI)) & Het kritieke verval over de waterkering, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Terugschrijdende erosie CCreep (WBI) [-] & Backward erosion CCreep (WBI) [-] & Piping (Sellmeijer Revised (WBI)) & Verhouding $L/\Delta H_c$ tussen de kwelweglengte en het berekende kritieke verval, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Terugschrijdende erosie gereduceerd verval [m] & Backward erosion reduced DeltaHc & Piping (Sellmeijer Revised (WBI)) & Daadwerkelijk aanwezige stijghoogteverschil, het verschil tussen de buitenwaterstand en de binnenwaterstand, gecorrigeerd voor de drukval in het opbarstkanaal, zie \nameref{sec:SellmeijerRevisedWBI} \\ \hline
Piping veiligheidsfactor (WBI) [-] & Piping safety factor (WBI) [-] & Piping (Sellmeijer Revised (WBI)) & De hoogste veiligheidsfactor van de drie submechanismen \\ \hline
Piping hc (WBI) [m] & Piping Hc (WBI) [m] & Piping (Sellmeijer Revised (WBI)) & De kritieke waterstand behorende bij het maatgevende submechanisme \\ \hline
Melding resultaat & Message & Algemeen & Berekening mogelijk? \\ \hline
Opmerkingen & Notes & Algemeen & Vrij tekstveld voor gebruiker \\ \hline
Aantal iteraties & Number of iterations & Algemeen / geoemtrieaanpassing & Aantal rekenslagen benodigd om eindgeometrie te genereren \\ \hline
Evaluatie & Evaluation & Algemeen & Mogelijkheid voor gebruiker om berekening goed of af te keuren \\ \hline
\end{longtable}
\end{footnotesize}

\end{landscape}

\begin{figure}[H]
	\centering
		\includegraphics[width=0.70\textwidth]{Pictures/Uitvoer/VensterEigenschappenTabbladBerekening.png}
	\caption{Voorbeeld venster Eigenschappen tabblad  Berekening}
	\label{fig:VensterEigenschappenTabbladBerekening}
\end{figure}

Indien het om een stabiliteitsberekening gaat, laat het venster Afbeelding, op het tabblad `Berekening' een afbeelding van de betreffende berekening zien, 
zie \autoref{fig:VensterAfbeeldingTabbladAfbeelding}.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Uitvoer/VensterAfbeeldingTabbladAfbeelding.png}
	\caption{Voorbeeld venster Afbeelding tabblad Afbeelding}
	\label{fig:VensterAfbeeldingTabbladAfbeelding}
\end{figure}

NB: In het geval van een piping berekening is er geen afbeelding beschikbaar.

Het is tevens mogelijk de berekening te openen door in het venster Eigenschappen, tabblad Berekening op de knop ‘Open berekening’ te klikken, 
zie \autoref{fig:VensterEigenschappenTabbladBerekening}.
Hiermee wordt \dgeostability opgestart en laat deze een copy van de invoer van de berekening zien. 
Het origineel wordt dus niet geopend, hierdoor is het noodzakelijk opnieuw de berekening te laten uitvoeren door \dgeostability om alle resultaten in te zien. 
Hierdoor blijft het origineel ongebruikt. 
Er kunnen eventueel aanpassingen in de copy gedaan worden, zonder dat dit invloed heeft op de originele berekening.

De copy wordt normaliter in een tijdelijke directory opgeslagen, maar kan elders worden bewaard door middel van de optie ‘opslaan als’. 
Hierbij wordt de locatie aangegeven door de gebruiker.

Indien de geometrie door DAM is aangepast is dit te zien in het tabblad “dwarsdoorsnede” door middel van een groen gestippelde lijn, 
zie \autoref{fig:TabbladDwarsdoorsnedeOrigineleSchematiseringEnAangepasteGeometrie}.

\begin{figure}[H]
	\centering
		\includegraphics[width=1.00\textwidth]{Pictures/Uitvoer/TabbladDwarsdoorsnedeOrigineleSchematiseringEnAangepasteGeometrie.png}
	\caption{De originele schematisering en aangepaste geometrie (groen gestippeld)}
	\label{fig:TabbladDwarsdoorsnedeOrigineleSchematiseringEnAangepasteGeometrie}
\end{figure}

\section{Berekeningen controleren}
In het venster Eigenschappen tabblad Berekeningen zijn twee kolommen opgenomen waarin de controle van de berekeningen geregistreerd kunnen worden; nl. ‘Evaluatie’ en ‘Opmerkingen’.

In de kolom ‘Evaluatie’ kan de status van de berekening evaluatie worden weergeven door middel van de keuzes; 
\begin{itemize}[noitemsep, nolistsep]
	\item Goedgekeurd
	\item Afgekeurd
	\item Niet geëvalueerd
\end{itemize}

De laatste optie staat standaard in de kolom.

De kolom ‘Opmerkingen’ kan vrije tekst worden ingevuld met een maximale lengte van 15 leestekens. 
In verband met eventueel categoriseren van de opmerkingen en latere verwerking/presentatie in GIS, wordt aangeraden met codes te werken. 
Een voorbeeld van een codelijst is opgenomen in bijlage X.

\section{Uitvoerbestanden}
Na het uitvoeren van de berekeningen zijn de vensters van de user interface aangepast, zoals beschreven in voorgaande paragraven. 
Dit wordt opgeslagen in het project bestand (*.DAMx). 

Nadat de berekeningen zijn uitgevoerd, wordt het originele project bestand (*.DAMx) overschreven door de nieuwe.

Indien DAM wordt afgesloten, op een later tijdstip wordt opgestart en het project bestand (*.DAMx) wordt geopend, 
dan zijn de berekeningen wederom inzichtelijk en te openen zoals boven omschreven.

De mogelijkheden om de afbeeldingen van de stabiliteitsberekeningen te kunnen zien en stabiliteitsberekeningen te kunnen openen is echter wel afhankelijk van de aanwezigheid van meerdere bestanden. 
Deze zijn allen opgeslagen in een aangemaakte map: <trajectnaam>.Calc. 

Deze map is in dezelfde map aangemaakt als waar het project bestand (*.DAMx) wordt opgeslagen.

De <trajectnaam>.Calc bestaat uit de volgende mappen: 
\begin{itemize}[noitemsep, nolistsep]
	\item FMBishop.
	\item FMUpliftvan.
	\item Piping met als mogelijke submappen Bligh en SellMeijer Revised (WBI).
\end{itemize}

Belangrijk is dat deze mapstructuur ongewijzigd blijft om het project bestand (*.DAMx) goed te laten functioneren. 

Bovengenoemde bestanden worden automatisch door DAM aangemaakt. 
Daarnaast bestaat ook de mogelijkheid om als gebruiker bepaalde resultaatbestanden aan te maken.
De export bestanden wordt uitgevoerd door in de menubalk bestand-export te kiezen.
Hierbij bestaan de volgende mogelijkheden:
\begin{itemize}[noitemsep, nolistsep]
	\item scenario’s: een shapefile met alle berekeningen.
	\item bewaar berekeningsbestand; de \dgeostability file van de gekozen berekening.
	\item sla uitvoer plaatje op; slaat de wmf file van de gekozen berekening op.
\end{itemize}

Een andere mogelijkheid is het exporteren van het venster tabellen – berekeningen.
Hierbij wordt de tabel geëxporteerd zoals hij zichtbaar is, dus eventuele selecties blijven gelden. 
Deze export wordt uitgevoerd middels de knop ‘exporteren’ in de werkbalk van het venster.

%%%%%%%%%%%%%%%%%%%%
\chapter{Referenties}
\bibliography{../DAM_references/dam_references}
\nocite{DAMWebsite}

\begin{appendix}

\chapter{Location parameters (locations.csv)}
\label{app:LocationParameters}
Onderstaande tabel geeft een overzicht van de door DAM gebruikte parameters (\textit{Name}). 
Daarbij is aangegeven het type van de parameter (\textit{Type}), de dimensie (\textit{Unit}), 
of de parameter verplicht is (\textit{Required}) en een korte omschrijving. 
Als gewerkt wordt met shape files, mogen de attribuutnamen vrij gekozen worden. 
In de *.defx wordt dan de link gelegd tussen de parameter en de shape, inclusief attribuut. 
Als gewerkt wordt met *.csv bestanden, dan zijn de parameternamen, zoals gepresenteerd in onderstaande tabel, de headernamen in het *.csv bestand.

\begin{footnotesize}
\begin{longtable}{|p{45mm}|p{10mm}|p{9mm}|p{12mm}|p{\textwidth-60pt-76mm}|} \hline
\textbf{Name} & \textbf{Type} & \textbf{Unit} & \textbf{Required} & \textbf{Description} \\ \hline
\endfirsthead
\hline
\textbf{Name} & \textbf{Type} & \textbf{Unit} & \textbf{Required} & \textbf{Description} \\
\endhead
location\_id & StringId & - & yes & Name of location \\ \hline
surfaceline\_id & StringId & - & yes & Reference to surfaceline \\ \hline 
segment\_id & StringId & - & yes & Reference to segment \\ \hline 
geo\_x & Float & m & yes & x-coordinate \\ \hline 
geo\_y & Float & m & yes & y-coordinate \\ \hline 
x\_soilgeometry2D\_origin & Float & m & no & The  distance in x-direction between the origin of the soilgeometry2D and the first point of the surfaceline \\ \hline 
Pl1\_id & StringId & - & no & Reference to Pl1-line \\ \hline 
polderlevel & Float & m & yes & Level of water in polder \\ \hline 
polderlevellow & Float & m & no & Water level in polder (summer) \\ \hline 
head\_pl2 & Float & m & yes & Head of PL-Line2 \\ \hline 
head\_pl3 & Float & m & no & Head of PL-Line3; use MHW if not specified \\ \hline 
head\_pl4 & Float & m & no & Head of PL-Line4; use MHW if not specified \\ \hline 
grass\_quality & Float &  & no & Quality of grass (overtopping) \\ \hline 
Direction & Float & degree & no & Direction of waves (overtopping) \\ \hline 
Ophoogmateriaaldijk & StringId & - & no & Material to use for raising dike \\ \hline 
Ophoogmateriaalberm & StringId & - & no & Material to use for generating shoulder \\ \hline 
Sheetpile\_x & Float & m & no & RD x-coordinate top of sheetpile \\ \hline 
Sheetpile\_y & Float & m & no & RD y-coordinate top of sheetpile \\ \hline 
Sheetpile\_z & Float & m & no & RD z-coordinate top of sheetpile \\ \hline 
Sheetpile\_length & Float & m & no & Length of sheetpile \\ \hline 
RWBankProtectionBottomLevel & Float & m & no & Level of bottom of the sheetpiling in m-NAP \newline NOT IMPLEMENTED YET \\ \hline 
use\_original\_plline\_assignments & Boolean & - & no & Use the original assignments of the PL-Lines of the orginal geometry, instead of using expert knowledge to do this ;only applicable when 2D-geometries are used to create the MStab projects. \newline 
-- true \newline
-- false \\ \hline 
PenetrationLength & Float & m & yes & indringingslengte (for PL2); must >= 0; if 0 then no indringing is applied \\ \hline 
TrafficLoad & Float & kN/m$^{\text{2}}$ & yes & load of traffic (non-uniform load will be added for this) \\ \hline 
minimal\_circle\_depth & Float & m & no & minimal depth of circle of stability \\ \hline 
dempingsfactor\_pl3 & Float & - & yes & factor of damping for PL-Line 3 (deep sandlayer) (0.0 -1.0) \\ \hline 
dempingsfactor\_pl4 & Float & - & yes & factor of damping for PL-Line 4 (in between sandlayer) (0.0 -1.0) \\ \hline 
SlopeDampingPiezometricHeight PolderSide & Float & - & no & Factor for damping PL3 and PL4 in hinterland (0.0-1.0) \\ \hline 
PLLineCreationMethod & StringId & - & no & Method for creating PL-Lines \newline
Possible values (attention: case sensitive!): \newline
-- ExpertKnowledgeRRD \newline
-- ExpertKnowledgeLinearInDike \newline
-- GaugesWithFallbackToExpertKnowledgeRRD \\ \hline 
level\_reduction\_inside & Float & m & no & Amount with which the surfacelevel will be lowered at polder side \\ \hline 
level\_reduction\_outside & Float & m & no & Amount with which the surfacelevel will be lowered at rivers side \\ \hline 
layer\_height\_distribution & StringId & - & No & Probabilistic distribution of layer\_height \newline
Possible values (attention: case sensitive!): \newline
-- None \newline
-- Uniform \newline
-- Normal \newline
-- LogNormal \newline
-- Exponential \newline
-- Gamma \newline
-- Beta \newline
-- Frechet \newline
-- Weibull \\ \hline 
layer\_height\_deviation & Float & m & No & Probabilistic deviation of layer\_height \\ \hline 
uplift\_criterion\_piping & Float & - & No & criterion to determine if uplift occurs for piping \\ \hline 
uplift\_criterion\_stability & Float & - & No & criterion to determine if uplift occurs for stability \\ \hline 
Materiaaltypedijk & StringId & - & No & Type of material of dike (zand, klei, veen) \\ \hline 
bp\_tp & Float & m & No & Normative boezem level \\ \hline 
bp\_hbp & Float & m & No & Boezem level mean waterlevel \\ \hline 
bp\_lbp & Float & m & No & Boezem level mean low waterlevel \\ \hline 
Baggerdiepte & Float & m & No & Dredging depth in boezem \\ \hline 
distance\_to\_entry\_point & Float & m & No & Distance from toe of dike to entry point of river in deep sandlayer \\ \hline 
PLLineOffsetBelowDikeTopAtRiver & Float & m & No & PL1 below top of dike (riverside) \\ \hline 
PLLineOffsetBelowDikeTopAtPolder & Float & m & No & PL1 below top of dike (polderside) \\ \hline 
PLLineOffsetBelowShoulderBase Inside & Float & m & No & PL1 below top of shoulder (polderside) \\ \hline 
PLLineOffsetBelowDikeToeAtPolder & Float & m & No & PL1 below toe of dike (polderside) \\ \hline 
PLLineOffsetDryBelowDikeTop AtRiver & Float & m & No & PL1 below top of dike (riverside) in dry situtation \\ \hline 
PLLineOffsetDryBelowDikeTopAt Polder & Float & m & No & PL1 below top of dike (polderside) in dry situtation \\ \hline 
PLLineOffsetDryBelowShoulder BaseInside & Float & m & No & PL1 below top of shoulder (polderside) in dry situtation \\ \hline 
PLLineOffsetDryBelowDikeToeAt Polder & Float & m & No & PL1 below toe of dike (polderside) in dry situtation \\ \hline 
UsePLLineOffsetBelowDikeCrest Middle & Boolean & - & No & Use the Offset below the middle of the dike crest for pl-line 1. \\ \hline 
PLLineOffsetBelowDikeCrestMiddle & Float & m & No & Offset below the middle of the dike crest for pl-line 1. \\ \hline 
UsePLLineOffsetFactorBelow ShoulderCrest & Boolean & - & No & Use the Offset below the shoulder crest defined as factor (0-1) on the difference in height between shoulder crest and shoulder (= dike) toe for pl-line 1. \\ \hline 
PLLineOffsetFactorBelowShoulder Crest & Float & - & No & Offset below the shoulder crest defined as factor (0-1) on the difference in height between shoulder crest and shoulder (= dike) toe for pl-line 1. \\ \hline 
UsePLLineOffsetDryBelowDike CrestMiddle & Boolean & - & No & Use the Offset below the middle of the dike crest for pl-line 1 in dry situtation. \\ \hline 
PLLineOffsetDryBelowDikeCrest Middle & Float & m & No & Offset below the middle of the dike crest for pl-line 1 in dry situtation. \\ \hline 
UsePLLineOffsetDryFactorBelow ShoulderCrest & Boolean & - & No & Use the Offset below the shoulder crest defined as factor (0-1) on the difference in height between shoulder crest and shoulder (= dike) toe for pl-line 1 in dry situtation. \\ \hline 
PLLineOffsetDryFactorBelow ShoulderCrest & Float & - & No & Offset below the shoulder crest defined as factor (0-1) on the difference in height between shoulder crest and shoulder (= dike) toe for pl-line 1 in dry situtation. \\ \hline 
IntrusionVerticalWaterPressure & String id & - & No & Defines how vertical water pressures should intrude. Options are (case insensitive): \newline
-- Standard \newline
-- Linear \newline
-- FullHydroStatic \newline
-- HydroStatic \newline
-- SemiTimeDependent \\ \hline 
StabilityShoulderGrowSlope & Float & m & No & Shoulder growth slope for stability design \\ \hline 
StabilityShoulderGrowDeltaX & Float & m & No & Shoulder growth delta X for stability design \\ \hline 
StabilitySlopeAdaptionDeltaX & Float & m & No & Slope adaption delta X for stability design \\ \hline 
detrimentfactor & Float & - & No & Detriment factor \\ \hline 
DikeTableHeight & Float & m & No & Dike table height \\ \hline 
StabilityDesignMethod & String Id & - & No & Design method \newline
-- OptimizedSlopeAndShoulderAdaption (apply slope adaption when slipcircle exits in slope, apply shoulder when slipcircle exits in polder) \newline
-- SlopeAdaptionBeforeShoulderAdaption (First apply slope adaption starting with SlopeAdaptionStartCotangent, stepping with SlopeAdaptionStepCotangent and ending with SlopeAdaptionStepCotangent; only after that apply shoulder adaption) \\ \hline 
ZoneType & String Id & - & No & ZoneType for stability inside calculation \newline
Possible values (attention: case sensitive!): \newline
-- NoZones \newline
-- ZoneAreas \newline
-- ForbiddenZone \\ \hline 
SlopeAdaptionStartCotangent & Float & - & No & Start slope for design method SlopeAdaptionBeforeShoulderAdaption \\ \hline 
SlopeAdaptionEndCotangent & Float & - & No & End slope for design method SlopeAdaptionBeforeShoulderAdaption \\ \hline 
SlopeAdaptionStepCotangent & Float & - & No & Step of slope for design method SlopeAdaptionBeforeShoulderAdaption \\ \hline 
UseNewDikeTopWidth & Boolean & - & No & Design method, height adapter: use the value for new width for dike crest \\ \hline 
NewDikeTopWidth & Float & m & No & Design method, height adapter: new width for dike crest \\ \hline 
UseNewDikeSlopeInside & Boolean & - & No & Design method, height adapter: use the value for new inside slope for the dike \\ \hline 
NewDikeSlopeInside & Float & - & No & Design method, height adapter: new inside slope for the dike \\ \hline 
UseNewDikeSlopeOutside & Boolean & - & No & Design method, height adapter: use the value for new outside slope for the dike \\ \hline 
NewDikeSlopeOutside & Float & - & No & Design method, height adapter: new outside slope for the dike \\ \hline 
UseNewShoulderTopSlope & Boolean & - & No & Design method, shoulder adapter: use the value for new topside slope for the shoulder \\ \hline 
NewShoulderTopSlope & Float & - & No & Design method, shoulder adapter: new topside slope for the shoulder \\ \hline 
UseNewShoulderBaseSlope & Boolean & - & No & Design method, shoulder adapter: use the value for new base slope for the shoulder \\ \hline 
NewShoulderBaseSlope & Float & - & No & Design method, shoulder adapter: new base slope for the shoulder \\ \hline 
UseNewMaxHeightShoulderAs Fraction & Boolean & - & No & Design method, shoulder adapter: use the value for new maximum allowed height for the shoulder as fraction of the dike height. \\ \hline 
NewMaxHeightShoulderAsFraction & Float & - & No & Design method, shoulder adapter: new maximum allowed height for the shoulder as fraction of the dike height. \\ \hline 
UseNewMinDistanceDikeToeStart Ditch & Boolean & - & No & Design method: use the new value of the minimum distance allowed between the dike toe (inside) and the start of the ditch. \\ \hline 
NewMinDistanceDikeToeStartDitch & Float & m & No & Design method: value of the minimum distance allowed between the dike toe (inside) and the start of the ditch. \\ \hline 
UseNewDitchDefinition & Boolean & - & No & Design method: use the new definition for the ditch (creating a totally new ditch instead of moving old ditch) \\ \hline 
NewWidthDitchBottom & Float & m & No & Design method: value of the width of the bottom of the new ditch. \\ \hline 
NewDepthDitch & Float & m & No & Design method: value of the depth of the bottom of the new ditch (related to polder level). \\ \hline 
NewSlopeAngleDitch & Float & - & No & Design method: value of the slope angles of the new ditch. \\ \hline 
\end{longtable}
\end{footnotesize}

\chapter{Characteristic points}
\label{app:CharacteristicPoints}
Onderstaande tabel geeft een overzicht van de benodigde karakteristieke punten in het bestand \textit{characteristicpoints.csv}. 
Daarbij is aangegeven welke punten verplicht zijn en welke niet. 
Overigens geldt dat als, bijvoorbeeld van de sloot, het eerste punt is opgegeven ook alle andere punten van de sloot aanwezig moeten zijn. 
Dit geldt ook voor de bermen. Deze onderlinge afhankelijkheden zijn in onderstaande tabel gearceerd. 
Als een niet verplicht punt niet aanwezig is, dan dient voor de X, Y en Z waarde -1 ingevuld te worden. 
De onderstaande namen vormen samen de header regel van het \textit{characteristicpoints.csv} bestand.

\begin{longtable}{|l|l|} \hline
\textbf{Naam} & \textbf{Required} \\ \hline
\endfirsthead
\hline
\textbf{Naam} & \textbf{Required} \\
\endhead
LOCATIONID & Yes \\ \hline
X\_Maaiveld binnenwaarts & Yes \\ \hline
Y\_Maaiveld binnenwaarts & Yes \\ \hline
Z\_Maaiveld binnenwaarts & Yes \\ \hline
X\_Insteek sloot polderzijde & No \\ \hline
Y\_Insteek sloot polderzijde & No \\ \hline
Z\_Insteek sloot polderzijde & No \\ \hline
X\_Slootbodem polderzijde & No \\ \hline
Y\_Slootbodem polderzijde & No \\ \hline
Z\_Slootbodem polderzijde & No \\ \hline
X\_Slootbodem dijkzijde & No \\ \hline
Y\_Slootbodem dijkzijde & No \\ \hline
Z\_Slootbodem dijkzijde & No \\ \hline
X\_Insteek sloot dijkzijde & No \\ \hline
Y\_Insteek sloot dijkzijde & No \\ \hline
Z\_Insteek sloot dijkzijde & No \\ \hline
X\_Teen dijk binnenwaarts & Yes \\ \hline
Y\_Teen dijk binnenwaarts & Yes \\ \hline
Z\_Teen dijk binnenwaarts & Yes \\ \hline
X\_Kruin binnenberm & No \\ \hline
Y\_Kruin binnenberm & No \\ \hline
Z\_Kruin binnenberm & No \\ \hline
X\_Insteek binnenberm & No \\ \hline
Y\_Insteek binnenberm & No \\ \hline
Z\_Insteek binnenberm & No \\ \hline
X\_Kruin binnentalud & Yes \\ \hline
Y\_Kruin binnentalud & Yes \\ \hline
Z\_Kruin binnentalud & Yes \\ \hline
X\_Verkeersbelasting kant binnenwaarts & Yes \\ \hline
Y\_Verkeersbelasting kant binnenwaarts & Yes \\ \hline
Z\_Verkeersbelasting kant binnenwaarts & Yes \\ \hline
X\_Verkeersbelasting kant buitenwaarts & Yes \\ \hline
Y\_Verkeersbelasting kant buitenwaarts & Yes \\ \hline
Z\_Verkeersbelasting kant buitenwaarts & Yes \\ \hline
X\_Kruin buitentalud & Yes \\ \hline
Y\_Kruin buitentalud & Yes \\ \hline
Z\_Kruin buitentalud & Yes \\ \hline
X\_Insteek buitenberm & No \\ \hline
Y\_Insteek buitenberm & No \\ \hline
Z\_Insteek buitenberm & No \\ \hline
X\_Kruin buitenberm & No \\ \hline
Y\_Kruin buitenberm & No \\ \hline
Z\_Kruin buitenberm & No \\ \hline
X\_Teen dijk buitenwaarts & Yes \\ \hline
Y\_Teen dijk buitenwaarts & Yes \\ \hline
Z\_Teen dijk buitenwaarts & Yes \\ \hline
X\_Maaiveld buitenwaarts & Yes \\ \hline
Y\_Maaiveld buitenwaarts & Yes \\ \hline
Z\_Maaiveld buitenwaarts & Yes \\ \hline
\end{longtable}

\chapter{Voorbeeld tijdreeks voor berekeningstype calamiteit}
\label{app:VoorbeeldCalamiteit}
Onderstaand een voorbeeld van een *.XML bestand zoals gebruikt voor het berekeningstype calamiteit.

In onderstaand voorbeeld is voor de locaties dwp00\_5 en dwp02\_04 een waterstandsverloop geconstrueerd. 
Hierbij zijn voor drie tijdstippen waterstanden opgenomen.

\begin{scriptsize}
\begin{verbatim}
<series>
<header>
  <type>instantaneous</type> 
  <locationid>dwp00\_5</locationid> 
  <parameterid>Waterlevel</parameterid> 
  <timeStep unit="hour" divider="1" multiplier="1" /> 
  <startDate date="1995-01-22" time="00:00:00" /> 
  <endDate date="1995-01-22" time="02:00:00" /> 
  <missVal>NaN</missVal> 
  </header>
  <event date="1995-01-22" time="00:00:00" value="0.43120244" flag="0" /> 
  <event date="1995-01-22" time="01:00:00" value="0.444383032" flag="0" /> 
  <event date="1995-01-22" time="02:00:00" value="0.453542638" flag="0" /> 
  </series>
<series>
<header>
  <type>instantaneous</type> 
  <locationid>dwp02\_4</locationid> 
  <parameterid>Waterlevel</parameterid> 
  <timeStep unit="hour" divider="1" multiplier="1" /> 
  <startDate date="1995-01-22" time="00:00:00" /> 
  <endDate date="1995-01-22" time="02:00:00" /> 
  <missVal>NaN</missVal> 
  </header>
  <event date="1995-01-22" time="00:00:00" value="0.43120244" flag="0" /> 
  <event date="1995-01-22" time="01:00:00" value="0.444383032" flag="0" /> 
  <event date="1995-01-22" time="02:00:00" value="0.453542638" flag="0" /> 
  </series>
</TimeSeries>
\end{verbatim}
\end{scriptsize}

\chapter{Voorbeeld scenarios.csv}
\label{app:VoorbeeldScenariosCsv}
Onderstaand een voorbeeld van een \textit{scenarios.csv} voor twee locaties. 
De koppeling met de locaties gebeurd met de \textit{location\_id}. 
Daarnaast heeft elk scenario, per \textit{location\_id}, zijn unieke ID.

\begin{table}[H]
\begin{scriptsize}
\begin{tabular}{|p{19mm}|p{25mm}|p{15mm}|p{22mm}|p{\textwidth-60pt-81mm}|} \hline
\textbf{location\_id} & \textbf{location\_scenario\_id} & \textbf{water\_height} & \textbf{dike\_table\_height} & \textbf{safety\_factor\_stability\_inner\_slope} \\ \hline
OR\_409\_001\_i & 1 & -0.3 & 1 & 0.95 \\ \hline
OR\_409\_001\_i & 2 & -0.1 & 1.2 & 0.95 \\ \hline
OR\_409\_001\_i & 3 & 0 & 1.3 & 0.95 \\ \hline
OR\_409\_002A\_i & 1 & -0.2 & 1 & 0.9 \\ \hline
OR\_409\_002A\_i & 2 & -0.2 & 1 & 0.95 \\ \hline
OR\_409\_002A\_i & 3 & -0.2 & 1 & 1 \\ \hline			
\end{tabular}
\end{scriptsize}
\end{table}

In het voorbeeld is duidelijk te zien dat met de verschillende parameters gevarieerd kan worden. 
Naast de weergegeven kolommen, zijn er nog meer kolommen mogelijk. 
Deze zijn allen in onderstaande tabel weergegeven te weten:

\begin{table}[H]
\begin{footnotesize}
\begin{tabular}{|p{55mm}|p{10mm}|p{10mm}|p{10mm}|p{\textwidth-60pt-85mm}|} \hline
\textbf{Name} & \textbf{Type} & \textbf{Unit} & \textbf{Required} & \textbf{Description} \\ \hline
location\_id & StringId & - & yes & Reference to location (in locations.csv) \\ \hline
location\_scenario\_id & Integer & - & yes & Sequence number of scenario for location \\ \hline
water\_height & Float & m & yes & Waterheight for scenario (MHW) \\ \hline
water\_height\_low & Float & m & no & Waterheight lw for scenario (GLW) \\ \hline
dike\_table\_height & Float & m & yes & Dike table height for scenario \\ \hline
water\_height\_decimerings\_hoogte & Float & m & no & water height difference (+ or -) with chance of occurrence 10 times as low as the specified water height \\ \hline
max\_waterheight & Float & m & no & when applying water\_height\_decimerings\_hoogte the upper boundary is set by this value \\ \hline
safety\_factor\_piping & Float & - & no & required safety factor for piping for design option \\ \hline
safety\_factor\_stability\_inner\_slope & Float & - & no & required safety factor for stability innerslope for design option \\ \hline
safety\_factor\_stability\_outer\_slope & Float & - & no & required safety factor for stability outerslope for design option for design option \\ \hline
uplift\_criterion\_piping & Float & - & no & criterion to determine if uplift occurs for piping \\ \hline
uplift\_criterion\_stability & Float & - & no & criterion to determine if uplift occurs for stability \\ \hline
PLLineOffsetBelowDikeTopAtRiver & Float & m & no & Offset below the dike top at river for pl-line 1. \\ \hline
PLLineOffsetBelowDikeTopAtPolder & Float & m & no & Offset below the dike top at polder for pl-line 1. \\ \hline
PLLineOffsetBelowShoulderBaseInside & Float & m & no & Offset below the base of the shoulder inside for pl-line 1. \\ \hline
PLLineOffsetBelowDikeToeAtPolder & Float & m & no & Offset below the dike toe at polder for pl-line 1. \\ \hline
UsePLLineOffsetBelowDikeCrestMiddle & Boolean & - & No & Use the Offset below the middle of the dike crest for pl-line 1. \\ \hline
PLLineOffsetBelowDikeCrestMiddle & Float & m & No & Offset below the middle of the dike crest for pl-line 1. \\ \hline
UsePLLineOffsetFactorBelowShoulderCrest & Boolean & - & No & Use the Offset below the shoulder crest defined as factor (0-1) on the difference in height between shoulder crest and shoulder (= dike) toe for pl-line 1. \\ \hline
PLLineOffsetFactorBelowShoulderCrest & Float & - & No & Offset below the shoulder crest defined as factor (0-1) on the difference in height between shoulder crest and shoulder (= dike) toe for pl-line 1. \\ \hline
HeadPL3 & Float & m & No & Head for pl-line 3. \\ \hline
HeadPL4 & Float & m & No & Head for pl-line 4. \\ \hline
\end{tabular}
\end{footnotesize}
\end{table}

\chapter{Voorbeeld soils.csv}
\label{app:VoorbeeldSoilsCsv}
Onderstaand een voorbeeld van een \textit{soils.csv}. 
De koppeling met de grond profielen gebeurt met de \textit{soil\_name}. 
Deze naam dient dan ook uniek te zijn.

In het voorbeeld is duidelijk te zien dat met de verschillende parameters gevarieerd kan worden afhankelijk van het gekozen model. 
Alle mogelijkheden zijn in onderstaande tabel weergegeven:

\begin{table}[H]
\begin{footnotesize}
\begin{tabular}{|p{40mm}|p{10mm}|p{10mm}|p{15mm}|p{\textwidth-60pt-75mm}|} \hline
\textbf{Name} & \textbf{Type} & \textbf{Unit} & \textbf{Required} & \textbf{Description} \\ \hline
soil\_name & StringId & - & yes & Name \\ \hline
soil\_color & StringId & - & yes & Color \\ \hline
soil\_type & StringId & - & yes & Indicates the soil type associated with this soil. \\ \hline
saturated\_unit\_weight & Float & kN/m$^{\text{3}}$ & no & Unit weight below phreatic level \\ \hline
unsaturated\_unit\_weight & Float & kN/m$^{\text{3}}$ & no & Unit weight above phreatic level \\ \hline
cohesion & Float & kN/m$^{\text{2}}$ & no & Cohesion \\ \hline
friction\_angle & Float & deg & no & Friction Angle \\ \hline
diameter\_d70 & Float & µm & no & Diameter D70 \\ \hline
permeability\_x & Float & m/s & no & Permeability Kx \\ \hline
shear\_strength\_model & StringId & - & no & Shear strength model. The only supported two options are “CPhi” and “CuCalculated” \\ \hline
strength\_increase\_exponent & Float & - & no & Strength increase exponent \\ \hline
ratio\_su\_pc & Float & - & no & Shear strength ratio S \\ \hline
use\_pop & Boolean & - & no & Use POP \\ \hline
pop & Float & kN/m$^{\text{2}}$ & no & POP \\ \hline
\end{tabular}
\end{footnotesize}
\end{table}

\chapter{Voorbeeld soilprofiles.csv}
\label{app:VoorbeeldSoilprofilesCsv}
Onderstaand een voorbeeld van een \textit{soilprofile.csv}. 
Per profiel kunnen er meerdere rijen aanwezig zijn indien een profiel uit meerdere lagen bestaat. 
De eigenschappen van de laag wordt gedefinieerd in \textit{soils.csv}.

In het voorbeeld is duidelijk te zien dat met de verschillende parameters gevarieerd kan worden afhankelijk van het gekozen model. 
Alle mogelijkheden zijn in onderstaande tabel weergegeven:

\begin{table}[H]
\begin{tabular}{|p{30mm}|p{15mm}|p{10mm}|p{15mm}|p{\textwidth-60pt-70mm}|} \hline
\textbf{Name} & \textbf{Type} & \textbf{Unit} & \textbf{Required} & \textbf{Description} \\ \hline
soilprofile\_id & StringId & - & yes & Name \\ \hline
top\_level & Float & - & yes & Indicates the top level of the soil \\ \hline
soil\_name & StringId & - & yes & Indicates the soil name associated with this soil. The name should be present in soil.csv \\ \hline
soiltype & StringId & - & no & Obsolete. \\ \hline
is\_aquifer & Boolean & - & yes & Indicates whether the soil is water bearing. \\ \hline
\end{tabular}
\end{table}

\chapter{Voorbeeld *.defx}
\label{app:VoorbeeldDefx}

\begin{tiny}
\begin{verbatim}
<?xml version="1.0" encoding="utf-8"?>
<DatasourceContainer Key="1">
  <DataSourceList>
    <DataSource Key="2" DataSourceType="CsvFiles" DataLocation="csvfiles\" />
    <DataSource Key="4" DataSourceType="BackgroundShapeFiles" DataLocation="..\shapefiles\Hollands_Noorderkwartier_top250" />
    <DataSource Key="6" DataSourceType="DataShapeFiles" DataLocation="..\shapefiles\" />
  </DataSourceList>
  <DataAttributes>       
     <Attribute Key="7" Id="PolderLevel" DataSource="PolderLevel.shp" Name="PLHIGH" />
     <Attribute Key="8" Id="PolderLevellow" DataSource="PolderLevel.shp" Name="PLLOW" />     
     <Attribute Key="18" Id="head_pl3" DataSource="HeadPL3.shp" Name="HEADPL3" />
     <Attribute Key="19" Id="materiaaltypedijk" DataSource="Materiaaltypedijk.shp" Name="MATDIKE" />
     <Attribute Key="19" Id="ophoogmateriaaldijk" DataSource="DikeMaterial.shp" Name="DikeMtrl" />
     <Attribute Key="18" Id="dempingsfactor_pl3" DataSource="DampingFactorPL3.shp" Name="DAMPINGPL3" />
     <Attribute Key="19" Id="dempingsfactor_pl4" DataSource="DampingFactorPL4.shp" Name="DAMPINGPL4" />
     <Attribute Key="20" Id="Sheetpile_length" DataSource="SheetPileLength.shp" Name="SHTPLLGTH" />
     <Attribute Key="22" Id="RWBankProtectionBottomLevel" DataSource="SheetPileLength.shp" Name="ONDDMWND" />
     <Attribute Key="25" Id="PenetrationLength" DataSource="PenetrationLength.shp" Name="PENLENGTH" />
     <Attribute Key="26" Id="TrafficLoad" DataSource="TrafficLoad.shp" Name="TRAFLOAD" />
     <Attribute Key="27" Id="PLLineCreationMethod" DataSource="PLLineCreationMethod.shp" Name="PLCRTMTHD" />
     <Attribute Key="28" Id="PLLineOffsetBelowDikeTopAtRiver" DataSource="PLLines.shp" Name="PLOBDTOPR" />
     <Attribute Key="29" Id="PLLineOffsetBelowDikeTopAtPolder" DataSource="PLLines.shp" Name="PLOBDTOPP" />
     <Attribute Key="30" Id="PLLineOffsetBelowShoulderBaseInside" DataSource="PLLines.shp" Name="PLOBSB" />
     <Attribute Key="31" Id="PLLineOffsetBelowDikeToeAtPolder" DataSource="PLLines.shp" Name="PLOBDTOEP" />
     <Attribute Key="32" Id="PLLineOffsetDryBelowDikeTopAtRiver" DataSource="PLLines.shp" Name="PLODBDTOPR" />
     <Attribute Key="33" Id="PLLineOffsetDryBelowDikeTopAtPolder" DataSource="PLLines.shp" Name="PLODBDTOPP" />
     <Attribute Key="34" Id="PLLineOffsetDryBelowShoulderBaseInside" DataSource="PLLines.shp" Name="PLODBSB" />
     <Attribute Key="35" Id="PLLineOffsetDryBelowDikeToeAtPolder" DataSource="PLLines.shp" Name="PLODBDTOEP" />
     <Attribute Key="40" Id="baggerdiepte" DataSource="Baggerdiepte.shp" Name="DRDGDEPTH" />
     <Attribute Key="40" Id="bp_tp" DataSource="MBPPROV.shp" Name="mbp" />
     <Attribute Key="41" Id="bp_hbp" DataSource="BP_GWS.shp" Name="BPGWS" />
     <Attribute Key="42" Id="bp_lbp" DataSource="BP_GLW.shp" Name="BPGLW" />
     <Attribute Key="43" Id="minimal_circle_depth" DataSource="MinimalCircleDepth.shp" Name="MINCLDEPTH" />
     <Attribute Key="48" Id="safety_factor_piping" DataSource="SafetyFactorPiping.shp" Name="FPIPING" />
     <Attribute Key="54" Id="uplift_criterion_piping" DataSource="UpliftCriterionPiping.shp" Name="UPLPIPING" />
     <Attribute Key="56" Id="uplift_criterion_stability" DataSource="UpliftCriterionStability.shp" Name="UPLSTAB" />     
     <Attribute Key="60" Id="Location_id" DataSource="LocationID.shp" Name="LocationId" />         
     <Attribute Key="61" Id="DikeRing_id" DataSource="LocationID.shp" Name="DikeRingId" /> 
     <Attribute Key="64" Id="segment_id" DataSource="segments.shp" Name="CODE" />         
     <Attribute Key="64" Id="DetrimentFactor" DataSource="Schadefactor.shp" Name="SCHADEFACT" />         
  </DataAttributes>
</DatasourceContainer>
\end{verbatim}
\end{tiny}

\end{appendix}

\end{document}