F.3.1 Installatie en instellingen Leidraad versie 2019 - RuudvandenWijngaart/VestaDV GitHub Wiki

De Leidraad versie van Vesta MAIS heeft een afwijkende installatie van de default-versie van Vesta MAIS. De stappen om de Leidraad versie jaargang 2019 te installeren worden in dit onderdeel uitgelegd. De systeemvereisten voor de Leidraad versie zijn hetzelfde als de default-versie van Vesta MAIS met uitzondering van de benodigde harddisk ruimte. Zie voor de systeemvereisten onderdeel B.1.

Installatie van Vesta MAIS Leidraad-versie jaargang 2019

Om de met de Leidraad-versie van Vesta MAIS te werken dienen de volgende stappen doorlopen te worden:

1. Aanmaken folderstructuur

Optioneel: De Leidraad-versie kan naast de default versie van Vesta MAIS geïnstalleerd worden, door dezelfde folderstructuur te gebruiken. Het aanmaken van een nieuwe folderstructuur is in principe niet nodig. Echter, om het overzicht te bewaren tussen de verschillende versies kan het handig zijn om een eigen nieuwe folderstructuur te maken voor de Leidraad-versie. Zie hiervoor de volgende stappen. Als je de default versie van het model niet hebt geïnstalleerd is het noodzakelijk om de volgende stappen doorlopen te worden.

  • Maak een hoofdfolder onder de root van de schijf (bijv. C:\) aan genaamd Vesta-Leidraad-2019 of kies een eigen gekozen naam en bovenliggende folderstructuur.
  • Maak in de folder Vesta-Leidraad-2019 de volgende folders aan: PD en LD. PD staat voor Project Directory en LD staat voor Local Data.

2. Installatie VestaDV-Leidraad-2019 project map:

  • Ga naar de 'VestaLeidraad2019' branch op de 'code' pagina van Github en klik op de groene knop "Clone or Download" en kies voor "Download zip".
  • Plaats de uitgepakte bestanden (de map VestaDV-VestaLeidraadOktober2019) in de map genaamd PD.

3. Installatie Vesta Leidraad 2019 SourceData:

  • Download de SourceData zip file van deze webpagina.
  • Pak deze bestanden uit in de Vesta-Leidraad-2019 hoofd-folder. Gebruik hiervoor zip-software zoals WinRAR of 7Zip. De standaard Windows zip-software werkt hiervoor niet (!). De zip-file is password-protected en kan worden opgevraagd bij het Vesta MAIS team van PBL (zie hiervoor onderdeel B.1). Het password is hetzelfde als bij de corresponderende default versie van Vesta MAIS (versie 4.0).
  • Na het uitpakken van de source data wordt de map Leidraad aangemaakt. Voor gemak hernoem deze map naar SourceDataLeidraad2019.

Na deze installatiestappen waarbij gebruik is gemaakt van de standaard paden dient de gehele folderstructuur er als volgt uit te zien:

  • Hoofdmap: C:\Vesta-Leidraad-2019
  • PD-map: C:\Vesta-Leidraad-2019\PD
  • LD-map: C:\Vesta-Leidraad-2019\LD
  • SourceData-map: C:\Vesta-Leidraad\SourceDataLeidraad2019

In de Windowsverkenner ziet dat er als volgt uit:

images/mapstructuur_vestaleidraad2019.jpg

Installatie GeoDMS software

GeoDMS wordt gebruikt als de grafische user interface (GUI) van het model. De Leidraad-versie van Vesta MAIS gebruikt een afwijkende GeoDMS versie in vergelijking met de default versie van Vesta MAIS. De volgende stappen dienen genomen te worden voor de installatie van GeoDMS:

  • Browse naar deze webpagina en selecteer: GeoDMS Version 7.182.
  • Klik vervolgens in het volgende scherm op x64 om GeoDMS te downloaden.
  • Kies tijdens de installatie van GeoDMS voor de default voorgestelde bestandslocaties indien er geen reden is om hiervan af te wijken.

images/setup_geodms7182.jpg

Installatie overige software en updaten van het model

De installatie van de Crimson Editor (ten behoeve van het raadplegen van de code) en Python (voor de verwerking van de resultaten) wijken niet af van de default versie van Vesta MAIS. Ook de handelingen voor het updaten van het model wijken niet af. Voor deze stappen verwijzen we je door naar pagina B.1 Installeren. Indien deze stappen al doorlopen zijn voor de installatie van de default versie van Vesta MAIS hoeven de stappen niet nogmaals doorlopen te worden.

