kkpdata · chrispijo · Feb 5, 2026 · Feb 5, 2026 · Mar 12, 2026 · Mar 12, 2026
diff --git a/docs/_static/BRP_implementatie.png b/docs/_static/BRP_implementatie.png
diff --git a/docs/_static/EffectieveVoorlandlengte_dubbel_scenario.png b/docs/_static/EffectieveVoorlandlengte_dubbel_scenario.png
diff --git a/docs/_static/EffectieveVoorlandlengte_enkel_scenario.png b/docs/_static/EffectieveVoorlandlengte_enkel_scenario.png
diff --git a/docs/achtergronden_schematiseren.rst b/docs/achtergronden_schematiseren.rst
@@ -0,0 +1,14 @@
+Achtergronden schematiseren
+===========================
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Inhoud
+    :titlesonly:
+
+    achtergronden_schematiseren/hierarchie
+    achtergronden_schematiseren/typen_ondergrondscenarios
+    achtergronden_schematiseren/effectieve_kwelweglengte
+    achtergronden_schematiseren/polderpeilen_kwelkades
+    achtergronden_schematiseren/verdelingen_min_max
+
diff --git a/docs/achtergronden_schematiseren/effectieve_kwelweglengte.rst b/docs/achtergronden_schematiseren/effectieve_kwelweglengte.rst
@@ -0,0 +1,54 @@
+Effectieve kwelweglengte
+========================
+
+Voor het mechanisme piping is de effectieve kwelweglengte een belangrijke sterkte parameter.
+Afhankelijk van het gebruikte geohydrologische model wordt de kwelweglengte direct gedefinieerd of wordt deze afgeleid
+uit overige parameters.
+
+Zoals ook in :ref:`effectieve-voorlandlengte` is beschreven, maakt de kwelweglengte gebruik van het principe van de 
+effectieve voorlandlengte door:
+
+.. math::
+
+   L_{kwelweg} = L_{but} + L_{eff,voorland}
+
+   L_{eff,voorland} = \lambda_{1} \cdot tanh(\frac{L_1}{\lambda_{1}})
+
+   \lambda_{1} = \sqrt{c_{voorland} \cdot k \cdot D_{wvp}}
+
+waarin:
+
+- :math:`L_{eff,voorland}` de effectieve voorlandlengte is [m]
+- :math:`\lambda_{1}` de spreidingslengte van het voorland is [m]
+- :math:`c` is de deklaagdikte gedeeld door de doorlatendheid van de deklaag [dag]
+
+De effectieve kwelweglengte van het voorland ligt altijd tussen de buitenteen en de intredelijn en is 
+altijd gemaximaliseerd op de lengte van het voorland :math:`L_{1}`. 
+Daarom is het advies om de geografische ligging van de intredelijn :math:`L_{intrede}` zo te schematiseren dat de kweleglengte
+fysisch gezien nooit groter kan zijn. Hierbij kan je ook rekening houden met eventuele radiale weerstand, 
+bijvoorbeeld in het geval van een schaardijk.
+
+De weerstand van het voorland (en de daaruit volgende spreidingslengte) is een onzekere variabele die de weerstand over 
+een groot oppervlak van het voorland beschrijft. Zonder metingen is de kennisonzekerheid groot en vindt de schematisatie
+plaats op basis van ervaring en gebiedskennis. 
+
+Bij het gebruik van model 4a is het vaak niet nodig om apart voor de weerstand in het voorland meerdere scenario's te definiëren.
+De spreidingslengte wordt namelijk afgeleid uit de weerstand van de deklaag en de eigenschappen van het watervoerend pakket.
+Het gaat erom om dat de combinatie van variabelen past bij fysieke kenmerken van het voorland. 
+
+
+Omgang met verschillende scenario's
+-----------------------------------
+
+.. figure:: /_static/EffectieveVoorlandlengte_enkel_scenario.png
+   :width: 100%
+
+   Effectieve voorlandlengte bij een enkel scenario
+
+
+
+.. figure:: /_static/EffectieveVoorlandlengte_dubbel_scenario.png
+   :width: 100%
+
+   Effectieve voorlandlengte bij een dubbel scenario. De effectieve voorlandlengte wordt bepaald door de mate van 
+   weerstand in het voorland die per scenario kan worden opgegeven.
diff --git a/docs/achtergronden_schematiseren/hierarchie.rst b/docs/achtergronden_schematiseren/hierarchie.rst
@@ -0,0 +1,137 @@
+.. _achtergronden-schematiseren-hierarchie:
+
+Hiërarchie van invoerbronnen en detailniveaus
+=============================================
+
+GeoProb-Pipe combineert gegevens uit verschillende invoerbronnen om
+scenarioberekeningen uit te voeren. Daarbij kunnen dezelfde parameters op
+meerdere detailniveaus en vanuit verschillende bronnen beschikbaar zijn.
+
+Deze pagina beschrijft:
+
+* welke invoercategorieën door GeoProb-Pipe worden gebruikt;
+* hoe invoerwaarden worden georganiseerd binnen trajecten, vakken en uittredepunten;
+* hoe GeoProb-Pipe bepaalt welke waarde wordt gebruikt wanneer dezelfde parameter op meerdere niveaus of in meerdere bronnen aanwezig is.
+
+Door deze hiërarchie toe te passen kan zowel met een globale als een
+gedetailleerde schematisering worden gewerkt, waarbij de meest specifieke
+beschikbare invoer altijd voorrang krijgt.
+
+Invoercategorieën
+-----------------
+De schematisering bestaat uit drie categorieën invoer:
+
+Geometrische eigenschappen
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Deze gegevens worden via GIS-bestanden aangeleverd en beschrijven de ligging van het traject en de ruimtelijke kenmerken van de kering. Deze kunnen later via de excel of de geopackage (in de toekomst) worden aangepast. Hieronder vallen onder andere:
+
+-   trajectlijn;
+-   vakindeling;
+-   HRD-locaties;
+-   buitenteenlijn;
+-   binnenteenlijn;
+-   intredelijn;
+-   polderpeilen.
+
+Uittredepunten
+~~~~~~~~~~~~~~
+Uittredepunten worden aangeleverd als puntenbestand. Een uittredepunt beschrijft de locatie waarop een pipingberekening wordt uitgevoerd. Naast de locatie bevat een uittredepunt bijvoorbeeld informatie over:
+
+-   maaiveldhoogte ter plaatse van het uittredepunt.
+-   wordt gecombineerd met de geometrische gegevens om afstand tot de buitenteenlijn en binnenteenlijn te bepalen.
+
+Ondergrondscenario's
+~~~~~~~~~~~~~~~~~~~~
+Ondergrondscenario's worden aangeleverd via een Excelbestand. Hierin worden onder andere de ondergrondeigenschappen vastgelegd, zoals:
+
+-   top van de watervoerende zandlaag;
+-   dikte van de zandlaag;
+-   doorlatendheid (k-waarde);
+-   weerstand van het voorland (c-waarde).
+
+Deze drie categorieën vormen gezamenlijk de invoer voor een scenarioberekening. Elke scenarioberekening wordt uitgevoerd voor een specifieke combinatie van geometrie, uittredepunt en ondergrondscenario.
+
+Prioriteit van invoerwaarden
+----------------------------
+
+De invoercategorieën beschrijven welke gegevens beschikbaar zijn voor een
+scenarioberekening. Binnen iedere invoercategorie kunnen parameters op
+verschillende detailniveaus worden vastgelegd. Daarnaast kunnen parameterwaarden
+afkomstig zijn uit verschillende invoerbronnen.
+
+Voor het bepalen van de uiteindelijke invoerwaarde wordt daarom een vaste
+hiërarchie toegepast op zowel detailniveau als invoerbron.
+
+Detailniveaus
+~~~~~~~~~~~~~
+
+Parameterwaarden kunnen worden vastgelegd op de volgende detailniveaus:
+
+* Traject
+* Vak
+* Uittredepunt
+
+Hierbij geldt dat een meer specifiek detailniveau altijd voorrang heeft op een
+meer algemeen detailniveau.
+
+De prioriteitsvolgorde is daarom:
+
+::
+
+Uittredepunt > Vak > Traject
+
+Wanneer voor een parameter een waarde beschikbaar is op meerdere detailniveaus, wordt altijd de meest specifieke waarde gebruikt.
+
+Voorbeeld
+^^^^^^^^^
+
+Voor de parameter *top van de watervoerende zandlaag* zijn de volgende waarden
+beschikbaar:
+
+* Trajectniveau: -3 m + NAP
+* Vakniveau: -2 m + NAP
+* Uittredepuntniveau: niet ingevuld
+
+In dit geval wordt de waarde op vakniveau gebruikt, omdat er geen waarde
+beschikbaar is op uittredepuntniveau.
+
+Wanneer ook op vakniveau geen waarde beschikbaar zou zijn, wordt de waarde op
+trajectniveau gebruikt.
+
+Invoerbronnen
+~~~~~~~~~~~~~
+
+Afhankelijk van de invoercategorie kunnen parameterwaarden afkomstig zijn uit
+Excel of GIS.
+
+Excel vormt hierbij de primaire bron voor parameterwaarden.
+GIS levert aanvullende informatie, met name voor geometrische eigenschappen en
+uittredepuntinformatie.
+
+Binnen beide bronnen kan onderscheid worden gemaakt tussen:
+
+* Algemene waarden
+* Scenario-afhankelijke waarden
+
+De beschikbare combinaties zijn:
+
+::
+
+    Uittredepunten
+    ├─ Excel + Scenario's
+    ├─ GIS + Scenario's
+    ├─ Excel + Algemeen
+    └─ GIS + Algemeen
+
+    Vakken
+    ├─ Excel + Scenario's
+    └─ Excel + Algemeen
+
+    Traject
+    ├─ Excel + Algemeen
+    └─ Scenario's (nader te bepalen)
+
+Hierdoor wordt eerst bepaald op welk detailniveau een waarde beschikbaar is.
+Vervolgens wordt binnen dat detailniveau de juiste bron en invoercategorie
+gebruikt.
diff --git a/docs/achtergronden_schematiseren/polderpeilen_kwelkades.rst b/docs/achtergronden_schematiseren/polderpeilen_kwelkades.rst
@@ -0,0 +1,3 @@
+Schematiseren van polderpeilen
+==============================
+
diff --git a/docs/achtergronden_schematiseren/typen_ondergrondscenarios.rst b/docs/achtergronden_schematiseren/typen_ondergrondscenarios.rst
@@ -0,0 +1,23 @@
+Typen ondergrondscenario's
+==========================
+
+Een ondergrondscenario is een unieke verzameling van variabelen die de eigenschappen van de ondergrond beschrijven. 
+Ondergrondscenario's worden per vak of per uittredepunt vastgelegd. Specifiek voor het mechanisme piping zijn de 
+ligging en de eigenschappen van watervoerende zandlaag van belang. In hoofdlijn zijn er drie typen ondergrondscenario's:
+
+- Holoceen gefundeerd (HLF): Hierbij zit de deklaag boven een holocene zandlaag welke samen met de onderliggende 
+  pleistocene zandlaag het watervoerend pakket vormen.
+- Pleistoceen (PL): Hierbij ligt de deklaag direct boven op een pleistocene zandlaag.
+- Tussenzandlaag (TZ): Hierbij is er nog een tussenzandlaag aanwezig omsloten door de deklaag en een andere kleilaag. 
+  Deze is niet in direct contact met het pleistocene watervoerend pakket.
+
+Een kenmerk van ondergrondscenario's is dat ze elkaar uitsluiten. Ter plaatse van een uittredepunt komt of het ene 
+scenario voor binnen een vak of het andere. We kiezen er in deze implementatie voor om per vak een ondergrondscenario 
+vast te leggen. Dit betekent dat alle uittredepunten binnen een vak dezelfde (typen) ondergrondscenario's hebben. Wel 
+is het mogelijk om de eigenschappen van de ondergrond per uittredepunt te variëren. Dit overschrijft de eigenschappen 
+op vakniveau.
+
+.. figure:: /_static/TypenOndergrondscenario.png
+   :width: 100%
+
+   Voorbeeld typen ondergrondscenario's
diff --git a/docs/achtergronden_schematiseren/verdelingen_min_max.rst b/docs/achtergronden_schematiseren/verdelingen_min_max.rst
@@ -0,0 +1,39 @@
+Truncated verdelingen
+=====================
+
+In probabilistische berekeningen kunnen stochasten waarden aannemen die vanuit
+statistisch oogpunt mogelijk zijn, maar fysisch niet realistisch of zelfs
+onmogelijk. Dit komt met name voor bij normaal verdeelde variabelen, waarvan
+het theoretische domein onbegrensd is.
+
+Om te voorkomen dat dergelijke fysisch onmogelijke waarden worden gebruikt in
+de betrouwbaarheidsanalyse, kunnen stochasten worden begrensd door toepassing
+van een *truncated distribution*. Hierbij wordt een ondergrens (*minimum*) en
+een bovengrens (*maximum*) opgegeven. De kansmassa buiten deze grenzen wordt
+verwijderd en de overblijvende verdeling wordt opnieuw genormaliseerd. Hierdoor
+kunnen geen waarden meer worden getrokken buiten het fysisch plausibele bereik.
+
+Het toepassen van truncatie heeft twee voordelen:
+
+* Het voorkomt fysisch onmogelijke invoerwaarden tijdens de analyse.
+* Het kan leiden tot een realistischer ontwerp- en faalmechanisme wanneer het design point wordt gedomineerd door extreme waarden die in de praktijk niet kunnen voorkomen.
+
+Gebruik van truncatie
+---------------------
+
+GeoPob-Pipe hanteert standaard grenzen voor een aantal veelgebruikte stochasten.
+Deze grenzen zijn gebaseerd op praktische fysische aannames en dienen als
+eerste controle tegen onrealistische waarden.
+
+Tijdens een betrouwbaarheidsanalyse wordt aanbevolen om het design point te
+controleren. Wanneer blijkt dat één of meerdere stochasten in het design point
+waarden aannemen die fysisch niet plausibel zijn, kunnen de truncatiegrenzen
+worden aangescherpt. Hierdoor wordt de berekening beter afgestemd op het
+daadwerkelijke fysische gedrag van het systeem.
+
+De standaardwaarden vormen daarom geen vaste voorschriften, maar een hulpmiddel
+om onrealistische modeluitkomsten te voorkomen.
+
+#TODO tabel met min en max waarden toevoegen
+
+
diff --git a/docs/assembleren.rst b/docs/assembleren.rst
@@ -1,34 +1,36 @@
 Assembleren
 ===========
 
