eVis Plugin¶

Den eVis-Ereignisbrowser starten¶

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

Der Ereignisbrowser-Dialog besteht aus drei Reitern am oberen linken Rand. Der Reiter Anzeigen wird verwendet, um das Foto anzuzeigen und das damit verbundene Datenattribut. Der Reiter Optionen enthält eine Reihe von Einstellungen, die angepasst werden, um das Verhalten des Plugins zu verändern. Schließlich gibt es noch den Reiter Externe Anwendungen konfigurieren, um eine Tabelle mit Dateierweiterungen und damit verbundenen Anwendungen zu managen, um andere Dokumente als Bilder anzeigen zu können.

Der Anzeigen-Reiter¶

Um das Anzeigen Fenster zu sehen, klicken Sie auf den Anzeigen Reiter im Dialog Ereignisbrowser. Der Reiter Anzeigen des Ereignisbrowsers wird verwendet, um georeferenzierte Fotos und damit verknüpfte Attribute anzuzeigen.

Das eVis Anzeigen Fenster

1. Anzeigefenster: Ein Fenster, in dem das Foto erscheint.

2. Hineinzoomen: Zoomen, um Details zu sehen. Wenn das gesamte Bild nicht im Anzeigefenster dargestellt werden kann, erscheinen Scrollbars auf der linken und unteren Seite des Fensters, um das Foto verschieben zu können.

3. Herauszoomen: Aus dem Bild herauszoomen, um einen Überblick zu haben.

4. Zur vollen Ausdehnung zoomen: Zeigt die volle Ausdehnung des Fotos an.

5. Attributfenster: Alle Attribute des Vektorpunktes, der mit dem Foto verlinkt ist werden hier angezeigt. Wenn der Datentyp, auf den verwiesen wird kein Foto ist, sondern ein anderer Datentyp, der im Reiter Externe Applikationen konfigurieren definiert ist, dann öffnet sich die Anwendung mit dem speziellen Datentyp, indem Sie auf das Feld mit dem Pfad doppelkicken. Die Anwendung wird dann gestartet und Sie können den Inhalt anschauen oder anhören. Wenn die Datenendung erkannt wird, wird sie automatisch in grün angezeigt.

6. Navigation: Verwenden Sie den ‘Vorheriges’ und ‘Nächstes’ Knopf, um weitere Objekte zu laden, falls vorhanden und selektiert.

Der Optionen-Reiter¶

Das eVis Optionen Fenster

1. Dateipfad: Eine Dropdown-Liste, um das Attributfeld zu definieren, welches den Verzeichnispfad oder die URL für die Fotos oder anderen Dokumente enthält. Wenn es ein relativer Pfad ist, dann wählen Sie das Kontrollkästchen Pfad ist relaitiv, links neben dem Dropdown-Menü. Der Grundpfad für den relativen Pfad kann in dem Grundpfad eingegeben werden. Informationen über die verschiedenen Optionen zur Angabe des Speicherortes der Datei werden weiter unten im Abschnitt Den Ort und Namen eines Fotos festlegen beschrieben.

2. Kompassrichtung: Eine Dropdownliste um das Attributfeld anzugeben, das die Kompassrichtung des angezeigten Fotos enthält. Wenn Kompassversatzinformationen zur Verfügung stehen, ist es erforderlich das Kontrollkästchen unter dem Dropdownmenütitel zu klicken.

3. Kompassversatz: Kompassversätze können dazu benutzt werden Deklinationen zu kompensieren (um Versätze, die unter Anwendung von Magnetlagern gesamelt wurden, zu geographisch Nord anzupassen). Klicken Sie den Manuell Radiobutton um den Versatz in das Textfenster einzugeben oder klicken Sie den Aus Attribut Radiobutton um das Attributfeld, das die Versätze enthält, auszuwählen. Für beide dieser Optionen sollten Ostdeklinationen mit positiven Werten und Westdeklinationen mit negativen Werten eingegeben werden.

4. Directory base path: The base path onto which the relative path defined in Figure_eVis_options (A) will be appended.

