Konfiguration externer Anwendungen¶

SAGA¶

SAGA Algorithmen können von QGIS aus benutzt werden wenn Sie SAGA auf Ihrem System installiert haben und Sie die Verarbeiten Umgebung richtig konfigurieren, so dass es ausführbare Module von SAGA finden kann. Insbesondere das SAGA Kommandozeilenmodul wird benötigt um SAGA Algorithmen zum Laufen zu bringen.

Wenn Sie Windows benutzen beinhalten sowohl das Installationspaket und der OSGeo4W Installer SAGA unter QGIS und er Pfad ist automatisch konfiguriert, es muss also nichts weiter getan werden.

Wenn Sie SAGA selber installiert haben (denken Sie daran, dass Sie Version2.1 brauchen) muss der Pfad zu den ausführbaren Modulen konfiguriert werden. Um dies zu tun öffnen Sie den Optionen und Konfiguration Dialog. Im SAGA Block finden Sie eine Einstellung genannt SAGA Folder. Geben Sie den Pfad zu dem Ordner wo SAGA installiert ist an. Schließen Sie den Verarbeitungsoptionendialog und jetzt können Sie SAGA Algorithmen aus QGIS heraus ausführen.

Wenn Sie Linux benutzen, sind SAGA Binärpakete nicht in der Verarbeitung Umgebung enthalten, also müssen Sie die Software selber downloaden und installieren. Bitte überprüfen Sie die SAGA Webseite für mehr Informationen. Es wird SAGA 2.1 benötigt.

In diesem Fall braucht der Pfad zu den ausführbaren SAGA Modulen nicht konfiguriert werden und Sie werden diese Ordner nicht sehen. Anstelledessen müssen Sie sicherstellen, dass SAGA richtig installiert ist und seine Ordner zur PATH Umgebungsvariable hinzugefügt wurden. Öffnen Sie einfach eine Konsole und geben Sie saga_cmd ein um zu überprüfen, dass das System herausfindet, wo sich die SAGA Binärpakete befinden.

R. Creating R scripts¶

Die R Integration in QGIS unterscheidet sich von der SAGA Integration, da es keinen vordefinierten Satz von Algorithmen gibt, den man ausführen kann (bis auf einige Beispiele). Stattdessen sollten Sie Ihre Skripte schreiben und dann über R Befehle aufrufen, ähnlich wie man es von R kennt, und in einer sehr ähnlichen Weise zu dem, was wir sahen, im Kapitel Verarbeitung Skripte. Dieses Kapitel zeigt Ihnen die Syntax, die Sie verwenden sollten, um die R-Befehle von QGIS anzusprechen und wie QGIS Objekte verwendet werden (Layer, Tabellen).

Das erste, was Sie tun müssen, wie wir im Fall von SAGA gesehen haben, ist zu sagen, wo sich die R Binärdateien befinden. Sie können dies tun, indem Sie den R folder Eintrag im Verarbeitung Konfigurationsdialog ansprechen. Nachdem Sie die Parameter definiert haben, können Sie anfangen, eigene R-Skripte zu erstellen und auszuführen.

Dies ist wieder anders in Linux. Dort müssen Sie nur sicherstellen, dass der R-Ordner in der Umgebungsvariablen PATH enthalten ist. Wenn Sie nur die Eingabe R in eine Konsole eingeben können, kann es losgehen.

Um einen neuen Algorithmus hinzuzufügen, der eine R Funktion (oder ein komplexeres RScript, das sie entwickelt haben und das sie gerne zur in QGIS zur Verfügung stehen haben wollen) aufruft, müssen Sie eine Script Datei erstellen, die der Verarbeiten Umgebung, wie diese Operation durchgeführt wird, und die entsprechenden R Befehle mitteilt um das zu tun.

R Scripts Dateien habe die Erweiterung .rsx und es ist ziemlich einfach sie zu erstellen wenn Sie nur etwas grundlegende Kenntnisse über die R Syntax und R Scripting besitzen. Sie sollten im R Scripts Ordner gespeichert werden. Sie können diesen Ordner in der R Einstellungen Gruppe (steht im Verarbeitungsoptionen Dialog) einstellen, genauso wie Sie es mit dem Ordner für reguläre Verarbeitung Scripts machen.

Werfen Sie einen Blick auf eine sehr einfache Scripts-Datei, die die R-Methode spsample aufruft und ein zufälliges Gitter innerhalb der Grenzen eines Polygon in einem bestimmten Polygon-Layer erstellt. Diese Methode gehört zum Paket zur MapTools. Grundsätzlich brauchen Sie für R-Algorithmen, die Sie in Verarbeitung für räumliche geostatistische Analysen nutzen wollen, zumindest Kenntnisse der Pakete wie MapTools und speziell sp.

##polyg=vector
##numpoints=number 10
##output=output vector
##sp=group
pts=spsample(polyg,numpoints,type="random")
output=SpatialPointsDataFrame(pts, as.data.frame(pts))

