eVis Plugin¶

Den eVis-Ereignisbrowser starten¶

Um den Ereignisbrowser zu starten, klicken Sie entweder auf das ^{eVis Event Browser} Icon oder auf Datenbank ‣ eVis ‣ eVis Ereignisbrowser. Dies öffnet den Ereignisbrowser Dialog.

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

Figure eVis 1:

The eVis display window

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.

7. Objektindikator: Diese Information in der Kopfzeile des Ereignisbrowsers gibt an, welches Objekt gerade angezeigt wird und wieviele insgesamt vorhanden sind.

Der Optionen-Reiter¶

Figure eVis 2:

The eVis Options window

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

2. Kompassrichtung: Eine Dropdown-Liste, um das Attributfeld zu definieren, welches die Himmelsrichtung angibt, in der das Foto geschossen wurde. Wenn eine Kompassrichtung verfügbar ist, ist es notwendig, zuvor das Kontrollkästchen Kompassrichtung anzeigen auszuwählen, um die Spalte mit den Himmelsrichtungen auszuwählen.

3. Kompassversatz: Der Kompassversatz kann verwendet werden, um die magnetische Abweichung zu kompensieren. (Abweichung der magnetischen zur wahren Nordrichtung). Klicken Sie dazu auf :guilabel`Manuell`, um die Abweichung einzugeben, oder auf radiobuttonon| :guilabel`Aus Attribut`, um eine Attributspalte mit den Abweichungen festzulegen. Für beide Optionen sollten östliche Abweichungen als postive Zahlenwerte und westliche Abweichungen als negative Zahlenwerte angegeben werden.

4. Relativer Pfad: Der Grundpfad, auf den sich die relativen Pfade der Fotos und Dokumente beziehen wie in Abbildung Figure_eVis_2 (A) und wird angehängt.

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 (Filme, Texte, usw.) verwendet. Ansonsten werden die definierten Pfadangaben nur für die Fotos verwendet. Alle anderen Dokumente ignorieren den Grundpfad.

7. Dies merken: Wenn dieses Kontrollkästchen aktiviert ist, werden alle damit in Verbindung stehenden Parameter für die nächste Sitzung gespeichert. Sie können dazu auch global den Knopf [Speichern] drücken.

8. Zurücksetzen: Setzt die Werte der jeweiligen Zeile auf die Standardwerte zurück.

9. Voreinstellungen: Damit werden alle Werte in den Feldern auf die Standardwerte zurückgesetzt. Es ist derselbe Effekt, als wenn Sie alle Zurücksetzen Knöpfe drücken.

10. Speichern: Dieser Knopf speichert alle Einstellungen, ohne den Dialog zu schließen.

Der Externe Applikationen konfigurieren Reiter¶

Figure eVis 3:

The eVis External Applications window

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-Werkzeug’ zu starten, klicken Sie entweder auf das ^{Ereignis-ID-Werkzeug} Icon oder auf Datenbanken ‣ eVis ‣ Ereignis-ID-Werkzeug. Dadurch wechselt der Mauszeiger zu einem Pfeil mit einem ‘i’ und zeigt an, dass das Ereignis-ID-Werkzeug aktiv ist.

Um die mit den Vektorobjekten verlinkten Fotos in dem aktiven Vektorlayer anzuzeigen, bewegen Sie den Ereignis-ID Mauszeiger über das Objekt und klicken dann auf die linke Maustaste. Nach einem Klick auf das Objekt, wird der Ereignisbrowser geöffnet und die Fotos auf oder in der Nähe des angeklickten Ortes werden angezeigt. Wenn mehr als ein Foto zur Verfügung steht, können Sie durch die verschiedenen Objekte wandeln, indem Sie auf die Schaltflächen [Vorgeriges] und [Nächstes] drücken. Die anderen Steuerelemente sind in Kapitel Ereignisbrowser beschrieben.

Starten des Dialogs Datenbankverbindung¶

