What-if functionaliteit in het NWM biedt de gebruiker de mogelijkheid om interactief (via de GUI; What-if Scenario display, zie Figuur WIF.2) veranderingen door te voeren in een model data sets, bijvoorbeeld om wijzigingen in de model parameters aan te brengen of wijzigingen in de schematisatie (Let op: bij schematisatie wijzigingen moet de gebruiker bedenken dat de wijziging impact kan hebben op de koppeling met NWM en andere modellen binnen het NWM; in dat geval kunnen aanvullende (configuratie) aanpassingen nodig zijn). Deze what-if functionaliteit is vooralsnog alleen geimplementeerd voor Zoetwater (en nog niet voor Veiligheid). Op deze pagina wordt uitgelegd hoe de what-if functionaliteit gebruikt moet worden in het Nationaal Water Model. Als voorbeeld is het LHM model genomen, maar de functioanliteit werkt ook voor de andere Zoetwater modellen (LSM, NDB, LTM).
Er zijn twee opties die hieronder uitgelegd worden, te weten "Gebruik van een What-if scenario" en "Geadvanceerd gebruik van een What-if scenario".
Gebruik van een What-if scenario voor Zoetwater modellen (zonder scenario.xml)
- Plaats een zip-file met de nieuwe data files op de server onder D:\what_if_scenarios (see Figuur WIF.1.): Deze nieuwe files zullen de bestaande files van een schematisatie overschrijven bij de prepossessing stap van het LHM model.
Gebruik geen spaties in de naam van de gezipte file!
De zip-file moet op dezelfde server staan waar de FSS gehost is die de LHM-workflow in combinatie met het what-if scenario zal draaien. Bijvoorbeeld, in de Deltares' Testomgeving kan de FSS benaderd worden via 'Remote Desktop Connection': aw-fs041.xtr.deltares.nl (met FSS00 t/m FSS04) of aw-fs042.xtr.deltares.nl (met FSS05 t/m FSS09).
In het zip-bestand kan of beter moet ook een README.txt opgeslagen worden (of andere *.txt files, bijvoorbeeld met een beschrijving, naam, datum, etc) waarin een korte beschrijving van het what-if scenario opgenomen kan worden. Om archivering van deze files te garanderen, moet de filenaam de extensie ".txt" hebben.
Figuur WIF.1.: Place zip-folder in d:\what_if_scenario
- Ga naar de OC (Operator Client) van het NWM
- Open hetWhat-if scenario display via Menu/Extra/What-If Scenario (of Ctrl + W, Tool symbol)
- Maak een nieuw scenario (met button Nieuw scenario aanmaken..)(see Figuur WIF.2.); de naam van het scenario moet identiek zijn aan de naam van de gezipte file in D:\what_if_scenarios at the server (zonder extensie .zip), die gegenereerd was in de eerste stap. Indien nodig kan een beschrijving van het nieuwe scenario nu nog toegevoegd worden.
Figuur WIF.2.: What-if Scenario display
- Specifeer het scenario met tab 5:Properties (zie Figuur WIF.3.)
- selecteer van het File_path drop-down menu de regel D:\what_if_scenarios
Figuur WIF.3.: Select file_path
- Sla het scenario op onder button Bewaar alles
- met de button Beheren.. kan het scenario gewijzigd of gedeletet worden
- Start de LHM run
- via Starten workflow display:
- Specifeer taak (selectie van de uit te voeren workflow)
- Specifeer what-if scenario via What-if scenario drop-down menu (zie Figuur WIF.4.)
Figuur WIF.4.:Start workflow
- via interactive forecasting display:
- Specifeer taak (selectie van de uit te voeren workflow) in het interactive forecast display
- Zet taak opties (button Taak uitvoer opties)
- Specifeer what-if scenario via What-if scenario drop-down menu (zie Figuur WIF.5.)
Figuur WIF.5.: Interactief forecast display
- via Starten workflow display:
Geavanceerd gebruik van een What-if scenario voor Zoetwater modellen (met scenario.xml)
Met behulp van file scenario.xml heeft de gebruiker meer flexibiliteit in de naam van het gezipte bestand en de directory waar what-if scenario's gedefinieerd worden. De vereiste stappen worden hieronder opgesomd, waarbij alleen de verschillen met het hierboven beschreven scenario genoemd worden:
- Plaats een zip-file met de niewe data files ergens op de server
- Maak een scenario.xml on de eigen lokale pc (bijv.. ScenariosA.xml of zie Figuur WIF.6.):
- Bepaal een scenario naam (deze kan verschillen van de zip-folder naam) onder name
- Bepaal het scenario id (als de id al in gebruik is in het system, dan volgt er een warning tijdens import (zie Figuur WIF.7.)) onder id
- Bepaal het absolute pad en de naam van de geuploadede zip-file onder value
Figuur WIF.6.: Voorbeeld van scenario.xml
Figuur WIF.7.: Warning by same IDs - Importeer het scenario.xml via button Importeer... of het what-if display:
- Ga naar tab 5:Properties and selecteer uit het File_path drop-down menu de juiste regel met de verwijzing naar de nieuwe directory en bestandsnaam
- Sla het scenario op met de button Bewaar alles...
- Gebruik het scenario met de eerder gespecificeerde naam en start de workflow.
Informatie voor gebruik van What-ifs voor andere modelen
In principe zijn de werkstappen voor het gebruik van de what-ifs voor alle modellen hetzelfde. Er zijn alleen verschillen in de bestanden die kunnen overschrijven worden. Het zijn allemaal statische model bestanden. Volgende tabel geeft een overzicht in welke mappen de bestanden van de zip-file gekopiëerd worden.
Model | Map |
---|---|
LHM | \Modules\NHIxxx\tmp |
LSM_LT | \Modules\SOBEK_LSM_LT\S0\AllScenarios\LSMLt1_2.Lit\1\ |
NDB | \Modules\Sobek_ndb\modeldata |
LTM | \Modules\WAQ_LSMLT\\CASE\WAQ_LSMLT\Modeldir\ |
Voorbereiden basis bestanden voor What-ifs
Via de OC is het mogelijk om de basis bestanden die het model gebruikt voor een 'default' berekening (zonder actieve What-if scenario) klaar te zetten met behulp van een workflow in de Interactive display onder 'Prepare Zoetwater files', zie Figuur WIF.8. Bij het uivoeren van deze workflow worden de modelbestanden in het OpenDap-archive in een zip-bestand (gemarkeerd met _data_) klaargezet. Deze bestanden zijn de basis waarop de gebruiker zijn/haar what-if scenario moet baseren: dwz. door een of meerdere van deze bestanden aan te passen en aan te bieden als what-if zip-file.
Figuur WIF.8.: Generen van de basis bestanden is mogelijk via de OC.
Overzicht volgorde LHM preprocessing stappen
De stappen die binnen de NWM component "LHM" achtereenvolgens worden uitgevoerd binnen het Delft-FEWS systeem zijn:
Verwijderen van alle niet-gezipte bestanden en het daarmee leegmaken van de LHM modelomgeving.
- Uitpakken LHM modelbestanden.
Importeren van model-states.
Klaarzetten van NDB chlorideconcentraties.
Resampling KNMI OpenDap data.
Draaien LHM preprocessing scripts met bijbehorende ini-file.
Hieronder zijn de eerste twee stappen verder uitgewerkt. De stappen 3 t/m 6 hebben geen subtaken en zijn daarom niet in meer detail uitgewerkt.
1. Verwijderen van alle niet-gezipte bestanden en het daarmee leegmaken van de LHM modelomgeving:
De volgende bestanden en/of mappen worden verwijderd voordat een LHM simulatie wordt uitgevoerd zijn te vinden in dit bestand.
2. Uitpakken LHM modelbestanden:
Het uitpakken van de LHM modelbestanden gebeurt in de volgorde:
- Modeldata.zip --> %ROOT_DIR%\tmp
- Preprocessing.zip --> %ROOT_DIR%
- Postprocessing.zip --> %ROOT_DIR%\postprocessing
- Script.zip --> %ROOT_DIR%
- Klimaat scenario ($climate$$climateyear$.zip) --> %ROOT_DIR%\tmp
- Socio-economisch scenario ($socioeconomic$$climateyear$-socecon.zip) --> %ROOT_DIR%\tmp
- S0, S1, S2, S3 ($measure$-$socioeconomic$$climateyear$.zip) --> %ROOT_DIR%\tmp
Voorbeeld van een specifiek scenario:
Modeldata.zip –> preprocessing.zip –> postprocessing.zip –> script.zip –> WH2050.zip –> Druk2050-socecon.zip –> S0-Druk2050.zip