The first lines, which start with a double Python comment sign (##), tell QGIS the inputs of the algorithm described in the file and the outputs that it will generate. They work with exactly the same syntax as the SEXTANTE scripts that we have already seen, so they will not be described here again. Check the processing_scripts section for more information.

Wenn Sie einen Eingabeparameter definieren, verwendet QGIS diese Informationen für zwei Dinge: Erstellung der Benutzeroberfläche, um die Benutzer nach Eingaben von Parameters zu fragen und die Schaffung einer entsprechenden R Variable, die später als Eingabe für die R-Befehle verwendet werden.

In dem obigen Beispiel erklären wir die Eingabe vom Typ Vektor mit dem Namen polyg. Bei der Ausführung des Algorithmus wird durch QGIS R geöffnet und der Layer, der durch den Benutzer ausgewählt wurde, in einer Variablen polyg abgelegt. Der Name des Parameters ist also auch der Name der Variablen, die wir in R für den Zugriff auf den Wert des Parameters nutzen (vermeiden Sie, reservierte R Begriffe als Parameter zu verwenden).

Räumliche Elemente wie Vektor- und Rasterlayer werden mit den readOGR() und brick() Befehlen eingelesen (sie brauchen sich nicht darum kümmern diese Befehle Ihrer Beschreibungsdatei hinzuzufügen - das macht QGIS) und sie werden als Spatial*DataFrame Objekte gespeichert. Tabellenfelder werden als Strings, die den Namen des ausgewählten Feldes beinhalten, gespeichert.

Tabellen werden anhand des read.csv() Befehls geöffnet. Wenn ein Anwender eine Tabelle eingibt, die nicht im CSV Format ist, wird diese vor dem Importieren in R konvertiert.

Zusätzlich können Rasterdateien mit Hilfe des readGDAL() Befehls anstelle von brick() eingelesen werden indem ##usereadgdal benutzt wird.

Wenn Sie ein fortgeschrittener Anwender sind und nicht wollen, dass QGIS ein Objekt, das den Layer repräsentiert, erstellt, können Sie den ##passfilename Tag benutzen um anzuzeigen, dass Sie anstelledessen einen String mit dem Dateinamen bevorzugen. In diesem Fall ist es an Ihnen, die Datei vor dem Durchführen von Operationen mit Daten, die es beinhaltet, zu öffnen.

Mit den oben genannten Informationen können wir jetzt die erste Zeile unseres ersten Beispiel Scripts verstehen (dabei startet die erste Zeile nicht mit einem Python Kommentar).

pts=spsample(polyg,numpoints,type="random")

Die Variable Polygon enthält bereits ein SpatialPolygonsDataFrame Objekt, damit kann es verwendet werden, um das spsample Verfahren aufzurufen, ebenso wie die NumPoints, die die Anzahl der Punkte zeigt, die zum Gitter hinzugefügt werden sollen.

Da wir eine Ausgabe vom Typ Vektor definiert haben mit dem Namen``out``, müssen wir nun eine Variable namens out erstellen und Spatial*DATAframe Objekt dafür erstellen (in diesem Fall ein SpatialPointsDataFrame). Sie können einen beliebigen Namen für Ihre Zwischenvariablen verwenden. Stellen Sie nur sicher, dass die Variable Ihres Endergebnisses den gleichen Namen hat, den Sie zuvor definiert haben und dass sie einen geeigneten Wert enthält.

In diesem Fall muss das von der spsample Methode erhaltene Ergebnis ausdrücklich in ein SpatialPointsDataFrame Objekt konvertiert werden, da es ein Objekt der Klasse ppp ist, welches keine geeignete Klasse ist um an QGIS zurückgegeben zu werden.

Wenn Ihr Algorithmus Rasterlayer erstellt, hängt die Art und Weise wie Sie gespeichert werden davon ab ob Sie die #dontuserasterpackage Option verwendet haben. Wenn Sie sie verwendet haben werden die Layer anhand der writeGDAL() Methode gespeichert. Wenn nicht wir die writeRaster() Methode aus dem raster Paket benutzt.

Wenn Sie die #passfilename Option verwendet haben, werden Ausgaben anhand des raster Paketes erstellt (mit writeRaster()), trotzdessen es nicht für Eingaben verwendet wird.

Wenn Ihr Algorithmus keinen Layer erzeugt sondern stattdessen ein Textergebnis in der Konsole, müssen Sie angeben, dass die Konsole gezeigt wird, nachdem die Ausführung beendet ist. Um das zu tun starten Sie die Kommandozeilen, die die Ergebnisse produzieren, die Sie mit dem > (größer) Zeichen drucken wollen. Die Ausgabe aller anderen Zeilen wird nicht gezeigt. Zum Beispiel ist hier die Beschreibungsdatei eines Algorithmus, der einen Test auf Normalverteilung mit einem vorhandenen Feld (Spalte) eines Vektorlayerattributes durchführt:

##layer=vector
##field=field layer
##nortest=group
library(nortest)
>lillie.test(layer[[field]])

Die Ausgabe der letzten Zeile wird gedruckt, die Ausgabe der ersten aber nicht (und auch nicht die Ausgaben von anderen Kommandozeilen, die automatisch von QGIS hinzugefügt werden).

Wenn Ihr Algorithmus eine Grafiken erstellt (mit der plot()-Methode), fügen Sie die folgende Zeile ein:

##showplots

Dies bewirkt, dass QGIS alle grafischen Ausgaben von R in eine temporäre Datei, die geöffnet wird nachdem die Ausführung von R beendet wurde, umleitet.

Sowohl grafische als auch Konsolenergebnisse werden im Verarbeitung Ergebnisanzeige gezeigt.

Für weitere Informationen schauen Sie sich bitte die Skript-Dateien an, die Verarbeitung bereits enthält. Die meisten von ihnen sind ziemlich einfach und werden wesentlich dazu beitragen, wie Sie Ihre eigenen erstellen.

GRASS¶

Die Konfiguration von GRASS ist nicht viel anders als die Konfiguration von SAGA. Zuerst muss der Pfad zu dem Ordner GRASS definiert werden, aber nur, wenn Sie Windows verwenden. Zusätzlich gibt es einen Shell-Interpreter (in der Regel: msys.exe, den Sie in den meisten GRASS für Windows-Distributionen finden) der definiert werden muss, genauso wie der Pfad dorthin.

Standardmäßig versucht die Verarbeiten Umgebung seine GRASS Verbindung so zu kofigurieren, dass die GRASS-Distribution, die mit QGIS geliefert wird, benutzt werden kann. Dies sollte ohne Probleme in den meisten Systemen funktionieren, aber wenn Probleme auftauchen, müssen Sie vielleicht die GRASS Verbindung manuell konfigurieren. Auch wenn Sie eine andere GRASS Installation benutzen wollen, können Sie diese Einstellung ändern und auf den Ordner , wo die andere Version installiert ist, verweisen. Damit die Algorithmen korrekt funktionieren wird GRASS 6.4. benötigt.

Wenn Sie Linux verwenden, müssen Sie nur noch sicherstellen, dass GRASS richtig installiert ist, und dass es problemlos von einer Konsole ausgeführt werden kann.

GRASS Algorithmen verwenden eine Region für die Berechnungen. Diese Region kann manuell definiert werden unter Verwendung von Werten ähnlich denen, die in der SAGA Konfiguration stehen oder automatisch, wobei die minimale Ausdehnung aller Eingangslayer verwendet werden, wenn der Algorithmus ausgeführt wird. Wenn dies das Verhalten ist, das Sie bevorzugen, können Sie es über die Option Verwende min abdecken Region in den GRASS Konfigurationsparametern definieren.

Der letzte Parameter, der konfiguriert werden muss, bezieht sich auf die Mapset. Eine Mapset wird benötigt um GRASS benutzen zu können und die Verarbeiten Umgebung erstellt eine temporäre für jede Ausführung. Sie müssen angeben, ob die Daten, mit denen Sie arbeiten Geografische (lat/lon) Koordinaten oder projezierte verwenden.

GDAL¶

Ist keine zusätzliche Konfiguration erforderlich, um GDAL Algorithmen laufen zu lassen. Da es bereits in QGIS integriert ist, können die Algorithmen ihre Konfiguration davon ableiten.

Orfeo Toolbox¶

Orfeo Toolbox (OTB) Algorithmen können von QGIS aus ausgeführt werden wenn Sie OTB auf Ihrem System installiert haben und Sie QGIS richtig konfiguriert haben, so dass es alle notwendigen Dateien finden kann (Kommandozeilentools und Bibliotheken).

Wie im Fall von SAGA sind OTB Binärpakete im Installationspaket für Windows enthalten, sie sind aber nicht enthalten wenn Sie Linux benutzen, also müssen Sie die Software selber downloaden und installieren. Bitte überprüfen Sie die OTB Webseite für weitere Informationen.

Starten Sie QGIS nachdem OTB installiert wurde, öffnen Sie den Verarbeitungsoptionen Dialog und konfigurieren Sie den OTB Algorithmus Provider. Im Orfeo Toolbox (Image analysis) Block finden Sie alle für OTB relevanten Einstellungen. Stellen Sie zuerst sicher, dass die Algorithmen aktiviert sind.

Konfigurieren Sie dann den Pfad zu dem Ordner wo die ORB Kommandozeilentools und -bibliotheken installiert sind:

• Normalerweise verweist der OTB applications folder zu /usr/lib/otb/applications und der OTB command line tools folder zu /usr/bin.

• Wenn Sie den OSGeo4WInstaller benutzen, installieren Sie das otb-bin Paket und geben Sie C:\OSGeo4W\apps\orfeotoolbox\applications als OTB applications folder und C:\OSGeo4W\bin as OTB command line tools folder ein. Diese Werte sollten standardmäßig konfiguriert werden, aber wenn Sie eine abweichende OTB Installation durchgeführt haben, konfigurieren Sie sie auf die entsprechenden Werte in Ihrem System.

TauDEM¶

Um diesen Provider zu verwenden müssen Sie TauDEM Kommandozeilentools installieren.