\chapter{Inleiding}

Het softwarepakket Dijksterkte Analyse Module (\dam) is sinds 2008 ontwikkeld binnen verschillende projecten van onder andere diverse waterschappen, STOWA en (ontwikkelings-) programma's. Dit heeft in 2013 geleid tot \dam 1.0: een versie van \dam die voor iedereen binnen het waterkeringendomein te gebruiken is. De voordelen van \dam en de aanwezige functionaliteiten in \dam voor de waterkeringsprocessen hebben zich in de praktijk bewezen. Tegelijkertijd zien Deltares en de gebruikers veel mogelijkheden om \dam uit te breiden met nieuwe functionaliteiten, zoals aansluiten bij de ontwikkelingen van het Wettelijke Beoordelingsinstrumentarium 2017 (WBI2017). Maar ook in \damlive (de real-time variant van \dam voor operationele systemen, zoals monitoringssystemen) worden vele mogelijkheden gezien om de waterkeringsprocessen door middel van automatisering te ondersteunen.
In 2017 wordt een herstructureringsslag gemaakt voor \dam. Hiertoe worden de 'Eisen en functioneel ontwerp' opgesteld, zodat de huidige functionaliteit aantoonbaar aanwezig is na de herstructurering.

\section{Achtergrond}\label{sec:achtergrond}
Voor het uitvoeren van een analyse van de dijksterkte kunnen vier hoofdstappen worden onderscheiden. 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 schematisatie is sterk afhankelijk van de vraag. Daarnaast geldt hoe meer informatie aanwezig is, hoe nauwkeuriger de schematisatie. 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. Zie \autoref{fig:Sterkte_analyse_dijk}

\begin{figure}[H]
	\centering
		\includegraphics[width=0.5\textwidth]{figuren/Sterkte_analyse_dijk.png}
	\caption{Sterkte analyse dijk}
	\label{fig:Sterkte_analyse_dijk}
\end{figure}

Deze vier stappen worden voor elke toepassing gezet. Voor toetsing, ten tijde van calamiteiten, voor beleidsvraagstukken en voor beheerszaken wordt veelal gebruik gemaakt van dezelfde basisgegevens en eventueel van dezelfde schematisaties.

Wanneer het schema van \autoref{fig:Sterkte_analyse_dijk} meer uitgewerkt wordt, zie het er als volgt uit:

\begin{figure}[H]
	\centering
		\includegraphics[width=1\textwidth]{figuren/flowchart_proces_DAM.png}
	\caption{Stroomschema DAM-processen}
	\label{fig:stroomschemaDAM}
\end{figure}

Waarbij de stappen die door de gebruiker worden gedaan, weergegeven door 'persoon' en de functionaliteit van de DAM wordt weergegeven met 'computer'.
Alle sterkteberekeningen zijn gebaseerd op de verhouding tussen de sterkte en de belasting. Hierbij zijn twee workflows:
\begin{enumerate}
	\item Sterkte analyse; belasting en sterkte zijn bekend; evenwichtsfactor wordt uitgerekend
	\item Doelzoeken; bij een gegeven evenwichtsfactor en een variabele van de invoer, wordt een variabele gevonden, waarbij de evenwichtsfactor gehaald wordt.
\end{enumerate}

Het toetsen van regionale keringen is een bijzondere uitwerking van de eerste optie, waarbij de stap van het vaststellen van de rekenscenario's ondersteund/uitgevoerd wordt door \dam.

\section{Doelstellingen}
\dam dient bovenstaande stappen te faciliteren op zodanige wijze dat de stappen reprocuceerbaar zijn en de stappen voor andere toepassingen met minder inspanning gezet kunnen worden.

Het werkproces kan effici\"enter gemaakt worden door de basisdata en schematisaties op een handige manier aan elkaar te koppelen en vervolgens te 'hergebruiken'. Hiertoe is de Dijksterkte Analyse Module (\dam) 1.0 ontwikkeld. \dam 1.0 betreft een platform waarmee automatisch stabiliteitsberekeningen van grote dijkstrekkingen kunnen worden uitgevoerd. \dam 1.0 rationaliseert en automatiseert de derde stap (berekeningen) en een groot gedeelte van de tweede stap (schematisatie). 

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:Datamanagement}.

\section{Over dit document}

Tijdens de ontwikkeling van \dam is de functionaliteit beschreven in deel C van de handleiding. In 2017 wordt \dam geherstructureerd; er wordt geen nieuwe functionaliteit toegevoegd, wel wordt de architectuur van de software aangepast. Voor dit proces en de verdere toekomst, worden de requirements en functioneel ontwerp in een apart (onderliggend) document zo volledig mogelijk uitgeschreven. Hiermee kunnen de stakeholders na de herstructurering vaststellen of de bestaande functionaliteit gehandhaafd (of eventueel verbeterd) is.
Dit houdt in dat in de huidige versie de bestaande functionaliteit als uitgangspunt wordt genomen en wordt beschreven. Eventuele ontwikkelpunten worden in \autoref{Openstaandekwesties} opgenomen.

Na herstucturering dient dit onderliggende document regelmatig geactualiseerd te worden tijdens de verder ontwikkeling van \dam. Met dit document kunnen stakeholders dan controleren of de beoogde nieuwe functionaliteiten naar hun wensen zijn en of deze functionaliteit bereikt wordt (acceptatie testen).

De functionaliteit wordt omschreven in zowel de stappen (\autoref{sec:DAMinStappen}), als de type vraagstellingen (\autoref{sec:DAMpervraag}), beiden genoemd in \autoref{sec:achtergrond}. Daarnaast komen ook de niet-functionele eisen aan de orde, zie \autoref{sec:niet-functionele eisen}. Omdat voor de architectuur van belang is welke toekomstige ontwikkelingen voorzien zijn voor \dam, zijn deze opgenomen in \autoref{sec:DAMtoekomst})
Omdat tijdens het opstellen van dit document en ook in de verdere ontwikkeling van \dam, mogelijk nog niet alle issues te plaatsen zijn, is er een \autoref{sec:openstaandekwesties} opgenomen. Hier kunnen zaken in worden opgenomen, waarover nog besloten moet worden of zijn binnen de scope van \dam vallen en zo ja, welke uitwerking verder nodig is. 

\subsection*{Overige documenten}
In een visiedocument wordt beschreven wat de filosofie achter DAM is en wat er binnen de scope van DAM valt.

In een architectuurdocument wordt de samenhang van de verschillende componenten van \dam weergegeven.

Naast dit functioneel ontwerp voor DAM, wordt ook een functioneel ontwerp opgesteld voor een GUI van DAM. Hierin wordt omschreven welke functionaliteit van de GUI wordt verwacht, evenals een ontwerp van de schermen.


