Plug-in eVis¶

Start de module Event Browser¶

To launch the Event Browser module, click on Database ‣ eVis ‣ eVis Event Browser. This will open the Generic Event Browser window.

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.

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¶

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 optieknop Handmatig om de verschuiving in het tekstvak in te voeren of klik op de optieknop 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. Map van bestandspad: Het basispad waaraan het relatieve pad, gedefinieerd in Figure_eVis_options (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. Remember settings: If the checkbox is checked, the values for the associated parameters will be saved for the next session when the window is closed or when the [Save] button below is pressed.

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

9. Restore defaults: This will reset all of the fields to their default settings. It has the same effect as clicking all of the [Reset] buttons.

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

Begrijpen van het venster Externe programma’s configureren¶

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.

To view the photographs linked to vector features in the active vector layer displayed in the QGIS map window, move the Event ID cursor over the feature and then click the mouse. After clicking on the feature, the Event Browser window is opened and the photographs on or near the clicked locality are available for display in the browser. If more than one photograph is available, you can cycle through the different features using the [Previous] and [Next] buttons. The other controls are described in the Event Browser section of this guide.

Start de module Databaseverbinding¶

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 Naam database. Indien u ‘ODBC’ selecteerde als het type database, dient u de naam van de gegevensbron in te voeren.

When all of the parameters are filled in, click on the [Connect] button. If the connection is successful, a message will be written in the Output Console window stating that the connection was established. If a connection was not established, you will need to check that the correct parameters were entered above.

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 queries are used to extract information from a database or ODBC resource. In eVis, the output from these queries is a vector layer added to the QGIS map window. Click on the SQL Query tab to display the SQL query interface. SQL commands can be entered in this text window. A helpful tutorial on SQL commands is available at http://www.w3schools.com/sql. For example, to extract all of the data from a worksheet in an Excel file, select * from [sheet1$] where sheet1 is the name of the worksheet.

Click on the [Run Query] button to execute the command. If the query is successful, a Database File Selection window will be displayed. If the query is not successful, an error message will appear in the Output Console window.

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.

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

Use the X Coordinate and Y Coordinate combo boxes to select the fields from the database that stores the X (or longitude) and Y (or latitude) coordinates. Clicking on the [OK] button causes the vector layer created from the SQL query to be displayed in the QGIS map window.

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 query’s voor SQL 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.

Click on the [Run Query] button in the SQL Query tab to execute the command. If the query is successful, a Database File Selection window will be displayed. If the query is not successful, an error message will appear in the Output Console window.

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>