Workflows starten

In het NWM kunnen workflows op een snelle en eenvoudige wijze gestart worden, maar is het ook mogelijk voor de expert gebruiker om een workflow eerst naar zijn of haar voorkeur aan te passen en dan pas te starten. Een workflow is een set van één of meerdere taken die automatisch uitgevoerd worden na het activeren van de workflow, waarvan bijvoorbeeld een berekening of het exporteren van data er één van kan zijn. Naast de beschrijving van deze manieren om workflows te starten, wordt in dit hoofdstuk ook ingegaan op het starten van meerjarige berekeningen.

1.3.1 Standaard

Er zijn twee manieren waarop een workflow snel opgestart kan worden: via het tabblad Interactive en via het Topology scherm.

Het tabblad Interactive staat automatisch open bij het opstarten van het NWM en is altijd in en uit te klappen via de knop Interactive aan de linker bovenkant van het scherm (figuur 1.1). Het Topology scherm kan geopend worden door de Topology knop in de buttonbar aan te klikken (figuur 1.2), via het menu <Extra>, <Topology>, of via de shortcut <Ctrl+T>.

In het tabblad Interactive staan de workflows in folders geordend per onderdeel, dan per gebied en als laatste per scenario. Zo is bijvoorbeeld in figuur 1.3 (1) de workflow 'Importeer randvoorwaarden' geselecteerd, waarbij te zien is dat deze workflow zich bevindt in de scenario folder '2015 - referentie'14', de gebiedsfolder 'Rijn' en de onderdeel folder 'Veiligheid'.

Na het selecteren van een workflow kunnen de T0 (figuur 1.3 (2)), Initial state en Forecast length worden aangepast en kan een omschrijving aan de workflow worden meegegeven. De Initial state, Forecast length en omschrijving bevinden zich in het pop up scherm Taakuitvoer opties (figuur 1.3 (3)). Voor zowel het onderdeel Veiligheid als het onderdeel Zoetwater zijn de T0, Initial state en Forecast length op de juiste datum-tijd gezet. Deze standaard instellingen zijn te controleren met de Testwaarden tabel op de Testwaarden pagina, welke onderdeel is van de Testprotocollen en terug te vinden is op de wiki van het NWM. Het instellen of aanpassen van de initial state en forecast length is in principe alleen bedoeld voor het uitvoeren van testsommen, bijvoorbeeld voor het draaien van kortere runs dan de standaard instellingen. We raden aan om in de omschrijving van de workflow de versie van het NWM op te nemen. Het is dan altijd duidelijk met welke versie van het NWM de berekeningen zijn gedraaid. In het geval er een workflow wordt gedraaid waarin de resultaten van het NWM geëxporteerd worden en de NWM versie waarmee de berekeningen zijn gedraaid afwijkt van de NWM versie waarmee de export wordt gedraaid zal dit aan de beheerder van het Archief moeten worden doorgegeven. Deze persoon kan dan de versie in de geëxporteerde NetCDF file aanpassen. De geëxporteerde NetCDF file krijgt namelijk de huidige NWM versie mee en dus niet automatisch de versie waarmee de berekeningen zijn gedraaid. Voor meer informatie over het Archief zie 1.4.2.1 Het Archief (Geonetwork).

Zodra de gewenste workflow geselecteerd is en de juiste T0, initial state en forecast length ingevoerd zijn, kan de workflow gestart worden. Start een workflow door deze te selecteren en vervolgens op de knop 'Uitvoeren geselecteerd segment(groep)' te klikken (figuur 1.3 (4)), of gebruik de shortcut <Shift+F9>.  

Elke scenario folder bevat meerdere workflows en sommige workflows hebben input van andere workflows uit dezelfde scenario folder nodig om te kunnen draaien. Indien de benodigde input voor een bepaalde workflow ontbreekt, verschijnt er een waarschuwingsscherm (figuur 1.4) en wordt de workflow niet gestart. Hoe de workflows met elkaar samenhangen, is terug te vinden in het Topology scherm (figuur 1.5). Wanneer in dit scherm een blok met een ander blok verbonden is door middel van een pijl, dan betekent dat dat de output van het blok aan de staartkant van de pijl noodzakelijk is voor het starten van het blok aan de puntkant van de pijl. Zo is bijvoorbeeld de output van de workflow LHM noodzakelijk voor het draaien van de workflow Export BIVAS. Met een dubbele muisklik op het workflowblok kan een workflow ook vanuit dit scherm gestart worden. In- en outzoomen in dit scherm kan door aan het muiswieltje te draaien.

Welke workflows beschikbaar zijn is weergegeven in tabel 1.1 voor Zoetwater en tabel 1.2 voor Veiligheid. Wat er in elke workflow gebeurt staat verder uitgewerkt in de hoofdstukken Zoetwater  en Veiligheid.

Meer informatie over het tabblad Interactive en het Topology scherm is terug te vinden in het hoofdstuk Interactive Forecasting Displays van de Delft-FEWS User Guide.

Figuur 1.3. De volgorde van handelingen voor het starten van een workflow: 1. Het selecteren van een workflow, 2. Eventueel aanpassen van de T0, 3. Eventueel aanpassen van de initiële condities en forecast length en het toevoegen van een omschrijving, 4. Starten van de workflow.

Figuur 1.4. Waarschuwingsscherm ontbrekende invoer.

Figuur 1.5. Het topology scherm.

Tabel 1.1. De workflows van Zoetwater. De beschikbaarheid van een worflow is met een groen vinkje aangegeven.
Zoetwater	Landelijk
LHM
export LHM data
LSM Light
Export BIVAS
Export VONK
Export other LSM Light data
LSM
LTM
Export KRW Verkenner
Export LSM data

1.3.2 Expert

Het scherm 'Starten workflow' wordt geopend door de knop 'Starten workflow' in de buttonbar (figuur 1.9) aan te klikken, of via het menu <Extra>, <Starten Workflow>, of via de shortcut <Ctrl+M>. De mogelijkheid om een workflow aan te passen en op te starten via het scherm 'Starten workflow' is niet bedoeld voor de standaard gebruiker, maar voor de expert gebruiker en wordt hier beperkt toegelicht. Het selecteren van een workflow kan middels het dropdown menu onder <Taak>. Verder kan de T0 en de begintoestand van de workflow worden ingesteld. Optioneel kan een omschrijving aan de taak worden meegegeven. Door op 'Uitvoeren' te klikken wordt de taak gedraaid.

NB. Voor Zoetwater geldt dat een berekening altijd voor hele jaren (1 januari tot 1 januari) moet worden uitgevoerd.

Meer informatie over het starten van workflows in het 'Start workflow' scherm is te vinden in het hoofdstuk Manual Forecast Display van de engelstalige Delft-FEWS gebruikershandleiding.

Figuur 1.6. Scherm voor het aanpassen van workflows.

1.3.3 Meerjarige berekeningen starten

In het NWM kunnen ook meerjarige berekeningen uitgevoerd worden. Dit type berekeningen moet voorgedenifinieerd worden met een XML script (figuur 1.7). Wanneer een XML script klaar is voor gebruik, kan deze met de knop 'Voorbereide taak uitvoeren..' in het 'Starten workflow' scherm geselecteerd en vervolgens uitgevoerd worden. Standaard staat een set aan XML scripts klaar voor meerjarige berekeningen voor Zoetwater. Voor een overzicht van deze scripts zie tabel 1.3.

In afwachting van de tool

Figuur 1.7. Stuk uit een XML script voor een meerjarige taak.