Instellingen Aanpassen

Na installatie van de Leidraad-versie van Vesta MAIS dienen de juiste instellingen gekozen te worden. De onderstaande afbeeldingen laten de stappen zien die doorlopen dienen te worden om de instellingen aan te passen. Na openen van het bestand 'GeoDmsGui.exe' (versie 7.182) verschijnt de vrijwel lege GUI-interface.

  • Vervolgens dient een model file geopend te worden waarin de model configuratie waarden zijn opgeslagen. Kies voor de menu-optie 'File' en vervolgens in het uitklapmenu voor 'Open Configuration File'.

  • Browse naar het bestand 'S0_Referentie.dms', dit is te vinden onder C:\Vesta-Leidraad\PD\VestaDV-VestaLeidraad[datum]\Runs (indien gekozen is voor de geadviseerde padnamen bij installatie). Door deze file te selecteren open we het model met haar configuratie instellingen.

images/setup_config_geodms7182.jpg

  • Er verschijnt nu een zogenaamde containerstuctuur in de linkerzijde van de GUI. Kies vervolgens voor de menu-optie 'Tools' en vervolgens in het uitklapmenu voor 'Options'.

Check in het menu onder het tabblad 'General Settings' dat de volgende paden/instellingen goed staan:

  • Er dient een een vink te staan voor de opties: Administrator mode, TraceLogFile, Parallel Processing 1 (tile based), Show State Colors in TreeView, Suspend View Updates to favour GUI en PP2 (multiple calculation steps simultaneously).
  • De LocalDataDir dient te staan op: C:\Vesta-Leidraad\LD (indien niet is afgeweken van de geadviseerde paden).
  • De SourceDataDir dient te staan op: C:\Vesta-Leidraad\SourceDataLeidraad[datum] (indien niet is afgeweken van de geadviseerde paden).
  • Kopje External programs, DMS Editor: Het pad naar de executable van de Crimson Editor. Dit pad wordt als volgt: C:\Program Files (x86)\Crimson Editor\cedt.exe /L:%L "%F"

images/setup_options_geodms7182_nieuw.jpg

  • Vervolgens dient er op de OK-knop te worden gedrukt, dan popt waarschijnlijk de melding op "new LocalDataDir only becomes active after restarting the GeoDMS". Sluit de GUI af met het zwarte kruisje in de rechterbovenhoek. GeoDMS dient vervolgens opnieuw te worden opgestart (zie wederom de eerste stap).

Als laatste stap moet een kleine aanpassing gemaakt worden in het bestand Vergelijking.dms ten behoeve van het gebruik van de gewenste 'Configuration settings' in GeoDMS. Hierbij moeten de volgende stappen worden doorlopen:

  • Open Vergelijking.dms. Dit bestand is te vinden onder het volgende pad: C\Leidraad-Vesta\PD\VestaDV-VestaLeidraadOktober2019\CombineerRuns\Vergelijking.dms
  • Voeg onder de container 'Vergelijking' de volgende regel code toe: #include <%projDir%/model/ConfigSettings.dms>

images/setup_configsettings_vergelijking.jpg

Testen of alles werkt

Voer de volgende stap uit om het model te testen:

  • Browse in de containerstructuur naar: /Invoer/RuimtelijkeData/WarmteBronnen/RestWarmte/BronSelecties/StartJaar/Bronnen/TypeInfoList_rel (dubbelklik of CTRL+M).

Als het goed is verschijnt de kaart zoals in de onderstaande afbeelding. Indien dit niet het geval is, het betreffende containeritem is dan rood, is dat een teken dat er iets niet goed is gegaan. Een veel voorkomend probleem is bijvoorbeeld dat het pad naar de SourceData niet goed staat. Er verschijnen dan meldingen bij het openen van containteritems zoals "Error reading geographic reference info from" of "Cannot read data from .... because DBF Error: Cannot open .... for read (2: No such file or directory)". Voor andere issues zie onderdeel B.3. Als de containeritems goed kunnen worden geopend (er verschijnt een kaart of tabel) kan er daadwerkelijk met het model gewerkt worden.

images/setup_testwarmtebronnen_geodms7182_nieuw.jpg