Plug-in eVis¶

Start de module Event Browser¶

Klik op Database ‣ eVis ‣ eVis Event Browser om de module Event Browser te starten. Dit zal het venster Event Browser openen.

Het venster Event Browser heeft drie tabs die worden weergegeven aan de bovenzijde van het venster. De tab Tonen wordt gebruikt om de foto te bekijken en de daaraan geassocieerde gegevens van de attributen. De tab Opties verschaft een aantal instellingen die kunnen worden aangepast om het gedrag van de plug-in eVis te beheren. tenslotte wordt de tab Configureren externe applicaties gebruikt om een tabel met bestandsextensies en de daarn geassocieerde programma’s te onderhouden om eVis in staat te stellen andere documenten dan afbeeldingen weer te geven.

Begrijpen van het venster Tonen¶

Klik op de tab Tonen in het venster Event Browser om het venster Tonen te zien. Het venster Tonen wordt gebruikt om geo-gecodeerde foto’s en hun geassocieerde gegevens voor attributen te bekijken.

Figure eVis 1:

Het eVis venster Tonen

1. venster Tonen: Een venster waar de foto zal verschijnen.

2. knop Inzoomen: Zoom in om meer detail te zien. Als niet de gehele afbeelding kan worden weergegeven in het venster Tonen zullen schuifbalken aan de linker- en onderzijde van het venster verschijnen om u in staat te stellen u over de afbeelding te verplaatsen.

3. knop Uitzoomen: Zoom uit om meer gebied te zien.

4. knop Zoomen naar maximale inhoud: Geeft de volledige inhoud van de foto weer.

5. venster Attribuutinformatie: Alle informatie over attributen voor het geassocieerde punt dat op de foto wordt weergegeven, wordt hier getoond. Als het gerefereerde bestandstype in het record geen afbeelding is, maar van een bestandstype dat is gedefinieerd onder de tab “Externe programma’s configureren”, dan zal bij het dubbelklikken van de waarde, van het veld dat het pad naar het bestand bevat, het bijbehorende programma worden geopend om de inhoud van het bestand te bekijken of beluisteren. Als de extensie van het bestand wordt herkend zal de informatie over de attributen in groen worden weergegeven.

6. Navigatieknoppen: Gebruik de knoppen Vorige en Volgende om het vorige of volgende object te laden wanneer meer dan één object is geselecteerd.

Begrijpen van het venster Opties¶

Figure eVis 2:

Het eVis venster Opties

1. Bestandspad: Een keuzelijst om het veld met attributen te specificeren dat het pad naar de map of de URL voor de foto’s of andere documenten die worden weergegeven bevat. Als de locatie een relatief pad is, dan moet het keuzevak worden geselecteerd. Het basispad voor een relatief pad kan worden ingevoerd in het tekstvak Basispad hieronder. Informatie over de verschillende opties voor het specificeren van de bestandslocatie zijn opgenomen in het gedeelte Specificeren van de locatie en de naam van een foto hieronder.

2. Kompasrichting: Een keuzelijst om het veld met attributen te specificeren dat de kompasrichting bevat die is geassocieerd met de weergegeven foto. Als informatie over de kompasrichting beschikbaar is, is het noodzakelijk om het keuzevak te selecteren onder de titel van de keuzelijst.

3. Kompasafwijking: Verschuivingen aan het kompas kunnen worden gebruikt om de afbuiging (om met behulp van magnetische richtingen verzamelde richtingen aan te passen naar richtingen van het echte Noorden) te compenseren. Klik op de keuzeknop Handmatig om de verschuiving in het tekstvak in te voeren or klik op de keuzeknop Afkomstig van attribuut om het veld met de attributen dat de verschuivingen bevat te selecteren. Voor beide opties zouden oostelijke afbuigingen moeten worden ingevoerd met positieve waarden en westelijke afbuigingen zouden negatieve waarden moten gebruiken.

4. Bestandspad: Het basispad waaraan het relatieve pad, gedefinieerd in Figure_eVis_2 (A) zal worden toegevoegd.

5. Vervangpad: Als dit keuzevak is geselecteerd zal alleen de bestandsnaam uit A worden toegevoegd aan het basispad.