-Deze pagina beschrijft de assemblage van faalkansen binnen `GeoProb-Pipe`
-voor het faalmechanisme STPH (piping).
-De assemblage combineert lokaal berekende faalkansen op uittredepuntniveau
-tot faalkansen op vak- en trajectniveau.
-
-Samenvatting
-------------
-
-De assemblage start bij individuele scenario’s per uittredepunt, waarin
-meerdere faalmechanismen probabilistisch worden gecombineerd.
-Via opschaling met het lengte-effect worden faalkansen geaggregeerd naar
-vakniveau. Op trajectniveau worden vakkansen gecombineerd als een
-seriesysteem, zonder aanvullende opschaling.
-
-Het lengte-effect wordt uitsluitend toegepast bij de overgang van
-uittredepunt naar vak, waarmee dubbeltelling wordt voorkomen. De
-α-vector wordt niet gemiddeld of gecombineerd, maar steeds ontleend aan
-het onderliggende scenario, uittredepunt of vak dat de grootste bijdrage
-levert aan de totale faalkans, omdat α-vectoren niet lineair
-optelbaar zijn.
+De faalkans voor het faalmechanisme STPH (piping) van een dijktraject bestaat uit een seriesysteem van uittredepunten, 
+waarbij falen optreedt zodra één van de uittredepunten faalt. De trajectkans wordt mede bepaald door een onderlinge 
+afhankelijkheid tussen uittredepunten. 
+Deze probabilistische rekentechnieken zijn beschikbaar maar beperkt toegankelijk en rekenintensief, waardoor dit nog 
+niet is geïmplementeerd in GeoProb-Pipe.
+
+Als alternatief zijn er verschillende methoden ontwikkeld om de trajectkans te benaderen, rekening houdend  met de 
+veronderstelde lengte-effecten. Dit wordt ook wel assembleren genoemd. Deze assemblage van faalkansen is o.a.
+beschreven op de bottom-up assemblage door het Adviesteam Dijkontwerp in Rode Draad #10 :cite:`ADO2024Assembleren`.
+
+Deze sectie beschrijft de verschillende methoden die in GeoProb-Pipe zijn geïmplementeerd om de trajectkans te
+benaderen. Per onderdeel is aangegeven welke aannames er zijn gedaan om de methode toe te kunnen passen.
+
+De beschrijving start op scenarioniveau met de berekeningen die leiden tot een betrouwbaarheid van een enkele 
+scenarioberekening en eindigt bij de benadering van de trajectkans. Dit is opgedeeld in de volgende stappen:
+
+1. **Stap 0: Bepalen faalkans op scenarioniveau**
+2. **Stap 1: Bepalen faalkans per uittredepunt**
+3. **Stap 2: Bepalen trajectkans met meerdere benaderingsmethoden**
+
+
 
 .. toctree::
    :maxdepth: 2
    :caption: Inhoud
    :titlesonly:
 
-   assembleren/kader
+
    assembleren/stap0_sc
    assembleren/stap1_sc_up
-   assembleren/stap2_up_vak
-   assembleren/stap3_vak_tra
+   assembleren/stap2_vakkans_trajectkans
+   assembleren/resultaten
+
diff --git a/docs/assembleren/kader.rst b/docs/assembleren/kader.rst
diff --git a/docs/assembleren/resultaten.rst b/docs/assembleren/resultaten.rst
@@ -0,0 +1,9 @@
+Resultaten
+==========
+
+In de map ``export → results`` bevinden zich verschillende Excel-bestanden. Het bestand ``df_beta_traject`` geeft een
+overzicht van de resultaten van de hierboven benoemde methoden en bevat de vergelijking van de berekende trajectbeta’s.
+
+In de ``results`` map staan daarnaast de achtergrondresultaten van de WBI-methode.
+
+In de submap ``alternatieve methoden`` staan de achtergrondresultaten van de Window-methode en de individuele secties.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		Schematiseren van polderpeilen
		==============================