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.

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).

Image Added

Figuur WIF.1.: Generen van de basis bestanden is mogelijk via de OC.

Voorbeeld van aanpassen bestand (CASE LHM):

Image Added

Image Added

Image Added

Anchor
Gebruik_What-if_scenario Gebruik_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

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-folder 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.
  Image Removed(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.
  
  Image Added
  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
  Image Removed 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.
  
  Image Added
  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
  
  Image Modified
  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.)
        
        Image Modified
        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.)
        
        Image Modified
        Figuur WIF.9.: Interactief forecast display
        
        

...

Anchor
Geavanceerd_gebruik_What-if_scenario Geavanceerd_gebruik_What-if_scenario

Geavanceerd gebruik van een What-if scenario voor Zoetwater modellen (met scenario.xml)

With help of the scenario.xml the user can provide a more flexible way of defining what-if scenarios. The steps are described in the following (just changes to the steps described above are explicitly mentioned):

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
  
  Image Added
  Figuur WIF.10.: Voorbeeld van scenario.xml
  
  Image Added
  Figuur WIF.11.: Warning by same IDs
  
  
• Importeer het
• Place a zip-folder with the new data files somewhere at the server
• Prepare a scenario.xml on your local machine (e.g. ScenariosA.xml):
  • Set the scenario name (it can be different from the zip-folder name) under name
  • Set the scenario id (if the id is already used in the system a warning will occur during import) under id
  • Set the absolute path and name of the uploaded zip-folder under value
    Image Removed
    Image Removed
• Import the scenario.xml via button Importeer... of the het what-if display:
  • Go to Ga naar tab 5:Properties and select from the selecteer uit het File_path  drop-down menu the line with the new path and filenamede juiste regel met de verwijzing naar de nieuwe directory en bestandsnaam
  • Sla het scenario op met de save the scenario with the button Bewaar alles...
• Use the scenario as mentioned above in your workflow

Overzicht volgorde LHM preprocessing stappen

De stappen die binnen de NWM component "LHM" achtereenvolgens worden uitgevoerd binnen het Delft-FEWS systeem zijn:

Image Removed

1. Verwijderen van alle niet-gezipte bestanden en het daarmee leegmaken van de LHM modelomgeving.

2. Uitpakken LHM modelbestanden.

3. Importeren van model-states.

4. Exporteren NDB chlorideconcentraties.

5. Resampling KNMI OpenDap data.

6. 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:

1. Modeldata.zip --> %ROOT_DIR%\tmp
2. Preprocessing.zip --> %ROOT_DIR%
3. Postprocessing.zip --> %ROOT_DIR%\postprocessing
4. Script.zip --> %ROOT_DIR%
5. Klimaat scenario ($climate$$climateyear$.zip) --> %ROOT_DIR%\tmp
6. Socio-economisch scenario ($socioeconomic$$climateyear$-socecon.zip) --> %ROOT_DIR%\tmp
7. S0, S1, S2, S3 ($measure$-$socioeconomic$$climateyear$.zip) --> %ROOT_DIR%\tmp

Voorbeeld van een specifiek scenario:

• 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).

 Modeldata.zip –> preprocessing.zip –> postprocessing.zip –> script.zip –> WH2050.zip –> Druk2050-socecon.zip –> S0-Druk2050.zip