B.3 Problemen - RuudvandenWijngaart/VestaDV GitHub Wiki

In dit onderdeel worden de handelingen uitgelegd wanneer een gebruiker problemen ondervind met het Vesta MAIS-model. De gebruiker dient eerst te kijken of het probleem wordt veroorzaakt door te veel cached data en local data. Indien dit het probleem niet oplost dient de gebruiker te kijken naar de problemen omschreven onder het kopje bekende issues. Hier wordt een groot deel van de problemen die gebruikers ondervinden behandeld. Indien het ondervonden probleem niet overeen komt met het overzicht, dient de gebruiker de handelingen te volgen onder het kopje overige issues.

CalcCache en local data legen

Wanneer de gebruiker een foutmelding krijgt is het altijd een goede om eerst te kijken of de Calcache en local data directory (LD) niet vol zit. Wanneer de gebruiker bijvoorbeeld een aanpassing doet in het energieprijzenbestand dan moet de CalCache eerst verwijderd worden voor opnieuw gerekend kan worden met Vesta MAIS. Ook voor andere aanpassingen is het handig om de CalCache en de local data directory even leeg te gooien (locatie bij standaard installatie: C:/Vesta/LD/)

Bekende issues

Hierbij volgt een overzicht van de bekende issues bij het installeren van en het werken werken met Vesta MAIS en de GeoDMS software:

  • Foutmelding bij eerste keer starten van de GeoDmsGui.exe (na installatie): The program can't start because api-ms-win-crt-runtime-l1-1-0.dll is missing from your computer. Zie hiervoor de volgende website .

  • Brondata kan niet worden gelezen: Na het openen van de GeoDMSGUI met het Vesta MAIS project en het opvragen van brondata worden items rood en verschijnen foutmeldingen over het niet kunnen lezen van data. Zie hiervoor de volgende website .

  • Vesta MAIS draait al: Er kan 1 versie van Vesta MAIS (GUI or Batch) tegelijk draaien, als meerdere versies worden opgestart verschijnt een foutmelding over een gelockte CalcCache.

  • Sommige virusscanners kunnen de werking van Vesta MAIS verstoren (bijvoorbeeld Avast Antivirus).

  • Voor de volledige lijst met known issues voor de GeoDMS, zie hiervoor d volgende website

  • Het inlezen van csv-bestanden in Excel gaat fout: Het decimale scheidingsteken in de .csv bestanden is altijd een punt. Dit geeft problemen indien het scheidingsteken van het systeem niet is ingesteld op een punt (maar bijvoorbeeld een komma). Dit is het geval bij sommige landinstellingen van het operating system zoals "Dutch (Netherlands)". Er zijn twee mogelijke oplossingen:

  1. Zorg ervoor dat het operating system de punt als decimaal scheidingsteken hanteert. Bij Windows 10 gaat dit als volgt. Ga naar 'Windows System', 'Control Panel', 'Region', het tabblad 'Formats' en zet het format op 'English (United States)'. Excel hanteert dan automatisch de punt als decimaal scheidingsteken. Zie de eerste onderstaande afbeelding.
  2. Zorg ervoor dat Excel de punt als decimaal scheidingsteken hanteert (het operating system hoeft dan niet te worden aangepast). Als voorbeeld hoe je dat kan doen gaan we hier uit van versie Excel 2016. De instellingen in versie Excel 2016 kun je wijzigen onder Options, Advanced. Vink 'Use system seperators' uit en kies als 'Decimal separator' de punt en voor de 'Thousands seperator' de komma. Zie de tweede onderstaande afbeelding.

images/decimale_scheidingsteken_landinstellingen_windows10.jpg

images/decimale_scheidingsteken_in_excel.jpg

Overige issues

Naast de bekende issues is het natuurlijk mogelijk dat een gebruiker problemen tegen het lijf loopt die hier niet beschreven staan. Dit kunnen verschillende soorten type problemen zijn. Om te zorgen dat gebruikers niet altijd afhankelijk zijn van het PBL is er binnen GitHub een ‘Issue’ pagina. Deze is te vinden op het tabblad van GitHub naast 'Code'.

Forum

Het idee van deze issue-pagina is om gebruikers de mogelijkheid te geven om vragen te stellen over verschillende problemen die kunnen spelen bij het rekenen met Vesta MAIS. Een PBL-medewerker en/of ander gebruikers uit de Vesta MAIS-community zal dan reageren op dit probleem, waarbij zijn/haar antwoord ook op de issue-pagina komt te staan. Op deze manier kan een volgende gebruiker met hetzelfde probleem de oplossing gelijk vinden en hoeft deze geen antwoord van het PBL of de Vesta MAIS-community af te wachten. Op deze manier kan de issue-pagina als een soort Frequently Asked Questions (FAQ) pagina fungeren. Echter, voordat je een vraag stelt, controleer of de vraag niet al eerder is gesteld door een andere gebruiker. Een overzicht van alle forumregels is te vinden op de issuepagina.

TraceLogFile

Indien er iets fout gaat in het model kan je sneller geholpen worden op het forum door de TraceLogFile te delen. De TraceLogFile is een bestandje dat bijhoud welke paden je opent binnen de GUI. Indien er foutmeldingen voorkomen tijdens het navigeren in de GUI worden ze 'gedocumenteerd' in de TraceLogFile. Om de TraceLogFile te activeren ga je binnen de GUI naar 'Options'/'General settings' en dient er een vinkje geplaatst te worden bij TraceLogFile (zoals beschreven in onderdeel B.2 Instellingen aanpassen en controle na installatie. De TraceLogFile wordt opgeslagen in de %LocalDataDir%\trace.log.

Mantis

Om op de hoogte te blijven van de laaste ontwikkelingen met betrekking tot bug-fixes en model-updates kan Mantis gebruikt worden. Mantis is een bug tracker programma. Om gebruik te maken van Mantis is authorisatie noodzakelijk. Voor geautoriseerde gebruikers, navigeer naar de volgende link.