5. Gesamten Pfad ersetzen: Wenn dieses Kontrollkästchen aktiviert ist, wird nur der Dateiname an den Grundpfad angehängt, der als Attributspalte im Bereich Dateipfad definiert wurde.

6. Bildpfad auf alle Dokumente anwenden: Wenn dieses Kontrollkästchen aktiviert ist, wird derselbe Grundpfad, der für Fotos verwendet wird, auch auf alle anderen Dokumente wie Filme, Texte, usw. verwendet. Ansonsten werden die definierten Pfadangaben nur für die Fotos verwendet. Alle anderen Dokumente ignorieren den Grundpfad.

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. Zurücksetzen: Setzt die Werte der jeweiligen Zeile auf die Standardwerte zurück.

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. Speichern: Dieser Knopf speichert alle Einstellungen, ohne den Dialog zu schließen.

Der Externe Applikationen konfigurieren Reiter¶

Das eVis Externe Anwendungen konfigurieren Fenster

1. Datei Referenztabelle: Eine Tabelle mit den Datentypen, die mit eVis geöffnet werden können. Jeder Datentyp benötigt eine Dateiendung, und den Pfad zu einer Anwendung, die den entsprechenden Datentyp anzeigen oder ausführen kann. Dies schließt neben Fotos u.a. auch Textdokumente, Filme oder Hörspiele mit ein.

2. Neuen Dateityp hinzufügen: Füge einen neuen Dateityp mit einer einzigartigen Dateiendung hinzu, sowie einen Pfad zu der Applikation, mit der dieser Datentyp geöffnet werden kann.

3. Aktuelle Zeile löschen: Löschen Sie den ausgewählten Dateityp aus der Referenztabelle.

Starten des Ereignis-ID-Werkzeugs¶

Um das ‘Ereignis-ID’ Modul zu öffnen klicken Sie entweder auf das ^{eVis-Ereignis-ID} Icon oder Datenbank ‣ eVis ‣ eVis-Ereignis-ID-Werkzeug. Dies bewirkt, dass der Cursor in einen Pfeil mit einem ‘i’ am oberen Ende wechselt, was bedeutet, dass das ID Werkzeug aktiv ist.

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 Ereignisbrowser section of this guide.

Starten des Dialogs Datenbankverbindung¶

Um das ‘Datenbankverbindung’ Modul zu starten klicken Sie auf das entsprechende Icon ^{eVis Datenbankverbindung} oder klicken Sie auf Datenbank ‣ eVis ‣ eVis-Datenbankverbindung. Dies öffnet das Datenbankverbindung Fenster. Das Fenster hat drei Reiter: Vordefinierte Abfragen, Datenbankverbindung und SQL-Abfrage. Das Ausgabekonsole Fenster im unteren Teil des Fensters stellt den Status der Aktionen, die von verschiedenen Abschnitten dieses Moduls initiiert wurden, dar.

Verbinden mit einer Datenbank¶

Drücken Sie auf den Reiter Datenbankverbindung und definieren Sie dann im Dropdown-Menü den Datenbanktyp, mit dem Sie sich verbinden wollen. Wenn ein Passwort oder Benutzername erforderlich ist, können diese Informationen in den Feldern Benutzername und Passwort eingegeben werden.

Geben Sie den Datenbank-Host in das Datenbank-Host Textfenster ein. Diese Option steht nicht zur Verfügung wenn Sie ‘MS Access’ als Datenbanktyp ausgewählt haben. Wenn die Datenbank auf Ihrem Desktop vorgehalten wird sollten Sie ‘’localhost’’ eingeben.

Geben Sie den Namen der Datenbank in das Datenbankname Textfeld ein. Wenn Sie ‘ODBC’ als Datenbanktyp eingegeben haben, müssen Sie den Datenquellenname eingeben.

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.

Das eVis Datenbankverbindung Fenster

1. Datenbanktyp: Eine Dropdown-Liste, um den zu verwendenen Datenbanktyp festzulegen.

2. Datenbank-Host: Der Name des Datenbank-Hosts.

3. Port: Die Portnummer, wenn MYSQL oder PostgreSQL benutzt wird.

4. Datenbankname: Der Name der Datenbank.