6. Regel toepassen op alle documenten: Indien geselecteerd worden dezelfde regels voor paden die zijn gedefinieerd voor foto’s worden gebruikt voor documenten die geen afbeelding zijn, zoals filmpjes, tekstdocumenten en geluidsbestanden. Indien niet geselecteerd zullen de regels voor paden alleen van toepassing zijn op foto’s en zullen andere documenten de parameter Basispad negeren.

7. Onthouden: Als het keuzevak is geselecteerd zullen de waarden voor de geassocieerde parameters worden opgeslagen voor de volgende sessie wanneer het venster wordt gesloten of wanneer de knop [Save] eronder wordt ingedrukt.

8. Terug naar beginwaarden: Herstelt de waarden op deze regel naar de standaard instelling.

9. Standaarden herstellen: Dit zal alle velden terugzetten naar hun standaard waarden. Het heeft hetzelfde effect als het klikken op alle knoppen [Terug naar beginwaarden].

10. Opslaan: Dit zal de instellingen opslaan zonder het paneel Opties te sluiten.

Begrijpen van het venster Externe programma’s configureren¶

Figure eVis 3:

Het eVis venster Externe applicaties

1. Tabel bestandsverwijzingen: Een tabel met bestandstypen die kunnen worden geopend met eVis. Voor elk bestandstype is een bestandsextensie en pad naar een programma/toepassing nodig om dat type bestand te openen. Dit maakt het mogelijk om zeer veel verschillende soorten bestanden, zoals filmpjes, geluidsbestanden en tekstdocumenten, te kunnen openen in plaats van alleen afbeeldingen.

2. Nieuw bestandstype toevoegen: Voeg een nieuw bestandstype toe met een unieke extensie en het pad naar het programma dat dit bestand kan openen.

3. Verwijder huidige regel: Verwijder het bestandstype dat geselecteerd is in de tabel en gedefinieerd wordt door een bestandsextensie en een pad naar het bijbehorende programma.

Start de module Event ID¶

Ofwel klik op het pictogram ^{Event ID} óf klik op Database ‣ eVis ‣ Event ID-gereedschap om de module ‘Event ID’ te starten. Dit zal er voor zorgen dat de cursor wijzigt naar een pijl met een ‘i’ erboven om aan te geven dat het gereedschap ID actief is.

Verplaats de cursor van de Event ID over het object en klik met de muis om de foto’s te bekijken die zijn gekoppeld aan vectorobjecten in de actieve vectorlaag die wordt weergegeven in het kaartvenster van QGIS. Na het klikken op het object wordt het venster Event Browser geopend en de foto’s op of nabij de aangeklikte locatie zijn beschikbaar om te worden weergegeven in de browser. Indien meer dan één foto beschikbaar is, kunt u door de verschillende objecten gaan met behulp van de knoppen [Vorige] en [Volgende]. De andere besturingselementen worden beschreven in het gedeelte ref:evis_browser van deze handleiding.

Start de module Databseverbinding¶

Ofwel klik op het toepasselijke pictogram ^{eVis Databaseverbinding} óf klik op Database ‣ eVis ‣ Databaseverbinding om de module ‘Databaseverbinding’ te starten. Dit zal het venster Databaseverbinding starten. Het venster heeft drie tabs: Voorgedefinieerde query’s, Databaseverbinding en SQL-query. Het venster Output Console onder in het venster geeft de status weer van de acties die worden geïnitieerd door de verschillende gedeelten van deze module.

Verbinden met een database¶

Klik op de tab Databaseverbinding om de interface voor de databaseverbinding te openen. Gebruik vervolgens het combinatievak Type database om het type database te selecteren waarmee u wilt verbinden. Als een wachtwoord of gebruikersnaam is vereist, kan die informatie worden ingevoerd in de tekstvakken Gebruikersnaam en Wachtwoord.

Voer de naam van de host voor de database in in het tekstvak Database Host. Deze optie is niet beschikbaar als u “MSAccess” als type database heeft gekozen. Als de database zich op uw desktop bevindt, zou u “localhost” moeten invoeren.