Um den Dialog Datenbankverbindung zu starten, klicken Sie auf das Icon ^{Datenbankverbindung} oder gehen Sie in das Menü Datenbanken ‣ eVis ‣ Datenbankverbindung. Dadurch wird der Dialog Datenbankverbindung gestartet und Sie finden die drei Reiter Vordefinierte Abfragen, Datenbankverbindung und SQL-Abfrage. Im Fenster Ausgabekonsole werden Informationen zu den jeweiligen Aktionen angezeigt.

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 dann den Datenbank-Host an. Diese Option ist nicht vorhanden, wenn Sie ‘MSAccess’ als Datenbanktyp ausgewählt haben. Wenn die Datenbank auf Ihrem Rechner läuft, geben Sie an dieser Stelle ‘localhost’ ein.

Nun geben sie den Namen der Datenbank im Feld Datenbankname ein. Wenn Sie hier ‘ODBC’ als Datenbanktyp ausgewählt haben, müssen Sie den Namen der Datenquelle eingeben.

Nachdem Sie alle Parameter angegeben haben, klicken Sie auf den [Verbinden] Knopf. Wenn die Verbindung erfolgreich ist, wird dies im Ausgabefenster angezeigt. Im anderen Fall müssen Sie die Parameter nochmal überprüfen, die Sie eingegeben haben.

Figure eVis 4:

The eVis Database connection window

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 definierten Datenbank 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ßen des Dialogs ‘Datenbankverbindung’.

SQL-Abfrage durchführen¶

SQL-Abfragen werden verwendet, um Informationen aus einer Datenbank oder ODBC-Ressource zu extrahieren. In eVis wird die Abfrage als Vektorlayer zum QGIS Kartenfenster hinzugefügt. Klicken Sie auf den Reiter SQL-Abfrage, um die SQL-Abfrage-Schnittstelle zu öffnen. Sie können dann SQL-Kommandos in dem Textfenster eingeben. Ein hilfreiches Tutorial über SQL-Befehle finden Sie unter der http://www.w3schools.com/sql/. Um z.B. einen Auszug aller Daten aus einer Excel-Datei zu erstellen, können Sie eingeben select * from [Blatt1\$] wobei ‘Blatt1’ der Name des Arbeitsblattes ist.

Klicken Sie dann auf die Knopf [Abfrage ausführen], um den Befehl auszuführen. Wenn die Abfrage erfolgreich ist, wird ein Auswahlfenster angezeigt. Wenn die Abfrage nicht erfolgreich ist, erscheint eine Fehlermeldung in der Ausgabekonsole.

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

Figure eVis 5:

The eVis SQL query tab

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.

Verwenden Sie die Dropdown-Menüs X Koordinate und Y Koordinate, um die Spalten der Datenbank zu selektieren, in denen die X (oder Longitude) and Y (oder Latitude) Koordinaten abgelegt sind. Wenn Sie nun auf den [OK] Knopf drücken, wird ein Vektorlayer entsprechend der SQL-Abfrage erstellt und als neuer Layer in QGIS angezeigt.

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 sind mit SQL-Befehlen. 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. Dann können Sie die Datei mit den abgespeicherten SQL-Befehlen auswählen und laden. Danach erscheinen die einzelnen Abfragen im Dropdown-Menü. Eine Beschreibung der SQL-Abfrage wird jeweils im Textfenster unterhalb des Dropdown-Menüs angezeigt.

Wählen Sie nun eine Abfrage, die Sie aus dem Dropdown-Menü ausführen möchten und klicken Sie auf den Reiter SQL-Abfrage, um die Abfrage anzuschauen. Wenn Sie eine vordefinierten Abfrage das erste Mal starten, müssen Sie sich erst vergewissern, dass die Datenbankverbindung steht.

Klicken Sie auf den Knopf [Abfrage ausführen] im Reiter SQL-Abfrage. Wenn die Abfrage erfolgreich ist, wird ein Auswahlfenster angezeigt. Wenn die Abfrage nicht erfolgreich ist, erscheint eine Fehlermeldung in der Ausgabekonsole.

Figure eVis 6:

The eVis Predefined queries tab

1. Öffne Datei: Startet den ‘Datei öffnen’ Dialog, um eine XML-Datei mit vordefinierten Abfragen zu laden.

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>