5. Verbinden: Ein Knopf, um sich mit der Datenbank, die die oben definierten Parameter verwendet, zu verbinden.

6. Ausgabekonsole: Hier werden Informationen zu den Prozessen angezeigt.

7. Benutzername: Benutzername, um sich mit einer passwortgeschützten Datenbank zu verbinden.

8. Passwort: Passwort, wenn die Datenbank passwortgeschützt ist.

9. Vordefinierte Abfragen: Reiter, um den Dialog ‘Vordefinierte Abfragen’ zu öffnen.

10. Datenbankverbindung: Reiter, um den Dialog ‘Datenbankverbindung’ zu öffnen.

11. SQL-Abfrage: Reiter, um den Dialog ‘SQL-Abfrage’ zu öffnen.

12. Hilfe: Zeigt die Online-Hilfe an.

13. OK: Schließt das Fenster ‘Datenbankverbindung’.

SQL-Abfrage durchführen¶

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.

Im Datenbank Dateiauswahl Fenster geben Sie den Namen des Layers an, der aus dem Ergebnis der Abfrage erstellt werden soll.

Der eVis SQL-Abfrage Reiter

1. SQL-Abfrage: Ein Fenster zur Eingabe von SQL-Abfragen.

2. Abfrage ausführen: Knopf, um die SQL-Abfrage auszuführen.

3. Ausgabekonsole: Hier werden Informationen zu den Prozessen angezeigt.

4. Hilfe: Zeigt die Online-Hilfe an.

5. OK: Schließt das Fenster Datenbankverbindung.

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.

Sie können den Layer als Shapefile speichern, wenn Sie mit dem Mauspfeil auf den Layernamen in der Legende zeigen und dann auf die rechte Maustaste klicken. Dort erscheint dann die Option ‘Speichern als...’

Vordefinierte Abfragen starten¶

Über den Reiter Vordefinierte Abfragen können Sie zuvor schriftlich erstellte SQL-Abfragen, die als Datei im XML-Format gespeichert werden, wieder aufrufen. Dies ist besonders hilfreich, wenn Sie nicht vertraut mit SQL-Befehlen sind. Klicken Sie auf den Reiter Vordefinierte Abfragen, um die vordefinierte Abfrage-Schnittstelle zu öffnen.

Um eine Reihe von vordefinierten Abfragen zu laden, klicken Sie auf das ^{Datei öffnen} Icon. Dies öffnet das Datei öffnen Fenster, das dazu verwendet wird die Datei mit den SQL-Abfragen ausfindig zu machen. Wenn die Abfragen geladen sind, erscheinen ihre Titel wie in der XML-Datei definiert im Dropdownmenü gerade unter dem |evis_file| ^{Datei öffnen} Icon. Die ausführliche Beschreibung der Abfrage wird im Textfenster unter dem Dopdownmenü dargestellt.

Wählen Sie die Abfrage, die Sie aus dem Dropdownmenü ausführen wollen und klicken Sie dann auf den SQL-Abfrage Reiter um zu sehen, dass die Abfrage in das Abfragefenster geladen worden ist. Wenn Sie das erste Mal eine vordefinierte Abfrage ausführen oder die Datenbank wechseln müssen Sie sich vergewissern, dass Sie mit der Datenbank verbunden sind.

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.

Der eVis Vordefinierte Abfragen Reiter

1. Datei öffnen: Öffnet den ‘’Datei öffnen’’ Dateibrowser um nach der XML-Datei, die die vordefinierten Abfragen vorhält, zu suchen.

2. Vordefinierte Abfragen: Eine Dropdown-Liste mit allen Abfragen der bereits erstellten XML-Datei.

3. Abfragebeschreibung: Eine Beschreibung der Abfrage. Diese Beschreibung ist in der XML-Datei enthalten.

4. Ausgabekonsole: Hier werden Informationen zu den Prozessen angezeigt.

5. Hilfe: Zeigt die Online-Hilfe an.

6. OK: Schließt das Fenster ‘Datenbankverbindung’.

XML-Format für vordefinierte Abfragen in eVis¶

Die von eVis gelesenen XML-Tags

Ein Beispiel einer XML-Datei mit drei Abfragen ist unten dargestellt:

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