Voer de naam van de database in in het tekstvak :guilabel:`Naam database `. Indien u ‘ODBC’ selecteerde als het type database, dient u de naam van de gegevensbron in te voeren.

Als alle parameters zijn ingevuld, klik dan op de knop [Verbinden]. Als de verbinding tot stand wordt gebracht zal een bericht worden geschreven in het venster Output Console dat aangeeft dat de verbinding tot stand is gebracht. Als geen verbinding tot stand wordt gebracht dient u te controleren of boven de juiste parameters werden ingevoerd.

Figure eVis 4:

Het eVis venster Databaseverbinding

1. Type database: Een keuzelijst om het type database te specificeren dat zal worden gebruikt.

2. Database-host: De naam van de host van de database .

3. Poort: Het poortnummer als een type database van MySQL of PostgreSQL is geselecteerd.

4. Naam database: De naam van de database.

5. Verbinden: Een knop om te verbinden met de database met behulp van de parameters die boven werden gedefinieerd.

6. Console-venster: Het console-venster waar berichten over de voortgang worden weergegeven.

7. Gebruikersnaam: Gebruikersnaam om te gebruiken als de database met een wachtwoord is beveiligd.

8. Wachtwoord: Wachtwoord om te gebruiken als de database met een wachtwoord is beveiligd.

9. Voorgedefinieerde query’s: Tab om het venster “Voorgedefinieerde query’s” te openen.

10. Databaseverbinding: Tab om het venster “Databaseverbinding” te openen.

11. SQL Query: Tab om het venster “SQL Query” te openen.

12. Help: Geeft de online help weer.

13. OK: Sluit het hoofdvenster “Databaseverbinding”.

SQL-query’s uitvoeren¶

SQL-query’s worden gebruikt om informatie te extraheren uit een database of bron van ODBC. In eVis is de uitvoer van deze query’s een vectorlaag die wordt toegevoegd aan het kaartvenster van QGIS. Klik op de tab SQL-query om de interface voor SQL-query’s weer te geven. Opdrachten voor SQL kunnen worden ingevoerd in dit tekstvenster. Een hulpvolle handleiding over opdrachten voor SQL is beschikbaar op http://www.w3schools.com/sql. Om bijvoorbeeld alle gegevens uit een werkblad van een Excel-bestand te extraheren: select * from [blad1$] waar sheet1 de naam is van het werkblad.

Klik op de knop [Query uitvoeren] om de opdracht uit te voeren. Als de query met succes wordt uitgevoerd zal een venster Database bestandsselectie worden weergegeven. Als de query niet goed werd uitgevoerd zal een foutbericht verschijnen in het venster Console-venster.

Voer, in het venster Database bestandsselectie, de naam in van de laag die zal worden gemaakt vanuit de resultaten van de query in het tekstvak Naam voor de nieuwe laag.

Figure eVis 5:

De eVis tab SQL query

1. SQL-Query tekstvenster: Een scherm om query’s voor SQL in te typen.

2. Voer query uit: Knop om de query uit te voeren die is ingevoerd het het :guilabel:` venster SQL-Query`.

3. Console-venster: Het console-venster waar berichten over de voortgang worden weergegeven.

4. Help: Geeft de online help weer.

5. OK: Sluit het hoofdvenster Databaseverbinding.

Gebruik de combinatievakken X-coördinaat en Y-coördinaat om de velden uit de database te selecteren die de coördinaten voor de X (of lengtegraad) en Y (of breeedtegraad) bevatten. Klikken op de knop [OK] zorgt er voor dat de vectorlaag wordt gemaakt vanuit de SQL-query om te worden weergegeven in het kaartvenster van QGIS.

U kunt de opdracht van QGIS ‘Opslaan als...’ gebruiken, waar u kunt komen door met rechts te klikken op de naam van de laag in de legenda van de kaart van QGIS en dan te selecteren ‘Opslaan als...’, om dit vectorbestand op te slaan voor toekomstig gebruik.

Voorgedefinieerde query’s uitvoeren¶

