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 van de 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 specifiek geimplementeerd voor Zoetwater. 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".
De eerste (voorbereidende) stap is om de basis modelbestanden vanuit de NWM omgeving klaar te zetten; het what-if scenario moet op deze gebaseerd worden, zie Voorbereiden basis bestanden voor What-ifs, dit om te voorkomen dat er onbedoelde modelwijzijgingen worden toegepast.
Voorbereiden basis bestanden voor What-ifs Anchor Voorbereiden basis bestanden voor What-ifs Voorbereiden basis bestanden voor What-ifs
Via de Operator Client 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.1. 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. Dit is alleen geimplementeerd voor LHM, omdat voor dit model een aantal preprocessing stappen worden uitgevoerd voordat de berekening start (zie Overzicht volgorde LHM preprocessing stappen). De overige modellen kunnen uit het archief worden gedownload (zie Geëxporteerde resultaten downloaden).
Figuur WIF.1.: Generen van de basis bestanden is mogelijk via de OC.
Voorbeeld van aanpassen bestand (CASE LHM):
Anchor Gebruik_What-if_scenario Gebruik_What-if_scenario
Gebruik van een What-if scenario voor Zoetwater modellen (zonder scenario.xml)
Gebruik_What-if_scenario | |
Gebruik_What-if_scenario |
- Plaats een zip-file met de nieuwe data files op de server onder
In deze paragraaf staat uitgelegd hoe gebruik gemaakt kan worden van de What-if functionaliteit binnen het Nationaal Water Model.
Algemeen
With the What-if functionality in the NWM the user can interactively (via the GUI) change the model data sets, that means testing for example a new schematisation of the model. Within the current version what-if functionality is tested and implemented for ZW. In the follwoing section it will be described how to do it for the LHM model. However, similar steps have to be done to use what-if for other ZW models.
Use of What-if in ZW (without use of scenario.xml)
- Place a zip-file with the new data files at the server under D:\what_if_scenarios : These new files overwrite during the LHM prepossessing the existing files of the base schematisation. Do not use any spaces within the folder name! The mentioned zip-folder has to be at the same server, where the FSS is hosted which will run the LHM-workflow in combination with what-if scenario. Besides the new model data files also a README.txt or other informative files (e.g. description, name, date etc) can be stored here. To ensure that these files are also archived the filename extension must be .txt.
(see Figuur WIF.5.): Deze nieuwe files zullen de bestaande files van een schematisatie overschrijven bij de prepossessing stap van het LHM model.
Let op: 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.5.: Place zip-folder in d:\what_if_scenario
- Ga naar de OC (Operator Client) van het NWM
- Open hetWhat
- Go to OC (Operator Client) of the NWM
- Open the What-if scenario display via Menu/Extra/What-If Scenario (or of Ctrl + W, Tool symbol)
- Make a new Maak een nieuw scenario (with met button Nieuw scenario aanmaken..; zie Figuur WIF.6.); the name of the scenario has to be the same as from the zip-folder (without extension) which was generated within the first step; if required set a new scenario description
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.6.: What-if Scenario display
- Specifeer het scenario met tab 5:Properties (zie Figuur WIF.7.)
- selecteer van het
- Specify the scenario with tab 5:Properties
- select from the File_path drop-down menu the line de regel D:\what_if_scenarios
Figuur WIF.7.: Select file_path
- Sla het scenario op onder save the scenario with the button Bewaar alles
- with the met de button Beheren.. you can delete or modify the scenario kan het scenario gewijzigd of gedeletet worden
- Start the de LHM run
- via Starten workflow display:
- Specifeer taak (selectie van de uit te voeren workflow)
- Specifeer
- Specify task (base schematisation)
- Specify what-if scenario via wat-als drop What-if scenario drop-down menu (zie Figuur WIF.8.)
Figuur WIF.8.:Start workflow
- via interactive forecasting display:
- Specify task (base schematisationSpecifeer taak (selectie van de uit te voeren workflow) in the het interactive forecast display
- Set task options Zet taak opties (button Taak uitvoer opties)
- Specify Specifeer what-if scenario via wat-als drop What-if scenario drop-down menu (zie Figuur WIF.9.)
Figuur WIF.9.: Interactief forecast display
- via Starten workflow display:
Use of What-if in ZW (with use of scenario.xml)
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.
Exporteren NDB chlorideconcentraties.
Resampling KNMI OpenDap data.
Draaien LHM preprocessing scripts met bijbehorende ini-file.
Hieronder zijn de eerste twee stappen verder 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:
Anchor Geavanceerd_gebruik_What-if_scenario Geavanceerd_gebruik_What-if_scenario
Geavanceerd gebruik van een What-if scenario voor Zoetwater modellen (met scenario.xml)
Geavanceerd_gebruik_What-if_scenario | |
Geavanceerd_gebruik_What-if_scenario |
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.10.):
- 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.8.)) onder id
- Bepaal het absolute pad en de naam van de geuploadede zip-file onder value
Figuur WIF.10.: Voorbeeld van scenario.xml
Figuur WIF.11.: 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 modellen
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 overschreven worden. Het zijn allemaal statische model bestanden. Volgende tabel geeft een overzicht in welke mappen de bestanden van de 'what-if' zip-file gekopiëerd worden. Momenteel kan alleen voor 'LHM zonder zout' de actuele inhoud van de model map worden geëxporteerd. Voor de overige modellen kunnen gewijzigde bestanden tbv what-if wel worden opgepakt, maar kan het origineel (waarop de what-if gebaseerd zal worden) verkregen worden uit een recent gearchiveerde modeldataset (zie Data-opslag).
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_SOW\Modeldir\ |
Modeldata.zip –> preprocessing.zip –> postprocessing.zip –> script.zip –> WH2050.zip –> Druk2050-socecon.zip –> S0-Druk2050.zip