Met Voorgedefinieerde query’s kunt u eerder geschreven query’s, die zijn opgeslagen in een bestand met de indeling XML, selecteren. Dit is in het bijzonder handig als u niet goed bekend bent met opdrachten in SQL. Klik op de tab Voorgedefinieerde query’s om de interface voor Voorgedefinieerde query’s weer te geven.

Klik op het pictogram ^{Bestand openen} om een set voorgedefinieerde query’s te openen. Dit opent het venster Bestand openen, dat wordt gebruikt om het bestand dat de SQL-query’s bevat te lokaliseren. Als de query’s zijn geladen, zullen hun titels, zoals gedefinieerd in het XML-bestand, in het keuzemenu verschijnen dat net onder het pictogram ^{Bestand openen} staat. De volledige beschrijving van de query wordt weergegeven in het tekstvenster onder het keuzemenu.

Selecteer de query die u wilt uitvoeren uit het keuzemenu en klik dan op de tab SQL-query om te zien dat de query is geladen in het query-venster. Als het de eerste keer is dat u een voorgedefinieerde query uitvoert of schakelt tussen databases, dient u zich er van te overtuigen dat u met de database bent verbonden.

Klik op de knop [Query uitvoeren] op de tab SQL-query om de opdracht uit te voeren. Als de query met succes wordt uitgevoerd zal een venster Database bestandsselectie worden weergegeven. Als de query niet goed werd uitgevoerd zal een foutbericht verschijnen in het venster Console-venster.

Figure eVis 6:

De tab eVis Voorgedefinieerde query’s

1. Bestand openen: Start de bestandsbrowser “Bestand openen” om te zoeken naar het XML-bestand dat de voorgedefinieerde query’s bevat.

2. Voorgedefinieerde query’s: Een keuzelijst met alle query’s die zijn gedefinieerd in het XML-bestand voor voorgedefinieerde query’s.

3. beschrijving query: Een korte beschrijving van de query. Deze beschrijving komt vanuit XML-bestand voor de voorgedefinieerde query’s.

4. Console-venster: Het console-venster waar berichten over de voortgang worden weergegeven.

5. Help: Geeft de online help weer.

6. OK: Sluit het hoofdvenster “Databaseverbinding”.

XML-indeling voor voorgedefinieerde query’s van eVis¶

De XML-tags die worden gelezen door eVis

Een volledig voorbeeld XML-bestand met drie query’s wordt hieronder weergegeven:

<?xml version="1.0"?>
<doc>
 <query>
   <shortdescription>Import all photograph points</shortdescription>
   <description>This command will import all of the data in the SQLite database to QGIS
      </description>
   <databasetype>SQLITE</databasetype>
   <databasehost />
   <databaseport />
   <databasename>C:\textbackslash Workshop/textbackslash
eVis\_Data\textbackslash PhotoPoints.db</databasename>
   <databaseusername />
   <databasepassword />
   <sqlstatement>SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec_id=Attributes.point_ID</sqlstatement>
   <autoconnect>false</autoconnect>
 </query>
  <query>
   <shortdescription>Import photograph points "looking across Valley"</shortdescription>
   <description>This command will import only points that have photographs "looking across
      a valley" to QGIS</description>
   <databasetype>SQLITE</databasetype>
   <databasehost />
   <databaseport />
   <databasename>C:\Workshop\eVis_Data\PhotoPoints.db</databasename>
   <databaseusername />
   <databasepassword />
   <sqlstatement>SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec_id=Attributes.point_ID where COMMENTS='Looking across
      valley'</sqlstatement>
   <autoconnect>false</autoconnect>
 </query>
 <query>
   <shortdescription>Import photograph points that mention "limestone"</shortdescription>
   <description>This command will import only points that have photographs that mention
      "limestone" to QGIS</description>
   <databasetype>SQLITE</databasetype>
   <databasehost />
   <databaseport />
   <databasename>C:\Workshop\eVis_Data\PhotoPoints.db</databasename>
   <databaseusername />
   <databasepassword />
   <sqlstatement>SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec_id=Attributes.point_ID where COMMENTS like '%limestone%'
      </sqlstatement>
   <autoconnect>false</autoconnect>
 </query>
</doc>