QGIS 2.6 UserGuide de

Als pdf oder txt herunterladen
Als pdf oder txt herunterladen
Sie sind auf Seite 1von 757

QGIS User Guide

Release 2.6

QGIS Project

12.01.2015

Inhaltsverzeichnis

Prambel

Gebrauch der Dokumentation


2.1 GUI Schreibstile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Text oder Tastatur Schreibstile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3 Betriebssystemspezifische Anweisungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5
5
5
6

Vorwort

Funktionalitten
4.1 Daten visualisieren . . . . . . . . . . . . . . . . . .
4.2 Daten erkunden, abfragen und Karten layouten . . .
4.3 Daten erstellen, editieren, verwalten und exportieren
4.4 Daten analysieren . . . . . . . . . . . . . . . . . .
4.5 Karten im Internet verffentlichen . . . . . . . . . .
4.6 Erweiterte QGIS Funktionalitt durch Erweiterungen
4.7 Python-Konsole . . . . . . . . . . . . . . . . . . .
4.8 Bekannte Probleme . . . . . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

9
9
9
10
10
10
10
11
12

Was ist neu in QGIS 2.6


5.1 Anwendungen und Projektoptionen
5.2 Datenprovider . . . . . . . . . . .
5.3 Kartenzusammenstellung . . . . .
5.4 QGIS Server . . . . . . . . . . . .
5.5 Darstellung . . . . . . . . . . . . .
5.6 Benutzeroberflche . . . . . . . . .

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

13
13
13
13
14
14
14

Der erste Einstieg


6.1 Installation . . . . . . . . . .
6.2 Beispieldaten . . . . . . . . .
6.3 Ein erstes bungsbeispiel . .
6.4 QGIS Starten und Beenden .
6.5 Optionen der Kommandozeile
6.6 QGIS Projekte . . . . . . . .
6.7 Ausgabe . . . . . . . . . . .

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

15
15
15
16
17
17
19
20

QGIS GUI
7.1 Menleiste . .
7.2 Werkzeugleiste
7.3 Legende . . .
7.4 Kartenfenster .
7.5 Statusleiste . .

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

21
22
28
29
31
32

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

33
33
33
33
35
37
38
41
42
43

QGIS Konfiguration
9.1 Bedienfelder und Werkzeugksten
9.2 Projekteigenschaften . . . . . . .
9.3 Optionen . . . . . . . . . . . . .
9.4 Anpassung . . . . . . . . . . . .

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

45
45
46
46
55

10 Arbeiten mit Projektionen


10.1 berblick zur Projektionsuntersttzung . . .
10.2 Bestimmung einer globalen Projektion . . .
10.3 On-The-Fly (OTF) Projektion . . . . . . . .
10.4 Eigenes Koordinatenbezugssystem definieren
10.5 Standard Datumtransformationen . . . . . .

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

57
57
57
59
60
61

Allgemeine Werkzeuge
8.1 Tastenkrzel . . . . . . .
8.2 Hilfe . . . . . . . . . . .
8.3 Layeranzeige kontrollieren
8.4 Messen . . . . . . . . . .
8.5 Objekte abfragen . . . . .
8.6 Dekorationen . . . . . . .
8.7 Beschriftungstools . . . .
8.8 Rumliche Lesezeichen .
8.9 Layer/Gruppen einbinden

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

11 QGIS Browser
12 Arbeiten mit Vektordaten
12.1 Untersttzte Datenformate
12.2 The Symbol Library . . .
12.3 Vektorlayereigenschaften
12.4 Expressions . . . . . . . .
12.5 Editierfunktionen . . . . .
12.6 Abfrageeditor . . . . . . .
12.7 Feldrechner . . . . . . . .

63

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

65
65
78
83
112
118
137
139

13 Arbeiten mit Rasterdaten


143
13.1 Arbeiten mit Rasterdaten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
13.2 Dialogfenster Rasterlayereigenschaften . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
13.3 Rasterrechner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
14 Arbeiten mit OGC Daten
155
14.1 QGIS als OGC Datenclient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
14.2 QGIS als OGC Datenserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
15 Arbeiten mit GPS Daten
171
15.1 GPS Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
15.2 Live GPS tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
16 GRASS GIS Integration
16.1 GRASS Plugin starten . . . . . . . . . . . . . . . . . .
16.2 GRASS Layer visualisieren . . . . . . . . . . . . . . .
16.3 Information zur GRASS-Datenbank . . . . . . . . . . .
16.4 Daten in eine GRASS LOCATION importieren . . . . .
16.5 Das GRASS Vektormodell . . . . . . . . . . . . . . . .
16.6 Einen neuen GRASS Vektorlayer erstellen . . . . . . .
16.7 Digitalisieren und Editieren eines GRASS Vektorlayers
16.8 Einstellung der GRASS Region . . . . . . . . . . . . .
16.9 Die GRASS Werkzeugkiste . . . . . . . . . . . . . . .

ii

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

181
181
182
182
185
186
187
187
191
191

17 QGIS Verarbeitung Umgebung


17.1 Einfhrung . . . . . . . . . . . . . . . . . . . . . . . . .
17.2 Die Werkzeugkiste . . . . . . . . . . . . . . . . . . . . .
17.3 Die Grafische Modellierung . . . . . . . . . . . . . . . .
17.4 Die Stapelproze Schnittstelle . . . . . . . . . . . . . . .
17.5 Verarbeitung Algorithmen von der Konsole aus verwenden
17.6 Das Protokoll . . . . . . . . . . . . . . . . . . . . . . . .
17.7 Writing new Processing algorithms as python scripts . . .
17.8 Handing data produced by the algorithm . . . . . . . . .
17.9 Communicating with the user . . . . . . . . . . . . . . .
17.10 Documenting your scripts . . . . . . . . . . . . . . . . .
17.11 Beispielskripte . . . . . . . . . . . . . . . . . . . . . . .
17.12 Best practices for writing script algorithms . . . . . . . .
17.13 Pre- and post-execution script hooks . . . . . . . . . . . .
17.14 Konfiguration externer Anwendungen . . . . . . . . . . .
17.15 The QGIS Commander . . . . . . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

203
203
203
213
219
221
227
228
230
230
231
231
231
231
232
239

18 Processing providers and algorithms


18.1 GDAL algorithm provider . . . .
18.2 LAStools . . . . . . . . . . . . .
18.3 Modeler Tools . . . . . . . . . .
18.4 OrfeoToolbox algorithm provider
18.5 QGIS algorithm provider . . . . .
18.6 R algorithm provider . . . . . . .
18.7 SAGA algorithm provider . . . .
18.8 TauDEM algorithm provider . . .

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

241
241
274
299
301
376
430
440
611

19 Druckzusammenstellung
19.1 Erste Schritte . . . . . . . . . . . . . . . . . . .
19.2 Darstellung . . . . . . . . . . . . . . . . . . . .
19.3 Zusammenstellungselemente . . . . . . . . . . .
19.4 Elemente verwalten . . . . . . . . . . . . . . .
19.5 Schritte rckgngig machen und wiederherstellen
19.6 Atlas-Erzeugung . . . . . . . . . . . . . . . . .
19.7 Eine Ausgabe erzeugen . . . . . . . . . . . . .
19.8 Die Druckzusammenstellung verwalten . . . . .

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

643
644
648
650
673
675
675
677
679

20 Erweiterungen
20.1 QGIS Erweiterungen . . . . . . . .
20.2 QGIS Kernplugins verwenden . . .
20.3 Koordinaten aufnehmen Plugin . .
20.4 DB Manager Plugin . . . . . . . .
20.5 Dxf2Shape Konverter Plugin . . . .
20.6 eVis Plugin . . . . . . . . . . . . .
20.7 fTools Plugin . . . . . . . . . . . .
20.8 GDALTools Plugin . . . . . . . . .
20.9 Georeferenzier Plugin . . . . . . .
20.10 Interpolationsplugin . . . . . . . .
20.11 Offline-Bearbeitung Plugin . . . . .
20.12 Oracle-Spatial-GeoRaster Plugin .
20.13 Rastergelndeanalyse-Erweiterung
20.14 Heatmap-Erweiterung . . . . . . .
20.15 MetaSearch Katalog Client . . . . .
20.16 Straengraph Plugin . . . . . . . .
20.17 Rumliche Abfrage Plugin . . . . .
20.18 SPIT Plugin . . . . . . . . . . . .
20.19 SQL-Anywhere Plugin . . . . . . .
20.20 Topologieprfung Erweiterung . . .
20.21 Zonenstatistikerweiterung . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

681
681
686
686
687
688
689
699
702
705
710
711
711
714
715
717
723
724
725
726
726
729

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

iii

21 Hilfe und Support


21.1 Mailinglisten
21.2 IRC . . . . .
21.3 BugTracker .
21.4 Blog . . . .
21.5 Plugins . . .
21.6 Wiki . . . .

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

731
731
732
732
733
733
733

22 Anhang
735
22.1 GNU General Public License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735
22.2 GNU Free Documentation License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739
23 Literatur und Internetreferenzen

747

Stichwortverzeichnis

749

iv

QGIS User Guide, Release 2.6

.
.

Inhaltsverzeichnis

QGIS User Guide, Release 2.6

Inhaltsverzeichnis

KAPITEL 1

Prambel

Dieses Werk ist das offizielle Handbuch zur Benutzung und Installation der Software QGIS. Die in diesem Werk
genannten Soft- und Hardwarebezeichnungen sind in den meisten Fllen auch eingetragene Warenzeichen und
unterliegen als solche den gesetzlichen Bestimmungen. QGIS ist unter der GNU General Public License verffentlicht. Weitere Informationen finden Sie auf der Quantum GIS Homepage http://www.qgis.org.
Die in diesem Werk enthaltenen Angaben, Daten, Ergebnisse usw. wurden von den Autoren nach bestem Wissen
erstellt und mit Sorgfalt berprft. Dennoch sind inhaltliche Fehler nicht vllig auszuschlieen.
Daher erfolgen alle Angaben ohne jegliche Verpflichtung oder Garantie. Die Autoren und Herausgeber
bernehmen aus diesem Grund auch keinerlei Verantwortung oder Haftung fr Fehler und deren Folgen.Hinweise
auf eventuelle Irrtmer werden gerne entgegengenommen.
Dieses Dokument ist mit reStructuredText gesetzt. Es ist als reST Quellcode erhltlich unter github und kann
online als HTML und PDF angeschaut bzw. heruntergeladen werden. Weitere Informationen darber wie Sie an
diesem Dokument mitwirken und bersetzen knnen finden Sie auf http://www.qgis.org/wiki/.
Verweise in diesem Dokument
Das Dokument enthlt interne und externe Verweise. Wenn Sie auf einen internen Verweis klicken dann springen
Sie innerhalb des Dokuments whreddessen sich wenn Sie auf einen externen Verweis klicken eine Internetadresse
ffnet. Im PDF sind interne Verweise blau und externe Verweise grn dargestellt. Klicken Sie auf einen grnen
Verweis dann wird mit Ihrem Webbrowser eine Seite im Internet geffnet. In der HTML Version sind die Farben
der Verweise identisch.
Autoren des englischsprachigen User Guides:
Tara Athan
Peter Ersts
Werner Macho
Claudia A. Engel
Larissa Junek
Tim Sutton
Astrid Emde

Radim Blazek
Anne Ghisla
Carson J.Q. Farmer
Brendan Morely
Diethard Jansen
Alex Bruy
Yves Jacolin

Godofredo Contreras
Stephan Holl
Tyler Mitchell
David Willis
Paolo Corti
Raymond Nijssen
Alexandre Neto

Otto Dassau
N. Horning
K. Koy
Jrgen E. Fischer
Gavin Macaulay
Richard Duivenvoorde
Andy Schmid

Martin Dobias
Magnus Homann
Lars Luthman
Marco Hugentobler
Gary E. Sherman
Andreas Neumann
Hien Tran-Quang

Copyright (c) 2004 - 2014 QGIS Development Team


Internet: http://www.qgis.org
Lizenz des Dokuments
Es wird die Erlaubnis gewhrt, dieses Dokument zu kopieren, zu verteilen und/oder zu modifizieren, unter den
Bestimmungen der GNU Free Documentation License, Version 1.3 oder jeder spteren Version, verffentlicht von
der Free Software Foundation; ohne unvernderliche Abschnitte, ohne vordere Umschlagtexte und ohne hintere
Umschlagtexte. Eine Kopie der Lizenz wird im Kapitel GNU Free Documentation License bereitgestellt.
.

QGIS User Guide, Release 2.6

Kapitel 1. Prambel

KAPITEL 2

Gebrauch der Dokumentation

Dieser Abschnitt beschreibt die in diesem Handbuch benutzten einheitlichen Schreibstile.

2.1 GUI Schreibstile


Die GUI Schreibstile der sollen das Erscheinungsbild der Grafischen Benutzeroberflche nachahmen. Im Allgemeinen gibt ein Stil das einfache Erscheinungsbild wieder, so dass der Benutzer die GUI nach etwas das wie die
Instruktionen im Handbuch aussieht absuchen kann.
Men Optionen: Layer Rasterlayer hinzufgen oder Einstellungen Werkzeugkasten Digitalisierung
Werkzeug:

Rasterlayer hinzufgen

Knopf : [Speicher als Standard]


Titel einer Dialogbox: Layereigenschaften
Reiter: Allgemein
Kontrollkstchen:
Radio Button:

Darstellen
Postgis SRID

EPSG ID

Whle eine Zahl:


Whle ein Wort:
Suche nach einer Datei:
Whle eine Farbe:
Schieberegler:
Eingabetext:
Ein Schatten zeigt, dass dieses GUI Element mit der Maus anwhlbar ist.

2.2 Text oder Tastatur Schreibstile


Dieses Handbuch enthlt auch Stile die sich auf Texte, Tastaturbefehle und Code beziehen um verschiedene Einheiten, wie Klassen und Methoden anzuzeigen. Diese Stile entsprechen nicht dem tatschlichen Aussehen von
Texten oder Codezeilen innerhalb von QGIS.
Querverweise: http://qgis.org
Tastenkombinationen: Drcken Sie Strg+B, was heisst dass Sie doe Strg-Taste drcken und halten sollen
und dann die B-Taste drcken sollen.
5

QGIS User Guide, Release 2.6

Name einer Datei: lakes.shp


Name einer Klasse:New Layer
Methode: classFactory
Server: myhost.de
User Text: qgis --help
Kodezeilen werden durch eine Schriftart mit festgelegter Breite angezeigt:
PROJCS["NAD_1927_Albers",
GEOGCS["GCS_North_American_1927",

2.3 Betriebssystemspezifische Anweisungen


GUI Sequenzen und kleine Textzeilen werden wie folgt formatiert: Klicken Sie
Datei
QGIS QGIS
beenden. Dies beschreibt dass Sie unter Linux, Unix und Windows Betriebssystemen erst das Datei-Men und
dann QGIS beenden klicken sollen whrend Sie unter dem Macintosh OS X Betriebssystem erst das QGISMen klicken und dann Verlassen klicken sollen.
Grere Texte knnen als Liste formatiert werden:

Mache dies

Mache das

Mache etwas anderes

oder als Paragraph


Mache dies und dies und dies. Dann mache dies und dies und dies, und dies und dies und dies, und dies und
dies und dies.
Tun Sie das. Dann tun sie das und das und das, das und das und , das und das und das, das und das und das, das
und das und das.
Abbildungen innerhalb der Dokumentation knnen unter verschiedenen Betriebssystemen erstellt worden sein.
Das jeweilige Betriebssystem wird dabei am Ende der Abbildungsberschrift mit einem Icon angezeigt.
.

Kapitel 2. Gebrauch der Dokumentation

KAPITEL 3

Vorwort

Willkommen in der wunderbaren Welt der Geographischen Informationssysteme (GIS)!


QGIS ist ein Freies (Open Source) GIS. Die Idee zu dem Projekt wurde im Mai 2002 geboren und bereits im
Juni desselben Jahres bei SourceForge etabliert. Wir haben hart daran gearbeitet, traditionell sehr teure GIS Software kostenfrei fr jeden, der Zugang zu einem PC hat, bereitzustellen. QGIS kann unter den meisten Unices,
Windows und MacOSX betrieben werden. QGIS wurde mit Hilfe des Qt toolkit (http://qt.nokia.com) und C++ entwickelt. Dadurch ist QGIS sehr benutzerfreundlich und besitzt eine einfach zu bedienende und intuitive grafische
Benutzeroberflche.
QGIS soll ein einfach zu benutzendes GIS sein und grundlegende GIS-Funktionalitten bieten. Das anfngliche
Ziel bestand darin, einen einfachen Geo-Datenviewer zu entwickeln. Dieses Ziel wurde bereits mehr als erreicht, so dass QGIS mittlerweile von vielen Anwendern fr ihre tgliche Arbeit eingesetzt wird. QGIS untersttzt
eine Vielzahl von Raster- und Vektorformaten. Mit Hilfe der Plugin-Architektur knnen weitere Funktionalitten
einfach ergnzt werden.
QGIS wird unter der GNU Public License (GPL) herausgegeben. Fr die Entwicklung des Programms bedeutet
dies das Recht, den Quellcode einzusehen und entsprechend der Lizenz verndern zu drfen. Fr die Anwendung der Software ist damit garantiert, dass QGIS kostenfrei aus dem Internet heruntergeladen, genutzt und weitergegeben werden kann. Eine vollstndige Kopie der Lizenz ist dem Programm beigefgt und kann auch im
Appendix GNU General Public License eingesehen werden.
Tipp: Aktuellste Dokumentation
Die aktuellste Version dieses Dokuments knnen Sie immer im Dokumentationsbereich der QGIS Internetseite
unter http://www.qgis.org/en/docs/ finden.
.

QGIS User Guide, Release 2.6

Kapitel 3. Vorwort

KAPITEL 4

Funktionalitten

QGIS bietet viele allgemeine GIS Funktionen die durch Kernfunktionen und Erweiterungen bereitgestellt werden.
Eine kurze Zusammenfassung von sechs allgemeinen Kategorien von Funktionen und Erweiterungen wird unten
dargestellt, gefolgt von ersten Einblicken in die integrierte Python-Konsole.

4.1 Daten visualisieren


Es ist mglich, Vektor- und Rasterdaten in unterschiedlichen Formaten und aus verschiedenen Projektionen
anzuschauen und zu berlagern, ohne die Daten selbst in irgendeiner Art und Weise konvertieren zu mssen.
Zu den untersttzten Datenformaten gehren z.B.:
Tabellen und Views aus rumlichen Datenbanken wie PostGIS, SpatiaLite und MS SQL Spatial, Oracle
Spatial, Vektorformate die durch die installierte OGR Bibliothek untersttzt werden, darunter ESRI Shapedateien, MapInfo, SDTS, GML und viele mehr. Siehe Kapitel Arbeiten mit Vektordaten.
Raster- und Bilddatenformate die von der installierten GDAL (Geospatial Data Abstraction Library) Bibliothek untersttzt werden wiie z.B. GeoTIFF, ERDAS IMG, ArcInfo ASCII GRID, JPEG, PNG und viele
mehr. Siehe Kapitel Arbeiten mit Rasterdaten.
GRASS Raster- und Vektordaten aus GRASS Datenbanken (Location/Mapset). Siehe Kapitel GRASS GIS
Integration.
Online Geodaten welche als OGC Webdienst, darunter WMS, WMTS, WCS, WFS und WFS-T, bereitgestellt werden. Siehe Kapitel Arbeiten mit OGC Daten.

4.2 Daten erkunden, abfragen und Karten layouten


Sie knnen Karten zusammenstellen und interaktiv rumliche Daten mit einer benutzerfreundlichen GUI erkunden. Die vielen in der GUI erhltlichen hilfreichen Werkzeuge beinhalten:
QGIS Browser
Spontanreprojektion
DB Manager
Drucklayouts erstellen mit dem Map Composer
Kartenbersichtsfenster
Rumliche Bookmarks
Beschriftungswerkzeuge
Identifizieren/Selektieren von Objekten
Editieren/Visualisieren/Suchen von Attributdaten

QGIS User Guide, Release 2.6

Datendefiniertes Beschriften von Objekten


Datendefinierte Vektor- und Rastersymbolisierungswerkzeuge
Atlas Kartenzusammenstellung mit Gradnetz-Layern
Nordpfeil, Mastab und Urheberrechtsnachweis
Untersttzung fr das Speichern und Wiederherstellen von Projekten

4.3 Daten erstellen, editieren, verwalten und exportieren


Sie knnen Vektor- und Rasterlayer erstellen, bearbeiten und in zahlreiche Formate exportieren. QGIS bietet die
folgenden an:
Digitalisierwerkzeuge fr OGR-untersttzte Formate und GRASS Vektorlayer
Fhigkeit Shapedateien und GRASS Vektorlayer zu erstellen und zu bearbeiten
Georeferenzierungsplugin um Bilder zu geocodieren
GPS Werkzeuge um das GPX Format zu importieren und exportieren und andere GPS Format in GPS
Format zu konvertieren oder um direkt in ein GPS Gert runter/hochzuladen (Unter Linux ist usb: zur Liste
der GPS Gerte hinzugefgt worden.)
Untersttzung fr das Darstellen und Bearbeiten von OpenStreetMap Daten
Fhigkeit rumliche Datenbanktabellen aus Shapedateien mittels des DB Manager Plugins zu erstellen
Verbesserte Handhabung von rumlichen Datenbanktabellen
Werkzeuge um Vektorattributtabellen zu verwalten
Mglichkeit Screenshots als georeferenzierte Bilder zu speichern

4.4 Daten analysieren


Sie knnen rumliche Datenanalysen auf rumliche Datenbanken und andere OGR-untersttzte Formate anwenden. QGIS bietet zur Zeit Vektoranalysen, Sampling, Geoverarbeitung sowie Geometrie und Datenbankmanagementwerkzeuge. Sie knnen auch die integrierten GRASS Werkzeuge, die die komplette GRASS Funktionalitt
von mehr als 400 Modulen beinhalten, benutzen. (Siehe Kapitel GRASS GIS Integration .). Oder Sie arbeiten
mit dem Verarbeitungs Plugin, das eine mchtige rumliche Analyseumgebung zur Verfgung stellt mit dem man
native oder Drittanbieter-Algorithmen aus QGIS heraus aufrufen kann, z.B. GDAL, SAGA, fTools und weitere.
(Siehe Kapitel Einfhrung.)

4.5 Karten im Internet verffentlichen


QGIS kann als WMS, WMTS, WMS-C oder WFS und WFS-T Client und als WMS, WCS oder WFS Server
benutzt werden. (Siehe Kapitel Arbeiten mit OGC Daten.) Zustzlich knnen Sie Ihre Daten im Internet verffentlichen in dem Sie einen mit UMN MapServer oder GeoServer installierten Webserver verwenden.

4.6 Erweiterte QGIS Funktionalitt durch Erweiterungen


QGIS kann an Ihre speziellen Bedrfnisse mit seiner erweiterbaren Pluginarchitektur und Bibliotheken die zum
Erstellen von Plugins benutzt werden knnen angepasst werden. Sie knnen sogar neue Anwendungen mit C++
oder Python erstellen!

10

Kapitel 4. Funktionalitten

QGIS User Guide, Release 2.6

4.6.1 Kern Plugins


Kernplugins sind:
1. Koordinaten aufnehmen (Nehmen Sie Mauskoordinaten in verschiedenen KBS auf)
2. DB Manager (Austauschen, Bearbeiten und Darstellen von Layern und Tabellen; Ausfhren von SQL
Abfragen.
3. Diagram Overlay (Place diagrams on vector layers)
4. Dxf2Shp-Konverter (DXF Dateien zu Shapedateien konvertieren)
5. eVis (Events visualisieren)
6. fTools (Vektordaten analysieren und verwalten)
7. GDALTools (Integration von GDALTools in QGIS)
8. GDAL-Georeferenzierung ( Rasterdateien Projektionsinformationen hinzufgen mit GDAL)
9. GPS Werkzeuge (GPS Daten laden und importieren)
10. GRASS (GRASS GIS integrieren)
11. Heatmap (Erzeuge ein Heatmap-Raster aus Punktdaten)
12. Interpolationserweiterung (Interpolation basierend auf Sttzpunkten von Vektorlayern)
13. Offline-Bearbeitung (Ermglicht Offline-Bearbeitung und Synchronisation mit Datenbanken)
14. Oracle Spatial GeoRaster
15. Verarbeitung (vorher SEXTANTE)
16. Rastergelndeanalyse-Erweiterung (rasterbasierte Gelndeanalyse)
17. Straengraph-Erweiterung (Analysiert ein krzeste-Wege-Netzwerk)
18. Rumliche Abfrage Plugin
19. SPIT (Importiert Shapedateien nach PostgreSQL/PostGIS)
20. SQL Anywhere Erweiterung (Speichern von Vektorlayern in einer SQL Anywhere - Datenbank)
21. Topologie-Prfung (Topologische Fehler in Vektorlayern finden)
22. Zonenstatistikerweiterung ( Berechnet Anzahl, Summe und Mittel eines Rasters fr jedes Polygon eines
Vektorlayers)

4.6.2 Externe Python Plugins


QGIS bietet eine steigende Anzahl von externen Python Plugins, die von der Community bereitgestellt werden, an.
Diese Plugins werden in dem offiziellen Plugins Repository vorgehalten und knnen auf einfache Art und Weise
mit der Python Plugin Installation installiert werden. Siehe Kapitel Der Erweiterungen Dialog.

4.7 Python-Konsole
Um Skripte zu erstellen ist es mglich die integrierte Python-Konsole zu benutzen die mit dem Men Erweiterungen Python-Konsole geffnet werden kann. Die Konsole ffnet sich als nicht-modales Utility-Fenster. Fr
das Zusammenspiel mit der QGIS Umgebung gibt es die qgis.utils.iface Variable, die eine Instanz von
QgsInterface ist. Diese Schnittstelle ermglicht den Zugang zum Kartenfenster, Mens, Werkzeugleisten und
anderen Teilen der QGIS Anwendung.
Weitere Informationen zum Arbeiten mit der Python-Konsole und das Programmieren von QGIS Plugins und
Anwendungen finden Sie unter http://www.qgis.org/html/en/docs/pyqgis_developer_cookbook/index.html.

4.7. Python-Konsole

11

QGIS User Guide, Release 2.6

4.8 Bekannte Probleme


4.8.1 Begrenzung der Anzahl von geffneten Dateien
Wenn Sie ein groes QGIS Projekt ffnen und Sie sicher sind dass alle Layer gltig sind aber einige Layer
als schlecht markiert sind stehen Sie wahrscheinlich vor diesem Problem. Linux (und auch andere Bs) hat eine
prozessbezogene Begrenzung von geffneten Dateien. Ressourcengrenzen beziehen sich auf einen Prozess und
werden vererbt. Der ulimit Befehl, den die Shell zur Verfgung stellt, verndert die Begrenzung nur fr den
aktuellen Shell-Prozess; die neue Begrenzung wird von allen untergeordneten Prozessen geerbt.
Sie knnen sich die Informationen zu ulimit anzeigen lassen indem Sie folgenden Befehl eingeben
user@host:~$ ulimit -aS

Sie knnen die aktuell zulssige Anzahl von geffneten Dateien pro Prozess mit dem folgenden Befehl in der
Konsole sehen
user@host:~$ ulimit -Sn

Um die Begrenzungen fr eine vorhandene Sitzung zu ndern, knnen Sie so etwas verwenden
user@host:~$ ulimit -Sn #number_of_allowed_open_files
user@host:~$ ulimit -Sn
user@host:~$ qgis

Um es fr immer zu beheben
Unter den meisten Linux Systemen werden die Ressourcenbegrenzungen beim Login durch
das pam_limits Modul gem den Einstellungen in etc/security/limits.conf oder
/etc/security/limits.d/*.conf eingestellt. Sie mssten in der Lage sein die Dateien zu editieren wenn Sie Root-Rechte haben (auch ber sudo), die nderungen jedoch werden erst wirksam wenn Sie sich
erneut anmelden.
Mehr Informationen:
http://www.cyberciti.biz/faq/linux-increase-the-maximum-number-of-open-files/ http://linuxaria.com/article/openfiles-in-linux?lang=en
.

12

Kapitel 4. Funktionalitten

KAPITEL 5

Was ist neu in QGIS 2.6

Diese Verffentlichung enthlt neue Features und erweitert die Programmierschnittstelle vorhergehender Versionen. Wir empfehlen dass Sie diese Version statt der vorherigen Verffentlichungen benutzen.
Diese Version enthlt hunderte Fehlerkorrekturen und viele neue Funktionen und Verbesserungen die
in diesem Handbuch beschrieben werden. Sie knnen dazu auch den visuellen Changelog unter
http://changelog.linfiniti.com/qgis/version/2.6.0/ berprfen.

5.1 Anwendungen und Projektoptionen


Projektdateiname in Eigenschaften: Sie knnen jetzt den vollstndigen Pfad fr das QGIS-Projekt im
Projekteigenschaften Dialog sehen.

5.2 Datenprovider
DXF Exportwerkzeugverbesserungen:
Baumansicht und Attributauswahl fr die Layerzuweisung im Dialog
Untersttzung fr Flchenfllung/SCHRAFFUR
Texte als MTEXT statt TEXT ausgeben (einschlielich Text, Neigung und Dicke)
Untersttzung fr RGB-Farbe, wenn es keinen genaue Farbbereinstimmung gibt
AutoCAD 2000-DXF (R15) statt R12 nutzen

5.3 Kartenzusammenstellung
Ausmae in der Karte anzeigen: Auf das Element in den Elementeigenschaften gibt es jetzt zwei zustzliche Knpfe die es Ihnen ermglichen (1) den Kartenausschnitt entsprechend dem Ausma Ihres
Kartenelementes einzustellen und (2) in der Kartenansicht die aktuell fr das Kartenelement festgelegten Ausmae darzustellen.
Untersttzung fr mehrere Gitter: Es ist jetzt mglich mehr als ein Gitter in Ihr Kartenelement einzufgen. Jedes Gitter ist vollstndig anpasspar und kann einem unterschiedlichen KBS zugeordnet werden. Das
heit zum Beispiel dass Sie jetzt ein Kartenlayout sowohl mit geografischem wie projeziertem Gitter erstellen knnen.
Selektiver Export: Sie knnen bei jedem Element Ihres Druckzusammenstellungslayouts unter den Darstellungsoptionen das Objekt vom Kartenexport ausschlieen.

13

QGIS User Guide, Release 2.6

5.4 QGIS Server


5.5 Darstellung
5.6 Benutzeroberflche
.

14

Kapitel 5. Was ist neu in QGIS 2.6

KAPITEL 6

Der erste Einstieg

Dieses Kapitel gibt einen schnellen berblick ber das Installieren von QGIS, einige Beispieldaten von der QGIS
Internetseite und das erste Starten sowie eine einfache Sitzung bei der Raster- und Vektorlayer visualisiert werden.

6.1 Installation
Die Installation von QGIS ist sehr einfach. Fr MS Windows und Mac OS X sind Standardinstallationspakete
erhltlich. Fr viele GNU/Linux Betriebssysteme stehen Binrpakete (rpm und deb) oder Softwarerepositories die
Ihrem Installationsmanager hinzugefgt werden knnen zur Verfgung. Holen Sie sich die neuesten Informationen
ber Binrpakete von der QGIS Internetseite unter http://download.qgis.org.

6.1.1 Kompilieren des Quellcodes


Wenn Sie QGIS aus dem Quellcode installieren lesen Sie bitte in den Installationsanweisungen nach. Werden
mit dem QGIS Quellcode in einer Datei mit dem Namen INSTALL vetrieben. Sie knnen Sie auch online unter
http://htmlpreview.github.io/?https://raw.github.com/qgis/QGIS/master/doc/INSTALL.html finden.

6.1.2 Installation auf externen Medien


Unter QGIS knnen Sie eine --configpath Einstellung die den Standardpfad fr die Benutzerkonfiguration
berschreibt (z.B. ~/.qgis2 unter Linux) und QSettings zwingt dieses Verzeichnis auch zu benutzen. So knnen Sie z.B. eine QGIS Installation auf einem Flashlaufwerk mit allen Plugins und Einstellungen durchfhren.
Siehe Kapitel Men System fr zustzliche Informationen.

6.2 Beispieldaten
Die Dokumentation zeigt eine Reihe von Beispielen, die auf den Geodaten des QGIS Beispieldatensatzes basieren.
Whrend der Installation unter Windows gibt es die Option, den QGIS Beispieldatensatz mit herunterzuladen.
Wenn die Option ausgewhlt wurde, werden die Daten nach Eigene Dateien in den Ordner GIS Database heruntergeladen. Mit dem Windows Explorer knnen Sie die Daten bei Bedarf nachtrglich in ein anderes Verzeichnis
verschieben. Wenn Sie die Option bei der Installation nicht ausgewhlt haben, knnen Sie
bereits auf Ihrem Rechner vorhandene GIS Daten verwenden
den QGIS Beispieldatensatz nachtrglich von http://download.osgeo.org/qgis/data/qgis_sample_data.zip
herunterladen
QGIS deinstallieren, wieder neu installieren und dabei die entsprechende Option auswhlen, wenn die oben
angesprochenen Optionen nicht funktionieren.

15

QGIS User Guide, Release 2.6

Fr GNU/Linux und Mac OSX wird momentan noch kein fertiges Installationspaket fr den Beispieldatensatz als rpm, deb or dmg bereitgestellt. Sie mssen die Datei qgis_sample_data als ZIP- oder TAR-Archiv
von der URL http://download.osgeo.org/qgis/data/qgis_sample_data.zip herunterladen und auf Ihrem Rechner entpacken.
Der QGIS Beispieldatensatz enthlt Geodaten von Alaska und deckt smtliche bungen und Screenshots dieser
Dokumentation ab, inklusive einer kleinen GRASS GIS Datenbank. Das Koordinatenbezugssystem ist Albers
Equal Area mit der Maeinheit feet (EPSG-Code 2964).
PROJCS["Albers Equal Area",
GEOGCS["NAD27",
DATUM["North_American_Datum_1927",
SPHEROID["Clarke 1866",6378206.4,294.978698213898,
AUTHORITY["EPSG","7008"]],
TOWGS84[-3,142,183,0,0,0,0],
AUTHORITY["EPSG","6267"]],
PRIMEM["Greenwich",0,
AUTHORITY["EPSG","8901"]],
UNIT["degree",0.0174532925199433,
AUTHORITY["EPSG","9108"]],
AUTHORITY["EPSG","4267"]],
PROJECTION["Albers_Conic_Equal_Area"],
PARAMETER["standard_parallel_1",55],
PARAMETER["standard_parallel_2",65],
PARAMETER["latitude_of_center",50],
PARAMETER["longitude_of_center",-154],
PARAMETER["false_easting",0],
PARAMETER["false_northing",0],
UNIT["us_survey_feet",0.3048006096012192]]

Wenn Sie QGIS berwiegend als grafische Benutzeroberflche fr GRASS GIS verwenden mchten, finden Sie
weitere GRASS GIS Beispiel-Locations (z.B. Spearfish oder South Dakota) auf der offiziellen GRASS Website
unter der URL: http://grass.osgeo.org/download/sample-data/.

6.3 Ein erstes bungsbeispiel


Nachdem Sie QGIS installiert und den Beispieldatensatz heruntergeladen und entpackt haben, beginnen wir
mit einem einfachen und kurzen Beispiel. Ziel ist es, einen Raster- und einen Vektorlayer zu laden und wir
verwenden dazu den Rasterlayer qgis_sample_data/raster/landcover.img und den Vektorlayer
qgis_sample_data/gml/lakes.gml.

6.3.1 QGIS starten

Starten Sie QGIS indem Sie QGIS in die Kommandozeile eingeben oder wenn Sie ein vorkompiliertes
Binrpaket verwenden indem Sie das Men Anwendungen benutzen.

Starten Sie QGIS ber das Start Men, das QGIS Desktop Icon oder durch doppelklicken auf eine evtl.
bereits vorhandene QGIS Projektdatei.

Doppelklicken Sie auf das QGIS Icon in Ihrem Programmordner.

6.3.2 Laden eines Raster- und Vektorlayers aus dem Beispieldatensatz


1. Drcken Sie auf den

Rasterlayer hinzufgen

Knopf.

2. Wechseln Sie in den Ordner qgis_sample_data/raster/, whlen Sie die ERDAS IMG Datei
landcover.img und klicken Sie auf [ffnen].

16

Kapitel 6. Der erste Einstieg

QGIS User Guide, Release 2.6

3. Wenn die Datei nicht aufgelistet ist, prfen Sie in der Dateien des Typs
Combobox im unteren Bereich
des Dialogs, ob der richtige Datentyp, in diesem Fall Erdas Imagine Images (*.img, *.IMG) eingestellt
ist.
4. Nun drcken Sie auf den

Vektorlayer hinzufgen

Knopf.

5. Als Quelltyp sollte im neuen Vektorlayer hinzufgen Dialog Datei ausgewhlt sein. Klicken Sie jetzt
[Durchsuchen] um den Vektorlayer auszusuchen.
6. Wechseln Sie in den Ordner qgis_sample_data/gml/, whlen Sie Geography Markup Language
Pulldown Men, dann whlen Sie die GML Datei
[GML] [OGR] (.gml,.GML) aus dem Filter
lakes.gml und klicken auf [ffnen]. Im Dialog Vektorlayer hinzufgen dann nochmal auf [ffnen]
klicken. Der Koordinatenbezugssystem-Auswahl Dialog ffnet sich mit ausgewhltem NAD27 / Alaska Alberts; klicken Sie [OK].
7. Zoomen Sie in einen Bereich in dem sich ein paar Seen befinden.
8. Doppelklicken Sie auf lakes in der Legende. Der Dialog Layereigenschaften ffnet sich.
9. Klicken Sie auf das Men Stil und whlen Sie Blau als Fllfarbe.
10. Klicken Sie auf das Men Beschriftungen und aktivieren Sie das
Layer beschriften mit Kontrollkstchen
um das Beschriften einzuschalten. Whlen Sie das Feld NAMES als Feld das Beschriftungen enthlt.
11. Um die Lesbarkeit der Beschriftungen zu verbessern knnen Sie einen weien Puffer um sie bilden indem
Sie links Buffer klicken, das Kontrollkstchen
whlen.

Textpuffer zeichnen aktivieren und 3 als Puffergre

12. Drcken Sie nun auf den Knopf [Anwenden], prfen Sie, ob das Ergebnis gut aussieht und besttigen Sie
dann mit einem Klick auf [OK].
Sie sehen, wie einfach es ist, Raster- und Vektorlayer in QGIS zu visualisieren. Gehen Sie nun weiter zu den folgenden Kapiteln, um mehr ber die vorhandenen Funktionalitten, Einstellungsmglichkeiten und ihre Benutzung
zu erfahren.

6.4 QGIS Starten und Beenden


In Kapitel Ein erstes bungsbeispiel wurde bereits kurz gezeigt, wie QGIS gestartet wird. Dies wird hier wiederholt und Sie werden sehen, dass QGIS darber hinaus noch eine Reihe von Kommandozeilenoptionen zur Verfgung stellt.

Wenn QGIS bereits in einem ausfhrbaren Pfad installiert ist, knnen Sie QGIS in einem Kommandozeilenfenster mit dem Befehl: qgis starten, oder durch einen Doppelklick auf das QGIS Icon auf dem
Desktop oder im Anwendungen Men.

Starten Sie QGIS ber das Start Men, das QGIS Desktop Icon oder durch doppelklicken auf eine evtl.
bereits vorhandene QGIS Projektdatei.

Doppelklicken Sie auf das QGIS Icon in Ihrem Programmordner. Wenn Sie QGIS aus der Shell starten
wollen, verwenden Sie /Pfad-zu-den-ausfhrbaren-Dateien/Contents/MacOS/Qgis.

Um QGIS zu beenden klicken Sie im Men


Strg+Q.

Datei

QGIS Beenden oder benutzen Sie das Tastenkrzel

6.5 Optionen der Kommandozeile


QGIS Wenn Sie QGIS in der Kommandozeile starten, stehen eine Reihe von Optionen zur Verfgung. Eine
Liste erhalten Sie, indem Sie qgis ---help eingeben. Die Ausgabe zeigt folgende Informationen:

6.4. QGIS Starten und Beenden

17

QGIS User Guide, Release 2.6

qgis --help
QGIS - 2.6.0-Brighton Brighton (exported)
QGIS is a user friendly Open Source Geographic Information System.
Usage: /usr/bin/qgis.bin [OPTION] [FILE]
OPTION:
[--snapshot filename]
emit snapshot of loaded datasets to given file
[--width width] width of snapshot to emit
[--height height]
height of snapshot to emit
[--lang language]
use language for interface text
[--project projectfile] load the given QGIS project
[--extent xmin,ymin,xmax,ymax] set initial map extent
[--nologo]
hide splash screen
[--noplugins]
dont restore plugins on startup
[--nocustomization]
dont apply GUI customization
[--customizationfile]
use the given ini file as GUI customization
[--optionspath path]
use the given QSettings path
[--configpath path]
use the given path for all user configuration
[--code path]
run the given python file on load
[--defaultui]
start by resetting user ui settings to default
[--help]
this text
FILE:
Files specified on the command line can include rasters,
vectors, and QGIS project files (.qgs):
1. Rasters - supported formats include GeoTiff, DEM
and others supported by GDAL
2. Vectors - supported formats include ESRI Shapefiles
and others supported by OGR and PostgreSQL layers using
the PostGIS extension

Tipp: Ein Beispiel mit der Kommandozeile


Sie knnen einen oder mehrere Kartenlayer in der Kommandozeile angeben, wenn Sie QGIS starten. Z.B. wenn
Sie sich in dem Ordner qgis_sample_data befinden, knnen Sie durch folgendes Kommando QGIS mit
einem Vektor- und einen Rasterlayer starten: qgis ./raster/landcover.img ./gml/lakes.gml
Kommandozeilenoption --snapshot
Diese Option ermglicht es, einen PNG-Snapshot des aktuellen Kartenfensters zu erstellen. Dies ist z.B. sinnvoll,
wenn Sie zahlreiche Projekte angelegt haben und Snapshots von den Daten machen wollen.
QGIS erstellt ein PNG-Bild mit 800x600 Pixeln. Dies knnen Sie mit den Parametern ---width und
---height anpassen und dann hinter der Option --snapshot einen Dateinamen angeben.
Kommandozeilenoption --lang
Auf Basis der Systemsprache Ihres Rechners wird auch die Sprache der QGIS-Oberflche eingestellt. Wenn Sie
diese ndern mchten, knnen Sie einen Sprachcode festlegen. Z.B. startet --lang=it QGIS in italienischer Lokalisierung. Eine Liste der untersttzten Sprachen finden Sie mit dem entsprechenden Lnderkrzel unter
http://hub.qgis.org/wiki/quantum-gis/GUI_Translation_Progress.
Kommandozeilenoption --project
Es ist auch mglich, beim Starten von QGIS ein Projekt zu laden. Fgen Sie dazu die Option project mit dem
Namen ihres Projektes hinzu und QGIS ldt alle darin enthaltenen Daten direkt beim Start.
Kommandozeilenoption ---extent
Um QGIS in einem bestimmten Ausschnitt Ihrer Daten zu starten, kann diese Option genutzt werden. Dazu wird
durch die Eingabe von Eckkoordinaten eine Bounding Box eingestellt. Die Koordinaten mssen durch Komma
getrennt angegeben werden:
--extent xmin,ymin,xmax,ymax

Kommandozeilenoption --nologo
18

Kapitel 6. Der erste Einstieg

QGIS User Guide, Release 2.6

Diese Option verhindert das Anzeigen des Begrungsbildschirms beim Starten von QGIS.
Kommandozeilenoption --noplugins
Wenn Sie Probleme mit dem Starten von Erweiterungen haben knnen Sie das Laden beim Hochfahren von QGIS
verhindern. Die Erweiterungen stehen danach immer noch ber den QGIS-Erweiterungsmanager zu Verfgung.
Kommandozeilenoption --customizationfile
Wenn Sie diese Kommandozeilenoption verwenden knnen Sie eine GUI Anpassungsdatei definieren die dann
beim Start verwendet wird.
Kommandozeilenoption --nocustomization
Wenn Sie diese Kommandozeilenoption verwenden wird die bestehende GUI Anpassung beim Start nicht
angewendet.
Kommandozeilenoption --optionspath
Sie knnen Mehrfachkonfigurationen durchfhren und entscheiden welche Sie verwenden wollen wenn Sie
QGIS unter Verwendung dieser Option starten. Unter Optionen knnen Sie berprfen wo das Betriebssystem die Einstellungen speichert. Derzeit gibt es noch keine Mglichkeit die Datei festzulegen, in die die Einstellungen gespeichert werden. Aus diesem Grund knnen Sie eine Kopie der Originaldatei machen und sie
umbenennen. Die Option legt den Pfad zum Verzeichnis mit Einstellungen fest. Wenn Sie zum Beispiel die
/path/to/config/QGIS/QGIS2.ini Einstellungen verwenden wollen verwenden Sie die Option:
--optionspath /path/to/config/

Kommandozeilenoption --configpath
Diese Option hnelt der vorangegangenen, berschreibt jedoch den Standardpfad (~/.qgis2) fr die Benutzerkonfiguration und zwingt QSettings dieses Verzeichnis zu verwenden. So kann der Benutzer z.B. eine
QGIS-Installation mit allen Erweiterungen und Einstellungen auf einem USB-Stick transportieren.
Kommandozeielenoption -code
Diese Option kann verwendet werden um eine vorgegebene Python-Datei direkt nachdem QGIS gestartet hat
auszufhren.
Zum Beispiel wenn Ihnen eine Python-Datei genannt load_alaska.py mit dem folgenden Inhalt vorliegt:
from qgis.utils import iface
raster_file = "/home/gisadmin/Documents/qgis_sample_data/raster/landcover.img"
layer_name = "Alaska"
iface.addRasterLayer(raster_file, layer_name)

Angenommen Sie befinden sich in dem Verzeichnis wo sich die Datei load_alaska.py befindet knnen Sie
QGIS starten, die Rasterdatei file:landcover.img laden und dem Layer den Namen Alaska geben in dem Sie den
folgenden Befehl benutzen: qgis --code load_alaska.py

6.6 QGIS Projekte


Der Status einer gerade laufenden QGIS-Sitzung wird als Projekt bezeichnet. Sie knnen in QGIS immer nur
an einem Projekt zur Zeit arbeiten. Einstellungen beziehen sich daher immer auf ein bestimmtes Projekt oder
dienen als Standard-Einstellung fr ein neues Projekt (vgl. Abschnitt Optionen). QGIS kann den aktuellen Status
eines Projektes in einer Projektdatei speichern. Whlen Sie dazu in der Menleiste Datei Projekt
speichern oder Projekt

Projekt

Projekt speichern als.

Gespeicherte QGIS Projekte knnen anhand von Projekt


ffnen..., Projekt Neu aus Vorlage oder Projekt
Zuletzt verwendetes in eine QGIS Sitzung geladen werden.
Wenn Sie Ihre Sitzung lschen wollen und neu starten whlen Sie Projekt
Neu. Jede dieser Menoptionen
wird Sie auffordern das bestehende Projekt zu speichern seit es geffnet wurde oder zuletzt gespeichert wurde.
6.6. QGIS Projekte

19

QGIS User Guide, Release 2.6

In einer Projektdatei sind folgenden Informationen gespeichert:


Hinzugefgte Layer
Einstellungen der Layer, inklusive Symbologie
Projektion fr das Kartenfenster
Zuletzt gewhlte Ausdehnung im Kartenfenster
Die Projektdatei wird im XML-Format gespeichert. Dadurch knnen Sie die Datei auch auerhalb von QGIS
editieren, wenn Sie wissen, was Sie tun. Projektdateien aus lteren QGIS-Version funktionieren meist leider nicht.
Um darauf hingewiesen zu werden, knnen Sie im Men Allgemein im Men Einstellungen Optionen das
Kontrollkstchen:

Bei Bedarf nachfragen ob genderte Projekte und Datenquellen gespeichert werden sollen

Warnung ausgeben, wenn QGIS-Projekt einer frheren Version geffnet wird auswhlen

Immer wenn Sie in QGIS 2.2 ein Projekt speichern wird nun ein Backup von der Projektdatei gemacht.

6.7 Ausgabe
Es gibt viele Wege eine Ausgabe von Ihrer QGIS Sitzung zu erzeugen. Einen Weg haben Sie bereits in Abschnitt
QGIS Projekte gezeigt. Hier finden Sie ein Beispiel Ausgabedateien auf andere Art und Weise zu erzeugen:
Bild speichern als
Menauswahl Projekt
ffnet einen Dateidialog indem Sie den Namen, Pfad und Bildtyp
(PNG oder JPG Format) auswhlen. Eine World-Datei mit der Erweiterung PNGW oder JPGW, die im
gleichen Ordner abgelegt wird, georeferenziert das Bild.

Menoption Projekt DXF Export ... ffnet einen Dialog in dem Sie den Darstellungsmodus, den
Darstellungsmastab und Vektorlayer, die Sie in DXF exportieren wollen, definieren knnen.
Die Menoption Projekt
Neue Druckzusammenstellung ffnet einen Dialog in dem Sie das aktuelle
Kartenfenster gestalten und drucken knnen (siehe Kapitel Druckzusammenstellung).
.

20

Kapitel 6. Der erste Einstieg

KAPITEL 7

QGIS GUI

Beim ffnen von QGIS ffnet sich die grafische Benutzeroberflche wie in der Abbildung zu sehen (die Nummern
1 bis 5 in gelben Kreisen werden unten erlutert).

Abbildung 7.1: QGIS GUI mit Alaskabeispieldatensatz

Bemerkung: Das Aussehen einzelner Bereiche (Titelleiste, etc.) kann in Abhngigkeit vom Betriebssystem und
dem Fenstermanager abweichen.
Die QGIS GUI ist in fnf Bereiche unterteilt:
1. Menleiste
2. Werkzeugleiste
3. Legende
4. Kartenfenster
5. Statusleiste
Diese fnf Komponenten der QGIS-Schnittstelle werden in den folgenden Abschnitten detaillierter beschrieben.
Zwei weitere Abschnitte stellen die Tastenkrzel und das Hilfemenu vor.

21

QGIS User Guide, Release 2.6

7.1 Menleiste
Die Menleiste bietet Zugriff auf verschiedene Anwendungen mit Hilfe eines hierarchischen Mens. Das Hauptmen mit einer kurzen Beschreibung der enthaltenen Funktionen wird hier zusammen mit dem jeweiligen Icon,
das auch in der Werkzeugleiste zu finden ist und dem Tastenkrzel aufgelistet. Die Tastenkrzel stellen dabei die
Standardeinstellung dar und knnen im Men Einstellungen Tastenkrzel festlegen definiert werden.
Obwohl fast jede Anwendung der Menleiste ein entsprechendes Icon in der Werkzeugleiste besitzt, ist die Anordnung unterschiedlich. Die Werkzeugleiste mit der entsprechenden Anwendung ist hinter jedem Meneintrag als
Kontrollkstchen angegeben. Weitere Informationen ber die Werkzeuge in der Werkzeugleiste finden Sie in Abschnitt Werkzeugleiste.

7.1.1 Projekt
Menleiste

Tastenkrzel

Referenz

Werkzeugleiste

Ctrl+N

siehe QGIS Projekte

Projekt

Strg+O

siehe QGIS Projekte


siehe QGIS Projekte
siehe QGIS Projekte

Projekt
Projekt

Speichern

Strg+S

siehe QGIS Projekte

Projekt

Speichern als ...

Strg+Shift+S

siehe QGIS Projekte

Projekt

Neu
ffnen ...
Neu aus Vorlage
Zuletzt verwendetes

siehe Ausgabe
siehe Ausgabe

Bild speichern als ...


DXF-Export ...
Neue Druckzusammenstellung

Strg+P

Druckzusammenstellungen verwalten ...


Druckzusammenstellungen
QGIS beenden

22

siehe Druckzusammenstellung

Projekt

siehe Druckzusammenstellung
siehe Druckzusammenstellung

Projekt

Strg+Q

Kapitel 7. QGIS GUI

QGIS User Guide, Release 2.6

7.1. Menleiste

23

QGIS User Guide, Release 2.6

7.1.2 Bearbeiten
Menleiste

Tastenkrzel

Referenz

Werkzeugleiste

Rckgngig

Strg+Z

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Wiederholen

Strg+Shift+Zsiehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Ausgewhlte Objekte
ausschneiden

Strg+X

siehe Einen vorhandenen Layer


editieren

Digitalisierung

Objekte kopieren

Strg+C

siehe Einen vorhandenen Layer


editieren

Digitalisierung

Objekte einfgen

Strg+V

siehe Einen vorhandenen Layer


editieren
siehe Mit Attributtabelle
arbeiten

Digitalisierung

Strg+.

siehe Einen vorhandenen Layer


editieren

Digitalisierung

Objekte verschieben

siehe Einen vorhandenen Layer


editieren

Digitalisierung

Ausgewhltes lschen

siehe Einen vorhandenen Layer


editieren

Digitalisierung

Objekt(e) drehen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Objekt vereinfachen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Ring hinzufgen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Teil hinzufgen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Ring fllen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Ring lschen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Teil lschen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Objekte berarbeiten

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Linie versetzen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Objekte trennen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Teile zerlegen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Gewhlte Objekte
verschmelzen

siehe Erweiterte Digitalisierung

Erweiterte
Digitalisierung

Objekte einfgen als


Objekt hinzufgen

Attribute gewhlter Objekte


vereinen
24
Knotenwerkzeug

siehe Erweiterte Digitalisierung

Punktsymbole drehen

siehe Erweiterte Digitalisierung

siehe Einen vorhandenen Layer


editieren

Erweiterte
Digitalisierung
Kapitel 7. QGIS GUI
Digitalisierung
Erweiterte

QGIS User Guide, Release 2.6

Bearbeitungsstatus umschalten
Nach dem Sie auf das Icon
gedrckt haben finden Sie das Objekt hinzufgen Icon im
Bearbeiten Men das abhngig vom Layertyp (Punkt, Linie oder Polygon) dargestellt wird.

7.1.3 Bearbeiten (extra)


Menleiste

Tastenkrzel

Referenz

Werkzeugleiste

Objekt hinzufgen

siehe Einen vorhandenen Layer editieren

Digitalisierung

Objekt hinzufgen

siehe Einen vorhandenen Layer editieren

Digitalisierung

Objekt hinzufgen

siehe Einen vorhandenen Layer editieren

Digitalisierung

7.1.4 Ansicht
Menleiste

Tastenkrzel

Referenz

Werkzeugleiste

Karte verschieben

Kartennavigation

Karte zur Auswahl


verschieben

Kartennavigation

Hineinzoomen

Strg++

Kartennavigation

Herauszoomen

Strg+-

Kartennavigation
Attribute

Auswahl

siehe Objekte auswhlen und Auswahl


aufheben

Objekte abfragen
Messen

Strg+Shift+I

Volle Ausdehnung

Strg+Shift+F

siehe sec_measure

Kartennavigation

Auf den Layer zoomen


Zur Auswahl zoomen

Attribute
Attribute

Kartennavigation
Kartennavigation

Strg+J

Zoom zurck

Kartennavigation

Zoom vor

Kartennavigation

Auf tatschliche Gre


zoomen
Dekorationen

Kartennavigation
siehe Dekorationen

Kartenhinweise

Attribute

Neues Lesezeichen ...

Strg+B

siehe Rumliche Lesezeichen

Attribute

Lesezeichen anzeigen

Strg+Shift+B siehe Rumliche Lesezeichen

Attribute

Aktualisieren

Strg+R

Kartennavigation

7.1. Menleiste

25

QGIS User Guide, Release 2.6

7.1.5 Layer
Menleiste
Neu
Eingebettete Layer und Gruppen ...

Tastenkrzel

Referenz
siehe Neue Vektorlayer erstellen
siehe Layer/Gruppen einbinden

Werkzeugleiste
Layer verwalten

Vektorlayer hinzufgen

Strg+Shift+V

siehe Arbeiten mit Vektordaten

Layer verwalten

Rasterlayer hinzufgen

Strg+Shift+R

siehe Rasterlayer in QGIS laden

Layer verwalten

PostGIS-Layer hinzufgen

Strg+Shift+D

siehe PostGIS Layer laden

Layer verwalten

SpatiaLite-Layer hinzufgen ...

Strg+Shift+L

siehe SpatiaLite Layer laden

Layer verwalten

Rumlichen MSSQL-Layer hinzufgen

Strg+Shift+M

siehe Rumliche MSSQL-Layer

Layer verwalten

Oracle-GeoRaster-Layer hinzufgen

siehe Oracle-Spatial-GeoRaster Plugin

Layer verwalten

SQL-Anywhere-Layer hinzufgen ...

siehe SQL-Anywhere Plugin

Layer verwalten

siehe WMS/WMTS Client

Layer verwalten

WCS-Layer hinzufgen

siehe WCS Client

Layer verwalten

WFS-Layer hinzufgen ...

siehe WFS und WFS-T Klient

Layer verwalten

Textdatei als Layer importieren ...

siehe Delimited Text Dateien

Layer verwalten

Stil kopieren

siehe Men Stil

Stil einfgen

siehe Men Stil

Attributtabelle ffnen

siehe Mit Attributtabelle arbeiten

Attribute

Bearbeitungsstatus umschalten

siehe Einen vorhandenen Layer editieren

Digitalisierung

Layernderungen speichern

siehe Einen vorhandenen Layer editieren

Digitalisierung

Aktuelle nderungen
Speichern als ...
Auswahl als Vektordatei speichern ...

siehe Einen vorhandenen Layer editieren

Digitalisierung

WMS/WMTS-Layer hinzufgen

Layer lschen
Layer kopieren
KBS von Layer(n) setzen
Layer-KBS dem Projekt zuweisen
Eigenschaften ...
Abfrage ...

Strg+Shift+W

Siehe Mit Attributtabelle arbeiten


Strg+D
Strg+Shift+C

Beschriftung
Zur bersicht hinzufgen

Strg+Shift+O

Layer verwalten

Alle Layer anzeigen

Strg+Shift+U

Layer verwalten

Alle Layer ausblenden

Strg+Shift+H

Layer verwalten

Alle zur bersicht hinzufgen


Alle aus berischt enfernen

26

Kapitel 7. QGIS GUI

QGIS User Guide, Release 2.6

7.1.6 Einstellungen
Menleiste

Tastenkrzel

Bedienfelder
Werkzeugksten
Auf Vollbildmodus umschalten
Projekteinstellungen ...

Referenz

Werkzeugleiste

siehe Bedienfelder und Werkzeugksten


siehe Bedienfelder und Werkzeugksten
F 11
Strg+Shift+Psiehe QGIS Projekte
siehe Eigenes Koordinatenbezugssystem
definieren
siehe Presentation

Benutzerkoordinatenbezugssystem
Stilmanager...
Tastenkrzel festlegen ...
mActionOptions| Anpassungen
...
Optionen ...
Fangoptionen ...

siehe Anpassung
siehe Optionen

7.1.7 Erweiterungen
Menleiste

Tastenkrzel

Erweiterungen verwalten und installieren ...


Python-Konsole

Referenz

Werkzeugleiste

siehe Der Erweiterungen Dialog

Wenn Sie QGIS das erste Mal starten werden nicht alle Erweiterungen geladen.

7.1.8 Vektor
Menleiste
OpenStreetMap

Tastenkrzel

Referenz
siehe OpenStreetMap Vektordateien laden

Analyse-Werkzeuge

siehe fTools Plugin

Forschungswerkzeuge

siehe fTools Plugin

Geoverarbeitungswerkzeuge

siehe fTools Plugin

Geometrie-Werkzeuge

siehe fTools Plugin

Datenmanagement-Werkzeuge

siehe fTools Plugin

Werkzeugleiste

Wenn Sie QGIS das erste Mal starten werden nicht alle Erweiterungen geladen.

7.1.9 Raster
Menleiste
Rasterrechner ...

Tastenkrzel

Referenz
siehe Rasterrechner

Werkzeugleiste

Wenn Sie QGIS das erste Mal starten werden nicht alle Erweiterungen geladen.

7.1. Menleiste

27

QGIS User Guide, Release 2.6

7.1.10 Verarbeitung
Menleiste

Tastenkrzel

Referenz

Werkzeugleiste

Werkzeugkiste

siehe Die Werkzeugkiste

Grafische Modellierung

siehe Die Grafische Modellierung


siehe Das Protokoll

Protokoll
Optionen und Konfiguration

siehe Die Verarbeiten Umgebung konfigurieren

Ergebnisanzeige

siehe Konfiguration externer Anwendungen

Commander

Strg+Alt+M

siehe The QGIS Commander

Wenn Sie QGIS das erste Mal starten werden nicht alle Erweiterungen geladen.

7.1.11 Hilfe
Menleiste

Tastenkrzel

Hilfe-bersicht
Direkthilfe
API-Dokumentation
Brauchen Sie professionelle Untersttzung?
QGIS-Homepage

Referenz

Werkzeugleiste

F1

Direkthilfe

Shift+F1

Direkthilfe

Strg+H

QGIS-Version berprfen
ber
QGIS-Sponsoren
Bitte beachten Sie dass unter Linux die oben aufgefhrten Menleisteneintrge der Standard im KDE Window
Manager sind. Unter GNOME hat das Einstellungen Men unterschiedliche Inhalte und Ihre Eintrge lassen sich
hier finden:
Projekteinstellungen
Optionen
Tastenkrzel festlegen
Stilmanager

Projekt
Bearbeiten
Bearbeiten
Bearbeiten

Benutzerkoordinatenbezugssystem
Bedienfelder
Werkzeugksten
Volle Ausdehnung
Kachelmastab
GPS-Information

Bearbeiten
Ansicht
Ansicht
Ansicht
Ansicht
Ansicht

7.2 Werkzeugleiste
Die Werkzeugleiste bietet mit Hilfe von Icons Zugriff auf alle Funktionen aus der Menleiste sowie ein paar
zustzliche Tools, um mit der Karte zu interagieren. Jedes Icon der Werkzeugleiste bietet eine kurze Beschreibung
ihrer Funktion. Indem Sie mit der Maus ber das Icon fahren, erscheint es.
Jedes Untermen der Werkzeugleiste kann nach eigenen Wnschen verschoben werden und jedes Untermen kann
auch an bzw. ausgeschaltet werden, indem Sie mit der Maus in einen freien Bereich der Werkzeugleiste fahren
und auf den rechten Mausknopf drcken (lesen sie auch Abschnitt Bedienfelder und Werkzeugksten).

28

Kapitel 7. QGIS GUI

QGIS User Guide, Release 2.6

Tipp: Werkzeugleiste wiederherstellen


Wenn sie aus Versehen alle Untermens der Werkzeugleiste ausgeblendet haben, knnen Sie diese
ber das Men Einstellungen Werkzeugksten wieder zurckholen. Wenn eine Werkzeugleiste
unter Windows verschwindet - was unter QGIS manchmal ein Problem zu sein scheint- mssen Sie
\HKEY_CURRENT_USER\Software\QuantumGIS\qgis\UI\state aus der Registry lschen. Wenn Sie
dann QGIS neu starten wird der Key wieder mit Standardeinstellungen geschrieben und die Werkzeugleisten sind
wieder sichtbar

7.3 Legende
Der Legendenbereich fhrt alle Layer im Projekt auf. Das Kontrollkstchen in jedem Legendeneintrag kann
dazu verwendet werden um den Layer anzuzeigen oder auszublenden. Die Legendenwerkzeugleiste im Legendenbereich ermglicht es Ihnen Eine Gruppe hinzufgen, Layersichtbarkeitseinstellungen aller Layer oder
Sichtbarkeitsvoreinstellungen vorzunehmen, die Legende nach Karteninhalt filtern, Alle ausklappen oder Alle
ermglicht es Ihnen, Voreinstellungen von Views in
einklappen und Layer/Gruppe lschen. Der Knopf
der Legende hinzuzufgen. Das heit dass Sie sich entscheiden knnen Layer mit bestimmten Kategorisierungen
darzustellen und diese Views zu der Liste der Voreinstellungen hinzuzufgen. Um den View einer Voreinstellung
, whlen Sie Voreinstellung hinzufgen ... aus dem Drop-down-Men
hinzuzufgen klicken Sie einfach auf
und vergeben Sie einen Namen fr die Voreinstellung. Danach sehen Sie eine Liste mit allen Voreinstellungen, die
Sie mit durch Drcken des

Knopfes wieder aufrufen knnen.

Alle hinzugefgten Voreinstellungen liegen auch in der Druckzusammenstellung vor um es Ihnen zu ermglichen
eine Karte auf Basis Ihrer bestimmten Views zu erstellen (siehe Haupteigenschaften).
Die Z-Anordnung der Kartenlayer kann mit der drag and drop Funktion der Maus festgelegt werden. ZAnordnung bedeutet, dass ein weiter oben in der Legende angeordneter Layer ber einem weiter unten angeordneten Layer im Kartenfenster angezeigt wird.
Bemerkung: Diese Einstellungen knnen mit dem Layerreihenfolge Bedienfeld berschrieben werden.
Einzelne Layer knnen in der Legende zu Gruppen zusammengefasst werden. Sie knnen dies auf zwei Arten tun:
1. Drcken Sie das
Icon um eine neue Gruppe hinzuzufgen. Geben Sie einen Namen fr die Gruppe ein
und drcken Sie Enter. Klicken Sie jetzt auf einen bestehenden Layer und ziehen Sie ihn auf die Gruppe.
2. Whlen Sie einige Layer aus, machen Sie einen Rechtsklick in die Legende und whlen Sie Gewhlte
gruppieren. Die ausgewhlten Layer werden automatisch in eine neue Gruppe gesetzt.
Um einen Layer aus einer Gruppe zu bringen, knnen Sie ihn herausschieben oder einen Rechtsklick darauf
machen und In oberste Ebene bringen whlen. Gruppen knnen auch in andere Gruppen verschachtelt werden.
Das Kontrollkstchen fr eine Gruppe zeigt oder verbirgt alle Layer einer Gruppe mit einem Klick.
Die angezeigten Elemente der rechten Maustaste-Funktion sind abhngig davon, ob es sich um einen Raster- oder
Bearbeitungsstatus umschalten
Vektorlayer handelt. Fr geladene GRASS Vektorlayer steht die Funktion
nicht zur
Verfgung. Vergleichen Sie dazu das Kapitel Digitalisieren und Editieren eines GRASS Vektorlayers fr weitere
Informationen zum Editieren von GRASS Vektorlayern.

Rechte-Maustaste-Men fr Rasterlayer
Auf die Layerausdehnung zoomen
In der bersicht anzeigen
Auf besten Mastab zoomen (100%)
Auf aktuelle Ausdehnung strecken
Entfernen

7.3. Legende

29

QGIS User Guide, Release 2.6

Kopieren
Mastabsabhngige Sichtbarkeit des/der Layer setzen
KBS fr Layer setzen
Layer-KBS dem Projekt zuweisen
Speichern als ...
Als Layerdefinitionsdatei speichern ...
Eigenschaften ...
Umbenennen
Stil kopieren
Zustzlich abhngig von der Layerposition und -auswahl
In oberste Ebene bringen
Gewhlte gruppieren
Rechte-Maustaste-Men fr Vektorlayer
Auf die Layerausdehnung zoomen
In der bersicht anzeigen
Entfernen
Kopieren
Mastabsabhngige Sichtbarkeit des/der Layer setzen
KBS fr Layer setzen
Layer-KBS dem Projekt zuweisen
Attributtabelle ffnen
Bearbeitungsstatus umschalten (bei GRASS Layern nicht mglich)
Speichern als ...
Als Layerdefinitionsdatei speichern ...
Filter ...
Objektanzahl anzeigen
Eigenschaften ...
Umbenennen
Stil kopieren
Zustzlich abhngig von der Layerposition und -auswahl
In oberste Ebene bringen
Gewhlte gruppieren
Rechte Maustaste-Men fr Layergruppen
Zur Gruppe zoomen
Entfernen
KBS fr Gruppe setzen
Umbenennen
Gruppe hinzufgen

30

Kapitel 7. QGIS GUI

QGIS User Guide, Release 2.6

Es ist mglich mehr als einen Layer oder Gruppe zur gleichen Zeit auszuwhlen indem man die Strg Taste
gedrckt hlt und die Layer mit der linken Maustaste auswhlt. Sie knnen dann alle ausgewhlten Layer gleichzeitig zu einer neuen Gruppe verschieben.
Sie knnen auch mehr als einen Layer oder Gruppe auf einmal lschen indem Sie mehrere Layer mit der Strg
Taste auswhlen und danach Strg+D drcken. Auf diese Art und Weise werden alle ausgewhlten Layer und
Gruppen aus der Layerliste entfernt.

7.3.1 Mit der legendenunabhngigen Layerreihenfolge arbeiten


Es gibt ein Bedienfeld das es Ihnen ermglicht eine unabhngige Zeichenreihenfolge fr die Legende zu bestimmen. Sie knnen es im Men Einstellungen Bedienfelder Layerreihenfolge aktivieren. Diese Feature
ermglicht es Ihnen z.B. Ihre Layer der Wichtigkeit nach zu sortieren und diese gleichzeitig in der korrekten
Bestimmt Zeichenreihenfolge KonReihenfolge darzustellen (siehe figure_layer_order). Das Aktivieren des
trollkstchens unterhalb der Layerliste bewirkt eine Rckkehr zum Standardverhalten.

Abbildung 7.2: Eine legendenunabhngige Layerreihenfolge festlegen

7.4 Kartenfenster
Dies ist der Ergebnisbereich von QGIS - hier werden die Daten visualisiert. Die Karten, die hier angezeigt werden,
hngen davon ab, welche Raster- und Vektorlayer Sie ausgewhlt haben (vgl. folgende Abschnitte). Innerhalb des
Kartenfensters knnen Sie zoomen, verschieben (pan) und eine Vielzahl weiterer Funktionen aus der Werkzeugleiste anwenden. Das Kartenfenster und die Legende sind miteinander verknpft. Layer im Kartenfenster spiegeln
Vernderungen in der Legende wider.
Tipp: Mit dem Mausrad in der Karte zoomen
Sie knnen das Mausrad benutzen, um im Kartenfenster in Layer hinein- bzw. hinauszuzoomen. Platzieren Sie
dazu den Mauszeiger im Kartenfenster und drehen Sie das Mausrad nach vorne (Hinauszoomen) oder nach hinten
zum Hineinzoomen. Der Mauszeiger bildet dabei das Zentrum. Sie knnen das Verhalten des Mausrades in der
Menleiste Einstellungen Optionen unter dem Men Kartenwerkzeuge einstellen.

7.4. Kartenfenster

31

QGIS User Guide, Release 2.6

Tipp: Den Kartenausschnitt mit den Pfeiltasten und der Leertaste verschieben
Sie knnen die Pfeiltasten verwenden, um den Layer zu verschieben. Platzieren Sie dazu den Mauszeiger im
Kartenfenster und drcken Sie auf die rechte Pfeiltaste um nach Osten zu verschieben, die linke Pfeiltasten fr
Westen, die Hoch-Pfeiltasten fr Norden und die Unten-Pfeiltasten fr Sden. Sie knnen einen Layer auch mit
der Space-Taste verschieben. Bewegen Sie dazu einfach die Maus whrend Sie die Space-Taste gedrckt halten.

7.5 Statusleiste
Die Statusleiste zeigt die aktuelle Position als Koordinate (z.B. in Meter oder Dezimalgrad) whrend der
Mauszeiger ber dem Kartenfenster verschoben wird. Links von der Koordinatenanzeige ist ein kleiner Knopf
mit dem Sie auswhlen knnen, ob die Koordinaten des Bezugsystems oder der Ausdehnung des Kartenfensters
angezeigt werden sollen, whrend der Mauszeiger bewegt wird.
Neben der Koordinatenanzeige finden Sie die Mastabsanzeige. Es zeigt den Mastab des Kartenfensters. Wenn
Sie herein- oder hinauszoomen zeigt QGIS ihnen den aktuellen Mastab. Seit QGIS 1.8 gibt es eine Mastabsauswahl mit der Sie zwischen vordefinierten Mastben von 1:500 bis 1:1000000 whlen knnen.
Ein Fortschrittsbalken in der Statusleiste zeigt den Fortschritt des Zeichnens der einzelnen Layer im Kartenfenster.
In einigen Fllen, etwa wenn statistische Informationen ber Rasterlayer errechnet werden, wird der Fortschritt
dieser Operation angezeigt.
Wenn ein neues externes Plugin oder ein Plugin Update im Internet verfgbar ist, wird diese Information auch
in der Statusleiste angezeigt. Mit dem Kontrollkstchen auf der rechten Seite der Statusleiste kann eingestellt
werden, ob Layer angezeigt werden sollen oder nicht (vgl. Abschnitt Layeranzeige kontrollieren). Das Icon
stoppt die Darstellung umgehend.
Rechts von den Renderingfunktionen finden Sie den EPSG Kode des aktuellen Projektes und ein Projektor Icon.
Wenn man darauf klickt ffnet es die Projektionseigenschaften des aktuellen Projektes.
Tipp: Die richtige Mastabseinheit im Kartenfenster einstellen
Wenn Sie QGIS starten, ist als Maeinheit Grad voreingestellt und sagt QGIS, dass alle Koordinaten des Layers
in Grad vorliegen. Um die korrekte Maeinheit anzeigen zu lassen, knnen Sie es im Men Allgemein im Men
Einstellungen Projekteinstellungen einstellen oder sie whlen das passende Bezugskoordinatensystem (KBS)
KBS Status
aus, indem Sie auf das Icon
in der unteren rechten Ecke der Statusleiste klicken. Dann wird die
Maeinheit entsprechend der KBS eingestellt, z.B.: +units=m.

32

Kapitel 7. QGIS GUI

KAPITEL 8

Allgemeine Werkzeuge

8.1 Tastenkrzel
QGIS bietet Standard Tastenkrzel fr zahlreiche Funktionen. Sie knnen im Kapitel Menleiste nachgelesen
werden. Zustzlich ist es aber auch mglich, eigene Tastenkrzel zu definieren und bestehende zu ndern. ffnen
Sie dazu das Men Einstellungen Tastenkrzel festlegen ....

Abbildung 8.1: Tastenkrzel festlegen

(Gnome)

Die Konfiguration ist sehr einfach. Whlen Sie einfach eine Aktion aus und drcken dann auf [ndern], [Keins
setzen] oder [Voreinstellung]. Wenn Sie ihre Einstellung gefunden haben, kann diese als XML-Datei abgespeichert und somit auch fr eine andere QGIS Installation genutzt werden.

8.2 Hilfe
Wenn Sie Hilfe zu bestimmten Themen brauchen erreichen Sie die Kontext-Hilfe ber den [Hilfe] Knopf der
Ihnen in den meisten Dialogen zur Verfgung steht. Bitte beachten Sie da Erweiterungen von Drittanbietern zu
dementsprechend gewidmeten Internetseiten verweisen.

8.3 Layeranzeige kontrollieren


QGIS rendert standardmig alle sichtbaren Layer wenn das Kartenfenster aktualisiert werden muss. Die Ablufe,
die eine Erneuerung der Wiedergabe verursachen sind:

33

QGIS User Guide, Release 2.6

Einen Layer hinzufgen


Karten verschieben, hinein- oder herauszoomen
Die Gre des QGIS Fensters ndern
Layer ein- oder ausblenden
QGIS ermglicht Ihnen den Darstellungsprozess in einer Reihe von Mglichkeiten zu steuern.

8.3.1 Mastabsabhngige Layeranzeige


Die mastabsabhngige Wiedergabe erlaubt es, einen mini- und maximalen Mastab, in dessen Rahmen ein Layer
angezeigt wird, anzugeben. Um die mastabsabhngige Wiedergabe einzustellen ffnen Sie den Eigenschaften
Dialog eines Layers, indem Sie diesen in der Legende doppelt anklicken, im Men Allgemein die entsprechenden
Einstellungen vornehmen und das Kontrollkstchen

Mastabsabhngige Sichtbarkeit aktivieren.

Sie knnen die Mastabswerte bestimmen indem Sie erst auf den Level den Sie benutzen wollen zoomen und den
Mastabswert in der QGIS Statusleiste notieren.

8.3.2 Layeranzeige kontrollieren


Die Kartendarstellung kann wie unten beschrieben auf verschiedene Art und Weise gesteuert werden.
Wiedergabe unterdrcken
Um die Wiedergabe einer Karte zu unterdrcken, klicken Sie auf das Kontrollkstchen
Zeichnen auf der rechten Seite der Statusleiste. Wenn das Kontrollkstchen nicht aktiv ist, fhrt QGIS keine Erneuerung der Wiedergabe
des Kartenfensters durch wie in Abschnitt Layeranzeige kontrollieren beschrieben. Beispiele, bei denen das Unterdrcken der Wiedergabe angewendet wird, sind:
Viele Layer hinzufgen und ihre Symbologie vor der Visualisierung einstellen
Einen oder mehrere groe Layer hinzufgen und erst die mastabsabhngige Wiedergabe einstellen
Einen oder mehrere groe Layer hinzufgen und erst in ein bestimmtes Gebiet hineinzoomen
Eine Kombination aus den oben genannten Punkten
Wenn Sie die
statt.

Zeichnen aktivieren, findet automatisch eine Erneuerung der Wiedergabe des Kartenfensters

Option fr Layer hinzufgen


Sie knnen fr das Hinzuladen neuer Layer eine Einstellung vornehmen, die bewirkt, dass diese beim Laden erst
einmal nicht angezeigt werden. Um diese Option zu nutzen deaktivieren Sie in der Menleiste unter Einstellungen Optionen im Men Darstellung das Kontrollkstchen
Normalerweise werden alle neuen Layer im
Kartenfenster angezeigt. Dadurch werden alle neu geladenen Layer erstmal nicht angezeigt.
Zeichnen stoppen
Um die Wiedergabe einer Karte zu stoppen drcken Sie die ESC Taste. Dies stoppt die Erneuerung der Wiedergabe
und die Karte wird nur zum Teil angezeigt. Es kann sein dass etwas Zeit zwischen dem Drcken der Esc Taste
und dem Stoppen der Kartenwiedergabe vergeht.
Bemerkung: Es ist derzeit nicht mglich das Zeichnen zu stoppen - diese Funktion wurde mit der Version qt4
ausgeschaltet da es zu Problemen und Abstrzen der Benutzeroberflche kam.

34

Kapitel 8. Allgemeine Werkzeuge

QGIS User Guide, Release 2.6

Anpassen des Kartenfensters bei der Wiedergabe


Normalerweise werden in QGIS Inhalte von Layern erst visualisiert wenn smtliche Daten geladen sind. Um zu
bewirken, dass die Inhalte von Layern direkt beim Lesen angezeigt werden, verndern Sie in der Menleiste unter
Einstellungen Optionen im Men Darstellung die Anzahl von Objekten, nach deren Zeichnung die Anzeige
aktualisiert werden soll. Der Wert 0 (Standard) verhindert die Aktualisierung whrend des Zeichnens. Bei zu
niedrigem Wert leidet die Leistung, das stndig ein Update der Wiedergabe stattfindet. Zu Beginn ist oftmals ein
Wert von 500 sinnvoll.
Die Qualitt der Wiedergabe beeinflussen
Um die Wiedergabequalitt der Layer zu beeinflussen gibt es zwei Mglichkeiten. ffnen Sie das Men Darstellung im Men Einstellungen Optionen und aktivieren bzw. deaktivieren Sie folgende Kontrollkstchen.

Linien auf Kosten der Zeichengeschwindigkeit weniger gezackt zeichnen

Problem mit falsch gefllten Polygonen beheben

Darstellung beschleunigen
Es gibt zwei Einstellungen die es Ihnen ermglichen die Darstellungsgeschwindigkeit zu erhhen. ffnen Sie den
QGIS Optionen Dialog indem Sie Einstellungen Optionen benutzen, gehen Sie zum Darstellung Men und
aktivieren oder deaktivieren Sie die folgenden Kontrollkstchen:

Hintergrundpuffer aktivieren. Dies sorgt fr eine bessere Grafikleistung wobei dann das Darstellen dann
nicht mehr gestoppt und Objekte nicht mehr stufenweise dargestellt werden knnen. Wenn es deaktiviert
ist knnen Sie die Anzahl von Objekten nach deren Zeichnung die Anzeige aktualisiert werden soll
festlegen, sonst ist diese Option nicht aktiv.
Wo mglich den Darstellungscache benutzen, um das Neuzeichnen zu beschleunigen

8.4 Messen
Das Messen funktioniert mit Projektionen (z.B. UTM) und auch mit nicht projizierten Daten. Wenn die geladene
Karte als Geografisches Koordinatensystem abgebildet wird (z.B. Latitude/Longitude) sind die Messergebnisse
falsch. Sie mssen dann ein passendes KBS mit einer Projektion verwenden (siehe Abschnitt Arbeiten mit Projektionen). Alle Mewerkzeuge verwenden auch die eingestellte Fangtoleranz der Digitalisierung. Dies ist zum
Beispiel dann sinnvoll, wenn Sie entlang von Linien oder Polygongrenzen geladener Vektorlayer messen wollen.
Um ein Mewerkzeug auszuwhlen klicken Sie auf

und suchen das Werkzeug das Sie benutzen wollen aus.

8.4.1 Strecken, Flchen und Winkel messen


Linie messen

: QGIS kann reale Distanzen zwischen Punkten auf Basis eines vorgegebenen Ellipsoiden messen.
Dazu whlen Sie im Men Einstellungen Optionen im Men Kartenwerkzeuge einen Ellipsoiden aus. Es kann
auerdem die Gummibandfarbe, die bevorzugte Maeinheit (Meter oder Fu) und das bevorzugte Winkelma
(Grad, Bogenma, Gon) eingestellt werden. Das Werkzeug ermglicht es, Punkte im Kartenfenster auszuwhlen.
Jedes Lngensegment wird in einem Popup angezeigt und zustzlich auch die Gesamtlnge aller Lngensegmente.
Um das Messen von Strecken zu beenden, klicken Sie auf die rechte Maustaste
Flche messen

: Auch Flchengren knnen gemessen werden. Das Popup zeigt dabei die akkumulierte Flchengre. Zustzlich schnappt das Mewerkzeug auf den gerade ausgewhlten Layer wenn fr den entsprechenden
Layer ein Fangmodus eingestellt wurde (siehe Abschnitt Einstellen der Fangtoleranz und des Suchradius). Wenn
Sie also exakt entlang einer Linie oder Polygonumrandung messen mchten, setzen Sie erst eine Fangtoleranz
8.4. Messen

35

QGIS User Guide, Release 2.6

Abbildung 8.2: Entfernungen messen

(Gnome)

und selektieren dann den Layer. Wenn Sie jetzt das Mewerkzeug benutzen schnappt man mit jedem Mausklick
(innerhalb der eingestellten Toleranz) auf den Layer.

Abbildung 8.3: Flchen messen

(Gnome)

Winkel messen

: Auch Winkel knnen mit dem Winkel messen- Werkzeug gemessen werden. Der Mauszeiger wird
zum Kreuz. Drcken Sie die linke Maustaste und zeichnen Sie das erste Segment des Winkels, klicken nochmals
auf die linke Maustaste und messen sie den Winkel, der im Dialogfenster angezeigt wird.

Abbildung 8.4: Winkel messen

(Gnome)

8.4.2 Objekte auswhlen und Auswahl aufheben


Die Werkzeugleiste bietet mehrere Werkzeuge, um Objekte im Kartenfenster auszuwhlen. Um ein oder mehrere
Objekte auszuwhlen, klicken Sie auf

Einzelnes Objekt whlen

Objekte durch Rechteck whlen

Objekte durch Polygon whlen

Objekte freihndig whlen

Objekte durch Radius whlen

und whlen Sie dann das entsprechende Werkzeug:

Um die Auswahl von Objekten wieder aufzuheben, klicken Sie auf den Knopf

Objekte mit einem Ausdruck whlen

ermglicht es dem Anwender ein Objekt anhand eines Ausdruckdialoges


auszuwhlen. Siehe auch die Beispiele in Kapitel Expressions .

36

Kapitel 8. Allgemeine Werkzeuge

QGIS User Guide, Release 2.6

Anwender knnen eine Objektauswahl in Neuer Memory-Vektorlayer oder Neuer Vektorlayer anhand von
Bearbeiten Objekte einfgen als speichern indem Sie den gewnschten Modus auswhlen.

8.5 Objekte abfragen


Das Objekte abfragen Werkzeug ermglicht es Ihnen mit dem Kartenfenster zu interagieren und Informationen
ber Objekte ber eine Pop-Up Fenster abzurufen. Um ein Objekt abzufragen verwenden Sie Ansicht Objekte abfragen, drcken Sie Strg + Umschalt + I oder klicken Sie auf das
Werkzeugleiste.

Objekte abfragen

Icon in der

Wenn Sie auf mehrere Objekte klicken gibt der Identifikationsergebnis Dialog die Informationen ber die ausgewhlten Objekte in einer Liste wieder. Das erste Element ist die Nummer des Objekts in der Ergebnisliste,
gefolgt vom Layernamen. Das erste Untermen ist der Name eines Feldes mit seinem Wert. Schlielich werden
alle Informationen ber das Objekt abgebildet.
Dieses Fenster kann angepasst werden um benutzerdefinierte Felder anzuzeigen, standardmig gibt es drei Arten
von Informationen wieder:
Aktionen: Aktionen knnen zum Objekte abfragen Fenster hinzugefgt werden. Wenn Sie dann auf das
Aktionen-Icon klicken wird eine Aktion ausgefhrt. Standardmig wird nur eine Aktion hinzugefgt um
das Objektformular zum Bearbeiten darzustellen.
Abgeleitet: Diese Information wird von anderen Informationen berechnet oder abgeleitet. Sie knnen hier
durch einen Klick X- und Y-Koordinate, Flche in Karteneinheiten und Umfang in Karteneinheiten von
Polygonen, Lngen in Karteneinheiten von Linien und Objekt IDs herausfinden.
Datenattribute: Dies ist die Liste von Attributfeldern aus den Daten.

Abbildung 8.5: Objekte abfragen Dialog

(Gnome)

Am unteren Rand des Fensters gibt es fnf Icons:

Baum ausklappen

Baum einklappen

Neue Ergebnisse erscheinen automatisch ausgeklappt.

Gewhlte Objekte in Zwischenablage kopieren.

Gewhlte HTML-Antwort drucken

Andere Funktionen knnen im Kontextmen des abgefrageten Objekts gefunden werden. Im Kontextmen knnen
Sie z.B.:
8.5. Objekte abfragen

37

QGIS User Guide, Release 2.6

Das Objektformular anzeigen


Zum Objekt zoomen
Objekt kopieren: Kopieren Sie alle Objektgeometrien und -attribute
Auswahl des Objekts umkehren: fgt das ausgewhlte Objekt der Auswahl hinzu
Attributwert kopieren: Kopieren Sie nur den Wert des Attributes auf das Sie klicken
Objektattribute kopieren: Kopieren Sie nur die Attribute
Ergebnisse lschen: Lschen Sie Ergebnisse im Fenster
Hervorhebungen lschen: Entfernen Sie in der Karte hervorgehobene Objekte
Alle hervorheben
Layer hervorheben
Layer aktivieren: Whlen Sie einen Layer der aktiviert werden soll
Layereigenschaften ... : ffnen Sie das Layereigenschaften Fenster
Alles ausklappen
Alles zusammenfalten

8.6 Dekorationen
Die Dekorationen von QGIS umfassen das Gitter, den Urheberrechtshinweis, den Nordpfeil und die Mastabsleiste. Sie werden zum Dekorieren der Karte durch Hinzufgen von kartografischen Elementen benutzt.

8.6.1 Gitter
Gitter

ermglicht es Ihnen ein Koordinatengitter und Koordinatenbeschriftungen der Karte hinzuzufgen.

Abbildung 8.6: Der Gitter Dialog


1. Whlen Sie das Men Ansicht Dekorationen Gitter. Der Dialog ffnet sich (siehe figure_decorations_1).
2. Aktivieren Sie das Kontrollkstchen
Aktiviere Gitter und machen Sie Definitionen gem den Layern
die Sie ins Kartenfenster geladen haben.
38

Kapitel 8. Allgemeine Werkzeuge

QGIS User Guide, Release 2.6

3. Aktivieren Sie das Kontrollkstchen


Beschriftungen zeichnen und machen Sie Beschriftungsdefinitionen
gem den im Kartenfenster geladenen Layern.
4. Klicken Sie [Anwenden] um sicherzugehen dass es so aussieht wie sie es erwarten.
5. Klicken Sie [OK] um den Dialog zu schlieen.

8.6.2 Urheberrechtshinweis
Urheberrechtshinweis

fgt einen Urheberrechtshinweis mit dem Text Ihrer Wahl in Ihr Kartenfenster ein.

Abbildung 8.7: Der Urheberrechtshinweis-Dialog


1. Whlen Sie Ansicht Dekorationen Urheberrechtshinweis. Der Dialog ffnet sich (siehe figure_decorations_2)
2. Geben Sie den Text den Sie auf der Karte platzieren wollen ein. Sie knnen wie im Beispiel gezeigt HTML
benutzen.
3. Whlen Sie die Platzierung der Beschriftung in der Platzierung
4. Versichern Sie sich dass das

Kombobox aus.

Urheberrechtshinweis aktivieren Kontrollkstchen aktiviert ist.

5. Klicken Sie [OK].


Im oben genannten Beispiel, das den Standard darstellt, platziert QGIS einen Urheberrechtshinweissymbol gefolgt
vom Datum in der rechten unteren Ecke des Kartenfensters.

8.6.3 Nordpfeil
Nordpfeil

platziert einen einfachen Nordpfeil im Kartenfenster. Bislang steht hierfr lediglich eine Pfeilform zur
Verfgung. Sie knnen die Richtung des Nordpfeiles entweder selbst anpassen oder dies automatisch von QGIS
bewerkstellingen lassen. Wenn Sie es QGIS berlassen die Richtung zu bestimmen, entscheided das Programm, in
welche Richtung der Nordpfeil idealerweise zeigen sollte. Zum Platzieren des Pfeils haben Sie vier Mglichkeiten
entsprechend den vier Ecken des Kartenfensters.

8.6.4 Mastab

Mastab

fgt einen einfachen Mastab in das Kartenfenster ein. Sie knnen Mastabstil und Platzierung so
wie die Beschriftung des Balkens steuern.

8.6. Dekorationen

39

QGIS User Guide, Release 2.6

Abbildung 8.8: Der Nordpfeil Dialog

Abbildung 8.9: Der Mastab Dialog


QGIS untersttzt hierbei jedoch lediglich die Darstellung des Balkens in denjenigen Einheiten, die auch in Ihren
entsprechenden Karten verwendet werden. Dies bedeutet, dass Sie einer Karte deren Layer der Einheit Meter
entsprechen, keinen Mastabsbalken in den Einheiten Fu oder Zoll hinzufgen knnen.
Das Hinzufgen eines Mastabbalkens geht folgendermaen:
1. Klicken Sie auf Ansicht Dekorationen Mastab. Der Dialog startet (siehe figure_decorations_4).
2. Whlen Sie die Platzierung aus der Platzierung
3. Whlen Sie den Stil aus der Mastabsstil

Kombobox aus.
Kombobox aus.

4. Whlen Sie die Farbe fr den Balken unter Balkenfarbe


standardmig eingestellte schwarze Farbe.

oder benutzen Sie die

5. Legen Sie die Gre des Balkens und seine Beschriftung unter Gre des Mastabs
6. Versichern Sie sich dass das
7. Gegebenenfalls knnen Sie

fest.

Aktiviere Mastab Kontrollkstchen aktiviert ist.


Bei Grennderungen automatisch runde Zahlen einstellen aktivieren.

8. Klicken Sie [OK].


Tipp: Einstellungen von Dekorationen
Wenn Sie ein .qgs -Projekt speichern werden alle bezglich Nordpfeil, Mastab und Urheberrechtshinweis
gemachten nderungen im Projekt gespeichert und das nchste Mal wenn das Projekt geladen wird wiederhergestellt

40

Kapitel 8. Allgemeine Werkzeuge

QGIS User Guide, Release 2.6

8.7 Beschriftungstools
Beschriftungstext
-Werkzeug in der Atrribut-Werkzeugleiste bietet die Mglichkeit formatierten Text in einer
Das
Sprechblase im QGIS Kartenfenster zu platzieren. Aktivieren Sie dazu einfach das Beschriftungstext-Werkzeug
und klicken Sie in das Kartenfenster.

Abbildung 8.10: Anmerkungstext Dialog


Ein Doppelklick auf das Element ffnet den Dialog mit verschiedenen Optionen. Im Texteditor knnen Sie den
formatierten Text eingeben und einige Einstellungen vornehmen. Z.B. kann das Objekt an einer bestimmten Stelle
positioniert werden, was dann durch ein Markersymbol angezeigt wird. Oder das es unabhngig von dem Objekt
im Kartenfenster angezeigt wird. Der Text kann entweder durch Verschieben der Markierung oder der Sprechblase
im Kartenfenster verschoben werden.
Das

Beschriftung verschieben

Werkzeug ermglicht es Ihnen die Beschriftung auf den Kartenfenster zu verschieben.

8.7.1 HTML-Beschriftung
HTML-Beschriftung
Die
Werkzeuge in der Attribut-Werkzeugleiste ermglichen es den Inhalt einer HTML-Datei
in einer Sprechblase auf dem QGIS-Kartenfenster zu platzieren. Benutzen Sie das HTML-Beschriftung Werkzeug
indem Sie ins Kartenfenster klicken und den Pfad zur HTML-Datei in den Dialog einfgen.

8.7.2 SVG-Anmerkung
SVG-Anmerkung
Das
Werkzeug in der Attribut-Werkzeugleiste ermglicht es ein SVG-Symbol in einer Sprechblase auf dem QGIS-Kartenfenster zu platzieren. Um das SVG-Anmerkung Werkzeug zu benutzen klicken Sie in
das Kartenfenster und fgen Sie den Pfad zur SVG-Datei in den Dialog ein.

8.7.3 Beschriftungsformular
Beschriftungsformular
Werkzeug
Zustzlich knnen Sie eigene Beschriftungsformulare erstellen. Das
ist ntzlich um Attribute eines Vektorlayers in einem mageschneiderten QT-Designer Beschriftungsformular anzuzeigen (siehe figure_custom_annotation). Es ist hnlich wie die Designer-Formulare

8.7. Beschriftungstools

41

QGIS User Guide, Release 2.6

Abbildung 8.11: Benutzerfreundliches QT Designer Beschriftungsformular


fr das Identifizierungswerkzeug, wird aber als Beschriftungstext angezeigt. Siehe auch das Video
https://www.youtube.com/watch?v=0pDBuSbQ02o von Tim Sutton fr weitere Informationen.
Bemerkung: Wenn Sie das Tastenkrzel Ctrl+T drcken whrend ein Beschriftungswerkzeug aktiv ist ndert
sich deren Anzeigestatus zwischen an und aus.

8.8 Rumliche Lesezeichen


Rumliche Lesezeichen ermglichen es, geografische Orte zu markieren und als Lesezeichen abzuspeichern, um
dorthin spter zurckzufinden.

8.8.1 Ein Lesezeichen erstellen


Um ein Lesezeichen zu erstellen:
1. Zoomen oder verschieben Sie das Kartenfenster in einen Ausschnitt Ihrer Wahl.
2. Whlen Sie in der Menleiste Ansicht Neues Lesezeichen oder drcken Sie kbd:Ctrl-B.
3. Geben Sie eine Beschreibung fr das Lesezeichen ein (bis zu 255 Zeichen).
4. Klicken Sie auf Enter um das Lesezeichen hinzuzufgen oder auf [Lschen] um das Lesezeichen zu
entfernen.
Sie knnen mehrere Lesezeichen mit demselben Namen erstellen.

8.8.2 Arbeiten mit Lesezeichen


Um rumliche Lesezeichen zu verwenden oder zu verwalten whlen Sie die Menoption Ansicht Lesezeichen
anzeigen . Mit dem Rumliches Lesezeichen Dialog knnen Sie zu einem rumlichen Lesezeichen zoomen oder
ein Lesezeichen lschen. Sie knnen hier den Namen und die Koordinaten des Lesezeichens bearbeiten.

42

Kapitel 8. Allgemeine Werkzeuge

QGIS User Guide, Release 2.6

8.8.3 Auf ein Lesezeichen zoomen


Im Dialogfenster Rumliches Lesezeichen klicken Sie auf das gewnschte Lesezeichen und whlen dann den
Knopf [Zoomen auf]. Sie knnen auch auf ein Lesezeichen zoomen, indem Sie es mit einem Doppelklick
auswhlen.

8.8.4 Ein Lesezeichen lschen


Um ein Lesezeichen aus dem Rumliches Lesezeichen Dialog zu lschen klicken Sie es an und klicken Sie dann
[Lschen]. Besttigen Sie Ihre Wahl indem Sie [OK] klicken oder brechen Sie das Lschen mit [Abbrechen] ab.

8.9 Layer/Gruppen einbinden


Wenn Sie Inhalte von anderen Projekten in Ihr Projekt einbinden wollen whlen Sie Layer Eingebettete Layer
und Gruppen ....

8.9.1 Layer einbetten


Mit dem folgenden Dialog knnen Sie Layer von anderen Projekten einbetten. Hier ein kleines Beispiel:
1. Drckekn Sie

um nach einem anderen Projekt des Alaskadatensatzes zu suchen.

2. Whlen Sie die Projektdatei grassland. Sie knnen hier den Inhalt des Projektes einsehen (siehe figure_embed_dialog).
3. Klicken Sie Strg und klicken Sie auf die Layer grassland und regions. Klicken Sie [OK]. Die
ausgewhlten Layer sind jetzt in Legende und Kartenfenster eingebettet.

Abbildung 8.12: Einzubettende Layer und Gruppen whlen


Whrenddessen die Layer editierbar sind knnen Sie Ihre Eigenschaften wie Darstellung und Beschriftung nicht
ndern.

8.9.2 Eingebettete Layer entfernen


Machen Sie einen Rechtsklick auf den eingebetteten Layer und whlen Sie

Entfernen

8.9. Layer/Gruppen einbinden

43

QGIS User Guide, Release 2.6

44

Kapitel 8. Allgemeine Werkzeuge

KAPITEL 9

QGIS Konfiguration

Sie knnen QGIS auf vielfache Art und Weise im Men Einstellungen anpassen. Whlen Sie zwischen Bedienfeldern, Werkzeugksten, Projekteinstellungen, Optionen und Anpassungen.
Bemerkung: QGIS befolgt die Desktopvorgaben zum Lokalisieren der Optionen und Projekteigenschaften. Im
Zusammenhang mit dem von Ihnen verwendeten Betriebssystem knnen die oben Beschriebenen Dialoge entweder im Men Ansicht (Bedienfelder und Werkzeugleisten) oder in Projekt fr Optionen gefunden werden.

9.1 Bedienfelder und Werkzeugksten


Im Bedienfelder Men knnen Sie QGIS Widgeds an- und ausschalten. Das Werkzeugkste Men
bietet Ihnen die Mglichkeit Icongruppen in der QGIS Werkzeugleiste an- und auszuschalten (siehe figure_panels_toolbars).

Abbildung 9.1: Das Bedienfelder und Werkzeugksten Men

45

QGIS User Guide, Release 2.6

Tipp: Die QGIS-bersicht aktivieren


Sie knnen in QGIS eine bersicht, die die Gesamtausdehnung der hinzugefgten Layer wiedergibt, benutzen.
Sie kann unter dem Menu Einstellungen Bedienfelder ausgewhlt werden. Innerhalb des Fensters zeigt ein
Rechteck die aktuelle Kartenausdehnung an. Dies ermglicht es Ihnen schnell zu bestimmen welchen Bereich der
Karte Sie gerade sehen. Beachten Sie dass Beschriftungen auch wenn die Layer explizit beschriftet worden sind
in der bersicht nicht dargestellt werden. Wenn Sie auf das Rechteck klicken und es in der bersicht, die die
aktuelle Kartenausdehnung zeigt, verschieben wird das Kartenfenster entsprechend geupdatet.
Tipp: Protokoll anzeigen lassen
Protokoll im Men
Einstellungen BedienEs ist mglich das QGIS Protokoll zu verfolgen. Sie knnen
Ansicht Bedienfelder aktivieren und die Meldungen, die in den verschiedene Reitern whrend
felder oder
des Ladens und im Laufe von Operationen angezeigt werden, verfolgen.

9.2 Projekteigenschaften
Im Eigenschaftenfenster fr das Projekt unter
Einstellungen Projekteinstellungen (kde) oder
Projekt
Projekteigenschaften (Gnome) knnen Sie die projektbezogenen Optionen einstellen. Diese beinhalten:
Im Men Allgemein den Projekttitel, die Auswahl- und Hintergrundfarbe, Layereinheiten, Genauigkeit und
die Option die Pfade der Layer relativ zu speichern. Wenn die KBS-Transformation eingeschaltet ist knnen Sie einen Ellipsoiden fr Abstandsberechnungen auswhlen. Sie knnen die Karteneinheiten definieren
(nur wenn die KBS-Transformation ausgeschaltet ist) sowie die Genauigkeit der benutzten Dezimalstellen.
Auch knnen Sie eine Liste von Projektmastben festlegen die die global voreingestellten Mastbe berschreibt.
Im KBS Men knnen Sie das Koordinatenbezugssystem fr dieses Projekt auswhlen und SpontanReprojektion fr das Darstellen von Vektor- und Rasterlayern mit verschiedenen KBS einschalten.
Mit dem dritten Abfragbare Layer Men legen Sie fest (oder verhindern) welche Layer auf das Objekte
abfragen-Werkzeug reagieren (siehe der Abschnitt ber Kartenwerkzeuge im Abschnitt Optionen ber das
Einschalten der Identifizierung von Mehrfachlayern.).
Mit dem Vorgabestile Men knnen Sie steuern wie neue Layer dargestellt werden wenn kein .qml Stil
definiert wurde. Sie knnen hier auch den voreingestellten Transparenzlevel bestimmen und einstellen ob
Symbolen Zufallsfarben zugewiesen werden sollen. Es gibt auch einen zustzlichen Abschnitt in dem Sie
bestimmte Farben fr das laufende Projekt festlegen knnen. Sie knnen die hinzugefgten Farben im Dropdown-Men des Farbdialogfensters, das Sie in jeder Darstellung zur Verfgung steht.
Im Men OWS Server knnen Sie Informationen ber die QGIS Server WMS- und WFS-Eigenschaften,
Ausdehnung und KBS-Beschrnkungen definieren.
Das Men Macros wird verwendet um Python-Makros fr Projekte zu bearbeiten. Zur Zeit sind nur drei
Makros mglich:openProject(), saveProject() und closeProject().
Das Men Beziehungen wird verwendet um 1:n-Beziehungen zu definieren. Die Beziehungen werden im
Dialog Projekteigenschaften definiert. Sind einmal Beziehungen fr einen Layer erstellt erscheint ein neues
Schnittstellenelement im Objektformular (z.B. wenn Sie ein Objekt abfragen und sein Formular ffnen) das
die damit verknpften Elemente auflistet. Dies ist eine leistungsfhige Methode um z.B. die Inspektionsgeschichte eines Pipelineabschnittes oder Straenabsschnittes auszudrcken. Sie knnen mehr ber die
Untersttzung von 1:n Beziehungen im Abschnitt Ein-Zu-Mehrere-Beziehungen erstellen finden.

9.3 Optionen
Einige grundlegende Optionen fr QGIS knnen mit dem Optionen Dialog gewhlt werden. Whlen Sie die
Menoption Einstellungen Optionen. Die Mens mit denen Sie Ihre Optionen optimieren knnen sind:
46

Kapitel 9. QGIS Konfiguration

QGIS User Guide, Release 2.6

Abbildung 9.2: Makroeinstellungen in QGIS

9.3.1 Men Allgemein


Anwendung
und whlen
Whlen Sie Stil (QGIS-Neustart erforderlich)
gen,Windows,Motif,CDE, Plastique, GTK+ und Cleanlooks ( ).

zwischen

Oxy-

. Derzeit ist nur default mglich.

Definieren Sie das Icon-Thema


Definieren Sie die Icon-Gre

Sie

Definieren Sie die Schriftart. Whlen Sie zwischen


Schriftart.

Qt-Voreinstellung und einer benutzerdefinierten

Verndern Sie Dauer von zeitweiligen Meldungen oder Dialogen

Splashscreen beim Start nicht anzeigen

Tipps beim Starten anzeigen

Gruppenrahmentitel fett

Gruppenrahmen im QGIS-Stil

Farbauswahldialoge verwenden, die laufend aktualisieren

Projektdateien
Projekt beim Starten ffnen

(whlen Sie zwischen Neu, Zuletzt verwendetes und Bestimmtes).

Wenn Sie Bestimmtes whlen benutzen Sie den

Knopf um ein Projekt festzulegen.

Neues Projekt aus Vorgabeprojekt erstellen. Sie haben die Mglichkeit auf Aktuelles Projekt als Vorgabe
speichern oder Vorgabe zurcksetzen zu drcken. Sie knnen durch Ihre Dateien gehen und ein Verzeichnis
definieren in dem Sie ihre benutzerdefinierten Projektvorlagen festlegen. Diese werden dann dem Men
Projekt Neu aus Vorlage hinzugefgt wenn Sie erst
Neues Projekt aus Vorgabeprojekt erstellen
aktivieren und dann ein Projekt in den Projektvorlagenordner speichern.

Bei Bedarf nachfragen, ob genderte Projekt und Datenquellen gespeichert werden sollen

9.3. Optionen

47

QGIS User Guide, Release 2.6

Warnung ausgeben wenn QGIS-Projekt einer frheren Version geffnet wird

Makros aktivieren
. Diese Option wurde erstellt um Makros zu handhaben die geschrieben wurden
um eine Aktion auf Projektereignisse auszufhren. Sie knnen zwischen Nie, Fragen, Nur in dieser
Sitzung und Immer (nicht empfohlen) whlen.

9.3.2 Men System


Umgebung
Systemumgebungsvariablen knnen nun eingesehen werden und viele von ihnen konfiguriert in der Umgebung
Gruppe (siehe figure_environment_variables). Dies ist fr Betriebssysteme wie Mac ntzlich da dort eine GUI
Anwendung nicht notwendigerweise die Shellumgebung des Benutzers bernimmt. Sie ist auch ntzlich um
Umgebungsvariablen fr externe Werkzeuge die von der Verarbeitungs-Toolbox (z.B. SAGA, GRASS) kontrolliert werden zu setzen und zu visualisieren und um die Debug-Ausgabe fr bestimmte Abschnitte des Quellcodes
anzuschalten.

Benutzerdefinierte Umgebungsvariablen verwenden (Neustart erforderlich - Trennzeichen einschlieen).


Sie knnen Variablen [Hinzufgen] und [Entfernen]. Bereits definierte Umgebungsvariablen sind unter Aktuelle Umgebungsvariablen dargestellt und es ist mglich sie zu filtern indem Sie
Variablen anzeigen aktivieren.

Nur QGIS-spezifische

Abbildung 9.3: Systemumgebungsvariablen in QGIS


Erweiterungspfade
[Hinzufgen] und [Entfernen] von Nach zustzlichen C++ Erweiterungsbibliotheken zu durchsuchende Pfad(e)

9.3.3 Men Datenquellen


Objektattribute und -tabelle

48

Kapitel 9. QGIS Konfiguration

QGIS User Guide, Release 2.6

Attributtabelle gedockt ffnen (QGIS-Neustart erforderlich)


Ausgewhlte Zeilen in die Zwischenablage kopieren
Geometrie in WKT aus Attributtabelle kopieren. Wenn Sie
aus
dem Attributtabelle Dialog verwenden, hat dies zum Ergebnis dass auch die Koordinaten von Punkten und
Sttzpunkten auch in die Zwischenablage kopiert werden.

Attributtabellenverhalten
. Es gibt drei Mglichkeiten: Alle Objekte anzeigen, Alle gewhlten Objekte anzeigen und Sichtbare Objekte der Karte anzeigen
Attributtabellenzeilencache
. Dieser Zeilencache erlaubt es, die N zuletzt geladenen Attributzeilen
im Cache zu speichern. Dadurch wird das Arbeiten mit der Attributtabelle schneller. Der Cache wird wieder
gelscht, wenn man die Attributtabelle schliesst.
Reprsentation fr NULL-Werte. Hier knnen Sie einen Wert fr Datenfelder die einen NULL-Wert enthalten festlegen.
Datenquellenbehandlung
Nach gltigen Element im Browser suchen
halt prfen whlen.

. Sie knnen zwischen Erweiterung prfen und Dateiin-

Inhalt komprimierter Dateien (.zip) im Browser durchsuchen


sind mglich.

. Nein, Grundsuche und Vollsuche

Beim ffnen nach Rasterunterlayern fragen. Einige Rasterformate untersttzen Unterlayer - sie werden
Subdataset in GDAL genannt. Ein Beispiel sind netCDF-Dateien - wenn es viele netCDF-Variablen gibt
interpretiert GDAL jede Variable als Subdataset. Die Option ermglicht es Ihnen zu steuern wie mit
Unterlayern umgegangen wird wenn eine Datei mit Unterlayern geffnet wird. Sie haben die folgenden
Wahlmglichkeiten:
Immer: Immer fragen (ob es Unterlayer gibt)
Wenn ntig: Fragen ob Layer keine Bnder aber Unterlayer hat
Nie: Nie fragen, ldt dann nichts
Alle laden: Nie auffordern aber alle Unterlayer laden

Shapefile-Kodierungsangabe ignorieren. Wenn eine Shapedatei Kodierungsinformationen enthlt wird


dieses von QGIS ignoriert.

PostGIS-Layer per Doppelklick hinzufgen und zur Auswahl den erweiterten Modus verwenden

Oracle-Layer mit Doppelklick hinzufgen und zur Auswahl den erweiterten Modus verwenden

9.3.4 Men Darstellung


Zeichenverhalten

Normalerweise werden alle neuen Layer im Kartenfenster angezeigt

Wo mglich den Darstellungscache benutzen, um das Neuzeichnen zu beschleunigen

Layer mit vielen CPU-Kernen parallel zeichnen

Max. zu benutzende Kerne

Kartenaktualisierungsintervall

Geometrievereinfachung fr neue Layer voreinstellen

Vereinfachungsschwelle

Auf Datenlieferantenebene vereinfachen, wenn mglich

9.3. Optionen

49

QGIS User Guide, Release 2.6

Grter Mastab bis zu dem der Layer vereinfacht werden soll


Zeichenqualitt

Linie auf Kosten der Zeichengeschwindigkeit weniger gezackt zeichnen

Raster
Mit RGB Kanalauswahl knnen Sie Nummer fr den Roten Kanal, Grnen Kanal und Blauen Kanal festlegen.
Kontrasverbesserung
. Fr ein Einkanalgraustufenband kann eingestellt werden: Kein Stretch,
Einkanalgraustufen
Strecken auf MinMax, Strecken und Zuschneiden auf MinMax und Zuschneiden auf MinMax.
. Optionen sind Kein Strecken, Strecken auf MinMax, Strecken
Multikanalfarbe (Byte/Kanal)
und Zuschneiden auf MinMax und Zuschneiden auf MinMax.
Multikanalfarbe (>Byte/Band)
. Optionen sind Kein Strecken, Strecken auf MinMax, Strecken
und Zuschneiden auf MinMax und Zuschneiden auf MinMax
Grenzen (Minimum/Maximum)
. Optionen sind Kumulativer Pixelanzahl-Schnitt, Minimum/Maximum, Mittlere +/- Standardabweichung
Kommulative Pixelanzahl-Schnittgrenzen
Standardabweichungsfaktor
Fehlersuche

Kartenaktualisierung

9.3.5 Men Farben


Dieses Men ermglicht es Ihnen benutzerdefinierte Farben hinzuzufgen die Sie in jedem Farbdialogfenster
der Darstellungen finden knnen. Sie sehen in dem Reiter eine Reihe von vordefnierten Farben: Sie knnen alle
lschen oder bearbeiten. Darberhinaus knnen Sie eine Farbe Ihrer Wahl hinzufgen und eine Kopieren und
Einfgen Operation durchfhren. Schlielich knnen Sie den Farbsatz als gpl Datei exportieren oder importieren.

9.3.6 Men Karte und Legende


Voreingestelltes Kartenaussehen (Projekteigenschaften berschreiben)
Definieren Sie eine Farbe fr Auswahlen und eine Hintergrundfarbe
Layerlegende
Doppelklickaktion in Legende
nen oder Attributtabelle ffnen.

. Sie knnen mit dem Doppelklick entweder Layereigenschaften ff-

Die folgenden Legendenelementstile sind mglich:

50

Layernamen gro schreiben

Layernamen fett

Gruppennamen fett

Klassifikationsattributnamen anzeigen

Rastericons erzeugen (kann langsam sein)

Neue Layer zur gewhlten oder aktuellen Gruppe hinzufgen

Kapitel 9. QGIS Konfiguration

QGIS User Guide, Release 2.6

9.3.7 Men Kartenwerkzeuge


Dieses Men bietet einige Optionen in Bezug auf das Verhalten des Objekte abfragen Werkzeugs.
Suchradius fr die Objektidentifikation und zur Maptipanzeige ist ein Toleranzfaktor ausgedrckt als
Prozentsatz der Kartenbreite. Das heit dass das Objekte abfragen Werkzeug so lange Ergebnisse anzeigt
wie sie innerhalb dieser Toleranz klicken.
Mit Hervorhebungsfarbe knnen Sie whlen mit welcher Farbe abgefragte Objekte hervorgehoben werden
solllen.
Puffer, ausgedrckt als Prozentsatz der Kartenbreite, legt eine Pufferdistanz, die durch die Umrisslinie der
Hervorhebung dargestellt wird, fest.
Minimalbreite, ausgedrckt als Prozentsatz der Kartenbreite, legt fest wie dick die Umrisslinie eines hervorgehobenen Objektes sein soll.
Messwerkzeug
Definieren Sie Gummibandfarbe fr das Mewerkzeug
Definieren Sie Dezimalstellen

Basiseinheit beibehalten

Bevorzugte Maeinheiten
Bevorzugtes Winkelma

(Meter, Fu, Seemeilen oder Grad)


(Grad, Bogenma oder Gon)

Verschieben und Zoomen


Definieren Sie Mausradaktion (Zoom, Zoomen und mittig zentrieren, Zur Mausposition zoomen, Nichts)
Definieren Sie Zoomfaktor fr das Mausrad
Vordefinierte Mastbe
Hier finden Sie eine Liste von vordefinierten Mastben. Mit den [+] und [-]-Knpfen knnen Sie Ihre individuellen Mastbe hinzufgen oder lschen.

9.3.8 Men Zusammenstellung


Zusammenstellungsvoreinstellungen
Sie knnen hier die Vorgabeschriftart festlegen
Gitterdarstellung
Definieren Sie den Gitterstil

(Ausgefllt, Punkte, Kreuze)

Definieren Sie Farbe ...


Gittervoreinstellungen
Legen Sie Zwischenrume

fest

Legen Sie den Gitterversatz

fr x und y fest

Legen Sie die Fangtoleranz

fest

Fhrungsvorgaben
Legen Sie die Fangtoleranz

9.3. Optionen

fest

51

QGIS User Guide, Release 2.6

9.3.9 Men Kartenwerkzeuge


Objekterzeugung

Eingabe der Attributwerte bei der Erstellung neuer Objekte unterdrcken

Letzte Attributwerteingaben wiederverwenden

Geometrien prfen. Das Bearbeiten komplexer Linien/Polygone mit vielen Sttzpunkten kann zu einer erheblichen Verlangsamung der Darstellung fhren. Das liegt an den Standard-Validierungsverfahren, die viel
Zeit bentigen. Um die Darstellung zu beschleunigen ist es mglich die Geometrieberprfung von GEOS
(von GEOS 3.3.an) zu whlen oder die Validierung ganz auszuschalten. Die GEOS Geometrieberprfung
ist viel schneller, aber der Nachteil ist dass nur das erste Geometrieproblem gemeldet wird.
Gummiband
Definieren Sie fr das Gummiband die Linienbreite und Linienfarbe
Objektfang

Fangoptionsdialog in einem Dockfenster anzeigen (QGIS-Neustart erforderlich)

Legen Sie den Voreingestellten Fangmodus


und Segment, Aus) fest

(Zum Sttzpunkt, Zum Segment, Zum Sttzpunkt

Definieren Sie die Voreingestellte Fangtoleranz in Karteneinheiten oder Pixeln


Definieren Sie den Suchradius fr die Sttzpunktbearbeitung in Karteneinheiten oder Pixeln.
Sttzpunktmarken

Markierungen nur fr gewhlte Objekte anzeigen

Legen Sie fr die Sttzpunktmarken den Markierungsstil


Kreis oder Keine) fest

(Kreuz (standard), Teiltransparenter

Definieren Sie die Markierungsgre fr die Sttzpunktmarken


Werkzeug zum Linien versetzen
Linie versetzen
Die nchsten 3 Optionen beziehen sich auf das
Werkzeug in Erweiterte Digitalisierung. Durch die
verschiedenen Einstellungen ist es mglich die Form des Linienversatzes zu beeinflussen. Diese Optionen sind
von GEOS 3.3 an mglich.

Verbindungsstil
Quadrantensegmente
Eckengrenze

9.3.10 Men GDAL


GDAL ist eine Datenaustauschbibliothek fr Rasterdateien. In diesem Men knnen Sie Erzeugungsoptionen
bearbeiten und Pyramidenoptionen bearbeiten . Definieren Sie welcher GDAL-Treiber fr ein Rasterformat benutzt wird, da in einigen Fllen mehr als ein Treiber zur Verfgung gestellt wird.

9.3.11 Men KBS


Vorgabe-KBS fr neue Projekte

52

Spontanreprojektion nicht einschalten

Spontanreprojektion (SRP) automatisch aktivieren wenn die Layer unterschiedliche KBS haben

Kapitel 9. QGIS Konfiguration

QGIS User Guide, Release 2.6

Spontanreprojektion voreinstellen

Whlen Sie ein KBS aus und Neue Projekte immer in diesem KBS beginnen
KBS fr neue Layer
Der zweite Bereich ermglicht es, Voreinstellungen vorzunehmen, wenn ein neuer Layer erzeugt wird oder ein
Layer geladen wird, der keine KBS Information besitzt.

KBS abfragen

KBS des Projekts benutzen

Folgendes KBS benutzen

Datumtransformationsvorgaben

Datumtransformation erfragen wenn keine Vorgabe definiert ist

Wenn Sie mit der Spontan KBS Transformation gearbeitet haben knnen sie das Ergebnis der Transformation im Fenster unten sehen. Sie knnen Informationen ber das Quell-KBS und das Ziel-KBS genauso
wie ber Quell-Datumstransformation und Ziel-Datumstransformation finden.

9.3.12 Men Sprache

System-Locale berschreiben und Stattdessen folgende Spracheinstellungen benutzen

Informationen ber die aktive System-Locale

9.3.13 Men Netzwerk


Allgemein
WMS Suchadresse - Standard ist http://geopole.org/wms/search?search=%1&type=rss
Definieren Sie Zeitberschreitung fr Netzwerkanfragen (ms) - Standard ist 60000
Definieren Sie Verfallszeitraumvorgabe fr WMS-C/WMTS Kacheln (Stunden) - Standard ist 24
Legen Sie Maximale Wiederholungen bei Kachelabfragefehlern fest.
Definieren Sie User-Agent
Cache-Einstellungen
Definieren Sie das Verzeichnis und eine Gre fr den Cache.

Proxy fr Web-Zugriff benutzen und entsprechend Host, Port, Benutzer und Passwort definieren.

Definieren Sie den Proxytyp entsprechend ihrer Bedrfnisse.


DefaultProxy : Proxy wird auf Grundlage des Proxy der Anwendung festgelegt
Socks5Proxy : Proxy fr jede Art von Verbindung. Untersttzt TCP, UDP, Bindung an einen Port
(eingehende Verbindungen) und Authentifizierung.
HttpProxy : Umgesetzt mit dem CONNECT-Befehl, untersttzt nur ausgehende TCPVerbindungen und Authentifizierung.
HttpCachingProxy:Umgesetzt mit normalen HTTP Befehlen ist dies nur im Zusammenhang mit HTTP
Befehlen sinnvoll einzusetzen.
FtpCachingProxy: Mit einem FTP-Proxy umgesetzt ist dies nur sinnvoll im Zusammenhang mit FTPAnforderungen anzuwenden

9.3. Optionen

53

QGIS User Guide, Release 2.6

Abbildung 9.4: Proxy-Einstellungen in QGIS

54

Kapitel 9. QGIS Konfiguration

QGIS User Guide, Release 2.6

Das Ausschlieen von URLs kann in das Textfenster unter den Proxyeinstellungen eingetragen werden (siehe
Figure_Network_Tab).
Wenn Sie weitere Informationen ber die verschiedenen Proxyeinstellungen bentigen, schauen Sie bitte im Handbuch der QT-Bibliothek nach unter der http://doc.trolltech.com/4.5/qnetworkproxy.html#ProxyType-enum.
Tipp: Proxy richtig anwenden
Das Verwenden von Proxys kann manchmal schwierig sein. Es ist sinnvoll die oben angesprochenen Proxytypen
auszuprobieren, um zu sehen, welcher in dem jeweiligen Fall am besten funktioniert.
Sie knnen die Optionen nach Ihren Bedrfnissen verndern. Bei einigen der nderungen kann ein Neustart von
QGIS erforderlich sein bevor sie wirksam werden.

Einstellungen sind gespeichert in einer Textdatei: $HOME/.config/QGIS/QGIS2.conf

Alle Einstellungen sind gespeichert in: $HOME/Library/Preferences/org.qgis.qgis.plist

Einstellungen sind gespeichert in der Registry unter: HKEYCURRENT_USERSoftwareQGISqgis

9.4 Anpassung
Mit dem Anpassungswerkzeug knnen fast jedes Element in der QGIS Benutzeroberflche (de)aktivieren. Dies
kann sehr ntzlich sein wenn man viele Plugins, die sie nie benutzen und die den Bildschirm berfllen, installiert
hat.

Abbildung 9.5: Der Anpassung Dialog

Die QGIS-Anpassung ist in fnf Gruppen unterteilt. Mit

Menus knnen Sie Eintrge aus der Menleiste ver-

stecken. In
Panels finden Sie die Dock-Fenster. Dock-Fenster sind Anwendungen die als frei schwebendes
top-level Fenster oder eingebettet in das QGIS Hauptfenster a gedocktes Widged gestartet und genutzt werden
knnen (siehe auch Bedienfelder und Werkzeugksten). Mit

Status Bar knnen Features wie die Koordinaten-

Toolbars knnen Sie Werkzeugleisteneintrge von QGIS und mit


information deaktiviert werden. Mit
Widgeds knnen Sie Dialoge genauso wie Ihre Knpfe (de)aktivieren.
Umschalten um Bedienelemente der Hauptapplikation zu fangen
Mit
knnen Sie auf Elemente in QGIS die sie verstecken wollen
klicken und den enstprechenden Eintrag in Anpassung finden (siehe figure_customization). Sie knnen genauso
ihre verschiedenen Setups fr verschiedene Anwendungen speichern. Sie mssen QGIS neustarten bevor die nderungen angewendet werden.

9.4. Anpassung

55

QGIS User Guide, Release 2.6

56

Kapitel 9. QGIS Konfiguration

KAPITEL 10

Arbeiten mit Projektionen

QGIS ermglicht es, globale und projektbezogene KBS (Koordinatenbezugssysteme) fr Layer ohne vordefinierte
KBS zu definieren. Es knnen benutzerdefinierte Koordinatenbezugssysteme erstellt werden und fr Raster- und
Vektorlayer wird On-The-Fly (OTF) Projektion untersttzt, um Layer gemeinsam und lagegenau darzustellen,
auch wenn sie unterschiedliche KBS besitzen.

10.1 berblick zur Projektionsuntersttzung


QGIS untersttzt etwa 2700 bekannte Koordinatenbezugssysteme (KBS). Diese sind in einer SQlite-Datenbank
abgelegt, die mit QGIS installiert wird. Normalerweise muss diese Datenbank nicht editiert werden, und es kann
Probleme verursachen, wenn Sie es dennoch versuchen. Selbstdefinierte KBS sind in einer Benutzerdatenbank
abgelegt. Informationen zum Anlegen einer Benutzerdatenbank finden Sie im Abschnitt Eigenes Koordinatenbezugssystem definieren.
Die Koordinatenbezugssysteme in QGIS basieren auf EPSG Codes der European Petroleum Search Group (EPSG)
und dem Institut Geographic National de France (IGNF) und entsprechen weitestgehend den spatial reference
Tabellen der Software GDAL. Die EPSG IDs sind in einer SQlite-Datenbank abgelegt und werden benutzt, um
KBS in QGIS zu spezifizieren.
Um OTF Projektion zu verwenden, mssen die Daten Informationen ber ihr Koordinatenbezugssystem enthalten
oder Sie mssen ein globales, layer- oder projektbezogenes KBS definieren. Bei PostGIS-Layern benutzt QGIS die
spatial reference ID, die bei der Erstellung des Layers festgelegt wurde. Bei Daten, die von der OGR-Bibliothek
untersttzt werden, bezieht sich QGIS auf das Vorhandensein eines KBS bei den Daten. Bei Shapes bedeutet dies,
dass eine Datei mit der Endung .prj vorhanden sein muss, in der das KBS im Well Known Text (WKT) Format
angegeben ist. Fr ein Shape mit dem Namen alaska.shp gbe es also eine entsprechende Projektionsdatei
alaska.prj.
Sobald Sie ein neues KBS auswhlen ndern sich die Layereinheiten automatisch im Men Allgemeindes |mActionOptions| :guilabel:Projekteigenschaften Dialogs unter Projekt (Gnome, OS X) oder :guilabel:Einstellungen
(KDE, Windows).

10.2 Bestimmung einer globalen Projektion


QGIS startet ein neues Projekt mit dem Festlegen eines Standard-KBS. Vordefiniert ist EPSG:4326 - WGS84
(proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs). Sie knnen diese Grundeinstellung ber
den [Whlen ...] Knopf, der dazu verwendet wird das Standard-Koordinatensystem fr neue Projekte zu
definieren, im ersten Abschnitt ndern, wie in figure_projection_1 gezeigt. Diese Auswahl wird dann fr die
folgenden QGIS Sitzungen gespeichert.
Wenn Sie Layer, die kein KBS besitzen, verwenden, mssen Sie festlegen wie QGIS auf diese Layer reagiert. Dies
kann global oder projektbezogen im KBS Men unter Einstellungen Optionen erfolgen.
Die Optionen aus figure_projection_1 sind:

57

QGIS User Guide, Release 2.6

Abbildung 10.1: Men KBS im QGIS Optionen Dialog

58

Kapitel 10. Arbeiten mit Projektionen

QGIS User Guide, Release 2.6

KBS abfragen

KBS des Projektes nutzen

Folgendes KBS benutzen

Wenn Sie ein Koordinatenbezugssystem fr einen bestimmten Layer ohne KBS-Information definieren wollen
knnen Sie das im Men Allgemein des Raster- und Vektorlayereigenschaften-Dialogs durchfhren (siehe Men
Allgemein fr Rasterlayer und :ref:vectorgeneralmenu fr Vektorlayer). Wenn der Layer schon eine KBSInformation besitzt wird dies wie in Vektor Layereigenschaften Dialog dargestellt.
Tipp: KBS im Kontextmen des Layers
Wenn Sie mit der rechten Maustaste auf den Layernamen im Legendenbereich klicken, ffnet sich das Kontextmen des Layers (Kapitel Legende). Dort befinden sich zwei Mglichkeiten zur Einstellung des KBS KBS
fr Layer setzen ffnet den KBS Dialog (siehe Abbildung figure_projection_2). Layer-KBS dem Projekt zuweisen
berschreibt das aktuelle Projekt-KBS mit dem KBS des Layers.

10.3 On-The-Fly (OTF) Projektion


QGIS untersttzt jetzt die On-The-Fly Reprojektion fr Raster- und Vektorlayer. Diese Funktion ist aber nicht als
Standard aktiviert. Um sie auszuwhlen, ffnen Sie den Dialog
KBS und klicken dort auf das Kontrollkstchen

Projekteinstellungen, wechseln in das Men

Spontan-KBS-Transformation aktivieren.

Es gibt drei Mglichkeiten, um dies zu erreichen:


1. Whlen Sie
Men.

Projekteigenschaften aus dem Projekt (Gnome, OSX) oder Einstellungen (KDE, Windows)

2. Klicken Sie auf das

KBS Status

Icon in der rechten unteren Ecke der Statusleiste.

3. Aktivieren Sie OTF als Standardeinstellung, indem Sie das Men KBS im Optionen Dialog ffnen und
On-The-Fly-Reprojektion voreinstellen aktivieren wenn die Layer verschiedene KBS haben.
Wenn Sie bereits einen Layer geladen haben und nun die Untersttzung fr Spontan-KBS-Projektion aktivieren
wollen ist der beste Weg folgender: ffnen Sie das Men KBS im Men Projekteinstellungen ..., whlen Sie
das passende KBS fr den Layer aus und aktivieren Sie dann das Kontrollkstchen

On-The-Fly-KBS-

KBS-Status
Transformation aktivieren. Das Icon
ist nun nicht lnger ausgegraut, und alle daraufhin geladenen
Layer werden On-The-Fly auf das ausgewhlte KBS projiziert.

Das Men KBS des Projekteigenschaften-Dialogs enthlt 5 wichtige Optionen (siehe Figure_projection_2). Diese
werden im Folgenden beschrieben.
1. Spontan-KBS-Transformation aktivieren Dieses Kontrollkstchen wird dazu verwendet Spontan-KBSTransformation ein- oder auszuschalten. Ist diese ausgeschaltet wird jeder Layer anhand der Koordinaten aus der Datenquelle gezeichnet und die unten beschriebenen Komponenten sind nicht aktiv. Ist diese
eingeschaltet werden die Koordinaten in jedem Layer zu dem KBS, das fr das Kartenfenster definiert
wurde, projeziert.
2. Filter - wenn Sie den EPSG Code, die ID oder den Namen fr ein Koordinatenbezugssystem kennen knnen
Sie diese benutzen, um ihr Koordinatenbezugssystem zu finden. Geben Sie einfach einen EPSG Code, eine
ID oder einen Namen ein.
3. Krzlich benutzte Koordinatenbezugssysteme -Wenn Sie bestimmte Koordinatenbezugssysteme
regelmig fr ihre tgliche GIS Arbeit verwenden, werden diese fr den schnellen Zugriff unterhalb
des Fensters mit den vorhandenen KBS angezeigt. Klicken Sie auf einen der Knpfe, um das enstprechende
KBS direkt auszuwhlen.
4. Koordinatenbezugssystem der Welt Dies ist eine Liste von allen KBS die von QGIS untersttzt werden,
darunter Geographische, Projezierte und Benutzerdefinierte Koordinatenbezugssysteme. Um ein KBS zu
10.3. On-The-Fly (OTF) Projektion

59

QGIS User Guide, Release 2.6

Abbildung 10.2: Projekteigenschaften Dialog


definieren whlen Sie es aus der Liste indem Sie den entsprechenden Knoten aufklappen und das KBS
auswhlen. Das aktive KBS ist vorgewhlt.
5. Proj4Text - dies ist ein Ausdruck der von der PROJ4-Bibliothek genutzt wird. Er dient nur zu Information
und kann nicht verndert werden.
Tipp: Dialog Projekteigenschaften
Wenn Sie den Projekteigenschaften Dialog von dem Projekt Men ffnen mssen Sie auf das CRS Men klicken
um die KBS Einstellungen anzuzeigen.
Wenn man den Dialog anhand des
gebracht.

KBS-Status

Icons ffnet wird automatisch das KBS Men in den Vordergrund

10.4 Eigenes Koordinatenbezugssystem definieren


Wenn QGIS nicht das Koordinatenbezugssystem das Sie brauchen zur Verfgung stellt knnen Sie ein Benutzerdefiniertes Koordinatensystem definieren. Um ein KBS zu definieren whlen Sie
Benutzerkoordinatenbezugssystem ... aus dem Men Einstellungen. Benutzerkoordinatenbezugssysteme werden in Ihrer QGIS Benutzerdatenbank gespeichert. Zustzlich zu Ihrem Benutzerkoordinatensystem enthlt diese Datenbank auch Ihre
Rumlichen Lesezeichen und andere Benutzerdaten.
Wenn man in QGIS eine eigene Projektion erstellen mchte bedarf es einem grundlegenden Verstndnis im Umgang mit der PROJ.4-Bibliothek. Zu Beginn sollten Sie einen Blick in das Benutzerhandbuch von PROJ werfen. Cartographic Projection Procedures for the UNIX Environment - A Users Manual by Gerald I. Evenden,
U.S. Geological Survey Open-File Report 90-284, 1990 (zu finden unter ftp://ftp.remotesensing.org/proj/OF90284.pdf).
Dieses Handbuch beschreibt die Anwendung von proj.4 und die damit verbundenen Kommandozeilenprogramme. Die dort beschriebenen kartographischen Parameter sind identisch mit denen, die in QGIS verwendet
60

Kapitel 10. Arbeiten mit Projektionen

QGIS User Guide, Release 2.6

Abbildung 10.3: Der Benutzerkoordinatensystem Dialog


werden.
Der Dialog Definition eines Benutzerkoordinatensystems braucht nur zwei Eintrge, um eine eigene Projektion zu
definieren:
1. Ein beschreibender Name
2. Die kartografischen Parameter im PROJ.4-Format
Um ein neues KBS zu erstellen klicken Sie
KBS-Parameter ein.

Neu

Knopf und geben Sie einen aussagekrftigen Namen sowie die

Denken Sie daran, dass die kartographischen Parameter mit einem +proj=-Block beginnen mssen, um den
Beginn eines neuen KBS anzuzeigen.
Sie knnen das neue KBS testen, um zu sehen, ob bei einer Konvertierung von bekannten WGS84 Lat-Lon Koordinaten in ihre Projektion ein sinnvolles Ergebnis herauskommt. Dazu kopieren Sie ihre kartographischen Parameter in das Fenster Parameter, geben ein paar bekannte WGS84 Lat-Lon Koordinaten an und klicken dann auf den
Knopf [Berechnen]. Vergleichen Sie die Ergebnisse mit den Werten im Kartenfenster.

10.5 Standard Datumtransformationen


Eine Spontan-Reprojektion hngt davon ab ob Daten in ein Standard-KBS transformiert werden knnen, QGIS
benutzt hierbei WGS84. Fr einige KBS sind eine Reihe von Transformationen verfgbar. Sie knnen unter QGIS
die benutzte Transformation definieren sonst benutzt es eine Standard-Transformation.
Im KBS Men unter Einstellungen

Optionen knnen Sie:

qg| so einstellen dass es fragt wenn es eine Transformation definieren muss indem Sie
mation erfragen, wenn keine Vorgabe definiert ist benutzen
10.5. Standard Datumtransformationen

Datumtransfor-

61

QGIS User Guide, Release 2.6

eine Liste von Benutzereinstellungen fr Transformationen bearbeiten


QGIS fragt welche Transformation benutzt werden soll indem es eine Dialogbox, die den PROJ.4 Text der
wiederum die Quell- und Ziel-Datumstransformation beschreibt, ffnet. Weitere Informationen sind zu finden indem man mit der Maus ber eine Transformation geht. Benutzereinstellungen knnen gespeichert werden indem
Speichere Auswahl auswhlen.
Sie
.

62

Kapitel 10. Arbeiten mit Projektionen

KAPITEL 11

QGIS Browser

Der QGIS Browser ist ein Bedienfeld in QGIS mit dem Sie auf einfache Art und Weise in Ihrem Dateisystem
navigieren knnen und Geodaten verwalten knnen. Sie knnen Zugang zu Ihren Vektordateien (z.B. ESRI Shapedateien oder MapInfo Dateien), zu Ihren Datenbanken (z.B. PostGIS, Oracle, SpatiaLite oder rumliche MSSQL)
und zu Ihren WMS/WFS Verbindungen herstellen. Sie knnen auch GRASS-Daten anschauen (siehe GRASS GIS
Integration um die Daten ins QGIS zu importieren).

Abbildung 11.1: QGIS Browser als eigenstndige Anwendung


Verwenden Sie QGIS Browser um einen Preview von Ihren Daten zu machen. Mit der Drag- und Drop-Funktion
knnen Sie auf einfache Art und Weise ihre Daten in das Kartenfenster und in die Legende bringen.
1. Aktivieren Sie den QGIS Browser: Machen Sie einen Rechtsklick in die Werkzeugleiste und aktivieren Sie
Browser oder whlen Sie es in Einstellungen Bedienfelder aus.
2. Verschieben Sie das Bedienfeld in die Legende und lass Sie es los.
3. Klicken Sie auf den Browser Reiter
4. Durchsuchen Sie Ihr Dateisystem und whlen Sie die den shapefile Ordner aus dem
qgis_sample_data Verzeichnis aus.
5. Drcken Sie den Umschalt Taste und whlen Sie die airports.shp und alaska.shp Dateien.

63

QGIS User Guide, Release 2.6

6. Klicken Sie die linke Maustaste und machen dann mit den Dateien ein Drag&Drop in die Kartenansicht.
7. Machen Sie einen Rechtsklick auf einen Layer und whlen Sie Layer-KBS dem Projekt zuweisen. Weitere
Informationen sehen Sie unter Arbeiten mit Projektionen.
8. Klicken Sie auf

Volle Ausdehnung

um die Layer sichtbar zu machen.

Es gibt einen zweiten Browser unter Einstellungen Bedienfelder. Dies ist ntzlich wenn Sie Dateien oder Layer
zwischen verschiedenen Orten verschieben mssen.
1. Aktivieren Sie den QGIS Browser: Machen Sie einen Rechtsklick in die Werkzeugleiste und aktivieren Sie
Browser (2) oder whlen Sie es in Einstellungen Bedienfelder aus.
2. Schieben Sie das Bedienfeld in die Legende.
3. Navigieren Sie zum Browser (2) Reiter und suchen Sie nach einer Shapedatei in Ihrem Dateisystem.
4. Whlen Sie eine Datei mit der linken Maustaste aus. Jetzt knnen Sie das
verwenden um diese dem aktuellen Projekt hinzuzufgen.

Gewhlte Layer hinzufgen

Icon

QGIS sucht automatisch nach dem Koordinatenbezugssystem (KBS) und zoomt auf die Layerausdehnung wenn
Sie in einem leeren QGIS Projekt arbeiten. Wenn es schon Dateien in Ihrem Projekt gibt wird die Datei einfach
hinzugefgt und in dem Fall dass es die gleiche Ausdehnung und KBS hat wird sie dargestellt. Wenn die Datei
ein anderes KBS und Layerausdehnung hat mssen Sie erst auf den Layer rechtsklicken und dann Layer-KBS dem
Projekt zuweisen auswhlen. Whlen Sie dann Auf die Layerausdehnung zoomen.
Dateifilter
Funktion funktioniert auf Verzeichnisebene. Suchen Sie den Ordner in dem Sie Dateien filtern
Die
wollen und geben Sie ein Suchwort oder Wildcard ein. Der Browser zeigt dann nur die zutreffenden Dateinamen
an - andere Daten werden nicht dargestellt.

Es ist genauso mglich, den QGIS Browser als eigenstndige Anwendung auszufhren.
Den QGIS Browser starten

Tippen Sie qbrowser in eine Kommandozeile.

Starten Sie den QGIS Browser indem Sie das Startmen oder die Desktop-Verknpfung verwenden.

Sie knnen den QGIS Browser ber dem Anwendungen Ordner erreichen.

In figure_browser_standalone_metadata knnen Sie die erweiterte Funktionalitt des eigenstndigen QGIS


Browsers sehen. Der Param Reiter stellt die Details Ihrer verbindungsbasierten Datenstze dar, so PostGIS und
rumliche MSSQL. Der Metadata Reiter enthlt allgemeine Informationen ber die Datei (siehe Men Metadaten). Mit dem Preview Reiter knnen Sie einen Blick auf Ihre Dateien machen ohne Sie in Ihr QGIS Projekt zu
importieren. Es ist sogar mglich eine Vorschau von den Attributen Ihrer Dateien im Reiter Attributes zu machen.
.

64

Kapitel 11. QGIS Browser

KAPITEL 12

Arbeiten mit Vektordaten

12.1 Untersttzte Datenformate


QGIS verwendet die OGR-bibliothek um Vektordatenformate zu lesen und zu schreiben, einschlielich ESRI
Shapedateien, MapInfo und MicroStation Dateiformate, AutoCAD DXF, PostGIS, SpatiaLite, Oracle Spatial und
MSSQL Spatial Datenbanken und viele mehr. GRASS Vektor und PostgreSQL Support wird duch native Datenprovider Plugins bereitgestellt. Die Vektordaten knnen auch im Lesemodus aus zip- und gzip-Archiven ins QGIS
geladen werden. Zum Zeitpunkt der Erstellung dieses Dokumentes werden 69 Vektorformate von der OGRBibliothek untersttzt (siehe OGR-SOFTWARE-SUITE in Literatur und Internetreferenzen). Die vollstndige
Liste ist auf http://www.gdal.org/ogr/ogr_formats.html zu finden.
Bemerkung: Einige der aufgelisteten Formate knnen auf ihrem Rechner aus unterschiedlichen Grnden nicht
untersttzt werden. Einige brauchen z.B. kommerzielle Bibliotheken oder die GDAL Installation auf Ihrem Rechner wurde ohne die Untersttzung fr das entsprechende Format erstellt. Nur Formate, die getestet wurden, knnen ausgewhlt werden, wenn Sie eine Vektordatei in QGIS laden. Alle anderen werden angezeigt, wenn Sie *.*
auswhlen.
Das Arbeiten mit GRASS GIS Vektorlayern wird in Kapitel GRASS GIS Integration beschrieben.
In diesem Abschnitt wird beispielhaft beschrieben, wie man mit ESRI Shapedateien, PostGIS- und SpatiaLiteLayern, OpenStreetMap Vektordateien und Comma Separated data (CSV) arbeitet. Viele Funktionen in QGIS
sind unabhngig vom verwendeten Datenformat und verhalten sich daher identisch. Dies ist gewollt und bezieht
sich u.a. auf Abfrage, Selektion, Beschriftung und Attributfunktionen.

12.1.1 ESRI Shapes


Die ESRI Shapedatei ist das Standard Vektorformat in QGIS und wird durch die OGR Simple Feature Library
(http://www.gdal.org/ogr/ ) bereitgestellt.
Ein Shape besteht derzeit aus mehreren Dateien. Die folgenden drei sind erforderlich:
1. shp Datei (enthlt die Geometrien)
2. .dbf Datei (enthlt die Attribute im dBase-Format)
3. .shx Indexdatei
Darber hinaus kann eine Datei mit .prj Endung existieren. Diese enthlt die Projektionsinformationen des Shapes.
Whrend es sehr ntzlich ist eine Projektionsdatei zu verwenden ist dies nicht zwingend erforderlich. Ein ShapeDatensatz kann zustzliche Dateien enthalten. Details dazu finden sich in der technischen Spezifikation von ESRI
unter http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf.

65

QGIS User Guide, Release 2.6

Shape Layer laden


Vektorlayer hinzufgen
Knopf in
Um eine Shapedatei zu laden starten Sie QGIS und klicken Sie auf den
der Werkzeugleiste oder drcken einfach Strg+Umschalt+V. Dieses ffnet ein neues Fenster (siehe figure_vector_1).

Abbildung 12.1: Vektorlayer hinzufgen Dialog


Whlen Sie aus den mglichen Quelltypen
Datei und klicken Sie auf den Knopf [Durchsuchen]. Dadurch
erscheint ein weiterer Dialog zum ffnen (siehe figure_vector_2) mit dem Sie im Dateisystem navigieren knnen und Sie ein Shape oder eine andere untersttzte Datenquelle laden knnen. Die Auswahlbox Filter
ermglicht es Ihnen einige OGR-unterstzte Dateiformate vorzuwhlen.
Auerdem kann auch der Kodierungstyp fr die Shapedatei eingestellt werden, falls dies notwendig ist.

Abbildung 12.2: ffnen eines OGR-Vektorlayers Dialog


Durch Auswahl eines Shapes und Anklicken des Knopfes [ffnen] wird die Datei in QGIS geladen. In Abbildung
Figure_vector_3 sehen Sie das Ergebnis, nachdem die Beispieldatei alaska.shp ins QGIS geladen wurde.

66

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Abbildung 12.3: QGIS mit geladenem Shapefile aus dem Alaskabeispieldatensatz


Tipp: Farben von Vektorlayern
Wenn Sie einen neuen Vektorlayer in QGIS laden, werden Farben zufllig zugewiesen. Wenn Sie mehrere neue
Vektorlayer laden, werden jeweils unterschiedliche Farben zugewiesen.
Nach dem Laden knnen Sie mit den Navigationstools aus der Werkzeugleiste beliebig zoomen. Um den Stil eines
Layers zu verndern ffnen Sie den Layereigenschaften Dialog in dem Sie auf den Layernamen doppelklicken
oder indem Sie einen Rechtsklick auf den Namen in der Legende machen und Eigenschaften im Popupmenu
whlen. Vergleichen Sie Abschnitt vector_style_tab fr weitere Informationen zum Editieren der Eigenschaften
von Vektorlayern.
Tipp: Layer und Projekte von externen Datentrgern laden unter OS X
Unter OS X werden externe Datentrger unter Datei ffne Projekt nicht gemeinsam mit den internen Festplatten angezeigt. Dies soll zuknftig behoben werden. Solange knnen Sie /Volumes in das Eingabefenster
Dateiname eintragen und Return drcken. Danach knnen Sie auch zu den externen Datentrgern bzw. Rechnern in einem Netzwerk browsen.

Die Darstellungsgeschwindigkeit von Shapdedateien verbessern


Um die Darstellungsgeschwindigkeit zu optimieren, kann ein rumlicher Index erstellt werden. Ein rumlicher
Index erhht die Geschwindigkeit beim Zoomen und Verschieben. Rumliche Indizes haben in QGIS die Endung
.qix.
Benutzen Sie folgende Schritte zum Erstellen eines rumlichen Index:
Um eine Shapedatei zu laden klicken Sie auf den
drcken einfach Strg+Umschalt+V.
12.1. Untersttzte Datenformate

Vektorlayer hinzufgen

Knopf in der Werkzeugleiste oder

67

QGIS User Guide, Release 2.6

ffnen Sie den Eigenschaften-Dialog des Vektorlayers, indem Sie auf den Namen des Layers in der Legende
doppelklicken oder mit der rechten Maustaste Eigenschaften auswhlen.
Im Men Allgemein klicken Sie auf den [Rumlichen Index erzeugen] Knopf.
Problem beim Laden eines Shapes mit .prj Datei
Wenn Sie eine Shapedatei mit .prj-Datei laden und QGIS ist nicht in der Lage, die Projektionsinformationen
korrekt auszulesen, ist es notwendig das Koordinatenbezugsystem (KBS) manuell im Allgemein Men des Layereigenschaften Dialog anhand des [Festlegen ...] Knopfs anzugeben. Hintergrund ist, dass .prj Dateien oftmals
nicht die vollstndigen Projektionsparameter enthalten, so wie QGIS sie bentigt und auch im KBS Dialog anzeigt.
Aus diesem Grund, wenn Sie ein neues Shapefile mit QGIS erstellen, werden derzeit zwei unterschiedliche Projektionsdateien angelegt. Eine .prj Datei, mit den unvollstndigen Projektionsparametern, wie sie z.B. von ESRI
Software gelesen und erstellt wird, und eine .qpj Datei, in der die vollstndigen Projektionsparameter anthalten
sind. Wenn Sie dann ein Shape in QGIS laden, und QGIS findet eine .qpj Datei, dann wird diese anstelle der
.prj Datei benutzt.

12.1.2 MapInfo Layer laden


Vektorlayer hinzufgen
Um eine MapInfo Datei zu laden, klicken Sie auf das Icon
in der Werkzeugleiste oder
drcken Sie die Taste Strg+Umschalt+V. Definieren Sie unter Filter: Mapinfo File [OGR] (*.mif *.tab *.MIF
*.TAB) und whlen die gewnschte Datei aus.

12.1.3 ArcInfo Binary Coverage laden


Vektorlayer hinzufgen
Um ein ArcInfo Coverage zu laden, klicken Sie auf das Icon
in der Werkzeugleiste oder
drcken Sie die Taste Strg+Shift+V. Whlen Sie aus den mglichen Quelltypen
Verzeichnis, whlen Sie

Arc/Info Binr-Coverage

. Whlen Sie nun den Ordner mit den ArcInfo Binary-Coverage-Dateien aus.

Auf die gleiche Art und Weise knnen auch andere Verzeichnis-basierte Vektorlayer geladen werden, wie etwa
das U.K. National Transfer Format oder das raw TIGER Format des U.S. Census Bureau.

12.1.4 Delimited Text Dateien


Tabellendaten sind ein sehr beliebtes und weit verbreitetes Format wegen seiner Einfachheit und Lesbarkeit die Daten knnen sogar in einem Texteditor eingesehen und bearbeitet werden. Eine Delimited Text Datei ist
eine Attributtabelle bei der jede Spalte durch ein definiertes Zeichen und jede Zeile durch einen Zeilenumbruch
getrennt wird. Die erste Zeile enthlt normalerweise die Spaltennamen. Ein gngiger Typ von Delimited Text
Datei ist eine CSV-Datei (Comma Separated Values), bei der jede Spalte durch ein Komma getrennt wird.
Solche Datenstze knnen auch Positionsinformationen in zwei Formaten enthalten:
Als Punktkoordinaten in getrennten Spalten
Als WKT-Daten die die Geometrien darstellen
QGIS macht es mglich eine Delimited Text Datei als Layer oder einfache Tabelle zu laden. berprfen Sie aber
erst dass die Datei die folgenden Anforderungen erfllt:
1. Die Datei muss eine begrenzte Kopfspalte mit Feldnamen besitzen. Dieses muss die erste Zeile in der
Textdatei sein.
2. Die Kopfspalte muss Feld(er) mit Geometriedefinitionen enthalten. Diese Feld(er) knnen jeden beliebigen
Namen haben.
3. Die X und Y Koordinaten (wenn die Geometrien anhand von Koordinaten definiert sind) mssen als Nummern angegeben werden. Das Koordinatensystem ist nicht wichtig.

68

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Als Beispiel fr eine Textdatei importieren wir die Datei elevp.csv aus dem QGIS Beispieldatensatz (siehe
Kapitel Beispieldaten):
X;Y;ELEV
-300120;7689960;13
-654360;7562040;52
1640;7512840;3
[...]

Einige weitere Anmerkungen zu Textdateien:


1. Die Beispieldatei verwendet ; (Semikolon) als Trennzeichen. Es knnen auch andere Zeichen zum Trennen
der Spalten verwendet werden.
2. Die erste Zeile ist die Kopfzeile. Sie enthlt die Spaltennamen X, Y und ELEV.
3. Anfhrungszeichen (") drfen nicht als Trennzeichen benutzt werden.
4. Die X-Koordinaten sind in der Spalte X enthalten.
5. Die Y-Koordinaten sind in der Spalte Y enthalten.
Eine Delimited Text Datei laden
Textdatei als Layer importieren
Klicken Sie danach auf das Icon
in der Layer koordinieren Werkzeugleiste, um den
Dialog Textdatei als Layer importieren zu ffnen, wie in figure_delimited_text_1 zu sehen.

Abbildung 12.4: Textdatei als Layer importieren Dialog


Als erstes whlen Sie eine Datei (z.B., qgis_sample_data/csv/elevp.csv) fr den Import aus, indem
Sie auf den [Durchsuchen] Knopf drcken. Sobald eine Datei ausgewhlt wurde, versucht QGIS die Datei zu
durchsuchen und auf Basis des zuletzt verwendeten Trennzeichens zu strukturieren. Damit QGIS die Datei richtig
durchsucht ist es wichtig das richtige Trennzeichen auszuwhlen. Sie knnen ein Trennzeichen indem Sie
Benutzerdefiniert aktivieren angeben oder
Regulre Ausdrcke aktivieren und Text in das Ausdruck Feld eingeben.
Um z.B. einen Tabulator zu verwenden, geben Sie \t ein (dies ist ein regulrer Ausdruck fr das Tab-Zeichen).
Ist die Datei erst einmal durchsucht knnen Sie die Geometriedefinition auf
Punktkoordinaten stellen und die
X und Y Felder aus der Drop-Down-Liste auswhlen. Sind die Koordinaten als Grad/Minuten/Sekunden definiert
aktivieren Sie das Kontrollkstchen
12.1. Untersttzte Datenformate

GMS-Koordinaten
69

QGIS User Guide, Release 2.6

Als letztes geben Sie einen Layernamen ein (z.B., elevp), wie in figure_delimited_text_1 gezeigt. Um den Layer
der Karte hinzuzufgen klicken Sie [OK]. Die Delimited Text Datei verhlt sich jetzt wie jeder andere Kartenlayer
in QGIS.
Es gibt auch eine Hilfeoption mit der Sie vorangehende und nachfolgende Leerzeichen von Feldern abschneiden
knnen -

Felder abschneiden. Es ist ebenfalls mglich

Leere Felder berspringen anzuwenden. Falls ntig

knnen Sie festlegen dass ein Komma der Dezimalseparator sein soll indem Sie
aktivieren.

Dezimalseparator ist Komma

Wenn rumliche Informationen durch WKT reprsentiert sind aktivieren Sie


Well Known Text (WKT) und
whlen Sie das Feld mit den WKT-Definitionen fr Punkt-, Linien- oder Polygonobjekte aus. Wenn die Datei
Keine Geometrie (nur Attributtabelle) und sie wird als ordinale
nicht-rumliche Daten enthlt, aktivieren Sie
Tabelle geladen.
Zustzlich knnen Sie aktivieren:

Rumlichen index benutzen um die Performanz der Darstellung und rumlichen Selektion der Objekte
zu verbessern.
Untermengenindex benutzen
Datei berwachen um nderungen der Datei durch andere Anwendungen zu berwachen whrend
QGIS luft.

12.1.5 OpenStreet Daten


In den letzten Jahren hat das OpenStreetMap-Projekt an Popularitt gewonnen, weil in vielen Lndern keine freien
Geodaten, wie etwa digitale Straenkarten zur Verfgung stehen. Ziel des OSM-Projekts ist es, eine frei editierbare
Karte der Welt auf Basis von GPS-Daten, Luftaufnahmen oder einfach nur Ortskenntnis zu erschaffen. Um diese
Idee zu untersttzen, wurde ein QGIS Plugin geschrieben, das die Arbeit mit OSM-Daten ermglicht.
OpenStreetMap Vektordateien laden
QGIS integriert OpenStreetMap-Import als Kernfunktionalitt.
Um sich mit dem OSM Server zu verbinden und Daten herunterzuladen ffnen Sie das Men Vektor
OpenStreetMap Daten herunterladen. Sie knnen diesen Schritt berspringen wenn Sie bereits eine
.osm XML Datei ber JOSM, Overpass API oder durch eine andere Quelle erhalten haben.
Das Men Vektor OpenStreetMap Topologie aus XML importieren konvertiert Ihre .osm Datei in
eine SpatiaLite Datenbank und erstellt eine entsprechende Datenbankverbindung.
Mit dem Men Vektor OpenStreetMap Topologie nach SpatiaLite exportieren ermglicht es Ihnen die
Datenbankverbindung zu ffnen, den Datentyp Ihrer Wahl (Punkte, Linien oder Flchen) auszuwhlen und
Tags zum Importieren auszuwhlen. Dies erstellt einen SpatiaLite-Geometrielayer den Sie Ihrem Projekt
hinzufgen knnen indem Sie auf den

SpatiaLite-Layer hinzufgen ...

Knopf in der Werkzeugleiste klicken oder

die
SpatiaLite-Layer hinzufgen ... Option aus dem Men Layer auswhlen (siehe Abschnitt SpatiaLite
Layer laden).

12.1.6 PostGIS Layer laden


PostGIS-Ebenen sind in einer PostgreSQL Datenbank gespeichert. Der Vorteil von PostGIS liegt in der
Fhigkeitkeit, rumliche Indizes, Filterungen und Abfragen bereitszustellen. Vektorfunktionen wie Selektieren
und Abfragen funktionieren besser als bei Layern, die durch die OGR-Bibliothek geladen wurden.

70

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Erstellen einer PostGIS Anbindung


Das erste mal wenn Sie eine PostGIS-Datenquelle verwenden mssen Sie eine Verbindung zur PostgreSQLPostGIS-Layer hinzufgen ...
Datenbank die die Daten enthlt erstellen. Beginnen Sie mit dem Klicken auf
aus dem
Layer Men oder geben Sie Strg+Umschalt+D ein. Sie knnen genauso den Dialog Vektorlayer hinzufgen
ffnen und
Datenbank auswhlen. Um den Verbindungsmanager zu erreichen klicken Sie auf den [Neu] Knopf
um den Eine neue OGR-Datenbankverbindung Dialog aufzurufen. Die fr eine Verbindung erforderlichen Parameter sind:

Name: Ein Name fr die Verbindung. Kann derselbe wie fr die Datenbank sein
Dienst: Dienstparameter der alternativ zu Hostname/port verwendet werden kann (und eventuell Datenbank). Dies kann in pg_service.conf definiert werden.
Host: Name des Datenbank-Hosts. Dies muss einauflsbarer Name fr den HOST sein, genau wie beim
Benutzen von telnet oder ping. Wenn die Datenbank auf demselben Computer ist wie QGIS, tragen Sie hier
einfach localhost ein.
Port: Port Nummer der Datenbank auf dem Server. Standard ist 5432.
Datenbank: Name der Datenbank.
SSL-Modus: Wie die SSL-Verbindung mit dem Server ausgehandelt wird. Beachten Sie dass die PostGISLayerdarstellung erheblich verschnellert werden kann wenn man SSL im Verbindungseditor deaktiviert. Die
folgenden Optionen sind mglich:
Abschalten: Nur versuchen eine unverschlsselte SSL-Verbindung herzustellen.
Erlauben: Eine nicht-SSL-Verbindung versuchen. Wenn dies misslingt, eine SSL-Verbindung versuchen.
Bevorzugen: Eine SSL-Verbindung versuchen. Wenn dies misslingt eine nicht-SSL-Verbindung versuchen.
Verlangen: Versuche nur eine SSL-Verbindung.
Name: Benutzername, um sich bei der Datenbank anzumelden.
Passwort: Passwort das zusammen mit Benutzername verwendet wird um sich bei der Datenbank
anzumelden.
Bei Bedarf knnen Sie die folgenden Kontrollkstchen aktivieren:

Benutzernamen speichern

Passwort speichern

Nur in geometry_columns nachschauen

Geometrietyp von Spalten ohne Einschrnkung nicht feststellen (GEOMETRY)

Nur im public Schema nachschauen

Auch geometrielose Tabellen anzeigen

Gechtzte Tabellenmetadaten nutzen

Wenn alle Parameter eingetragen sind, kann die Verbindung getestet werden, indem Sie auf den Knopf
[Verbindung testen] drcken.

12.1. Untersttzte Datenformate

71

QGIS User Guide, Release 2.6

Laden eines Layers aus der PostGIS Datenbank


Sobald Sie eine oder mehrere Verbindungen definiert haben knnen Sie Layer aus der PostgreSQL-Datenbank
laden. Natrlich erfordert dieses dass man Daten in PostgreSQL vorhlt. Lesen Sie in Kapitel Layer nach PostgreSQL/PostGIS importieren ber eine Diskussion die das Importieren von Daten in die Datenbank beschreibt.
Um eine Ebene aus PostGIS zu laden, fhren Sie folgende Schritte durch:
Wenn der PostGIS-Layer hinzufgen Dialog nicht schon geffnet ist ffnet das Klicken von
Layer hinzufgen ... oder das Eingeben von Strg+Umschalt+D den Dialog.

PostGIS-

Whlen Sie eine Verbindung aus dem Drop-Down Men und klicken auf [Verbinden].
Whlen Sie

Auch geometrielose Tabelle anzeigen an oder ab.

Nutzen Sie gegebenenfalls die


Suchoptionen um zu definieren welche Objekte aus dem Layer geladen
werden sollen oder benutzen Sie den [Erstelle Abfrage] Knopf um den Abfrageerstellung Dialog zu starten.
Suchen Sie einen Layer den Sie laden mchten.
Whlen Sie es aus indem Sie darauf klicken. Sie knnen mehrere Layer gleichzeitig indem Sie die
Umschalt-Taste gedrckt halten auswhlen. Siehe Abschnitt Abfrageeditor fr Informationen wie man
die PostgreSQL-Abfrageerstellung fr das weitere Definieren des Layers benutzt.
Klicken Sie auf den Knopf [Hinzufgen] um den Layer zu laden.
Tipp: PostGIS-Layer
Normalwerweise ist ein PostGIS-Layer ber einen Eintrag in der geometry_columns Tabelle definiert. Seit Version
0.9.0 ist QGIS in der Lage, Layer zu laden, die keinen Eintrag in der geometry_columns Tabelle besitzen. Dies
bezieht sich auf Tabellen und Views. Um einen spatial view zu definieren, brauchen Sie ein kraftvolles System,
um die Daten zu visualisieren. Beziehen Sie sich auf das PostgreSQL Handbuch, um weitere Informationen ber
die Erstellung von Views zu erhalten.

Einige Details zu PostGIS-Layern


Dieser Abschnitt enthlt einige Details, wie QGIS auf PostgreSQL zugreift. Meistens soll QGIS eine Liste mit
ein paar Datenbanktabellen bereitstellen, die bei Bedarf geladen werden knnen. Wenn Sie Probleme mit dem
Laden von Layern aus PostgreSQL haben, knnen die nun folgenden Informationen vielleicht eine Hilfe sein,
die Fehlermeldungen von QGIS besser zu verstehen und eine Lsung zu finden, die PostgreSQL Tabellen- oder
Viewdefinition anzupassen, und somit den Layer laden zu knnen.
Unter QGIS mssen PostgreSQL-Layer eine Spalte beinhalten die als eindeutigen Schlssel fr den Layer benutzt
werden kann. Fr Tabellen heit dies normalerweise dass die Tabelle einen Primrschlssel oder eine Spalte
mit einer eindeutigen Beschrnkung braucht. In QGIS muss diese Spalte vom Typ int4 (ein Integer mit 4 Byte
Gre) sein. Alternativ kann die ctid-Spalte als Primrschlssel verwendet werden. Wenn eine Tabelle keines
dieser Elemente aufweist wird die oid-Spalte anstelle dessen verwendet. Die Performanz wird verbessert wenn die
Spalte indexiert ist (beachten Sie das Primrschlssel in PostgreSQL automatisch indexiert werden).
Wenn der PostgreSQL-Layer ein View ist bestehende dieselben Anforderungen, nur dass Views keine
Primrschlssel oder Spalten mit eindeutigen Einschrnkungen besitzen. Sie mssen ein Primrschlsselfeld (dies
muss vom Typ Integer sein) im QGIS-Dialog definieren bevor Sie den View laden knnen. Wenn im View keine
geeignete Spalte existiert ldt QGIS den Layer nicht. Tritt dies auf ist die Lsung den View zu verndern, so dass
dieser dann eine geeignete Spalte beinhaltet (eine Spalte vom Typ Integer und entweder mit Primrschlssel oder
eindeutiger Beschrnkung, vorzugsweise indexiert).
QGIS bietet ein Kontrollkstchen Abfrage nach Id das standardmig aktiviert ist. Diese Option whlt die ids
ohne die Attribute aus was in den meisten Fllen schneller ist. Es kann sinnvoll sein diese Option zurckzusetzen
wenn Sie umfangreiche Views verwenden.

72

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

12.1.7 Layer nach PostgreSQL/PostGIS importieren


Daten knnen anhand von mehreren Werkzeugen in PostgreSQL/PostGIS importiert werden, einschlielich des
SPIT Plugins und den Kommandozeilenwerkzeugen shp2pgsql und ogr2ogr.
DB-Manager
DB Manager
heisst. Es kann dafr verwendet werden um Shapdedateien und
QGIS bietet ein Kernplugin das
andere Datenformate zu laden und beinhaltet Untersttzung fr Schemas. Siehe Kapitel DB Manager Plugin fr
weitere Informationen.

shp2pgsql
PostGIS beinhaltet ein Programm mit dem Namen shp2pgsql das dazu benutzt werden kann Shpadateien in eine
PostGIS-fhige Datenbank zu importieren. Um z.B. eine Shapedatei lakes.shp in eine PostgreSQL-Datenbank
mit dem Namen gis_data zu importieren verwenden Sie den folgenden Befehl:
shp2pgsql -s 2964 lakes.shp lakes_new | psql gis_data

Dieser Befehl erzeugt eine neue Tabelle mit dem Namen lakes_new in der PostgreSQL/PostGIS Datenbank
gis_data. Die neue Ebene wird die ID 2964 als spatial reference identifier (SRID) tragen. Weitere Informationen zu rumlichen Referenzsystemen finden Sie in Abschnitt Arbeiten mit Projektionen.
Tipp: Layer aus PostGIS exportieren
Wie das Importprogramm shp2pgsql gibt es ebenfalls ein Werkzeug um PostGIS Datenstze als Shapedateien zu
exportieren: pgsql2shp. Dies ist innerhalb der PostGIS-Installation enthalten.

ogr2ogr
Neben shp2pgsql und dem DB Manager gibt es noch ein anderes Programm um Geodaten PostGIS zuzufhren:
ogr2ogr. Dies ist Teil Ihrer GDAL-Installation.
Um ein Shape nach PostGIS zu importieren, kann folgendes Kommando verwendet werden:
ogr2ogr -f "PostgreSQL" PG:"dbname=postgis host=myhost.de user=postgres
password=topsecret" alaska.shp

Dies wird die Shapedatei alaska.shp in die PostGIS-Datenbank postgis mit dem Benutzer postgres*und dem
Passwort *topsecret auf dem Host-Server myhost.de importieren.
Beachten Sie dass OGR mit PostgreSQL gebaut werden muss um PostGIS-Untersttzung zu erhalten. Sie knnen
dies berprfen indem Sie eingeben (in )
ogrinfo --formats | grep -i post

Wenn Sie es vorziehen dem PostgreSQL COPY-Befehl anstelle der Standard INSERT INTO Methode zu arbeiten
knnen Sie die folgende Umgebungsvariable (zumindest unter

und

zugnglich) benutzen

export PG_USE_COPY=YES

ogr2ogr erstellt keine rumlichen Indizes wie shp2pgsl das tut. Sie mssen diese hinterher als zustzlichen Schritt
manuell unter Zuhilfenahme des normalen SQL-Befehls CREATE INDEX erstellen (wie im nchsten Abschnitt
Geschwindigkeit optimieren beschrieben).

12.1. Untersttzte Datenformate

73

QGIS User Guide, Release 2.6

Geschwindigkeit optimieren
Der Datentransfer von einer PostgreSQL/PostGIS Datenbank kann langsam sein, besonders ber ein Netzwerk.
Die Geschwindigkeit kann optimiert werden, indem fr alle Ebenen in PostgreSQL ein PostGIS rumlicher Index
erstellt wird. PostGIS untersttzt das Erstellen eines GiST (Generalized Search Tree) Index, um den Zugriff auf die
Ebenen zu beschleunigen (die GiST Index Informationen wurden aus der PostGIS Dokumentation bernommen
unter: http://postgis.refractions.net).
Dies ist die Syntax fr das Erstellen eines GiST-Index:
CREATE INDEX [indexname] ON [tablename]
USING GIST ( [geometryfield] GIST_GEOMETRY_OPS );

Bedenken Sie, dass das Erstellen eines Index bei groen Datenmengen zeitaufwendig ist. Nachdem der Index
erstellt ist, sollte ein VACUUM ANALYZE durchgefhrt werden (vgl. PostGIS Dokumentation Literatur und
Internetreferenzen).
Im Folgenden sehen Sie ein Beispiel, um einen GiST-Index zu erstellen:
gsherman@madison:~/current$ psql gis_data
Welcome to psql 8.3.0, the PostgreSQL interactive terminal.
Type:

\copyright for distribution terms


\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit

gis_data=# CREATE INDEX sidx_alaska_lakes ON alaska_lakes


gis_data-# USING GIST (the_geom GIST_GEOMETRY_OPS);
CREATE INDEX
gis_data=# VACUUM ANALYZE alaska_lakes;
VACUUM
gis_data=# \q
gsherman@madison:~/current$

12.1.8 Vektorlayer, die den Lngengrad 180 berschreiten


Viele GIS Applikationen stellen einen Vektorlayer, der ber den Lngengrad 180 hinausgeht nicht zusammenhngend dar (http://postgis.refractions.net/documentation/manual-2.0/ST_Shift_Longitude.html). So wird in QGIS
der Layer geteilt und man sieht im Kartenfenster zwei, weit voneinander entfernte Teile, die eigentlich zusammengehren. In Abbildung Figure_vector_4 sollte z.B. der kleine Punkt in der linken Ecke des Kartenfensters
(Chatham Inseln) rechts neben Neuseeland angezeigt werden.

Abbildung 12.5: Karte in lat/lon die den 180 Lngengrad schneidet


Eine Mglichkeit, dies zu umgehen, bietet PostGIS und die Funktion ST_Umschalt_Longitude
(http://postgis.refractions.net/documentation/manual-1.4/ST_Umschalt_Longitude.html). Die Funktion liest
alle Objekte der Karte ein und wenn der Lngengrad <0 ist, werden 360 hinzugezhlt. Das Ergebnis ist eine
0-360 Karte, die als Mittelpunkt den Lngengrad 180 verwendet.

74

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Abbildung 12.6: Das berqueren von 180 Lnge unter Verwendung der ST_Shift_Longitude Funktion
Beispielanwendung
Importieren Sie Daten in PostGIS (Layer nach PostgreSQL/PostGIS importieren) in dem Sie z.B. das DB
Manager Plugin benutzen.
ffnen Sie das PostGIS Kommandozeilenfenster und geben Sie folgendes Kommando ein (in diesem
Beispiel steht der Name TABELLE fr den tatschlichen Namen der PostGIS Tabelle): gis_data=#
update TABLE set the_geom=ST_Shift_Longitude(the_geom);
Wenn alles gut gelaufen ist sollten Sie jetzt eine Besttigung ber die Anzahl der Objekte die geupdated worden sind erhalten. Dann sollten Siedie Karte laden und den Unterschied sehen knnen (Figure_vector_5).

12.1.9 SpatiaLite Layer laden


Wenn Sie das erste Mal einen Layer aus einer SpatiaLite Datenbank laden mchten, klicken Sie auf das Icon
SpatiaLite-Layer hinzufgen

SpatiaLite Layer hinzufgen ... im Men Layer


in der Werkzeugleiste oder indem Sie
auswhlen oder indem Sie die Taste Strg+Shift+L drcken. Dies ffnet einen Dialog, ber den Sie entweder
eine Verbindung zu einer bereits in QGIS definierten SpatiaLite Datenbank auswhlen oder eine neue Verbindung
erstellen knnen. Um eine neue Verbindung zu erstellen, klicken Sie auf den Knopf [Neu] und verwenden dann
den Dateibrowser, um eine entsprechende SpatiaLite Datenbank auszuwhlen. Dabei handelt es sich um eine Datei
mit der Endung .sqlite.
Wenn Sie einen Vektorlayer im SpatiaLite-Format abspeichern wollen, whlen Sie den Layer in der Legende aus,
benutzen Sie das Kontextmen der rechten Maustaste und klicken Sie auf Speichern als .... Geben Sie den Namen
der Ausgabe an, whlen Sie sqlite als Format aus und das KBS. Danach fgen Sie noch SPATIALITE=YES
in das Fenster Datenquelle. Damit sagen Sie OGR, dass eine SpatiaLite-Datenbank erstellt werden soll. Siehe
http://www.gdal.org/ogr/drv_sqlite.html.
QGIS untersttzt auch das Bearbeiten von Views in SpatiaLite-Datenbanken.
Einen neuen SpatiaLite Layer erzeugen
Wenn Sie einen neuen SpatiaLite Layer erzeugen wollen, finden Sie in Kapitel Einen neuen SpatiaLite Layer
erstellen eine Anleitung.
Tipp: SpatiaLite Datenmanagement Plugin
Fr das Managen von SpatiaLite-Daten knnen Sie mehrere Python Plugins verwenden: QSpatiaLite oder DB
Manager (Kernplugin, wird empfohlen). Sie knnen mit dem Plugin Installer gedownloaded und installiert werden.

12.1. Untersttzte Datenformate

75

QGIS User Guide, Release 2.6

12.1.10 Rumliche MSSQL-Layer


QGIS verfgt auch ber native MS SQL 2008 Untersttzung. Wenn Sie das erste mal Rumliche MSSQL
Daten laden fangen Sie damit an indem Sie auf den

Add MSSQL Spatial Layer

Knopf in der Werkzeugleiste klicken

Rumlichen MSSQL-Layer hinzufgen... Option aus dem Layer Men whlen, oder indem
oder indem Sie die
Sie Strg+Umschalt+M eingeben.

12.1.11 Oracle Spatial Layer


Die rumlichen Objekte in Oracle Spatial helfen Nutzern Geographische und Location Daten als native Typen
innerhalb einer Oracledatenbank zu verwalten. QGIS bietet jetzt Untersttzung fr solche Ebenen.
Erstellen einer PostGIS Anbindung
Wenn Sie das erste mal eine Oracle Spatial Datenquelle verwenden mssen Sie eine Verbindung zu der
Datenbank die die Daten enthlt erstellen. Beginnen Sie indem Sie auf den

Oracle-GeoRaster-Layer hinzufgen

Knopf

in der Werkzeugleiste drcken, die


Oracle-GeoRaster-Layer hinzufgen Option aus dem Layer Men whlen
oder indem Sie Strg+Umschalt+O eingeben. Um den Verbindungsmanager zu erreichen klicken Sie auf den
[Neu] Knopf um den Oracle-Verbindung herstellen Dialog aufzurufen. Die fr die Verbindung erforderlichen
Parameter sind:
Name: Ein Name fr diese Verbindung. Er kann der gleiche wie Datenbankinstanz sein
Datenbank: SID oder SERVICE_NAME der Oracleinstanz.
Host: Name des Datenbank-Hosts. Dies muss einauflsbarer Name fr den HOST sein, genau wie beim
Benutzen von telnet oder ping. Wenn die Datenbank auf demselben Computer ist wie QGIS, tragen Sie hier
einfach localhost ein.
Port: Port Nummer der Oracle Spatial Datenbank auf dem Server. Standard ist 1521.
Benutzername: Benutzername der verwendet wird um sich in die Datenbank einzuloggen.
Passwort: Passwort das zusammen mit Benutzername verwendet wird um sich bei der Datenbank
anzumelden.
Wahlweise knnen Sie die folgenden Kontrollkstchen aktivieren:

76

Benutzernamen speichern zeigt an ob der Datenbankbenutzername in der Verbindungskonfiguration


gespeichert werden soll.

Passwort speichern zeigt an ob das Datenbankpasswort in den Verbindungseinstellungen gespeichert


werden soll.

Nur in Metadatentabelle geometry_columns nachsehen. Schrnkt die dargestellten Tabellen auf jene die
sich im all_sdo_geom_metadata View befinden ein. Dies kann die Initialanzeige von rumlichen Tabellen
verschnellern.

Nur nach Tabellen des Benutzers suchen. Beim Suchen nach rumlichen Tabellen die Suche auf Tabellen
die dem Benutzer gehren einschrnken.

Auch geometrielose Tabelle anzeigen zeigt dass Tabellen ohne Geometrie auch standardmig aufgefhrt werden.

Verwende geschtzte Tabellenstatistiken fr die Layermetadaten. Wenn der Layer aufgesetzt wird werden verschiedene Metadaten fr die Oracletabelle bentigt. Dies beinhaltet Informationen wie die Tabellenspaltenanzahl, Geometrietyp und rumliche Ausdehnung der Daten in der Geometriespalte. Wenn die
Tabelle eine groe Anzahl von Spalten enthlt kann das Festlegen dieser Daten zeitaufwndig sein. Indem

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Sie diese Optionen aktivieren werden die folgenden schnellen Tabellenmetadatenoptionen durchgefhrt: die
Spaltenanzahl wird durch all_tables.num_rows festgelegt. Die Tabellenausdehnung wird immer mit
den SDO_TUNE.EXTENTS_OF Funktionen festgelegt, auch wenn ein Layerfilter angewendet wird. Die
Tabellengeometrie wird von den ersten 100 nicht-null Geometriespalten der Tabelle festgelegt.

Nur bestehende Geometrietypen. Fhrt nur die bestehenden Geometrietypen auf fragt nicht nach anderen.

Wenn alle Parameter eingetragen sind, kann die Verbindung getestet werden, indem Sie auf den Knopf
[Verbindung testen] drcken.
Tipp: QGIS Benutzereinstellungen und Sicherheit
Je nach Arbeitsumgebung birgt das Speichern von Passwrtern in Ihren QGIS-Einstellungen Risiken in sich. Ihre
Einstellungen fr QGIS werden basierend auf ihrem Betriebssystem unverschlsselt in der Systemkonfiguration
und den Projektdateien gespeichert! Ihre benutzerdefinierten Einstellungen fr QGIS werden abhngig vom Betriebssystem gespeichert.

Die Einstellungen werden in Ihrem Homeverzeichnis in ~/.qgis2 gespeichert.

Die Einstellungen werden in der Registry gespeichert.

Einen Oracle Spatial Layer laden


Haben Sie erst eine oder mehrere Verbindungen definiert knnen Sie Layer von der Oracle-Datenbank laden.
Natrlich erfordert dies dass Sie schon Daten in Oracle vorhalten.
Um einen Layer von Oracle Spatial zu laden, fhren Sie die folgenden Schritte durch:
Wenn der Oracle-Spatial-GeoRaster whlen Dialog noch nicht offen ist, klicken Sie auf den
Oracle-GeoRaster-Layer
Werkzeugknopf.
Whlen Sie eine Verbindung aus dem Drop-Down Men und klicken auf [Verbinden].
Whlen Sie

Auch geometrielose Tabelle anzeigen an oder ab.

Verwenden Sie wahlweise


Suchoptionen um zu definieren welche Objekte aus dem Layer geladen werden sollen oder verwenden Sie den [Abfrage erstellen] Knopf um den Dialog Abfrageerstellung zu starten.
Suchen Sie einen Layer den Sie laden mchten.
Whlen Sie ihn aus indem Sie darauf klicken. Sie knnen mehrere Layer auf einmal whlen indem Sie die
Umschalt Taste beim Klicken gedrckt halten. Siehe Kapitel Abfrageeditor ber Informationen wie man
den Oracle Query Builder benutzt um den Layer weiter zu definieren.
Klicken Sie auf den Knopf [Hinzufgen] um den Layer zu laden.
Tipp: Oracle Spatial Layer
Normalerweise wird ein Oracle Spatial Layer durch einen Eintrag in der USER_SDO_METADATA Tabelle
definiert.
.

12.1. Untersttzte Datenformate

77

QGIS User Guide, Release 2.6

12.2 The Symbol Library


12.2.1 Presentation
The Symbol Library is the place where users can create generic symbols to be used in several QGIS projects. It
allows users to export and import symbols, groups symbols and add, edit and remove symbols. You can open it
with the Settings Style Library or from the Style tab in the vector layers Properties.
Share and import symbols
Users can export and import symbols in two main formats: qml (QGIS format) and SLD (OGC standard). Note
that SLD format is not fully supported by QGIS.
share item

displays a drop down list to let the user import or export symbols.

Groups and smart groups


Groups are categories of Symbols and smart groups are dynamic groups.
To create a group, right-click on an existing group or on the main Groups directory in the left of the library. You
can also select a group and click on the

add item

button.

To add a symbol into a group, you can either right click on a symbol then choose Apply group and then the group
name added before. There is a second way to add several symbols into group: just select a group and click
and choose Group Symbols. All symbols display a checkbox that allow you to add the symbol into the selected
groups. When finished, you can click on the same button, and choose Finish Grouping.
Create Smart Symbols is similar to creating group, but instead select Smart Groups. The dialog box allow user
to choose the expression to select symbols in order to appear in the smart group (contains some tags, member of
a group, have a string in its name, etc.)
Add, edit, remove symbol
With the Style manager from the [Symbol]

menu you can manage your symbols. You can

add item

edit item

remove item
share item
,
and
. Marker symbols, Line symbols, Fill patterns and colour ramps
can be used to create the symbols. The symbols are then assigned to All Symbols, Groups or Smart groups.

For each kind of symbols, you will find always the same dialog structure:
at the top left side a symbol representation
under the symbol representation the symbol tree show the symbol layers
at the right you can setup some parameter (unit,transparency, color, size and rotation)
under these parameteres you find some symbol from the symbol library
The symbol tree allow adding, removing or protect new simple symbol. You can move up or down the symbol
layer.
More detailed settings can be made when clicking on the second level in the Symbol layers dialog. You can define
Symbol layers that are combined afterwards. A symbol can consist of several Symbol layers. Settings will be
shown later in this chapter.
Tipp: Note that once you have set the size in the lower levels of the Symbol layers dialog, the size of the whole
symbol can be changed with the Size menu in the first level again. The size of the lower levels changes accordingly,
while the size ratio is maintained.

78

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

12.2.2 Marker Symbols


Marker symbols have several symbol layer types:
Ellipse marker
Font marker
Simple marker (default)
SVG marker
Vector Field marker
The following settings are possible:
Symbol layer type: You have the option to use Ellipse markers, Font markers, Simple markers, SVG markers
and Vector Field markers.
colors
Size
Outline style
Outline width
Angle
Offset X,Y: You can shift the symbol in the x- or y-direction.
Anchor point
Data defined properties ...

12.2.3 Line Symbols


Line marker symbols have only two symbol layer types:
Marker line
Simple line (default)
The default symbol layer type draws a simple line whereas the other display a marker point regularly on the line.
You can choose different location vertex, interval or central point. Marker line can have offset along the line or
offset line. Finally, rotation allows you to change the orientation of the symbol.
The following settings are possible:
colour
Pen width
Offset
Pen style
Join style
Cap style

Use custom dash pattern

Dash pattern unit


Data defined properties ...

12.2. The Symbol Library

79

QGIS User Guide, Release 2.6

12.2.4 Polygon Symbols


Polygon marker symbols have also several symbol layer types:
Centroid fill
Gradient fill
Line pattern fill
Point pattern fill
SVG fill
Shapeburst fille
Simple fill (default)
Outline: Marker line (same as line marker)
Outline: simple line (same as line marker)
The following settings are possible:
Colors for the border and the fill.
Fill style
Border style
Border width
Offset X,Y
Data defined properties ...
Using the color combo box, you can drag and drop color for one color button to another button, copy-paste color,
pick color from somewhere, choose a color from the palette or from recent or standard color. The combo box
allow you to fill in the feature with transparency. You can also just clic on the button to open the palettte dialog.
Note that you can import color from some external software like GIMP.
Gradient Fill Symbol layer type allows you to select between a

Two color and

Color ramp setting. You

Feature centroid as Referencepoint. All fills Gradient Fill Symbol layer type is also available
can use the
through the Symbol menu of the Categorized and Graduated Renderer and through the Rule properties menu of
the Rule-based renderer. Other possibility is to choose a shapeburst fill which is a buffered gradient fill, where a
gradient is drawn from the boundary of a polygon towards the polygons centre. Configurable parameters include
distance from the boundary to shade, use of color ramps or simple two color gradients, optional blurring of the fill
and offsets.
It is possible to only draw polygon borders inside the polygon. Using Outline: Simple line select
only inside polygon.

Draw line

12.2.5 Color ramp


You can create a custom color ramp choosing New color ramp... from the color ramp drop-down menu. A dialog
will prompt for the ramp type: Gradient, Random, colorBrewer, or cpt-city. The first three have options for number
of steps and/or multiple stops in the color ramp. You can use the
Invert option while classifying the data with
a color ramp. See figure_symbology_3 for an example of custom color ramp and figure_symbology_3a for the
cpt-city dialog.
The cpt-city option opens a new dialog with hundreds of themes included out of the box.
Ausdrcke fr das Beschriften verwenden

80

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Abbildung 12.7: Example of custom gradient color ramp with multiple stops

12.2. The Symbol Library

81

QGIS User Guide, Release 2.6

Abbildung 12.8: cpt-city dialog with hundreds of color ramps

82

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

12.3 Vektorlayereigenschaften
Der Layereigenschaften-Dialog stellt Informationen ber den Layer, Darstellungseinstellungen und Beschriftungsoptionen bereit. Wenn ein Vektorlayer aus einer PostgreSQL/PostGIS Datenbank geladen wurde, knnen ber den
Dialog Layereigenschaften auch SQL-Abfragen mit dem Objektuntermenge-Dialog im Men Allgemein angewendet werden. Um den Layereigenschaften-Dialog zu erreichen doppelklicken Sie einen Layer in der Legende oder
machen Sie einen Rechtsklick auf den Layer und whlen Sie Eigenschaften aus dem Popupmen.

Abbildung 12.9: Vektor Layereigenschaften Dialog

12.3.1 Men Stil


Das Men Stil stellt Ihnen ein umfassendes Werkzeug zum Darstellen und symbolisieren Ihrer Vektordaten zur
Verfgung. Sie knnen Layerdarstellung Werkzeuge, die fr alle Vektordaten gleich sind, genauso wie spezielle
Symbolisierungstools, die fr die verschiedenen Arten von Vektordaten konzipiert wurden, verwenden.
Darstellungen
The renderer is responsible for drawing a feature together with the correct symbol. There are four types of renderers: single symbol, categorized, graduated and rule-based. There is no continuous color renderer, because it is
in fact only a special case of the graduated renderer. The categorized and graduated renderers can be created by
specifying a symbol and a color ramp - they will set the colors for symbols appropriately. For point layers, there
is a point displacement renderer available. For each data type (points, lines and polygons), vector symbol layer
types are available. Depending on the chosen renderer, the Style menu provides different additional sections. On
the bottom right of the symbology dialog, there is a [Symbol] button, which gives access to the Style Manager
(see Presentation). The Style Manager allows you to edit and remove existing symbols and add new ones.
12.3. Vektorlayereigenschaften

83

QGIS User Guide, Release 2.6

After having made any needed changes, the symbol can be added to the list of current style symbols (using
[Symbol]

Save in symbol library), and then it can easily be used in the future. Furthermore, you can use

the [Save Style]


button to save the symbol as a QGIS layer style file (.qml) or SLD file (.sld). SLDs can be
exported from any type of renderer single symbol, categorized, graduated or rule-based but when importing
an SLD, either a single symbol or rule-based renderer is created. That means that categorized or graduated styles
are converted to rule-based. If you want to preserve those renderers, you have to stick to the QML format. On the
other hand, it can be very handy sometimes to have this easy way of converting styles to rule-based.
If you change the renderer type when setting the style of a vector layer the settings you made for the symbol will
be maintained. Be aware that this procedure only works for one change. If you repeat changing the renderer type
the settings for the symbol will get lost.
If the datasource of the layer is a database (PostGIS or Spatialite for example), you can save your layer style inside
a table of the database. Just clic on :guilabel: Save Style comboxbox and choose Save in database item then fill
in the dialog to define a style name, add a description, an ui file and if the style is a default style. When loading a
layer from the database, if a style already exists for this layer, QGIS will load the layer and its style. You can add
several style in the database. Only one will be the default style anyway.

Abbildung 12.10: Save Style in database Dialog

Tipp: Auswahl und ndern von Mehrfachsymbolen


Mit der Symbologie knnen Sie Mehrfachsymbole auswhlen und Rechtsklicken um Farbe, Transparenz, Gre
oder Breite der ausgewhlten Eintrge zu ndern.
Einzelsymbol Darstellung
Der Einzelsymbol Renderer wird verwendet um alle Objekte des Layers mit einem einfachen benutzerdefinierten
Symbol darzustellen. Die Eigenschaften, die im Men Stil angepasst werden knnen, hngen teilweise von dem
Typ des Layers ab, wobei alle Typen die folgende Dialogstruktur befolgen. Im oberen linken Teil des Mens gibt
es einen Preview von den aktuellen Symbolen die dargestellt werden sollen. Im rechten Teil des Mens gibt es
eine Liste von Symbolen die bereits fr den aktuellen Stil definiert wurden, welche durch Auswhlen aus der Liste
benutzt werden knnen. Das aktuelle Symbol kann mit dem Men auf der rechten Seite verndert werden. If you
click on the first level in the Symbol layers dialog on the left side, its possible to define basic parameters like Size,
Transparency, color and Rotation. Here, the layers are joined together.
Kategorisierte Darstellung
Der Kategorisiert Renderer wird verwendet um alle Objekte eines Layers darzustellen indem man ein einfaches
benutzerdefiniertes Symbol, dessen Farbe den Wert des ausgewhlten Attributs des Objekts wiedergibt. Im Stil
Men knnen Sie folgendes auswhlen:
The attribute (using the Column listbox or the

Set column expression function, see Expressions)

Das Symbol (ber die Auswahl Symbol)


The colors (using the color Ramp listbox)

84

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Abbildung 12.11: Linieneigenschaften Einzelsymbol

12.3. Vektorlayereigenschaften

85

QGIS User Guide, Release 2.6

Then click on Classify button to create classes from the distinct value of the attribute column. Each classes can be
disabled unchecking the checkbox at the left of the class name.
You can change symbol, value and/or label of the clic, just double clicking on the item you want to change.
Right-clic shows a contextual menu to Copy/Paste, Change color, Change transparency, Change output unit,
Change symbol width.
Mit dem [Erweitert] Knopf in der rechten unteren Ecke des Dialogs knnen Sie die Felder, die Drehungs- und
Grenskalierungsinformationen enthalten, einstellen. Der Einfachheit halber werden in der Mitte des Mens die
Werte aller aktuell ausgewhlten Attribute zusammen aufgefhrt, inklusive der Symbole die dargestellt werden
sollen.
Das Beispiel in figure_symbology_2 zeigt den Dialog Kategorisierte Darstellung fr den Vektorlayer rivers des
QGIS -Beispieldatensatzes.

Abbildung 12.12: Kategorisierte Symbolisierungsoptionen


Abgestufte Darstellung
Der Abgestuft Renderer wird verwendet alle Objekte eines Layers darzustellen indem ein einfaches benutzerdefiniertes Symbol dessen Farbe die Zuweisung eines Objektattributes zu einer Klasse reflektiert.
Wie beim Kategorisiert Renderer knnen Sie mit dem Abgestuft Renderer die Drehung und Grenskalierung von
angegebenen Spalten definieren.
Genauso knnen Sie -analog zum Kategorisierten Renderer - im Men Stil auswhlen:
The attribute (using the Column listbox or the

Set column expression function, see Expressions chapter)

Das Symbol (ber die Auswahl Symbol)

86

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Abbildung 12.13: Abgestufte Symbolisierungsoptionen

12.3. Vektorlayereigenschaften

87

QGIS User Guide, Release 2.6

The colors (using the color Ramp list)


Zustzlich knnen Sie die Anzahl der Klassen und auch den Modus fr das Klassifizieren von Objekten innerhalb
der Klassen (indem man die Modus-Liste verwendet). Die mglichen Modi sind:
Equal Interval: each class has the same size (e.g. values from 0 to 16 and 4 classes, each class has a size of
4);
Quantile: each class will have the same number of element inside (the idea of a boxplot);
Natural Breaks (Jenks): the variance within each class is minimal while the variance between classes is
maximal;
Standard Deviation: classes are built depending on the standard deviation of the values;
Pretty Breaks: the same of natural breaks but the extremes number of each class are integers.
Das Listenfeld im mittleren Teill des Stil Mens fhrt die Klassen zusammen mit ihren Bereichen, Beschriftungen
und Symbolen die dargestellt werden auf.
Click on Classify button to create classes using the choosen mode. Each classes can be disabled unchecking the
checkbox at the left of the class name.
You can change symbol, value and/or label of the clic, just double clicking on the item you want to change.
Right-clic shows a contextual menu to Copy/Paste, Change color, Change transparency, Change output unit,
Change symbol width.
Das Beispiel figure_symbology_4 zeigt den Abgestufte Darstellung Dialog fr den Vektorlayer rivers des QGISBeispieldatensatzes.
Tipp: Thematische Karten anhand von Ausdrcken erstellen
Kategorisierte und Abgestufte thematische Karten knnen jetzt anhand des Ergebnisses eines Ausdrucks erstellt
werden. Im Eigenschaftendialog fr Vektorlayer wurde die Attributauswahl um eine
Set column expression
Funktion ergnzt. Jetzt brauchen Sie nicht lnger das Klassifikationsattribut in eine neue Spalte in Ihrer Attributtabelle schreiben wenn Sie wollen, dass das Klassifikationsattribut eine Zusammenstellung von mehreren Feldern
wie z.B. eine Formel irgendeiner Art ist.
Regelbasierende Darstellung
Der regelbasierte Renderer wird verwendet um alle Objekte eines Layers anhand eines regelbasierten Symbols
dessen Farbe die Zuordnung eines ausgewhlten Objektattributs zu einer Klasse wiedergibt, darzustellen. Die
Regeln basieren auf SQL-Anweisungen. Mit dem Dialog knnen Sie anhand von Filtern oder Mastben gruppieren und Sie knnen entscheiden ob Sie die Zeichenreihenfolge benutzen wollen oder nur die erste zutreffende
Regel benutzen wollen.
Das Beispiel figure_symbology_5 zeigt den Dialog der regelbasierenden Darstellung fr den Layer rivers des
QGIS Beispieldatensatzes.
To create a rule, activate an existing row by double-clicking on it, or click on + and click on the new rule. In
the Rule properties dialog, you can define a label for the rule. Press the
button to open the expression string
builder. In the Function List, click on Fields and Values to view all attributes of the attribute table to be searched.
To add an attribute to the field calculator Expression field, double click its name in the Fields and Values list.
Generally, you can use the various fields, values and functions to construct the calculation expression, or you can
just type it into the box (see Expressions). You can create a new rule by copying and pasting an existing rule with
the right mouse button. You can also use the ELSE rule that will be run if none of the other rules on that level
match. Since QGIS 2.6 the label for the rules appears in a pseudotree in the map legend. Just double-klick the
rules in the map legend and the Style menu of the layer properties appears showing the rule that is the background
for the symbol in the pseudotree.
Punkt-Verschiebung
Fr Punktlayer gibt es eine Darstellungsart, mit der es mglich ist, smtliche Punkte eines Layers auch dann
darzustellen, wenn sie sich teilweise an derselben Stelle befinden. Die Punkte werden dabei um ein Zentrumssymbol herum auf einem Versatzkreis angeordnet und dargestellt.

88

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Abbildung 12.14: Regelbasierte Symbolisierungsoptionen

12.3. Vektorlayereigenschaften

89

QGIS User Guide, Release 2.6

Abbildung 12.15: Dialog Punktverdrngung

90

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Tipp: Symbologie exportierten


You have the option to export vector symbology from QGIS into Google *.kml, *.dxf and MapInfo *.tab files. Just
open the right mouse menu of the layer and click on Save selection as to specify the name of the output file and
its format. In the dialog, use the Symbology export menu to save the symbology either as Feature symbology or
as Symbol layer symbology . If you have used symbol layers, it is recommended to use the second setting.
Inverted Polygon
Inverted polygon renderer allows user to define a symbol to fill in outside of the layers polygons. As before you
can select a subrenderers. These subrenderers are the same as for the main renderers.

Abbildung 12.16: Inverted Polygon dialog

Color Picker
Regardless the type of style to be used, the select color dialog will show when you click to choose a color either border or fill color. This dialog has four different tabs which allow you to select colors by
color wheel

color swatches

or

color picker

color ramp

Whatever method you use, the selected color is always described through color sliders for HSV (Hue, Saturation,
Value) and RGB (Red, Green, Blue) values. There is also an opacity slider to set transparency level. On the lower
left part of the dialog you can see a comparison between the current and the new color you are presently selecting
and on the lower right part you have the option to add the color you just tweaked into a color slot button.
With

color ramp

or with

color wheel

, you can browse to all possible color combinations. There are other possi-

you can choose from a preselected list. This selected list is populated
bilities though. By using color swatches
with one of three methods: Recent colors, Standard colors or Project colors
Another option is to use the

color picker

12.3. Vektorlayereigenschaften

which allows you to sample a color from under your mouse pointer at

91

QGIS User Guide, Release 2.6

Abbildung 12.17: Color picker ramp tab

Abbildung 12.18: Color picker swatcher tab

92

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

any part of QGIS or even from another application by pressing the space bar. Please note that the color picker is
OS dependent and is currently not supported by OSX.
Tipp: quick color picker + copy/paste colors
You can quickly choose from Recent colors, from Standard colors or simply copy or paste a color by clicking the
drop-down arrow that follows a current color box.

Abbildung 12.19: Quick color picker menu

Layerdarstellung
: Sie knnen den unten liegenden Layer in der Kartenansicht mit
Layertransparenz
diesem Werkzeug sichtbar machen. Verwenden Sie den Slider um die Sichtbarkeit Ihres Vektorlayers an
Ihre Bedrfnisse anzupassen. Sie knnen auch eine genaue Definition des Prozentgrades der Sichtbarkeit
im Men neben dem Slider vornehmen.
guilabel:Layermischmodi und Objektmischmodi: Sie knnen spezielle Darstellungseffekte mit diesen
Werkzeugen, die Sie vorher nur von Grafikprogrammen gekannt haben, erzielen. Die Pixel der oben auf
liegenden und darunter liegenden Layer werden anhand der unten beschriebenen Einstellungen gemischt.
Normal: Dies ist der Standardmischmodus, der den Alphakanal des oben liegenden Pixels mit dem
darunter liegenden Pixel vermischt. Die Farben werden nicht vermischt.
Heller: Dies whlt das Maximum jeder Komponente der Vordergrund- und Hintergrundpixel. Seien
Sie sich bewusst dass die Ergebnisse zackig und hart aussehen knnen.
Bildschirm: Helle Pixel der Quelle werden ber die des Ziels gezeichnet wohingegen dunkle Pixel
nicht verwendet werden. Dieser Modus ist am ntzlichsten fr das Mischen der Textur eines Layers
mit einem anderen Layer (z.B. kann man eine Schummerung dazu verwenden einen anderen Layer
mit einer Textur zu versehen).
Abwedeln: das Abwedeln erhellt und sttigt unten liegende Pixel auf Basis der Helligkeit des oben
liegenden Pixels. Demzufolge erhhen hellere oben liegende Pixel die Sttigung und Helligkeit des
unten liegenden Pixels. Dies funktioniert am Besten wenn die oben liegenden Pixel nicht zu hell sind;
andernfalls ist der Effekt zu extrem.
Addition: Dieser Mischmodus fgt einfach die Pixelwerte eines Layers denen eines anderen Layers
hinzu. Im Falle von Werten grer 1 (im Fall von RGB) wird wei dargestellt. Dieser Modus ist dafr
geeignet Objekte hervorzuheben.
Dunkler: Dies erstellt ein Ergebnispixel das die kleinste Komponente der Vordergrund und Hintergrundpixel erhlt. Wie das Aufhellen neigen die Ergebnisse dazu zackig und hart zu sein.
Multiplizieren: Hier werden die Nummern fr jedes Pixel des oben liegenden Layers mit den
entsprechenden Pixeln des unteren Layers multipliziert. Das Ergebnis sind dunklere Bilder.
Einbrennen: Dunklere Farben im oben liegenden Layer bewirken ein Verdunkeln des unten liegenden Layers. Einbrennen kann dazu benutzt werden um unten liegende Layer zu optimieren und zu
colorieren.
12.3. Vektorlayereigenschaften

93

QGIS User Guide, Release 2.6

berlagern: Dieser Modus kombiniert die Multiplizieren und Bilschirm Mischmodi. Im Ergebnispixel
werden helle Bereiche heller und dunkle Bereiche dunkler.
Weiches Licht: Dieses ist dem berlagern sehr hnlich nur dass anstelle Multiplizieren/Bildschirm
Einbrennen/Abwedeln verwendet wird. Hier soll das Leuchten eines weichen Lichtes auf ein Bild
nachgeahmt werden.
Hartes Licht: Auch Hartes Licht ist dem berlagerungsmodus sehr hnlich. Hier soll die Projektion
eines sehr intensiven Lichts auf ein Bild nachgeahmt werden.
Unterschied: Unterschied subtrahiert das oben liegende Pixel von dem unten liegenden Pixel oder
andersherum um immer einen positiven Wert zu bekommen. Das Mischen mit Schwarz produziert
keinen Unterschied, da die Differenz mit allen Farben Null ist.
Abziehen: Dieser Mischmodus zieht einfach die Pixelwerte eines Layers von dem anderen ab. Im Fall
von negativen Werten wird Schwarz dargestellt.

12.3.2 Men Beschriftungen


Beschriftungen
Kernanwendung stellt intelligentes Beschriften fr Punkt-, Linien- und Polygonlayer zur VerDie
fgung und erfordert nur wenige Parameter. Diese neue Anwendung unterstzt auch spontan transformierte Layer.
Die Kernfunktionen der Anwendung wurden berarbeitet. In QGIS gibt es eine Anzahl von anderen Funktionen
die das Beschriften verbessern. Die folgenden Mens wurden erstellt um die Vektorlayer zu beschriften:

Text
Formatierung
Puffer
Hintergrund
Schatten
Platzierung
Darstellung
Lassen Sie uns sehen wie die Mens fr verschiedene Vektorlayer benutzt werden knnen.
beschriften

Punktlayer

Starten Sie QGIS und laden Sie einen Punktlayer. Aktivieren Sie den Layer in der Legende und klicken Sie auf
das

Layerbeschriftungseinstellungen

Icon in der QGIS Werkzeugleiste.

Der erste Schritt besteht darin das


Layer beschriften mit Kontrollkstchen zu aktivieren und eine Attributspalte
fr das Beschriften auszuwhlen. Klicken Sie
wenn Sie ausdrucksbasierte Beschriftungen definieren wollen Siehe labeling_with_expressions.
Die folgenden Schritte beschreiben ein einfaches Beschriften ohne die Verwendung der Datendefinierten bersteuerung Funktionen, die neben den Drop-Down Mens untergebracht sind.
Sie knnen den Textstil im Text Men definieren (siehe Figure_labels_1). Verwenden Sie die Schriftart Gro/Kleinschreibung Option um die Textdarstellung zu beeinflussen. Sie haben die Mglichkeit den Text mit Nur
Grobuchstaben, Nur Kleinbuchstaben oder Erstes Zeichen gro darzustellen. Verwenden Sie Mischmodi um
Effekte die Sie von Grafikprogrammen kennen zu erstellen (siehe blend_modes).
Im Men Formatierung knnen Sie einen Buchstaben fr einen Zeilenumbruch in den Beschriftungen mit der Bei
Zeichen umbrechen Funktion definieren. Verwenden Sie die
Zahlenformatierung Option um die Nummern
in einer Attributtabelle zu formatieren. Hier knnen Dezimalstellen eingefgt werden. Wenn Sie diese Option
aktivieren werden erst einmal drei Dezimalstellen als Standard eingestellt.
Um einen Puffer zu erstellen aktivieren Sie einfach die
Textpuffer zeichnen im Men Puffer. Die Pufferfarbe
ist variabel. Auch hier knnen Sie Mischmodi verwenden ( siehe blend_modes).

94

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

If the
color buffers fill checkbox is activated, it will interact with partially transparent text and give mixed
color transparency results. Turning off the buffer fill fixes that issue (except where the interior aspect of the buffers
stroke intersects with the texts fill) and also allows you to make outlined text.
Im Men Hintergrund knnen Sie mit Gre X und Gre Y die Form Ihres Hintergrunds definieren. Verwenden
Sie Grenart um einen zustzlichen Puffer in Ihren Hintergrund einzufgen. Der Hintergrund besteht dann aus
dem Puffer mit dem Hintergrund in Gre X und Gre Y. Sie knnen eine Drehung festlegen wobei Sie zwischen
Mit Beschriftung abgleichen, Beschriftungsversatz und Fest whlen knnen. Indem Sie Beschriftungsversatz und Fest verwenden, knnen Sie den Hintergrund rotieren. Definieren Sie X-,Y-Versatz mit X und Y Werten
und der Hintergrund wird versetzt. Wenn Sie X-, Y-Radius verwenden erhlt der Hintergrund runde Ecken. Auch
hier ist es mglich den Hintergrund mit den darunterliegenden Layern in der Kartenansicht anhand von Mischmodi
zu mischen (siehe blend_modes).
Verwenden Sie das Schatten Men fr einen benutzerdefinierten Schattenwurf. Das Zeichnen des Hintergrunds
ist sehr variabel. Whlen Sie zwischen Niedrigste Beschriftungskomponente, Text, Puffer und Hintergrund.
Globalen
Der Versatz-Winkel hngt von der Orientierung der Beschriftung ab. Wenn Sie das Kontrollkstchen
Schatten verwenden dann ist der Ausgangspunkt des Winkels immer nach Norden orientiert und hngt nicht von
der Orientierung der Beschriftung ab. Sie knnen das Erscheinungsbild des Schattens mit Radius verschmieren
beeinflussen. Je hher die Nummer desto weicher sind die Schatten. Das Erscheinungsbild des Schattenwurfs kann
auch durch das Benutzen eines Mischmodus verndert werden (siehe blend_modes).
Verwenden Sie das Men Platzierung fr die Platzierung der Beschriftung und die Beschriftungsprioritt. Wenn
Abstand vom Punkt Einstellung verwendne haben jetzt die Option Quadrant zum Platzieren Ihrer
Sie die
Label zu benutzen. Zustzlich knnen Sie den Winkel der Beschriftungsplatzierung mit der Drehung Einstellung
verwenden. So ist die Platzierung in einem bestimmten Quadranten mit einer bestimmten Drehung mglich.
Im Men Darstellung knnen sie Beschriftungs- und Objektoptionen definieren. Unter Beschriftungsoptionen
knnen Sie jetzt die mastabsabhngige Sichtbarkeitseinstellung vornehmen. Sie knnen QGIS davon abhalten
Alle Beschriftungen auf diesem Layer anzeigen
nur ausgewhlte Beschriftungen darzustellen indem Sie das
(einschlielich kollidierender) Kontrollkstchen benutzen. Unter Objektoptionen knnen Sie definieren ob jeder
Teil eines Mulitpart Features beschriftet werden soll. Es ist mglich zu definieren ob die Nummer von Objekten
die beschriftet werden soll begrenzt ist und

Mglichst keine Objekte durch Beschriftungen verdecken.

Abbildung 12.20: Intelligentes Beschriften von Punktlayern


Linienlayer beschriften
Der erste Schritt ist es das
Layer beschriften mit Kontrollkstchen im Beschriftungen Men zu aktivieren und
eine Attributspalte fr das Beschriften auszuwhlen. Klicken Sie
wenn Sie ausdrucksbasierte Beschriftungen
definieren wollen - siehe labeling_with_expressions.
12.3. Vektorlayereigenschaften

95

QGIS User Guide, Release 2.6

Danach knnen Sie den Textstil im Text Men definieren. Hier knnen Sie die gleichen Einstellungen wie fr
Punktlayer verwenden.
Auch im Men Formatierung sind die gleichen Einstellungen wie fr Punktlayer mglich.
Das Men Puffer hat die gleichen Funktionen wie in Abschnitt labeling_point_layers.
Das Men Hintergrund hat die gleichen Eintrge wie in Abschnitt labeling_point_layers beschrieben.
Auch das Schatten Men hat die gleichen Eintrge wie in section labeling_point_layers beschrieben.
Parallel,
Im Men Platzierung finden Sie spezielle Einstellungen fr Linienlayer. Die Beschriftung kann
Gebogen oder
Horizontal platziert werden. Mit der
Parallel und radiobuttonoff| Gebogen Option knnen
ber Linie,
Auf der Linie und
Unter Linie definieren. Es ist mglich mehrere OpSie die Position
tionen auf einmal auszuwhlen. In diesem Fall wird QGIS nach der optimalen Position der Beschriftung suchen.
Zustzlich knnen Sie Grter Winkel zwischen Zeichen auf Kurven definieren wenn Sie die
Gebogen Option
auswhlen (siehe Figure_labels_2).
You can set up a minimum distance for repeating labels. Distance can be in mm or in map units.
Some Placement setup will display more options, for example, Curved and Parallel Placements will allow the user
to set up the position of the label (above, belw or on the line), distance from the line and for Curved, the user can
also setup inside/outside max angle between curved label.
Das Darstellung Men hat fast die gleichen Eintrge wie das bei Punktlayern. In den Objektoptionen knnen Sie
jetzt Objekte nicht beschriften, wenn krzer als.

Abbildung 12.21: Intelligentes Beschriften von Linienlayern


Polygonlayer beschriften
Der erste Schritt ist es das
Layer beschriften mit Kontrollkstchen zu aktivieren und eine Attributspalte fr das
wenn Sie ausdrucksbasierte Beschriftungen definieren wollen - Siehe
Beschriften auszuwhlen. Klicken Sie
labeling_with_expressions.
Definieren Sie den Textstil im Text Men. Die Eintrge sind die gleichen wie die fr Punkt- und Linienlayer.
Das Men Formatierung ermglicht es Ihnen mehrzeilige Zeilen zu formatieren wie schon bei Punkt- und Linienlayern.
Wie bei Punkt- und Linienlayern knnen Sie einen Textpuffer im Puffer Men erstellen.
Verwenden Sie das Men Hintergrund um einen komplexen benutzerdefinierten Hintergrund fr den Polygonlayer
zu erstellen. Sie knnen das Men wie bei Punkt- und Linienlayern benutzen.

96

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Die Eintrge in dem Men Schatten sind die gleichen wie fr Punkt- und Linienlayer.
Abstand
Im Men Platzierung finden Sie spezielle Einstellungen fr Polygonlayer (siehe Figure_labels_3).
vom Zentrum,
Horizontal (langsam), |radiobuttonoff| :guilabel:Um Zentrum,
Frei (langsam) und
Nach
Umfang sind mglich.
In den
Abstand vom Zentrum Einstellungen knnen Sie festlegen ob der Zentroid sich auf
sichtbarem
Polygon oder
ganzem Polygon bezieht. Das heit dass entweder der Zentroid fr das Polygon das Sie auf
der Karte sehen verwendet wird oder der Zentroid fr das ganze Polygon bestimmt wird egal ob Sie das ganze
Objekt auf der Karte sehen. Sie knnen hier Ihre Beschriftung anhand von Quadranten platzieren sowie Versatz
und Drehung definieren. Die
Um Zentrum Einstellung macht es mglich die Beschriftung um einen Zentroiden
sichtbarem Polygon oder
ganzem
herum mit einer bestimmten Distanz zu platzieren. Auch hier knnen Sie
Polygon fr den Zentroiden definieren. Mit den
Nach Umfang Einstellungen knnen Sie eine Position und
einen Abstand fr die Beschriftung definieren. Fr die Position sind
:guilabel:Unter Linie und

ber Linie,

Auf Linie, |checkbox|

Linienrichtungsabhngige Position mglich.

Related to the choose of Label Placement, several options will appear. As for Point Placement you can choose the
distance for the polygon outline, repeat the label around the polygon perimeter.
Die Eintrge in das Men Darstellung sind die gleichen wie fr Linienlayer. Sie knnen auch Objekte nicht
beschriften wenn krzer als in den Objektoptionen. Ausdrucksbasierte Beschriftungen definieren

Abbildung 12.22: Intelligentes Beschriften von Polygonlayern


Mit QGIS knnen Sie Ausdrcke benutzen um Objekte zu beschriften. Klicken Sie einfach das

Icon im Men

Beschriftungen

des Eigenschaften Dialogs. In figure_labels_4 sehen Sie einen Beispielausdruck um die Alaska
Regionen mit Namen- und Flchengre, abhngig vom Feld NAME_2, etwas beschreibenden Text und die
Funktion $area() in Kombination mit format_number() damit sie besser aussieht.
Mit dem ausdrucksbasierten Beschriften knnen Sie auf einfache Art und Weise arbeiten. Alles worum Sie
sich kmmern mssen ist dass Sie alle Elemente (Zeichenketten, Felder und Funktionen) mit einem StringVerkettungszeichen || kombinieren und dass Felder in doppelten Anfhrungszeichen und Zeichenketten in
einfachen Anfhrungszeichen geschrieben werden. Lassen Sie uns einen Blick auf einige Beispiele werfen:
# label based on two fields name and place with a comma as separater
"name" || , || "place"
-> John Smith, Paris
# label based on two fields name and place separated by comma

12.3. Vektorlayereigenschaften

97

QGIS User Guide, Release 2.6

Abbildung 12.23: Ausdrcke fr das Beschriften verwenden

My name is || "name" || and I live in || "place"


-> My name is John Smith and I live in Paris
# label based on two fields name and place with a descriptive text
# and a line break (\n)
My name is || "name" || \nI live in || "place"
-> My name is John Smith
I live in Paris
# create a multi-line label based on a field and the $area function
# to show the place name and its area size based on unit meter.
The area of || "place" || has a size of || $area || m
-> The area of Paris has a size of 105000000 m
# create a CASE ELSE condition. If the population value in field
# population is <= 50000 it is a town, otherwise a city.
This place is a || CASE WHEN "population <= 50000" THEN town ELSE city END
-> This place is a town

As you can see in the expression builder, you have hundreds if functions available to create simple and very
complex expressions to label your data in QGIS. See Expressions chapter for more information and example on
expressions.
Datendefinierte bersteuerung fr das Beschriften
Mit der datendefinierten bersteuerung werden die Einstellungen fr das Beschriften von Eintrgen in der Attributtabelle berschrieben. Sie knnen die Funktion mit dem Rechte-Maus-Knopf aktivieren und deaktivieren.
Fahren Sie ber das Symbol und Sie sehen die Information ber die datendefinierte bersteuerung einschlielich
des aktuellen Definitionsfeldes. Wir beschreiben jetzt ein Beispiel indem wir die datendefinierte bersteuerungsfunktion fr die

Beschriftung verschieben

Funktion verwenden (siehe figure_labels_5 ).

1. Importieren Sie lakes.shp aus dem QGIS Beispieldatensatz.


2. Doppelklicken Sie den Layer um die Layereigenschaften zu ffnen. Klicken Sie auf Beschriftungen und
98

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Platzierung. Whlen Sie

Abstand vom Punkt.

3. Suchen Sie nach den Datendefiniert Eintrgen. Klicken Sie das


Icon um den Feldtyp fr die Koordinate
zu definieren. Whlen Sie xlabel fr X und ylabel fr Y aus. Die Icons sind jetzt in gelb hervorgehoben.
4. Zoomen Sie auf einen See.
Icon. Jetzt knnen Sie die Beschriftung
5. Gehen Sie zur Beschriftung Werkzeugleiste und klicken Sie das
manuell in eine andere Position verschieben (siehe figure_labels_6). Die neue Position der Beschriftung ist
in den xlabel und ylabel Spalten der Attributtabelle gespeichert.

Abbildung 12.24: Das Beschriften von Polygonlayern mit datendefinierter bersteuerung

Abbildung 12.25: Beschriftungen verschieben

12.3. Vektorlayereigenschaften

99

QGIS User Guide, Release 2.6

12.3.3 Men Felder


Innerhalb des Felder Mens knnen die Feldattribute des ausgewhlten Datensatzes manipuliert werden. Die
Knpfe
Modus ist.

Neue Spalte

und

Spalte lschen

knnen benutzt werden wenn der Datensatz im

Bearbeitungsstatus umschalten

Bearbeitungselement

Abbildung 12.26: Dialog um ein Bearbeitungselement fr eine Attributspalte auszuwhlen


Innerhalb des Mens Felder finden Sie auch eine Bearbeitungselement Spalte. Diese Spalte kann dazu benutzt
werden Werte oder eine Spanne von Werten zu definieren die zu der bestimmten Attributtabellenspalte hinzugefgt
werden drfen. Wenn Sie auf den [Eingabezeile] Knopf klicken ffnet sich ein Dialog indem Sie verschiedene
Elemente definieren knnen. Diese Elemente sind:
Kontrollkstchen: Gibt ein Kontrollkstchen wieder und Sie knnen definieren welches Attribut der Spalte
hinzugefgt wird wenn das Kontrollkstchen aktiviert ist oder nicht.
Klassifikation: Auswahlliste mit den Attributwerten, die im Men Stil als Legendentyp Eindeutiger Wert
fr die Klassifikation benutzt werden.
Color: Displays a color button allowing user to choose a color from the color dialog window.
Date/Time: Displays a line fields which can opens a calendar widget to enter a date, a time or both. Column
type must be text. You can select a custom format, pop-up a calendar, etc.
Aufzhlung: ffnet eine Kombobox mit Werten die innerhalb eines Spaltentyps benutzt werden knnen.
Dieses wird aktuell nur vom PostgreSQL Provider unterstzt.
Dateiname: Vereinfacht die Dateiauswahl durch einen Dateiauswahldialog.
100

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Versteckt: Ein verstecktes Attribut ist unsichtbar. Der Anwender kann den Inhalt nicht sehen.
Foto: Feld enthlt einen Dateinamen fr ein Bild. Die Breite und Hhe des Feldes kann definiert werden.
Bereich: Erlaubt Ihnen numerische Werte eines bestimmten Wertebereichs festzulegen. Das Bearbeitungselement kann entweder ein Schieber oder ein Drehfeld sein.
Beziehungsreferenz: Mit diesem Element knnen Sie das Objektformular des referenzierten Layers in das
Objektformular des aktuellen Layers einbetten. Siehe Ein-Zu-Mehrere-Beziehungen erstellen.
Text edit (default): This opens a text edit field that allows simple text or multiple lines to be used. If you
choose multiple lines you can also choose html content.
Eindeutige Werte: Sie knnen einen der Werte die bereits in der Attributtabelle verwendet werden aussuchen. Wenn nderbar aktiviert ist, wird eine Eingabezeile mit Autovervollstndigungsuntersttzung
gezeigt, andernfalls wird eine Kombobox verwendet.
UUID Generator: Erstellt ein schreibgeschtztes UUID (Universally Unique Identifiers)-Feld wenn es leer
ist.
Wertabbildung: Eine Kombobox mit vordefinierten Elementen. Der Wert ist im Attribut gespeichert, die
Beschreibung wird in der Kombobox gezeigt. Sie knnen Werte manuell definieren oder sie aus einem Layer
oder einer CSV-Datei laden.
Wertbeziehung: Bietet Werte aus einer verknpften Tabelle in einem Auswahlmen an. Sie knnen Layer,
Schlsselspalte und Wertspalte auswhlen.
Webansicht: Feld enthlt eine URL. Die Breite und Hhe des Feldes ist variabel.
Mit der Attributeditorzusammenstellung knnen Sie jetzt integrierte Formulare fr Dateneingabeaufgaben
definieren (siehe figure_fields_2). Whlen Sie Mit Drag und Drop zusammenstellen und eine Attributspalte.
Verwenden Sie das

Icon um eine Kategorie die dann whrend der Digitalisiersitzung gezeigt wird zu erstellen

Icon der Kategorie


(siehe figure_fields_3). Im nchsten Schritt werden dann die relevanten Felder mit dem
zugeordnet. Sie knnen noch mehr Kategorien erstellen und dabei die gleichen Felder verwenden. Wenn Sie eine
neue Kategorie erstellen fgt QGIS einen neuen Reiter fr die Kategorie im integrierten Formular ein.
Andere Optionen im Dialog sind Autogenerate und Provide ui-file. Automatisch erzeugen erstellt einfach Editoren fr alle Felder und tabelliert sie. Bei der UI-Datei verwenden Option knnen Sie komplexe Dialoge, die mit
dem Qt-Designer erstellt werden, verwenden. Das Verwenden einer UI-Datei ermglicht ein hohes Ma an Freiheit beim Erstellen eines Dialogs. Detaillierte Informationen knnen Sie unter http://nathanw.net/2011/09/05/qgistips-custom-feature-forms-with-python-logic/ finden.
QGIS Dialoge knnen eine Python-Funktion beinhalten, die aufgerufen wird wenn der Dialog geffnet wird.
Verwenden Sie diese Funktion um Ihren Dialogen eine zustzliche Logik hinzuzufgen. Ein Beispiel ist (im Modul
MyForms.py):
def open(dialog,layer,feature):
geom = feature.geometry()
control = dialog.findChild(QWidged,"My line edit")

Die Referenz in der Python Init Function sieht in etwa so aus: MyForms.open
MyForms.py muss in den PYTHONPATH wie in .qgis2/python oder innerhalb des Projektordners eingetragen
werden.

12.3.4 Men Allgemein


Verwenden Sie dieses Men um allgemeine Einstellungen fr den Vektorlayer zu machen. Es stehen mehrere
Optionen zur Verfgung:
Layerinformation
ndern Sie den Anzeigenamen des Layers in angezeigt als

12.3. Vektorlayereigenschaften

101

QGIS User Guide, Release 2.6

Abbildung 12.27: Dialog Attributeditorzusammenstellung um Kategorien zu erstellen

Abbildung 12.28: Das Ergebnis eines integrierten Formulars in einer Dateneingabesitzung.

102

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Definieren Sie die Layerquelle des Vektorlayers


Definieren Sie Datenquellenkodierung um providerspezifische Optionen zu definieren und um in der Lage
zu sein die Datei zu lesen.
Koordinatenbezugssystem
Verwenden Sie Festlegen fr das Koordinatensystem. Hier knnen Sie die Projektion eines bestimmten
Vektorlayers ansehen oder verndern.
Erstellen Sie einen Rumlichen Index (nur OGR-untersttzte Formate)
Die Ausmae aktualisieren fr einen Layer
Sehen Sie sich die Projektion eins spezifischen Vektorlayers an oder ndern Sie diese indem Sie auf Festlegen ... klicken.
Mastabsabhngige Sichtbarkeit
Sie knnen den Maximum (inklusive) und Minimum (exklusiv) Mastab einstellen. Der Mastab kann auch
mit den [Aktuell] Knpfen eingestellt werden.
Objektuntermenge
With the [Query Builder] button, you can create a subset of the features in the layer that will be visualized
(also refer to section Abfrageeditor).

Abbildung 12.29: Men Allgemein in Vektorlayer Eigenschaften Dialog

12.3.5 Men Darstellung


QGIS 2.2 fhrt Untersttzung fr Geometrievereinfachung ein. Dies kann die Darstellungszeit verbessern wenn
viele komplexe Objekte in kleinem Mastab gezeichnet werden sollen. Dieses Objekt kann in den Layereinstel12.3. Vektorlayereigenschaften

103

QGIS User Guide, Release 2.6

lungen ein- oder ausgeschaltet werden indem


Geometrie vereinfachen verwendet wird. Es gibt zustzlich eine
neue globale Einstellung die die Vereinfachung standardmig fr neu hinzugefgte Layer einschaltet (siehe Abschnitt Optionen): Beachten Sie: Geometrievereinfachung kann zu Splitterpolygonen und ungenauer Darstellung
fhren wenn offset-basierte Symbollayer verwendet werden.

12.3.6 Men Darstellung


Dieses Men ist speziell fr Kartenhinweise erstellt worden. Es enthlt eine neue Funktion: Kartentippanzeigetext in HTML. Whrend Sie weiterhin ein
Feld das angezeigt werden soll wenn Sie ber ein Objekt
auf der Karte gehen whlen knnen ist es jetzt mglich HTML Code der eine komplexe Anzeige erstellt wenn
man darber geht einzugeben. Um Kartenhinweise zu aktivieren whlen Sie die Menoption Ansicht Kartenhinweise. Figure Display 1 zeigt ein Beispiel fr HTML Code.

Abbildung 12.30: HTML-Code fr Kartenhinweis

Abbildung 12.31: Kartenhinweis erstellt mit HTML-Code

104

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

12.3.7 Men Aktionen


QGIS bietet die Mglichkeit, Aktionen auf Basis von Attributen einer Ebene durchzufhren. Dies kann fr
eine Vielzahl von Aktionen genutzt werden, z.B. um ein Programm mit Abfragen aus der Attributdatenbank zu
fttern oder um Parameter an ein Web-Reporting-Tool weiterzugeben.

Abbildung 12.32: berblick ber den Dialog Aktionen mit einigen Beispielaktionen
Aktionen auf Basis von Attributen sind sinnvoll wenn sie hufig eine externe Anwendung starten oder eine Internetseite auf Basis von einem oder mehreren Werten in Ihrem Vektorlayer visualisieren wollen. Sie sind in 6 Typen
aufgeteilt und knnen wie folgt verwendet werden:
Allgemein, Mac, Windows und Unix Aktionen starten einen externen Prozess.
Python Aktionen fhren einen Python-Ausdruck aus.
Allgemeine und Pythonaktionen sind berall sichtbar.
Mac, Windows und Unix Aktionen sind nur sichtbar auf der entsprechenden Plattform (z.B. knnen Sie
drei Bearbeiten Aktionen definieren um einen Editor zu ffnen und die Benutzer knnen nur die eine
Bearbeiten Aktion fr Ihr Betriebssystem sehen und ausfhren um den Editor zu starten).
Es gibt verschiedene Beispiele in diesem Dialog. Sie knnen Ihn laden indem Sie auf [Voreingestellte Aktion]
klicken. In einem Beispiel wird eine Suche auf Basis eines Attributwertes durchgefhrt. Dieses Konzept wird in
der folgenden Diskussion verwendet.
Aktionen definieren
Attributaktionen werden im Vektor Layer Eigenschaften Dialog definiert. Um eine Aktion zu definieren ffnen
Sie den Vektor Layereigenschaften Dialog und klicken Sie auf das Men Aktionen. Gehen Sie zu den Aktionseigenschaften. Whlen Sie Allgemein als Typ und vergeben Sie einen beschreibenden Namen fr die Aktion.
Die Aktion selbst muss den Namen der Anwendung, die ausgefhrt wird wenn die Aktion zum Einsatz kommt,
enhalten. Sie knnen einen oder mehrere Attributfeldwerte als Argumente der Applikation hinzufgen. Wenn die
Aktion aufgerufen wird wird jeder Satz von Buchstaben, der mit einem % beginnt und auf den der Name eines
Feldes folgt, durch den Wert des entsprechenden Feldes ersetzt. Die speziellen Buchstaben %% werden durch
12.3. Vektorlayereigenschaften

105

QGIS User Guide, Release 2.6

den Wert des Feldes, das durch das Objekte abfragen Werkzeug oder die Attributtabelle ausgewhlt wurde, ersetzt
(siehe using_actions unten). Anfhrungszeichen werden ignoriert wenn Ihnen ein Backslash vorausgeht.
Wenn Sie Feldnamen vorfinden die Substrings anderer Feldnamen sind (z.B., col1 und col10) sollten Sie das
angeben indem Sie den Feldnamen (und den % Buchstaben) mit eckigen Klammern umrunden (z.B. [%col10]).
Hiermit wird vermieden dass der %col10 Feldname mit de, %col1 Feldnamen mit einem 0 am Ende verwechselt
wird. Die Klammern werden von QGIS entfernt wenn es im Wert des Feldes ersetzt. Wenn Sie wollen dass das zu
ersetzende Feld von eckigen Klammern umrandet wird verwenden Sie ein zweites Set wie hier:[[%col10]].
Wenn Sie das Objekte abfragen Werkzeug verwenden, knnen Sie den Identifikationsergebnis Dialog ffnen. Es
enthlt eine (Abgeleitet) Item das layertyprelevante Informationen enthlt. Die Werte in diesem Element knnen
auf hnliche Weise den anderen Feldern zugeordnet werden indem dem Abgeleitet Feldnamen ein (Derived)
vorangeht. Zum Beispiel hat ein Punktlayer ein X und Y Feld und die Werte dieser Felder knnen in der Aktion
mit %(Derived).X und %(Derived).Y verwendet werden. Die Abgeleitet Attribute sind nur in der Objekte
abfragen Dialog Box erhltlich, jedoch nicht in der Attributtabelle Dialogbox.
Nachfolgend werden zwei Beispielaktionen gezeigt:
konqueror http://www.google.com/search?q=%nam
konqueror http://www.google.com/search?q=%%
Im ersten Beispiel wird der Webbrowser Konqueror eingebunden und ffnet eine URL. Die URL fhrt eine
Googlesuche fr den Wert des nam Feldes unseres Vektorlayers durch. Beachten Sie das die Anwendung oder
das Skript das von der Anwendung aufgerufen wird im Pfad sein muss oder den vollen Pfad vermitteln muss.
Um sicher zu sein knnten wir das erste Beispiel wie folgt umschreiben: /opt/kde3/bin/konqueror
http://www.google.com/search?q=%nam. Dies wird versichern dass die Konqueroranwendung ausgefhrt wird wenn die Aktion aufgerufen wird.
Das zweite Beispiel nutzt den Ausdruck %%, welcher unabhngig ist von einem speziellen Feld. Beim Ausfhren
des Befehls wird der Ausdruck %% durch den Wert des jeweils selektierten Feldes aus Objekte abfragen oder der
Attributtabelle ersetzt. Aktionen anwenden
Aktionen knnen entweder ber den Objekte abfragen Dialog, den Attributtabelle Dialog oder ber Objektaktion
durchfhren aufgerufen werden (erinnern Sie sich daran dass diese Dialoge durch Klicken von

Objekte abfragen

Attributtabelle ffnen
Objektaktion ausfhren
oder
geffnet werden knnen). Um eine Aktion aufzurufen, klicken
oder
Sie mit der rechten Maustaste auf einen Eintrag im Popup Men und whlen die gewnschte Aktion aus der Liste
aus. Aktionen sind anhand des Namens den Sie beim Definieren der Aktion vergeben haben im Popup Men
aufgefhrt. Klicken Sie auf die Aktion die sie aufrufen wollen.

Wenn Sie eine Aktion mit %% Notation verwenden, machen Sie einen Rechtsklick auf den Feldwert im Objekte
abfragen Dialog oder im Attributtabelle Dialog den Sie der Anwendung oder dem Skript bergeben wollen.
In einem weiteren Beispiel soll gezeigt werden, wie Attributwerte eines Vektorlayers abgefragt und in eine Textdatei mit Hilfe der Bash und des echo Kommandos geschrieben werden (funktioniert also nur unter
und evtl.
). Der Abfragelayer enthlt die Felder Art taxon_name, Latitude lat und Longitude long. Wir mchten jetzt eine rumliche Selektion von rtlichkeiten machen und diese Feldwerte in eine Textdatei fr den ausgewhlten
Datensatz (in der QGIS Kartenansicht in gelb gezeigt) exportieren. Hier ist die Aktion, um dies zu erreichen:
bash -c "echo \"%taxon_name %lat %long\" >> /tmp/species_localities.txt"

Nachdem ein paar Orte auf dem Bildschirm ausgewhlt wurden (diese erscheinen gelb hinterlegt), starten wir die
Aktion mit der rechten Maustaste ber den Dialog Abfrageergebnisse und knnen danach in der Textdatei die
Ergebnisse ansehen:
Acacia
Acacia
Acacia
Acacia

mearnsii
mearnsii
mearnsii
mearnsii

-34.0800000000
-34.9000000000
-35.2200000000
-32.2700000000

150.0800000000
150.1200000000
149.9300000000
150.4100000000

Als bung knnen wir eine Aktion erstellen die eine Googlesuche auf Basis des lakes Layers durchfhrt. Zuerst
mssen wir die URL, die gebraucht wird um eine Suche nach einem Stichwort durchzufhren, festlegen. Dies
lsst sich einfach durchfhren indem man einfach Google aufruft und eine einfache Suche durchfhrt und dann

106

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

die URL aus der Adressleiste Ihres Browsers entnimmt. Mit diesem kleinen Aufwand knnen wir sehen dass das
Format http://google.com/search?q=qgis ist, wobei QGIS das Suchwort ist. Anhand dieser Informationen knnen
wir fortfahren:
1. Laden Sie den Layer file:lakes.shp.
2. ffnen Sie den Layereigenschaften Dialog indem Sie einen Doppelklick auf den Layer in der Legende
machen und whlen Sie Eigenschaften aus dem Popup-Men.
3. Klicken Sie auf das Men Aktionen
4. Geben Sie einen Namen fr die Aktion ein, z.B. Google Search.
5. Fr diese Aktion ist es notwendig den Namen des externen Programms anzugeben. In diesem Fall knnen
wir Firefox verwenden. Wenn das Programm sich nicht im Pfad befindet mssen Sie den vollstndigen Pfad
angeben.
6. Hinter dem Namen des Programms geben wir die URL ein, die wir fr die Internetsuche benutzen wollen,
aber ohne das Schlsselwort: http://google.com/search?q=
7. Der
Text
imm
Feld
Aktion
http://google.com/search?q=

sollte

nun

folgendermaen

aussehen:

firefox

8. Klicken Sie nun auf die DropDown Box mit dem Spaltennamen der Attributtabelle des Layers lakes.
Der Knopf ist gleich links neben dem Knopf [Attribut einfgen].
9. Selektieren Sie NAMES aus der DropDown Box und klicken Sie [Attribut einfgen].
10. Die Aktion sieht nun so aus:
firefox http://google.com/search?q=%NAMES
11. Um die Aktion abzuschlieen klicken Sie auf den [Zur Aktionsliste hinzufgen] Knopf.
Damit ist die Aktion fertig fr den Einsatz. Der gesamte Befehl der Aktion sollte folgendermaen aussehen:
firefox http://google.com/search?q=%NAMES

Damit ist die Aktion fertig fr den Einsatz. Schlieen Sie den Eigenschaften Dialog und zoomen Sie in einen
Bereich Ihrer Wahl. Stellen Sie sicher, dass der Layer lakes in der Legende aktiviert ist. Nun identifizieren Sie
einen See. In der Ergebnisanzeige sollte nun die Aktion sichtbar sein:

Abbildung 12.33: Whlen Sie ein Objekt und eine Aktion aus

12.3. Vektorlayereigenschaften

107

QGIS User Guide, Release 2.6

Wenn wir nun auf das Wort action klicken, ffnet sich der Webbrowser Firefox und zeigt uns das Ergebnis der
Internetrecherche z.B. nach dem See Tustumena an http://www.google.com/search?q=Tustumena. Es ist brigens
auch mglich, weitere Attributspalten zu ergnzen. Dazu fgen Sie einfach ein +-Zeichen an das Ende der
Aktion, whlen eine weitere Attributspalte und klicken wieder auf den Knopf [Attribut einfgen]. In unserem
Datensatz ist leider keine weitere sinnvolle Attributspalte vorhanden, nach der man im Internet suchen knnte.
Sie knnen auch mehrere Aktionen fr einen Layer definieren. Sie alle werden dann bei der Abfrage von Objekten
im Identifikationsergebnis Dialog angezeigt.
Sie sehen, man kann sich eine Vielzahl interessanter Aktionen ausdenken. Wenn Sie z.B. einen Punktlayer mit
einzelnen Punkten haben, an denen Photos geschossen wurden, dann knnen Sie eine Aktion erstellen, ber die
Sie dann das entsprechende Foto anzeigen lassen knnen, wenn Sie auf den Punkt in der Karte klicken. Man kann
auch zu bestimmten Attributen webbasierte Information ablegen (z.B. in einer HTML-Datei) und diese dann ber
eine Aktion anzeigen lassen, etwa so wie in dem Google Beispiel.
Wir knnen auch komplexere Beispiele erstellen, indem wir z.B. Python Aktionen verwenden.
Normalerweise wenn wir beim Erstellen von Aktionen zum ffnen einer Datei mit einer externen Anwendung
absolute Pfade, oder letztendlich relative Pfade verwenden ist im zweiten Fall der Pfad relativ zum Ort der ausfhrbaren Datei. Was aber wenn wir relative Pfade, die relativ zum ausgewhlten Layer (eine dateibasierte, wie
ein Shape oder SpatiaLite) sind, benutzen mssen ? Mit dem folgenden Code knnen wir einen Trick anwenden:
command = "firefox";
imagerelpath = "images_test/test_image.jpg";
layer = qgis.utils.iface.activeLayer();
import os.path;
layerpath = layer.source() if layer.providerType() == ogr
else (qgis.core.QgsDataSourceURI(layer.source()).database()
if layer.providerType() == spatialite else None);
path = os.path.dirname(str(layerpath));
image = os.path.join(path,imagerelpath);
import subprocess;
subprocess.Popen( [command, image ] );

Wir mssen uns nur ins Gedchtnis rufen dass es sich um eine Python Aktion handelt und dass das ndern der
command und imagerelpath Variablen auf unsere Bedrfnisse angepasst wird.
Was aber wenn der relative Pfad relativ zur (gespeicherten) Projektdatei sein muss? Der Code der Python Aktion
wrde wie folgt lauten:
command="firefox";
imagerelpath="images/test_image.jpg";
projectpath=qgis.core.QgsProject.instance().fileName();
import os.path; path=os.path.dirname(str(projectpath)) if projectpath != else None;
image=os.path.join(path, imagerelpath);
import subprocess;
subprocess.Popen( [command, image ] );

Ein anderes Python Aktion Beispiel ist das mit wir dem Projekt neue Layer hinzufgen knnen. Z.B. wird in
den folgenden Beispielen dem Projekt ein Vektorlayer beziehungsweise ein Rasterlayer hinzugefgt. Die Namen
der Dateien, die dem Projekt hinzugefgt werden sollen, und die Namen, die den Layern gegeben werden, sind
datengesteuert (filename und layername sind Spaltennamen der Attributtabelle des Vektorlayers in dem die Aktion
erstellt wurde):
qgis.utils.iface.addVectorLayer(/yourpath/[% "filename" %].shp,[% "layername" %],
ogr)

Um eine Rasterdatei hinzuzufgen (ein TIF-Bild in diesem Beispiel) wird daraus:


qgis.utils.iface.addRasterLayer(/yourpath/[% "filename" %].tif,[% "layername" %]
)

108

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

12.3.8 Men Verknpfungen


The Joins menu allows you to join a loaded attribute table to a loaded vector layer. After clicking
, the
Add vector join dialog appears. As key columns, you have to define a join layer you want to connect with the
target vector layer. Then, you have to specify the join field that is common to both the join layer and the target
Choose which
layer. Now you can also specify a subset of fields from the joined layer based on the checkbox
fields are joined. As a result of the join, all information from the join layer and the target layer are displayed in
the attribute table of the target layer as joined information. If you specified a subset of fields only these fields are
displayed in the attribute table of the target layer.
QGIS bietet zur Zeit Untersttzung fr das Verknpfen von nicht-rumlichen Tabellenformaten die von OGR
untersttzt werden (z.B. CSV, DBF und Excel) und von Delimited Text und fr den PostgreSQL Provider (siehe
figure_joins_1).

Abbildung 12.34: Verknpfe eine Attributtabelle zu einem vorhandenen Vektorlayer


Zustzlich knnen Sie mit dem Vektorverknpfung hinzufgen Dialog:
12.3. Vektorlayereigenschaften

109

QGIS User Guide, Release 2.6

Verknpfung im Speicher cachen

Index auf Feld erzeugen

12.3.9 Men Diagramme


Das Men Diagramme ermglicht es, ein Diagramm als Grafik ber einen Vektorlayer zu visualisieren (siehe
figure_diagrams_1).
Die aktuelle Kernimplementation von Diagrammen bietet Untersttzung von Kuchendiagrammen, Textdiagrammen und Histogrammen.
Das Men ist in vier Reiter aufgeteilt: Darstellung, Gre, Position und Optionen.
Im Fall des Textdiagramms und Kuchendiagramms werden Textwerte aus verschiedenen Datenspalten untereinander mit einem Kreis oder einer Box mit Teilern dargestellt. Im Gre Reiter basiert die Diagrammgre auf einer
festen Gre oder auf linearer Skalierung entsprechend eines Klassifikationsattributs. Die Platzierung der Diagramme, die im Position Reiter vorgenommen wird, interagiert mit dem neuen Beschriften, also werden Positionskonflikte zwischen Diagrammen und Beschriftungen aufgedeckt und gelst. Zustzlich knnen die Diagramme
manuell befestigt werden.

Abbildung 12.35: Vektorlayer Eigenschaften Dialog mit Men Diagramme


Wir werden ein Beispiel zeigen und dem Alaskagrenzlayer ein Textdiagramm das Temperaturdaten von einem
climate Vektorlayer zeigt berlagern. Beide Vektorlayer sind Teil des QGIS Beispieldatensatzes (siehe Abschnitt
Beispieldaten).
Vektorlayer hinzufgen
Icon, browsen Sie zum QGIS Beispieldatensatzordner und
1. Klicken Sie erst auf das
laden Sie die beiden Vektorlayer alaska.shp und climate.shp.

110

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

2. Doppelklicken Sie auf den climate Layer in der Kartenlegende um den Dialog Layereigenschaften zu
ffnen.
3. Klicken Sie auf das Men Diagramme, aktivieren Sie
gramm aus der Diagrammtyp

Diagramme anzeigen und whlen Sie Textdia-

Kombo-Box aus.

4. Im Darstellung Reiter whlen wir ein Hellblau als Hintergrundfarbe und im Reiter Gre stellen wir eine
feste Gre von 18 mm ein.
5. Im Reiter Position knnte die Platzierung auf Um Punkt eingestellt werden.
6. Im Diagramm wollen wir die Werte der drei Spalten T_F_JAN, T_F_JUL und T_F_MEAN darstellen.
Whlen Sie erst T_F_JAN als Attribute und klicken Sie den |mActionSignPlus| Knopf, dann T_F_JUL
und schlielich T_F_MEAN.
7. Klicken Sie jetzt [Anwenden] um das Diagramm in QGIS anzuzeigen.
Feste Gre und stellen
8. Sie knnen die Diagrammgre im Gre Reiter anpassen. Deaktivieren Sie
Sie die Gre des Diagramms auf Basis eines Attributes mit dem [Maximalwert suchen] Knopf und dem
Gre Men ein. Wenn die Diagramme auf dem Bildschirm zu klein erscheinen knnen Sie das
Kleine
Diagramme vergrern Kontrollkstchen aktivieren und die Minimalgre des Diagramms definieren.
9. Verndern Sie die Attributfarben indem Sie auf die Farbwerte im Zugewiesene Attribute Feld doppelklicken.
Figure_diagrams_2 zeigt eine Vorstellung von dem Ergebnis.
10. Klicken Sie schlielich auf [Ok].

Abbildung 12.36: Diagramm aus Temperaturdaten auf einer Karte dargestellt


Behalten Sie im Hinterkopf dass im Reiter Position eine Datendefinierte Position der Diagramme mglich ist. Sie
knnen hier Attribute verwenden um die Position des Diagramms zu definieren. Sie knnen auch eine mastabsabhngige Sichtbarkeit im Darstellung Reiter einstellen.
The size and the attributes can also be an expression. Use the
chapter for more information and example.

button to add an expression. See Expressions

12.3.10 Men Metadaten


Das Metadaten Men besteht aus Beschreibung, Beschreibung, Metadaten-URL und :guilabel:Eigenschaften Abschnitten.

12.3. Vektorlayereigenschaften

111

QGIS User Guide, Release 2.6

Im Abschnitt Eigenschaften erhalten Sie allgemeine Informationen ber den Layer, darunter Einzelheiten ber den
Typ und die Verortung, Anzahl der Objekte, Objekttyp und Bearbeitungsmglichkeiten. Die Ausdehnung Tabelle
zeigt Ihnen Layerausdehnungsinformationen und das Rumliches Bezugssystem des Layers Informationen ber
das CRS des Layers. Dies ist ein schneller Weg Informationen ber den Layer herauszufinden.
Zustzlich knnen Sie einen Titel und eine Zusammenfassung fr den Layer im Abschnitt Beschreibung hinzufgen oder bearbeiten. Es ist hier auerdem mglich eine :guilabel: Stichwortliste zu definieren. Diese Stichwortlisten knnen in einem Metadatenkatalog verwendet werden. Wenn Sie einen Titel aus einer XML Metadatendatei
verwenden wollen mssen Sie einen Link im DateURL Feld ausfllen. Verwenden Sie Beschreibung um Attributdaten aus einem XML-Metadatenkatalog zu erhalten. In Metadaten-URL knnen Sie den allgemeinen Pfad zum
XML-Metadatenkatalog definieren. Diese Information wird in der QGIS Projektdatei fr nachfolgende Sitzungen
gespeichert und wird fr QGIS Server verwendet.

Abbildung 12.37: Men Metadaten im Vektorlayer Eigenschaften Dialog


.

12.4 Expressions
The Expressions feature are available through the field calculator or the add a new column button in the attribut
table or the Field tab in the Layer properties ; through the graduaded, categorized and rule-based rendering in the
Style tab of the Layer properties ; through the expression-based labeling
in the
; through the feature selection and through the diagram tab of the Layer properties.

Labeling

core application

There are powerful way to manipulate attribute value in order to dynamicly change the final value in order to
change the geometry style, the content of the label, the value for diagram, select some feature or create virtual
column.

12.4.1 Functions List


The Function List contains functions as well as fields and values. View the help function in the Selected Function Help. In Expression you see the calculation expressions you create with the Function List. For the most

112

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

commonly used operators, see Operators.


In the Function List, click on Fields and Values to view all attributes of the attribute table to be searched. To add
an attribute to the Field calculator Expression field, double click its name in the Fields and Values list. Generally,
you can use the various fields, values and functions to construct the calculation expression, or you can just type it
into the box. To display the values of a field, you just right click on the appropriate field. You can choose between
Load top 10 unique values and Load all unique values. On the right side, the Field Values list opens with the
unique values. To add a value to the Field calculator Expression box, double click its name in the Field Values
list.
The Operators, Math, Conversions, String, Geometry and Record groups provide several functions. In Operators, you find mathematical operators. Look in Math for mathematical functions. The Conversions group contains
functions that convert one data type to another. The String group provides functions for data strings. In the Geometry group, you find functions for geometry objects. With Record group functions, you can add a numeration to
your data set. To add a function to the Field calculator Expression box, click on the > and then double click the
function.
Operators
This group contains operators (e.g., +, -, *).
a
a
a
a
a

+
*
/
%

b
b
b
b
b

a plus b
a minus b
a multiplied by b
a divided by b
a modulo b (for example, 7 % 2 = 1, or 2 fits into 7 three
times with remainder 1)
a ^ b
a power b (for example, 2^2=4 or 2^3=8)
a = b
a and b are equal
a > b
a is larger than b
a < b
a is smaller than b
a <> b
a and b are not equal
a != b
a and b are not equal
a <= b
a is less than or equal to b
a >= b
a is larger than or equal to b
a ~ b
a matches the regular expression b
+ a
positive sign
- a
negative value of a
||
joins two values together into a string Hello || world
LIKE
returns 1 if the string matches the supplied pattern
ILIKE
returns 1 if the string matches case-insensitive the supplied
pattern (ILIKE can be used instead of LIKE to make the match
case-insensitive)
IS
returns 1 if a is the same as b
OR
returns 1 when condition a or b is true
AND
returns 1 when condition a and b are true
NOT
returns 1 if a is not the same as b
column name "column name"
value of the field column name, take
care to not be confused with simple
quote, see below
string
a string value, take care to not be
confused with double quote, see above
NULL
null value
a IS NULL
a has no value
a IS NOT NULL
a has a value
a IN (value[,value])
a is below the values listed
a NOT IN (value[,value])
a is not below the values listed

Some example:
Joins a string and a value from a column name:

12.4. Expressions

113

QGIS User Guide, Release 2.6

My features id is: || "gid"

Test if the description attribute field starts with the Hello string in the value (note the position of the %
caracter):
"description" LIKE Hello%

Conditionals
This group contains functions to handle conditional checks in expressions.
CASE
CASE ELSE
coalesce
regexp_match

evaluates multiple expressions and returns a


result
evaluates multiple expressions and returns a
result
returns the first non-NULL value from the
expression list
returns true if any part of a string matches
the supplied regular expression

Some example:
Send back a value if the first condition is true, else another value:
CASE WHEN "software" LIKE %QGIS% THEN QGIS ELSE Other

Mathematical Functions
This group contains math functions (e.g., square root, sin and cos).
sqrt(a)
abs
sin(a)
cos(a)
tan(a)
asin(a)
acos(a)
atan(a)
atan2(y,x)

exp
ln
log10
log
round
rand

randf

max
min
clamp
scale_linear

114

square root of a
returns the absolute value of a number
sine of a
cosine of a
tangent of a
arcsin of a
arccos of a
arctan of a
arctan of y/x using the signs of the two
arguments to determine the quadrant of the
result
exponential of a value
value of the natural logarithm of the passed
expression
value of the base 10 logarithm of the passed
expression
value of the logarithm of the passed value
and base
round to number of decimal places
random integer within the range specified by
the minimum
and maximum argument (inclusive)
random float within the range specified by
the minimum
and maximum argument (inclusive)
largest value in a set of values
smallest value in a set of values
restricts an input value to a specified
range
transforms a given value from an input
domain to an output

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

range using linear interpolation


transforms a given value from an input
domain to an output
range using an exponential curve
rounds a number downwards
rounds a number upwards
pi as value for calculations

scale_exp

floor
ceil
$pi

Conversions
This group contains functions to convert one data type to another (e.g., string to integer, integer to string).
toint
toreal
tostring
todatetime
todate
totime
tointerval

converts a string to integer number


converts a string to real number
converts number to string
converts a string into Qt data time type
converts a string into Qt data type
converts a string into Qt time type
converts a string to an interval type (can be
used to take days, hours, months, etc. off a
date)

Date and Time Functions


This group contains functions for handling date and time data.
$now
age
year
month
week
day
hour
minute
second

current date and time


difference between two dates
extract the year part from a date, or the number of years from
an interval
extract the month part from a date, or the number of months
from an interval
extract the week number from a date, or the number of weeks
from an interval
extract the day from a date, or the number of days from an
interval
extract the hour from a datetime or time, or the number
of hours from an interval
extract the minute from a datetime or time, or the number
of minutes from an interval
extract the second from a datetime or time, or the number
of minutes from an interval

Some example:
Get the month and the year of today in the format 10/2014
month($now) || / || year($now)

String Functions
This group contains functions that operate on strings (e.g., that replace, convert to upper case).
lower
upper
title

trim

12.4. Expressions

convert string a to lower case


convert string a to upper case
converts all words of a string to title
case (all words lower case with leading
capital letter)
removes all leading and trailing white
space (spaces, tabs, etc.) from a string

115

QGIS User Guide, Release 2.6

wordwrap
length
replace
regexp_replace(a,this,that)
regexp_substr
substr(*a*,from,len)
concat
strpos
left
right
rpad
lpad
format
format_number

format_date

returns a string wrapped to a maximum/


minimum number of characters
length of string a
returns a string with the supplied string
replaced
returns a string with the supplied regular
expression replaced
returns the portion of a string which matches
a supplied regular expression
returns a part of a string
concatenates several strings to one
returns the index of a regular expression
in a string
returns a substring that contains the n
leftmost characters of the string
returns a substring that contains the n
rightmost characters of the string
returns a string with supplied width padded
using the fill character
returns a string with supplied width padded
using the fill character
formats a string using supplied arguments
returns a number formatted with the locale
separator for thousands (also truncates the
number to the number of supplied places)
formats a date type or string into a custom
string format

Color Functions
This group contains functions for manipulating colors.
color_rgb
color_rgba
ramp_color
color_hsl
color_hsla

color_hsv
color_hsva
color_cmyk
color_cmyka

returns a string representation of a color based on its


red, green, and blue components
returns a string representation of a color based on its
red, green, blue, and alpha (transparency) components
returns a string representing a color from a color ramp
returns a string representation of a color based on its
hue, saturation, and lightness attributes
returns a string representation of a color based on its
hue, saturation, lightness and alpha (transparency)
attributes
returns a string representation of a color based on its
hue, saturation, and value attributes
returns a string representation of a color based on its
hue, saturation, value and alpha (transparency) attributes
returns a string representation of a color based on its
cyan, magenta, yellow and black components
returns a string representation of a color based on its
cyan, magenta, yellow, black and alpha (transparency)
components

Geometry Functions
This group contains functions that operate on geometry objects (e.g., length, area).
$geometry
$area
$length

116

returns the geometry of the current feature (can be used


for processing with other functions)
returns the area size of the current feature
returns the length size of the current feature

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

$perimeter
$x
$y
xat
yat
xmin

xmax

ymin

ymax

geomFromWKT
geomFromGML
bbox
disjoint
intersects
touches
crosses
contains

overlaps

within
buffer

centroid
bounds

bounds_width

bounds_height

convexHull

difference
distance
intersection
symDifference
combine

12.4. Expressions

returns the perimeter length of the current feature


returns the x coordinate of the current feature
returns the y coordinate of the current feature
retrieves the nth x coordinate of the current feature.
n given as a parameter of the function
retrieves the nth y coordinate of the current feature.
n given as a parameter of the function
returns the minimum x coordinate of a geometry.
Calculations are in the Spatial Reference System of this
Geometry
returns the maximum x coordinate of a geometry.
Calculations are in the Spatial Reference System of this
Geometry
returns the minimum y coordinate of a geometry.
Calculations are in the Spatial Reference System of this
Geometry
returns the maximum y coordinate of a geometry.
Calculations are in the Spatial Reference System of this
Geometry
returns a geometry created from a well-known text (WKT)
representation
returns a geometry from a GML representation of geometry
returns 1 if the geometries do not share any space
together
returns 1 if the geometries spatially intersect
(share any portion of space) and 0 if they dont
returns 1 if the geometries have at least one point in
common, but their interiors do not intersect
returns 1 if the supplied geometries have some, but not
all, interior points in common
returns true if and only if no points of b lie in the
exterior of a, and at least one point of the interior
of b lies in the interior of a
returns 1 if the geometries share space, are of the
same dimension, but are not completely contained by
each other
returns 1 if geometry a is completely inside geometry b
returns a geometry that represents all points whose
distance from this geometry is less than or equal to
distance
returns the geometric center of a geometry
returns a geometry which represents the bounding box of
an input geometry. Calculations are in the Spatial
Reference System of this Geometry.
returns the width of the bounding box of a geometry.
Calculations are in the Spatial Reference System of
this Geometry.
returns the height of the bounding box of a geometry.
Calculations are in the Spatial Reference System of
this Geometry.
returns the convex hull of a geometry (this represents
the minimum convex geometry that encloses all geometries
within the set)
returns a geometry that represents that part of geometry
a that does not intersect with geometry b
returns the minimum distance (based on spatial ref)
between two geometries in projected units
returns a geometry that represents the shared portion
of geometry a and geometry b
returns a geometry that represents the portions of a and
b that do not intersect
returns the combination of geometry a and geometry b

117

QGIS User Guide, Release 2.6

union
geomToWKT

returns a geometry that represents the point set union of


the geometries
returns the well-known text (WKT) representation of the
geometry without SRID metadata

Record Functions
This group contains functions that operate on record identifiers.
$rownum
$id
$currentfeature

$scale
$uuid
getFeature
attribute
$map

returns the number of the current row


returns the feature id of the current row
returns the current feature being evaluated.
This can be used with the attribute function
to evaluate attribute values from the current
feature.
returns the current scale of the map canvas
generates a Universally Unique Identifier (UUID)
for each row. Each UUID is 38 characters long.
returns the first feature of a layer matching a
given attribute value.
returns the value of a specified attribute from
a feature.
returns the id of the current map item if the map
is being drawn in a composition, or "canvas" if
the map is being drawn within the main QGIS
window.

Fields and Values


Contains a list of fields from the layer. Sample values can also be accessed via right-click.
Select the field name from the list, then right-click to access a context menu with options to load sample values
from the selected field.
Fields name should be double-quoted. Values or string should be simple-quoted.
.

12.5 Editierfunktionen
QGIS untersttzt vielfltige Mglichkeiten OGR, SpatiaLite, PostGIS, MSSQL Spatial und Oracle Spatial Vektorlayer und -tabellen zu editieren.
Bemerkung: Die Vorgehensweise GRASS Layer zu bearbeiten ist anders - siehe Abschnitt Digitalisieren und
Editieren eines GRASS Vektorlayers fr Details.
Tipp: Zeitgleiches Editieren
Diese Version von QGIS kontrolliert nicht, ob noch jemand ein Objekt zur gleichen Zeit editiert wie Sie. Die
zuletzt schreibende Person gewinnt.

12.5.1 Einstellen der Fangtoleranz und des Suchradius


Bevor wir damit beginnen knnen Sttzpunkte zu editieren ist es sehr wichtig die Fangtoleranz und den Suchradius
fr Sttzpunkte festzulegen um Vektorlayergeometrien optimal editieren zu knnen.

118

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Fangtoleranz
Die Fangtoleranz ist der Abstand den QGIS verwendet um den nchstgelegenen Sttzpunkt bzw. das nchstgelegene Liniensegment zu suchen mit dem sie versuchen sich zu verbinden wenn sie einen neuen Sttzpunkt setzen
wollen oder einen bestehenden Sttzpunkt verschieben wollen. Wenn Sie sich nicht innerhalb der definierten Fangtoleranz befinden wird QGIS den Sttzpunkt dort lassen wo sich der Mauszeiger gerade befindet anstatt zu einem
bestehenden Sttzpunkt oder Liniensegment zu snappen. Die Fangtoleranz Einstellungen betreffen alle Werkzeuge
die mit Toleranz arbeiten.
1. A general, project-wide snapping tolerance can be defined by choosing Settings Options. On Mac, go
Preferences.... On Linux: Edit
Options. In the Digitizing tab, you can select between
to QGIS
to vertex, to segment or to vertex and segment as default snap mode. You can also define a default
snapping tolerance and a search radius for vertex edits. The tolerance can be set either in map units or in
pixels. The advantage of choosing pixels is that the snapping tolerance doesnt have to be changed after
zoom operations. In our small digitizing project (working with the Alaska dataset), we define the snapping
units in feet. Your results may vary, but something on the order of 300 ft at a scale of 1:10000 should be a
reasonable setting.
2. Eine layerbezogene Fangtoleranz kann unter Einstellungen (oder Datei ) Fangoptionen ... um den
Fangmodus und die Fangtoleranz auf Layerbasis zu ermglichen und anzupasssen definiert werden (siehe
figure_edit_1 ).
Beachten Sie dass dieses layerbasierte Fangen die globalen Fangoptionen im Men Digitalisieren berschreibt.
Also wenn Sie einen Layer bearbeiten wollen und dass seine Sttzpunkte zu einem anderen Layer snappen sollen,
dann aktivieren Sie das Fangen nur auf den zu snappenden Layer und verringern Sie die globale Fangtoleranz auf einen kleineren Wert. Darberhinaus wird das Fangen nicht mit einem Layer funktionieren der nicht im
Fangoptionen Dialog aktiviert ist, was unabhngig von der globalen Fangtoleranz funktioniert. Vergewissern Sie
sich also dass das Kontrollkstchen fr die Layer auf die Sie snappen wollen aktiviert ist.

Abbildung 12.38: Das Bearbeiten von Snappingoptionen auf Layerbasis

Suchradius
Der Suchradius ist der Abstand den QGIS verwendet um nach dem nchsten Sttzpunkt den Sie versuchen zu
verschieben wenn Sie auf die Karte klicken zu suchen. Wenn Sie sich nicht innerhalb des Suchradius befinden
wird QGIS keinen Sttzpunkt fr das Bearbeiten finden und auswhlen und dementsprechend wird eine lstige
Warnung auftauchen. Die Fangtoleranz und der Suchradius werden in Karteneinheiten oder Pixeln eingestellt so
dass Sie vielleicht experimentieren mssen um Sie passend einzustellen. Wenn Sie eine zu groe Toleranz angeben
snappt QGIS zum falschen Sttzpunkt, besonders wenn Sie es mit einer groen Anzahl von Sttzpunkten in kurzer
Distanz zu tun haben. Stellen Sie den Suchradius zu klein ein wird nichts zum Verschieben gefunden.

12.5. Editierfunktionen

119

QGIS User Guide, Release 2.6

Der Suchradius fr die Sttzpunktbearbeitung in Layereinheiten kann im Men Digitalisierung unter Einstellungen
Optionen definiert werden. An der gleichen Stellen wo Sie die allgemeine, projektweite Fangtoleranz
definieren.

12.5.2 Zoomen und Karte verschieben


Bevor Sie einen Layer editieren sollten Sie in den Bereich hineinzoomen, den Sie bearbeiten wollen. Dadurch
vermeiden Sie lange Wartezeiten, bis alle Sttzpunkte des Layers visualisiert werden.
Karte verschieben
Hineinzoomen
Hinauszoomen
und
/
Icons in der Werkzeugleiste knnen Sie auch
Neben den
mit dem Mausrad, der Leertaste und den Pfeiltasten navigieren.

Mit dem Mausrad im Kartenfenster zoomen und verschieben


Whrend des Digitalisierens knnen Sie das Mausrad zum Verschieben innerhalb des Hauptfensters drcken und
Sie knnen das Mausrad zum hinein- und hinauszoomen drehen. Zum Zoomen platzieren Sie den Mauscursor in
die Karte und rollen es vorwrts (von Ihnen weg) um hineinzuzoomen und rckwrts (zu Ihnen hin) um herauszuzoomen. Die Position des Mauscursors wird das Zentrum des Sie interessierenden Bereichs sein. Sie knnen das
Verhalten des Mausrad-Zooms anhand des Reiters Kartenwerkzeuge unter Einstellungen Optionen anpassen.
Den Layer mit den Pfeiltasten verschieben
Das Verschieben der Karte whrend des Digitalisierens ist mit den Pfeiltasten mglich. Platzieren Sie die Maus in
das Kartenfenster und klicken Sie auf die rechts-Pfeiltaste um nach Osten zu verschieben, auf die links-Pfeiltaste
um nach Westen zu verschieben, auf die Aufwrts-Pfeiltaste um nach Norden zu verschieben und die AbwrtsPfeiltaste um nach Sden zu verschieben.
Sie knnen auch die Leertaste verwenden um vorbergehend Mausbewegungen die die Karte verschieben
auszulsen. Die Bild hoch und Bild runter Tasten auf Ihrer Tastatur bewirken bei der Kartenanzeige
hinein- oder hinauszuzoomen ohne Ihre Digitalisiersitzung zu unterbrechen.

12.5.3 Topologisches Editieren


Abgesehen von der Einstellung des layerbasierten Fangmodus knnen im Men Einstellungen Fangoptionen...
(oder Datei Fangoptionen) auch topologische Funktionen aktiviert werden. Hier knnen Sie
Bearbeitung an definieren und/oder fr Polygonlayer knnen Sie die Spalte
eine berschneidung neuer Polygone vermeided.

Topologische

berschn. verm. aktivieren, die

Topologisches Editieren ermglichen


Topologische Bearbeitung an dient dem Bearbeiten und Aufrechterhalten von gemeinsamen GrenDie Option
zen in Polygonmosaiken. QGIS erkennt gemeinsame Grenzen in Polygonmosaiken so dass Sie einfach den
Sttzpunkt einmal verschieben mssen und QGIS dann die Aufgabe bernimmt die andere Grenze zu updaten.
berschneidung neuer Polygone vermeiden
Die zweite topologische Option in der
berschn. verm. Spalte, berschneidungen von neuen Polygonen vermeiden, verhindert ein berlappen in Polygonmosaiken. Es dient dazu aneinanderhngende Polygone schneller zu
digitalisieren. Wenn Sie bereits ein Polygon erstellt haben ist es mit dieser Option mglich das zweite zu digitalisieren, so dass beide sich berschneiden und QGIS schneidet dann das zweite Polygon gem der gemeinsamen
Grenze aus. Der Vorteil ist dass Sie nicht alle Sttzpunkte der gemeinsamen Grenze digitalisieren mssen.

120

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Fang auf Schnittpunkte aktivieren


Fang auf Schnittpunkte aktivieren dar. Sie knnen damit auf einen
Ein andere Mglichkeit stellt das
Schnittpunkt von Hintergrundlayern snappen selbst wenn es keinen Sttzpunkt auf dem Schnittpunkt gibt.

12.5.4 Einen vorhandenen Layer editieren


Standardmig ldt QGIS Vektorlayer im read-only Modus, um ungewolltes Editieren zu verhindern wenn Sie
versehentlich die Maus klicken. Ansonsten knnen aber alle Ebenen editiert werden, wenn es der Datenanbieter
erlaubt bzw. die Rechte entsprechend gesetzt sind.
In general, tools for editing vector layers are divided into a digitizing and an advanced digitizing toolbar, described in section Erweiterte Digitalisierung. You can select and unselect both under
View Toolbars . Using the basic digitizing tools, you can perform the following functions:
Icon
Funktion
Icon
Funktion
Aktuelle nderungen

Bearbeitungsstatus umschalten

Objekt hinzufgen: Punkt hinzufgen

Objekt hinzufgen: Linie hinzufgen

Objekt hinzufgen: Polygon hinzufgen

Objekt(e) verschieben

Knotenwerkzeug

Ausgewhltes Lschen

Ausgewhlte Objekte ausschneiden

Objekte kopieren

Objekte einfgen

Layernderungen speichern

Tabelle Bearbeiten: Funktionen der Werkzeugleiste Digitalisierung


Bearbeitungsstatus umschalten
Alle Editiersitzungen fangen mit dem Anwhlen der
Option an. Sie knnen dies im
Kontextmenu nach dem Rechtsklicken auf den Legendeneintrag fr einen vorhandenen Layer finden.

Alternativ knnen Sie den Bearbeitungsstatus umschalten Knopf aus der Digitalisierung Werkzeugleiste verwenden um den Bearbeitungsstatus ein- oder auszuschalten. Sobald der Layer im Bearbeitungsstatus ist, erscheinen
die Sttzpunkte als das von Ihnen gewhlte Sttzpunktsymbol und zustzlich werden die Digitalisier-Tools in der
Werkzeugleiste aktiv.
Tipp: Regelmiges Sichern der Daten
Denken Sie daran
derungen akzeptiert.

Layernderungen

regelmig zu speichern. Dies berprft auch dass Ihre Datenquelle alle n-

Objekte digitalisieren
Objekt hinzufgen
Danach knnen Sie mit den Icons
,
gleiste den Mauszeiger in den Digitalisiermodus bringen.

Objekt hinzufgen

oder

Objekt hinzufgen

in der Werkzeu-

Fr jedes Objekt wird erst die Geometrie digitalisiert und dann das Attribut hinzugefgt. Um eine Geometrie zu
digitalisieren, klicken Sie mit der linken Maustaste an eine gewnschte Stelle im Kartenfenster, um den ersten
Punkt zu erstellen.
Fr Linien und Polygone klicken Sie fr jeden weiteren Knotenpunkt wieder die linke Maustaste. Zum Beenden
klicken Sie irgendwo im Kartenfenster auf die rechte Maustaste, um anzuzeigen, dass die Geometrie ihres Objektes
fertig gestellt ist.
Das Attribute Fenster wird erscheinen in dem Sie Informationen fr das neue Objekt eingeben knnen. Figure_edit_2 zeigt die Eingabe von Attributen fr einen fiktiven neuen Fluss in Alaska. In dem Men Digitalisierung
unter Einstellungen Optionen knnen Sie auch
drcken und

Attributeingabeformular bei der Objekteerstellung unter-

Letzte Attributwerteingaben wiederverwenden aktivieren.

12.5. Editierfunktionen

121

QGIS User Guide, Release 2.6

Abbildung 12.39: Der Attributwertedialog nach dem Digitalisieren eines neuen Vektorobjekts

Mit dem

Objekt(e) verschieben

Icon in der Werkzeugleiste knnen Sie bestehende Objekte verschieben.

Tipp: Datentyp der Attribute


Beim Editieren werden die Attributtypen whrend der Dateneingabe berprft. Deswegen ist es nicht mglich
eine Zahl in eine Textspalte im Dialog Attribute oder andersherum einzugeben. Wenn Sie das tun mssen sollten
Sie die Attribute in einem zweiten Schritt innerhalb des Attributtabelle Dialogs bearbeiten.

Aktuelle nderungen
This feature allows the digitization of multiple layers. Choose
made in multiple layers. You also have the opportunity to

Save for Selected Layers to save all changes you


Rollback for Selected Layers, so that the digitization

may be withdrawn for all selected layers. If you want to stop editing the selected layers,
Layer(s) is an easy way.

Cancel for Selected

Die gleichen Funktionen sind fr das Bearbeiten aller Layer des Projektes zugngig.
Knotenwerkzeug
Fr Shapedatei basierte Layer genauso wie fr SpatialLite, PostgreSQL/Post GIS, MSSQL Spatial und Oracle SpaKnotenwerkzeug
tial Tabellen stellt das
Bearbeitungsmglichkeiten fr Sttzpunkte hnlich wie CAD Programme
zur Verfgung. Es ist mglich einfach mehrere Sttzpunkte auf einmal auszuwhlen und diese zu verschieben,
hinzuzufgen und alle zusammen zu lschen. Das Knotenwerkzeug funktioniert auch mit angeschalteter Spontan Reprojektion und untersttzt die topologische Bearbeitungsfunktion. Dieses Werkzeug ist, anders als andere
Werkzeuge in QGIS, nachhaltig, so dass wenn eine Operation durchgefhrt wird die Auswahl fr dieses Objekt
und Werkzeug aktiv bleibt. Wenn das Knotenwerkzeug nicht in der Lage ist Objekte zu finden wird eine Warnung
gezeigt.

Es ist wichtig die Eigenschaften unter menuselection:Einstellungen > Optionen Digitalisierung Suchraauf eine Zahl grer als Null (z.B. 10) einzustellen. Andernfalls ist QGIS nicht in der Lage
dius:
mitzuteilen welcher Sttzpunkt bearbeitet werden soll.

122

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Tipp: Sttzpunktmarken
Die aktuelle Version von QGIS untersttzt drei Arten von Sttzpunktmarkern:Teiltransparenter Kreis, Kreuz
Optionen aus dem Einstellungen Men, klicken
und Keine. Um den Markierungsstil zu ndern whlen Sie
Sie auf das Digitalisierung Men und whlen Sie den entsprechenden Eintrag.

Eine einfache bung


Knotenwerkzeug
Beginnen Sie, indem Sie das
aktivieren und dann ein Objekt selektieren. Rote Boxen erscheinen
an jedem Sttzpunkt des Objektes. Nun sind folgende Funktionen vorhanden.

Sttzpunkte auswhlen: Sie knnen Sttzpunkte auswhlen indem Sie nacheinander darauf klicken, indem
Sie auf eine Ecke klicken um die Sttzpunkte an beiden Ecken auszuwhlen oder indem Sie ein Rechteck
um einige Sttzpunkte klicken und ziehen. Wenn ein Sttzpunkt ausgewhlt ist ndert sich die Farbe zu
blau. Um der aktuellen Auswahl mehr Sttzpunkte hinzuzufgen halten Sie die Strg Taste beim Klicken
gedrckt. Halten Sie Strg oder Umschalt -Taste gedrckt wenn Sie Klicken um den Auswahlstatus der
Sttzpunkte umzuschalten (Sttzpunkte die gerade nicht selektiert sind werden wie immer ausgewhlt, aber
auch Sttzpunkte die schon ausgewhlt sind werden deselektiert).
Sttzpunkte hinzufgen: Um einen Sttzpunkt hinzuzufgen machen Sie einfach einen Doppleklick in der
Nhe einer Ecke und ein neuer Sttzpunkt erscheint auf der Ecke in der Nhe des Mauszeigers; deswegen
muss er wenn ntig noch verschoben werden.
Sttzpunkte lschen: Whlen Sie dazu Sttzpunkte aus, die gelscht werden sollen und klicken Sie dann
Knotenwerkzeug
nicht fr das Lschen eines vollstndigen
auf die Taste Entfernen. Beachten Sie dass das
Objekts benutzen knnen, QGIS stellt sicher dass die minimal erforderliche Anzahl von Sttzpunkten fr

das Objekt an dem Sie arbeiten erhalten bleibt. Um ein vollstndiges Objekt zu lschen mssen Sie das
Ausgewhltes lschen
Werkzeug benutzen.
Sttzpunkte verschieben:Whlen Sie alle Sttzpunkte aus, die verschoben werden sollen. Alle ausgewhlten Sttzpunkte werden in dieselbe Richtung wie der Mauspfeil verschoben. Wenn eine Fangtolerazt
eingestellt ist, knnen die Sttzpunkte zu dem nchstgelegenen Sttzpunkt oder Segment snappen.
Jede Vernderung die mit dem Knotenwerkzeug gemacht wurde ist als separater Eintrag im Rckgngig Dialog
eingetragen. Beachten Sie dass alle Operationen topologisches Bearbeiten untersttzen wenn dies eingeschaltet
ist. Spontanreprojektion wird auch untersttzt und das Knotenwerkzeug erstellt Tooltips um einen Sttzpunkt
ausfindig zu machen wenn man mit dem Mauszeiger darbergeht.
Objekte ausschneiden, kopieren und einfgen
Ausgewhlte Objekte knnen ausgeschnitten, kopiert und an andere Ebenen im aktuellen QGIS-Projekt bergeben
(eingefgt) werden, wenn sich der Ziellayer auch im Editiermodus befindet, indem Sie nach Auswahl des Ziellayers auf den Knopf

Bearbeitungsstatus umschalten

klicken.

Objekte knnen an externe Anwendungen als Text abgelegt werden. Dabei werden die Objekte im CSV-Format
dargestellt und die Geometriedaten im OGC Well-Know Text (WKT) Format.
In dieser Version von QGIS knnen jedoch Textobjekte von auen nicht in einen Layer innerhalb von QGIS eingefgt werden. Wann wrde dann die Kopieren und Einfgen Funktion zum Einsatz kmmen? Wie sich herausstellt
kann man mehr als einen Layer zur gleichen Zeit bearbeiten und Objekte zwischen Layern Kopieren/Einfgen.
Warum wrden wir das tun wollen? Sagen wir wir mssen an einem Layer arbeiten, brauchen davon aber nur einbis zwei Seen, nicht die gesamten 5.000 aus unserem big_lakes Layer. Wir knnen einen neuen Layer erstellen
und Kopieren/Einfgen verwenden um die erforderlichen Seen hineinzukopieren.
Als Beispiel werden wir einige Seen in einen neuen Layer kopieren:
1. Laden Sie den Layer, von dem Sie einige Objekte kopieren wollen (Quelle)
2. Laden oder erstellen Sie einen Layer, in den die kopierten Objekte eingefgt werden sollen (Ziel)

12.5. Editierfunktionen

123

QGIS User Guide, Release 2.6

3. Schalten Sie fr den Ziel Layer den Bearbeitungsstatus ein


4. Stellen Sie die Quelle aktiv, indem Sie es in der Legende anklicken
5. Benutzen Sie das

Einzelnes Objekt auswhlen

6. Klicken Sie auf das Icon

Werkzeug und whlen ein paar Objekte in der Quelle aus

Objekte kopieren

7. Stellen Sie das Ziel aktiv, indem Sie es in der Legende anklicken
8. Klicken Sie auf das Icon

Objekte einfgen

9. Beenden Sie den Bearbeitungsstatus fr beide Layer und speichern Sie das Ergebnis ab
Was passiert, wenn der Quell- und Ziellayer ein unterschiedliches Schema enthlt (Spaltennamen und -typen
unterscheiden sich)? QGIS verwendet die Eintrge, die gleich sind und ignoriert den Rest. Wenn es Ihnen egal
ist, ob die Attribute korrekt bernommen werden, dann ist es egal, wie Sie die Spaltennamen und -typen der
Attributtabelle erstellen. Wenn auch die Attributdaten korrekt bernommen werden sollen, dann stellen Sie sicher,
dass auch die Spaltennamen und -typen beider Layer zueinander passen.
Tipp: Deckungsgleichheit eingefgter Objekte
Wenn Ihre Quell- und Ziellayer die gleiche Projektion verwenden dann haben die eingefgten Objekte die identische Geometrie wie der Quellayer. Wenn der Ziellayer jedoch eine andere Projektion hat dann kann QGIS nicht
garantieren dass die Geometrie identisch ist. Dies ist einfach aus dem Grund so, dass sich kleine Rundungsfehler
ergeben wenn zwischen Projektionen konvertiert wird.

Ausgewhlte Objekte lschen


Einzelnes Objekt auswhlen
Wenn Sie ein ganzes Polygon lschen mchten, selektieren Sie es erst mit dem
Werkzeug.
Sie knnen dabei auch mehrere Objekte gleichzeitig auswhlen. Wenn Sie die Objekte ausgewhlt haben, klicken

Sie auf das Icon

Ausgewhltes lschen

Ausgewhlte Objekte ausschneiden


kann auch benutzt werden, um Objekte zu lschen. Die Objekte
Das Werkzeug
werden gelscht aber zustzlich noch im spatial clipboard abgelegt. In diesem Fall knnte man dann den letzten
Objekte einfgen
Schritt, falls ein Fehler unterlaufen ist, wieder rckgngig machen, indem wir auf das Werkzeug
drcken. Ausschneiden, kopieren und bergeben von Objekten funktioniert mit den gerade ausgewhlten Objekten
und knnen nach Bedarf kombiniert verwendet werden.

nderungen speichern
Wenn ein Layer im Bearbeitungsmodus ist behlt QGIS alle nderungen im Speicher. Aus diesem Grund werden
diese nicht umgehend der Datenquelle oder -platte bermittelt. Wenn Sie Bearbeitungen in dem aktuellen Layer
speichern wollen aber mit dem Bearbeiten fortfahren wollen ohne den Bearbeitungsmodus verlassen zu wollen
Layernderungen speichern
Bearbeitungsstatus umschalten
knnen Sie den
Knopf klicken. Wenn Sie den Editiermodus mit
aussschalten wollen werden Sie ebenfalls gefragrt ob Sie Ihre nderungen speichern oder verwerfen wollen.

Wenn die nderungen nicht gespeichert werden knnen (z.B. weil die Festplatte voll ist oder Attribute Werte
aufweisen, die auerhalb der Wertespanne liegen), bleiben die nderungen erstmal im QGIS Arbeitsspeicher.
Dies ermglicht es, nderungen vorzunehmen und dann nochmals die Daten zu speichern.
Tipp: Datenintegritt
Es ist immer gut ein Backup von Ihren Daten zu machen bevor Sie mit dem Bearbeiten starten. Whrend die
Autoren von QGIS sich bemhen die Integritt Ihrer Daten zu bewahren bieten wir keine Garantie in dieser
Hinsicht.

124

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

12.5.5 Erweiterte Digitalisierung


Icon

Funktion

Icon

Funktion

Rckgngig

Wiederholen

Objekt(e) drehen

Objekt vereinfachen

Ring hinzufgen

Teil hinzufgen

Ring fllen

Ring lschen

Teil lschen

Objekte berarbeiten

Linie versetzen

Objekte trennen

Teile zerlegen

Gewhlte Objekte verschmelzen

Attribute gewhlter Objekte vereinen

Punktsymbole drehen

Tabelle Erweiterte Digitalisierung: Werkzeugleiste Erweiterte Digitalisierung fr Vektorlayer


Rckgngig und Wiederholen
Rckgngig
Wiederholen
Mit dem
und
Werkzeug knnen Sie Vektorbearbeitungsoperationen rckgngig
machen oder wiederholen. Es gibt auch ein andockbares Bedienfeld das alle Operationen in der Rcknahme/Wiederholung History zeigt (siehe Figure_edit_3). Dieses Bedienfeld wird nicht standardmig angezeigt;
es kann kann angezeigt werden indem man auf die Werkzeugleiste klickt und das Rcknahme/Wiederholung Kontrollkstchen aktiviert. Rcknahme/Wiederholung ist auch dann noch aktiv wenn das Bedienfeld nicht angezeigt
wird.

Wenn Rckgngig gedrckt wird wird der Status aller Objekte und Attribute auf den Status bevor die
zurckgenommene Aktion durchgefhrt wurde zurckgesetzt. nderungen die keine normalen Vektorbearbeitungsoperationen sind (z.B. nderungen die durch ein Plugin durchgefhrt werden) knnen oder knnen nicht
rckgngig gemacht werden. Dies hngt davon ab wie die nderungen durchgefhrt werden.
Wenn Sie Rcknahme/Wiederholung verwenden wollen klicken Sie einfach auf eine Operation in der History; alle
Objekte werden dann auf den Stand vor der ausgewhlten Operation zurckgesetzt.
Objekt(e) drehen
Verwenden Sie

Objekt(e) drehen

um ein oder mehrere ausgewhlte Objekte in der Kartenansicht zu drehen. Sie

Objekt(e) drehen
mssen erst die Objekte auswhlen und dann das
Icon drcken. Der Zentroid des/der Objekte(s)
erscheint und wird zum Drehungsankerpunkt. Wenn Sie mehrere Objekte auswhlen liegt der Drehungsankerpunkt
im gemeinsamen Zentrum der Objekte. Drcken und ziehen Sie den linke Maustaste in die gewnschte Richtung
um die ausgewhlten Objekte zu drehen.

Es ist auch mglich einen benutzerdefinierten Drehungsankerpunkt, um den dann die ausgewhlten Objekte
Objekt(e) drehen
rotieren, zu erstellen. Whlen Sie die Objekte, die gedreht werden sollen und aktivieren Sie das
Werkzeug. Drcken und halten Sie den Strg Knopf und bewegen Sie den Mauszeiger (ohne die Maustaste zu
drcken) zu der Stelle wohin Sie den Rotationsanker verschieben wollen. Lassen Sie den Strg Knopf los wenn
der gewnschte Rotationsankerpunkt erreicht ist. Jetzt knnen Sie die Linke Maustaste in die gewnschte Richtung
drcken und ziehen um das/die ausgewhlte(n) Objekt(e) zu drehen.

12.5. Editierfunktionen

125

QGIS User Guide, Release 2.6

Abbildung 12.40: Rckgngig und Wiederholen von Digitalisierschritten

126

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Objekt vereinfachen

Simplify Feature
tool allows you to reduce the number of vertices of a feature, as long as the geometry
The
doesnt change and geometry type is not a multi geometry. First, select a feature. It will be highlighted by a red
rubber band and a slider will appear. Moving the slider, the red rubber band will change its shape to show how
the feature is being simplified. Click [OK] to store the new, simplified geometry. If a feature cannot be simplified
(e.g. multi-polygons), a message will appear.

Ring hinzufgen

Ring hinzufgen
erstellen. Das bedeutet, dass Sie innerhalb eines
Sie knnen Ring-Polygone mit dem Werkzeug
bestehenden Polygons weitere Polygone digitalisieren knnen. Diese erscheinen dann als Loch, so dass nur der
Zwischenraum des inneren und des ueren Polygons als Ring-Polygon brig bleibt.

Teil hinzufgen
Teil hinzufgen
einem ausgewhlten multipolygon Polygone hinzufgen. Das neue Teilpolygon
Sie knnen mit
muss auerhalb des ausgewhlten Multipolygons digitalisiert werden.

Ring fllen
Sie knnen die

Ring fllen

Funktion verwenden um gleichzeitig einen Ring in ein Polygon einzufgen und

dem Layer ein neues Objekt zuzufgen. So brauchen Sie nicht erst das
Objekt hinzufgen
Funktion benutzen.

Ring hinzufgen

Icon und dann die

Ring lschen

Ring lschen
Das Werkzeug
ermglicht es, Ringpolygone innerhalb eines existierenden Flche zu lschen. Das
Werkzeug funktioniert nur mit Polygonlayern und kann fr Polygon- und Multipolygon-Objekte benutzt werden.
Es findet keine Vernderung statt, wenn es auf den ueren Ring eines Polygons angewendet wird. Bevor Sie die
Sttzpunkte des Ringes selektieren, stellen Sie bitte die Fangtoleranz entsprechend ein.

Teil lschen

Teil lschen
Mit dem
Werkzeug knnen Teile eines Multi-Feature Objektes gelscht werden (z.B. ein Polygon
von einem Multipolygon Objekt lschen). Dabei wird der letzte Teil des Multi-Feature Objektes nicht gelscht.
Das Werkzeug funktioniert mit allen Multi-Feature Geometrien Punkte, Linien und Polygone. Bevor Sie die
Sttzpunkte des Teils selektieren, stellen Sie bitte die Fangtoleranz entsprechend ein.

Objekte berarbeiten
Objekt berarbeiten
Die Geometrien von Linien und Polygonen knnen mit dem Werkzeug
verndert werden. Dabei
ersetzt die gezogene Linie die originale Linie oder Flchenlinie eines Objektes von der ersten bis zur zweiten
berschneidung. Fr Polygone kann dies manchmal zu unerwnschten Resultaten fhren und ist vorwiegend
sinnvoll, wenn man nur kleinere Teile einer Flche ersetzen mchte und nicht fr eine vollstndige berarbeitung.
Dabei ist es fr die Vereinfachungslinie auch nicht erlaubt, mehrere Polygongrenzen zu berschneiden.

12.5. Editierfunktionen

127

QGIS User Guide, Release 2.6

Als Beispiel knnen Sie die Grenze eines Polygons mit diesem Tool bearbeiten. Klicken Sie als erstes in die
Flche des Polygons neben den Punkt wo Sie den neuen Sttzpunkt hinzufgen wollen. Dann berqueren Sie
die Grenze und fgen sie Sttzpunkte auerhalb des Polygons ein. Machen Sie einen Rechtsklick in die Flche
des Polygons zum Vervollstndigen. Das Werkzeug wird automatisch einen Knoten an der Stelle wo die neue
Linie die grenze kreuzt hinzufgen. Es ist auch mglich einen Teil der Polygonflche zu entfernen indem man
auerhalb des Polygons anfngt, Sttzpunkte innerhalb des Polygons hinzufgt und auerhalb des Ploygons mit
einem Rechtklick aufhrt.
Bemerkung: Das Objekte berarbeiten Werkzeug kann die Startposition eines Polygonringes oder einer
geschlossenen Linie verndern. Der Punkt, der zweimal abgebildet ist wird also nicht mehr der gleiche sein.
Dies mag kein Problem fr die meisten Anwendungen sein, sollte aber beachtet werden.

Linie versetzen
Offset Curve
The
tool creates parallel shifts of line layers. The tool can be applied to the edited layer (the geometries are modified) or also to background layers (in which case it creates copies of the lines / rings and adds them
to the the edited layer). It is thus ideally suited for the creation of distance line layers. The displacement is shown
at the bottom left of the taskbar.

To create a shift of a line layer, you must first go into editing mode and then select the feature. You can make
Offset Curve

the

Save Layer Edits

tool active and drag the cross to the desired distance. Your changes may then be saved with the

tool.

QGIS options dialog (Digitizing tab then Curve offset tools section) allows you to configure some parameters
like Join style, Quadrant segments, Miter limit.
Objekte trennen
Objekte knnen mit dem Werkzeug
Objekt, das Sie teilen wollen.

Objekt teilen

geteilt werden. Zeichnen Sie dazu einfach eine Linie durch das

Teile zerlegen
In QGIS 2.0 ist es jetzt mglich die Teile eines Multi-Part Features zu zerlegen so dass die Anzahl der Teile sich
erhht. Zeichnen Sie einfach eine Linie ber den Teil den Sie zerlegen wollen indem Sie dafr das
Icon verwenden.

Teile zerlegen

Gewhlte Objekte verschmelzen


Merge Selected Features
tool allows you to merge features that have common boundaries. A new dialog will
The
allow you to choose which value to choose between each selected features or select a fonction (Minimum, Maximum, Median, Sum, Skip Attribute) to use for each column.

Attribute gewhlter Objekte vereinen


Attribute gewhlter Objekte vereinen
Werkzeug knnen Sie Attribute von Objekten vereinen die gemeinsame
Mit dem
Grenzen und Attribute haben ohne Ihre Grenzen zu vereinen. Whlen Sie zuerst mehrere Objekte auf einmal aus.
Attribute gewhlter Objekte
Drcken Sie dann den
Knopf. Jetzt fragt Sie QGIS welche Attribute auf alle ausgewhlten
Objekte angewendet werden sollen. Im Ergebnis haben alle ausgewhlten Objekte die gleichen Attributeintrge.

128

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Punktsymbole drehen
Punktsymbole drehen
knnen Sie die Rotation von Punktsymbolen in der Kartenansicht verndern. Sie mssen
Mit
erst ein Drehungsfeld in der Attributtabelle des Punktlayers im Erweitert Men des Stil Men der Layereigenschaften definieren. Sie werden auch nach SVG Markierung gehen mssen und Datendefinierte Eigenschaften ...

whlen. Aktivieren Sie


inaktiv.

Winkel und whlen Sie Drehung als Feld. Ohne diese Einstellungen ist das Werkzeug

Abbildung 12.41: Drehen von Punktsymbolen


Um die Drehung zu ndern, whlen Sie einen Punkt im Kartenfenster aus und drehen diesen, indem Sie die linke
Maustaste gedrckt halten. Ein roter Pfeil mit dem Drehwinkel wird dann angezeigt (siehe Figure_edit_4). Wenn
Sie die linke Maustaste wieder loslassen, wird der neue Wert in der Attributtabelle aktualisiert.
Bemerkung: Wenn Sie zustzlich die Strg-Taste gedrckt halten, findet die Drehung in 15 Grad Schritten statt.

12.5.6 Neue Vektorlayer erstellen


Mit QGIS knnen Sie neue Shapedateilayer, neue SpatiaLite Layer und neue GPX Layer erstellen. Die Erstellung
eines neuen GRASS Layers wird durch das GRASS Plugin untersttzt. Bitte gehen Sie zu Abschnitt Einen neuen
GRASS Vektorlayer erstellen fr mehr Informationen ber das Erstellen von GRASS Vektorlayern.
Eine neue Shapedatei erstellen
Um einen neuen Shapelayer zum Bearbeiten zu erstellen whlen Sie Neu
Neuer Shapedateilayer ... aus
dem Layer Men. Der Neuer Vektorlayer Dialog wird dargestellt wie in Figure_edit_5 gezeigt. Whlen Sie den
Layertyp (Punkt, Linie oder Polygon) und das KBS (Koordinatenbezugssystem).
Beachten Sie dass QGIS noch nicht die Erstellung von 2.5D Objekten untersttzt (d.h. Objekte mit X,Y,Z Koordinaten).
Um die Erstellung des neuen Shapedateilayer zu vervollstndigen fgen Sie die gewnschten Attribute ein indem
Sie den [Der Attributliste hinzufgen] Knopf drcken und einen Namen und einen Typ fr das Attribut festlegen.
Eine erste id Spalte wird standardmig hinzugefgt, kann aber, falls nicht gewnscht, wieder gelscht werden.
Es werden nur Typ:Text
, Typ: Ganzzahl, Typ: Dezimalzahl und Typ: Datum Attribute untersttzt. Zustzlich
und gem des Attributtyps knnen Sie auch die Breite und Przision der neuen Attributspalte definieren. Sind Sie
einmal zufrieden mit den Attributen, klicken Sie [OK] und vergeben Sie einen Namen fr die Shapedatei. QGIS
wird dem Namen automatisch eine .shp Erweiterung hinzufgen. Ist der Layer einmal erstellt wird dieser der
Karte hinzugefgt und Sie knnen Ihn auf die gleiche Weise wie in Abschnitt Einen vorhandenen Layer editieren
bearbeiten.

12.5. Editierfunktionen

129

QGIS User Guide, Release 2.6

Abbildung 12.42: Neuer Vektorlayer Dialog

130

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Einen neuen SpatiaLite Layer erstellen


SpatiaLite Layer erstellen
Um einen neuen SpatiaLite Layer zum Bearbeiten zu erstellen whlen Sie Neu
... aus dem Layer Men. Der Neuer SpatiaLite Layer Dialog wird dargestellt wie in Figure_edit_6 beschrieben.

Abbildung 12.43: Neuer SpatiaLite-Layer Dialog


Der erste Schritt ist eine bestehende SpatiaLite Datenbank auszuwhlen oder eine neue SpatiaLite Datenbank
zu erstellen. Dies kann mit dem Suchen Knopf
auf der rechten Seite des Datenbankfeldes durchgefhrt
werden. Fgen Sie dann einen Namen fr den neuen Layer ein, definieren Sie den Layertyp und legen Sie das
Koordinatenbezugssystem mit [KBS angeben] fest. Falls gewnscht knnen Sie einen
tierenden Primrschlssel erzeugen.

automatisch inkremen-

Um eine Attributtabelle fr den neuen SpatiaLite Layer zu definieren fgen Sie die Namen der Attributspalten, die
Sie mit dem entsprechenden Spaltentyp erstellen wollen, ein und klicken Sie den [Der Attributliste hinzufgen]
Knopf. Sind Sie mit den Attributen zufrieden klicken Sie [OK]. QGIS wird automatisch den neuen Layer in die
Legende einfgen und Sie knnen diesen dann auf die gleiche Art und Weise bearbeiten wie in Abschnitt Einen
vorhandenen Layer editieren.
Mit dem DB Manager knnen Sie SpatiaLite Layer ausfhrlicher managen. Siehe DB Manager Plugin.

12.5. Editierfunktionen

131

QGIS User Guide, Release 2.6

Einen neuen GPX Layer erstellen


Um eine GPX-Datei zu laden, mssen Sie das GPS Plugin laden. Das Men Erweiterungen
verwalten und installieren ... ffnet den Erweiterungen Dialog . Aktivieren Sie das
lkstchen.

Erweiterungen

GPS Werkzeuge Kontrol-

Erstelle neuen GPX Layer im Layer Men. Im Neue


Wenn dieses Plugin geladen ist whlen Sie Neu
GPX-Datei speichern als ... Dialog knnen Sie auswhlen wo der neue GPX Layer gespeichert werden soll.

12.5.7 Mit Attributtabelle arbeiten


Die Attributtabelle stellt die Objekte eines ausgewhlten Layers dar. Jede Zeile in der Tabelle reprsentiert ein
Kartenobjekt und jede Spalte enthlt bestimmte Informationen ber das Objekt. Objekte in der Tabelle knnen
gesucht, ausgewhlt, verschoben oder sogar bearbeitet werden.
Um die Attributtabelle eines Vektorlayers zu ffnen machen Sie Ihn aktiv indem Sie auf ihn in der Legende
klicken. Dann whlen Sie aus dem Layer Men
auf einen Layer zu machen und

Attributtabelle ffnen. Es ist auch mglich einen Rechtsklick

Attributtabelle ffnen aus dem Drop-Down Men auszuwhlen und auf den

Attributtabelle ffnen Knopf in der Attribute Werkzeugleiste zu klicken.


Dies wird ein neues Fenster ffnen das die Attribute des Layers zeigt (figure_attributes_1). Die Anzahl der Objekte
und die Anzahl der gewhlten Objekte werden im Attributtabellentitel gezeigt.

Abbildung 12.44: Attributtabelle des regions Layer

132

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Objekte einer Attributtabelle abfragen


Jede selektierte Zeile in einer Attributtabelle reprsentiert alle Attribute eines Objektes in dem ausgewhlten
Layer. Die Attributtabelle zeigt alle Vernderungen bei einer Abfrage in der Attributtabelle im Kartenfenster und
umgekehrt. Eine neue Abfrage in der Attributtabelle verursacht also eine Vernderung der im Kartenfenster als
ausgewhlt dargestellten Objekte und eine im Kartenfenster genderte Auswahl von Objekten spiegelt sich durch
eine Vernderung der ausgwhlten Zeilen in der Attributtabelle wider.
Zeilen knnen ausgewhlt werden, indem Sie auf die Zeilennummer links neben der Zeile klicken. Mehrere
Zeilen knnen ausgewhlt werden, indem die Strg Taste whrend der Auswahl gedrckt wird.Eine kontinuierliche Auswahl ist mglich, indem Sie bei der Selektion die Umschalt Taste gedrckt halten, whrend Sie die
Zeilennummern auswhlen. Alle Zeilen zwischen der aktuell ausgewhlten Zeile und der Mauspfeilposition werden dadurch selektiert. Bewegt man den Mauszeiger in der Attributtabelle indem man in eine Zelle in der Tabelle
klickt ndert die Zeilenauswahl nicht. Verndert man die Auswahl im Kartenfenster bewegt sich der Mauszeiger
in der Attributtabelle nicht.
Jede Spalte kann sortiert werden, indem Sie auf die Kopfzeile klicken. Ein kleiner Pfeil zeigt die Sortierfolge an.
Wenn er nach unten zeigt, werden die Werte von oben nach unten absteigend angezeigt. Wenn der Pfeil nach oben
zeigt, werden die von oben nach unten aufsteigend angezeigt.
For a simple search by attributes on only one column, choose the Column filter from the menu in the bottom
left corner. Select the field (column) on which the search should be performed from the drop-down menu, and hit
the [Apply] button. Then, only the matching features are shown in the attribute table.
Objekte mit einem Ausdruck whlen

Um eine Auswahl zu treffen mssen Sie das


Objekte mit einem Ausdruck whlen

wenden. Mit

Icon oberhalb der Atributtabelle ver-

knnen Sie eine Untermenge einer Tabelle anhand einer Funktion-

Feldrechner
sliste, wie Sie im
vorhanden ist, definieren (siehe Feldrechner). Das Abfrageergebnis kann dann
als neuer Vektorlayer gespeichert werden. Wenn Sie zum Beispiel Regionen vom Typ borough aus der Datei
regions.shp der QGIS Beispieldaten finden wollen, mssen Sie das Felder und Werte Men ffnen und das
Feld, das Sie abfragen wollen, auswhlen. Doppelklicken Sie das Feld TYPE_2 und auch [Alle eindeutigen].
Whlen und doppelklicken Sie Borough in der Liste. Im Feld Ausdruck erscheint die folgende Abfrage:

"TYPE_2"

Borough

Hier knnen Sie auch Funktionsliste Letztes (Selection) verwenden um eine Auswahl zu treffen die Sie schon
einmal verwendet haben. Der Ausdruckseditor speichert die letzten 20 verwendeten Ausdrcke ab.
Die zutreffenden Zeilen werden ausgewhlt und die volle Anzahl zutreffender Zeilen erscheint dann in der
Titelleiste der Attributtabelle sowie in der Statusleiste des Hauptfensters. Wollen Sie eine Suche durchfhren,
die dann nur die gewhlten Objekte auf der Karte darstellt, verwenden Sie die Abfrageerstellung die in Kapitel
Abfrageeditor beschrieben wird.
Um nur ausgewhlte Objekte anzuzeigen verwenden Sie Alle gewhlten Objekte anzeigen aus dem Men links
unten.
Die anderen Knpfe im Kopf der Attributtabelle stellen die folgenden Funktionalitten zur Verfgung:

Bearbeitungsmodus umschalten
um einen einzelnen Wert zu bearbeiten und um die unten beschriebenen Funktionalitten zu ermglichen (auch mit Strg+E)

nderungen speichern

Alles abwhlen

Auswahl nach Oben

Auswahl umkehren

Ausgewhlte Zeilen in die Zwischenablage kopieren

Zu den gewhlten Zeilen zoomen

(auch mit Strg+S)

(auch mit Strg+U)


(auch mit Strg+T)
(auch mit Strg+R)

12.5. Editierfunktionen

(auch mit Strg+C)

(auch mit Strg+J)


133

QGIS User Guide, Release 2.6

Zu den gewhlten Zeilen verschieben

Gewhlte Objekte lschen

Neue Spalte

Spalte lschen

Feldrechner ffnen

(auch mit Strg+P)

(auch mit Strg+D)

fr PostGIS Layer und fr OGR Layer mit GDAL Version >=1.6 (auch mit Strg+W)
fr PostGIS Layer und fr OGR Layer mit GDAL Version >=1.9 (auch mit Strg+L)
(auch mit Strg+I)

Below these buttons is the Field Calculator bar, which allows calculations to be quickly applied attributes visible
in the table. This bar uses the same expressions as the

Field Calculator

(see Feldrechner).

Tipp: WKT Geometrie berspringen


Wenn Sie Attributdaten in externen Programmen (wie Excel) nutzen wollen verwenden Sie den
Ausgewhlte Zeilen in die Zwischenablage kopieren
Knopf. Sie knnen die Informationen ohne Vektorgeometrien kopieren wenn
Sie Einstellungen Optionen Datenquellen Men
tiveren.

Geometrie in WKT aus Attributtabelle kopieren deak-

Ausgewhlte Objekte als neuer Layer speichern


The selected features can be saved as any OGR-supported vector format and also transformed into another coordinate reference system (CRS). Just open the right mouse menu of the layer and click on Save as to define the name
of the output file, its format and CRS (see section Legende). To save the selection ensure that the
selected features is selected. It is also possible to specify OGR creation options within the dialog.

Save only

In neuen Layer einfgen


Objekte, die sich in der Zwischenablage befinden, knnen in einen neuen Layer eingefgt werden. Versetzen Sie
den Layer zuerst in den Bearbeitungsmodus. Whlen Sie einige Objekte aus, kopieren Sie sie in die Zwischenablage und fgen Sie sie unter Zuhilfenahme von Bearbeiten Objekte einfgen als und Neuer Vektorlayer oder
Neuer Memory-Vektorlayer ein.
Dieses gilt fr Objekte, die innerhalb von QGIS ausgewhlt und kopiert wurden und auch fr Objekte einer
anderen Quelle die als Well-Known Text (WKT) definiert wurden.
Arbeiten mit nicht rumlichen Attributtabellen
Mit QGIS knnen Sie auch nicht-rumliche Tabellen laden. Dies beinhaltet derzeit Tabellen die von OGR und
Delimited Text, sowie vom PostgreSQL, MSSQL and Oracle Provider untersttzt werden. Die Tabellen knnen
zum Nachschlagen benutzt werden oder nur um allgemein zu suchen und zu bearbeiten anhand der Tabellenansicht. Wenn Sie die Tabelle laden sehen Sie dies in der Legende. Sie kann mit dem
geffnet werden und ist dann editierbar wie jeder andere Attributtabelle.

Attributtabelle ffnen

Werkzeug

Sie knnen zum Beispiel Spalten von nicht-rumlichen Tabellen verwenden um Attributwerte oder eine Spanne
von Werten, die erlaubt ist, in einen bestimmten Vektorlayer whrend der Bearbeitung hinzugefgt zu werden
definieren. Sehen Sie sich das Bearbeitungselement genauer im Abschnitt Men Felder an, um mehr zu erfahren.

12.5.8 Ein-Zu-Mehrere-Beziehungen erstellen


Beziehungen sind eine Technik, die oft in Datenbanken zum Einsatz kommen. Das Konzept ist dass Objekte
(Zeilen) verschiedener Layer (Tabellen) zueinander gehren knnen.

134

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Als Beispiel nehmen wir einen Layer mit allen Regionen von Alaska (Polygon) in dem einige Attribute ber den
Namen und den Regionstyp sowie eine eindeutige ID (die als Primrschlssel eingesetzt wird) vorhanden sind.
Fremdschlssel
Dann erhalten Sie einen anderen Punktlayer oder Tabelle mit Informationen ber Flughfen die in den Regionen
liegen und wollen diese ebenfalls im Auge behalten. Wenn Sie diese dem Regionen Layer hinzufgen wollen
mssen Sie eine Eine-Zu-Mehrere-Beziehung anhand von Fremdschlsseln erstellen weil es in den meisten Regionen mehrere Flughfen gibt.

Abbildung 12.45: Die Region Alaska mit Flughfen


Zustzlich zu den bereits bestehenden Attributen in der Airport Attributtabelle wird ein anderes Feld fk_region
das als Fremdschlssel verwendet werden soll, eingefgt (wenn Sie eine Datenbank verwenden wrden Sie
wahrscheinlich dafr einen Constraint definieren).
Dieses Feld fk_region enthlt immer eine ID einer Region. Man kann es als Zeiger zu der Region, zu der es gehrt,
betrachten. Und sie knnen eine benutzerdefinierte Eingabemaske erstellen wobei QGIS sich um das Einrichten
kmmert. Es funktioniert mit verschiedenen Anbietern (so dass sie es mit Shape- und CSV-Dateien benutzen
knnen) und alles was Sie tun mssen ist QGIS die Beziehung zwischen Ihren Tabellen mitzuteilen.
Layer
QGIS unterscheidet nicht zwischen einer Tabelle und einem Vektorlayer. Grundstzlich gesehen ist ein Vektorlayer
eine Tabelle mit einer Geometrie. Sie knnen Ihre Tabelle also als Vektorlayer einfgen. Zu Demonstrationszwecken knnen Sie die region Shapedatei (mit Geometrien) und die airport CSV-Tabelle (ohne Geometrien) und
einen Fremdschlssel (fk_region) zu dem Layer region laden (eine typische Ein-Zu-Mehrere Beziehung).
Definition (Relation Manager)
Das erste was wir machen mssen ist QGIS ber die Beziehungen zwischen den Layern wissen lassen. Dies
wird in Einstellungen Projekteigenschaften gemacht. ffnen Sie das Beziehungen Men und klicken Sie auf
Beziehung hinzufgen.
Name wird als Titel verwendet. Es sollte eine lesbare Zeichenfolge sein, die beschreibt, wofr die
Beziehung verwendet werden soll. Wir werden ihn in diesem Fall einfach Airports nennen.
Referenzierender Layer ist der in dem der Fremdschlssel steht. In diesem Fall ist dies der airports Layer.

12.5. Editierfunktionen

135

QGIS User Guide, Release 2.6

Referenzierendes Feld zeigt an welches Feld auf den anderen Layer zeigt, also ist dies in diesem Fall
fk_region
Referenzierter Layer ist der mit dem Primrschlssel, auf den gezeigt wird, also ist dies in diesem Fall der
regions Layer
Referenziertes Feld ist der Primrschlssel des referenzierten Layers, also die ID.
ID wird fr interne Zwecke benutzt und muss eindeutig sein. Sie brauchen es vielleicht um benutzerdefinierte Eingabemasken zu erstellen sobald dies untersttzt wird. Wenn Sie es leer lassen wird
eines fr Sie erstellt aber Sie knnen auch selber eine zuweisen die einfacher zu handhaben ist.

Abbildung 12.46: Relation Manager

Formulare
Jetzt wo QGIS von der Beziehung weiss wird es dazu benutzt das Formular das es erstellt zu verbessern. Da
wir die Standard Formular Methode (autogenerated) nicht verndert haben, wird es Ihrem Formular einfach ein
neues Bearbeitungselement hinzufgen. Also lassen Sie uns einen Layer region in der Legende auswhlen und
das Objekte abfragen Werkzeug benutzen. Abhngig von Ihren Einstellungen ffnet sich das Formular entweder
direkt oder Sie mssen den Identifizieren Dialog unter Aktionen ffnen.
Wie Sie sehen knnen werden die dieser bestimmten region zugeordneten airports alle in einer Tabelle gezeigt.
Und es iknnen auerdem einige Knpfe benutzt werden. Lassen Sie uns einen kurzen Blick daruf werfen
Der
Knopf ist zum Umschalten des Bearbeitungsmodus da. Seien Sie sich dessen bewusst dass es den
Bearbeitungsmodus des airport Layers umschaltet, trotzdessen wir uns im Objektformular eines Objektes
aus dem region Layer befinden. Die Tabelle jedoch stellt Objekte des aiport Layer dar.
Der
Knopf wird dem airport Layer ein neues Objekt hinzufgen. Und es wird den neuen airport der
aktuellen region standardmig zuordnen.
Der

Knopf lscht den ausgewhlten airport dauerhaft.

Das
Symbol ffnet einen neuen Dialog in dem Sie jeden vorhandenen airport auswhlen knnen was
dann der aktuellen region zugewiesen wird. Dies kann ntzlich sein wenn Sie den airport aus Versehen
in der falschen region erstellt haben.

136

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Abbildung 12.47: identifikationsergebnis Dialog von regions mit Beziehung zu airports

Das
Symbol hebt die Verbindung zwischen dem ausgewhlten airport und der aktuellen region
wieder auf so dass dieser auf wirksame Art und Weise nicht mehr zugewiesen ist (der Fremdschlssel wird
auf NULL gesetzt).
Die zwei Knpfe rechts wechseln zwischen Tabellenansicht und Formularansicht wobei Sie bei der letzten
Einstellung alle airports in ihrer jeweiligen Form sehen knnen.
Wenn Sie an der airport Tabelle arbeiten steht ein neuer Typ von Bearbeitungselement zur Verfgung, mit dem
Sie das Objektformular der referenzierten region in das Objektformular der airports einbetten knnen. Es kann
verwendet werden wenn Sie die Layereigenschaften der airports Tabelle ffnen, zum Felder Men wechseln und
den Typ des Bearbeitungselements des Fremdschlssels fk_region auf Beziehungsreferenz ndern.
Wenn Sie jetzt einen Blick auf den Objektdialog werfen werden Sie sehen dass das Formular der region in das
airports Formular eingebettet ist und sogar eine Kombobox vorhanden ist mit dem der aktuelle airport zu einer
anderen region zugeordnet werden kann.

Abbildung 12.48: Objekte abfragen Dialog von airport mit Beziehung zu regions
.

12.6 Abfrageeditor
Mit der Abfrageerstellung knnen Sie eine Untermenge einer Tabelle definieren indem Sie eine SQL-hnliche
WHERE Klausel verwenden und das Ergbnis im Hauptfenster anzeigen lassen. Das Abfrageergebnis kann dann
als neuer Vektorlayer gespeichert werden.

12.6. Abfrageeditor

137

QGIS User Guide, Release 2.6

12.6.1 Abfrage
ffnen Sie die Abfrageerstellung indem Sie die Layereigenschaften ffnen und zum Allgemein Men wechseln. Klicken Sie unter Objektuntermenge auf den [Abfrageerstellung] Knopf um die Abfrageerstellung zu ffnen. Wenn Sie z.B. einen regions Layer mit einem TYPE_2 Feld haben knnten Sie nur die regions des
Typs borough in der Datenlieferanten spezifischer Filterausdruck Fenster der Abfrageerstellung auswhlen. Figure_attributes_2 zeigt ein Beispiel von der Abfrageerstellung die mit dem regions.shp Layer aus dem QGIS
Beispieldatensatz. Die Felder, Werte und Operatoren Bereiche helfen Ihnen die SQL-hnliche Abfrage zu erstellen.

Abbildung 12.49: Abfrageerstellung


Die Felder Liste enthlt alle Attributspalten der Attributtabelle die durchsucht werden soll. Um eine Attributspalte
dem SQL WHERE Klausel Feld hinzuzufgen machen Sie einen Doppelklick auf den Namen in der Felderliste.
Im Allgemeinen knnen Sie die diversen Felder, Werte und Operatoren verwenden um die Abfrage zu erstellen
oder Sie knnen Sie einfach in die SQL Box eingeben.
Die Werte Liste fhrt die Werte einer Attributtabelle auf. Um alle mglichen Werte eines Attribut aufzulisten
whlen Sie das Attribut in der Felderliste und klicken Sie den [Alle] Knopf. Um die ersten 25 eindeutigen Werte
der Attributspalte aufzulisten whlen Sie die Attributspalte in der Felderliste und klicken Sie den [Stichprobe]
Knopf. Um einen Wert dem SQL WHRERE Klausel Feld hinzuzufgen, machen Sie einen Doppelklick auf den
Namen in der Werteliste.
Der Operatoren Bereich enthlt alle verwendbaren Operatoren. Um einen Operator dem SQL WHERE Klausel
Feld hinzuzfgen klicken Sie den enstprechenden Knopf. Es stehen relationale Operatoren (=, >, ...) String
Vergleichsoperatoren (LIKE) und logische Operatoren (AND, OR, ...) zur Verfgung.

138

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

Der [Testen] Knopf zeigt ein Nachrichtenfenster mit der Anzahl von Objekten die auf die aktuelle Abfrage zutreffen, was ntzlich im Prozess der Abfrageerstellung ist. Der [Lschen] Knopf lscht den Text im SQL WHERE
Klausel Feld. Der [OK] Knopf schliet das Fenster und whlt die Objekte die auf die Abfrage zutreffen aus. Der
[Abbrechen] Knopf schliet das Fenster ohne die aktuelle Auswahl zu ndern.
QGIS treats the resulting subset acts as if it where the entire layer. For example if you applied the filter above for
Borough, you can not display, query, save or edit Ankorage, because that is a Manicpality and therefore not
part of the subset.
The only exception is that unless your layer is part of a database, using a subset will prevent you from editing the
layer.
.

12.7 Feldrechner
Field Calculator
button in the attribute table allows you to perform calculations on the basis of existing
The
attribute values or defined functions, for instance, to calculate length or area of geometry features. The results can
be written to a new attribute field, a virtual field, or they can be used to update values in an existing field.

Tipp: Virtual Fields


Virtual fields are not permanent and are not saved.
To make a field virtual it must be done when the field is made.
The field calculator is now available on any layer that supports edit. When you click on the field calculator icon
the dialog opens (see figure_attributes_3). If the layer is not in edit mode, a warning is displayed and using the
field calculator will cause the layer to be put in edit mode before the calculation is made.
The quick field calculation bar in top of the attribute table is only visible if the layer is editable.
In quick field calculation bar, you first select the existing field name then open the expression dialog to create your
expression or write it directly in the field then click on Update All button.
In the field calculator dialog, you first must select whether you want to only update selected features, create a new
attribute field where the results of the calculation will be added or update an existing field.
Wenn Sie sich entschlieen ein neues Feld hinzuzufgen, mssen Sie einen Feldnamen, einen Feldtyp (Ganzzahl,
Dezimalzahl, Text oder Datum), die Ausgabefeldbreite und die Genauigkeit eingeben (siehe figure_attributes_3).
Zum Beispiel wenn Sie ein Ausgabefeldbreite von 10 und eine Genauigkeit von 3 whlen, heit das, dass 6
Eintrge vor dem Komma stehen, dann das Komma und dann weitere 3 Eintrge fr die Genauigkeit.
Ein kurzes Beispiel zeigt wie der Feldrechner arbeitet. Wir wollen die Lnge des railroads Layers aus dem QGIS
Beispieldatensatz in km berechnen:
1. Laden Sie das Shape railroads.shp in QGIS und ffnen Sie die den Dialog

2. Klicken Sie auf

Bearbeitungsmodus umschalten

3. Whlen Sie das


ichern.

Neues Feld anlegen Kontrollkstchen um die Berechnungen in ein neues Feld zu spe-

und ffnen Sie den

Feldrechner

Attributtabelle ffnen

Dialog.

4. Setzen Sie laenge als Ausgabefeldname, real als Ausgabefeldtyp und definieren Sie die Ausgabefeldbreite mit 10 und die Ausgabefeldgenauigkeit mit 3.
5. Machen Sie jetzt einen Doppelklick auf die Funktion $length in der Geometrie Gruppe und fgen Sie sie
in die Ausdruck Box des Feldrechners ein.
6. Vervollstndigen Sie den Ausdruck indem Sie /1000 im Feldrechnerausdruckfenster und klicken Sie
[OK].
7. You can now find a new field length in the attribute table.
12.7. Feldrechner

139

QGIS User Guide, Release 2.6

Abbildung 12.50: Feldrechner

140

Kapitel 12. Arbeiten mit Vektordaten

QGIS User Guide, Release 2.6

The available functions are listed in Expressions chapter.


.

12.7. Feldrechner

141

QGIS User Guide, Release 2.6

142

Kapitel 12. Arbeiten mit Vektordaten

KAPITEL 13

Arbeiten mit Rasterdaten

13.1 Arbeiten mit Rasterdaten


Dieser Abschnitt beschreibt wie man Rasterlayereigenschaften visualisiert und einstellt. QGIS verwendet die
GDAL Bibliothek um Rasterdatenformate zu lesen und zu schreiben. Dies umfasst Arc/Info Binary Grid, Arc/Info
ASCII Grid, GeoTIFF, Erdas Imagine und viele weitere Formate. GRASS Rastersupport wird durch einen eigenen QGIS Datenprovider bereitgestellt. Die Rasterdaten knnen auch im Lesemodus aus zip und gzip Archiven in
QGIS geladen werden.
Zum Zeitpunkt der Erstellung diese Dokumentes werden mehr als 100 Rasterdatenformate von der GDALBibliothek untersttzt (siehe GDAL-SOFTWARE-SUITE Literatur und Internetreferenzen). Eine vollstndige
Liste ist unter http://www.gdal.org/formats_list.html. erhltlich.
Bemerkung: Einige der aufgelisteten Formate knnen auf ihrem Rechner aus unterschiedlichen Grnden nicht
untersttzt werden. Einige brauchen z.B. kommerzielle Bibliotheken oder die GDAL Installation auf Ihrem Rechner, wurde ohne die Untersttzung fr das entsprechende Format erstellt. Nur Formate, die getestet wurden, knnen
ausgewhlt werden, wenn Sie eine Rasterdatei in QGIS laden. Andere nicht getestete Formate knnen anhand des
[GDAL] Alle Dateien (*) Filter geladen werden.
Das Arbeiten mit GRASS Rasterdaten wird in Kapitel GRASS GIS Integration vorgestellt.

13.1.1 Was ist ein Rasterlayer?


Rasterlayer in QGIS sind Gitter aus diskreten Zellen oder Pixeln, die Objekte ber, auf oder unter der Erdoberflche beschreiben. Jede Zelle eines Rasters hat die gleiche Gre und ist meistens rechteckig (in QGIS ist dies
immer so). Typische Rasterlayer sind Fernerkungsdaten wie Luft- oder Satellitenbilddaten oder modellierte Daten
wie Hhenmodelle.
Im Gegensatz zu Vektorlayern haben Rasterlayer keine Verknpfung zu einer Attributtabelle mit Werten fr jede
Zelle. Sie sind anhand der Pixelauflsung und der x/y Koordinate eines Eckpixels des Rasterlayers geocodiert.
Dies ermglicht es QGIS die Daten korrekt im Kartenfenster zu positionieren.
QGIS liest die Projektionsinformationen innerhalb des Rasterlayers (e.g. GeoTiff) oder aus einem passenden
Worldfile um die Daten richtig darzustellen.

13.1.2 Rasterlayer in QGIS laden


Rasterlayer werden geladen indem man auf das
Layer

Rasterlayer hinzufgen

Icon klickt oder indem man die Option

Rasterlayer hinzufgen ... auswhlt. Es knnen mehrere Layer gleichzeitig geladen werden indem

143

QGIS User Guide, Release 2.6

man Strg oder Umschalt gedrckt hlt und auf mehrere Objekte im ffnen einer GDAL-Rasterdatenquelle
Dialog klicken.
Ist ein Rasterlayer in die Legende geladen knnen Sie auf den Layernamen mit der rechten Maustaste klicken
um layerspezifische Eigenschaften auszuwhlen oder zu aktivieren oder um einen Dialog zum Einstellen der
Rastereigenschaften des Layers zu ffnen.
Rechte-Maustaste Men fr Rasterlayer
Auf die Layerausdehnung zoomen
Auf besten Mastab zoomen (100%)
Auf aktuelle Ausdehung strecken
In der bersicht anzeigen
Entfernen
Kopieren
KBS fr Layer setzen
Layer-KBS dem Projekt zuweisen
Speichern als ...
Eigenschaften
Umbenennen
Stil kopieren
Neue Gruppe hinzufgen
Alles ausklappen
Alles zusammenfalten
Zeichenreihenfolge aktualisieren
.

13.2 Dialogfenster Rasterlayereigenschaften


Um die Eigenschaften eines Rasterlayers zu sehen oder einzustellen doppelklicken Sie auf den Layernamen in der
Legende oder rechtsklicken Sie auf den Layernamen und whlen Sie Eigenschaften aus dem Kontextmen. Dies
ffnet den Layereigenschaften Dialog (siehe figure_raster_1).
Es gibt mehrere Mens in diesem Dialog:
Allgemein
Stil
Transparenz
Pyramiden
Histogramm
Metadaten

144

Kapitel 13. Arbeiten mit Rasterdaten

QGIS User Guide, Release 2.6

Abbildung 13.1: Dialog Rasterlayereigenschaften

13.2.1 Men Allgemein


Layerinformation
Das Men Allgemein stellt grundlegende Informationen ber den ausgewhlten Rasterlayer dar, einschlielich der
Layerquelle, dem Anzeigenamen (der verndert werden kann) und der Anzahl von Spalten, Zeilen und LeerWerten
des Rasterlayers.
Koordinatenbezugssystem
Hier knnen Sie das Koordinatenbezugssystem (KBS) als PROJ.4 Text ablesen. Wenn diese Einstellung nicht
richtig ist knnen Sie Sie verndern indem Sie den Knopf [Angeben] klicken.
Mastabsabhngige Sichtbarkeit
Zustzlich kann eine skalenabhngige Sichtbarkeit eingestellt werden. Dazu muss das Kontrollkstchen aktiviert
sein und ein entsprechender Mastab, indem Ihre Daten im Kartenfenster dargestellt werden, eingetragen werden.
Unten knnen Sie einen Thumbnail, sein Legendensymbol und die Palette sehen.

13.2.2 Men Stil


Kanaldarstellung
QGIS bietet vier verschiedene Darstellungsart. Die ausgewhlte Darstellungsart hngt vom Datentyp ab.

13.2. Dialogfenster Rasterlayereigenschaften

145

QGIS User Guide, Release 2.6

1. Multikanalfarbe - wenn die Datei ein Multiband mit mehreren Kanlen ist (z.B. bei einem Satellitenbild mit
mehreren Bndern)
2. Palette - wenn ein Einkanalbild eine indizierte Palette besitzt (z.B. benutzt bei digitalen Topographischen
Karten)
3. Einkanalgraustufen - das Bild oder ein Kanal davon wird grau dargestellt; QGIS benutzt diese Darstellung
wenn die Datei weder Multibnder, noch eine indizierte Palette noch eine kontinuirliche Palette (z.B. in
einer Schummerungskarte benutzt) besitzt.
4. Einkanalpseudofarbe - diese Darstellung ist bei Dateien mit kontinuirlicher Palette oder Farbkarte (z.B. wie
sie in Hhenkarten verwendet wird) mglich
Multikanalfarbe
Mit der Darstellung Multikanalfarbe werden drei ausgewhlte Kanle des Bildes dargestellt, wobei jedes Band
due rote, grne oder blaue Komponente zum Erstellen eines Farbbildes darstellt.

Abbildung 13.2: Rasterdarstellung - Multikanalfarbe


Diese Auswahl bietet Ihnen ein breites Spektrum von Optionen zum Verndern des Erscheinungsbildes des Rasterlayers an. Zuerst mssen Sie den Datenbereich Ihres Bildes abrufen. Dieser kann durch das Whlen von Ausdehnung und das Klicken von [Laden] ermittelt werden. QGIS kann die Min und Max Werte der Kanle
Schtzen (schneller) oder die
Genau (langsamer) Genauigkeit verwenden.
Jetzt knnen Sie die Farben mit Hilfe des Min/Max Werte Bereichs skalieren. Viele Bilder haben ein paar sehr
tiefe und hohe Daten. Diese Ausreier knnen anhand der
Kommulativer Anzahlschnitt Einstellung beseitigt werden. Der voreingestellte Datenbereich ist auf 2% bis 98% der Datenwerte eingestellt und kann manuell
angepasst werden. Mit dieser Einstellung kann das graue Aussehen des Bildes verschwinden. Mit der Skalierungsoption
Min/max erstellt QGIS eine Farbtabelle von allen im Originalbild enthaltenen Daten (z.B. erstellt QGIS
eine Farbtabelle mit 256 Werten, vorausgesetzt Sie haben 8bit-Kanle). Sie knnen Ihre Farbtabelle auch mit der
Mittlere +/- Standardabweichung x
berechnen. Dann werden nur Werte innerhalb der Standardabweichung oder innerhalb mehrerer Standardabweichungen verwendet. Dies ist ntzlich wenn ein oder zwei Zellen
mit anormalen hohen Werten, die einen negativen Effekt auf die Darstellung des Rasterbildes haben, in einem
Grid auftauchen.
Alle Berechnungen knnen auch fr die

Aktuell Ausdehnung durchgefhrt werden.

Tipp: Einen einzelnen Kanal eines Mehrkanal-Rasterlayers anzeigen


Wenn Sie sich nur einen einzelnen Kanal eines Multikanalfarbe Bildes (z.B. Rot) ansehen wollen kommen Sie
vielleicht auf die Idee den Grn- und Blaukanal auf Nicht gesetzt einzustellen. Dies ist nicht der korrekte Weg.
Um den Rotkanal darzustellen stellen Sie den Bildtyp auf Einkanalgraustufen ein und whlen Sie dann Rot als
Kanal, der fr Grau benutzt werden soll, aus
146

Kapitel 13. Arbeiten mit Rasterdaten

QGIS User Guide, Release 2.6

Palette
Dies ist die voreingestellt Darstellungsart fr Singleband-Dateien die bereits eine Farbtabelle besitzen, wobei
jedem Pixel eine bestimmte Farbe zugewiesen wird. In diesem Fall wird die Palette automatisch dargestellt. Wenn
Sie die Farben, die einem bestimmten Wert zugewiesen werden, ndern wollen, Doppelklicken Sie auf die Farbe
und der Farbauswahl Dialog erscheint. Seit QGIS 2.2. ist es mglich dem Farbwert eine Beschriftung zuzuweisen.
Die Beschriftung erscheint dann in der Legende des Rasterlayers.

Abbildung 13.3: Rasterdarstellung - Palette


Kontrastverbesserung
Bemerkung: Wenn GRASS Rasterlayer hinzugefgt werden wird die Option Kontrastverbesserung immer
automatisch auf Strecken auf MinMax eingestellt, ungeachtet der Einstellungen in den QGIS Optionen.
Einkanalgraustufen
Mit dieser Darstellungsart knnen Sie ein Einkanalbild mit einem Farbverlauf darstellen: Schwarz nach Wei
oder Wei nach Schwarz. Sie knnen einen Min und einen Max Wert festlegen indem Sie erst Ausdehnung
auswhlen und dann [Laden] drcken. QGIS kann die Min und Max Werte der Kanle
Schtzen (schneller)
oder die
Genau (langsamer) Genauigkeit verwenden.
Im Extremwerte laden Abschnitt ist das Skalieren der Farbtabelle mglich. Ausreier knnen anhand der
Kommulativer Anzahlschnitt Einstellung beseitigt werden. Der voreingestellte Datenbereich ist von 2% bis 98%
der Datenwerte eingestellt und kann manuell angepasst werden. Mit dieser Einstellung kann der graue Charakter
Extrema und
Mittlere +/- Standardabweichung
des Bildes verschwinden. Weitere Einstellungen knnen mit
x
gemacht werden. Whrend die erste eine Farbtabelle mit allen Daten, die im Originalbild enthalten
sind, erstellt, erstellt die zweite eine Farbtabelle die nur Werte innerhalb der Standardabweichung oder mehrerer
Standardabweichungen bercksichtigt. Dies ist ntzlich wenn Sie eine oder zwei Zellen mit anormal hohen Werten
in einem Grid haben die einen negativen Einfluss auf die Darstellung des Rasterlayers haben.
Einkanalpseudofarbe
Dies ist eine Darstellungsoption fr Einkanaldateien die eine kontinuirliche Palette enthalten. Sie knnen hier auch
individuelle Karten fr die einzelnen Kanle erstellen. Es sind drei Typen von Farbinterpolation mglich:
1. Diskret
2. Linear
13.2. Dialogfenster Rasterlayereigenschaften

147

QGIS User Guide, Release 2.6

Abbildung 13.4: Rasterdarstellung - Einkanalgraustufen

Abbildung 13.5: Rasterdarstellung - Einkanalpseudofarbe

148

Kapitel 13. Arbeiten mit Rasterdaten

QGIS User Guide, Release 2.6

3. Genau
Im linken Block fgt der Knopf

Werte manuell hinzufgen

einen Wert zu der individuellen Farbtabelle hinzu. Der

Gewhlte Zeile lschen


Farbabbildungselemente
Knopf
lscht einen Wert aus der individuellen Farbtabelle und der
Knopf sortiert die Farbtabelle gem den Pixelwerten in der Wertespalte. Ein Doppelklick auf die Wertespalte
macht das Eingeben eines spezifischen Wertes mglich. Das Doppelklicken auf die Farbspalte ffnet den Dialog
Change color in dem Sie eine Farbe die auf den Wert angewendet werden soll auswhlen knnen. Des weiteren
knnen Sie auch Beschriftungen fr jede Farbe hinzufgen, allerdings wird dieser Wert nicht angezeigt wenn Sie
das Objekte abfragen Werkzeug benutzen. Sie knnen auch auf den Knopf mActionDraw| Farbabbildung aus Kanal laden
klicken welcher versucht die Tabelle aus dem Kanal zu laden (falls dieser eine hat). Und Sie knnen die Knpfe
Farbabbildung aus Datei laden
Farbabbildung in Datei speichern
oder
verwenden um eine bestehende Farbtabelle zu laden
oder eine definierte Farbtabelle fr andere Sitzungen zu speichern.

Im rechten Block wird Ihnen durch Neue Farbabbildung generieren das Erstellen von neuen kategorisierten FarGleiches Intervall mssen Sie nur die Anzahl der Klassen
bkarten ermglicht. Fr den Modus
auswhlen und den Knopf Klassifizieren drcken. Sie knnen die Farben der Farbkarte invertieren indem Sie auf
Invertieren Kontrollkstchen klicken. Im Fall des Modus
Fortlaufend erstellt QGIS automatisch
das
Klassen abhngig von Min und Max. Das Definieren von Extremwerten kann mit Hilfe des Extremwerte laden Abschnitts durchgefhrt werden. Viele Bilder haben einige wenige sehr tiefe und hohe Daten. Diese Ausreier knnen
anhand der
Kommulativer Anzahlschnitt Einstellung beseitigt werden. Der voreingestellte Datenbereich ist von
2% bis 98% der Datenwerte eingestellt und kann manuell angepasst werden. Anhand dieser Einstellung kann der
graue Charakter des Bildes verschwinden. Mit der Skalierungsoption
Extrema erstellt QGIS eine Farbtabelle
mit allen im Originalbild enthaltenen Daten (z.B. erstellt QGIS eine Farbtabelle mit 256 Werten, vorausgesetzt Sie
haben 8bit Kanle). Sie knnen Ihre Farbtabelle auch anhand der
Mittlere +/- Standardabweichung x
berechnen. Dann werden nur Werte innerhalb der Standardabweichung oder mehrerer Standardabweichungen fr
die Farbtabelle bercksichtigt.
Farbdarstellung
Fr jede Kanaldarstellung ist eine Farbdarstellung mglich.
Sie knnen auch spezielle Darstellungseffekte fr Ihre Rasterdatei(en) erreichen indem Sie Mischmodi verwenden
(siehe Vektorlayereigenschaften).
Weitere Einstellungen knnen durch das Verndern der Helligkeit, der Sttigung und des Kontrast gemacht
werden. Sie knnen auch eine Graustufen Option verwenden bei der Sie zwischen Nach Helligkeit, Nach
Leuchtkraft und Nach Durchschnitt whlen knnen. Fr einen Farbwert in der Farbtabelle knnen Sie die
Strke verndern.
Abtastung
Die Abtastung Option kommt zur Erscheinung wenn Sie in ein Bild herein- oder herauszoomen. Abtastungsmodi knnen die Erscheinung der Karte optimieren. Sie berechnen eine neue Grauwertmatrix anhand einer geometrischen Transformation.
Wenn Sie die Nchster Nachbar Methode anwenden kann die Karte eine pixelige Struktur bein Hineinzoomen
haben. Dieses Erscheinungsbild kann verbessert werden indem man die Bilinear oder Kubisch Methode verwendet, die scharfe Objekte verwischt. Der Effekt ist ein weicheres Bild. Diese Methode kann z.B. auf digitale
Topographische Karten angewendet werden.

13.2.3 Men Transparenz


QGIS besitzt die Fhigkeit jeden Rasterlayer auf einem unterschiedlichen Transparenzlevel darzustellen. Verwenden Sie den Transparenzschieberegler
um einzugeben bis zu welchem Ausma die darunterliegenden Layer (falls es welche gibt) sichtbar durch den aktuellen Rasterlayer sein sollen. Dies ist sehr ntzlich

13.2. Dialogfenster Rasterlayereigenschaften

149

QGIS User Guide, Release 2.6

Abbildung 13.6: Rasterdarstellung - Abtastung


wenn Sie mehr als einen Rasterlayer berlagern wollen (z.B. wenn eine Schummerungskarte von einer klassifizierten Rasterkarte berlagert werden soll). So wird die Karte dreidimensionaler aussehen.
Zustzlich knnen Sie einen Rasterwert eingeben der als Leerwert im Zustzlicher Leerwert Men behandelt
wird.
Die Transparenz kann noch flexibler ber die Transparente Pixelliste angepasst werden. Die Transparenz jedes
Pixels kann hier eingestellt werden.
Als Beispiel wollen wir die Wasserflchen aus dem Rasterlayer landcover.tif auf eine Transparenz von 20%
setzen. Folgende Schritte sind dazu notwendig:
1. Laden Sie die Rasterdatei landcover.tif.
2. ffnen Sie den Dialog Layereigenschaften indem Sie auf den Namen in der Legende doppelklicken, oder
im Rechte-Maustaste Men Eigenschaften auswhlen.
3. Whlen Sie das Men Transparenz.
4. Whlen Sie Keines aus dem Transparenzkanal Men.
5. Klicken Sie den

Werte manuell hinzufgen

Knopf. Eine neue Zeile erscheint in der Pixelliste.

6. Geben Sie den Rasterwert in die Von und Nach Spalte ein (wir benutzen hier 0) und passen Sie die
Transparenz auf 20% an.
7. Drcken Sie den Knopf [Anwenden] und schauen Sie sich das Ergebnis an.
Sie knnen Schritte 5 und 6 wiederholen um mehr Werte mit benutzerdefinierter Transparenz einzustellen.
Wie Sie sehen knnen ist es recht einfach die benutzerdefinierte Transparenz einzustellen, aber es kann ganz schn
viel Arbeit sein. Deswegen knnen Sie den Knopf
Datei zu speichern. Der Knopf
aktuellen Rasterlayer an.

Aus Datei importieren

In Datei exportieren

benutzen um Ihre Transparenzliste in eine

ldt Ihre Transparenzeinstellungen und wendet sie auf den

13.2.4 Men Pyramiden


Hochaufgelste Rasterlayer knnen das Navigieren in QGIS verlangsamen. Indem Sie kleiner aufgelste Kopien der Daten (Pyramiden) erstellen kann die Performanz erheblich verbessert werden, da QGIS die am besten
geeignete Auflsung fr den jeweiligen Zoomlevel auswhlt.
Sie brauchen dazu Schreibrecht in dem Ordner, in dem sich sie Originaldaten befinden.
150

Kapitel 13. Arbeiten mit Rasterdaten

QGIS User Guide, Release 2.6

Sie knnen mehrere Resampling-Methoden zum Berechnen der Pyramiden verwenden:


Nchster Nachbar
Durchschnitt
Gau
Kubisch
Modus
Keine
Wenn Sie Intern (wenn mglich) aus dem bersichtsformat Men whlen, versucht QGIS Pyramiden intern zu
erstellen. Sie knnen auch Extern und Extern (Erdas Imagine) whlen.

Abbildung 13.7: Das Men Pyramiden


Bitte beachten Sie dass das Erstellen von Pyramiden die Originaldatei verndern kann und sind sie erstmal erstellt
knnen Sie nicht entfernt werden. Wenn Sie eine nichtpyramidisierte Version Ihres Rasters erhalten wollen,
machen Sie eine Backupkopie vor dem Erstellen von Pyramiden.

13.2.5 Men Histogramm


Das Histogramm Men ermglicht es Ihnen die Verteilung der Kanle oder Farben in Ihrem Rasterlayer
anzuzeigen. Das Histogramm wird automatisch erzeugt wenn Sie das Histogramm Men ffnen. Alle bestehenden
Kanle werden zusammen dargestellt. Sie knnen das Histogramm als Bild mit dem

Knopf speichern. Mit der

Sichtbarkeit Option im
Prfs/Aktionen Men knnen Sie Histogramme der individuellen Kanle darstellen.
Sie werden die Option
Gewhlten Kanal anzeigen auswhlen mssen. Die Extrema-Optionen ermglichen
Ihnen Extrema-Markierungen immer anzeigen, Zu Extremen zoomen und Stile auf Extrema setzen. Mit der
Aktionen Option knnen Sie Zurcksetzen und Histogramm neuberechnen nachdem Sie die Extrema Optionen
gewhlt haben.

13.2. Dialogfenster Rasterlayereigenschaften

151

QGIS User Guide, Release 2.6

Abbildung 13.8: Rasterlayer Histogramm

13.2.6 Men Metadaten


Das Metadaten Men stellt eine Flle von Informationen ber den Rasterlayer dar, einschlielich Statistiken
ber jeden Kanal im aktuellen Rasterlayer. In diesem Men knnen Eintrge fr Beschreibung, Beschreibung,
Metadaten-URL und Eigenschaften gemacht werden. In Eigenschaften werden Statistiken nach dem Prinzip was
brauche ich erstellt, so dass es gut sein kann dass fr einen Rasterlayer noch keine Statistik erstellt oder gesammelt
wurde.

Abbildung 13.9: Rasterlayer Metadaten


.

13.3 Rasterrechner
The Raster Calculator in the Raster menu allows you to perform calculations on the basis of existing raster pixel
values (see figure_raster_10). The results are written to a new raster layer with a GDAL-supported format.

152

Kapitel 13. Arbeiten mit Rasterdaten

QGIS User Guide, Release 2.6

Abbildung 13.10: Rasterrechner


Die Rasterkanle Liste enthlt alle geladenen Rasterlayer die benutzt werden knnen. Um einen Rasterlayer
dem Rasterrechnerausdruck Feld hinzuzufgen, machen Sie einen Doppelklick auf seinen Namen in der Felder
Liste. Sie knnen dann die Operatoren zum konstruiren von Berechnungsausdrcken benutzen oder Sie geben Sie
einfach in die Box ein.
Im Abschnitt Ergebnislayer mssen Sie einen Ausgabelayer definieren. Sie knnen dann den Analysebereich auf
Grundlage eines Eingaberasters oder basierend auf Min/Max X und Y-Koordinaten bzw. mittels Spalten und Zeilen
angeben, um die Auflsung des Ausgabelayer festzulegen. Wenn die Eingabelayer eine abweichende Auflsung
besitzen, werden die Werte auf Basis des nearest neighbor Algorithmus resampelt.
Der Bereich Operatoren stellt Operatoren fr die Berechnungen bereit. Um einen Operator auszuwhlen, klicken
Sie auf die entsprechende Schaltflche. Es stehen mathematische Berechnungen (+, -, *, ... ) und trigonometrische
Funktionen (sin, cos, tan, ... ) zur Verfgung. Die Anzahl wird mit den nchsten Versionen sicherlich noch
wachsen!
Mit dem Aktivieren des Kontrollkstchens
Ergebnis zum Projekt hinzufgen wird der Ausgabelayer automatische der Legende hinzugefgt und kann somit visualisiert werden.

13.3.1 Beispiele
Hhenwerte von Meter zu Fu konvertieren
Fr das Erstellen eines Rasterlayers in Fu aus einem Rasterlayer in Metern mssen Sie den Konvertierungsfaktor
von Metern zu Fu benutzen: 3.28. Der Ausdruck lautet:
"elevation@1" * 3.28

Eine Maske verwenden


Wenn Sie Teile des Rasterlayers ausmaskieren wollen, weil Sie nur an Hhenwerten ber 0 Metern interessiert
sind, knnen Sie den folgenden Ausdruck zum Erstellen einer Maske und zum gleichzeitigen Anwenden auf den
13.3. Rasterrechner

153

QGIS User Guide, Release 2.6

Rasterlayer verwenden.
("elevation@1" >= 0) * "elevation@1"

Jede Zelle die grer oder gleich 0 ist wird auf den Wert 1 gesetzt, ansonsten lautet er 0. Dies erstellt die Maske
on-the-fly.
If you want to classify a raster say, for instance into two elevation classes, you can use the following expression
to create a raster with two values 1 and 2 in one step.
("elevation@1" < 50) * 1 + ("eleevation@1" >= 50) * 2

In other words, for every cell less than 50 set its value to 1. For every cell greater than or equal 50 set its value to
2.
.

154

Kapitel 13. Arbeiten mit Rasterdaten

KAPITEL 14

Arbeiten mit OGC Daten

14.1 QGIS als OGC Datenclient


Das Open Geospatial Consortium (OGC) ist eine internationale Organisation mit mehr als 300 Mitgliedern aus
kommerziellen, behrdlichen Bereichen, aus der Forschung sowie aus Non-Profit Organisationen Vereinen. Die
Mitglieder entwickeln und implementieren Standards fr den Austausch rumlicher Daten, GIS-Datenprocessing
und standardisierte Bereitstellung von Geodaten.
Zur Beschreibung von geographischen Objekten in einem einfachen Datenmodell wurden von OGC eine steigende
Zahl von Spezifikationen entwickelt, die spezielle Bedrfnisse der Interoperabilitt bedienen, rumliche Informationen und GIS einbezogen. Weitere Informationen knnen unter http://www.opengeospatial.org/ abgerufen
werden.
Wichtige von QGIS untersttzte OGC Spezifikationen sind:
WMS Web Map Service (WMS/WMTS Client)
WMTS Web Map Tile Service (WMS/WMTS Client)
WFS Web Feature Service (WFS und WFS-T Klient)
WFS-T Web Feature Service - Transactional (WFS und WFS-T Klient)
WCS Web Coverage Service (WCS Client)
SFS Simple Features for SQL (PostGIS Layer laden)
GML Geography Markup Language
OGC-Dienste werden vermehrt zum Austausch von geographischen Daten zwischen unterschiedlichen GISSystemen und -implementierungen verwendet. QGIS untersttzt mittlerweile die oben genannten Spezifikationen
als Client in Form von SFS (durch den Postgresql/PostGIS Datenprovider, vgl. PostGIS Layer laden).

14.1.1 WMS/WMTS Client


bersicht ber die WMS-Untersttzung
Derzeit kann QGIS als WMS-Klient eingesetzt werden. Es untersttzt die Versionen 1.1, 1.1.1 und 1.3 der WMSServer. Gut getestet wurden die ffentlich verfgbaren Server wie beispielsweise DEMIS.
WMS-Server liefern Daten aufgrund einer Anfrage eines Klienten (hier QGIS) als Rasterbild aus. Dabei spielen
Ausdehnung, Anzahl der angefragten Layer, Symbolisierungen und Transparenz eine Rolle. Der WMS-Server
holt die bentigten Daten dann aus seiner Datenquelle hervor, rendert diese in eine Rasterkarte und sendet das
fertige Bild zurck zum Klienten. Das fr QGIS typische Rasterformat ist in aller Regel JPEG oder PNG.

155

QGIS User Guide, Release 2.6

WMS ist ein mehr auf bertragung ausgelegter Dienst (REST = Representational State Transfer) als ein voll
funktionsfhiger Web Service. Daraus resultiert die Tatsache, dass die von QGIS generierte URL fr das Bild
auch in einem Browser eingesetzt werden kann. Das ist besonders hilfreich, wenn es beim Einsatz von WMS
Probleme geben sollte. Da es sehr viele unterschiedle WMS-Server-Anbieter am Markt gibt - und alle die WMSSpezifikation etwas unterschiedlich interpretieren - ist eine berprfung im Browser sehr hilfreich.
WMS-Layer knnen sehr einfach hinzugefgt werden, solange man die URL des Servers kennt, eine Verbindung
ber HTTP zu diesem Server besteht und der angefragte Server auch HTTP versteht.
berblick ber die WMTS Untersttzung
QGIS kann auch als WMTS Client fungieren. WMTS ist ein OGC Standard zum Bereitstellen von Tile Sets von
rumlichen Daten. Dies ist ein schnellerer und effizienterer Weg als die Bereitstellung ber einen WMS weil bei
WMTS die Tile Sets vorgeneriert werden und der Client nur die bermittlung von Tiles, nicht Ihre Erstellung
abfragt. Ein WMS beinhaltet typischerweise sowohl die Erstellung als auch die bermittlung der Daten. Ein
bekanntes Beispiel eines nicht-OGC Standards zum Darstellen von gekachelten rumlichen Daten ist Google
Maps.
Um die Daten in einer Vielzahl von Mastben je nach Anforderung darzustellen werden die WMTS Tile Sets in
mehreren verschiedenen Mastben erstellt und dem GIS Client zur Abfrage bereitgestellt.
Das Diagramm veranschaulicht das Konzept der Tile Sets:

Abbildung 14.1: Konzept der WMTS Tile Sets


Dei zwei Typen von WMTS Schnittstellen die QGIS untersttzt sind die ber Key-Value-Pairs (KVP) und RESTful. Diese zwei Schnittstellen sind unterschiedlich und Sie mssen diese fr QGIS unterschiedlich spezifizieren.
1) In order to access a WMTS KVP service, a QGIS user must open the WMS/WMTS interface and add the
following string to the URL of the WMTS tile service:
"?SERVICE=WMTS&REQUEST=GetCapabilities"

Ein Beispiel fr diesen Typ von Adresse ist


http://opencache.statkart.no/gatekeeper/gk/gk.open_wmts?\
service=WMTS&request=GetCapabilities

Zu Testzwecken funktioniert der topo2 Layer in diesem WMTS gut. Indem man diese Zeichenfolge hinzufgt gibt
man an dass ein WMTS Web Service anstatt eines WMS Service benutzt werden soll.
2. Der RESTful WMTS Service erfordert eine andere Form, eine einfache URL. Das von der OGC empfohlene Format ist:
{WMTSBaseURL}/1.0.0/WMTSCapabilities.xml

156

Kapitel 14. Arbeiten mit OGC Daten

QGIS User Guide, Release 2.6

Dieses Format hilft Ihnen zu erkennen dass dies eine RESTful Adresse ist. Eine RESTful WMTS
Verbindung wird in QGIS einfach durch das Verlinken seiner Adresse im WMS Setup im URL Feld
des Formulars erstellt. Ein Beispiel fr diesen Adresstyp im Fall der sterreichischen Grundkarte ist
http://maps.wien.gv.at/basemap/1.0.0/WMTSCapabilities.xml.
Bemerkung: Sie knnen immer noch alte Services die WMS-C genannt werden finden. Diese Services sind
denen von WMTS hnlich (z.B. der gleiche Zweck der dann ein bisschen anders funktioniert). Sie knnen Sie
genauso wie WMTS Services verwalten. Geben Sie einfach ?tiled=true am Ende der URL ein. Schlagen Sie
unter http://wiki.osgeo.org/wiki/Tile_Map_Service_Specification fr weitere Informationen zu diese Spezifikation
nach.
Wenn Sie WMTS lesen knnen Sie auch an WMS-C denken.

WMS/WMTS Server auswhlen


Wenn Sie das WMS Feature das erste Mal in QGIS verwenden sind keine Server definiert.
WMS/WMTS-Layer hinzufgen
Knopf in der Werkzeugleiste klicken oder indem Sie
Fangen Sie an indem Sie den
Layer WMS/WMTS-Layer hinzufgen ... whlen.

Der Dialog Layer eines WM(T)S-Servers hinzufgen erscheint dann. Sie knnen zum Ausprobieren aber einige
vordefinierte Server hinzufgen, indem Sie auf den Knopf [Vorgegebene Server ergnzen] klicken. Dadurch
werden Ihnen zwei WMS Demo Server zur Verfgung gestellt: die WMS Server der DM Solutions Group
und von Lizardtech. Um im Reiter Layer einen neuen WMS Server zu definieren whlen Sie [Neu]. Geben
Sie dann die Parameter die zur Verbindung bentig werden, ein, so wie es in table_OGC_1 aufgelistet ist:
Name
Ein Name fr diese Verbindung. Dieser Name wird in der Serververbindungs
Dropdown Box verwendet und kann diese dann von anderen WMS Servern
unterscheiden.
URL
URL des Servers der die Daten bereitstellt. Dies muss ein auflsbarer
Hostname sein- das gleiche Format das Sie auch benutzen wrden um eine
Telnetverbindung zu ffnen oder einen Ping an einen Host zu senden.
Benutzername
Benutzername um einen abgesicherten WMS Server anzubinden. Dieser
Parameter ist optional.
Passwort
Passwort fr einen grundlegend authentifizierten WMS Server. Dieser
Parameter ist optional.
Gemeldete GetMap-URI
aus Diensteigenschaften
ignorieren

Gemeldete GetMap/GetTile-URI aus Diensteigenschaften ignorieren.


Verwenden Sie die vorgegebene URI aus dem URL Feld oben.

Gemeldete
GetFeatureInfo-URI
ignorieren

Gemeldete GetFeatureInfo-URI ignorieren. Verwenden Sie die


vorgegebene URI aus dem URL Feld oben.

Tabelle OGC 1: WMS Verbindungs-Parameter


Wenn Sie einen Poxyserver, um WMS Services aus dem Internet empfangen zu knnen, aufsetzen mssen knnen
Sie Ihren Proxyserver in den Optionen hinzufgen. Whlen Sie Einstellungen Optionen und klicken Sie auf das
Men Netzwerk. Dort knnen sie Ihre Proxyeinstellungen hinzufgen und diese aktivieren indem Sie das Kontrollkstchen

Proxy fr Webzugriff benutzen aktivieren. Vergewissern Sie sich dass Sie den richtigen Proxytyp aus

dem Proxytyp

Dropdownmen ausgewhlt haben

Ist erst einmal eine WMS Serververbindung erstellt worden bleibt dieser fr kommende QGIS Sitzungen erhalten.
Tipp: WMS-Server-URLs
Vergewissern Sie sich beim Eingeben der WMS Server URL dass Sie nur die einfache URL eingeben. Zum
Beispiel sollten keine Fragmente wie request=GetCapabilities oder version=1.0.0 enthalten sein.

14.1. QGIS als OGC Datenclient

157

QGIS User Guide, Release 2.6

WMS/WMTS Layer laden


Nachdem Sie erfolgreich Ihre Paramerter eingetragen haben knnen Sie den [Verbinden] Knopf zum abrufen
der Fhigkeiten des ausgewhlten Servers verwenden. Dies beinhaltet die Bildkodierung, Layerstile und Projektionen. Da dies eine Netzwerkoperation ist hngt die Schnellingkeit der Antwort von der Qualitt Ihrer Netzwerkverbindung zum WMS Server ab. Whrend Daten vom WMS Server heruntergeladen werden wird der Downloadfortschritt links unten im WMS Dialog visualisiert.
Ihr Bildschirm sollte in etwa so wie der in Abbildung figure_OGR_1 aussehen wie die Ausgabe durch den DM
Solutions Group Server.

Abbildung 14.2: Dialog zum Hinzufgen eines WMS Servers bei dem die erhltlichen Layer gezeigt werden
Bildkodierung
Der Bildkodierung Bereich listet die Formate die sowohl vom Client als auch vom Server untersttzt werden auf.
Whlen Sie eines abhngig von Ihren Anforderungen an die Bildqualitt aus.
Tipp: Bildkodierung
In der Regel bieten WMS-Server JPEG oder PNG als Bildkodierung an. JPEG hat eine bildverschlechternde
Kompression, whrend PNG zumeist die Qualitt der ursprnglichen Rasterdaten widerspiegelt.
Verwenden Sie JPEG wenn Sie damit rechnen das die WMS Daten photographischen Charakter haben und/oder
Sie ein Verlust an Bildqualitt nicht strt. Dieser Kompromiss reduziert typischerweise die Datentransferbedingungen um das fnffache verglichen mit PNG.
Verwenden Sie PNG wenn Sie eine genaue Wiedergabe der Originaldaten erzielen wollen und die erhhten Datentransferbedingungen Sie nicht stren.

158

Kapitel 14. Arbeiten mit OGC Daten

QGIS User Guide, Release 2.6

Optionen
Der Optionen Bereich des Dialogs stellt ein Textfeld zur Verfgung in das Sie einen Layernamen fr den WMS
Layer hinzufgen knnen. Dieser Name wird nach dem Laden in der Legende erscheinen.
Unter dem Layernamen knnen Sie wenn Sie den WMS Request in mehrere Requests aufsplitten wollen die
Kachelgre (z.B. 256x256) definieren.
Die Objektbegrenzung fr GetFeatureInfo legt fest welche Attributspalten vom Server abgefragt werden.
Wenn Sie einen WMS aus der Liste whlen erscheint ein Feld mit der Standardprojektion, die vom Mapserver
bereitgestellt wird. Ist der [ndern ...] Knopf aktiv knnen Sie darauf klicken und die Standardprojektion des
WMS in ein anderes vom WMS Server bereitgestelltes KBS ndern.
Layerreihenfolge
Der Reiter Layerreihenfolge listet die vom gerade verbundenen WMS Server ausgewhlten Layer auf. Sie stellen
vielleicht fest dass einige Layer ausklappbar sind. Das bedeutet dass der Layer in einer Auswahl von Bildstilen
dargestellt werden kann.
Sie knnen mehrere Layer auf einmal auswhlen aber nur einen Bildstil pro Layer. Wenn mehrere Layer ausgewhlt sind werden Sie am WMS Server kombiniert und in einem Rutsch an QGIS weitergegeben.
Tipp: WMS Layer anordnen
Von einem Server dargestellte WMS Layer werden in der Reihenfolge aus dem Abschnitt Layers von oben bis
unten berlagert. Wenn Sie die Layerreihenfolge ndern wollen knnen Sie den Reiter Layerreihenfolge benutzen.
Transparenz
In dieser Version von QGIS ist die Einstellung Globale Transparenz aus dem Men Layereigenschaften immer
gem den Layereigenschaften eingestellt.
Tipp: Transparenz von WMS-Layern
Die WMS Bildtransparenz steht Ihnen abhnig von der Bildkodierung zur Verfgung: PNG und GIF untersttzen
Transparenz whrenddessen JPEG keine Unterstzung bietet.
Koordinatenbezugsystem
Koordinatenbezugssystem (KBS) ist die Bezeichnung des OGC fr eine Projektion in QGIS.
Jeder WMS Layer kann abhngig von den Fhigkeiten des WMS in mehreren KBS dargestellt werden.
Um ein KBS auszuwhlen whlen Sie [ndern ...] und ein Dialog hnlich wie Figure Projection 3 aus Arbeiten
mit Projektionen erscheint. Der hauptschliche Unterschied der WMS-Version ist dass nur die KBS, die vom
WMS Server untersttzt werden, gezeigt werden.
Serversuche
In QGIS knnen Sie WMS-Server suchen. Figure_OGC_2 zeigt den Reiter Serversuche mit dem Dialog Layer
eines WM(T)S-Servers hinzufgen.
Wie Sie sehen knnen ist es mglich ein Suchwort in das Textfeld einzugeben und den [Suchen] Knopf zu bettigen. Nach kurzer Zeit werden dann die Ergebnisse aufgelistet. Gehen Sie die Ergebnisliste durch und berprfen
Sie die Suchergebnisse in der Tabelle. Um ein Ergebnis zu visualisieren suchen Sie einen Tabelleneintrag aus,
drcken Sie auf den [Gewhlte Zeile der WMS-Liste hinzufgen] Knopf und gehen Sie zurck zum Reiter
Layer. QGIS hat Ihre Serverliste automatisch aktualisiert und das ausgewhlte Suchergebnis ist bereits ausfhrbar
in der Liste der gespeicherten WMS-Server im Reiter Layer gemacht. Sie brauchen die Layerliste nur mit dem
Knopf [Verbinden] abfragen. Diese Option ist sehr praktisch wenn Sie Karten anhand bestimmter Schlsselworte
suchen wollen.
Diese Suchfunktion ist ein Frontend zur API von http://geopole.org.

14.1. QGIS als OGC Datenclient

159

QGIS User Guide, Release 2.6

Abbildung 14.3: Dialog zum Suchen von WMS Servern nach einigen Stichwrtern
Tilesets
Wenn Sie WMTS (gecachte WMS) Dienste verwenden wie
http://opencache.statkart.no/gatekeeper/gk/gk.open_wmts?\
service=WMTS&request=GetCapabilities

sind Sie in der Lage den Tilesets Reiter, der vom Server bereitgestellt wird, zu durchsuchen. Zustzliche Informationen wie Kachelgre, Formate und untersttzte KBS werden in der Tabelle aufgelistet. In Kombination
mit diesen Funktionalitten knnen Sie den Kachelmastabschieberegler verwenden indem Sie Einstellungen
Bedienfelder (KDE und Windows) oder Ansicht Bedienfelder (Gnome und MacOSX) auswhlen und dann
Kachelmastab aussuchen. Dadurch werden die erhltlichen Mastbe vom Kachelserver in einem netten angedockten Schieberegler zugngig gemacht.
Das Objekte abfragen Werkzeug
Nachdem Sie einen Layer von einem WMS-Server geladen haben, knnen Sie die Layer mit dem Werkzeug
abfragen, sofern der WMS-Server diese Funktion untersttzt. Ein Klick auf einen Pixel stellt dann
eine Abfrage an den WMS-Server fr diesen Pixel. Das Ergebnis wird in Textform geliefert. Die Formatierung
hngt von dem jeweilig verwendeten WMS-Server ab. Formatauswahl
Objekte Abfragen

Wenn durch den Server mehrere Formate untersttzt werden wird dem Objekte abfragen Dialog automatisch eine
Kombobox mit den untersttzten Formaten hinzugefgt und das ausgewhlte Format kann im Projekt fr den
Layer gespeichert werden. GML Formatuntersttzung
Objekte abfragen
Das
Werkzeug untersttzt WMS Server Response (GetFeatureInfo) im GML Format (es wird
Feature in der QGIS GUI in diesem Zusammenhang genannt). Wenn das Feature Format vom Server untersttzt
wird und ausgewhlt ist, sind die Ergebnisse des Objekte abfragen Werkzeugs Vektorobjekte, wie bei einem normalen Vektorlayer. Wenn ein einzelnes Objekt im Baum ausgewhlt wird wird es in der Karte hervorgehoben und

160

Kapitel 14. Arbeiten mit OGC Daten

QGIS User Guide, Release 2.6

kann in die Zwischenablage kopiert werden und in einen anderen Vektorlayer eingefgt werden. Sehen Sie sich
fr die Unterstzung von GetFeatureInfo im GML Format das Beispielsetup des UMN Mapservers unten an.
# in layer METADATA add which fields should be included and define geometry (example):
"gml_include_items"
"ows_geometries"
"ows_mygeom_type"

"all"
"mygeom"
"polygon"

# Then there are two possibilities/formats available, see a) and b):


# a) basic (output is generated by Mapserver and does not contain XSD)
# in WEB METADATA define formats (example):
"wms_getfeatureinfo_formatlist" "application/vnd.ogc.gml,text/html"
# b) using OGR (output is generated by OGR, it is send as multipart and contains XSD)
# in MAP define OUTPUTFORMAT (example):
OUTPUTFORMAT
NAME "OGRGML"
MIMETYPE "ogr/gml"
DRIVER "OGR/GML"
FORMATOPTION "FORM=multipart"
END
# in WEB METADATA define formats (example):
"wms_getfeatureinfo_formatlist" "OGRGML,text/html"

Eigenschaften
Nachdem Sie einen WMS Server hinzugefgt haben knnen Sie sich seine Eigenschaften mit einem Rechtsklick
in der Legende und dem Auswhlen von Eigenschaften ansehen. Reiter Metadaten
Der Reiter Metadaten im Kontextmen zeigt eine Vielzahl von Informationen ber den WMS-Server. Diese Infos
sind dem Capabilities-Dokument des Servers entnommen. Viele Definitionen knnen reduziert werden indem
man den WMS Standard liest (siehe OPEN-GEOSPATIAL-CONSORTIUM Literatur und Internetreferenzen),
hier sind dazu einige praktische Definitionen:
Servereigenschaften
WMS Version Die WMS-Version, die vom Server untersttzt wird.
Bildformate - Die Liste MIME-Typen mit denen der Server reagieren kann wenn er die Karte zeichnet.
QGIS unterstzt die Formate mit denen die Qt Bibliotheken gebaut worden sind, was typischerweise
wenigstens image/png und image/jpeg sind.
Abfrageformate Eine Liste der MIME-Typen mit denen der Server auf Pixel-Abfragen antworten
kann. Derzeit wird von QGIS nur der Typ text-plain untersttzt.
Layereigenschaften
Ausgewhlt Gibt an, ob dieser Layer whrend des Hinzufgens des Server ausgewhlt war.
Sichtbar Gibt an, ob der Layer in der Legende angezeigt wird oder nicht (noch nicht verwendet in
der aktuellen Version von QGIS).
Kann abfragen Gibt an, ob der Layer auf Abfragen Ergebnisse zurckgibt.
Kann Transparenz Gibt an, ob der Layer transparent gezeichnet werden kann. Diese Version
verwendet ein hardcodiertes Ja, sofern die Bildkodierung Transparenz bietet
Kann herangezoomt werden - Ob der Layer durch den Server herangezoomt werden kann oder nicht.
Diese Version von QGIS nimmt an, dass bei allen WMS Layern Ja eingestellt ist. Mangelhafte Layer
werden seltsam dargestellt.
Kaskadierend WMS-Server knnen als Proxy zwischen anderen WMS-Servern agieren, um Rasterdaten fr einen Layer anzufordern. Dieser Eintrag gibt an, wieviele WMS-Server angefragt werden
mssen, um die Daten zu bekommen.

14.1. QGIS als OGC Datenclient

161

QGIS User Guide, Release 2.6

Feste Breite, Fest Hhe - Ob dieser Layer festgelegte Quellpixeldimensionen besitzt. Diese Version
von QGIS nimmt an dass bei allen WMS Layern nichts eingestellt ist. Mangelhafte Layer werden
seltsam dargestellt.
WGS 84 Boundingbox Gibt die Boundingbox eines Layers in WGS84-Koordinaten an. Einige
WMS-Server setzen diese Werte nicht korrekt (z.B. stehen darin manchmal UTM-Koordinaten), sodass bei solchen Layern in QGIS der Eindruck entsteht, sehr weit herausgezoomt zu sein. Der Webmaster des WMS-Servers sollte dann auf dieses Problem aufmerksam gemacht werden. Das WMS
XML-Element ist LatLonBoundingBox, EX_GeographicBoundingBox oder die CRS:84
BoundingBox.
Verfgbare Koordinatensysteme Die Projektionen, in denen dieser Layer dargestellt werden
kann. Diese sind dem Capabilities-Dokument des Servers entnommen.
Verfgbare Stile Die Bildstile, in denen dieser Layer dargestellt werden kann.
Zeigen der WMS Legendengrafik im Inhaltsverzeichnis und in der Druckzusammenstellung
Der QGIS WMS Datenprovider ist in der Lage eine Legendengrafik in der Inhaltsverzeichnisliste und in der
Druckzusammenstellung darzustellen. Die WMS Legende wird nur gezeigt wenn der WMS Server eine GetLegendGraphic Capability hat und fr den Layer die getCapability URL angegeben wurde, also mssen Sie zustzlich einen Stil fr den Layer aussuchen.
Wenn eine legendGraphic verfgbar ist, wird diese unter dem Layer angezeigt. Sie ist klein und Sie mssen darauf
klicken um Sie in Ihrer tatschlichen Gre (gem den QgsLegendInterface Architekturlimitationen) zu ffnen.
Das Klicken auf die Legende des Layers ffnet einen Rahmen mit einer Legende in voller Auflsung.
In der Druckzusammenstellung wird die Legende in ihren (gedownloadeten) Originalmaen integriert. Die Auflsung der Legendengrafik kann in dem Elementeigenschaften unter Legende > WMS LegendGraphic eingestellt
werden um Ihren Druckanforderungen zu entsprechen
Die Legende wird Kontextinformationen basiert auf dem aktuellen Mastab darstellen. Die WMS Legende wird
nur gezeigt wenn der WMS Server eine GetLegendGraphic Capability hat und fr dem Layer eine getCapability
URL angegeben wurde, also mssen Sie einen Stil auswhlen.
Einschrnkungen des WMS-Klienten
Nicht alle mgliche WMS Client Funktionalitten sind in diese Version von QGIS integriert worden. Einige der
bemerkenswerteren Ausnahmen folgen noch.
WMS-Layereigenschaften ndern
WMS/WMTS-Layer hinzufgen
Prozedur beendet haben gibt es keine Mglichkeit mehr die EinstelNachdem Sie die
lungen zu ndern. Sie knnen das Problem umgehen indem Sie den Layer komplett entfernen und neu beginnen.

WMS-Server, die eine Authentifizierung bentigen


Derzeit werden ffentlich zugngliche und gesicherte WMS Services untersttzt. Die gesicherten WMS Server
knnen mit ffentlicher Authentifizierung angebunden werden. Sie knnen die (optionalen) Anmeldeinformationen hinzufgen wenn Sie einen WMS Server hinzufgen. Schlagen Sie unter Abschnitt WMS/WMTS Server
auswhlen Details nach.
Tipp: Zugriff auf abgesicherte OGC-Layer
Wenn Sie Zugriff auf OGC-Layer bentigen, die anders als durch einfache, ffentliche Authentifizierung
abgesichert sind, knnen Sie InteProxy als transparenten Proxy verwenden. Dieser untersttzt verschiedene
Methoden der Authentifizierung. Weitere Informationen zu diesem Thema finden Sie auf der Webseite
http://inteproxy.wald.intevation.org.
Tipp: QGIS WMS Mapserver

162

Kapitel 14. Arbeiten mit OGC Daten

QGIS User Guide, Release 2.6

Seit Version 1.7.0 besitzt QGIS seine eigene Implementierung eines WMS 1.3.0 Mapservers. Lesen mehr darber
in Kapitel QGIS als OGC Datenserver.

14.1.2 WCS Client


Ein Web Coverage Service (WCS) stellt eine Anbindung zu Rasterdaten in Formaten die ntzlich fr die
client-seitige Darstellung, als Input fr wissenschaftliche Modelle und fr andere Clients zur Verfgung. Der
WCS ist vergleichbar zu WFS und WMS. Als WMS und WFS Service Instanz erlaubt der WCS den Clients Teile
von Serverinformationsbestnden basierend auf rumlichen Einschrnkungen und Abfragekriterien auszuwhlen.
QGIS hat einen nativen WCS Provider und untersttzt sowohl Version 1.0 und 1.1 (welche deutliche Unterschiede
aufweisen), aktuell jedoch wird 1.0 vorgezogen da es mit 1.1 viele Probleme gibt (z.B. implementiert jeder Server
es auf eine andere Art und Weise mit zahlreichen Besonderheiten).
Der native WCS Provider kmmert sich um alle Netzwerkanfragen und verwendet alle voreingestellten QGIS
Netzwerkanfragen (insbesondere proxy). Es ist auch mglich einen Cache auszuwhlen (Immer cachen, Cache
vorziehen, Netzwerk vorziehen, Immer Netzwerk) und der Provider untersttzt ebenfalls das Auswhlen der
Zeitposition wenn Temporal Domain vom Server angeboten wird.

14.1.3 WFS und WFS-T Klient


In QGIS verhlt sich ein WFS Layer ziemlich genau so wie jeder andere Vektorlayer. Sie knnen Objekte abfragen
und auswhlen und sich die Attributtabelle anschauen.. Seit QGIS 1.6 wird auch das Bearbeiten von WFS-T
untersttzt.
Im Allgemeinen verhlt sich das Hinzufgen eines WFS Layers sehr hnlich wie die Vorgehensweise die beim
WMS verwendet wird. Der Unterschied besteht darin dass keine voreingestellten Server definiert sind, also mssen
wir eigene hinzufgen.
Einen WFS-Layer laden
In diesem Beispiel verwenden wir den WFS-Server der Firma DMSolutions und laden einen Layer. Die URL ist:
http://www2.dmsolutions.ca/cgi-bin/mswfs_gmap
WFS-Layer hinzufgen
Werkzeug in der Werkzeugleiste. Der Dialog WFS-Layer des
1. Klicken Sie auf das
Servers hinzufgen erscheint.

2. Klicken Sie auf [Neu].


3. Geben Sie DM Solutions als Namen ein.
4. Geben Sie die URL ein (siehe oben).
5. Klicken Sie [OK].
6. Whlen Sie DM Solutions aus der Serververbindungen

Dropdownliste.

7. Klicken Sie [Verbinden].


8. Warten Sie bis die Layerliste aufgefllt ist.
9. Whlen Sie den Parks Layer aus der Liste.
10. Klicken Sie [Hinzufgen] um den Layer zur Karte hinzuzufgen.
Beachten Sie dass auch jede Proxyeinstellung die Sie in Ihren eingestellt haben bercksichtigt wird.
Youll notice the download progress is visualized in the lower left of the QGIS main window. Once the layer is
loaded, you can identify and select a province or two and view the attribute table.
Es wird nur WFS 1.0.0 untersttzt. Bis zu diesem Zeitpunkt wurde noch nicht sehr umfangreich die Anbindung
mit anderen WFS Servern getestet. Wenn Sie Probleme feststellen, zgern Sie bitte nicht, eine Email an das QGIS

14.1. QGIS als OGC Datenclient

163

QGIS User Guide, Release 2.6

Abbildung 14.4: Einen WFS Layer hinzufgen


Projekt zu schicken oder einen Fehlerreport zu schreiben. Sie finden eine Liste mglicher Kontakte in Kapitel
Hilfe und Support.
Tipp: WFS-Server finden
Sie knnen weitere WFS Server mit Hilfe von Google oder ihrer bevorzugten Suchmaschine finden. Es gibt eine
Vielzahl von Listen im Internet, die Links zu ffentlichen Servern bereitstellen.
.

14.2 QGIS als OGC Datenserver


QGIS Server ist eine open Source WMS 1.3, WFS 1.0.0 und WCS 1.1.1 Umsetzung die zustzlich erweiterte
kartografische Funktionen fr thematische Karten zur Verfgung stellt. Der QGIS Server ist eine FastCGI/CGI
(Common Gateway Interface)-Anwendung, ist in C++ geschrieben und arbeitet mit einem Webserver zusammen
(z.B. Apache oder Lighttpd). Es wurde mit finanziellen Mitteln des EU Projekts Orchestra, Sany und der Stadt
Uster aus der Schweiz entwickelt.
QGIS Server verwendet QGIS im Hintergrund fr die GIS-Logik und fr das Darstellen der Karte. Des weiteren wird die Qt-Bibliothek fr Grafiken und fr die plattformunabhngige C++-Programmierung verwendet.
Im Gegensatz zu anderer WMS-Software verwendet der QGIS Server kartographische Regeln als Konfigurationssprache, sowohl fr die Server Konfiguration als auch fr die benutzerdefinierten kartographischen Regeln.
As QGIS desktop and QGIS Server use the same visualization libraries, the maps that are published on the web
look the same as in desktop GIS.
In einer der folgenden Anleitungen werden wir eine Beispielkonfiguration zum Aufsetzen eines QGIS Servers
anbieten. Vorerst empfehlen wir eine der folgenden URLs zu lesen um mehr Informationen zu bekommen:
http://karlinapp.ethz.ch/qgis_wms/
http://hub.qgis.org/projects/quantum-gis/wiki/QGIS_Server_Tutorial
http://linfiniti.com/2010/08/qgis-mapserver-a-wms-server-for-the-masses/

164

Kapitel 14. Arbeiten mit OGC Daten

QGIS User Guide, Release 2.6

14.2.1 Beispielinstallation unter Debian Squeeze


An dieser Stelle zeigen wir Ihnen eine kurze und einfache Beispielinstallation fr Debian Squeeze. Auch viele
andere Betriebssysteme bieten Pakete fr QGIS Server. Wenn Sie alles aus dem Quellcode bauen mssen, sehen
in den oben angegebenen URLs nach.
Abgesehen von QGIS Desktop und QGIS Server bentigen Sie einen Webserver, in unserem Fall apache2. Sie
knnen alle Pakete mit aptitude oder apt-get install zusammen installieren. Alle weiteren notwendigen Pakete
werden dann mitinstalliert. Nach der Installation sollten Sie testen, ob der Webserver und der QGIS Server wie
erwartet funktionieren. Vergewissern Sie sich, dass der Apache Webserver luft. Ansonsten starten Sie ihn mit
/etc/init.d/apache2 start. ffen Sie nun einen Web-Browser und geben Sie sie URL http://localhost ein. Wenn
alles in Ordnung ist, sollten Sie die Meldung It works! sehen.
Jetzt testen wir die QGIS Server Installation. Die Datei qgis_mapserv.fcgi finden Sie unter
/usr/lib/cgi-bin/qgis_mapserv.fcgi und stellt einen Test-WMS bereit, der die Grenzen von Alaska
zeigt. Laden Sie den WMS mit der URL http://localhost/cgi-bin/qgis_mapserv.fcgi wie in
Abschnitt WMS/WMTS Layer laden beschrieben.

Abbildung 14.5: Standard WMS mit USA boundaries im QGIS Server (KDE)

14.2.2 Erstellen eines WMS/WFS/WCS aus einem QGIS Projekt


Um einen neuen QGIS WMS, WFS oder WCS Server zur Verfgung zu stellen, mssen wir eine QGIS Projektdatei mit einigen Daten erstellen. Hier benutzen wir die Alaska Shapedatei aus dem QGIS Beispieldatensatz.
Definieren Sie die Farben und den Stil der Layer in QGIS und auch das Projekt KBS, falls die nicht schon definiert
ist.

14.2. QGIS als OGC Datenserver

165

QGIS User Guide, Release 2.6

Abbildung 14.6: Definitionen fr ein QGIS WMS/WFS/WCS Server Projekt (KDE)

166

Kapitel 14. Arbeiten mit OGC Daten

QGIS User Guide, Release 2.6

Gehen Sie dann zu dem OWS Server Men des Einstellung Projekteigenschaften Dialog und geben Sie einige
Informationen ber den OWS in den Feldern unter Diensteigenschaften an. Diese werden dann in der GetCapabilities Antwort des WMS, WFS oder WCS auftauchen. Wenn Sie
Diensteigenschaften nicht aktivieren wird
der QGIS Server die Informationen aus der wms_metadata.xml Datei, die im cgi-bin Ordner gespeichert
ist, verwenden.
WMS-Capabilities
Im WMS-Capabilities Bereich knnen Sie die von der WMS GetCapabilities Response angezeigten Ausmae
definieren indem Sie die minimalen und maximalen X und Y Werte in die Felder unter Angezeigte Ausmasse
eingeben. Das Klicken von Aktuelle Anzeigegrenzen bernehmen stellt diese Werte auf die Ausmae die gerade
KBS-Beschrnkungen aktivieren knnen Sie einim QGIS Kartenfenster dargestellt werden ein. Wenn Sie
schrnken in welchem Koordinatenbezugssystem (KBS) QGIS Server Karten zum Darstellen anbieten wird. Verwenden Sie den
Knopf um diese KBS aus der Koordinatenbezugssystem-Auswahl auszuwhlen oder klicken
Sie Benutzte um das im QGIS Projekt benutzte KBS der Liste hinzuzufgen.
Wenn Sie Druckzusammenstellungen in Ihrem Projekt definiert haben werden diese in der GetCapabilities
Response aufgelistet und sie knnen vom GetPrint Request verwendet werden um einen Druck zu erstellen,
wobei eines der Druckzusammenstellungslayouts als Vorlage verwendet wird. Dies ist eine QGIS-spezifische Erweiterung zur WMS 1.3.0 Spezifikation. Wenn Sie die Verffentlichung jedweder Druckzusammenstellung durch
den WMS ausschlieen wollen aktivieren Sie

Druckzusammenstellungen ausschlieen und klicken Sie unten

Knopf. Whlen Sie dann eine Druckzusammenstellung aus dem Druckzusammenstellung whlen Dialog
den
um diese der Ausnahmeliste fr die Zusammenstellungen hinzuzufgen.
Wenn Sie einen Layer oder eine Layergruppe davon ausschlieen wollen vom WMS verffentlicht zu werden
aktivieren Sie
Layer ausschlieen und klicken Sie auf den |mActionSignPlus| Knopf darunter. Dies ffnet den
:guilabel:Eingeschrnkte Layer und Gruppen whlen Dialog, der es Ihnen ermglicht die Layer und Gruppen
die nicht verffentlicht werden sollen auszusuchen. Verwenden Sie den Umschalt oder Strg Knopf wenn Sie
mehrere Eintrge auf einmal auswhlen wollen.
Sie knnen requestete GetFeatureInfo als Klartext, XML und GML empfangen. Standard ist XML, das Text- oder
GML-Format hngt vom verwendeten Ausgabeformat fr den GetFeatureInfo Request ab.
Wenn Sie es wnschen knnen Sie das
Geometrie der Objektantwort beifgen Kontrollkstchen aktivieren.
Dies wird die Geometrien der Objekte der GetFeatureInfo Response im Textformat hinzufgen. Wenn Sie wollen
dass QGIS Server spezifische Request URLs in der WMS GetCapabilities Response angbit, geben sie die enstprechende URL im Angezeigte URL Feld an. Darberhinaus knnen Sie die Maximalgre der Karten, die vom
GetMap Request wiedergegeben wird, durch das Eingeben der Maximalen Breite und Hhe in die entsprechenden
Felder unter Maxima fr GetMap-Abfragen einschrnken.
If one of your layers uses the Map Tip display (i.e. to show text using expressions) this will be listed inside the
GetFeatureInfo output. If the layer uses a Value Map for one of his attributes, also this information will be shown
in the GetFeatureInfo output.
WFS-Capabilities
Im WFS-Capabilities Bereich knnen Sie die Layer auswhlen die Sie als WFS verffentlichen wollen und festlegen ob Sie die Update, Insert und Delete Operationen erlauben. Wenn Sie eine URL in das Angezeigte URL Feld
des WFS-Capabilities Bereichs eingeben, wird QGIS Server diese bestimmte URL in der WFS GetCapabilities
Response angeben.
WCS-Capabilities
Im WCS-Capabilities Bereich knnen Sie die Layer auswhlen die Sie als WCS verffentlichen wollen. Wenn
Sie eine URL in das Angezeigte URL Feld des WFS-Capabilities Bereichs eingeben, wird QGIS Server diese
bestimmte URL in der WCS GetCapabilities Response angeben.
Speichern Sie die Sitzung jetzt in eine Projektdatei alaska.qgs. Um das Projekt als WMS/WFS bereitzustellen
erstellen wir einen neuen Ordner /usr/lib/cgi-bin/project mit Verwaltungsrechten und fgen eine Projektdatei alaska.qgs und eine Kopie der qgis_mapserv.fcgi Datei hinzu - das ist alles.

14.2. QGIS als OGC Datenserver

167

QGIS User Guide, Release 2.6

Jetzt testen wir unser WMS, WFS und WCS Projekt. Fgen Sie QGIS den WMS, WFS und WCS wie in
WMS/WMTS Layer laden, WFS und WFS-T Klient und WCS Client beschrieben zu und laden Sie die Daten.
Die URL ist:
http://localhost/cgi-bin/project/qgis_mapserv.fcgi

Den OWS feinabstimmen


Bei Vektorlayern ermglicht Ihnen das Felder Men des Layer Eigenschaften Dialogs fr jedes Attribut zu
definieren ob es verffentlicht wird oder nicht. Standardmig werden alle Attribute von Ihrem WMS und WFS
verffentlicht. Wenn Sie nicht wollen dass ein Attribut verffentlicht wird deaktivieren Sie das entsprechende
Kontrollkstchen in der WMS oder WFS Spalte.
Sie knnen Wasserzeichen ber die Karten legen, die von Ihrem WMS produziert werden, indem Sie Beschriftungstexte oder SVG-Anmerkungen hinzufgen. Siehe Beschriftungstools unter Allgemeine Werkzeuge fr Anleitungen zum Erstellen von Anmerkungen. Fr Anmerkungen die als Wasserzeichen in der WMS Ausgabe dargestellt
werden sollen muss das Feste Kartenposition Kontrollkstchen im Anmerkungstext Dialog deaktiviert sein. Dies
knnen Sie erreichen indem Sie auf die Anmerkung doppelklicken whrend eines der Beschriftungstools aktiv ist.
Bei SVG-Anmerkungen werden Sie entweder das Projekt einstellen mssen um absolute Pfade zu speichern (im
Allgemein Men des Projekt Projekteigenschaften Dialogs) oder den Pfad zum SVG-Bild manuell so verndern
dass es einen gltigen relativen Pfad darstellt.
Zustzliche Paramter die vom WMS GetMap Request untersttzt werden.
Im WMS GetMap Request akzeptiert der QGIS Server ein paar zustzliche Paramter zustzlich zu den Standardparametern gem der OGC WMS 1.3.0 Spezifikation:
MAP Parameter: hnlich wie MapServer kann der MAP Parameter zum Angeben des Pfads zur QGIS
Projektdatei verwendet werden. Sie knnen einen absoluten Pfad oder einen Pfad relativ zum Speicherort
der ausfhrbaren Serverdatei (qgis_mapserv.fcgi) angeben. Wenn nichts angegeben ist sucht QGIS
Server nach .qgs Dateien in dem Verzeichnis in dem die ausfhrbare Serverdatei gespeichert ist.
Beispiel:
http://localhost/cgi-bin/qgis_mapserv.fcgi?\
REQUEST=GetMap&MAP=/home/qgis/mymap.qgs&...

DPI Parameter: Der DPI Parameter kann verwendet werden um die angefragte Ausgabeauflsung
anzugeben.
Beispiel:
http://localhost/cgi-bin/qgis_mapserv.fcgi?REQUEST=GetMap&DPI=300&...

OPACITIES Parameter: Die Deckkraft kann auf Layer- oder Gruppenebene eingestellt werden. Zugelassene Werte bewegen sich von 0 (ganz transparent) bis 255 (volle Abdeckung).
Beispiel:
http://localhost/cgi-bin/qgis_mapserv.fcgi?\
REQUEST=GetMap&LAYERS=mylayer1,mylayer2&OPACITIES=125,200&...

QGIS Server logging


To log requests send to server, set the following environment variables:
QGIS_SERVER_LOG_FILE: Specify path and filename. Make sure that server has proper permissions
for writing to file. File should be created automatically, just send some requests to server. If its not there,
check permissions.
QGIS_SERVER_LOG_LEVEL: Specify desired log level. Available values are:

168

Kapitel 14. Arbeiten mit OGC Daten

QGIS User Guide, Release 2.6

0 INFO (log all requests),


1 WARNING,
2 CRITICAL (log just critical errors, suitable for production purposes).
Beispiel:
SetEnv QGIS_SERVER_LOG_FILE /var/tmp/qgislog.txt
SetEnv QGIS_SERVER_LOG_LEVEL 0

Note
When using Fcgid module use FcgidInitialEnv instead of SetEnv!
Server logging is enabled also if executable is compiled in release mode.
Environment variables
QGIS_OPTIONS_PATH: The variable specifies path to directory with settings. It works
the same ways as QGIS application optionspath option. It is looking for settings file in
<QGIS_OPTIONS_PATH>/QGIS/QGIS2.ini. For exaple, to set QGIS server on Apache to use
/path/to/config/QGIS/QGIS2.ini settings file, add to Apache config:
SetEnv QGIS_OPTIONS_PATH "/path/to/config/"

14.2. QGIS als OGC Datenserver

169

QGIS User Guide, Release 2.6

170

Kapitel 14. Arbeiten mit OGC Daten

KAPITEL 15

Arbeiten mit GPS Daten

15.1 GPS Plugin


15.1.1 Was ist GPS?
GPS, das Global Positioning System, ist ein satellitenbasiertes System das es jedem mit einem GPS Empfnger
ermglicht seine genaue Position berall auf der Welt zu finden. GPS wird als Navigationshilfe in Flugzeugen,
in Schiffen und von Wanderern benutzt. Der GPS Empfnger verwendet die Signale von den Satelliten um seine
Lnge, Breite und (manchmal) Hhe zu berechnen. Die meisten Empfnger haben auch die Fhigkeit Orte (bekannt als Wegpunkte), Sequenzen von Wegpunkten, die zusammen eine geplante Route ergeben und Tracklogs oder
Spuren der zeitlichen Bewegung des Empfngers zu speichern. Wegpunkte, Routen und Spuren sind die drei
Grundtypen in GPS Daten. QGIS stellt Wegpunkte in Punktlayern dar, wohingegen Routen und Spuren in Vektorlinien dargestellt werden.

15.1.2 GPS-Daten aus einer Datei laden


Es gibt dutzende von verschienden Dateiformaten zum Speichern von GPS Daten. Das Format das QGIS benutzt
wird GPX (GPS eXchange format) genannt, welches ein Standardaustauschformat ist welches eine beliebige Anzahl von Wegpunkten, Routen und Spuren in einer Datei enthalten kann.
Um eine GPX Datei zu laden mssen Sie zuerst das Plugin laden. Erweiterungen |mActionShowPluginManager| :menuselection:Erweiterungen verwalten und installieren ... ffnet den Pluginmanagerdialog. Aktivieren
Sie das
GPS Werkzeuge Kontrollkstchen. Wenn dieses Plugin geladen ist erscheinen zwei Knpfe mit einem
kleinen tragbaren GPS Gert in der Werkzeugleiste:

Erstelle neuen GPX Layer

GPS-Werkzeuge

Zum Arbeiten mit GPS Daten stellen wir Ihnen eine Beispiel GPX Datei, die im QGIS Beispieldatensatz zu finden
ist, zur Verfgung: qgis_sample_data/gps/national_monuments.gpx. Siehe Abschnitt Beispieldaten fr weitere Informationen ber die Beispieldaten.
GPS-Werkzeuge
1. Whlen Sie Vektor GPS GPS Werkzeuge oder klicken Sie das
Icon in der Werkzeugleiste und ffnen Sie den GPX-Datei laden Reiter (siehe figure_GPS_1).

2. Suchen Sie den Ordner qgis_sample_data/gps/,


national_monuments.gpx und klicken Sie [ffnen].

whlen

Sie

die

GPX-Datei

Verwenden Sie den [Suchen...] Knopf um die GPX-Datei auszuwhlen, verwenden Sie dann die Kontrollkstchen
um die Objekttypen die aus der GPX-Datei geladen werden sollen auszuwhlen. Jeder Objekttyp wird in einen

171

QGIS User Guide, Release 2.6

Abbildung 15.1: Das GPS Werkzeuge Dialogfenster


separaten Layer geladen wenn Sie [OK] klicken. Die Datei national_monuments.gpx enthlt nur Wegpunkte.
Bemerkung: GPS Einheiten ermglichen es Ihnen Daten in verschiedenen Koordinatensystemen zu speichern.
Wenn Sie eine GPX Datei herunterladen (von Ihrer GPS Einheit oder einer Webseite) und Sie dann in QGIS laden
versichern Sie sich das die Daten die in Ihrer GPX-Datei gespeichert sind WGS 84 (Lnge/Breite) verwenden.
QGIS erwartet dieses und es ist die offizielle GPX Spezifikation. Siehe http://www.topografix.com/GPX/1/1/ .

15.1.3 GPSBabel
Weil QGIS nur das GPX-Format untersttzt, mssen Sie einen Weg finden, um andere GPS-Datenformate nach
GPX zu konvertieren. Dies knnen Sie in vielen Fllen mit der Freien Software GPSBabel erledigen, erhltlich
unter der URL: http://www.gpsbabel.org. Diese Software kann auch GPS-Daten von Ihrem PC zu Ihrem GPSEmpfnger transferieren und umgekehrt. QGIS benutzt GPSBabel auch dazu, daher ist es ratsam, es zu installieren.
Wenn Sie aber lediglich GPX-Dateien in QGIS laden mchten, geht dies auch ohne GPSBabel. Version 1.2.3
funktioniert auf jeden Fall mit QGIS, neuere aber wahrscheinlich auch.

15.1.4 GPS-Daten importieren


Um GPS-Daten aus einer Datei, die nicht im GPX-Format vorliegt zu importieren, benutzen Sie den Reiter
Aus anderer Datei importieren. Whlen Sie dann die Datei (und den Dateityp), die importiert werden soll aus,
von welchem Datenformat Sie importieren mchten und wo die konvertierte GPX-Datei unter welchem Namen
abgelegt werden soll. Beachten Sie, dass nicht fr alle Datenformate die drei GPS-Datentypen Wegpunkte, Routen
und Spuren untersttzt werden. Manchmal sind es nur ein oder zwei.

15.1.5 GPS-Daten von einem Empfnger herunterladen


QGIS kann mit dem Programm GPSBabel GPS-Daten direkt von einem GPS-Empfnger in einen Vektorlayer
laden. Dazu knnen Sie den Reiter Vom GPS herunterladen verwenden (siehe Figure_GPS_2), indem Sie den Typ
Ihres GPS-Empfngers angeben, den Verbindungsport (oder USB wenn Ihr GPS dies untersttzt), den Namen der
GPX-Datei, in welche die Daten konvertiert werden sollen und schlielich den Namen des neuen Vektorlayers in
QGIS.
Durch die Angabe des Typs Ihres GPS-Empfngers legen Sie fest, wie GPSBabel mit dem Gert kommuniziert.
Wenn kein vorhandener Typ mit Ihrem Empfnger funktioniert, knnen Sie einen eigenen, neuen Gertetyp erstellen (vgl. Abschnitt Neues GPS-Gert definieren).

172

Kapitel 15. Arbeiten mit GPS Daten

QGIS User Guide, Release 2.6

Abbildung 15.2: Das Downloadwerkzeug


Der Verbindungsport ist ein Dateiname oder ein anderer Name, den Ihr System als Referenz fr den physischen
Port benutzt, ber den eine Verbindung zum GPS-Empfnger hergestellt wird. Es kann auch einfach USB sein,
wenn dies von dem GPS-Gert untersttzt wird.

Unter Linux ist dies etwas wie /dev/ttyS0 oder /dev/ttyS1.

Unter Windows ist dies COM1 oder COM2.

Wenn Sie [OK] klicken werden die Daten vom GPS-Empfnger heruntergeladen und in QGIS als Vektorlayer
dargestellt.

15.1.6 GPS-Daten auf einen Empfnger hochladen


Sie knnen auch einen Vektorlayer aus QGIS auf einen GPS-Empfnger hochladen, indem Sie den Reiter Zum
GPS hochladen verwenden. Der Vektorlayer muss dazu ein GPX-Layer sein. Sie whlen dazu einen entsprechenden Layer aus, den Typ Ihres GPS-Empfngers und den Verbindungsport (oder USB). Genau wie beim Reiter Vom
GPS herunterladen knnen Sie bei Bedarf auch einen eigenen, neuen Empfnger-Typ erstellen, wenn Ihr Gert
nicht in der Liste auftaucht.
Dieses Werkzeug ist sehr ntzlich in Kombination mit den Vektorbearbeitungsfunktionen von QGIS. Es ermglicht Ihnen eine Karte zu laden, Wegpunkte und Routen zu erstellen und diese dann auf Ihr GPS Gert
hochzuladen und zu verwenden.

15.1.7 Neues GPS-Gert definieren


Es gibt eine groe Vielfalt an GPS-Empfngern, und die QGIS Entwickler knnen nicht alle testen. Wenn Sie also
ein Gert haben, das nicht mit einem der bereits vorhandenen Gertetypen, die in Vom GPS herunterladen und
Zum GPS hochladen aufgelistet sind, funktioniert, knnen Sie selbst einen erstellen. Dazu klicken Sie auf den
Knopf [Editiere Gerte] im Hochladen Reiter oder Herunterladen Reiter.
Um ein neues Gert zu definieren klicken Sie einfach den Knopf [Neu], geben einen Namen, einen Downloadbefehl und einen Uploadbefehl fr Ihr Gert ein und klicken den [Aktualisieren] Knopf. Danach steht der Name des
Gertes in den Reitern Zum GPS hochladen und Vom GPS herunterladen zur Verfgung und kann in Form jeder
Zeichenfolge eingegeben werden. Der Downloadbefehl ist der Befehl der zum Downloaden der Daten von einem
Gert in eine GPX-Datei verwendet wird. Dies ist wahrscheinlich ein GPSBabelbefehl, man kann aber auch jedes
andere Kommandozeilenprogramm das eine GPX-Datei erstellen kann benutzen. QGIS wird die Schlsselwrter
%type , %in und %out ersetzen, wenn das Kommando ausgefhrt wird.
%type wird ersetzt durch -w, wenn Sie Wegpunkte herunterladen, -r wenn es eine Route ist und -t, wenn es
sich um Spuren handelt. GPSBabel erfhrt dadurch, um welchen GPS-Datentyp es sich handelt.
%in wird ersetzt durch den Namen des Verbindungsports und %out durch den Namen, den Sie fr die GPX-Datei
gewhlt haben. Wenn Sie also einen neuen Gertetyp mit dem Kommando gpsbabel %type -i garmin
15.1. GPS Plugin

173

QGIS User Guide, Release 2.6

-o gpx %in %out (es handelt sich hierbei um das Standard Kommando fr einen Garmin Serial) definieren
und diesen benutzen, um Wegpunkte von Port /dev/ttyS0 in die Datei output.gpx zu schreiben, dann ersetzt QGIS die Schlsselworte und startet das Kommando gpsbabel -w -i garmin -o gpx /dev/ttyS0
output.gpx.
Das Kommando hinaufladen wird benutzt, um die Daten auf Ihren GPS-Empfnger zu transferieren. Es werden
dazu die gleichen Schlsselworte benutzt, nur dass %in durch den Namen der hochzuladenen GPX-Datei und
%out durch den Namen des Verbindungsports ersetzt wird.
Sie knnen mehr ber GPSBabel und seine Funktionen unter der URL http://www.gpsbabel.org erlernen.
Wenn Sie einmal einen eigenen Gertetypen erstellt haben, wird dieser in der Liste der GPS-Gerte dauerhaft
angezeigt werden.

15.1.8 Downloaden von Punkten/Spuren von GPS Einheiten


As described in previous sections QGIS uses GPSBabel to download points/tracks directly in the project. QGIS
comes out of the box with a pre-defined profile to download from Garmin devices. Unfortunately there is a bug
#6318 that does not allow create other profiles, so downloading directly in QGIS using the GPS Tools is at the
moment limited to Garmin USB units.
Garmin GPSMAP 60cs
MS Windows
Installieren Sie Garmin USB Treiber von http://www8.garmin.com/support/download_details.jsp?id=591
Verbinden Sie die Einheit. ffnen Sie GPS Werkzeuge und verwenden Sie type=garmin serial und
port=usb:. Fllen Sie die Felder Layername und Ausgabedatei aus. Manchmal scheint es Probleme beim
Speichern in einen bestimmten Ordner zu geben, wenn Sie etwas wie c:\temp verwenden funktioniert es fr
gewhnlich.
Ubuntu/Mint GNU/Linux
Es wird zuerst ein Eintrag ber die Rechte des Gertes bentigt, wie beschrieben auf
https://wiki.openstreetmap.org/wiki/USB_Garmin_on_GNU/Linux. Sie knnen versuchen eine Datei
/etc/udev/rules.d/51-garmin.rules zu erstellen, die diese Regel enthlt.
ATTRS{idVendor}=="091e", ATTRS{idProduct}=="0003", MODE="666"

Danach ist es ntig sicher zu gehen das das garmin_gps Kernelmodul nicht geladen ist
rmmod garmin_gps

and then you can use the GPS Tools. Unfortunately there seems to be a bug #7182 and usually QGIS freezes
several times before the operation work fine.
BTGP-38KM Datenlogger (nur Bluetooth)
MS Windows
Der bereits erwhnte Bug lsst es nicht zu, dass Daten innerhalb von QGIS heruntergeladen werden, also mssen
Sie GPSBabel aus der Kommandozeile heraus oder mit Hilfe seiner Schnittstelle verwenden.
gpsbabel -t -i skytraq,baud=9600,initbaud=9600 -f COM9 -o gpx -F C:/GPX/aaa.gpx

Ubuntu/Mint GNU/Linux
Verwenden Sie den gleichen Befehl (oder Einstellungen wenn Sie die GPSBabel GUI verwenden) wie in Windows.
Unter Linux ist vielleicht blich eine Nachricht wie folgt zu erhalten

174

Kapitel 15. Arbeiten mit GPS Daten

QGIS User Guide, Release 2.6

skytraq: Too many read errors on serial port

es ist einfach eine Frage des aus- und anschalten des Dateloggers und es erneut zu versuchen.
BlueMax GPS-4044 Datenlogger (sowohl BT als auch USB)
MS Windows
Bemerkung: Es muss seine Treiber installieren bevor man es unter Windows 7 verwendet. Sehen Sie in den
Herstellerseiten fr den richtigen Download nach.
Downloaden mit GPSBabel, mit USB und BR, gibt immer einen Fehler heraus wie
gpsbabel -t -i mtk -f COM12 -o gpx -F C:/temp/test.gpx
mtk_logger: Cant create temporary file data.bin
Error running gpsbabel: Process exited unsucessfully with code 1

Ubuntu/Mint GNU/Linux
Mit USB
Nachdem Sie das Kabel angeschlossen haben verwenden Sie den dmesg Befehl um zu verstehen welcher Port
benutzt wird, zum Beispiel /dev/ttyACM3. Benutzen Sie dann wie immer GPSBabel aus der Kommandozeile
oder der GUI.
gpsbabel -t -i mtk -f /dev/ttyACM3 -o gpx -F /home/user/bluemax.gpx

Mit Bluetooth
Verwenden Sie Blueman Device Manager um das Gert zu verbinden und machen Sie es ber einen Systemport
zugnglich, starten Sie dann GPSBabel.
gpsbabel -t -i mtk -f /dev/rfcomm0 -o gpx -F /home/user/bluemax_bt.gpx

15.2 Live GPS tracking


Um das Live GPS tracking in QGIS zu aktivieren mssen Sie Einstellungen Bedienfelder
Information whlen. Es erscheint ein neues Dockfenster auf der linken Seite der Oberflche.

GPS-

Es sind 4 Bildschirme im GPS Tracking Fenster mglich:

GPS Positionskoordinaten und eine Schnittstelle fr manuelles Eintragen von Sttzpunkten und Objekten.

GPS Signalstrke von Satellitenverbindungen

GPS Polarbildschirm der die Anzahl und die polare Position von Satelliten zeigt

GPS Optionsansicht (siehe figure_gps_options)

Mit einem angeschlossenen GPS-Empfnger (muss auch von Ihrem Betriebssystem untersttzt werden) reicht ein
einfacher Klick auf den Knopf [Verbinden]. Ein zweiter Klick (jetzt auf [Trennen]) trennt die Verbindung zu dem
GPS-Empfnger wieder. Fr GNU/Linux wurde gpsd Support integriert. Dadurch ist eine einfache Verbindung
zu den meisten GPS Gerten gewhrleistet. Sie mssen gpsd im Vorfeld konfigurieren, damit QGIS sich damit
verbinden kann.
Warnung: Wenn Sie Ihre Position in die Oberflche aufnehmen wollen mssen Sie erst einen neuen Vektorlayer erstellen und diesen in den Bearbeitungsmodus bringen um Ihren Track aufnehmen zu knnen.

15.2. Live GPS tracking

175

QGIS User Guide, Release 2.6

15.2.1 Positionskoordinaten
Wenn das GPS Signale von Satelliten empfngt werden Sie Ihre Position als Lnge, Breite und Hhe zusammen mit zustzlichen Attributen sehen.

Abbildung 15.3: GPS Tracking Position und zustzliche Attribute

15.2.2 GPS Signalstrke


Hier knnen Sie die Signalstrke der Satelliten von denen Sie Signale empfangen sehen.

Abbildung 15.4: GPS Tracking Signalstrke

176

Kapitel 15. Arbeiten mit GPS Daten

QGIS User Guide, Release 2.6

15.2.3 GPS Polar-Bildschirm


Wenn Sie wissen wollen, wo sich die Satelliten befinden, mit denen Sie gerade verbunden sind, wechseln Sie
zum GPS Polarbildschirm. Sie knnen auch die IDs der Satelliten sehen, von denen Sie Signale empfangen.

Abbildung 15.5: GPS Tracking Polarbildschirm

15.2.4 GPS Optionen


Wenn es Probleme bei der Verbindung zum GPS-Gert geben sollte knnen Sie innerhalb dieser Einstellungen
wechseln:

Automatisch feststellen

Intern

Serielles Gert

gpsd (whlt den Host, Port und das Gert mit dem Ihr GPS verbunden ist)

Ein wiederholter Klick auf [Verbinden] stellt die Verbindung zum GPS-Gert wieder her.
Sie knnen

Hinzugefgte Objekte automatisch speichern aktivieren wenn Sie sich im Bearbeitungsmodus

befinden. Oder Sie knnen


Punkte automatisch hinzufgen aktivieren um Punkte mit einer bestimmten Gre
und Farbe der Kartenansicht hinzuzufgen.
Indem Sie das Kontrollkstchen
Cursor aktivieren, knnen Sie den Schieberegler
wenden, um den Positionscursor im Kartenfenster kleiner oder grer zu machen.

ver-

Das Aktivieren des Radioknopfes


Karte zentrieren ermglicht es auszuwhlen, wie das Kartenfenster aktualisiert werden soll. Dies enthlt immer beim Verlassen, wenn die aufgenommenen Koordinaten den Bereich des
Kartenfensters verlassen oder niemals, um die Kartenausschnitt beizubehalten.
Schliesslich knnen Sie das Kontrollkstchen
ber die GPS-Messung abgelegt werden.

Logdatei aktivieren und einen Pfad angeben, wo die Logdateien

Wenn Sie ein Objekt manuell angeben wollen, mssen Sie zurck zu
hinzufgen] oder [Wegpunkt hinzufgen] klicken.

Position

gehen und dann auf [Punkt

15.2.5 Ein Bluetooth GPS frs Live Tracking anbinden


Mit QGIS knnen Sie ein Bluetooth GPS fr das Aufnehmen von Felddaten anbinden. Um dies durchzufhren
bentigen Sie ein Bluetooth Gert und einen Bluetooth Empfnger auf Ihrem Computer.

15.2. Live GPS tracking

177

QGIS User Guide, Release 2.6

Abbildung 15.6: GPS Tracking Optionsansicht

178

Kapitel 15. Arbeiten mit GPS Daten

QGIS User Guide, Release 2.6

Als erstes mssen Sie Ihr GPS Gert erkennen lassen und mit dem Computer verbinden. Stellen Sie das GPS an,
gehen Sie zum Bluetooth Icon in Ihrem Infobereich und suchen Sie nach einem Neuen Gert.
Vergewissern Sie sich dass auf der rechten Seite Ihrer Gerteauswahlmaske alle Gerte ausgewhlt sind so dass
Ihre GPS Einheit darunter in Erscheinung tritt. Im nchsten Schritt sollte ein serieller Verbindungsservice erhltlich sein, whlen Sie ihn aus und klicken Sie auf den [Verbinden] Knopf.
Denken Sie daran dass die an die GPS Verbindung angebundenen COM Ports aus den Bluetooth Eigenschaften
resultieren.
Machen Sie die Kopplung fr die Verbindung nachdem das GPS erkannt wurde. Normalerweise ist der Authorisationskode 0000.
Now open GPS information panel and switch to GPS options screen. Select the COM port assigned to the GPS
connection and click the [Connect]. After a while a cursor indicating your position should appear.
Wenn QGIS keine GPS Daten empfangen kann sollten Sie Ihr GPS Gert neustarten, 5-10 Sekunden warten
und dann wieder eine Verbindung versuchen. Normalerweise funktioniert diese Lsung. Wenn Sie wieder einen
Verbindungsfehler erhalten vergewissern Sie sich dass kein anderer Bluetoothempfnger, der an die gleiche GPS
Einheit gekoppelt ist, in Ihrer Nhe ist.

15.2.6 GPSMAP 60cs verwenden


MS Windows
Der einfachste Weg, damit es funktioniert ist eine Middleware (Freeware, nicht offen) genannt GPSGate zu verwenden.
Starten Sie das Programm, lassen Sie es nach GPS Gerten suchen (funktioniert sowohl mit USB als Bluetooth
AuGerten), und klicken in Sie in QGIS einfach [Verbinden] wobei Sie im Live Tracking Bedienfeld den
tomatisch feststellen Modus verwenden.
Ubuntu/Mint GNU/Linux
Wie unter Windows ist der einfachste Weg einen Server, in diesem Fall GPSD, dazwischen zu benutzen, also
sudo apt-get install gpsd

Laden Sie dann das garmin_gps Kernelmodul


sudo modprobe garmin_gps

Und verbinden Sie dann die Einheit. berprfen Sie dann mit dmesg die aktuelle von dem Gert verwendete
Einheit, zum Beispiel /dev/ttyUSB0. Starten Sie jetzt gpsd
gpsd /dev/ttyUSB0

Und verbinden Sie sich zuletzt mit dem QGIS Live Tracking Tool.

15.2.7 BTGP-38KM Datenlogger verwenden (nur Bluetooth)


Sie knnen GPSD (unter Linux) oder GPSGate (unter Windows) mhelos verwenden.

15.2.8 BlueMax GPS-4044 Datenlogger verwenden (sowohl BT als auch USB)


MS Windows
Das Live Tracking funktioniert mit USB und BT Modus, mit oder ohne GPSGate, benutzen Sie einfach den
Automatisch feststellen Modus oder stellen Sie das Tool auf den richtigen Port ein.
15.2. Live GPS tracking

179

QGIS User Guide, Release 2.6

Ubuntu/Mint GNU/Linux
Fr USB
Das Live Tracking funktioniert sowohl mit GPSD
gpsd /dev/ttyACM3

or without it, by connecting the QGIS live tracking tool directly to the device (for example /dev/ttyACM3).
Fr Bluetooth
Das Live Tracking funktioniert sowohl mit GPSD
gpsd /dev/rfcomm0

oder ohne es, indem man das QGIS Live Tracking Tool direkt mit dem Gert verbindet (zum Beispiel
/dev/rfcomm0).
.

180

Kapitel 15. Arbeiten mit GPS Daten

KAPITEL 16

GRASS GIS Integration

Das GRASS Plugin bietet den Zugriff zu GRASS GIS Datenbanken und Funktionalitten (siehe GRASS-PRJECT
in Literatur und Internetreferenzen). Dies beinhaltet das Visualisieren von GRASS Raster- und Vektorlayern, das
Bearbeiten von Vektorattributen, das Erstellen von neuen Vektorlayern und das Analysieren von 2-D und 3-D
Daten mit mehr als 400 GRASS Modulen.
In diesem Kapitel bekommen Sie eine Einfhrung in die Plugin Funktionalitten und zeigen Ihnen einige Beispiele
wie man mit GRASS Daten arbeitet und diese verwaltet. Folgende Funktionen stehen ber das GRASS Plugin zur
Verfgung, wenn Sie es wie in Abschnitt GRASS Plugin starten beschrieben laden:

Mapset ffnen

Neues Mapset

Schliesse Mapset

GRASS-Vektorlayer hinzufgen

GRASS-Rasterlayer hinzufgen

Neuen GRASS-Vektorlayer anlegen

GRASS-Vektorlayer bearbeiten

GRASS-Werkzeugkiste ffnen

Aktuelle GRASS-Region darstelllen

Aktuelle GRASS-Region bearbeiten

16.1 GRASS Plugin starten


Um GRASS Funktionalitten zu benutzen und/oder GRASS Vektor- und Rasterlayer in QGIS zu visualisieren
mssen Sie das GRASS Plugin mit dem Pluginmanager auswhlen und laden. Gehen Sie deswegen zum Men
Erweiterungen

Erweiterungen verwalten und installieren ..., whlen Sie

GRASS und klicken Sie [OK].

Sie knnen wie in Abschnitt GRASS Layer visualisieren beschrieben, direkt Raster- und Vektorlayer aus einer existierenden GRASS-Datenbank LOCATION laden (siehe Abschnitt sec_load_grassdata), oder Sie knnen
eine neue GRASS LOCATION mit QGIS erstellten (siehe Abschnitt Eine neue GRASS LOCATION erstellen),
einige Raster- und Vektordaten in diese neue Location importieren (siehe Abschnitt import_loc_data) und ber
die GRASS-Werkzeuge weitere Analysen durchfhren (siehe Abschnitt Die GRASS Werkzeugkiste).

181

QGIS User Guide, Release 2.6

16.2 GRASS Layer visualisieren


Wenn das GRASS-Plugin geladen ist, knnen Sie GRASS Vektor- und Rasterlayer mit den entsprechenden
Knpfen in der Werkzeugleiste laden. Als Beispiel benutzen wir den QGIS Alaska Beispieldatensatz (siehe Kapitel
Beispieldaten). Dieser enthlt eine kleine GRASS LOCATION mit 3 Vektor- und einem Rasterlayer mit Hheninformationen.
1. Erstellen Sie einen neuen Ordner grassdata, laden Sie den QGIS Alaska Datensatz
qgis_sample_data.zip von http://download.osgeo.org/qgis/data/ herunter und entpacken Sie
die Datei nach grassdata.
2. Starten Sie QGIS.
3. Falls noch nicht in einer vorhergehenden QGIS Sitzung geschehen, laden Sie das GRASS Plugin indem Sie
Erweiterungen verwalten und installieren ... klicken und
Erweiterungen
GRASS Werkzeugleiste erscheint im QGIS Hauptfenster.
4. Klicken Sie in der GRASS Werkzeugleiste das
Assistenten zu ffnen.

Mapset ffnen

GRASS aktivieren. Die

Icon um den Whlen Sie ein GRASS Mapset

5. Als Gisdbase suchen und whlen Sie bitte den Pfad zum Ordner grassdata.
6. Sie sollten nun als LOCATION

alaska und als MAPSET

demo auswhlen knnen.

7. Klicken Sie auf [OK]. Einige weitere, zuvor grau hinterlegte GRASS-Werkzeuge sind nun aktiv.
GRASS-Rasterlayer hinzufgen
8. Klicken Sie auf
, whlen Sie den Layer gtopo30 und drcken Sie auf [OK].
Die Hhendaten werden nun dargestellt.
GRASS-Vektorlayer hinzufgen
, whlen Sie den Kartennamen alaska aus und klicken Sie
9. Klicken Sie auf
[OK]. Der Alaska Grenzvektorlayer wird ber die gtopo30 Karte gelegt. Sie knnen jetzt die Layereigenschaften wie in Kapitel Vektorlayereigenschaften beschrieben anpassen (z.B. ndern der Deckkraft, Fllund Umrandungsfarbe).

10. Laden Sie auch noch die weiteren Vektorlayer rivers und airports hinzu und passen Sie deren Layereigenschaften an.
Wie man sehen kann, ist es sehr einfach sich Raster- und Vektordaten aus einer existierenden GRASS-Datenbank
in QGIS anzeigen zu lassen. Lesen Sie die folgenden Kapitel, um zu lernen, wie man GRASS Daten editiert und
eine neue Location erstellt. Weitere Beispiel GRASS-Datenbanken finden Sie auf der GRASS Homepage unter:
http://grass.osgeo.org/download/sample-data/.
Tipp: Probleme beim Laden von GRASS-Layern
Sollten Sie Probleme beim Laden von GRASS-Layern haben oder sich QGIS unvorhergesehen beendet, dann berprfen Sie bitte, ob das GRASS-Plugin korrekt geladen ist wie in Abschnitt GRASS Plugin starten beschrieben.

16.3 Information zur GRASS-Datenbank


GRASS Daten werden in einem Ordner gespeichert, der als GISDBASE bezeichnet wird. Standardmig wird
der Ordner grassdata genannt und er muss erstellt worden sein, bevor man beginnt, mit dem GRASS
Plugin in QGIS zu arbeiten. Innerhalb dieses Ordners sind die GRASS Daten als Projekte in Unterordnern
genannt LOCATIONs organisiert. Jede :file:LOCATION ist durch ein Koordinatenbezugssystem, Kartenprojektion und eine geographische Grenze definiert und kann darberhinaus weitere Unterordner
MAPSETs besitzen, um die Layer der LOCATION weiter z.B. thematisch oder rumlich zu unterteilen (Neteler & Mitasova 2008 literature_and _web). Um Raster- und Vektorlayer mit den GRASS Modulen zu analysieren,
mssen diese zuerst in eine passende GRASS LOCATION importiert werden. (Dies ist nicht ganz korrekt. Mit den
GRASS Modulen r.external und v.external knnen Sie eine read-only Verknpfung zu externen durch

182

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

GDAL/OGR-untersttzte Layer erstellen, ohne die Daten importieren zu mssen. Da dies aber nicht der normale
Weg fr GRASS Anfnger ist, wird auf diese Mglichkeit nicht nher eingegangen.).

Abbildung 16.1: GRASS Daten in der Alaska LOCATION

16.3.1 Eine neue GRASS LOCATION erstellen


Als ein Beispiel mchten wir Ihnen zeigen, wie die GRASS LOCATION des Alaska Beispieldatensatzes erstellt wurde. Das Koordinatenbezugssystem ist Albers Equal Area mit der Einheit feet. Diese GRASS Location
alaska wird fr alle GRASS GIS Beispiele verwendet. Es ist also sinnvoll, sich diesen Datensatz zu installieren
(siehe Abschnitt Beispieldaten).
1. Starten Sie QGIS und stellen Sie sicher dass das GRASS Plugin geladen ist.
2. Visualisieren Sie die alaska.shp Shapedatei (siehe Abschnitt Shape Layer laden) aus dem Alaska Datensatz (siehe Beispieldaten).
3. Klicken Sie in der GRASS Werkzeugleiste auf das
zu ffnen.

Neues Mapset

Icon um den Neues Mapset Assistenten

4. Whlen Sie einen bestehende GRASS Datenbankordner (GISDBASE) grassdata oder erstellen Sie einen
fr die neue LOCATION anhand des Dateimanagers auf Ihrem Computer. Klicken Sie dann [Weiter].
5. Wir knnen diesen Assistenten verwenden um eine neue MAPSET innerhalb einer bestehenden LOCATION
zu erstellen (siehe Abschnitt Eine neue GRASS MAPSET erstellen) oder um dabei auch eine neue
Erstelle neue Location (see figure_grass_location_2).
LOCATION zu erstellen. Whlen Sie
6. Geben Sie einen Namen fr die LOCATION - wir haben alaska verwendet - und klicken Sie [Weiter].
7. Definieren Sie die Projektion indem Sie den Radiobutton
klicken.

Projektion zum Aktivieren der Projektionsliste

8. Wir benutzen Albers Equal Area Alaska (Fu) Projektion. Da wir zufllig wissen dass es durch den EPSG
ID 2964 reprsentiert wird geben wir dies in das Suchfenster ein. (Bemerkung: Wenn Sie diesen Ablauf fr
eine andere LOCATION und Projektion wiederholen wollen und Sie die EPSG ID nicht gespeichert haben,

16.3. Information zur GRASS-Datenbank

183

QGIS User Guide, Release 2.6

klicken Sie auf das


mit Projektionen)).

KBS-Status

Icon in der unteren rechten Ecke der Statusleiste (siehe Abschnitt Arbeiten

9. Geben Sie bei Filter 2964 ein um die Projektion auszuwhlen.


10. Klicken Sie auf [Weiter].
11. Um die Standardregion zu definieren mssen wir die LOCATION Ausdehnung in Nord-, Sd-, Ost- und
Westrichtung eingeben. Hier klicken wir einfach auf den Knopf [Setze aktuelle QGIS-Ausdehung] um die
Ausdehnung des geladenen Layers alaska.shp als voreingestellte GRASS Region Ausmae geltend zu
machen.
12. Klicken Sie auf [Weiter].
13. Wir mssen auch eine MAPSET innerhalb unserer neuen LOCATION definieren (dies ist ntig wenn Sie eine
neue LOCATION erstellen). Sie knnen Sie wie Sie wollen nennen - wir haben demo verwendet. GRASS
erstellt automatisch eine spezielle MAPSET genannt PERMANENT die dazu erstellt wird um Kerndaten fr
das Projekt, seine Standardausmae und Koordinatensystemdefinitionen zu speichern (siehe Neteler & Mitasova 2008 in Literatur und Internetreferenzen).
14. Prfen Sie alles, damit alles wie gewnscht ist. Klicken Sie auf [Abschliessen].
15. Die neue LOCATION, alaska, und zwei MAPSETs, demo und PERMANENT werden erstellt. Die
gerade geffnete Arbeitsumgebung ist demo, wie Sie es definiert haben.
16. Beachten Sie, dass einige Werkzeuge des GRASS Plugins grau hinterlegt waren und nun auch zur Verfgung
stehen.

Abbildung 16.2: Erstellen einer neuen GRASS LOCATION oder einer neuen MAPSET in QGIS
Wenn das wie eine Menge von Schritten schien ist es doch nicht so schlimm und ein schneller Weg eine
LOCATION zu erstellen. Die LOCATION alaska is jetzt bereit fr den Datenimport (siehe Abschnitt Daten
in eine GRASS LOCATION importieren). Sie knnen auch die bereits bestehenden Vektor- und Rasterdaten in der
Beispiel GRASS LOCATION alaska verwenden, die im QGIS Alaska Datensatz Beispieldaten enthalten ist und
weiter zu Abschnitt Das GRASS Vektormodell gehen.

184

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

16.3.2 Eine neue GRASS MAPSET erstellen


Ein Benutzer hat nur Schreibzugriff auf eine MAPSET die er oder sie erstellt hat. Das heit dass Sie neben dem
Zugriff zu Ihrer eigenen MAPSET Sie Karten in MAPSETs anderer Benutzer lesen knnen (und Sie knnen Ihre
lesen) aber Sie nur die Karten in Ihrer eigenen MAPSET verndern und lschen knnen.
Alle MAPSETs beinhalten eine WIND Datei die die aktuellen Grenzkoordinatenwerte und die aktuell ausgewhlte
Rasterauflsung speichert (siehe Neteler & Mitasova 2008 in Literatur und Internetreferenzen, und Abschnitt
Einstellung der GRASS Region).
1. Starten Sie QGIS und stellen Sie sicher dass das GRASS Plugin geladen ist.
Neues Mapset

2. Klicken Sie in der GRASS Werkzeugleiste auf das


zu ffnen.

Icon um den Neues Mapset Assistenten

3. Whlen Sie den GRASS Datenbankordner (GISDBASE) grassdata mit der LOCATION alaska aus wo
Sie eine weitere MAPSET genannt test hinzufgen wollen.
4. Klicken Sie auf [Weiter].
5. Wir knnen diesen Assistenten verwenden um eine neue MAPSET innerhalb einer bestehenden LOCATION
Erstelle neue Location
zu erstellen oder um dabei auch eine neue LOCATION zu erstellen. Whlen Sie
(see figure_grass_location_2) und klicken Sie [Weiter].
6. Geben Sie den Namen test fr die neue :file:MAPSET ein. Unter dem Assistenten sehen
Sie eine List bestehender MAPSETs und die entsprechenden Besitzer.
7. Klicken Sie auf [Weiter], prfen Sie die Einstellungen und drcken Sie dann auf [Abschlieen].

16.4 Daten in eine GRASS LOCATION importieren


Dieser Abschnitt zeigt ein Beispiel wie man Raster- und Vektordaten in die alaska GRASS LOCATION aus dem
QGIS Alaska Datensatz importiert. Daher verwenden wir die Landcover Rasterkarte landcover.img und die
GML Vektorkarte lakes.gml aus dem QGIS Alaska Datensatz (siehe Beispieldaten).
1. Starten Sie QGIS und stellen Sie sicher dass das GRASS Plugin geladen ist.
2. Klicken Sie in der GRASS Werkzeugleiste das
Assistenten zu starten.

Mapset ffnen

Icon um den Whlen Sie ein GRASS Mapset

3. Whlen Sie als GRASS Datenbank den Ordner grassdata aus dem QGIS Alaskadatensatz, als
LOCATION alaska, als MAPSET demo aus und klicken Sie [OK].
GRASS-Werkzeugkiste ffnen
4. Nun klicken Sie auf das Icon
, damit die GRASS Werkzeuge (siehe Abschnitt Die
GRASS Werkzeugkiste) zur Verfgung stehen.

5. Um die Rasterkarte landcover.img zu importieren, drcken Sie auf das Modul r.in.gdal im Modulbaum Reiter. Diese GRASS Module ermglicht es, GDAL-untersttzte Rasterdateien in eine GRASS
LOCATION zu importieren.
6. Browsen Sie zum Ordner raster im QGIS Alaska Datensatz und whlen Sie die Datei
landcover.img .
7. Definieren Sie als Rasterausgabename landcover_grass und klicken Sie [Starten].
Im Reiter Ergebnis knnen Sie den gerade laufenden GRASS Befehl r.in.gdal -o
input=/path/to/landcover.img output=landcover_grass sehen.
8. Wenn Erfolgreich beendet erscheint klicken Sie [Ergebnis visualisieren]. Der landcover_grass
Rasterlayer ist jetzt in GRASS importiert und wird in der QGIS Kartenansicht visualisiert.
9. Um die GML Vektordatei lakes.gml zu importieren klicken Sie das Modul v.in.ogr im Modulbaum
Reiter. Dieses GRASS Modul ermglicht den Import con OGR-untersttzen Vektordateien in eine GRASS
LOCATION. Der Moduldialog fr v.in.ogr erscheint.

16.4. Daten in eine GRASS LOCATION importieren

185

QGIS User Guide, Release 2.6

10. Browsen Sie zum Ordner gml im |qg| Alaska Datensatz und whlen Sie die
Datei :file:lakes.gml als OGR Datei aus.
11. Definieren Sie lakes_grass als Vektorausgabenamen und klicken Sie [Starten]. Sie brauchen sich in
diesem Beispiel nicht um andere Optionen kmmern. Im Reiter Ergebnis sehen Sie den aktuell laufenden
GRASS Befehl v.in.ogr -o dsn=/path/to/lakes.gml output=lakes\_grass.
12. Wenn Erfolgreich beendet erscheint klicken Sie [Ergebnis visualisieren]. Der lakes_grass Vektorlayer ist jetzt in GRASS importiert und wird in der QGIS Kartenansicht visualisiert.

16.5 Das GRASS Vektormodell


Es ist wichtig das GRASS Vektordatenmodell vor dem Digitalisieren zu verstehen.
GRASS nutzt ein topologisches Datenmodell.
Das bedeutet, dass Flchen nicht als geschlossene Polygone vorhanden sind, sondern als ein oder mehrere Umrandungen (Boundaries). Eine Umrandung (Boundary) zwischen zwei aneinander grenzenden Flchen ist nur einmal
digitalisiert worden; beide Flchen teilen sich diese Umrandung. Umrandungen drfen keine Lcken haben. Eine
Flche besteht also aus einer Umrandung und einem Zentroid, der diese Flche als ein sog. Labelpunkt mit einer
Attributtabelle verknpft.
Neben den Umrandungen und Zentroiden kann eine Vektorkarte selbstverstndlich auch Punkte und Linien enthalten. Alle diese Geometrieelemente knnen innerhalb ein und dem selben Datensatz enthalten sein. Sie werden
in unterschiedlichen Ebenen innerhalb von QGIS dargestellt. Auch wenn es mglich ist, Geometrieelemente zu
mischen, so ist es eigentlich unblich und wird normalerweise auch in GRASS GIS nur selten verwendet. Etwa bei
Netzwerkanalysen. Im Normalfall sollten Sie versuchen, unterschiedliche Geometrietypen in unterschiedlichen
Datenstzen (Layern) zu speichern.
Es ist auch mglich, unterschiedliche Inhalte des gleichen Geometrietyps in verschiendenen Ebenen eines Vektorlayers zu speichern. Beispielsweise knnen Felder, Wlder und Seen in einem Vektordatensatz gespeichert
werden. Angrenzende Seen, Felder und Wlder teilen sich dann die gleiche Umrandung, jedoch haben sie separate Attributtabellen, die ber ihre Ebene angesprochen wird. Darber hinaus knnen Sie auch Attribute fr die
Umrandungen vergeben, falls eine Umrandung gleichzeitg einen Weg darstellt. In diesem Fall knnte auch die
Umrandung eine separate Attributtabelle haben.
Die Ebene eines jeden Objektes wird in GRASS intern als layer bezeichnet. Layer ist die Nummer die
definiert ob es mehr als einen Layer innerhalb des Datensatzes gibt (z.B. ob die Geometrie Wald oder See ist). Vorerst kann dies nur eine Nummer sein. In Zukunft wird GRASS auch Namen als Felder in der Benutzeroberflche
untersttzen.
Attribute knnen innerhalb der GRASS LOCATION als dBase oder SQLite3 oder in externen Datenbanktabellen
abgelegt werden, z.B. PostgreSQL, MySQL, SQLITE3, etc.
Die Attribute in den Tabellen werden ber ein sog. Kategoriefeld an die Geometrien des Datensatzes gehngt.
Die Kategorie (oder key, ID, etc) ist eine Ganzzahl, ber die eine Verknpfung zwischen den Geometrien und
den Spalten in der Datenbanktabelle hergestellt wird.
Tipp: Das GRASS Vektormodell verstehen
Der beste Weg, etwas ber das GRASS Vektordatenmodell und seine Fhigkeiten zu erfahren, ist das
Studieren eines der vielen verfgbaren GRASS-Tutorien, wo dieses Thema vertieft behandelt wird. Unter
http://grass.osgeo.org/documentation/manuals/ sind eine Vielzahl weiterer Informationsquellen, Bcher und Tutorien in unterschiedlichen Sprachen vorhanden.

186

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

16.6 Einen neuen GRASS Vektorlayer erstellen


Um einen neuen GRASS Vektorlayer mit dem GRASS plugin zu erstellen klicken Sie das
Neuen GRASS-Vektorlayer anlegen
Werkzeugleistenicon. Geben Sie einen Namen in das Textfenster ein und Sie knnen
mit dem Digitalisieren von Punkt-, Linien- oder Polygongeometrien beginnen indem Sie wie in Abschnitt Digitalisieren und Editieren eines GRASS Vektorlayers verfahren.
GRASS GIS erlaubt es aufgrund des topologischen Datenmodells, die verschiedenen Geometrietypen (Punkt,
Linie und Flche) in einem Vektorlayer abzuspeichern. Aus diesem Grund ist es nicht notwendig im Vorfeld
einen Geometrietyp festzulegen. Dies unterscheidet sich von der Erstellung eines neuen Shapefile in QGIS, denn
Shapefiles verwenden das Simple Feature Vektormodell (siehe Abschnitt Neue Vektorlayer erstellen).
Tipp: Erstellen einer Attributtabelle fr einen neuen GRASS Vektorlayer
Wenn Sie fr ihre digitalisierten Geometrien auch eine Attributtabelle erstellen wollen, mssen Sie nach dem
Anlegen des GRASS-Vektorlayers eine Attributtabelle mit entsprechenden Spalten erstellen, bevor Sie mit dem
Digitalisieren beginnen (siehe figure_grass_digitizing_5).

16.7 Digitalisieren und Editieren eines GRASS Vektorlayers


GRASS-Vektorlayer bearbeiten
in der
Die Digitalisierwerkzeuge fr GRASS-Vektorlayer werden ber den Knopf
GRASS-Werkzeugleiste gestartet. Dazu mssen Sie den zu bearbeitenden Layer in der Legende auswhlen, bevor
Sie auf den Editier-Knopf drcken. Abbildung figure_grass_digitizing_2 zeigt den Dialog fr die GRASS Digitalisierung. Die einzelnen Werkzeuge werden im folgenden Kapitel beschrieben.

Tipp: Polygone in GRASS digitalisieren


Wenn Sie ein Polygon innerhalb eines GRASS Vektorlayers erstellen wollen, digitalisieren Sie zuerst die Boundary der Flche mit der Moduseinstellung Keine Kategorie. Danach fgen Sie einen Zentroid (Labelpunkt) mit
der Moduseinstellung Nchst folgender Kategoriewert hinzu. Der Grund ist, dass in topologischen Layern die
Attributinformationen einer Flche immer mit dem Zentroiden und nicht mit der Grenze verknpft werden.
Werkzeugleiste
In figure_grass_digitizing_1 sehen Sie die GRASS Digitalisieren Werkzeugleisten Icons, die vom GRASS Plugin zur Verfgung gestellt werden. Tabelle table_grass_digitizing_1 erklrt die verfgbaren Funktionalitten.

Abbildung 16.3: GRASS Digitalisieren Werkzeugleiste

16.6. Einen neuen GRASS Vektorlayer erstellen

187

QGIS User Guide, Release 2.6

Icon Werkzeug

Zweck

Neuer
Punkt

Digitalisiert neuen Punkt

Neue Linie

Digitalisiert neue Linie

Neue
Grenze

Digitalisiert neue Grenze (zum Beenden ein neues Werkzeug whlen)

Neuer
Zentroid

Digitalisiert neuen Zentroiden (Labelpunkt fr eine existierende Flche)

Verschiebe
Vertex

Whlt einen Sttzpunkt einer existierenden Linie oder Umrandung und setzt diesen an
eine neue Position

Vertex
hinzufgen

Fgt einen Sttzpunkt zu einer existierenden Linie hinzu

Lsche
Vertex

Lscht einen Sttzpunkt von einer existierenden Linie (Besttigung der Auswahl durch
einen weiteren Klick ntig)

Verschiebe
Element

Whlt existierende Grenze, Linie oder Zentroiden und verschiebt sie an eine neue
Position

Unterteile
Linie

Unterteile eine bestehende Linie in zwei Teile

Element
lschen

Lscht eine existierende Geometrie inklusive des Eintrags in der Attributtabelle


(Besttigung der Auswahl durch einen weiteren Klick ntig).

Editiere
Attribute

Editiert Attribute eines existierenden Objekts (Beachten Sie, dass ein Objekt mehrere
Feature reprsentieren kann, siehe oben)

Schlieen

Beendet die Bearbeitung (und aktualisiert die Topolgie anschlieend)

Tabelle GRASS Digitizing 1: GRASS Digitalisierwerkzeuge


Reiter Kategorie
In dem Reiter Kategorie knnen Sie einstellen, in welcher Weise Kategoriewerte neuen Objekten oder neue Kategoriewerte vorhandenen Objekten zugewiesen werden sollen.

Abbildung 16.4: GRASS Digitalisieren Kategorie Reiter


Modus: Der Kategoriewert der auf neuen Geometrieelemente angewendet wird.
Nchst folgender Kategoriewert - Der nchste noch nicht verwendete Kategoriewert wird auf das Ge-

188

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

ometrieelement angewendet
Manueller Eintrag - Definieren Sie den Kategoriewert fr das Geometrieelement manuell im Kategorie Eingabefeld.
Keine Kategorie - Wendet keinen Kategoriewert auf das Geometrieelement an. Dies wird z.B. fr
Flchengrenzen verwendet, da die Kategoriewerte ber den Zentroiden angebunden werden.
Kategorie - Die Nummer (ID) die an jedes digitalisierte Geometrieelement angehngt wird. Sie wird verwendet um jedes Geometrieelement mit seinen Attributen zu verbinden.
Feld (Layer) - Jedes Geometrieelement kann mit mehreren Attributtabellen, die verschiedene GRASS Geometrielayer verwenden, verknpft werden. Die voreingestellte Layernummer ist 1.
Tipp: Einen zustzlichen GRASS layer mit |qg| erstellen
Wenn Sie gerne mehr Layer zu Ihrem Datensatz hinzufgen wollen tragen Sie einfach eine neue Nummer im Feld
(Layer) Eingabefeld ein und drcken Sie Eingabe. Im Reiter Tabelle knnen Sie Ihre neue Tabelle, die dann an
den neuen Layer angebunden ist, erstellen.
Reiter Einstellungen
Der Reiter Einstellungen erlaubt das Setzen der Fangtoleranz in Bildschirmpixeln. Dies ist der Schwellenwert
in Pixeln, innerhalb dessen neu digitalisierte Knotenpunkte an vorhandene Knoten gesnappt werden. Dies hilft,
Lcken oder berlagerungen zwischen Objekten zu vermeiden. Der Standardwert ist auf 10 Pixel eingestellt.

Abbildung 16.5: GRASS Digitalisieren Einstellungen Reiter


Darstellung Reiter
Der Reiter Darstellung erlaubt die Farbeinstellungen fr die verschiedenen Geometrietypen und ihren Topologiestatus (z.B. offene/geschlossene Flche).
Reiter Tabelle
Der Reiter Tabelle stellt Informationen ber die Datenbanktabelle fr einen gegebenen layer bereit. Hier knnen
Sie neue Spalten in eine bestehende Attributtabelle einfgen oder eine neue Datenbanktabelle fr einen neuen
GRASS Vektorlayer erstellen (siehe Abschnitt Einen neuen GRASS Vektorlayer erstellen).
Tipp: GRASS Schreibberechtigung
Sie mssen der Besitzer der GRASS MAPSET, die Sie bearbeiten wollen, sein. Es ist unmglich Datenlayer in
einer MAPSET die Ihnen nicht gehrt zu bearbeiten, auch wenn Sie Schreibrechte darauf haben.

16.7. Digitalisieren und Editieren eines GRASS Vektorlayers

189

QGIS User Guide, Release 2.6

Abbildung 16.6: GRASS Digitallisieren Darstellung Reiter

Abbildung 16.7: GRASS Digitalisiern Tabelle Reiter

190

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

16.8 Einstellung der GRASS Region


Die Region Einstellung (Einstellung eines rumlichen Arbeitsfensters) in GRASS ist wichtig fr das Arbeiten mit
Rasterlayern. Vektoranalysen sind standardmig nicht auf eine definierte Region Definition begrenzt. Aber alle
neu erstellten Raster werden die rumliche Ausdehnung und Auflsung der gerade definierten GRASS Region
haben, unabhngig von Ihrer ursprnglichen Ausdehnung und Auflsung. Die aktuelle GRASS Region ist in der
$LOCATION/$MAPSET/WIND Datei gespeichert und Sie definiert die Nord-, Sd-. Ost- und Westgrenze, die
Anzahl von Spalten und Reihen sowie die horizontale und vertikale rumliche Auflsung.
Es ist mglich die Visualisierung der GRASS Region in der QGIS Kartenansicht ein- und auszuschalten indem
Sie den

Aktuelle GRASS-Region darstellen

Knopf verwenden.

Aktuelle GRASS-Region bearbeiten


Mit dem
Icon knnen Sie einen Dialog zum ndern der aktuellen Region und der
Darstellung des GRASS-Region Rechtecks im QGIS Kartenfenster ffnen. Geben Sie die neuen Region Ausmae
und Auflsung eine und klicken Sie [OK]. Der Dialog ermglicht Ihnen auch aktiv eine neue Region mit Ihrer
Maus im QGIS Kartenfenster auszuwhlen. Klicken Sie zu diesem Zweck mit der linken Maustaste in das QGIS
Kartenfenster, ffnen Sie ein Rechteck, schlieen Sie es mit Hilfe der linken Maustaste und klicken Sie [OK].

Das GRASS Modul g.region bietet viele weitere Optionen zur Einstellung der passenden Ausdehnung und
Auflsung der Region fr die Rasteranalyse. Das Modul g.region knnen Sie ber die GRASS Werkzeugkiste
nutzen, wie in Kapitel Die GRASS Werkzeugkiste beschrieben.

16.9 Die GRASS Werkzeugkiste


GRASS-Werkzeugkiste
ermglicht es, GRASS Module auf Daten innerhalb einer ausgewhlten GRASS
Die
LOCATION und MAPSET anzuwenden. Dazu muss im Vorfeld eine GRASS LOCATION und MAPSET geffnet
werden, in der Sie Schreibrechte besitzen. Dies ist normalerweise garantiert, wenn Sie die MAPSET selbst erstellt
haben und notwendig, damit die Ergebniskarten der Raster- und Vektoranalysen in der ausgewhlten LOCATION
und :file:MAPSET gespeichert werden knnen.

16.9.1 Arbeiten mit GRASS Modulen


Die GRASS Shell der Werkzeugkiste bietet Zugriff auf fast alle (mehr als 300) GRASS Module ber die Kommandozeile. Um eine benutzfreundlichere Umgebung zu bieten, sind davon etwa 200 Module graphisch auswhlbar
und bieten einen Dialog in Form eines zustzlichen Reiters in der Werkzeugkiste.
Eine vollstndige Liste von GRASS Modulen die in der grafischen Werkzeugkiste der QGIS Version 2.6 verfgbar
sind knnen Sie im GRASS Wiki unter http://grass.osgeo.org/wiki/GRASS-QGIS_relevant_module_list finden.
Es ist auerdem mglich, die GRASS Werkzeugkiste anzupassen und weitere Module zu integrieren. Die Herangehensweise ist in Abschnitt Anpassen der Module beschrieben.
Wie in Abbildung figure_grass_toolbox_1 zu sehen, knnen Sie nach dem passenden GRASS Modul in dem
Reiter Modulbaum nachschauen oder im Reiter Modulliste suchen.
Wenn Sie auf das grafische Icon eines Modules klicken, ffnet sich ein neuer Moduldialog mit drei Reitern Optionen, Ergebnis und Handbuch.
Optionen
Der Reiter Optionen stellt Ihnen einen Moduldialog in vereinfachter Form, in dem sie gewhnlicherweise einen
Raster- oder Vektorlayer, der in der QGIS Kartenansicht visualisiert ist, auswhlen knnen und weitere modulspezifische Parameter, um die Module zum Laufen zu bringen, eingeben knnen.
Die zur Verfgung gestellten Modulparameter sind oftmals nicht vollstndig um den Dialog einfach zu halten.
Wenn Sie weitergehende Modulparamter und -flags verwenden wollen mssen Sie die GRASS Shell starten und
das Programm in der Kommandozeile benutzen.

16.8. Einstellung der GRASS Region

191

QGIS User Guide, Release 2.6

Abbildung 16.8: GRASS Werkzeuge und Modulbaum

192

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

Abbildung 16.9: GRASS Werkzeuge Modul Optionen

16.9. Die GRASS Werkzeugkiste

193

QGIS User Guide, Release 2.6

Eine neue Funktion seit der QGIS Version 1.8.0 ist der Knopf Fortgeschrittene Optionen einblenden unterhalb
der vereinfachten Moduldialoge im Reiter Optionen. Momentan ist diese Funktion nur fr das Modul v.in.ascii
umgesetzt. Es ist aber zuknftig fr weitere Module vorgesehen und wird so die kompletten Funktionen der
GRASS Module grafisch bereitstellen, ohne die GRASS Shell und somit die Kommandozeile benutzen zu mssen.
Ergebnis

Abbildung 16.10: GRASS Werkzeuge Modul Ergebnis


Der Reiter Ergebnis stellt die Ausgabe des Moduls zur Laufzeit dar. Nachdem Sie den Knopf [Los] gedrckt
haben, wird auf diesen Reiter gewechselt und Sie sehen die Statusausgaben des Moduls. Wenn alles funktioniert
hat, sehen Sie den Ausgabetext Erfolgreich beendet.
Handbuch
Der Reiter Handbuch zeigt die HTML Hilfeseite der GRASS Module. Sie knnen es zum berprfen weitergehender Modulparameter oder -flags oder um vertieftere Kenntnisse ber den Anwendungszweck der Module zu
erwerben benutzen. Am Ende jeder Modul Handbuchseite sehen Sie weiterfhrende Links zum Main Help
index, dem Thematic index und dem Full index. Diese Links stellen die gleiche Information wie das
Modul g.manual zur Verfgung.
Tipp: Ergebnisse direkt anzeigen
Wollen Sie Ihre Ergenisse direkt in der Kartenansicht ansehen, nutzen Sie den Knopf Ergebnis visualisieren im
unteren Bereich des jeweiligen Modulreiters

194

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

Abbildung 16.11: GRASS Werkzeuge Modul Handbuch

16.9. Die GRASS Werkzeugkiste

195

QGIS User Guide, Release 2.6

16.9.2 GRASS Beispielanwendung


Die folgenden Beispiele sollen die Anwendung verschiedener GRASS Module demonstrieren.
Hhenlinien aus einem DGM erstellen
Im ersten Beispiel wird eine Hhenlinienkarte aus einem Hhenraster (DEM) erstellt. Hier wird angenommen dass
Sie die Alaska LOCATION wie in Abschnitt Daten in eine GRASS LOCATION importieren eingerichtet haben.
Als erstes ffnen Sie die Location, indem Sie auf das
Location auswhlen.

Mapset ffnen

Nun laden Sie den gtopo30 Rasterlayer, indem Sie auf das Icon
den Layer gtopo30 aus der Alaska Location auswhlen und laden.
Als nchstes drcken Sie auf das Icon

GRASS-Werkzeugkiste ffnen

Icon klicken und dann die Alaska


GRASS-Rasterlayer hinzufgen

klicken und

In der Liste von Werkzeugkategorien doppelklicken Sie auf Raster Oberflchenverwaltung Vektorkonturlinien erzeugen.
Jetzt wird ein einfacher Klick auf das Werkzeug r.contour einen Werkzeugdialog wie oben beschrieben
ffnen (siehe Arbeiten mit GRASS Modulen). Die gtopo30 Rasterdatei sollte als Name der EingabeRasterkarte erscheinen.
Geben Sie im Feld Abstand zwischen den Kontourintervallen
Hhenlinien in einem Abstand von 100m erstellt.)

den Wert 100 an. (Dadurch werden

In das Feld Name der Vektorausgabekarte geben Sie den Namen hoehen_100 an.
Klicken Sie [Starten] um den Prozess zu starten. Warten Sie mehrere Momente bis die Nachricht
Erfolgreiche beendet im Ergebnisfenster auftaucht. Klicken Sie dann [Ergebnis visualisieren] und
[Schlieen].
Da die aktuelle GRASS Region ziemlich gro ist, kann es eine Weile dauern, bis der Layer vollstndig dargestellt
wird. Danach knnen Sie noch die Layereigenschaften verndern und eine Farbe fr die Linien auswhlen, die
sich deutlich vom Hhenmodell unterscheidet, siehe Vektorlayereigenschaften.
Als nchstes zoomen Sie in einen bergigen Bereich im Zentrum Alaskas. Wenn Sie weit genug in die Karte
hineingezoomt sind, werden Sie erkennen, dass die Hhenlinien teilweise sehr eckig erscheinen. Um das Erscheinungsbild zu optimieren, bietet GRASS ein Modul mit dem Namen v.generalize. Dabei wird mit Hilfe
des Douglas Peuker Algorithmus und der einer Reduktion der Sttzpunkte eine Glttung der Linien erreicht,
ohne die Geometrien zu zerstren. Da der Ergebnislayer weniger Sttzpunkte hat, ist er auch kleiner und kann
schneller geladen werden. Die Analyse wird z.B. angewendet, wenn man sehr detailierte Daten nur in einem
kleinen Mastab anzeigen mchte.
Tipp: Geometrien in QGIS vereinfachen
Beachten Sie dass das QGIS fTools Plugin ber ein Geometrien vereinfachen Werkzeug verfgt das genauso
wie der GRASS v.generalize Douglas-Peuker Algorithmus funktioniert.
In diesem Beispiel wollen wir nun aber etwas anderes erreichen. Die Hhenlinien, die wir mit r.contour erstellt haben, zeigen teilweise sehr scharfe Winkel, die wir gltten mchten. Unter den Algorithmen des Moduls
v.generalize befindet sich auch der Chaikens-Algorithmus, der exakt das macht, was wir mchten (auch Hermite Splines). Achten Sie aber darauf, dass es passieren kann, dass Sttzpunkte nicht nur eliminiert sondern auch
hinzugefgt werden knnen. Dadurch kann der Layer wieder langsamer geladen werden.
ffnen Sie die GRASS Werkzeugkiste und doppelklicken Sie die Kategorien Vektor Karte entwickeln
Generalisierung und klicken Sie dann auf das v.generalize Modul um sein Optionsfenster zu ffnen.
Stellen Sie sicher, dass hoehen_100 als Vektorlayer in Feld Name der Vektoreingabekarte erscheint.

196

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

Aus der Liste mglicher Algorithmen whlen Sie nun Chaikens. Belassen Sie alle weiteren Optionen
wie sie sind und gehen Sie zum Ende des Dialogs, wo Sie als Name der Vektorausgabekarte hoehen_100_smooth angeben. Drcken Sie nun auf [Starten].
Der Prozess dauert eine Weile. Sobald Erfolgreich beendet im Reiter Ergebnis erscheint, drcken
Sie wieder auf [Ergebnis visualisieren] und dann auf [Schlieen].
ndern Sie nun auch die Farbe des neuen Layers, damit er sich deutlich von dem Hhenmodell und
den zuvor berechneten Hhenlinien abhebt. Sie werden erkennen, dass die Kanten der neuen Hhenlinien
wesentlich weicher gezeichnet sind.

Abbildung 16.12: GRASS Moduk v.generalize zum Gltten einer Vektorkarte


Tipp: Vektorlinien gltten mit dem GRASS Modul v.generalize
Die oben beschriebene Anwendung kann auch in anderen Situationen verwendet werden. Wenn Sie z.B. eine
Rasterkarte mit Niederschlagswerten haben, knnen Sie mit r.contour einen Isohyetallayer (konstanter Niederschlag) erstellen.

Erstellen eines 3D Schummerungseffekts


Es gibt verschiedene Methoden, um Hhenlayer anzuzeigen und ihnen einen 3D Schummerungseffekt zu verleihen. Der Gebrauch von Hhenlinien ist eine populre Methode, die hufig angewendet wird, um topographische
Karten zu erstellen. Eine andere Mglichkeit, um einen 3D Effekt zu erzeugen ist, bietet das Hillshading. Der
Effekt basiert dabei auf einem Hhenmodell. Dabei wird zuerst die Hangneigung und -richtung der Zellen bestimmt und dann durch die Simulation des Sonnenstandes eine Reflexionswert erzeugt. Dadurch werden der Sonne
zugewandte Bereiche aufgehellt und der Sonne abgewandte Bereiche (im Schatten) dunkler dargestellt.
Fangen Sie mit diesem Beispiel an indem Sie zuerst den Rasterlayer gtopo30 laden. ffnen Sie die
GRASS-Werkzeugkiste und unter der Raster Kategorie wechseln Sie in den Bereich Rumliche Analysen
Gelndeanalyse.
Nun klicken Sie auf r.shaded.relief, um den Modulreiter zu ffnen.
ndern Sie den Wert im Feld Winkel der Sonne in Grad stlich von der Nordrichtung

270 auf 315.

Geben Sie als Name der Schummerungskarte den Namen gtopo30_shade an und klicken Sie auf
[Starten].
Nachdem die Karte berechnet wurde, visualisieren Sie sie und setzen Sie die Farbe des Rasterlayers auf
Graustufen.
16.9. Die GRASS Werkzeugkiste

197

QGIS User Guide, Release 2.6

Um die Schummerung und das Hhenmodell gtopo30 zusammen zu sehen, ziehen Sie die Schummerungskarte in der Legende unter das Hhenmodell. ffnen Sie dann den Dialog Layereigenschaften der
Karte gtopo30, und ndern Sie die Transparenz im Reiter Transparenz auf den Wert 25%.
Die Hhenkarte gtopo30 wird nun als Farbkarte leicht transparent ber der Schummerungskarte angezeigt.
Dadurch entsteht ein visueller 3D Effekt. Um den Unterschied besser zu erkennen, wechseln Sie ber das Kontrollkstchen den Anzeigemodus der Schummerungskarte in der Legende und wieder zurck.
Die GRASS Kommandozeile verwenden
Das GRASS Plugin in QGIS stellt die GRASS Module oftmals in vereinfachter Form und auch nicht vollstndig
bereit. Es ist also grundstzlich fr Anwender gestaltet, die sich nicht so gut mit GRASS und all seinen Fhigkeiten auskennen oder nur einfache Analysen durchfhren wollen. Daher werden in den grafischen Moduldialogen
oftmals nicht alle Optionen und Parameter, die das GRASS Modul bieten bereitgestellt, um den Umgang einfacher
und intuitiver zu gestalten. Wer tiefer in GRASS einsteigen mchte, er hat die Mglichkeit, smtliche Funktionalitten und Module ber die GRASS Kommandozeile (GRASS Shell) anzusprechen. In dem folgenden Beispiel
soll eine zustzliche Option des Moduls r.shaded.relief angesprochen werden, die nur ber die Kommandozeile
genutzt werden kann.

Abbildung 16.13: Die GRASS Shell, Modul r.shaded.relief


Das Modul r.shaded.relief stellt einen zustzliche Parameter zmult bereit, ber den der Hhenwert relativ zu
den X-Y Werten multipliziert werden kann. Dadurch wird der Schummerungseffekt noch prgnanter.
Laden Sie das Hhenmodell gtopo30 wie im vorherigen Beispiel. ffnen Sie die GRASS-Werkzeugkiste
und klicken auf die GRASS Shell. In das Kommandozeilenfenster tippen Sie folgenden Befehl
r.shaded.relief map=gtopo30 shade=gtopo30_shade2 azimuth=315 zmult=3 und
drcken dann die Taste [Enter].
Wenn die Berechnung abgeschlossen ist, wechseln Sie in den Reiter Browser und Doppelklicken Sie auf die
neu erstellte Karte gtopo30_shade2, um Sie in QGIS anzuzeigen.
Wie oben erklrt verschieben Sie die Schummerungskarte unter das gtopo30 Raster in der Legende, berprfen Sie dann die Transparenz des farbigen gtopo30 Layers. Sie sollten dabei erkennen, dass der Schummerungseffekt strker verglichen mit der ersten Schummerungskarte ist.

198

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

Abbildung 16.14: Darstellen einer Schummering erstellt mit dem GRASS Modul r.shaded.relief
Rasterstatistik auf Basis eines Vektorlayer berechnen
Das folgende Beispiel zeigt, wie man univariate Statistik fr Rasterwerte innerhalb von Vektorpolygonen berechnen kann und die Werte in neue Attributspalten des Vektorlayers hinzufgt.
Verwenden Sie wieder die Alaska Location (siehe Abschnitt Daten in eine GRASS LOCATION importieren),
und importieren Sie das Shapefile trees aus dem Ordner shapefiles nach GRASS.
Jetzt ist ein Zwischenschritt ntig: es mssen Zentroiden zu der importierten Baumkarte hinzugefgt werden
um es zu einem kompletten GRASS Flchenvektor (der sowohl Umrandungen als auch Zentroide enthlt)
zu machen.
Whlen Sie aus der Werkzeugkiste Vektor Karte entwickeln Objekte verwalten und ffnen Sie das
Modul v.centroids.
Geben Sie als Name fr die Ausgabe-Vektorkarte forest_areas an und starten Sie das Modul.
Nun laden Sie den neuen Layer forest_areas und visualisieren Sie die verschiedenen Waldtypen in
verschiedenen Farben - deciduous, evergreen und mixed. Dazu ffnen Sie den Dialog Eigenschaften des
Layers, wechseln zum Reiter Darstellung, whlen
Eindeutiger Wert und setzen das Klassifikationsfeld auf VEGDESC (siehe auch die Beschreibung des Reiters Darstellung in Abschnitt Men Stil des
Vektordatenabschnitts).
Als nchstes ffnen Sie wieder die GRASS-Werkzeugkiste und wechseln nach Vektor Vektor mit anderen
Karten aktualisieren.
Klicken Sie auf das v.rast.stats Modul. Geben Sie gtopo30 und forest_areas ein.
Nun fehlt nur noch ein Parameter: Geben Sie als Spaltenprfix elev an, und klicken Sie dann auf [Starten].
Die Berechnung wird ziemlich lange dauern (wahrscheinlich bis zu zwei Stunden).
Schlielich ffnen Sie den Layer forest_areas erneut und lassen Sie sich die Attributtabelle anzeigen.
Dort gibt es nun weitere Spalten einschlielich elev_min, elev_max, elev_mean usw. fr jedes Waldpolygon.

16.9.3 Der GRASS Datei-Browser


Eine weitere interessante Funktion in den GRASS-Werkzeugen ist der GRASS LOCATION Browser.
In figure_grass_module_7_ knnen Sie die aktuelle :file:LOCATION mit den dazu

16.9. Die GRASS Werkzeugkiste

199

QGIS User Guide, Release 2.6

gehrigen MAPSETs sehen.


In der linken Hlfte des Datei-Browsers knnen Sie sich alle in der aktuellen LOCATION enthaltenen MAPSETs
anschauen. In der rechten Hlfte des Fensters sehen Sie weitere Metainformationen zum ausgewhlten Datensatz
(beispielsweise Auflsung, BoundingBox, Datenquelle, bei Vektordaten die Attributtabelle und die COMMAND
Geschichte).

Abbildung 16.15: GRASS LOCATION Browser


Die Werkzeugleiste im Browser Reiter stellt folgende Werkzeuge fr die ausgewhlte LOCATION zur Verfgung:

Ausgewhlten Layer dem Kartenfenster hinzufgen

Gewhlte Karte kopieren

Gewhlte Karte umbenennen

Gewhlte Karte lschen

200

Kapitel 16. GRASS GIS Integration

QGIS User Guide, Release 2.6

Setze die Region auf die gewhlte Karte

Neu zeichnen

Die Knpfe
Gewhlte Karte umbenennen und
Gewhlte Karte lschen stehen nur fr die aktuelle
MAPSET zur Verfgung. Die anderen Werkzeuge funktionieren auch in den anderen MAPSETs.

16.9.4 Anpassen der Module


Nahezu alle GRASS-Module knnen in die GRASS-Werkzeugkiste integriert werden. Eine XML-Schnittstelle
wertet die sehr einfachen XML-Dateien, die die Module beschreiben, aus und bernimmt die Oberflchendarstellung.
Beispielhaft ist hier die XML-Datei zum Modul v.buffer (v.buffer.qgm) dargestellt:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE qgisgrassmodule SYSTEM "http://mrcc.com/qgisgrassmodule.dtd">
<qgisgrassmodule label="Vector buffer" module="v.buffer">
<option key="input" typeoption="type" layeroption="layer" />
<option key="buffer"/>
<option key="output" />
</qgisgrassmodule>

Der Auswerter liest diese Definition und erstellt einen neuen Reiter in der Werkzeugkiste, wenn Sie das Modul auswhlen. Ein detailierte Beschreibung, um neue Module in die GRASS Werkzeugkiste zu integrieren, die
Gruppe des Moduls zu ndern etc. finden Sie auf dem QGIS Wiki unter http://hub.qgis.org/projects/quantumgis/wiki/Adding_New_Tools_to_the_GRASS_Toolbox.
.

16.9. Die GRASS Werkzeugkiste

201

QGIS User Guide, Release 2.6

202

Kapitel 16. GRASS GIS Integration

KAPITEL 17

QGIS Verarbeitung Umgebung

17.1 Einfhrung
Dieses Kapitel stellt das QGIS Verarbeitung Umgebung, eine leistungsstarke Analyseumgebung fr raumbezogene Daten in QGIS, vor. Verarbeitung ist eine Geoverarbeitungsumgebung, die verwendet wird, um eigene und
fremde Algorithmen aus QGIS heraus aufrufen zu knnen, so dass rumliche Analysen produktiv und einfach zu
bewerkstelligen sind.
In den folgenden Abschnitten werden wir betrachten wie die grafischen Elemente dieser Umgebung benutzt werden und wie man das Beste aus jedem einzelnen von ihnen herausholen kann.
Es gibt vier Basiselemente in der Umgebungs GUI die dazu verwendet werden Algorithmen zu verschiedenen
Zwecken auszufhren. Ob man das eine oder andere Werkzeug auswhlt hngt von der Art der Analyse, die
durchgefhrt werden soll, und den Besonderheiten jedes Nutzers und Projektes ab. Sie knnen alle (ausgenommen
die Batch Processing Schnittstelle, die aus den Werkzeugen heraus aufgerufen wird) aus dem Verarbeitung Men
aufgerufen werden. (Sie werden mehr als vier Eintrge sehen. Die restlichen werden nicht zum Ausfhren von
Algorithmen benutzt und werden spter in diesem Kapitel erklrt.)
Die Werkzeuge. Das Hauptelement der GUI wird verwendet um einen einzelnen Algorithmus auszufhren
oder einen Batchprozess aufbauend auf diesem Algorithmus laufen zu lassen.
Die Grafische Modellierung. Viele Algorithmen knnen mit der Modellierung grafisch kombiniert werden
um einen Workflow zu definieren, also einen einzelnen Prozess, der mehrere Unterprozesse beinhaltet.
Das Protokoll. Alle durchgefhrten Aktionen die eins der zuvor erwhnten Elemente verwenden werden
in einer History Datei gespeichert und spter auf einfache Weise anhand des Protokolls wiederhergestellt
werden.
Die Batch Processing Schnittstelle. Diese Schnittstelle ermglicht es Ihnen Batchprozesse auszufhren und
die Ausfhrung eines einzelnen Algorithmus auf mehrere Datenstze zu automatisieren.
In den folgenden Abschnitten werden wir auf jedes dieser Elemente im Detail eingehen.
.

17.2 Die Werkzeugkiste


Die Verarbeitunswerkzeuge sind das Hauptelement der Verarbeitung GUI und das was Sie eher bei Ihrer tglichen
Arbeit benutzen werden. Es zeigt die Liste von verfgbaren Algorithmen in verschiedenen Blcken gruppiert
und ist der Anknpfungspunkt um Sie auszufhren, entweder als einfachen Prozess oder als Batchprozess mit
mehreren Ausfhrungen des gleichen Algorithmus auf verschiedene Inputdatenstze.
Die Werkzeugkiste enthlt alle verfgbaren Algorithmen in fnf vordefinierte Gruppen aufgeteilt. Alle diese Gruppen knnen unter einem einzelnen Baumeintrag genannt Geoalgorithms gefunden werden.
203

QGIS User Guide, Release 2.6

Abbildung 17.1: Verarbeitungswerkzeuge

Abbildung 17.2: Verarbeitungsmodellierung

204

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Abbildung 17.3: Verarbeitung Protokoll

Abbildung 17.4: Batch Processing Schnittstelle

17.2. Die Werkzeugkiste

205

QGIS User Guide, Release 2.6

Abbildung 17.5: Verarbeitungswerkzeuge


Zustzlich kann man zwei Eintrge finden, genannt Models und Scripts. Diese beinhalten vom Anwender erstellte
Algorithmen und sie ermglichen es Ihnen Ihre eigenen Workflows und Verarbeitungsaufgaben zu definieren. Wir
widmen uns ihnen spter mit einem ganzen Kapitel.
Im oberen Teil der Werkzeugkiste finden Sie ein Textfeld. Um die Anzahl der Algorithmen die in der Werkzeugkiste gezeigt werden zu verringern und um es Ihnen zu erleichtern den den Sie brauchen zu finden, knnen Sie
jedes beliebige Wort oder Satz in das Textfeld eingeben. Stellen Sie fest, dass whrend der Eingabe die Anzahl
von Algorithmen in der Werkzeugkiste auf genau die, die den Text, den Sie eingegeben haben enthalten, verringert
ist.
Im unteren Teil finden Sie ein Fenster das es Ihnen ermglicht zwischen der vereinfachten Liste von Algorithmen
(jene die oben erklrt wurde) und der erweiterten Liste zu wechseln. Wenn Sie zum erweiterten Modus wechseln
sieht die Werkzeugkiste so aussehen:
In der erweiterten Ansicht stellt jede Gruppe einen sogenannten Algorithmen-Provider dar, der einen Satz von
Algorithmen, die aus der gleichen Quelle kommen, ist, z.B. von einer Drittanwendung mit Geoverarbeitungsfhigkeiten. Einige dieser Gruppen reprsentieren Algorithmen von Drittanwendungen wie SAGA, GRASS oder
R, whrend andere Algorithmen, die direkt als Teil vom Verarbeitungsplugin kodiert werden nicht von zustzlicher
Software abhngig sind.
Diese Ansicht wird den Benutzern empfohlen die ein bestimmtes Wissen ber die Anwendungen, die im Hintergrund der Algorithmen laufen haben, da Sie mit Ihren ursprnglichen Namen und Gruppen gezeigt werden.
Auch sind einige zustzliche Algorithmen nur in der erweiterten Ansicht zugnglich, so etwa u.a. die LIDAR
Werkzeuge und Skripte, die auf der statistischen Rechensoftware R basieren.
Vor allem enthlt die vereinfachte Ansicht Algorithmen von den folgenden Provider:
GRASS
SAGA
OTB
QGIS eigene Algorithmen
Wenn Sie QGIS unter Windows benutzen sind diese Algorithmen voll funktional in einer neuen Installation
von QGIS, und Sie knnen eine zustzliche Installation ausgefhrt werden. Auch erfordert das Benutzen keine
vorhergehenden Kenntnisse ber die externen Anwendungen die sie benutzen, was sie zugnglicher fr Erstanwender macht.

206

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Abbildung 17.6: Verarbeitungswerkzeuge (advanced interface)


Wenn Sie einen Algorithmus, der nicht von einem der oben genannten Provider zur Verfgung gestellt wird,
benutzen wollen, wechseln Sie in den Advanced Modus indem Sie die entsprechende Option unten in der
Werkzeugkiste auswhlen.
Um einen Algorithmus zu starten, klicken Sie einfach doppelt auf den Namen in der Toolbox.

17.2.1 Der Algorithmus Dialog


Nachdem Sie auf den Namen des Algorithmus, den Sie ausfhren wollen, gedoppeklickt haben, wird ein Dialog so hnlich wie der in der Abbildung unten gezeigt (in diesem Fall bezieht sich der Dialog auf den SAGA
Convergence index Algorithmus).
Dieser Dialog wird verwendet, um die Eingangs-Werte anzugeben, damit der Algorithmus ausgefhrt werden
kann. Er zeigt eine Tabelle, in der Eingangswerte und Konfigurationsparameter zu setzen sind. Der Inhalt des
Dialogs steht in Abhngigkeit vom Algorithmus, der ausgefhrt werden soll, und wird automatisch auf Basis der
Anforderungen erstellt. Auf der linken Seite wird der Name des Parameters angezeigt. Auf der rechten Seite wird
der Parameter gesetzt.
Obwohl die Anzahl und Art der Parameter von den Eigenschaften des Algorithmus abhngt, ist die Struktur fr
alle hnlich. Die Parameter die Sie in der Tabelle finden knnen knnen folgende Typen sein.
Ein Rasterlayer, der aus der Liste aller in QGIS geladenen Layer (gerade geffneten) ausgewhlt werden
kannn. Die Auswahl enthlt auch einen Knopf auf der rechten Seite mit dem Sie Dateinamen, die die aktuell
in QGIS nicht geladenen Layer wiedergeben, auswhlen knnen.
Ein Vektorlayer aus der Liste aller in QGIS zur Verfgung stehenden Layer. Layer die nicht in QGIS geladen
wurden knnen ebenfalls ausgewhlt werden, wie im Fall von Rasterlayern, allerdings nur wenn der Algorithmus kein Tabellenfeld, das von der Attributtabelle des Layers entnommen wird, erfordert. In diesem Fall
knnen nur bereits geladene Layer ausgewhlt werden, um auf die Liste der Spalten zugreifen zu knnen,
da Sie geffnet sein mssen um die Liste der zur Verfgung stehenden Feldnamen abrufen zu knnen.
Sie werden einen Knopf bei jeder Vektorlayerauswahl sehen, wie in der Abbildung unten gezeigt.
Wenn der Algorithmus mehrere davon enthlt knnen Sie auch nur einen von Ihnen umschalten. Wenn der zu
einer Vektoreingabe gehrende Knopf umgeschaltet ist wird der Algorithmus iterativ mit jedem seiner Objekte
ausgefhrt anstatt nur einmal fr den ganzen Layer und erstellt so viele Ausgaben wie der Algorithmus ausgefhrt

17.2. Die Werkzeugkiste

207

QGIS User Guide, Release 2.6

Abbildung 17.7: Der Parameters Dialog

Abbildung 17.8: Vekotr Interator Knopf


wurde. Dies ermglicht es den Ablauf zu automatisieren wenn alle Objekte in einem Layer separat verarbeitet
werden mssen.
Eine Tabelle, um aus einer Liste von allen in QGIS vorhandenen zu whlen. Nicht-rumliche Tabellen
werden in QGIS wie Vektorlayer geladen und werden auch als solche durch das Programm behandelt.
Derzeit ist die Liste der verfgbaren Tabellen, die Sie sehen knnen wenn Sie einen Algorithmus ausfhren
auf Dateien im DBase- (.dbf) und CSV-Format (.csv) eingeschrnkt.
Eine Option, um mgliche Parameter aus einer Auswahlliste zu whlen.
Ein numerischer Wert, der in ein Textfeld eingetragen wird. Hier finden Sie einen Knopf an seiner Seite. Mit
einem Klick darauf erscheint ein Dialog, ber den Sie einen mathematischen Ausdruck eingeben knnen.
Sie knnen es als handlichen Taschenrechner verwenden. Einige ntzliche Variablen, die automatisch in
QGIS berechnet sind, knnen zu Ihrem Ausdruck hinzugefgt werden. Sie knnen einen Wert aus jeder
dieser Variablen, wie z.B. die Zellengre eines Layers oder den nrdlichsten Koordinatenwert eines Layers,
verwenden.
Ein Wertebereich mit Minimum und Maxmum, der ber zwei Textfelder angegeben wird.
Ein Text, der in ein Textfeld eingegeben wird.
Eine Spalte, die aus einer Attributtabelle ausgewhlt wird oder eine einzelne Tabelle.
Ein Koordinatenbezugssystem. Sie knnen einen EPSG Code direkt ins Textfenster eingeben oder es direkt
aus der Koordinatenbezugssystem-Auswahl, die erscheint wenn Sie auf den Knopf auf der rechten Seite
klicken, auswhlen.
Vier Zahlen, die eingegeben werden, um die xmin, xmax, ymin, ymax Grenzen festzulegen. Mit einem
Klick auf den Knopf auf der rechten Seite erscheint ein Pop-up-Men mit zwei Optionen: um den Wert aus
einem Layer zu bernehmen oder um das aktuelle Ausma ber das Kartenfensters zu whlen, indem Sie
durch Aufziehen eines Rechtecks im Kartenfenster die Ausdehnung definieren.

208

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Abbildung 17.9: Zahlauswahl

Abbildung 17.10: Ausdehnung Auswahl


Wenn Sie die erste Option whlen, sehen Sie einen Dialog wie den nchsten.

Abbildung 17.11: Ausdehnung Liste


Wenn Sie den zweiten whlen, wird das Parameter-Fenster verschwinden, damit Sie durch Klicken und
Ziehen im Kartenfenster einen Bereich definieren knnen. Wenn das Rechteck definiert ist, wird der Dialog
mit den Werten wieder auftauchen.
Eine Liste von Elementen (ob Rasterlayer, Vektorlayer oder Tabellen), aus der Liste von denen, die in
QGIS geladen sind. Um eine Auswahl zu treffen, klicken Sie auf die kleine Taste auf der linken Seite der
entsprechenden Zeile, um einen Dialog wie den Folgenden zu sehen.
Eine kleine Tabelle, um vom Benutzer editiert werden kann. Diese wird verwendet, um Parameter wie
Lookup-Tabellen oder Convolution Filter zu definieren.
Klicken Sie auf den Knopf auf der rechten Seite, um die Tabelle zu sehen und zu editieren.
In Abhngigkeit vom Algorithmus kann die Anzahl der Zeilen verndert werden oder auch nicht, indem Sie
auf den Knopf rechts neben dem Fenster klicken.
Sie werden einen [Help] Reiter im Parameters Dialog finden. Wenn eine Hilfedatei zur Verfgung steht wird
diese angezeigt und stellt Ihnen mehr Informationen ber den Algorithmus und genaue Beschreibungen was jeder

17.2. Die Werkzeugkiste

209

QGIS User Guide, Release 2.6

Abbildung 17.12: Ausdehnung aufziehen

Abbildung 17.13: Mehrfachauswahl

Abbildung 17.14: Feste Tabelle

210

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Parameter macht zur Verfgung. Leider gibt es fr die meisten Algorithmen noch keine gute Dokumentation, aber
wenn Sie etwas dazu beisteuern wollen, wre dies eine gute Mglichkeit.
Bemerkung zum Thema Projektionen
Algorithmen werden durch die Verarbeiten Umgebung ausgefhrt - dies trifft auch auf die meisten externen Anwendungen, deren Algorithmen dadurch zur Verfgung gestellt werden, zu. Fhren Sie keine Reprojezierung mit
Eingabelayern durch und nehmen Sie an dass alle schon in einem gemeinsamen Koordinatensystem sind und
bereit fr die Analyse sind. Wann immer Sie mehr als einen Layer als Eingabe fr einen Algorithmus verwenden,
ob Vektorlayer oder Rasterlayer, liegt es an Ihnen sicherzustellen dass Sie alle das gleiche Koordinatensystem
besitzen.
Beachten Sie dass aufgrund der Spontan-Repojektions Fhigkeiten von QGIS trotzdessen zwei Layer sich zu
berlappen und zu passen scheinen, dies nicht richtig ist wenn ihre Ursprungskoordinaten verwendet werden ohne
Sie in ein gemeinsames Koordinatensystem zu reprojezieren. Diese Reprojektion sollte manuell durchgefhrt
werden und die Ergebnisse sollten als Eingabe fr den Algorithmus verwendet werden. Beachten Sie auch, dass
die Reprojektion mit den in der Bearbeiten Umgebung selber zur Verfgung stehenden Algorithmen durchgefhrt
werden kann.
Standardmig zeigt der Paramters Dialog eine Beschreibung des KBS jedes Layers bei Angabe seines Namens,
was es einfach macht Layer auszuwhlen, die das gleiche KBS verwenden und diese als Eingabelayer zu benutzen.
Wenn Sie diese zustzliche Information nicht sehen wollen, knnen Sie diese Funktionalitt im Verarbeitungsoptionen Dialog ausschalten indem Sie die Show layer CRS definition in selection boxes Option deaktivieren.
Wenn Sie versuchen einen Algorithmus auszufhren indem Sie als Eingabe zwei oder mehr Layer mit nicht zutreffenden KBSs verwenden, wird ein Warndialog gezeigt.
Sie knnen den Algorithmus immer noch ausfhren, seien Sie sich aber dessen bewusst dass dies in den meisten
Fllen zu falschen Ergebnissen fhrt, so z.B. leere Layer aufgrunddessen dass Eingabelayer nicht berlappen.

17.2.2 Von Algorithmen erstellte Datenobjekte


Von Algorithmen erstellte Datenobjekte knnen jeder der folgenden Typen sein:
Rasterlayer
Vektorlayer
Tabelle
HTML-Datei (wird fr Text und grafische Ausgabe verwendet)
Sie werden alle auf der Festplatte gespeichert und die Parametertabelle enthlt ein Textfeld entsprechend jeder
Ausgabe, wo Sie eine Ausgabe eingeben knnen, die fr die Speicherung verwendet wird. Die Ausgabe enthlt
die erforderlichen Informationen, um das resultierende Objekt irgendwo zu speichern. In den meisten Fllen werden Sie es in einer Datei speichern, aber die Architektur von Verarbeitung ermglicht auch andere Arten der
Speicherung. Zum Beispiel kann ein Vektorlayer in einer Datenbank gespeichert werden oder sogar zu einem
entfernten Server ber eine WFS-T-Schnittstelle hochgeladen werden. Obwohl Lsungen wie diese noch nicht
umgesetzt sind, wird die Verarbeitung Umgebung bereit sein, es zu nutzen, wenn es zuknftig mglich sein wird.
Um einen Ausgabekanal auszuwhlen klicken Sie einfach auf den Knopf auf der rechten Seite des Textfensters.
Dies ffnet einen Datei speichern Dialog, indem Sie den gewnschten Dateipfad auswhlen knnen. Untersttzte
Dateierweiterungen werden in der Dateiformatauswahl des Dialogs gezeigt, abhngig von der Art der Ausgabe
und des Algorithmus.
Das Format der Ausgabe ist durch die Dateinamenerweiterung definiert. Die untersttzten Formate hngen davon
ab was durch den Algorithmus selber untersttzt wird. Um ein Format auszuwhlen whlen Sie einfach die
entsprechende Dateierweiterung aus (oder fgen Sie sie hinzu, wenn Sie anstelle dessen den Dateipfad direkt
eingeben). Wenn die Erweiterung des Dateipfads, die Sie eingegeben haben, keines der untersttzen Formate
trifft, wird eine Standarderweiterung (normalerweise .dbf fr Tabellen, .tif fr Rasterlayer und .shp fr
Vektorlayer) an den Dateipfad angehngt und das dieser Erweiterung entsprechende Dateiformat wird verwendet
um den Layer oder die Tabelle zu speichern.

17.2. Die Werkzeugkiste

211

QGIS User Guide, Release 2.6

Wenn Sie keinen Dateinamen eingeben wird das Ergebnis als temporre Datei im entsprechenden Standarddateiformat gespeichert und wird gelscht nachdem Sie QGIS verlassen haben (achten Sie darauf dass Sie ihr
Projekt speichern und es temporre Layer enthlt).
Sie knnen einen voreingestellten Ordner fr Ausgabedaten Objekte einrichten. Gehen Sie in den Verarbeitungsoptionen Dialog (Sie knnen Ihn aus dem Verarbeitung Men ffnen) und in der General Gruppe finden Sie
einen Paramter genannt Output folder. Dieser Output folder wird als Standardpfad fr den Fall, dass Sie nur einen
Dateinamen ohne Pfad (z.B. :file:myfile.shp) eingeben wenn Sie einen Algorithmus ausfhren, verwendet.
Wenn Sie einen Algorithmus ausfhren, der einen Vektorlayer im iterativen Modus verwendet, wird der
eingegebene Dateipfad als Basispfad fr alle erstellten Dateien, die mit Hilfe des Basisnamens benannt werden
und an die eine Nummer, die den Index der Iteration darstellt, angehngt wird, verwendet. Die Dateierweiterung
(und das Format) wird fr alle so erstellten Dateien benutzt.
Neben Rasterlayern und Tabellen erstellen Algorithmen auch Grafiken und Text als HTML Dateien. Diese Ergebnisse werden am Ende der Ausfhrung des Algorithmus in einem neuen Dialog gezeigt. Dieser Dialog hlt die
Ergebnisse, die von jedem beliebigen Algorithmus whrend der aktuellen Sitzung erstellt werden, fr die Dauer
der aktuellen Sitzung vor und kann jederzeit durch Auswhlen von Verarbeitung Ergebnisanzeige aus dem
QGIS Hauptmen angezeigt werden.
Einige externe Anwendungen knnen Dateien (ohne besondere Erweiterungseinschrnkungen) als Ausgabe
haben, diese gehren dann aber nicht zu einger der oben genannten Kategorien. Diese Ausgabedateien werden
nicht von QGIS bearbeitet (geffnet oder in das aktuelle QGIS Projekt eingefgt), das Sie meistens den Dateiformaten oder -elementen entsprechen, die nicht von QGIS untersttzt werden. Dies ist z.B. der Fall mit LAS Dateien,
die fr LiDAR Daten verwendet werden. Die Dateien werden erstellt, aber Sie werden nichts neues in Ihrer QGIS
Arbeitssitzung sehen.
Fr alle anderen Arten von Ausgaben finden Sie ein Kontrollkstchen, mit dem sie festlegen knnen, ob die Datei
in QGIS geladen werden soll oder nicht, wenn sie durch den Algorithmus erzeugt wurde. Standardmig werden
alle Dateien angezeigt.
Optionale Ausgaben werden nicht untersttzt, alle Ausgaben werden erstellt, aber Sie knnen ber das
entsprechende Kontrollkstchen definieren, wenn Sie an einer bestimmten Ausgabe nicht interessiert sind, was
es im Wesentlichen zu einer Optionale Ausgabe macht (Der Layer wird zwar erstellt, aber nur temporr im Hintergrund, wenn Sie das Textfeld leer lassen, und wieder gelscht, sobald Sie QGIS verlassen).

17.2.3 Die Verarbeiten Umgebung konfigurieren


Wie bereits erwhnt wurde, gibt das Konfigurationsmen Zugang zu einem neuen Dialog, in dem Sie festlegen,
wie Algorithmen funktionieren. Die Konfigurationsparameter sind in separate Blcke strukturiert und knnen auf
der linken Seite des Dialogs ausgewhlt werden.
Zusammen mit dem oben genannten Ausgabeordner Eintrag, enthlt der Allgemein Block Parameter zur Einstellung der Standard-Darstellung fr Ausgabe Layer (d.h. Layer die durch Benutzen der Algorithmen aus einer der
Umgebungs GUI Komponenten erstellt werden). Erstellen Sie einfach den gewnschten Stil mit QGIS, speichern
Sie ihn in eine Datei, und geben Sie den Pfad zu dieser Datei in den Einstellungen an, so dass die Algorithmen sie
verwenden kann. Immer, wenn ein Layer von SEXTANTE in QGIS geladen wird, wird dieser Stil verwendet.
Die Darstellungsstile knnen individuell fr jeden Algorithmus und jeden seiner Ausgaben kofiguriert werden.
Machen Sie einfach einen Rechtsklick auf den Namen des Algorithmus in der Werkzeugkiste und whlen Sie
Darstellungsstile zur Ausgabe bereiten. Sie werden einen Dialog wie unten gezeigt sehen.
Whlen Sie die Stildatei (.qml) fr jede Ausgabedatei und klicken Sie dann [OK].
Andere Konfigurationsparameter in der General Gruppe sind unten aufgefhrt:
Use filename as layer name. Der Name jedes resultierenden Layers, der von einem Algorithmus erstellt
wurde, wird durch den Algorithmus selber definiert. In einigen Fllen kann ein fester Name verwendet
werden, was heit dass der selbe Ausgabename benutzt wird, egal welcher Inputlayer verwendet wird. In
anderen Fllen, kann der Name von dem Eingabelayer oder einigen Parametern, die verwendet werden um
den Algorithmus auszufhren, abhngen. Wenn dieses Kontrollkstchen aktiviert ist wird anstelle dessen
der Name dem Ausgabedateinamen entnommen. Beachten Sie dass wenn die Ausgabe in eine temporre

212

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Abbildung 17.15: Darstellungsstile


Datei gespeichert wird, der Name dieser temporren Datei fr gewhnlich lang und bedeutungslos ist und
damit Kollisionen mit bereits existierenden Dateinamen vermieden werden sollen.
Use only selected features. Wenn diese Option ausgewhlt ist, werden nur ausgewhlte Objekte verwendet
wenn ein Vektorlayer als Eingabe fr einen Algorithmus benutzt wird. Wenn der Layer keine ausgewhlten
Objekte hat, werden alle Objekte benutzt.
Pre-execution script und Post-execution script. Diese Paramter beziehen sich auf Scripts, die anhand der
Verarbeitung Scipting Funktionalit geschrieben worden sind und werden in dem Abschnitt, der Scripting
und Konsole abdeckt erklrt.
Abgesehen vom Bereich General im Men Optionen und Konfiguration, finden Sie auch einen fr jeden
Algorithmus-Provider. Sie enthalten ein aktivieren Element, das Sie verwenden knnen, um festzulegen,
ob Algorithmen dieses Providers in der Toolbox erscheinen oder nicht. Auch haben einige Provider ihre
eigene Algorithmus-Konfiguration, die wir spter noch genauer erklren wenn bestimmte Algorithmus Provider
abgedeckt werden.
.

17.3 Die Grafische Modellierung


Die grafische Modellierung ermglicht es, komplexe Modelle mit einer einfachen und leicht zu bedienenden Benutzeroberflche zu erstellen. Beim Arbeiten mit einem GIS finden die meisten Analyse-Operationen nicht isoliert,
sondern als Teil einer Kette von Operationen statt. Der grafische Modeller kann eine Kette von Prozessen in einen
einzigen Prozess einpacken. So ist es einfacher und bequemer, als einzelne Prozesse nacheinander auszufhren.
Egal, wie viele Schritte und verschiedene Algorithmen es sind, sie knnen als Modell in einem einzigen Algorithmus ausgefhrt werden. Das spart Zeit und Mhe, besonders fr grere Modelle.
Die Modellierung kann aus dem Verarbeiten Men heraus geffnet werden.
Der Modeller hat einen Arbeitsdialog, wo die Struktur des Modells und der Workflow dargestellt wird. Auf der
linken Seite des Fensters kann ein Bereich mit zwei Reitern verwendet werden, um neue Elemente in das Modell
zu integrieren.
Das Erstellen eines Modells geht in zwei Schritten:
1. Definition von erforderlichen Eingaben. Diese Eingaben werden dem Paramterfenster hinzugefgt, so dass
der Anwender Ihre Werte einstellen kann wenn er das Modell ausfhrt. Das Modell selber ist ein Algorithmus, also wird das Parameterfenster automatisch erstellt, so wie es mit allen Algorithmen, die in der

17.3. Die Grafische Modellierung

213

QGIS User Guide, Release 2.6

Abbildung 17.16: Modellierung


Verarbeiten Umgebung zur Verfgung stehen, passiert.
2. Definition des Workflows. Whrend Sie die Eingabedaten des Modells verwenden, wird der Workflow durch
Hinzufgen von Algorithmen und Auswhlen, wie diese Eingaben und Ausgaben, die von anderen Algorithmen erzeugt werden, benutzt werden, definiert.

17.3.1 Definition von Eingaben


Der Erste Schritt ein Modell zu erstellen ist die Eingaben, die es bentigt zu erstellen. Die folgenden Elemente
finden Sie im Eingaben Reiter auf der linken Seite des Modellierungsfensters:
Rasterlayer
Vektorlayer
Text
Tabellenspalte
Tabelle
Extent
Number
Boolean
File
Wenn man einen Doppelklick auf eines dieser Elemente macht wird ein Dialog zum Definieren seiner Eigenschaften gezeigt. Abhngig vom Parameter selber kann der Dialog nur ein grundlegendes Element (die Beschreibung, was der Benutzer sehen wird wenn er das Modell ausfhrt) oder mehrere beinhalten. Beispielsweise wenn
man einen numerischen Wert hinzufgt, wie in der nchsten Abbildung gezeigt, mssen Sie neben der Beschreibung des Parameters einen Standardwert und eine Wertespanne von gltigen Werten einstellen.

214

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Abbildung 17.17: Modelparameter


Fr jede Eingabe wird ein neues Element im Modeller-Fenster erstellt.

Abbildung 17.18: Modelparameter


You can also add inputs by dragging the input type from the list and dropping it in the modeler canvas, in the
position where you want to place it.

17.3.2 Definition des Workflows


Wenn die Eingaben definiert sind, ist es Zeit die Algorithmen festzulegen. Die Algorithmen knnen im Reiter
Algorithmen ausgewhlt werden. Die Gruppierung entspricht der Toolbox.
Auch hier hat die Erscheinung der Werkzeugkiste zwei Modi: simplified und advanced. Jedoch gibt es kein Element zum Wechseln zwischen den Ansichten in der Modellierung, so dass Sie dies in der Werkzeugkiste machen
mssen. Der Modus, der in der Werkzeugkiste ausgewhlt ist, ist der, der fr die Liste von Algorithmen in der
Modellierung verwendet wird.
To add an algorithm to a model, double-click on its name or drag and drop it, just like it was done when adding
inputs. An execution dialog will appear, with a content similar to the one found in the execution panel that is shown
when executing the algorithm from the toolbox. The one shown next corresponds to the SAGA Convergence
index algorithm, the same example we saw in the section dedicated to the toolbox.
Wie Sie sehen knnen bestehen einige Unterschiede. Anstelle des Dateiausgabefensters, das fr die Einstellung
des Dateipfades fr Ausgabelayer und -tabellen verwendet wurde, wird hier eine einfaches Textfenster verwendet.
Wenn der vom Algorithmus erstellte Layer nur ein vorlufiges Ergebnis ist, das als Eingabe fr einen anderen
Algorithmus verwendet wird und nicht als endgltiges Ergebnis vorgehalten werden soll, bearbeiten Sie dieses
Textfenster nicht. Wenn Sie etwas eingeben heit das, dass das Ergebnis endgltig ist und dass der Text den
Sie vergeben die Beschreibung fr die Ausgabe, die die Ausgabe ist, die der Benutzer sieht wenn das Modell
ausgefhrt wird, ist.
Das Auswhlen des Wertes fr jeden Parameter ist ebenfalls etwas schwierig, da es wichtige Unterschiede zwischen dem Kontext der Modellierung und der der Werkzeugkiste gibt. Wollen wir sehen wie man die Werte fr
jeden Typ von Parameter vorstellen.
Layer (Raster und Vektor) und Tabellen. Diese werden aus einer Liste ausgewhlt, aber in diesem Fall sind
die mglichen Werte nicht die Layer oder Tabellen die gerade in QGIS geladen sind, sondern die Liste von
Modelleingaben des entsprechenden Typs oder andere Layer und Tabellen, die von Algorithmen, die schon
dem Modell hinzugefgt wurden, erstellt wurden.

17.3. Die Grafische Modellierung

215

QGIS User Guide, Release 2.6

Abbildung 17.19: Modelparameter

Abbildung 17.20: Modelparameter

216

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Numerische Werte. Literale Werte knnen direkt im Textfenster eingefhrt werden. Dieses Textfeld is
ebenfalls eine Liste, die verwendet werden kann um jede der numerischen Werteingaben des Modells
auszuwhlen. In diesem Fall wird der Parameter den Wert, der vom Benutzer beim Ausfhren des Modells eingefhrt wird, annehmen.
String. Wie im Fall von numerischen Werten knnen literale Strings eingegeben werden oder ein Eingabestring kann ausgewhlt werden.
Table field. Die Felder der Elterntabelle oder -layers knnen nicht zur Erstellungszeit ermittelt werden, da
sie von der Auswahl des Anwenders jedes mal wenn das Modell ausgefhrt wird abhngen. Um den Wert fr
diesen Parameter einzustellen, geben Sie den Namen des Feldes direkt in das Textfenster ein oder verwenden
Sie die Liste um eine Tabellenfeldeingabe, die schon dem Modell hinzugefgt wurde, auszuwhlen. Die
Gltigkeit des ausgewhlten Feldes wird zur Laufzeit berprft.
Sie werden in jedem Fall einen zustzlichen Paramter genannt Parent algorithms, der nicht zugnglich ist wenn Sie
den Algorithmus aus der Werkzeugkiste aufrufen, finden. Dieser Parameter ermglicht es Ihnen die Reihenfolge in
welcher die Algorithmen ausgefhrt werden, indem ein Algorithmus ausdrcklich als Eltern des aktuellen definiert
werden, festzulegen. Dies bewirkt, dass der Elternalgorithmus vor dem aktuellen ausgefhrt wird.
Wenn Sie die Ausgabe eines vorherigen Algorithmus als Eingabe fr Ihren Algorithmus benutzen, stellt dies
implizit den vorherigen Algorithmus als Eltern des gerade verwendeten ein (und platziert den entsprechenden
Pfeil in der Modellierungsoberflche). In einigen Fllen jedoch kann ein Algorithmus von einem anderen abhngen
selbst wenn er keine Ausgabe von diesem verwendet (beispielsweise ein Algorithmus der einen SQL-Satz in einer
PostGIS Datenbank ausfhrt und ein weiterer der einen Layer in die gleiche Datenbank importiert). Whlen Sie in
diesem Fall einfach den vorherigen Algorithmus im Parent algorithms Parameter aus und die zwei Schritte werden
in der richtigen Reihenfolge ausgefhrt.
Nachdem allen Parametern die gltigen Werte zugewiesen worden sind klicken Sie auf [OK] und der Algorithmus
wird der Oberflche hinzugefgt. Er wird mit allen anderen Elementen in der Oberflche verbunden, egal ob
Algorithmen oder Eingaben, die Objekte darstellen, die als Eingabe fr diesen Algorithmus verwendet werden.
Elements can be dragged to a different position within the canvas, to change the way the module structure is
displayed and make it more clear and intuitive. Links between elements are updated automatically. You can zoom
in and out by using the mouse wheel.
Sie knnen Ihren Algorithmus zu jederzeit durch Klicken auf den [Run] Knopf ausfhren. Um jedoch den
Algorithmus aus der Werkzeugkiste zu verwenden muss er gespeichert werden und der Modellierungsdialog
geschlossen werden, damit die Werkzeugkiste ihre Inhalte auffrischen kann.

17.3.3 Speichern und laden von Modellen


Verwenden Sie den [Speichern] Knopf um das aktuelle Modell zu speichern und den [Modell ffnen] Knopf
um ein vorher gespeichertes Modell zu ffnen. Modelle werden mit der .model Erweiterung gespeichert. Wenn
das Modell vorher aus dem Verarbeitungsmodellierung Fenster heraus gespeichert wurde, werden Sie nicht nach
einem Dateinamen gefragt. Da es bereits eine Datei, die zu diesem Modell zugeordnet wurde, gibt, wird die gleiche
Datei fr jedes nachfolgende Speichern verwendet.
Vor dem Speichern eines Modells mssen Sie einen Namen und eine Gruppe angeben. Nutzen Sie dazu die
Textfelder im oberen Teil des Fensters.
Modelle, die im models Ordner (der Standardordner wenn Sie aufgefordert werden einen Dateinamen zum
Speichern des Modell einzugeben) gespeichert sind, erscheinen in der Werkzeugkiste im entsprechenden Baum.
Wenn die Verarbeitungswerkzeuge aufgerufen werden durchsucht sie den models Ordner nach Dateien mit der
.model Erweiterung und ldt die Modelle, die enthalten sind. Da ein Modell ein Algorithmus ist, kann es einfach
wie jeder andere Algorithmus zur Werkzeugkiste hinzugefgt werden.
Die Verarbeitungsmodellierung kann im Verarbeitungskonfigurationsdialog in der Models Gruppe eingestellt werden.
Modelle, die aus dem Models Ordner geladen werden, erscheinen nicht nur in der Werkzeugkiste, sondern auch
im Algorithmusbaum im Algorithmen Reiter des Modellierungsfensters.

17.3. Die Grafische Modellierung

217

QGIS User Guide, Release 2.6

In einigen Fllen kann ein Modell vielleicht nicht geladen werden da nicht alle im Workflow enthaltenen Algorithmen zur Verfgung stehen. Wenn Sie einen gegebenen Algorithmus als Teil Ihres Modells benutzt haben, sollte er
zu Verfgung stehen (er sollte also in der Werkzeugkiste erscheinen) um das Modell laden zu knnen. Das Deaktivieren eines Algorithmusproviders in den Verarbeitungsoptionen rendert alle die Algorithmen des Providers, der
nicht von der Modellierung benutztt werden kann, was Probleme beim Laden von Modellen verursachen kann.
Denken Sie daran wenn Sie Probleme beim Laden oder Ausfhren von Modellen haben.

17.3.4 Ein Modell editieren


Sie knnen das Modell, das Sie gerade erstellen editieren, den Workflow neu definieren sowie die Beziehungen
zwischen den Algorithmen und den Eingangsdaten, die das Modell ausmachen ndern.
Wenn Sie mit der rechten Maustaste auf einen Algorithmus im Dialog-Fenster klicken, wird ein Kontextmen
geffnet. wie in der nchsten Abbildung zu sehen:

Abbildung 17.21: Rechtsklick auf den Modeler


Wird die Remove Option gewhlt, bewirkt dies, dass der ausgewhlte Algorithmus entfernt wird. Ein Algorithmus
kann nur entfernt werden wenn keine weiteren Algorithmen von ihm abhngen. Das heit, wenn keine Ausgabe
des Algorithmus in einem anderen als Eingabe verwendet wird. Wenn Sie versuchen einen Algorithmus, von dem
andere abhngen, zu entfernen, wird eine Warnmeldung wie die, die Sie unten sehen knnen, gezeigt:

Abbildung 17.22: Kann Algorithmus nicht entfernen


Auswhlen der Bearbeiten Option oder einfaches Doppelklicken auf das Symbol des Algorithmus zeigt den
Parameter-Dialog des Algorithmus, um die Ein- und Ausgabe Parameter-Werte zu ndern. Nicht alle EingabeElemente des Modells werden in diesem Fall als verfgbare Eingnge angezeigt. Layer oder Werte, die in einem
fortgeschrittenen Schritt im Workflow durch das Modell erzeugt wurden, stehen nicht zur Verfgung, wenn sie
zirkulre Abhngigkeiten verursachen.
Whlen Sie die neuen Werte und klicken dann auf den [OK] Knopf wie gewohnt. Die Verbindungen zwischen
den Elementen des Modells ndern sich entsprechend im Modeller-Fenster.

17.3.5 Editieren der Modell-Hilfe Datei und der Metainformationen


Sie knnen Ihre Modelle aus der Modellierung heraus dokumentieren. Klicken Sie einfach auf den [Modellhilfe
bearbeiten] Knopf und ein Dialog, wie er als nchstes gezeigt wird, erscheint.
Auf der rechten Seite finden Sie eine einfache HTML-Seite, die anhand der Eingabeparameter und Ausgaben des
Algorithmus erstellt wurde, zusammen mit einigen zustzlichen Eintrgen wie eine allgemeine Beschreibung des
Modells und seines Autors. Wenn Sie den Hilfeeditor das erste Mal ffnen, sind alle diese Beschreibungen leer,
Sie knnen Sie aber mit Hilfe der Elemente auf der linken Seite des Dialogs bearbeiten. Whlen Sie ein Element
im oberen Teil aus und schreiben Sie seine Beschreibung in das Textfeld unten.

218

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Abbildung 17.23: Hilfeeditor


Die Modell Hilfe wird in einer Datei im gleichen Ordner wie das Modell selbst gespeichert. Sie mssen nichts
tun, um es zu speichern, da es automatisch geschieht.

17.3.6 Zu den verfgbaren Algorithmen


Sie haben vielleicht bemerkt, dass einige Algorithmen, die aus der Toolbox ausgefhrt werden knnen, nicht in
der Liste der verfgbaren Algorithmen erscheint, wenn Sie ein Modell entwerfen. Um in einem Modell enthalten
zu sein, muss der Algorithmus eine korrekte Semantik haben, um im Workflow verknpft zu werden. Wenn ein
Algorithmus keine solche definierte Semantik besitzt (zum Beispiel, wenn die Anzahl der Ausgangskanle oder
Layer nicht im Voraus bekannt ist), dann ist es nicht mglich, diesen in einem Modell zu verwenden, und somit
erscheint er auch nicht in der Liste.
Zustzlich werden Sie einige Algorithmen in der Modellierung sehen, die nicht in der Werkzeugkiste gefunden
werden knnen. Diese Algorithmen sollen ausschlielich als Teil eines Modells benutzt werden und sie in einem
anderen Kontext nicht von Interesse. Der Calculator Algorithmus ist ein Beispiel dafr. Er ist nur ein ein einfacher arithmetischer Rechner den Sie benutzen knnen um numerische Werte zu verndern (sie knnen durch
den Benutzer eingegeben werden oder durch einen anderen Algorithmus erstellt werden). Dieses Werkzeug ist
wirklich ntzlich innerhalb eines Modells, aber auerhalb dieses Kontexts machen es nicht allzuviel Sinn.
.

17.4 Die Stapelproze Schnittstelle


17.4.1 Einfhrung
Alle Algorithmen (inclusive Modelle) knnen als Stapelproze ausgefhrt werden. Ds heit, sie knnen nicht nur
anhand eines einzigen Satz von Eingaben, sondern mehreren von ihnen ausgefhrt werden, wobei der Prozess so
oft wie bentigt ausgefhrt werden kann. Dies ist ntzlich wenn groe Datenmengen prozessiert werden, da es
nicht ntig ist den Algorithmus viele Male von der Werkzeugkiste aus zu starten.
Um einen Algorithmus als Batch-Prozess ausfhren, klicken Sie mit der rechten Maustaste auf seinen Namen in
der Toolbox und whlen Sie die Option Ausfhren als Batch-Prozess.

17.4. Die Stapelproze Schnittstelle

219

QGIS User Guide, Release 2.6

Abbildung 17.24: Stapelprozess anhand eines Rechtsklicks

17.4.2 Die Parameter-Tabelle


Ausfhren eines Batch-Prozesses ist vergleichbar mit der Durchfhrung der einmaligen Ausfhrung eines Algorithmus. Parameter-Werte mssen definiert werden, aber in diesem Fall mssen wir nicht nur einen einzelnen Wert
fr jeden Parameter angeben, sondern eine Reihe von ihnen, einen fr jedes Mal, wenn der Algorithmus ausgefhrt
werden soll. Werte werden mit Hilfe einer Tabelle wie in der nchsten Abbildung zu sehen bergeben.

Abbildung 17.25: Batch Processing


Jede Zeile dieser Tabelle stellt eine einzelne Ausfhrung des Algorithmus dar, und jede Zelle enthlt den Wert
eines der Parameter. Es ist vergleichbar mit dem Parameter-Dialog, den Sie sehen, wenn Sie die Ausfhrung eines
Algorithmus aus der Toolbox starten, aber mit einer anderen Anordnung.
Standardmig enthlt die Tabelle nur zwei Zeilen. Sie knnen weitere hinzufgen oder entfernen mit den Tasten
am unteren Teil des Fensters.
Sobald die Gre der Tabelle gesetzt ist, muss sie mit den gewnschten Werten gefllt werden.

17.4.3 Fllen der Parameter-Tabelle


Bei den meisten Parametern ist das Setzen des Wertes trivial. Geben Sie einfach den Wer ein oder whlen Sie
diesen aus der Liste zur Verfgung stehender Optionen, abhngig vom Parametertyp, aus.
Die wichtigsten Unterschiede liegen zwischen den Parametern fr Layer oder Tabellen, und in der Angabe der
Ausgabedateipfade. Bezglich Eingabelayern und Tabellen, wenn ein Algorithmus als Teil eines Batch-Prozessen
ausgefhrt wird, werden die Eingangsdaten direkt von den Dateien genommen, und nicht aus denen, die bereits in
QGIS geladen sind. Aus diesem Grund kann jeder Algorithmus als Batch-Proze verwendet werden, auch wenn
die entsprechenden Daten nicht geffnet sind und der Algorithmus aus der Toolbox heraus nicht ausgefhrt werden
kann.

220

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Dateinamen fr Eingabedatenobjekte werden direkt eingegeben, indem Sie sie eintippen oder bequemer durch das
Klicken des
Knopfes auf der rechten Seite der Zelle, welcher einen typischen Dateiauswahldialog zeigt. Es
knnen mehrere Dateien auf einmal ausgewhlt werden. Wenn der Eingabeparameter ein einzelnes Datenobjekt
darstellt und mehrere Dateien ausgewhlt sind, wird jede von ihnen in eine separate Zeile gesetzt, und neue
hinzugefgt wenn ntig. Wenn der Parameter eine Mehrfacheingabe wiedergibt werden alle ausgewhlten Dateien
in eine Zelle getrennt durch Semikolons (;) gesetzt.
Ausgabedaten Objekte werden immer in einer Datei gespeichert und im Gegensatz zur Ausfhrung eines Algorithmus aus der Toolbox, ist das vorbergehende Speichern als temporre Datei nicht gestattet. Sie knnen den
Namen direkt eingeben oder im Dateiauswahldialog, wenn Sie auf den zugehrigen Button klicken.
Sobald Sie die Datei auswhlen, erscheint ein neuer Dialog, der Autovervollstndigung von anderen Zellen in
derselben Spalte (gleiche Parameter) ermglicht.

Abbildung 17.26: Batch Processing Save


Wenn der Standardwert (Do not autocomplete) gewhlt ist, wird einfach der gewhlte Dateiname in die ausgewhlte Zelle der Parameters Tabelle eingegeben. Wenn eine der anderen Optionen gewhlt ist, werden alle
Zellen unter der ausgewhlten automatisch anhand von definierten Kriterien ausgefllt. So ist es erheblich einfacher die Tabelle auszufllen und der Stapelproze kann mit weniger Aufwand definiert werden.
Automatische Fllung kann durch einfaches Hinzufgen von korrelativen Zahlen zum ausgewhlten Dateipfad
oder Anhngen des Wertes eines anderen Feldes zu derselben Zeile erreicht werden. Dies ist besonders ntzlich
fr die Benennung von Ausgabedaten-Objekte entsprechend der Eingnge.

Abbildung 17.27: Batch Processing Dateipfad

17.4.4 Ausfhren eines Batch-Prozesses


Um den Stapelprozess, nachdem Sie alle ntigen Werte eingefhrt haben, auszufhren, klicken Sie einfach auf
[OK]. Der Fortschritt dieses globalen Batch Tasks wird in der Statusleiste im unteren Teil des Dialogs gezeigt.
.

17.5 Verarbeitung Algorithmen von der Konsole aus verwenden


Die Konsole ermglicht es fortgeschrittenen Anwendern ihre Produktivitt zu erhhen und komplexe Operationen,
die nicht anhand eines der GUI Elemente der Verarbeitung Umgebung ausgefhrt werden knnen, durchzufhren.
Modelle mit mehreren Algorithmen knnen anhand der Kommandozeilenssschnittstelle definiert werden und
zustzliche Operationen wie Schleifen und Bedingungsstze knnen hinzugefgt werden, um flexiblere und leistungsfhigere Workflows zu erstellen.
17.5. Verarbeitung Algorithmen von der Konsole aus verwenden

221

QGIS User Guide, Release 2.6

Es gibt in QGIS keine Verarbeitung Konsole, aber alle Verarbeitung Befehle stehen anstelledessen in der eingebauten QGIS Python Konsole zur Verfgung. Das heisst dass Sie diese Befehle in Ihre Konsolenarbeit integrieren
knnen und Verarbeitung Algorithmen mit allen anderen dort zur Verfgung stehenden Objekten (einschlielich
Methoden aus der QGIS API) verbinden knnen.
Der Code den Sie von der Python Konsole aus ausfhren knnen, auch wenn er keine spezifische Verarbeitung
Methode aufruft, kann in einen neuen Algorithmus berfhrt werden den Sie spter aus der Werkzeugkiste, der
Grafischen Modellierung oder jeder anderen Komponente aufrufen knnen, so wie Sie es mit jedem anderen
Algorithmus tun wrden. In der Tat sind einige Algorithmen, die Sie in der Werkzeugkiste finden knnen einfache
Scripte.
In diesem Abschnitt werden wir uns angucken wie man Verarbeitung Algorithmen aus der QGIS Python Konsole
heraus verwendet und auch wie man Algorithmen in Python schreibt.

17.5.1 Algorithmen von der Python Konsole aus aufrufen


Das erste, was Sie machen mssen, ist die Verarbeitung Funktionen mit der folgenden Zeile importieren:
>>> import processing

Nun gibt es im Grunde nur eine (interessante) Sache, die Sie damit von der Konsole aus tun knnen: einen
Algorithmus ausfhren. Das wird anhand der runalg()Methode gemacht, die den Namen
des Algorithmus nimmt um ihn als seinen ersten Parameter auszufhren und
dann eine variable Anzahl von zustzlichen Parametern abhngig von den
Anforderungen des Algorithmus. Das erste was Sie also wissen mssen ist
der Name des Algorithmus, der ausgefhrt werden soll. Das ist nicht der
Name, den Sie in der Werkzeugkiste sehen knnen, sondern ein eindeutiger
Kommandozeilenname. Um den richtigen Namen fr Ihren Algorithmus zu finden,
knnen Sie die algslist() Methode verwenden. Geben Sie den folgenden Satz in Ihre Konsole ein:
>>> processing.alglist()

Sie werden etwas wie dieses sehen.


Accumulated Cost (Anisotropic)---------------->saga:accumulatedcost(anisotropic)
Accumulated Cost (Isotropic)------------------>saga:accumulatedcost(isotropic)
Add Coordinates to points--------------------->saga:addcoordinatestopoints
Add Grid Values to Points--------------------->saga:addgridvaluestopoints
Add Grid Values to Shapes--------------------->saga:addgridvaluestoshapes
Add Polygon Attributes to Points-------------->saga:addpolygonattributestopoints
Aggregate------------------------------------->saga:aggregate
Aggregate Point Observations------------------>saga:aggregatepointobservations
Aggregation Index----------------------------->saga:aggregationindex
Analytical Hierarchy Process------------------>saga:analyticalhierarchyprocess
Analytical Hillshading------------------------>saga:analyticalhillshading
Average With Mask 1--------------------------->saga:averagewithmask1
Average With Mask 2--------------------------->saga:averagewithmask2
Average With Thereshold 1--------------------->saga:averagewiththereshold1
Average With Thereshold 2--------------------->saga:averagewiththereshold2
Average With Thereshold 3--------------------->saga:averagewiththereshold3
B-Spline Approximation------------------------>saga:b-splineapproximation
...

Das ist eine Liste von allen zur Verfgung stehenden Algorithmen, alfabetisch geordnet, zusammen mit ihren
entsprechenden Kommandozeilennamen.
Sie knnen einen String als Parameter fr diese Methode benutzen. Statt die ganze Liste von Algorithmen herauszugeben wird sie nur die zeigen die diesen String enthalten. Wenn Sie beispielsweise nach einem Algorithmus
zum Berechnen der Hangneigung aus einem DEM suchen, geben Sie alglist("slope") ein, um folgendes
Ergebnis zu erhalten:

222

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

DTM Filter (slope-based)---------------------->saga:dtmfilter(slope-based)


Downslope Distance Gradient------------------->saga:downslopedistancegradient
Relative Heights and Slope Positions---------->saga:relativeheightsandslopepositions
Slope Length---------------------------------->saga:slopelength
Slope, Aspect, Curvature---------------------->saga:slopeaspectcurvature
Upslope Area---------------------------------->saga:upslopearea
Vegetation Index[slope based]----------------->saga:vegetationindex[slopebased]

Dieses Ergebnis kann sich abhngig von den Ihnen zur Verfgung stehenden Algorithmen ndern.
Es ist jetzt einfacher den Algorithmus und seinem Kommandozeilennamen, nach dem Sie suchen, zu finden, in
diesem Fall saga:slopeaspectcurvature.
Wenn Sie erstmal den Kommandozeilennamen des Algorithmus wissen ist das nchste, was Sie tun mssen die
richtige Syntax, um ihn auszufhren, zu bestimmen. Das heit zu wissen welche Parameter bentigt werden und
die Reihenfolge, in der sie eingegeben werden mssen, wenn die runalg() Methode aufgerufen wird. Es gibt
eine Methode, um den Algorithmus im Detail zu beschreiben, die dazu benutzt werden kann um eine Liste von
Parametern, die ein Algorihmus erfordert und die Ausgaben, die er erzeugt, zu erstellen. Um diese Information
zu erhalten knnen Sie die alghelp(name_of_the_algorithm) Methode verwenden. Verwenden Sie den
Kommandozeilennamen des Algorithmus, nicht den vollen beschreibenden Namen.
Wenn Sie die Methode mit saga:slopeaspectcurvature als Parameter aufrufen erhalten Sie die folgende
Beschreibung:
>>> processing.alghelp("saga:slopeaspectcurvature")
ALGORITHM: Slope, Aspect, Curvature
ELEVATION <ParameterRaster>
METHOD <ParameterSelection>
SLOPE <OutputRaster>
ASPECT <OutputRaster>
CURV <OutputRaster>
HCURV <OutputRaster>
VCURV <OutputRaster>

Jetzt haben Sie alles was Sie brauchen um einen Algorithmus auszufhren. Wie wir bereits erwhnt haben, gibt es
nur einen einzigen Befehl um einen Algorithmus auszufhren: runalg(). Seine Syntax ist wie folgt:
>>> processing.runalg(name_of_the_algorithm, param1, param2, ..., paramN,
Output1, Output2, ..., OutputN)

Die Liste von Parametern und Ausgaben hngen von dem Algorithmus den Sie ausfhren wollen ab und ist genau
die Liste die die alghelp() Methode Ihnen herausgibt, in der gleichen Reihenfolge wie gezeigt.
Abhngig vom Parametertyp werden Werte verschieden eingefhrt. Die nchste Liste gibt einen kurzen berblick
darber wie man Werte fr jeden Typ von Eingabeparameter einfhrt:
Rasterlayer, Vektorlayer oder Tabelle. Verwenden Sie einfach einen String mit dem Namen, der das zu
verwendende Datenobjekt (den Namen, den es im QGIS Inhaltsverzeichnis hat) identifiziert oder einen
Dateinamen (wenn der entsprechende Layer nicht geffnet ist, wird er geffnet aber nicht dem Kartenfenster
hinzugefgt). Wenn Sie eine Instanz eines QGIS Objektes, das den Layer reprsentiert, haben, knnen Sie es
als Parameter eingeben. Wenn der Input optional ist und Sie kein Datenobjekt verwenden wollen, benutzen
Sie None.
Auswahl. Wenn ein Algorithmus einen Auswahlparameter besitzt, sollte der Wert des Parameters
eingegeben werden, indem man einen Integerwert verwendet. Um die zur Verfgung stehenden Optionen
zu ermitteln, knnen Sie den algoptions() Befehl verwenden, wie im folgenden Beispiel gezeigt:
>>> processing.algoptions("saga:slopeaspectcurvature")
METHOD(Method)
0 - [0] Maximum Slope (Travis et al. 1975)
1 - [1] Maximum Triangle Slope (Tarboton 1997)
2 - [2] Least Squares Fitted Plane (Horn 1981, Costa-Cabral & Burgess 1996)
3 - [3] Fit 2.Degree Polynom (Bauer, Rohdenburg, Bork 1985)
4 - [4] Fit 2.Degree Polynom (Heerdegen & Beran 1982)

17.5. Verarbeitung Algorithmen von der Konsole aus verwenden

223

QGIS User Guide, Release 2.6

5 - [5] Fit 2.Degree Polynom (Zevenbergen & Thorne 1987)


6 - [6] Fit 3.Degree Polynom (Haralick 1983)

In diesem Fall hat der Algorithmus einen solchen Parameter mit sieben Optionen. Beachten Sie dass die
Bearbeitungsreihenfolge bei null anfngt.
Multiple input. Der Wert ist ein String mit Eingabebeschreibungen getrennt durch Semikolons (;). Wie im
Fall von einfachen Layern oder Tabellen kann jede Eingabebeschreibung der Datenobjektname oder sein
Dateipfad sein.
Tabellen Feld von XXX. Verwenden Sie einen String mit dem Namen des Feldes, das benutzt werden soll.
Dieser Parameter unterscheidet zwischen Gro- und Kleinschreibung.
Fixed Table. Geben Sie die Liste aller Tabellenwerte, die durch Kommas (,) getrennt sind und zwischen
Anfhrungsstrichen (") eingeschlossen sind. Die Werte beginnen in der oberen Zeile und gehen von links
nach rechts. Sie knnen auch einen 2D-Array von Werten, die die Tabelle reprsentieren, verwenden.
CRS. Geben Sie den EPSG Code des gewnschten KBS ein.
Extent. Sie mssen einen String mit xmin, xmax, ymin und ymax Werten getrennt durch Kommas (,)
eingeben.
Boolean, file, string und numerical parameters brauchen keien zustzlichen Erluterungen.
Input parameters such as strings, booleans, or numerical values have default values. To use them, specify None in
the corresponding parameter entry.
Fr Ausgabedatenobjekte geben Sie den Dateipfad, der benutzt wird um es zu speichern, ein, genauso wie es in
der Werkzeugkiste gemacht wird. Wenn Sie das Ergebnis in einer temporren Datei speichern wollen, verwenden
sie None. Die Erweiterung der Datei bestimmt das Dateiformat. Wenn Sie eine Dateierweiterung, die nicht vom
Algorithmus untersttzt wird, eingeben, wird das Standarddateiformat fr den Ausgabetyp verwendet und seine
entsprechende Erweiterung an den gebebenen Dateipfad angehngt.
Im Gegensatz zum Ausfhren aus der Werkzeugkiste werden Ausgaben nicht zum Kartenfenster hinzugefgt,
wenn Sie den gleichen Algorithmus aus der Python Konsole ausfhren. Wenn Sie eine Ausgabe dem Kartenfenster
hinzufgen wollen, mssen Sie das selber nach dem Ausfhren des Algorithmus machen. Sie knnen dafr QGIS
API Befehle, oder noch einfacher eine der praktischen Methoden, die fr solche Aufgaben bereitgestellt werden,
verwenden.
Die runalg Methode gibt ein Wrterbuch mit den Ausgabenamen (diejenigen die in the Algorithmusbeschreibung gezeigt werden) als Schlssel und die Dateipfade dieser Ausgaben als Werte zurck. Sie knnen diese Layer
laden indem Sie die entsprechenden Dateipfade an die load() Methode bergeben.

17.5.2 Zustzliche Funktionen fr den Umgang mit Daten


Abgesehen von den Funktionen, die verwendet werden um Algorithmen aufzurufen, importiert das Importieren
des processing Paketes einige zustzliche Funktionen, die es einfacher machen mit Daten zu arbeiten, insbesondere Vektordaten. Sie sind einfach Komfortfunktionen, die etwas Funktionalitt aus der QGIS API zusammenfassen, fr gewhnlich mit einer weniger komplexen Syntax. Diese Funktionen sollten verwendet werden wenn
neue Algorithmen entwickelt werden, das sie es einfacher machen mit den Eingabedaten zu verfahren.
Unten steht eine Liste mit diesen Befehlen. Mehr Informationen knnen Sie in den Klassen im
processing/tools Paket und auch in den Beispielscripts, die mit QGIS bereitgestellt werden, finden.
getObject(obj): Returns a QGIS object (a layer or table) from the passed object, which can be a
filename or the name of the object in the QGIS Table of Contents.
values(layer, fields): Gibt die Werte fr die zutreffenden Felder aus der Attributtabelle eines
Vektorlayers zurck. Felder knnen als Feldnamen oder als null-basierte Feldindizes zurckgegeben werden. Es gibt ein Wrterbuch von Listen zurck, mit den zurckgegebenen Feld Identifiers als Schlssel. Es
wird die bestehende Auswahl bercksichtigt.
features(layer): Returns an iterator over the features of a vector layer, considering the existing selection.

224

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

uniqueValues(layer, field): Returns a list of unique values for a given attribute. Attributes can
be passed as a field name or a zero-based field index. It considers the existing selection.

17.5.3 Scripte erstellen und diese aus der Werkzeugkiste starten.


Sie knnen Ihre eigenen Algorithmen erstellen indem Sie entsprechenden Python Code schreiben und einige
zustzliche Zeilen schreiben um zustzliche Informationen, die bentigt werden um die Semantik des Algorithmus
zu definieren, zu liefern. Sie knnen ein Create new script Men in der Tools Gruppe im Script Algorithmus
Block der Werkzeugkiste finden. Machen Sie einen Doppelklick darauf um den Skripteditor Dialog zu ffnen.
Dort sollten Sie Ihren Code eingeben. Wenn Sie von dort aus mit der Erweiterung .py in den Ordner scripts
(der Standardordner wenn Sie den Datei speichern Dialog ffnen) speichern wird automatisch ein entsprechender
Algorithmus erstellt.
Der Name des Algorithmus (derjenige den Sie in der Werkzeugkiste sehen) wird aus dem Dateinamen erstellt,
seine Erweiterung entfernt und Unterstriche mit Leerzeichen ersetzt.
Lassen Sie uns einen Blick auf den folgenden Code, der den Topographic Wetness Index (TWI) direkt von einem
DGM berechnet, werfen.
##dem=raster
##twi=output
ret_slope = processing.runalg("saga:slopeaspectcurvature", dem, 0, None,
None, None, None, None)
ret_area = processing.runalg("saga:catchmentarea(mass-fluxmethod)", dem,
0, False, False, False, False, None, None, None, None, None)
processing.runalg("saga:topographicwetnessindex(twi), ret_slope[SLOPE],
ret_area[AREA], None, 1, 0, twi)

Wie Sie sehen knnen beinhaltet die Berechnung drei Algorithmen, die alle aus SAGA kommen. Der letzte davon
berechnet den TWI, er braucht aber einen Hangneigungslayer und einen Abflussakkumulationslyer. Diese Layer
haben wir nicht, aber da ein DGM zur Verfgung steht, knnen wir sie berechnen indem wir die entsprechenden
SAGA Algorithmen aufrufen.
Der Teil des Codes wo dieses Verarbeiten stattfindet ist nicht schwer zu verstehen wenn Sie die vorherigen Abschnitte in diesem Kapitel gelesen haben. Die ersten Zeilen jedoch erfordern einige zustzliche Erklrungen. Sie
stellen Informationen, die fr das Umwandeln Ihres Codes in einen Algorithmus, der von jeder der GUI Komponenten, wie die Werkzeugkiste oder die Grafische Modellierung, ausgefhrt werden kann, zur Verfgung.
Diese Zeilen beginnen mit einem doppelten Python Kommentar (##) und haben die folgende Struktur:
[parameter_name]=[parameter_type] [optional_values]

Hier ist eine Liste von allen Parametertypen, die in Verarbeitung Scripts untersttzt werden, mit Ihrer Syntax und
einigen Beispielen.
raster. Ein Rasterlayer.
vector. Ein Vektorlayer.
table. Eine Tabelle.
number. Ein numerischer Wert. Es muss ein Standardwert vergeben werden. Beispielsweise
depth=number 2.4.
string. Ein Text String. Wie im Fall von numerischen Werten muss ein Standardwert eingefgt werden.
Beispielsweise name=string Victor.
boolean. Ein boolscher Wert. Geben Sie True oder False danach ein um den Standardwert zu setzen.
Zum Beispiel verbose=boolean True.
multiple raster. Ein Satz von Eingaberasterlayern.
multiple vector. Ein Satz von Eingabevektorlayern.

17.5. Verarbeitung Algorithmen von der Konsole aus verwenden

225

QGIS User Guide, Release 2.6

field. Ein Feld in der Attributtabelle eines Vektorlayers. Der Name des Layers muss nach dem field
Tag hinzugefgt werden. Beispielsweise wenn Sie eine Vektoreingabe mit mylayer=vector deklariert
haben, knnten Sie myfield=field mylayer verwenden um ein Feld dieses Layers als Parameter
hinzuzufgen.
folder. Ein Ordner.
file. Ein Dateiname.
Der Parametername ist der Name, der dem Anwender gezeigt wird wenn er den Algorithmus ausfhrt und gleichzeitig der Variablenname der verwendet werden muss, um den Script Code zu verwenden.
Wenn der Name des Parameters dem Anwender gezeigt wird, wird der Name bearbeitet um seine Erscheinung zu verbessern, dabei werden Unterstriche mit Leerzeilen ersetzt. Wenn Sie also beispielsweise wollen,
dass der Anwender einen Parameter mit Namen A numerical value sieht, knnen Sie den Variablennamen
A_numerical_value verwenden.
Layer und Tabellenwerte sind Strings, die einen Dateipfad des entsprechenden Objekts enthalten. Um Sie zu
einem QGIS Objekt zu machen knnen Sie die processing.getObjectFromUri() Funktion verwenden.
Mehrfacheingaben haben auch einen String Wert, welcher die Dateipfade zu allen ausgewhlten Objekten, getrennt
durch Semikolons (;), enthlt.
Ausgaben werden auf hnliche Weise mit Hilfe der folgenden Tags definiert:
output raster
output vector
output table
output html
output file
output number
output string
Der der Ausgabevariable zugewiesene Wert ist immer ein String mit einem Dateipfad. Er entspricht einem temporren Dateipfad wenn der Anwender nicht einen Ausgabedateinamen eingegeben hat.
Wenn Sie eine Ausgabe deklarieren wird der Algorithmus versuchen ihn zu QGIS hinzuzufgen nachdem sie
beendet wurde. Darum wird auch, trotzdessen die runalg() Methode nicht die Layer, die sie produziert, ldt,
der endgltige TWI Layer geladen (indem der Fall unseres vorherigen Beispiels verwendet wird), da er in die
Datei gespeichert wird, die von Anwender eingegeben wird, welche der Wert der entsprechenden Ausgabe ist.
Verwenden Sie die load() Methode nicht in Ihren Script Algorithmen, nur wenn Sie mit der Kommandozeile
arbeiten. Wenn ein Layer als Ausgabe eines Algorithmus erstellt wird, sollte er als solcher deklariert sein. Andernfalls werden Sie nicht in der Lage sein den Algorithmus richtig in der Modellierung zu verwenden, da seine
Syntax (die oben erklrt durch Tags definiert wird) nicht das treffen wird was der Algorithmus wirklich erstellt.
Versteckte Ausgaben (Nummern und Strings) haben keinen Wert. Anstelledessen mssen Sie ihnen einen Wert
zuweisen. Um das zu tun setzen Sie einfach den Wert einer Variablen mit dem Namen, den Sie verwendet haben,
um die Ausgabe zu deklarieren. Wenn Sie beispielsweise diese Deklaration verwendet haben,
##average=output number

die folgende Zeile setzt den Wert der Ausgabe auf 5:


average = 5

Zustzlich zu den Tags fr Parameter und Ausgaben knnen Sie zustzlich die Gruppe, in der der Algorithmus
dann gezeigt wird, definieren, indem Sie den group Tag benutzen.
Wenn Ihr Algorithmus lange Zeit zum Berechnen braucht ist es eine gute Idee den Anwender zu benachrichtigen. Es steht Ihnen eine Globale genannt progress mit zwei mglichen Methoden zur Verfgung:
setText(text) und setPercentage(percent) mit denen Sie den progress Text und die progress Leiste
verndern knnen.

226

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

Mehrere Beispiele werden zur Verfgung gestellt. Bitte gehen Sie sie durch um anhand von echten Beispielen zu
erfahren wie man Algorithmen anhand der Verarbeitung Umgebung Klassen erstellt. Sie knnen auf jeden Script
Algorithmus rechtklicken und Edit script whlen um seinen Code anzuschauen oder ihn zu bearbeiten.

17.5.4 Ihre Scripte dokumentieren


Wie bei Modellen knnen Sie zustzliche Dokumentationen fr Ihre Scripts erstellen, um zu erklren was sie tun
und wie man sie benutzen kann. Im Skript-Editor Dialog werden Sie einen [Skripthilfe bearbeiten] Knopf finden.
Klicken Sie darauf und er wird Sie zum Hilfe-Editor Dialog bringen. Gehen Sie den Abschnitt ber die Grafische
Modellierung durch um mehr ber diesen Dialog und seine Anwendung zu erfahren.
Hilfedateien werden in dem gleichen Ordner wie das Script selber unter Hinzufgen der .help Erweiterung
gespeichert. Beachten Sie dass Sie Ihre Script Hilfe bearbeiten knnen bevor Sie das Script zum ersten Mal
speichern. Wenn Sie spter den Script-Editor Dialog ohne das Script zu speichern (z.B. wenn Sie es verwerfen)
schlieen geht der Hilfeinhalt, den Sie geschrieben haben, verloren. Wenn Ihr Script bereits gespeichert wurde
und mit einem Dateinamen versehen wurde, luft das Speichern des Hilfeinhalts automatisch ab.

17.5.5 Pre- und Post-execution Script Hooks


Scripts knnen auch verwendet werden um Pre- und Post-execution Hooks, die vor und nach einem Algorithmus
ausgefhrt werden, zu setzen. Dies kann dafr benutzt werden um Aufgaben zu automatisieren wann immer ein
Algorithmus ausgefhrt wird.
Die Syntax ist identisch zu der oben erklrten Syntax, es steht aber eine zustzliche Globalvariable genannt alg
zur Verfgung, die den Algorithmus, der gerade ausgefhrt wurde (oder ausgefhrt wird), reprsentiert.
In der General Gruppe des Verarbeitungsoptionen Dialogs finden Sie zwei Eintrge genannt Pre-execution script
und Post-execution script wo die Dateinamen der Scripts, die ausgefhrt werden sollen, in jedem Fall eingegeben
werden knnen.
.

17.6 Das Protokoll


17.6.1 Das Verarbeitung Protokoll
Jedes mal wenn Sie einen Algorithmus ausfhren werden Informationen ber den Prozess im Protokoll gespeichert. Zusammen mit den verwendeten Parametern werden auch das Datum und die Zeit der Ausfhrung gespeichert.
Auf diese Weise ist es einfach alle Arbeiten, die entwickelt wurden anhand der Verarbeiten Umgebung, zu verfolgen und zu kontrollieren und sie auf einfache Art und Weise zu reproduzieren.
Das Protokoll ist ein Satz von Registryeintrgen, die entsprechend ihres Ausfhrungsdatums gruppiert werden, um
leichert Informationen ber einen Algorithmus, der zu einem bestimmten Moment ausgefhrt wurde, zu finden.
Prozessinformationen werden als Kommandozeilen-Ausdruck gespeichert, auch wenn der Algorithmus aus der
Toolbox gestartet wurde. Dies macht es auch ntzlich zu lernen, wie man die Kommandozeilen-Schnittstelle
verwendet, da man damit auch einen Algorithmus mit der Toolbox anrufen und dann im History Manager sehen
und prfen kann, wie der Algorithmus von der Kommandozeile aus aufgerufen werden kann.
Abgesehen vom Durchsuchen der Eintrge in der Registry knnen Sie auch Prozesse wiederausfhren, indem Sie
auf den entsprechenden Eintrag doppelklicken.
Zusammen mit der Aufzeichnung von Algorithmusausfhrungen kommuniziert die Verarbeitung Umgebung mit
dem Anwender anhand von anderen Gruppen der Registry, nmlich Errors, Warnings und Information. Fr den
Fall dass etwas nicht richtig funktioniert kann ein Blick auf die Errors vielleicht helfen herauszufinden, was
passiert. Wenn Sie in Kontakt mit einem Entwickler kommen, um einen Bug oder Fehler zu melden, wird die
Information in dieser Gruppe fr sie/ihn sehr ntzlich sein um herauszufinden, was falsch luft.
17.6. Das Protokoll

227

QGIS User Guide, Release 2.6

Abbildung 17.28: Protokoll


Algorithmen von Drittanbietern werden normalerweise ausgefhrt, indem ihre Kommandozeilenschnittstellen,
die mit dem Anwender ber die Konsole kommunizieren, aufgerufen werden. Trotzdessen diese Konsole nicht
gezeigt wird, wird ein vollstndiger Auszug davon in der Information Gruppe jedesmal wenn Sie einen dieser
Algorithmen ausfhren, gespeichert. Wenn Sie beispielsweise Problem beim Ausfhren eines SAGA Algorithmus
haben, suchen Sie nach einem Eintrag genannt SAGA execution console output , um alle von SAGA erzeugten
Nachrichten zu berprfen, und um zu versuchen herauszufinden wo das Problem ist.
Einige Algorithmen knnen, selbst wenn Sie ein Ergebnis mit den gegebenen Eingabedaten erzeugen knnen,
einen Kommentar oder zustzliche Informationen an den Warning Block hinzufgen, wenn sie potentielle Probleme mit den Daten auffinden, um Sie zu warnen. Vergewissern Sie sich, dass Sie diese Nachrichten berprfen,
wenn Sie unerwartete Ergebnisse erhalten.

17.7 Writing new Processing algorithms as python scripts


You can create your own algorithms by writing the corresponding Python code and adding a few extra lines to
supply additional information needed to define the semantics of the algorithm. You can find a Create new script
menu under the Tools group in the Script algorithms block of the toolbox. Double-click on it to open the script
edition dialog. Thats where you should type your code. Saving the script from there in the scripts folder (the
default one when you open the save file dialog), with .py extension, will automatically create the corresponding
algorithm.
The name of the algorithm (the one you will see in the toolbox) is created from the filename, removing its extension
and replacing low hyphens with blank spaces.
Lets have the following code, which calculates the Topographic Wetness Index (TWI) directly from a DEM
##dem=raster
##twi=output raster
ret_slope = processing.runalg("saga:slopeaspectcurvature", dem, 0, None,
None, None, None, None)
ret_area = processing.runalg("saga:catchmentarea", dem,

228

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

0, False, False, False, False, None, None, None, None, None)


processing.runalg("saga:topographicwetnessindextwi, ret_slope[SLOPE],
ret_area[AREA], None, 1, 0, twi)

As you can see, it involves 3 algorithms, all of them coming from SAGA. The last one of them calculates the TWI,
but it needs a slope layer and a flow accumulation layer. We do not have these ones, but since we have the DEM,
we can calculate them calling the corresponding SAGA algorithms.
The part of the code where this processing takes place is not difficult to understand if you have read the previous
chapter. The first lines, however, need some additional explanation. They provide the information that is needed to
turn your code into an algorithm that can be run from any of the GUI components, like the toolbox or the graphical
modeler.
These lines start with a double Python comment symbol (##) and have the following structure
[parameter_name]=[parameter_type] [optional_values]

Here is a list of all the parameter types that are supported in processign scripts, their syntax and some examples.
raster. A raster layer
vector. A vector layer
table. A table
number. A numerical value. A default value must be provided. For instance, depth=number 2.4
string. A text string. As in the case of numerical values, a default value must be added. For instance,
name=string Victor
longstring. Same as string, but a larger text box will be shown, so it is better suited for long strings,
such as for a script expecting a small code snippet.
boolean. A boolean value. Add True or False after it to set the default value. For example,
verbose=boolean True.
multiple raster. A set of input raster layers.
multiple vector. A set of input vector layers.
field. A field in the attributes table of a vector layer. The name of the layer has to be added after the
field tag. For instance, if you have declared a vector input with mylayer=vector, you could use
myfield=field mylayer to add a field from that layer as parameter.
folder. A folder
file. A filename
crs. A Coordinate Reference System
The parameter name is the name that will be shown to the user when executing the algorithm, and also the variable
name to use in the script code. The value entered by the user for that parameter will be assigned to a variable with
that name.
When showing the name of the parameter to the user, the name will be edited it to improve its appearance, replacing
low hyphens with spaces. So, for instance, if you want the user to see a parameter named A numerical value,
you can use the variable name A_numerical_value.
Layers and tables values are strings containing the filepath of the corresponding object. To turn them into a QGIS
object, you can use the processing.getObjectFromUri() function. Multiple inputs also have a string
value, which contains the filepaths to all selected objects, separated by semicolons (;).
Outputs are defined in a similar manner, using the following tags:
output raster
output vector
output table

17.7. Writing new Processing algorithms as python scripts

229

QGIS User Guide, Release 2.6

output html
output file
output number
output string
output extent
The value assigned to the output variables is always a string with a filepath. It will correspond to a temporary
filepath in case the user has not entered any output filename.
In addition to the tags for parameters and outputs, you can also define the group under which the algorithm will
be shown, using the group tag.
The last tag that you can use in your script header is ##nomodeler. Use that when you do not want your
algorithm to be shown in the modeler window. This should be used for algorithms that do not have a clear syntax
(for instance, if the number of layers to be created is not known in advance, at design time), which make them
unsuitable for the graphical modeler

17.8 Handing data produced by the algorithm


When you declare an output representing a layer (raster, vector or table), the algorithm will try to add it to QGIS
once it is finished. That is the reason why, although the runalg() method does not load the layers it produces,
the final TWI layer will be loaded, since it is saved to the file entered by the user, which is the value of the
corresponding output.
Do not use the load() method in your script algorithms, but just when working with the console line. If a layer
is created as output of an algorithm, it should be declared as such. Otherwise, you will not be able to properly use
the algorithm in the modeler, since its syntax (as defined by the tags explained above) will not match what the
algorithm really creates.
Hidden outputs (numbers and strings) do not have a value. Instead, it is you who has to assign a value to them. To
do so, just set the value of a variable with the name you used to declare that output. For instance, if you have used
this declaration,
##average=output number

the following line will set the value of the output to 5:


average = 5

17.9 Communicating with the user


If your algorithm takes a long time to process, it is a good idea to inform the user. You have a global named
progress available, with two available methods: setText(text) and setPercentage(percent) to
modify the progress text and the progress bar.
If you have to provide some information to the user, not related to the progress of the algorithm, you can use the
setInfo(text) method, also from the progress object.
If your script has some problem, the correct way of propagating it is to raise an exception of type
GeoAlgorithmExecutionException(). You can pass a message as argument to the constructor of the
exception. Processing will take care of handling it and communicating with the user, depending on where the
algorithm is being executed from (toolbox, modeler, Python console...)

230

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

17.10 Documenting your scripts


As in the case of models, you can create additional documentation for your script, to explain what they do and
how to use them. In the script editing dialog you will find a [Edit script help] button. Click on it and it will take
you to the help editing dialog. Check the chapter about the graphical modeler to know more about this dialog and
how to use it.
Help files are saved in the same folder as the script itself, adding the .help extension to the filename. Notice that
you can edit your scripts help before saving it for the first time. If you later close the script editing dialog without
saving the script (i.e. you discard it), the help content you wrote will be lost. If your script was already saved and
is associated to a filename, saving is done automatically.

17.11 Beispielskripte
Several examples are available in the on-line collection of scripts, which you can access by selecting the Get script
from on-line script collection tool under the Scripts/tools entry in the toolbox.

Please, check them to see real examples of how to create algorithms using the processing framework classes. You
can right-click on any script algorithm and select Edit script to edit its code or just to see it.

17.12 Best practices for writing script algorithms


Heres a quick summary of ideas to consider when creating your script algorithms and, epsecially, if you want to
share with other QGIS users. Following these simple rules will ensure consistency across the different Processing
elements such as the toolbox, the modeler or the batch processing interface.
Do not load resulting layers. Let Processing handle your results and load your layers if needed.
Always declare the outputs your algorithm creates. Avoid things such as decalring one output and then
using the destination filename set for that output to create a collection of them. That will break the correct
semantics of the algorithm and make it impossible to use it safely in the modeler. If you have to write an
algorithm like that, make sure you add the ##nomodeler tag.
Do not show message boxes or use any GUI element from the script. If you want to communicate with the
user, use the setInfo() method or throw an GeoAlgorithmExecutionException
As a rule of thumb, do not forget that your agorithm might be executed in a context other than the Processing
toolbox.

17.13 Pre- and post-execution script hooks


Scripts can also be used to set pre- and post-execution hooks that are run before and after an algorithm is run. This
can be used to automate tasks that should be performed whenever an algorithm is executed.
The syntax is identical to the syntax explained above, but an additional global variable named alg is available,
representing the algorithm that has just been (or is about to be) executed.
In the General group of the processing config dialog you will find two entries named Pre-execution script file and
Post-execution script file where the filename of the scripts to be run in each case can be entered.

17.10. Documenting your scripts

231

QGIS User Guide, Release 2.6

17.14 Konfiguration externer Anwendungen


Die Verarbeiten Umgebung kann anhand von zustzlichen Anwendungen erweitert werden. Derzeit werden
SAGA, GRASS, OTB (Orfeo Toolbox) und R zusammen mit einigen anderen Kommandozeilenanwendungen,
die rumliche Datenanalysefunktionalitten bereitstellen, untersttzt. Algorithmen, die von einer externen Anwendung herrhren, werden von ihrem eigenen Algorithmusprovider verwaltet.
Dieses Kapitel zeigt Ihnen, wie Sie die Verarbeiten Umgebung so konfigurieren, dass diese zustzlichen Anwendungen integriert sind, zudem werden einige Besonderheiten zu den Algorithmen, die auf ihnen basieren, erklren. Wenn das System korrekt konfiguriert ist, sind Sie in der Lage, externe Algorithmen von jeder Verarbeiten
Komponente, wie die Toolbox oder der grafischen Modellierung, auszufhren, so wie Sie es mit jedem anderen
Geo-Algorithmus gewohnt sind.
Standardmig sind alle Algorithmen, die aus einer externen Anwendung kommen und nicht in QGIS enthalten sind, deaktiviert. Sie knnen Sie in den Verarbeitungsoptionen aktivieren. Stellen Sie sicher, dass die
entsprechende Anwendung schon auf Ihrem System installiert ist. Das Aktivieren des Algorithmusproviders ohne
das Installieren der Anwendung, die bentigt wird, bewirkt, dass Algorithmen in der Werkzeugkiste erscheinen,
es wird dann aber ein Fehler ausgegeben wenn Sie versuchen sie auszufhren.
Das ist so, weil die Beschreibung des Algorithmus (erforderlich, um den Parameter Dialog zu erstellen und die
bentigten Informationen bereitzustellen) nicht in jeder Appllikation enthalten ist, dafr aber in QGIS. Das heit,
sie sind Teil von QGIS, so haben Sie sie in Ihrer Installation, auch wenn Sie keine andere Software installiert
haben. Zum Ausfhren des Algorithmus mssen jedoch auch die Binrdateien der Anwendung auf Ihrem System
installiert sein.

17.14.1 Ein Hinweis fr Windows Anwender


Wenn Sie kein fortgeschrittener Anwender sind und QGIS unter Windows benutzen, sind Sie vielleicht nicht daran
interessiert, den Rest dieses Kapitels zu lesen. Stellen Sie sicher, dass Sie QGIS auf Ihrem System mit Hilfe des
Standalone Installers installiert haben. Das wird automatisch SAGA, GRASS und OTB auf Ihrem System installieren und sie konfigurieren, so dass sie von QGIS aus zum Laufen gebracht werden knnne. Alle Algorithmen in
der simplified Ansicht der Werkzeugkiste werden fertig zum Ausfhren ohne weitere Konfigurationen sein. Wenn
Sie ber die OSGeo4W Anwendung installieren stellen Sie sicher dass SAGA und OTB zur Installation ebenfalls
ausgewhlt sind.
Wenn Sie mehr darber, wie die Provider arbeiten, wissen wollen oder wenn Sie einige Algorithmen, die nicht in
der simplified Werkzeugkiste enthalten sind (wie R Scripts), benutzen wollen, lesen Sie weiter.

17.14.2 Eine Bemwerkung zu den Datenformaten


Bei Verwendung einer externen Software, bedeutet das ffnen einer Datei in QGIS nicht, dass es auch von der
anderen Software geffnet und verarbeitet werden kann. In den meisten Fllen knnen sie zwar auch lesen, was
Sie in QGIS geffnet haben, aber in einigen Fllen ist das vielleicht nicht der Fall. Bei der Verwendung von
Datenbanken oder seltenen Dateiformaten, ob fr Raster- oder Vektorlayer, knnten Probleme auftreten. Wenn
das passiert, versuchen Sie, bekannte Dateiformate, bei denen Sie sicher sind, dass sie von beiden Programmen
verstanden werden, zu verwenden, und berprfen Sie die Ausgabe (im History und Log-Dialog) fr weitere
Informationen.
Das Verwenden von RASS Rasterlayern ist beispielsweise ein Fall, in dem Sie vielleicht Probleme haben und
nicht in der Lage sein werden Ihre Arbeit zu vervollstndigen, wenn Sie einen externen Algorithmus mit einem
solchen Layer als Eingabe aufrufen. Aus diesem Grund erscheinen diese Layer als nicht zur Verfgung stehend
fr die Algorithmen.
Bei Vektorlayern sollten jedoch keine Probleme auftreten, da QGIS diese automatisch vom ursprnglichen
Dateiformat zu einem von der externen Anwendung akzeptierten Format konvertiert bevor es den Layer bergibt.
Dies bentigt zustzliche Bearbeitungszeit, die erheblich sein kann, wenn der Layer gro ist. Also nicht wundern,
232

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

wenn es lnger braucht, um einen Layer aus einer DB-Verbindung zu analysieren, als bei einem hnlich groen
Shapefile.
Provider, die keine externe Anwendung verwenden knnen jeden beliebigen Layer, den Sie in QGIS ffnen knnen, prozessieren, da Sie ihn fr Analysen anhand von QGIS ffnen.
In bezug auf Ausgabeformate knnen alle von QGIS als Ausgabe untersttzen Formate verwendet werden, fr
Raster- und Vektorlayer. Einige Provider untersttzen kene bestimmten Formate, aber alle knnen in gngige
Rasterlayerformate exportieren, die spter von QGIS automatisch transformiert werden knnen. Wie im Fall von
Eingabelayern kann das, wenn eine Konvertierung bentigt wird, die Rechenzeit erhhen.
Wenn die Erweiterung des Dateinamens, der festgelegt wird, wenn ein Algorithmus nicht die Erweiterung eines
der von QGIS unterstzten Formate besitzt, dann wird ein Suffix hinzugefgt um das Standardformat zu setzen.
Im Fall von Rasterlayern wird die Erweiterung .tif verwendet, whrend .shp fr Vektorlayer verwendet wird.

17.14.3 Eine Bemerkung zu Vektorlayern mit ausgewhlten Objekten


Externe Anwendungen knnen auch ber die Auswahl die in Vektorlayern innerhalb von QGIS vorliegt unterrichtet werden. Das jedoch erfordert das Umschreiben aller Eingabevektorlayer, so als wrden Sie ursprnglich in
einem Format, das nicht von der externen Anwendung untersttzt wird, vorliegen. Nur wenn eine Auswahl besteht, oder die Use only selected features Option in den Verarbeitungsoptionen nicht aktiviert ist, kann ein Layer
direkt an eine externe Anwendung bergeben werden.
In anderen Fllen wird das Exportieren von nur ausgewhlten Objekten bentigt, was bewirkt, dass sich die Ausfhrungszeiten verlngern.
SAGA
SAGA Algorithmen knnen von QGIS aus benutzt werden wenn Sie SAGA auf Ihrem System installiert haben
und Sie die Verarbeiten Umgebung richtig konfigurieren, so dass es ausfhrbare Module von SAGA finden kann.
Insbesondere das SAGA Kommandozeilenmodul wird bentigt 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
ausfhrbaren 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. Schlieen Sie den Verarbeitungsoptionendialog und jetzt knnen Sie SAGA Algorithmen aus
QGIS heraus ausfhren.
Wenn Sie Linux benutzen, sind SAGA Binrpakete nicht in der Verarbeitung Umgebung enthalten, also mssen
Sie die Software selber downloaden und installieren. Bitte berprfen Sie die SAGA Webseite fr mehr Informationen. Es wird SAGA 2.1 bentigt.
In diesem Fall braucht der Pfad zu den ausfhrbaren SAGA Modulen nicht konfiguriert werden und Sie werden diese Ordner nicht sehen. Anstelledessen mssen Sie sicherstellen, dass SAGA richtig installiert ist und
seine Ordner zur PATH Umgebungsvariable hinzugefgt wurden. ffnen Sie einfach eine Konsole und geben
Sie saga_cmd ein um zu berprfen, dass das System herausfindet, wo sich die SAGA Binrpakete befinden.

17.14.4 ber die SAGA KBS Einschrnkungen


Die meisten SAGA Algorithmen, die mehrere Eingaberasterlayer bentigen, haben die Anforderung, dass diese
das gleiche Grid-System haben. Das heisst, dass Sie das gleiche geografische Gebiet abdecken und die gleiche
Zellgre besitzen mssen, so dass Ihre korrespondierenden Grids zueinanderpassen. Wenn SAGA Algorithmen
von QGIS aus aufgerufen werden, knnen Sie jeden Layer unabhngig von Zellgre und Ausdehnung benutzen.
Wenn Mahrfachrasterlayer als Eingabe fr einen SAGA Algorithmus verwendet werden, resampled QGIS sie zu
einem gemeinsamen Grid-System und bergibt diese dann an SAGA (es sei denn der SAGA Algorithmus kann
mit Layern aus verschiedenen Grid-Systemen operieren).

17.14. Konfiguration externer Anwendungen

233

QGIS User Guide, Release 2.6

Die Definition dieses gemeinsamen Grid-Systems wird durch den Anwender kontrolliert und Sie werden dafr
mehrere Parameter in der SAGA Gruppe im Einstellungen Fenster finden. Es gibt zwei Wege das Ziel-GridSystem einzustellen:
Manuelles Einstellen. Sie definieren das Ausma indem Sie die Werte der folgenden Parameter setzen:
Resampling min X
Resampling max X
Resampling min Y
Resampling max Y
Resampling cellsize
Beachten Sie, dass QGIS alle Eingabelayer bis zu diesem Ausma resampled, auch wenn sie sich nicht
damit berschneiden.
Automatisches Einstellen aus Eingabelayern. Um diese Option auszuwhlen, berprfen Sie einfach die
Use min covering grid system for resampling Option. Alle anderen Einstellungen werden ignoriert und
das minimale Ausma, das alle Eingabelayer abdeckt, wird benutzt. Die Zellgre des Ziellayers ist das
Maximum aller Zellgren des Eingabelayers.
Fr Algorithmen, die nicht mit mehreren Rasterlayern arbeiten, oder fr diejenigen, die kein eindeutiges KBS
bauchen, wird kein Resampling vor dem Aufruf von SAGA durchgefhrt, und die Parameter werden nicht verwendet.

17.14.5 Einschrnkungen fr Multi-Band-Layer


Im Gegensatz zu QGIS hat SAGA keine Untersttzung fr Multikanallayer. Wenn Sie einen Multikanallayer benutzen wollen (so wie ein RGB oder ein Multispektralbild), mssen Sie ihn erst in Einkanalbilder aufspalten. Um
das zu tun, knnen Sie den SAGA/Grid - Tools/Split RGB image Algorithmus (der drei Bilder aus einem RGB
Bild erstellt) oder den SAGA/Grid - Tools/Extract band Algorithmus (um einen einzelnen Kanal zu extrahieren)
verwenden.

17.14.6 Einschrnkungen in der Zellgre


SAGA geht davon aus, dass Rasterlayer die selbe Pixelgre in X- und Y-Richtung haben. Wenn Sie mit einem
Layer mit unterschiedlichen Werten fr die horizontale und vertikale Pixelge arbeiten, erhalten Sie mglicherweise unerwartete Ergebnisse. In diesem Fall wird eine Warnung im Verarbeitung Protokoll hinzugefgt, das
anzeigt, dass ein Layer mglicherweise nicht geeignet ist, von SAGA verarbeitet zu werden.

17.14.7 Logging
Wenn QGIS SAGA aufruft, findet das ber die Kommandozeilen-Schnittstelle statt mit einer Reihe von Befehlen,
um alle erforderlichen Operation durchzufhren. SAGA zeigt den Fortschritt, indem es Informationen an die
Konsole bergibt, die den Prozentsatz der Verarbeitung beinhaltet, zusammen mit zustzlichen Inhalten. Diese
Ausgabe wird gefiltert und verwendet, um die Fortschrittsanzeige zu aktualisieren, whrend der Algorithmus
luft.
Sowohl die von QGIS gesendeten Befehle und die von SAGA gedruckte zustzliche Information kann mit anderen
Verarbeitung Protokollnachrichten gelogged werden und Sie knnten es ntzlich finden im Detail zu verfolgen
was passiert wenn QGIS einen SAGA Algorithmus aufruft. Sie werden zwei Einstellungen finden, nmlich Log
console output und Log execution commands um diesen Protokollierungsmechanismus zu aktivieren.
Die meisten anderen Provider, die eine externe Anwendung verwenden und diese aus der Kommandozeile
aufrufen, haben hnliche Optionen, also finden Sie sie auch an anderer Stelle in der Verarbeitungsoptionen Liste.

234

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

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 ausfhren 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 mssen, wie wir im Fall von SAGA gesehen haben, ist zu sagen, wo sich die R Binrdateien
befinden. Sie knnen dies tun, indem Sie den R folder Eintrag im Verarbeitung Konfigurationsdialog ansprechen.
Nachdem Sie die Parameter definiert haben, knnen Sie anfangen, eigene R-Skripte zu erstellen und auszufhren.
Dies ist wieder anders in Linux. Dort mssen Sie nur sicherstellen, dass der R-Ordner in der Umgebungsvariablen
PATH enthalten ist. Wenn Sie nur die Eingabe R in eine Konsole eingeben knnen, kann es losgehen.
Um einen neuen Algorithmus hinzuzufgen, der eine R Funktion (oder ein komplexeres RScript, das sie entwickelt haben und das sie gerne zur in QGIS zur Verfgung stehen haben wollen) aufruft, mssen Sie eine Script
Datei erstellen, die der Verarbeiten Umgebung, wie diese Operation durchgefhrt 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 knnen diesen Ordner in der R Einstellungen Gruppe (steht im Verarbeitungsoptionen Dialog)
einstellen, genauso wie Sie es mit dem Ordner fr regulre Verarbeitung Scripts machen.
Werfen Sie einen Blick auf eine sehr einfache Scripts-Datei, die die R-Methode spsample aufruft und ein zuflliges Gitter innerhalb der Grenzen eines Polygon in einem bestimmten Polygon-Layer erstellt. Diese Methode
gehrt zum Paket zur MapTools. Grundstzlich brauchen Sie fr R-Algorithmen, die Sie in Verarbeitung fr
rumliche 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))

Die ersten Zeilen, die mit einem doppelten Python Kommentarzeichen (##) beginnen teilen QGIS die Eingaben
des Algorithmus, der in der Datei beschrieben wird und die Ausgaben, die er erzeugen wird, mit. Sie arbeiten mit
genau der gleichen Syntax wie den Verarbeitung Scripts, die wir bereits gesehen haben, also werden Sie hier nicht
noch einmal beschrieben.
Wenn Sie einen Eingabeparameter definieren, verwendet QGIS diese Informationen fr zwei Dinge: Erstellung
der Benutzeroberflche, um die Benutzer nach Eingaben von Parameters zu fragen und die Schaffung einer
entsprechenden R Variable, die spter als Eingabe fr die R-Befehle verwendet werden.
In dem obigen Beispiel erklren wir die Eingabe vom Typ Vektor mit dem Namen polyg. Bei der Ausfhrung
des Algorithmus wird durch QGIS R geffnet und der Layer, der durch den Benutzer ausgewhlt wurde, in einer
Variablen polyg abgelegt. Der Name des Parameters ist also auch der Name der Variablen, die wir in R fr den
Zugriff auf den Wert des Parameters nutzen (vermeiden Sie, reservierte R Begriffe als Parameter zu verwenden).
Rumliche Elemente wie Vektor- und Rasterlayer werden mit den readOGR() und brick() Befehlen eingelesen (sie brauchen sich nicht darum kmmern diese Befehle Ihrer Beschreibungsdatei hinzuzufgen - das macht
QGIS) und sie werden als Spatial*DataFrame Objekte gespeichert. Tabellenfelder werden als Strings, die
den Namen des ausgewhlten Feldes beinhalten, gespeichert.
Tabellen werden anhand des read.csv() Befehls geffnet. Wenn ein Anwender eine Tabelle eingibt, die nicht
im CSV Format ist, wird diese vor dem Importieren in R konvertiert.
Zustzlich knnen 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 reprsentiert, erstellt, knnen Sie den ##passfilename Tag benutzen um anzuzeigen, dass Sie anstelledessen einen
17.14. Konfiguration externer Anwendungen

235

QGIS User Guide, Release 2.6

String mit dem Dateinamen bevorzugen. In diesem Fall ist es an Ihnen, die Datei vor dem Durchfhren von Operationen mit Daten, die es beinhaltet, zu ffnen.
Mit den oben genannten Informationen knnen 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 enthlt 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 hinzugefgt werden sollen.
Da wir eine Ausgabe vom Typ Vektor definiert haben mit dem Namenout, mssen wir nun eine
Variable namens out erstellen und Spatial*DATAframe Objekt dafr erstellen (in diesem Fall ein
SpatialPointsDataFrame). Sie knnen einen beliebigen Namen fr 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 enthlt.
In diesem Fall muss das von der spsample Methode erhaltene Ergebnis ausdrcklich in ein
SpatialPointsDataFrame Objekt konvertiert werden, da es ein Objekt der Klasse ppp ist, welches keine
geeignete Klasse ist um an QGIS zurckgegeben zu werden.
Wenn Ihr Algorithmus Rasterlayer erstellt, hngt 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 fr Eingaben verwendet wird.
Wenn Ihr Algorithmus keinen Layer erzeugt sondern stattdessen ein Textergebnis in der Konsole, mssen Sie
angeben, dass die Konsole gezeigt wird, nachdem die Ausfhrung beendet ist. Um das zu tun starten Sie die Kommandozeilen, die die Ergebnisse produzieren, die Sie mit dem > (grer) 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 durchfhrt:
##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 hinzugefgt werden).
Wenn Ihr Algorithmus eine Grafiken erstellt (mit der plot()-Methode), fgen Sie die folgende Zeile ein:
##showplots

Dies bewirkt, dass QGIS alle grafischen Ausgaben von R in eine temporre Datei, die geffnet wird nachdem die
Ausfhrung von R beendet wurde, umleitet.
Sowohl grafische als auch Konsolenergebnisse werden im Verarbeitung Ergebnisanzeige gezeigt.
Fr weitere Informationen schauen Sie sich bitte die Skript-Dateien an, die Verarbeitung bereits enthlt. Die
meisten von ihnen sind ziemlich einfach und werden wesentlich dazu beitragen, wie Sie Ihre eigenen erstellen.
Bemerkung: rgdal and maptools Bibliotheken werden standardmig geladen, Sie mssen also nicht die
entsprechenden library() Befehle hinzufgen (Sie mssen nur sicherstellen, dass diese zwei Pakete in Ihrer RDistribution installiert sind). Jedoch mssen andere zustzliche Bibliotheken, die Sie vielleicht brauchen, explizit
geladen werden. Geben Sie einfach die notwendigen Befehle am Anfang Ihres Scripts ein. Auch mssen Sie
sicherstellen, dass die entsprechenden Pakete in der R-Distribution, die von QGIS genutzt wird, installiert sind.
Die Verarbeiten Umgebung kmmert sich nicht um Paketinstallationen. Wenn Sie ein Skript ausfhren, das ein
Paket erfordert, das nicht installiert ist, wird die Ausfhrung fehlschlagen und die Verarbeitung wird versuchen,

236

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

zu ermitteln welche Pakete fehlen. Sie mssen diese Bibliotheken manuell installieren bevor sie den Algorithmus
ausfhren knnen.

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. Zustzlich gibt es einen
Shell-Interpreter (in der Regel: msys.exe, den Sie in den meisten GRASS fr Windows-Distributionen finden)
der definiert werden muss, genauso wie der Pfad dorthin.
Standardmig 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, mssen Sie vielleicht die GRASS Verbindung manuell
konfigurieren. Auch wenn Sie eine andere GRASS Installation benutzen wollen, knnen Sie diese Einstellung
ndern und auf den Ordner , wo die andere Version installiert ist, verweisen. Damit die Algorithmen korrekt
funktionieren wird GRASS 6.4. bentigt.
Wenn Sie Linux verwenden, mssen Sie nur noch sicherstellen, dass GRASS richtig installiert ist, und dass es
problemlos von einer Konsole ausgefhrt werden kann.
GRASS Algorithmen verwenden eine Region fr 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 ausgefhrt wird. Wenn
dies das Verhalten ist, das Sie bevorzugen, knnen 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 bentigt um
GRASS benutzen zu knnen und die Verarbeiten Umgebung erstellt eine temporre fr jede Ausfhrung. Sie
mssen angeben, ob die Daten, mit denen Sie arbeiten Geografische (lat/lon) Koordinaten oder projezierte verwenden.
GDAL
Ist keine zustzliche Konfiguration erforderlich, um GDAL Algorithmen laufen zu lassen. Da es bereits in QGIS
integriert ist, knnen die Algorithmen ihre Konfiguration davon ableiten.
Orfeo Toolbox
Orfeo Toolbox (OTB) Algorithmen knnen von QGIS aus ausgefhrt 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 Binrpakete im Installationspaket fr Windows enthalten, sie sind aber nicht
enthalten wenn Sie Linux benutzen, also mssen Sie die Software selber downloaden und installieren. Bitte berprfen Sie die OTB Webseite fr 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 fr 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

17.14. Konfiguration externer Anwendungen

237

QGIS User Guide, Release 2.6

C:\OSGeo4W\bin as OTB command line tools folder ein. Diese Werte sollten standardmig konfiguriert werden, aber wenn Sie eine abweichende OTB Installation durchgefhrt haben, konfigurieren Sie sie
auf die entsprechenden Werte in Ihrem System.
TauDEM
Um diesen Provider zu verwenden mssen Sie TauDEM Kommandozeilentools installieren.

17.14.8 Windows
Bitte besuchen Sie die TauDEM homepage fr Installationhinweise und vorkompilierte Binrpakete fr 32-bit und
64-bit Systeme. WICHTIG: Sie bentigen die ausfhrbaren Dateien von TauDEM 5.0.6. Version 5.2 wird derzeit
nicht untersttzt.

17.14.9 Linux
Es gibt keine Pakete fr die meisten Linux Ditributionen, Sie sollten TauDEM also selber kompilieren. Da TauDEM MPICH2 verwendet, installieren Sie dieses zuerst und verwenden Sie dabei ihren bevorzugten Paketmanager. Alternativ dazu funktioniert TauDEM gut mit Open MPI, Sie knnen es also anstelle von MPICH2 verwenden.
Laden Sie TauDEM 5.0.6 source code und extrahieren Sie die Datein in einen gewissen Ordner.
ffnen Sie die linearpart.h Datei, und nach der Zeile
#include "mpi.h"

fgen Sie einen neue Zeile ein mit


#include <stdint.h>

dadurch bekommen Sie


#include "mpi.h"
#include <stdint.h>

Speichern Sie die nderungen und schlieen Sie die Datei. ffnen Sie jetzt tiffIO.h, finden Sie die Zeile
#include "stdint.h" und ersetzen Sie die Anfhrungszeichen ("") mit <> so dass Sie jetzt folgendes erhalten
#include <stdint.h>

Speichern Sie die nderungen und schlieen Sie die Datei. Erstellen Sie ein Build-Verzeichnis und machen Sie
ein cd dort hin.
mkdir build
cd build

Konfigurieren Sie Ihr build mit dem Befehl


CXX=mpicxx cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..

und dann kompilieren


make

Schlielich, um TauDEM in /usr/local/bin zu installieren, geben Sie ein


sudo make install

238

Kapitel 17. QGIS Verarbeitung Umgebung

QGIS User Guide, Release 2.6

17.15 The QGIS Commander


Processing includes a practical tool that allows you to run algorithms without having to use the toolbox, but just
by typing the name of the algorithm you want to run.
This tool is known as the QGIS commander, and it is just a simple text box with autocompletion where you type
the command you want to run.

Abbildung 17.29: The QGIS Commander


The Commander is started from the Analysis menu or, more practically, by pressing Shift + Ctrl + M (you
can change that default keyboard shortcut in the QGIS configuration if you prefer a different one). Apart from
executing Processing algorithms, the Commander gives you access to most of the functionality in QGIS, which
means that it gives you a practical and efficient way of running QGIS tasks and allows you to control QGIS with
reduced usage of buttons and menus.
Zudem ist der Commander konfigurierbar, Sie knnen also benutzerdefinierte Befehle hinzufgen und finden Sie
dann nur ein paar Tastendrcke entfernt, was es zu einem mchtigen Werkzeug macht, das Ihnen hilft bei Ihrer
tglichen Arbeit produktiver mit QGIS zu werden.

17.15.1 Zur Verfgung stehende Befehle


Die zur Verfgung stehenden Befehle im Commander fallen in die folgenden Kategorien:
Processing algorithms.
algorithm>.

These

are

shown

as

Processing algorithm: <name of the

Menu actions. Diese werden als Menu action:<Meneintragtext gezeigt. Alle zur Verfgung stehenden Menelemente von der QGIS Oberflche sind zugnglich, auch wenn sie sich in einem Untermen
befinden.
Pythonfunktionen. Sie knnen kurze Pythonfunktionen erstellen, die dann in die Liste von zur Verfgung
stehenden Befehlen eingefgt werden. Sie werden als Function:<Funktionsname> gezeigt.
Um einen der obigen Befehle zum Laufen zu bringen fangen Sie einfach an einzugeben und whlen Sie das
entsprechende Element aus der Liste der zur Verfgung stehenden Befehle, das nach dem Filtern der ganzen Liste
von Befehlen erscheint, aus.
Im Falle des Aufrufen eines Pythonfunktion knnen Sie den Eintrag in der Liste, dem der Begriff
Function: vorausgeht, auswhlen (zum Beispiel Function:removeall) oder Sie geben den Funktionsnamen (removeall im vorigen Beispiel) direkt ein. Sie mssen keine Klammern nach dem Funktionsnamen
eingeben.

17.15.2 Benutzerdefinierte Funktionen erstellen


Benutzerdefinierte Funktionen werden eingegeben indem Sie den entsprechenden Pythoncode in die
commands.py Datei, die Sie im .qgis/sextante/commander directory in Ihrem Benutzerverze17.15. The QGIS Commander

239

QGIS User Guide, Release 2.6

ichnis finden, eingeben. Es ist nur eine einfach Python Datei in die Sie alle Funktionen, die Sie brauchen eingeben
knnen.
Die Datei wird mit einigen Beispielfunktionen erstellt wenn Sie den Commander das erste Mal ffnen. Wenn
Sie den Commander noch nicht geffnet haben knnen Sie die Datei selber erstellen. Um die Befehlsdatei zu
bearbeiten benutzen Sie Ihren bevorzugten Texteditor. Sie knnen auch einen integrierten Editor, indem Sie den
edit Befehl aus dem Commander heraus aufrufen, benutzen. Dies ffnet den Editor mit der Befehlsdatei und Sie
knnen diesen direkt bearbeiten und dann Ihre nderungen speichern.
Beispielsweise knnen Sie die folgende Funktion, die alle Layer entfernt, hinzufgen.
from qgis.gui import *
def removeall():
mapreg = QgsMapLayerRegistry.instance()
mapreg.removeAllMapLayers()

Nachdem Sie die Funktion hinzugefgt haben, steht sie im Commander zur Verfgung und Sie knnen sie durch
Eingabe von removeall aufrufen. Es braucht nichts weiter getan werden als die Funktion selber zu schreiben.
Funktionen knnen Parameter empfangen. Fgen Sie *args Ihrer Funktionsdefinition hinzu um Argumente zu
empfangen. Wenn Sie die Funktion aus dem Commander aufrufen mssen Parameter getrennt durch Leerzeichen
bergeben werden.
Hier ist ein Beispiel einer Funktion, die einen Layer ldt und einen Parameter mit dem Dateinamen von dem zu
ladenden Layer nimmt.
import processing
def load(*args):
processing.load(args[0])

Wenn Sie den Layer in /home/myuser/points.shp


/home/myuser/points.shp in das Commander Textfeld ein.

laden

wollen,

geben

Sie

load

240

Kapitel 17. QGIS Verarbeitung Umgebung

KAPITEL 18

Processing providers and algorithms

18.1 GDAL algorithm provider


GDAL (Geospatial Data Abstraction Library) is a translator library for raster and vector geospatial data formats.
.

18.1.1 GDAL analysis


Perspektive
Beschreibung

<fgen Sie hier die bersetzung des Algorithmus ein>


Parameter

Eingabelayer [raster] <geben Sie hier die Parameterbeschreibung ein>


Kanalnummer [number] <geben Sie hier die Parameterbeschreibung ein>
Vorgabe: 1
Kanten berechnen [boolean] <geben Sie hier die Parameterbeschreibung ein>
Vorgabewert: False
Zevenbergen&&Thornesche (statt Hornsche) Formel verwenden [boolean] <geben Sie hier
die Parameterbeschreibung ein>
Vorgabewert: False
Trigonometrischen Winkel (statt Azimut) zurckgeben [boolean] <geben Sie hier die Parameterbeschreibung ein>
Vorgabewert: False
0 (statt -9999) fr Ebene zurckgeben [boolean] <geben Sie hier die Parameterbeschreibung
ein>
Vorgabewert: False

241

QGIS User Guide, Release 2.6

Ausgaben

Ausgaberaster [raster] <fgen Sie hier die bersetzung der Ausgabe ein>
Verwendung der Konsole

processing.runalg(gdalogr:aspect, input, band, compute_edges, zevenbergen, trig_angle, zero_flat

Siehe auch

Farbrelief
Beschreibung

<fgen Sie hier die bersetzung des Algorithmus ein>


Parameter

Eingabelayer [raster] <geben Sie hier die Parameterbeschreibung ein>


Kanalnummer [number] <geben Sie hier die Parameterbeschreibung ein>
Vorgabe: 1
Kanten berechnen [boolean] <geben Sie hier die Parameterbeschreibung ein>
Vorgabewert: False
Farbkonfigurationsdatei [file] <geben Sie hier die Parameterbeschreibung ein>
Zuordnungsmodus [selection] <geben Sie hier die Parameterbeschreibung ein>
Optionen:
0 0,0,0,0 RGBA
1 Exact color
2 Nearest color
Default: 0
Outputs

Output file [raster] <put output description here>


Console usage

processing.runalg(gdalogr:colorrelief, input, band, compute_edges, color_table, match_mode, outp

See also

Fill nodata
Description

<put algortithm description here>


242

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input layer [raster] <put parameter description here>


Search distance [number] <put parameter description here>
Default: 100
Smooth iterations [number] <put parameter description here>
Default: 0
Band to operate on [number] <put parameter description here>
Default: 1
Validity mask [raster] Optional.
<put parameter description here>
Do not use default validity mask [boolean] <put parameter description here>
Default: False
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:fillnodata, input, distance, iterations, band, mask, no_default_mask,

See also

Grid (Moving average)


Description

<put algortithm description here>


Parameters

Input layer [vector: point] <put parameter description here>


Z field [tablefield: numeric] Optional.
<put parameter description here>
Radius 1 [number] <put parameter description here>
Default: 0.0
Radius 2 [number] <put parameter description here>
Default: 0.0
Min points [number] <put parameter description here>
Default: 0.0
Angle [number] <put parameter description here>
Default: 0.0

18.1. GDAL algorithm provider

243

QGIS User Guide, Release 2.6

Nodata [number] <put parameter description here>


Default: 0.0
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32
10 CFloat64
Default: 5
Outputs

Output file [raster] <put output description here>


Console usage

processing.runalg(gdalogr:gridaverage, input, z_field, radius_1, radius_2, min_points, angle, no

See also

Grid (Data metrics)


Description

<put algortithm description here>


Parameters

Input layer [vector: point] <put parameter description here>


Z field [tablefield: numeric] Optional.
<put parameter description here>
Metrics [selection] <put parameter description here>
Options:
0 Minimum
1 Maximum
2 Range
244

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

3 Count
4 Average distance
5 Average distance between points
Default: 0
Radius 1 [number] <put parameter description here>
Default: 0.0
Radius 2 [number] <put parameter description here>
Default: 0.0
Min points [number] <put parameter description here>
Default: 0.0
Angle [number] <put parameter description here>
Default: 0.0
Nodata [number] <put parameter description here>
Default: 0.0
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32
10 CFloat64
Default: 5
Outputs

Output file [raster] <put output description here>


Console usage

processing.runalg(gdalogr:griddatametrics, input, z_field, metric, radius_1, radius_2, min_point

18.1. GDAL algorithm provider

245

QGIS User Guide, Release 2.6

See also

Grid (Inverse distance to a power)


Description

<put algortithm description here>


Parameters

Input layer [vector: point] <put parameter description here>


Z field [tablefield: numeric] Optional.
<put parameter description here>
Power [number] <put parameter description here>
Default: 2.0
Smothing [number] <put parameter description here>
Default: 0.0
Radius 1 [number] <put parameter description here>
Default: 0.0
Radius 2 [number] <put parameter description here>
Default: 0.0
Max points [number] <put parameter description here>
Default: 0.0
Min points [number] <put parameter description here>
Default: 0.0
Angle [number] <put parameter description here>
Default: 0.0
Nodata [number] <put parameter description here>
Default: 0.0
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32

246

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

10 CFloat64
Default: 5
Outputs

Output file [raster] <put output description here>


Console usage

processing.runalg(gdalogr:gridinvdist, input, z_field, power, smothing, radius_1, radius_2, max_

See also

Grid (Nearest neighbor)


Description

<put algortithm description here>


Parameters

Input layer [vector: point] <put parameter description here>


Z field [tablefield: numeric] Optional.
<put parameter description here>
Radius 1 [number] <put parameter description here>
Default: 0.0
Radius 2 [number] <put parameter description here>
Default: 0.0
Angle [number] <put parameter description here>
Default: 0.0
Nodata [number] <put parameter description here>
Default: 0.0
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
18.1. GDAL algorithm provider

247

QGIS User Guide, Release 2.6

9 CFloat32
10 CFloat64
Default: 5
Outputs

Output file [raster] <put output description here>


Console usage

processing.runalg(gdalogr:gridnearestneighbor, input, z_field, radius_1, radius_2, angle, nodata

See also

Hillshade
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Band number [number] <put parameter description here>
Default: 1
Compute edges [boolean] <put parameter description here>
Default: False
Use Zevenbergen&Thorne formula (instead of the Horns one) [boolean] <put parameter description here>
Default: False
Z factor (vertical exaggeration) [number] <put parameter description here>
Default: 1.0
Scale (ratio of vert. units to horiz.) [number] <put parameter description here>
Default: 1.0
Azimuth of the light [number] <put parameter description here>
Default: 315.0
Altitude of the light [number] <put parameter description here>
Default: 45.0
Outputs

Output file [raster] <put output description here>

248

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(gdalogr:hillshade, input, band, compute_edges, zevenbergen, z_factor, scale, a

See also

Near black
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


How far from black (white) [number] <put parameter description here>
Default: 15
Search for nearly white pixels instead of nearly black [boolean] <put parameter description here>
Default: False
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:nearblack, input, near, white, output)

See also

Proximity (raster distance)


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Values [string] <put parameter description here>
Default: (not set)
Dist units [selection] <put parameter description here>
Options:
0 GEO
1 PIXEL
18.1. GDAL algorithm provider

249

QGIS User Guide, Release 2.6

Default: 0
Max dist (negative value to ignore) [number] <put parameter description here>
Default: -1
No data (negative value to ignore) [number] <put parameter description here>
Default: -1
Fixed buf val (negative value to ignore) [number] <put parameter description here>
Default: -1
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32
10 CFloat64
Default: 5
Outputs

Output layer [raster] <put output description here>


Console usage

processing.runalg(gdalogr:proximity, input, values, units, max_dist, nodata, buf_val, rtype, out

See also

Roughness
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Band number [number] <put parameter description here>
Default: 1
250

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Compute edges [boolean] <put parameter description here>


Default: False
Outputs

Output file [raster] <put output description here>


Console usage
processing.runalg(gdalogr:roughness, input, band, compute_edges, output)

See also

Sieve
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Threshold [number] <put parameter description here>
Default: 2
Pixel connection [selection] <put parameter description here>
Options:
04
18
Default: 0
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:sieve, input, threshold, connections, output)

See also

Slope
Description

<put algortithm description here>

18.1. GDAL algorithm provider

251

QGIS User Guide, Release 2.6

Parameters

Input layer [raster] <put parameter description here>


Band number [number] <put parameter description here>
Default: 1
Compute edges [boolean] <put parameter description here>
Default: False
Use Zevenbergen&Thorne formula (instead of the Horns one) [boolean] <put parameter description here>
Default: False
Slope expressed as percent (instead of degrees) [boolean] <put
here>

parameter

description

Default: False
Scale (ratio of vert. units to horiz.) [number] <put parameter description here>
Default: 1.0
Outputs

Output file [raster] <put output description here>


Console usage

processing.runalg(gdalogr:slope, input, band, compute_edges, zevenbergen, as_percent, scale, out

See also

TPI (Topographic Position Index)


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Band number [number] <put parameter description here>
Default: 1
Compute edges [boolean] <put parameter description here>
Default: False
Outputs

Output file [raster] <put output description here>

252

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(gdalogr:tpitopographicpositionindex, input, band, compute_edges, output)

See also

TRI (Terrain Ruggedness Index)


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Band number [number] <put parameter description here>
Default: 1
Compute edges [boolean] <put parameter description here>
Default: False
Outputs

Output file [raster] <put output description here>


Console usage
processing.runalg(gdalogr:triterrainruggednessindex, input, band, compute_edges, output)

See also

18.1.2 GDAL conversion


gdal2xyz
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Band number [number] <put parameter description here>
Default: 1

18.1. GDAL algorithm provider

253

QGIS User Guide, Release 2.6

Outputs

Output file [table] <put output description here>


Console usage
processing.runalg(gdalogr:gdal2xyz, input, band, output)

See also

PCT to RGB
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Band to convert [selection] <put parameter description here>
Options:
01
12
23
34
45
56
67
78
89
9 10
10 11
11 12
12 13
13 14
14 15
15 16
16 17
17 18
18 19
19 20
20 21

254

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

21 22
22 23
23 24
24 25
Default: 0
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:pcttorgb, input, nband, output)

See also

Polygonize (raster to vector)


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Output field name [string] <put parameter description here>
Default: DN
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(gdalogr:polygonize, input, field, output)

See also

Rasterize (vector to raster)


Beschreibung

<put algortithm description here>

18.1. GDAL algorithm provider

255

QGIS User Guide, Release 2.6

Parameter

Input layer [vector: any] <put parameter description here>


Attribute field [tablefield: any] <put parameter description here>
Write values inside an existing raster layer(*) [boolean] <put
here>

parameter

description

Default: False
Set output raster size (ignored if above option is checked) [selection] <put
rameter description here>

pa-

Optionen:
0 Ausgabegre in Pixel
1 Output resolution in map units per pixel
Vorgabe: 1
Horizontal [Zahl] <put parameter description here>
Vorgabe: 100.0
Vertikal [Zahl] <put parameter description here>
Vorgabe: 100.0
Rastertyp [Auswahl] <put parameter description here>
Optionen:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32
10 CFloat64
Vorgabe: 0
Ausgaben

Output layer: mandatory to choose an existing raster layer if the (*) option is selected
<put output description here>
Console usage
processing.runalg(gdalogr:rasterize, input, field, writeover, dimensions, width, height, rtype,

256

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Siehe auch

RGB to PCT
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Number of colors [number] <put parameter description here>
Default: 2
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:rgbtopct, input, ncolors, output)

See also

Translate (convert format)


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Set the size of the output file (In pixels or %) [number] <put parameter description
here>
Default: 100
Output size is a percentage of input size [boolean] <put parameter description here>
Default: True
Nodata value, leave as none to take the nodata value from input [string] <put parameter description here>
Default: none
Expand [selection] <put parameter description here>
Options:
0 none
1 gray
2 rgb
18.1. GDAL algorithm provider

257

QGIS User Guide, Release 2.6

3 rgba
Default: 0
Output projection for output file [leave blank to use input projection] [crs]
<put parameter description here>
Default: None
Subset based on georeferenced coordinates [extent] <put parameter description here>
Default: 0,1,0,1
Copy all subdatasets of this file to individual output files [boolean] <put
parameter description here>
Default: False
Additional creation parameters [string] Optional.
<put parameter description here>
Default: (not set)
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32
10 CFloat64
Default: 5
Outputs

Output layer [raster] <put output description here>


Console usage

processing.runalg(gdalogr:translate, input, outsize, outsize_perc, no_data, expand, srs, projwin

See also

258

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

18.1.3 GDAL extraction


Clip raster by extent
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Nodata value, leave as none to take the nodata value from input [string] <put parameter description here>
Default: none
Clipping extent [extent] <put parameter description here>
Default: 0,1,0,1
Additional creation parameters [string] Optional.
<put parameter description here>
Default: (not set)
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:cliprasterbyextent, input, no_data, projwin, extra, output)

See also

Clip raster by mask layer


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Mask layer [vector: polygon] <put parameter description here>
Nodata value, leave as none to take the nodata value from input [string] <put parameter description here>
Default: none
Create and output alpha band [boolean] <put parameter description here>
Default: False

18.1. GDAL algorithm provider

259

QGIS User Guide, Release 2.6

Keep resolution of output raster [boolean] <put parameter description here>


Default: False
Additional creation parameters [string] Optional.
<put parameter description here>
Default: (not set)
Outputs

Output layer [raster] <put output description here>


Console usage

processing.runalg(gdalogr:cliprasterbymasklayer, input, mask, no_data, alpha_band, keep_resoluti

See also

Contour
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Interval between contour lines [number] <put parameter description here>
Default: 10.0
Attribute name (if not set, no elevation attribute is attached) [string]
Optional.
<put parameter description here>
Default: ELEV
Additional creation parameters [string] Optional.
<put parameter description here>
Default: (not set)
Outputs

Output file for contour lines (vector) [vector] <put output description here>
Console usage
processing.runalg(gdalogr:contour, input_raster, interval, field_name, extra, output_vector)

260

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

18.1.4 GDAL miscellaneous


Build Virtual Raster
Description

<put algortithm description here>


Parameters

Input layers [multipleinput: rasters] <put parameter description here>


Resolution [selection] <put parameter description here>
Options:
0 average
1 highest
2 lowest
Default: 0
Layer stack [boolean] <put parameter description here>
Default: True
Allow projection difference [boolean] <put parameter description here>
Default: False
Outputs

Output layer [raster] <put output description here>


Console usage

processing.runalg(gdalogr:buildvirtualraster, input, resolution, separate, proj_difference, outp

See also

Merge
Description

<put algortithm description here>

18.1. GDAL algorithm provider

261

QGIS User Guide, Release 2.6

Parameters

Input layers [multipleinput: rasters] <put parameter description here>


Grab pseudocolor table from first layer [boolean] <put parameter description here>
Default: False
Layer stack [boolean] <put parameter description here>
Default: False
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32
10 CFloat64
Default: 5
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:merge, input, pct, separate, rtype, output)

See also

Build overviews (pyramids)


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Overview levels [string] <put parameter description here>
Default: 2 4 8 16

262

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Remove all existing overviews [boolean] <put parameter description here>


Default: False
Resampling method [selection] <put parameter description here>
Options:
0 nearest
1 average
2 gauss
3 cubic
4 average_mp
5 average_magphase
6 mode
Default: 0
Overview format [selection] <put parameter description here>
Options:
0 Internal (if possible)
1 External (GTiff .ovr)
2 External (ERDAS Imagine .aux)
Default: 0
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:overviews, input, levels, clean, resampling_method, format)

See also

Information
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Suppress GCP info [boolean] <put parameter description here>
Default: False
Suppress metadata info [boolean] <put parameter description here>
Default: False

18.1. GDAL algorithm provider

263

QGIS User Guide, Release 2.6

Outputs

Layer information [html] <put output description here>


Console usage
processing.runalg(gdalorg:rasterinfo, input, nogcp, nometadata, output)

See also

18.1.5 GDAL projections


Extract projection
Description

<put algortithm description here>


Parameters

Input file [raster] <put parameter description here>


Create also .prj file [boolean] <put parameter description here>
Default: False
Outputs
Console usage
processing.runalg(gdalogr:extractprojection, input, prj_file)

See also

Warp (reproject)
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Source SRS (EPSG Code) [crs] <put parameter description here>
Default: EPSG:4326
Destination SRS (EPSG Code) [crs] <put parameter description here>
Default: EPSG:4326
264

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Output file resolution in target georeferenced units (leave 0 for no change) [number]
<put parameter description here>
Default: 0.0
Resampling method [selection] <put parameter description here>
Options:
0 near
1 bilinear
2 cubic
3 cubicspline
4 lanczos
Default: 0
Additional creation parameters [string] Optional.
<put parameter description here>
Default: (not set)
Output raster type [selection] <put parameter description here>
Options:
0 Byte
1 Int16
2 UInt16
3 UInt32
4 Int32
5 Float32
6 Float64
7 CInt16
8 CInt32
9 CFloat32
10 CFloat64
Default: 5
Outputs

Output layer [raster] <put output description here>


Console usage
processing.runalg(gdalogr:warpreproject, input, source_srs, dest_srs, tr, method, extra, rtype,

See also

18.1. GDAL algorithm provider

265

QGIS User Guide, Release 2.6

18.1.6 OGR conversion


Convert format
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Destination Format [selection] <put parameter description here>
Options:
0 ESRI Shapefile
1 GeoJSON
2 GeoRSS
3 SQLite
4 GMT
5 MapInfo File
6 INTERLIS 1
7 INTERLIS 2
8 GML
9 Geoconcept
10 DXF
11 DGN
12 CSV
13 BNA
14 S57
15 KML
16 GPX
17 PGDump
18 GPSTrackMaker
19 ODS
20 XLSX
21 PDF
Default: 0
Creation Options [string] Optional.
<put parameter description here>
Default: (not set)

266

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(gdalogr:convertformat, input_layer, format, options, output_layer)

See also

18.1.7 OGR geoprocessing


Clip vectors by extent
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Clip extent [extent] <put parameter description here>
Default: 0,1,0,1
Additional creation Options [string] Optional.
<put parameter description here>
Default: (not set)
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(gdalogr:clipvectorsbyextent, input_layer, clip_extent, options, output_layer)

See also

Clip vectors by polygon


Description

<put algortithm description here>

18.1. GDAL algorithm provider

267

QGIS User Guide, Release 2.6

Parameters

Input layer [vector: any] <put parameter description here>


Clip layer [vector: polygon] <put parameter description here>
Additional creation Options [string] Optional.
<put parameter description here>
Default: (not set)
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(gdalogr:clipvectorsbypolygon, input_layer, clip_layer, options, output_layer)

See also

18.1.8 OGR miscellaneous


Execute SQL
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


SQL [string] <put parameter description here>
Default: (not set)
Outputs

SQL result [vector] <put output description here>


Console usage
processing.runalg(gdalogr:executesql, input, sql, output)

268

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Import Vector into PostGIS database (available connections)


Description

<put algortithm description here>


Parameters

Database (connection name) [selection] <put parameter description here>


Options:
0 local
Default: 0
Input layer [vector: any] <put parameter description here>
Output geometry type [selection] <put parameter description here>
Options:
0
1 NONE
2 GEOMETRY
3 POINT
4 LINESTRING
5 POLYGON
6 GEOMETRYCOLLECTION
7 MULTIPOINT
8 MULTIPOLYGON
9 MULTILINESTRING
Default: 5
Input CRS (EPSG Code) [crs] <put parameter description here>
Default: EPSG:4326
Output CRS (EPSG Code) [crs] <put parameter description here>
Default: EPSG:4326
Schema name [string] Optional.
<put parameter description here>
Default: public
Table name, leave blank to use input name [string] Optional.
<put parameter description here>
Default: (not set)
Primary Key [string] Optional.
<put parameter description here>
Default: id

18.1. GDAL algorithm provider

269

QGIS User Guide, Release 2.6

Geometry column name [string] Optional.


<put parameter description here>
Default: geom
Vector dimensions [selection] <put parameter description here>
Options:
02
13
Default: 0
Distance tolerance for simplification [string] Optional.
<put parameter description here>
Default: (not set)
Maximum distance between 2 nodes (densification) [string] Optional.
<put parameter description here>
Default: (not set)
Select features by extent (defined in input layer CRS) [extent] <put parameter description here>
Default: 0,1,0,1
Clip the input layer using the above (rectangle) extent [boolean] <put parameter description here>
Default: False
Select features using a SQL "WHERE" statement (Ex: column="value") [string]
Optional.
<put parameter description here>
Default: (not set)
Group "n" features per transaction (Default: 20000) [string] Optional.
<put parameter description here>
Default: (not set)
Overwrite existing table? [boolean] <put parameter description here>
Default: True
Append to existing table? [boolean] <put parameter description here>
Default: False
Append and add new fields to existing table? [boolean] <put parameter description here>
Default: False
Do not launder columns/table name/s? [boolean] <put parameter description here>
Default: False
Do not create Spatial Index? [boolean] <put parameter description here>
Default: False
Continue after a failure, skipping the failed feature [boolean] <put parameter description here>
Default: False

270

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Additional creation options [string] Optional.


<put parameter description here>
Default: (not set)
Outputs
Console usage

processing.runalg(gdalogr:importvectorintopostgisdatabaseavailableconnections, database, input_l

See also

Import Vector into PostGIS database (new connection)


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Output geometry type [selection] <put parameter description here>
Options:
0
1 NONE
2 GEOMETRY
3 POINT
4 LINESTRING
5 POLYGON
6 GEOMETRYCOLLECTION
7 MULTIPOINT
8 MULTIPOLYGON
9 MULTILINESTRING
Default: 5
Input CRS (EPSG Code) [crs] <put parameter description here>
Default: EPSG:4326
Output CRS (EPSG Code) [crs] <put parameter description here>
Default: EPSG:4326
Host [string] <put parameter description here>
Default: localhost
Port [string] <put parameter description here>
Default: 5432

18.1. GDAL algorithm provider

271

QGIS User Guide, Release 2.6

Username [string] <put parameter description here>


Default: (not set)
Database Name [string] <put parameter description here>
Default: (not set)
Password [string] <put parameter description here>
Default: (not set)
Schema name [string] Optional.
<put parameter description here>
Default: public
Table name, leave blank to use input name [string] Optional.
<put parameter description here>
Default: (not set)
Primary Key [string] Optional.
<put parameter description here>
Default: id
Geometry column name [string] Optional.
<put parameter description here>
Default: geom
Vector dimensions [selection] <put parameter description here>
Options:
02
13
Default: 0
Distance tolerance for simplification [string] Optional.
<put parameter description here>
Default: (not set)
Maximum distance between 2 nodes (densification) [string] Optional.
<put parameter description here>
Default: (not set)
Select features by extent (defined in input layer CRS) [extent] <put parameter description here>
Default: 0,1,0,1
Clip the input layer using the above (rectangle) extent [boolean] <put parameter description here>
Default: False
Select features using a SQL "WHERE" statement (Ex: column="value") [string]
Optional.
<put parameter description here>
Default: (not set)

272

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Group "n" features per transaction (Default: 20000) [string] Optional.


<put parameter description here>
Default: (not set)
Overwrite existing table? [boolean] <put parameter description here>
Default: True
Append to existing table? [boolean] <put parameter description here>
Default: False
Append and add new fields to existing table? [boolean] <put parameter description here>
Default: False
Do not launder columns/table name/s? [boolean] <put parameter description here>
Default: False
Do not create Spatial Index? [boolean] <put parameter description here>
Default: False
Continue after a failure, skipping the failed feature [boolean] <put parameter description here>
Default: False
Additional creation options [string] Optional.
<put parameter description here>
Default: (not set)
Outputs
Console usage

processing.runalg(gdalogr:importvectorintopostgisdatabasenewconnection, input_layer, gtype, s_sr

See also

Information
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Outputs

Layer information [html] <put output description here>

18.1. GDAL algorithm provider

273

QGIS User Guide, Release 2.6

Console usage
processing.runalg(gdalogr:information, input, output)

See also

18.2 LAStools
LAStools is a collection of highly efficient, multicore command line tools for LiDAR data processing.

18.2.1 las2las_filter
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
filter (by return, classification, flags) [selection] <put parameter description here>
Options:
0
1 keep_last
2 keep_first
3 keep_middle
4 keep_single
5 drop_single
6 keep_double
7 keep_class 2
8 keep_class 2 8
9 keep_class 8
10 keep_class 6
11 keep_class 9
12 keep_class 3 4 5
13 keep_class 2 6
14 drop_class 7
15 drop_withheld

274

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Default: 0
second filter (by return, classification, flags) [selection] <put parameter description
here>
Options:
0
1 keep_last
2 keep_first
3 keep_middle
4 keep_single
5 drop_single
6 keep_double
7 keep_class 2
8 keep_class 2 8
9 keep_class 8
10 keep_class 6
11 keep_class 9
12 keep_class 3 4 5
13 keep_class 2 6
14 drop_class 7
15 drop_withheld
Default: 0
filter (by coordinate, intensity, GPS time, ...) [selection] <put parameter description
here>
Options:
0
1 clip_x_above
2 clip_x_below
3 clip_y_above
4 clip_y_below
5 clip_z_above
6 clip_z_below
7 drop_intensity_above
8 drop_intensity_below
9 drop_gps_time_above
10 drop_gps_time_below
11 drop_scan_angle_above
12 drop_scan_angle_below
13 keep_point_source
14 drop_point_source
15 drop_point_source_above
18.2. LAStools

275

QGIS User Guide, Release 2.6

16 drop_point_source_below
17 keep_user_data
18 drop_user_data
19 drop_user_data_above
20 drop_user_data_below
21 keep_every_nth
22 keep_random_fraction
23 thin_with_grid
Default: 0
value for filter (by coordinate, intensity, GPS time, ...) [string] <put parameter
description here>
Default: (not set)
second filter (by coordinate, intensity, GPS time, ...) [selection] <put
description here>

parameter

Options:
0
1 clip_x_above
2 clip_x_below
3 clip_y_above
4 clip_y_below
5 clip_z_above
6 clip_z_below
7 drop_intensity_above
8 drop_intensity_below
9 drop_gps_time_above
10 drop_gps_time_below
11 drop_scan_angle_above
12 drop_scan_angle_below
13 keep_point_source
14 drop_point_source
15 drop_point_source_above
16 drop_point_source_below
17 keep_user_data
18 drop_user_data
19 drop_user_data_above
20 drop_user_data_below
21 keep_every_nth
22 keep_random_fraction
23 thin_with_grid
Default: 0
276

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

value for second filter (by coordinate, intensity, GPS time, ...) [string] <put
parameter description here>
Default: (not set)
Outputs
output LAS/LAZ file [file] <put output description here>
Console usage

processing.runalg(lidartools:las2lasfilter, verbose, input_laslaz, filter_return_class_flags1, f

See also

18.2.2 las2las_project
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
source projection [selection] <put parameter description here>
Options:
0
1 utm
2 sp83
3 sp27
4 longlat
5 latlong
Default: 0
source utm zone [selection] <put parameter description here>
Options:
0
1 1 (north)
2 2 (north)
3 3 (north)
4 4 (north)
5 5 (north)
6 6 (north)
18.2. LAStools

277

QGIS User Guide, Release 2.6

7 7 (north)
8 8 (north)
9 9 (north)
10 10 (north)
11 11 (north)
12 12 (north)
13 13 (north)
14 14 (north)
15 15 (north)
16 16 (north)
17 17 (north)
18 18 (north)
19 19 (north)
20 20 (north)
21 21 (north)
22 22 (north)
23 23 (north)
24 24 (north)
25 25 (north)
26 26 (north)
27 27 (north)
28 28 (north)
29 29 (north)
30 30 (north)
31 31 (north)
32 32 (north)
33 33 (north)
34 34 (north)
35 35 (north)
36 36 (north)
37 37 (north)
38 38 (north)
39 39 (north)
40 40 (north)
41 41 (north)
42 42 (north)
43 43 (north)
44 44 (north)
45 45 (north)

278

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

46 46 (north)
47 47 (north)
48 48 (north)
49 49 (north)
50 50 (north)
51 51 (north)
52 52 (north)
53 53 (north)
54 54 (north)
55 55 (north)
56 56 (north)
57 57 (north)
58 58 (north)
59 59 (north)
60 60 (north)
61 1 (south)
62 2 (south)
63 3 (south)
64 4 (south)
65 5 (south)
66 6 (south)
67 7 (south)
68 8 (south)
69 9 (south)
70 10 (south)
71 11 (south)
72 12 (south)
73 13 (south)
74 14 (south)
75 15 (south)
76 16 (south)
77 17 (south)
78 18 (south)
79 19 (south)
80 20 (south)
81 21 (south)
82 22 (south)
83 23 (south)
84 24 (south)

18.2. LAStools

279

QGIS User Guide, Release 2.6

85 25 (south)
86 26 (south)
87 27 (south)
88 28 (south)
89 29 (south)
90 30 (south)
91 31 (south)
92 32 (south)
93 33 (south)
94 34 (south)
95 35 (south)
96 36 (south)
97 37 (south)
98 38 (south)
99 39 (south)
100 40 (south)
101 41 (south)
102 42 (south)
103 43 (south)
104 44 (south)
105 45 (south)
106 46 (south)
107 47 (south)
108 48 (south)
109 49 (south)
110 50 (south)
111 51 (south)
112 52 (south)
113 53 (south)
114 54 (south)
115 55 (south)
116 56 (south)
117 57 (south)
118 58 (south)
119 59 (south)
120 60 (south)
Default: 0
source state plane code [selection] <put parameter description here>
Options:

280

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

0
1 AK_10
2 AK_2
3 AK_3
4 AK_4
5 AK_5
6 AK_6
7 AK_7
8 AK_8
9 AK_9
10 AL_E
11 AL_W
12 AR_N
13 AR_S
14 AZ_C
15 AZ_E
16 AZ_W
17 CA_I
18 CA_II
19 CA_III
20 CA_IV
21 CA_V
22 CA_VI
23 CA_VII
24 CO_C
25 CO_N
26 CO_S
27 CT
28 DE
29 FL_E
30 FL_N
31 FL_W
32 GA_E
33 GA_W
34 HI_1
35 HI_2
36 HI_3
37 HI_4
38 HI_5

18.2. LAStools

281

QGIS User Guide, Release 2.6

39 IA_N
40 IA_S
41 ID_C
42 ID_E
43 ID_W
44 IL_E
45 IL_W
46 IN_E
47 IN_W
48 KS_N
49 KS_S
50 KY_N
51 KY_S
52 LA_N
53 LA_S
54 MA_I
55 MA_M
56 MD
57 ME_E
58 ME_W
59 MI_C
60 MI_N
61 MI_S
62 MN_C
63 MN_N
64 MN_S
65 MO_C
66 MO_E
67 MO_W
68 MS_E
69 MS_W
70 MT_C
71 MT_N
72 MT_S
73 NC
74 ND_N
75 ND_S
76 NE_N
77 NE_S

282

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

78 NH
79 NJ
80 NM_C
81 NM_E
82 NM_W
83 NV_C
84 NV_E
85 NV_W
86 NY_C
87 NY_E
88 NY_LI
89 NY_W
90 OH_N
91 OH_S
92 OK_N
93 OK_S
94 OR_N
95 OR_S
96 PA_N
97 PA_S
98 PR
99 RI
100 SC_N
101 SC_S
102 SD_N
103 SD_S
104 St.Croix
105 TN
106 TX_C
107 TX_N
108 TX_NC
109 TX_S
110 TX_SC
111 UT_C
112 UT_N
113 UT_S
114 VA_N
115 VA_S
116 VT

18.2. LAStools

283

QGIS User Guide, Release 2.6

117 WA_N
118 WA_S
119 WI_C
120 WI_N
121 WI_S
122 WV_N
123 WV_S
124 WY_E
125 WY_EC
126 WY_W
127 WY_WC
Default: 0
target projection [selection] <put parameter description here>
Options:
0
1 utm
2 sp83
3 sp27
4 longlat
5 latlong
Default: 0
target utm zone [selection] <put parameter description here>
Options:
0
1 1 (north)
2 2 (north)
3 3 (north)
4 4 (north)
5 5 (north)
6 6 (north)
7 7 (north)
8 8 (north)
9 9 (north)
10 10 (north)
11 11 (north)
12 12 (north)
13 13 (north)
14 14 (north)
15 15 (north)

284

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

16 16 (north)
17 17 (north)
18 18 (north)
19 19 (north)
20 20 (north)
21 21 (north)
22 22 (north)
23 23 (north)
24 24 (north)
25 25 (north)
26 26 (north)
27 27 (north)
28 28 (north)
29 29 (north)
30 30 (north)
31 31 (north)
32 32 (north)
33 33 (north)
34 34 (north)
35 35 (north)
36 36 (north)
37 37 (north)
38 38 (north)
39 39 (north)
40 40 (north)
41 41 (north)
42 42 (north)
43 43 (north)
44 44 (north)
45 45 (north)
46 46 (north)
47 47 (north)
48 48 (north)
49 49 (north)
50 50 (north)
51 51 (north)
52 52 (north)
53 53 (north)
54 54 (north)

18.2. LAStools

285

QGIS User Guide, Release 2.6

55 55 (north)
56 56 (north)
57 57 (north)
58 58 (north)
59 59 (north)
60 60 (north)
61 1 (south)
62 2 (south)
63 3 (south)
64 4 (south)
65 5 (south)
66 6 (south)
67 7 (south)
68 8 (south)
69 9 (south)
70 10 (south)
71 11 (south)
72 12 (south)
73 13 (south)
74 14 (south)
75 15 (south)
76 16 (south)
77 17 (south)
78 18 (south)
79 19 (south)
80 20 (south)
81 21 (south)
82 22 (south)
83 23 (south)
84 24 (south)
85 25 (south)
86 26 (south)
87 27 (south)
88 28 (south)
89 29 (south)
90 30 (south)
91 31 (south)
92 32 (south)
93 33 (south)

286

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

94 34 (south)
95 35 (south)
96 36 (south)
97 37 (south)
98 38 (south)
99 39 (south)
100 40 (south)
101 41 (south)
102 42 (south)
103 43 (south)
104 44 (south)
105 45 (south)
106 46 (south)
107 47 (south)
108 48 (south)
109 49 (south)
110 50 (south)
111 51 (south)
112 52 (south)
113 53 (south)
114 54 (south)
115 55 (south)
116 56 (south)
117 57 (south)
118 58 (south)
119 59 (south)
120 60 (south)
Default: 0
target state plane code [selection] <put parameter description here>
Options:
0
1 AK_10
2 AK_2
3 AK_3
4 AK_4
5 AK_5
6 AK_6
7 AK_7
8 AK_8

18.2. LAStools

287

QGIS User Guide, Release 2.6

9 AK_9
10 AL_E
11 AL_W
12 AR_N
13 AR_S
14 AZ_C
15 AZ_E
16 AZ_W
17 CA_I
18 CA_II
19 CA_III
20 CA_IV
21 CA_V
22 CA_VI
23 CA_VII
24 CO_C
25 CO_N
26 CO_S
27 CT
28 DE
29 FL_E
30 FL_N
31 FL_W
32 GA_E
33 GA_W
34 HI_1
35 HI_2
36 HI_3
37 HI_4
38 HI_5
39 IA_N
40 IA_S
41 ID_C
42 ID_E
43 ID_W
44 IL_E
45 IL_W
46 IN_E
47 IN_W

288

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

48 KS_N
49 KS_S
50 KY_N
51 KY_S
52 LA_N
53 LA_S
54 MA_I
55 MA_M
56 MD
57 ME_E
58 ME_W
59 MI_C
60 MI_N
61 MI_S
62 MN_C
63 MN_N
64 MN_S
65 MO_C
66 MO_E
67 MO_W
68 MS_E
69 MS_W
70 MT_C
71 MT_N
72 MT_S
73 NC
74 ND_N
75 ND_S
76 NE_N
77 NE_S
78 NH
79 NJ
80 NM_C
81 NM_E
82 NM_W
83 NV_C
84 NV_E
85 NV_W
86 NY_C

18.2. LAStools

289

QGIS User Guide, Release 2.6

87 NY_E
88 NY_LI
89 NY_W
90 OH_N
91 OH_S
92 OK_N
93 OK_S
94 OR_N
95 OR_S
96 PA_N
97 PA_S
98 PR
99 RI
100 SC_N
101 SC_S
102 SD_N
103 SD_S
104 St.Croix
105 TN
106 TX_C
107 TX_N
108 TX_NC
109 TX_S
110 TX_SC
111 UT_C
112 UT_N
113 UT_S
114 VA_N
115 VA_S
116 VT
117 WA_N
118 WA_S
119 WI_C
120 WI_N
121 WI_S
122 WV_N
123 WV_S
124 WY_E
125 WY_EC

290

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

126 WY_W
127 WY_WC
Default: 0
Outputs
output LAS/LAZ file [file] <put output description here>
Console usage

processing.runalg(lidartools:las2lasproject, verbose, input_laslaz, source_projection, source_ut

See also

18.2.3 las2las_transform
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
transform (coordinates) [selection] <put parameter description here>
Options:
0
1 translate_x
2 translate_y
3 translate_z
4 scale_x
5 scale_y
6 scale_z
7 clamp_z_above
8 clamp_z_below
Default: 0
value for transform (coordinates) [string] <put parameter description here>
Default: (not set)
second transform (coordinates) [selection] <put parameter description here>
Options:
0

18.2. LAStools

291

QGIS User Guide, Release 2.6

1 translate_x
2 translate_y
3 translate_z
4 scale_x
5 scale_y
6 scale_z
7 clamp_z_above
8 clamp_z_below
Default: 0
value for second transform (coordinates) [string] <put parameter description here>
Default: (not set)
transform (intensities, scan angles, GPS times, ...) [selection] <put parameter description here>
Options:
0
1 scale_intensity
2 translate_intensity
3 clamp_intensity_above
4 clamp_intensity_below
5 scale_scan_angle
6 translate_scan_angle
7 translate_gps_time
8 set_classification
9 set_user_data
10 set_point_source
11 scale_rgb_up
12 scale_rgb_down
13 repair_zero_returns
Default: 0
value for transform (intensities, scan angles, GPS times, ...) [string] <put
parameter description here>
Default: (not set)
second transform (intensities, scan angles, GPS times, ...) [selection] <put
rameter description here>

pa-

Options:
0
1 scale_intensity
2 translate_intensity
3 clamp_intensity_above
4 clamp_intensity_below

292

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

5 scale_scan_angle
6 translate_scan_angle
7 translate_gps_time
8 set_classification
9 set_user_data
10 set_point_source
11 scale_rgb_up
12 scale_rgb_down
13 repair_zero_returns
Default: 0
value for second transform (intensities, scan angles, GPS times, ...) [string]
<put parameter description here>
Default: (not set)
operations (first 7 need an argument) [selection] <put parameter description here>
Options:
0
1 set_point_type
2 set_point_size
3 set_version_minor
4 set_version_major
5 start_at_point
6 stop_at_point
7 remove_vlr
8 auto_reoffset
9 week_to_adjusted
10 adjusted_to_week
11 scale_rgb_up
12 scale_rgb_down
13 remove_all_vlrs
14 remove_extra
15 clip_to_bounding_box
Default: 0
argument for operation [string] <put parameter description here>
Default: (not set)
Outputs
output LAS/LAZ file [file] <put output description here>

18.2. LAStools

293

QGIS User Guide, Release 2.6

Console usage

processing.runalg(lidartools:las2lastransform, verbose, input_laslaz, transform_coordinate1, tra

See also

18.2.4 las2txt
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
parse_string [string] <put parameter description here>
Default: xyz
Outputs
Output ASCII file [file] <put output description here>
Console usage
processing.runalg(lidartools:las2txt, verbose, input_laslaz, parse_string, output)

See also

18.2.5 lasindex
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
is mobile or terrestrial LiDAR (not airborne) [boolean] <put parameter description here>
Default: False

294

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs
Console usage
processing.runalg(lidartools:lasindex, verbose, input_laslaz, mobile_or_terrestrial)

See also

18.2.6 lasinfo
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
Outputs
Output ASCII file [file] <put output description here>
Console usage
processing.runalg(lidartools:lasinfo, verbose, input_laslaz, output)

See also

18.2.7 lasmerge
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
files are flightlines [boolean] <put parameter description here>
Default: True
input LAS/LAZ file [file] Optional.
<put parameter description here>
2nd file [file] Optional.
<put parameter description here>

18.2. LAStools

295

QGIS User Guide, Release 2.6

3rd file [file] Optional.


<put parameter description here>
4th file [file] Optional.
<put parameter description here>
5th file [file] Optional.
<put parameter description here>
6th file [file] Optional.
<put parameter description here>
7th file [file] Optional.
<put parameter description here>
Outputs
output LAS/LAZ file [file] <put output description here>
Console usage

processing.runalg(lidartools:lasmerge, verbose, files_are_flightlines, input_laslaz, file2, file

See also

18.2.8 lasprecision
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
Outputs
Output ASCII file [file] <put output description here>
Console usage
processing.runalg(lidartools:lasprecision, verbose, input_laslaz, output)

296

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

18.2.9 lasquery
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
area of interest [extent] <put parameter description here>
Default: 0,1,0,1
Outputs
Console usage
processing.runalg(lidartools:lasquery, verbose, aoi)

See also

18.2.10 lasvalidate
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
Outputs
Output XML file [file] <put output description here>
Console usage
processing.runalg(lidartools:lasvalidate, verbose, input_laslaz, output)

18.2. LAStools

297

QGIS User Guide, Release 2.6

See also

18.2.11 laszip
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
input LAS/LAZ file [file] Optional.
<put parameter description here>
only report size [boolean] <put parameter description here>
Default: False
Outputs
output LAS/LAZ file [file] <put output description here>
Console usage
processing.runalg(lidartools:laszip, verbose, input_laslaz, report_size, output_laslaz)

See also

18.2.12 txt2las
Description
<put algortithm description here>
Parameters
verbose [boolean] <put parameter description here>
Default: False
Input ASCII file [file] Optional.
<put parameter description here>
parse lines as [string] <put parameter description here>
Default: xyz
skip the first n lines [number] <put parameter description here>
Default: 0
resolution of x and y coordinate [number] <put parameter description here>
Default: 0.01

298

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

resolution of z coordinate [number] <put parameter description here>


Default: 0.01
Outputs
output LAS/LAZ file [file] <put output description here>
Console usage

processing.runalg(lidartools:txt2las, verbose, input, parse_string, skip, scale_factor_xy, scale

See also
.

18.3 Modeler Tools


18.3.1 Calculator
Description
<put algortithm description here>
Parameters
Formula [string] <put parameter description here>
Default: (not set)
dummy [number] <put parameter description here>
Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0

18.3. Modeler Tools

299

QGIS User Guide, Release 2.6

dummy [number] <put parameter description here>


Default: 0.0
dummy [number] <put parameter description here>
Default: 0.0
Outputs
Result [number] <put output description here>
Console usage

processing.runalg(modelertools:calculator, formula, number0, number1, number2, number3, number4,

See also

18.3.2 Raster layer bounds


Description
<put algortithm description here>
Parameters
Layer [raster] <put parameter description here>
Outputs
min X [number] <put output description here>
max X [number] <put output description here>
min Y [number] <put output description here>
max Y [number] <put output description here>
Extent [extent] <put output description here>
Console usage
processing.runalg(modelertools:rasterlayerbounds, layer)

See also

18.3.3 Vector layer bounds


Description
<put algortithm description here>
Parameters
Layer [vector: any] <put parameter description here>
300

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs
min X [number] <put output description here>
max X [number] <put output description here>
min Y [number] <put output description here>
max Y [number] <put output description here>
Extent [extent] <put output description here>
Console usage
processing.runalg(modelertools:vectorlayerbounds, layer)

See also
.

18.4 OrfeoToolbox algorithm provider


Orfeo ToolBox (OTB) is an open source library of image processing algorithms. OTB is based on the medical
image processing library ITK and offers particular functionalities for remote sensing image processing in general and for high spatial resolution images in particular. Targeted algorithms for high resolution optical images
(Pleiades, SPOT, QuickBird, WorldView, Landsat, Ikonos), hyperspectral sensors (Hyperion) or SAR (TerraSarX,
ERS, Palsar) are available.
Bemerkung: Please remember that Processing contains only the interface description, so you need to install OTB
by yourself and configure Processing properly.
.

18.4.1 Calibration
Optical calibration
Description

<put algortithm description here>


Parameters

Input [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Calibration Level [selection] <put parameter description here>
Options:
0 toa
Default: 0

18.4. OrfeoToolbox algorithm provider

301

QGIS User Guide, Release 2.6

Convert to milli reflectance [boolean] <put parameter description here>


Default: True
Clamp of reflectivity values between [0, 100] [boolean] <put parameter description here>
Default: True
Relative Spectral Response File [file] Optional.
<put parameter description here>
Outputs

Output [raster] <put output description here>


Console usage
processing.runalg(otb:opticalcalibration, -in, -ram, -level, -milli, -clamp, -rsr, -out)

See also

18.4.2 Feature extrcation


BinaryMorphologicalOperation (closing)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5
Morphological Operation [selection] <put parameter description here>
Options:
0 closing
Default: 0
302

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Feature Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:binarymorphologicaloperationclosing, -in, -channel, -ram, -structype, -str

See also

BinaryMorphologicalOperation (dilate)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5
Morphological Operation [selection] <put parameter description here>
Options:
0 dilate
Default: 0
Foreground Value [number] <put parameter description here>
Default: 1
Background Value [number] <put parameter description here>
Default: 0
Outputs

Feature Output Image [raster] <put output description here>

18.4. OrfeoToolbox algorithm provider

303

QGIS User Guide, Release 2.6

Console usage

processing.runalg(otb:binarymorphologicaloperationdilate, -in, -channel, -ram, -structype, -stru

See also

BinaryMorphologicalOperation (erode)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5
Morphological Operation [selection] <put parameter description here>
Options:
0 erode
Default: 0
Outputs

Feature Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:binarymorphologicaloperationerode, -in, -channel, -ram, -structype, -struc

See also

BinaryMorphologicalOperation (opening)
Description

<put algortithm description here>


304

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5
Morphological Operation [selection] <put parameter description here>
Options:
0 opening
Default: 0
Outputs

Feature Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:binarymorphologicaloperationopening, -in, -channel, -ram, -structype, -str

See also

EdgeExtraction (gradient)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Edge feature [selection] <put parameter description here>
Options:

18.4. OrfeoToolbox algorithm provider

305

QGIS User Guide, Release 2.6

0 gradient
Default: 0
Outputs

Feature Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:edgeextractiongradient, -in, -channel, -ram, -filter, -out)

See also

EdgeExtraction (sobel)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Edge feature [selection] <put parameter description here>
Options:
0 sobel
Default: 0
Outputs

Feature Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:edgeextractionsobel, -in, -channel, -ram, -filter, -out)

See also

EdgeExtraction (touzi)
Description

<put algortithm description here>


306

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Edge feature [selection] <put parameter description here>
Options:
0 touzi
Default: 0
The Radius [number] <put parameter description here>
Default: 1
Outputs

Feature Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:edgeextractiontouzi, -in, -channel, -ram, -filter, -filter.touzi.xradius,

See also

GrayScaleMorphologicalOperation (closing)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5

18.4. OrfeoToolbox algorithm provider

307

QGIS User Guide, Release 2.6

Morphological Operation [selection] <put parameter description here>


Options:
0 closing
Default: 0
Outputs

Feature Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:grayscalemorphologicaloperationclosing, -in, -channel, -ram, -structype, -

See also

GrayScaleMorphologicalOperation (dilate)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5
Morphological Operation [selection] <put parameter description here>
Options:
0 dilate
Default: 0
Outputs

Feature Output Image [raster] <put output description here>

308

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(otb:grayscalemorphologicaloperationdilate, -in, -channel, -ram, -structype, -s

See also

GrayScaleMorphologicalOperation (erode)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5
Morphological Operation [selection] <put parameter description here>
Options:
0 erode
Default: 0
Outputs

Feature Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:grayscalemorphologicaloperationerode, -in, -channel, -ram, -structype, -st

See also

GrayScaleMorphologicalOperation (opening)
Description

<put algortithm description here>


18.4. OrfeoToolbox algorithm provider

309

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Structuring Element Type [selection] <put parameter description here>
Options:
0 ball
Default: 0
The Structuring Element Radius [number] <put parameter description here>
Default: 5
Morphological Operation [selection] <put parameter description here>
Options:
0 opening
Default: 0
Outputs

Feature Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:grayscalemorphologicaloperationopening, -in, -channel, -ram, -structype, -

See also

Haralick Texture Extraction


Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
X Radius [number] <put parameter description here>
Default: 2

310

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Y Radius [number] <put parameter description here>


Default: 2
X Offset [number] <put parameter description here>
Default: 1
Y Offset [number] <put parameter description here>
Default: 1
Image Minimum [number] <put parameter description here>
Default: 0
Image Maximum [number] <put parameter description here>
Default: 255
Histogram number of bin [number] <put parameter description here>
Default: 8
Texture Set Selection [selection] <put parameter description here>
Options:
0 simple
1 advanced
2 higher
Default: 0
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:haralicktextureextraction, -in, -channel, -ram, -parameters.xrad, -paramet

See also

Line segment detection


Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


No rescaling in [0, 255] [boolean] <put parameter description here>
Default: True

18.4. OrfeoToolbox algorithm provider

311

QGIS User Guide, Release 2.6

Outputs

Output Detected lines [vector] <put output description here>


Console usage
processing.runalg(otb:linesegmentdetection, -in, -norescale, -out)

See also

Local Statistic Extraction


Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Selected Channel [number] <put parameter description here>
Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Neighborhood radius [number] <put parameter description here>
Default: 3
Outputs

Feature Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:localstatisticextraction, -in, -channel, -ram, -radius, -out)

See also

Multivariate alteration detector


Description

<put algortithm description here>

312

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input Image 1 [raster] <put parameter description here>


Input Image 2 [raster] <put parameter description here>
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Change Map [raster] <put output description here>


Console usage
processing.runalg(otb:multivariatealterationdetector, -in1, -in2, -ram, -out)

See also

Radiometric Indices
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Blue Channel [number] <put parameter description here>
Default: 1
Green Channel [number] <put parameter description here>
Default: 1
Red Channel [number] <put parameter description here>
Default: 1
NIR Channel [number] <put parameter description here>
Default: 1
Mir Channel [number] <put parameter description here>
Default: 1
Available Radiometric Indices [selection] <put parameter description here>
Options:
0 ndvi
1 tndvi
2 rvi

18.4. OrfeoToolbox algorithm provider

313

QGIS User Guide, Release 2.6

3 savi
4 tsavi
5 msavi
6 msavi2
7 gemi
8 ipvi
9 ndwi
10 ndwi2
11 mndwi
12 ndpi
13 ndti
14 ri
15 ci
16 bi
17 bi2
Default: 0
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:radiometricindices, -in, -ram, -channels.blue, -channels.green, -channels.

See also

18.4.3 Geometry
Image Envelope
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Sampling Rate [number] <put parameter description here>
Default: 0

314

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Projection [string] Optional.


<put parameter description here>
Default: None
Outputs

Output Vector Data [vector] <put output description here>


Console usage
processing.runalg(otb:imageenvelope, -in, -sr, -proj, -out)

See also

OrthoRectification (epsg)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Output Cartographic Map Projection [selection] <put parameter description here>
Options:
0 epsg
Default: 0
EPSG Code [number] <put parameter description here>
Default: 4326
Parameters estimation modes [selection] <put parameter description here>
Options:
0 autosize
1 autospacing
Default: 0
Default pixel value [number] <put parameter description here>
Default: 0
Default elevation [number] <put parameter description here>
Default: 0
Interpolation [selection] <put parameter description here>
Options:
0 bco
1 nn
2 linear
18.4. OrfeoToolbox algorithm provider

315

QGIS User Guide, Release 2.6

Default: 0
Radius for bicubic interpolation [number] <put parameter description here>
Default: 2
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Resampling grid spacing [number] <put parameter description here>
Default: 4
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:orthorectificationepsg, -io.in, -map, -map.epsg.code, -outputs.mode, -outp

See also

OrthoRectification (fit-to-ortho)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Parameters estimation modes [selection] <put parameter description here>
Options:
0 orthofit
Default: 0
Model ortho-image [raster] Optional.
<put parameter description here>
Default pixel value [number] <put parameter description here>
Default: 0
Default elevation [number] <put parameter description here>
Default: 0
Interpolation [selection] <put parameter description here>
Options:
0 bco
1 nn
2 linear
Default: 0
316

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Radius for bicubic interpolation [number] <put parameter description here>


Default: 2
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Resampling grid spacing [number] <put parameter description here>
Default: 4
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:orthorectificationfittoortho, -io.in, -outputs.mode, -outputs.ortho, -outp

See also

OrthoRectification (lambert-WGS84)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Output Cartographic Map Projection [selection] <put parameter description here>
Options:
0 lambert2
1 lambert93
2 wgs
Default: 0
Parameters estimation modes [selection] <put parameter description here>
Options:
0 autosize
1 autospacing
Default: 0
Default pixel value [number] <put parameter description here>
Default: 0
Default elevation [number] <put parameter description here>
Default: 0
Interpolation [selection] <put parameter description here>
Options:
18.4. OrfeoToolbox algorithm provider

317

QGIS User Guide, Release 2.6

0 bco
1 nn
2 linear
Default: 0
Radius for bicubic interpolation [number] <put parameter description here>
Default: 2
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Resampling grid spacing [number] <put parameter description here>
Default: 4
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:orthorectificationlambertwgs84, -io.in, -map, -outputs.mode, -outputs.defa

See also

OrthoRectification (utm)
Beschreibung

<put algortithm description here>


Parameter

Input Image [raster] <put parameter description here>


Output Cartographic Map Projection [selection] <put parameter description here>
Optionen:
0 utm
Vorgabe: 0
Zonennummer [Nummer] <put parameter description here>
Vorgabe: 31
Northern Hemisphere [boolean] <put parameter description here>
Default: True
Parameters estimation modes [selection] <put parameter description here>
Optionen:
0 autosize
1 autospacing
Vorgabe: 0
318

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Default pixel value [number] <put parameter description here>


Vorgabe: 0
Default elevation [number] <put parameter description here>
Vorgabe: 0
Interpolation [Auswahl] <put parameter description here>
Optionen:
0 bco
1 nn
2 linear
Vorgabe: 0
Radius for bicubic interpolation [number] <put parameter description here>
Vorgabe: 2
Available RAM (Mb) [number] <put parameter description here>
Vorgabe: 128
Resampling grid spacing [number] <put parameter description here>
Vorgabe: 4
Ausgaben

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:orthorectificationutm, -io.in, -map, -map.utm.zone, -map.utm.northhem, -ou

Siehe auch

Pansharpening (bayes)
Description

<put algortithm description here>


Parameters

Input PAN Image [raster] <put parameter description here>


Input XS Image [raster] <put parameter description here>
Algorithm [selection] <put parameter description here>
Options:
0 bayes
Default: 0
Weight [number] <put parameter description here>
Default: 0.9999
18.4. OrfeoToolbox algorithm provider

319

QGIS User Guide, Release 2.6

S coefficient [number] <put parameter description here>


Default: 1
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output image [raster] <put output description here>


Console usage

processing.runalg(otb:pansharpeningbayes, -inp, -inxs, -method, -method.bayes.lambda, -method.ba

See also

Pansharpening (lmvm)
Description

<put algortithm description here>


Parameters

Input PAN Image [raster] <put parameter description here>


Input XS Image [raster] <put parameter description here>
Algorithm [selection] <put parameter description here>
Options:
0 lmvm
Default: 0
X radius [number] <put parameter description here>
Default: 3
Y radius [number] <put parameter description here>
Default: 3
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output image [raster] <put output description here>


Console usage

processing.runalg(otb:pansharpeninglmvm, -inp, -inxs, -method, -method.lmvm.radiusx, -method.lmv

320

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Pansharpening (rcs)
Description

<put algortithm description here>


Parameters

Input PAN Image [raster] <put parameter description here>


Input XS Image [raster] <put parameter description here>
Algorithm [selection] <put parameter description here>
Options:
0 rcs
Default: 0
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output image [raster] <put output description here>


Console usage
processing.runalg(otb:pansharpeningrcs, -inp, -inxs, -method, -ram, -out)

See also

RigidTransformResample (id)
Description

<put algortithm description here>


Parameters

Input image [raster] <put parameter description here>


Type of transformation [selection] <put parameter description here>
Options:
0 id
Default: 0
X scaling [number] <put parameter description here>
Default: 1

18.4. OrfeoToolbox algorithm provider

321

QGIS User Guide, Release 2.6

Y scaling [number] <put parameter description here>


Default: 1
Interpolation [selection] <put parameter description here>
Options:
0 nn
1 linear
2 bco
Default: 2
Radius for bicubic interpolation [number] <put parameter description here>
Default: 2
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output image [raster] <put output description here>


Console usage

processing.runalg(otb:rigidtransformresampleid, -in, -transform.type, -transform.type.id.scalex,

See also

RigidTransformResample (rotation)
Description

<put algortithm description here>


Parameters

Input image [raster] <put parameter description here>


Type of transformation [selection] <put parameter description here>
Options:
0 rotation
Default: 0
Rotation angle [number] <put parameter description here>
Default: 0
X scaling [number] <put parameter description here>
Default: 1
Y scaling [number] <put parameter description here>
Default: 1

322

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Interpolation [selection] <put parameter description here>


Options:
0 nn
1 linear
2 bco
Default: 2
Radius for bicubic interpolation [number] <put parameter description here>
Default: 2
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output image [raster] <put output description here>


Console usage

processing.runalg(otb:rigidtransformresamplerotation, -in, -transform.type, -transform.type.rota

See also

RigidTransformResample (translation)
Description

<put algortithm description here>


Parameters

Input image [raster] <put parameter description here>


Type of transformation [selection] <put parameter description here>
Options:
0 translation
Default: 0
The X translation (in physical units) [number] <put parameter description here>
Default: 0
The Y translation (in physical units) [number] <put parameter description here>
Default: 0
X scaling [number] <put parameter description here>
Default: 1
Y scaling [number] <put parameter description here>
Default: 1

18.4. OrfeoToolbox algorithm provider

323

QGIS User Guide, Release 2.6

Interpolation [selection] <put parameter description here>


Options:
0 nn
1 linear
2 bco
Default: 2
Radius for bicubic interpolation [number] <put parameter description here>
Default: 2
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output image [raster] <put output description here>


Console usage

processing.runalg(otb:rigidtransformresampletranslation, -in, -transform.type, -transform.type.t

See also

Superimpose sensor
Description

<put algortithm description here>


Parameters

Reference input [raster] <put parameter description here>


The image to reproject [raster] <put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Spacing of the deformation field [number] <put parameter description here>
Default: 4
Interpolation [selection] <put parameter description here>
Options:
0 bco
1 nn
2 linear
Default: 0
Radius for bicubic interpolation [number] <put parameter description here>
Default: 2
324

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Available RAM (Mb) [number] <put parameter description here>


Default: 128
Outputs

Output image [raster] <put output description here>


Console usage

processing.runalg(otb:superimposesensor, -inr, -inm, -elev.default, -lms, -interpolator, -interp

See also

18.4.4 Image filtering


DimensionalityReduction (ica)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Algorithm [selection] <put parameter description here>
Options:
0 ica
Default: 0
number of iterations [number] <put parameter description here>
Default: 20
Give the increment weight of W in [0, 1] [number] <put parameter description here>
Default: 1
Number of Components [number] <put parameter description here>
Default: 0
Normalize [boolean] <put parameter description here>
Default: True
Outputs

Output Image [raster] <put output description here>


Inverse Output Image [raster] <put output description here>
Transformation matrix output [file] <put output description here>

18.4. OrfeoToolbox algorithm provider

325

QGIS User Guide, Release 2.6

Console usage

processing.runalg(otb:dimensionalityreductionica, -in, -method, -method.ica.iter, -method.ica.mu

See also

DimensionalityReduction (maf)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Algorithm [selection] <put parameter description here>
Options:
0 maf
Default: 0
Number of Components. [number] <put parameter description here>
Default: 0
Normalize. [boolean] <put parameter description here>
Default: True
Outputs

Output Image [raster] <put output description here>


Transformation matrix output [file] <put output description here>
Console usage

processing.runalg(otb:dimensionalityreductionmaf, -in, -method, -nbcomp, -normalize, -out, -outm

See also

DimensionalityReduction (napca)
Description

<put algortithm description here>

326

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Algorithm [selection] <put parameter description here>
Options:
0 napca
Default: 0
Set the x radius of the sliding window. [number] <put parameter description here>
Default: 1
Set the y radius of the sliding window. [number] <put parameter description here>
Default: 1
Number of Components. [number] <put parameter description here>
Default: 0
Normalize. [boolean] <put parameter description here>
Default: True
Outputs

Output Image [raster] <put output description here>


Inverse Output Image [raster] <put output description here>
Transformation matrix output [file] <put output description here>
Console usage

processing.runalg(otb:dimensionalityreductionnapca, -in, -method, -method.napca.radiusx, -method

See also

DimensionalityReduction (pca)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Algorithm [selection] <put parameter description here>
Options:
0 pca
Default: 0
Number of Components. [number] <put parameter description here>
Default: 0

18.4. OrfeoToolbox algorithm provider

327

QGIS User Guide, Release 2.6

Normalize. [boolean] <put parameter description here>


Default: True
Outputs

Output Image [raster] <put output description here>


Inverse Output Image [raster] <put output description here>
Transformation matrix output [file] <put output description here>
Console usage

processing.runalg(otb:dimensionalityreductionpca, -in, -method, -nbcomp, -normalize, -out, -outi

See also

Mean Shift filtering (can be used as Exact Large-Scale Mean-Shift segmentation, step 1)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Spatial radius [number] <put parameter description here>
Default: 5
Range radius [number] <put parameter description here>
Default: 15
Mode convergence threshold [number] <put parameter description here>
Default: 0.1
Maximum number of iterations [number] <put parameter description here>
Default: 100
Range radius coefficient [number] <put parameter description here>
Default: 0
Mode search. [boolean] <put parameter description here>
Default: True
Outputs

Filtered output [raster] <put output description here>


Spatial image [raster] <put output description here>

328

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(otb:meanshiftfilteringcanbeusedasexactlargescalemeanshiftsegmentationstep1, -i

See also

Smoothing (anidif)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Smoothing Type [selection] <put parameter description here>
Options:
0 anidif
Default: 2
Time Step [number] <put parameter description here>
Default: 0.125
Nb Iterations [number] <put parameter description here>
Default: 10
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:smoothinganidif, -in, -ram, -type, -type.anidif.timestep, -type.anidif.nbi

See also

Smoothing (gaussian)
Description

<put algortithm description here>

18.4. OrfeoToolbox algorithm provider

329

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Smoothing Type [selection] <put parameter description here>
Options:
0 gaussian
Default: 2
Radius [number] <put parameter description here>
Default: 2
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:smoothinggaussian, -in, -ram, -type, -type.gaussian.radius, -out)

See also

Smoothing (mean)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Smoothing Type [selection] <put parameter description here>
Options:
0 mean
Default: 2
Radius [number] <put parameter description here>
Default: 2
Outputs

Output Image [raster] <put output description here>

330

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(otb:smoothingmean, -in, -ram, -type, -type.mean.radius, -out)

See also

18.4.5 Image manipulation


ColorMapping (continuous)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Operation [selection] <put parameter description here>
Options:
0 labeltocolor
Default: 0
Color mapping method [selection] <put parameter description here>
Options:
0 continuous
Default: 0
Look-up tables [selection] <put parameter description here>
Options:
0 red
1 green
2 blue
3 grey
4 hot
5 cool
6 spring
7 summer
8 autumn
9 winter
10 copper

18.4. OrfeoToolbox algorithm provider

331

QGIS User Guide, Release 2.6

11 jet
12 hsv
13 overunder
14 relief
Default: 0
Mapping range lower value [number] <put parameter description here>
Default: 0
Mapping range higher value [number] <put parameter description here>
Default: 255
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:colormappingcontinuous, -in, -ram, -op, -method, -method.continuous.lut, -

See also

ColorMapping (custom)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Operation [selection] <put parameter description here>
Options:
0 labeltocolor
Default: 0
Color mapping method [selection] <put parameter description here>
Options:
0 custom
Default: 0
Look-up table file [file] <put parameter description here>

332

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:colormappingcustom, -in, -ram, -op, -method, -method.custom.lut, -out)

See also

ColorMapping (image)
Beschreibung

<put algortithm description here>


Parameter

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Vorgabe: 128
Operation [selection] <put parameter description here>
Optionen:
0 labeltocolor
Vorgabe: 0
Color mapping method [selection] <put parameter description here>
Optionen:
0 Bild
Vorgabe: 0
Support Image [raster] <put parameter description here>
NoData value [number] <put parameter description here>
Vorgabe: 0
lower quantile [number] <put parameter description here>
Vorgabe: 2
upper quantile [number] <put parameter description here>
Vorgabe: 2
Ausgaben

Output Image [raster] <put output description here>

18.4. OrfeoToolbox algorithm provider

333

QGIS User Guide, Release 2.6

Console usage

processing.runalg(otb:colormappingimage, -in, -ram, -op, -method, -method.image.in, -method.imag

Siehe auch

ColorMapping (optimal)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Operation [selection] <put parameter description here>
Options:
0 labeltocolor
Default: 0
Color mapping method [selection] <put parameter description here>
Options:
0 optimal
Default: 0
Background label [number] <put parameter description here>
Default: 0
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:colormappingoptimal, -in, -ram, -op, -method, -method.optimal.background,

See also

ExtractROI (fit)
Description

<put algortithm description here>

334

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Extraction mode [selection] <put parameter description here>
Options:
0 fit
Default: 0
Reference image [raster] <put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:extractroifit, -in, -ram, -mode, -mode.fit.ref, -mode.fit.elev.default, -o

See also

ExtractROI (standard)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Extraction mode [selection] <put parameter description here>
Options:
0 standard
Default: 0
Start X [number] <put parameter description here>
Default: 0
Start Y [number] <put parameter description here>
Default: 0

18.4. OrfeoToolbox algorithm provider

335

QGIS User Guide, Release 2.6

Size X [number] <put parameter description here>


Default: 0
Size Y [number] <put parameter description here>
Default: 0
Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:extractroistandard, -in, -ram, -mode, -startx, -starty, -sizex, -sizey, -o

See also

Images Concatenation
Description

<put algortithm description here>


Parameters

Input images list [multipleinput: rasters] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:imagesconcatenation, -il, -ram, -out)

See also

Image Tile Fusion


Description

<put algortithm description here>

336

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input Tile Images [multipleinput: rasters] <put parameter description here>


Number of tile columns [number] <put parameter description here>
Default: 0
Number of tile rows [number] <put parameter description here>
Default: 0
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:imagetilefusion, -il, -cols, -rows, -out)

See also

Read image information


Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Display the OSSIM keywordlist [boolean] <put parameter description here>
Default: True
GCPs Id [string] <put parameter description here>
Default: None
GCPs Info [string] <put parameter description here>
Default: None
GCPs Image Coordinates [string] <put parameter description here>
Default: None
GCPs Geographic Coordinates [string] <put parameter description here>
Default: None
Outputs
Console usage

processing.runalg(otb:readimageinformation, -in, -keywordlist, -gcp.ids, -gcp.info, -gcp.imcoord

18.4. OrfeoToolbox algorithm provider

337

QGIS User Guide, Release 2.6

See also

Rescale Image
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Output min value [number] <put parameter description here>
Default: 0
Output max value [number] <put parameter description here>
Default: 255
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:rescaleimage, -in, -ram, -outmin, -outmax, -out)

See also

Split Image
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output Image [file] <put output description here>

338

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(otb:splitimage, -in, -ram, -out)

See also

18.4.6 Learning
Classification Map Regularization
Description

<put algortithm description here>


Parameters

Input classification image [raster] <put parameter description here>


Structuring element radius (in pixels) [number] <put parameter description here>
Default: 1
Multiple majority: Undecided(X)/Original [boolean] <put parameter description here>
Default: True
Label for the NoData class [number] <put parameter description here>
Default: 0
Label for the Undecided class [number] <put parameter description here>
Default: 0
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output regularized image [raster] <put output description here>


Console usage

processing.runalg(otb:classificationmapregularization, -io.in, -ip.radius, -ip.suvbool, -ip.noda

See also

ComputeConfusionMatrix (raster)
Description

<put algortithm description here>

18.4. OrfeoToolbox algorithm provider

339

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Ground truth [selection] <put parameter description here>
Options:
0 raster
Default: 0
Input reference image [raster] <put parameter description here>
Value for nodata pixels [number] <put parameter description here>
Default: 0
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Matrix output [file] <put output description here>


Console usage

processing.runalg(otb:computeconfusionmatrixraster, -in, -ref, -ref.raster.in, -nodatalabel, -ra

See also

ComputeConfusionMatrix (vector)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Ground truth [selection] <put parameter description here>
Options:
0 vector
Default: 0
Input reference vector data [file] <put parameter description here>
Field name [string] Optional.
<put parameter description here>
Default: Class
Value for nodata pixels [number] <put parameter description here>
Default: 0

340

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Available RAM (Mb) [number] <put parameter description here>


Default: 128
Outputs

Matrix output [file] <put output description here>


Console usage

processing.runalg(otb:computeconfusionmatrixvector, -in, -ref, -ref.vector.in, -ref.vector.field

See also

Compute Images second order statistics


Description

<put algortithm description here>


Parameters

Input images [multipleinput: rasters] <put parameter description here>


Background Value [number] <put parameter description here>
Default: 0.0
Outputs

Output XML file [file] <put output description here>


Console usage
processing.runalg(otb:computeimagessecondorderstatistics, -il, -bv, -out)

See also

FusionOfClassifications (dempstershafer)
Description

<put algortithm description here>


Parameters

Input classifications [multipleinput: rasters] <put parameter description here>


Fusion method [selection] <put parameter description here>
Options:

18.4. OrfeoToolbox algorithm provider

341

QGIS User Guide, Release 2.6

0 dempstershafer
Default: 0
Confusion Matrices [multipleinput: files] <put parameter description here>
Mass of belief measurement [selection] <put parameter description here>
Options:
0 precision
1 recall
2 accuracy
3 kappa
Default: 0
Label for the NoData class [number] <put parameter description here>
Default: 0
Label for the Undecided class [number] <put parameter description here>
Default: 0
Outputs

The output classification image [raster] <put output description here>


Console usage

processing.runalg(otb:fusionofclassificationsdempstershafer, -il, -method, -method.dempstershafe

See also

FusionOfClassifications (majorityvoting)
Description

<put algortithm description here>


Parameters

Input classifications [multipleinput: rasters] <put parameter description here>


Fusion method [selection] <put parameter description here>
Options:
0 majorityvoting
Default: 0
Label for the NoData class [number] <put parameter description here>
Default: 0
Label for the Undecided class [number] <put parameter description here>
Default: 0

342

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

The output classification image [raster] <put output description here>


Console usage

processing.runalg(otb:fusionofclassificationsmajorityvoting, -il, -method, -nodatalabel, -undeci

See also

Image Classification
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Input Mask [raster] Optional.
<put parameter description here>
Model file [file] <put parameter description here>
Statistics file [file] Optional.
<put parameter description here>
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:imageclassification, -in, -mask, -model, -imstat, -ram, -out)

See also

SOM Classification
Description

<put algortithm description here>

18.4. OrfeoToolbox algorithm provider

343

QGIS User Guide, Release 2.6

Parameters

InputImage [raster] <put parameter description here>


ValidityMask [raster] Optional.
<put parameter description here>
TrainingProbability [number] <put parameter description here>
Default: 1
TrainingSetSize [number] <put parameter description here>
Default: 0
StreamingLines [number] <put parameter description here>
Default: 0
SizeX [number] <put parameter description here>
Default: 32
SizeY [number] <put parameter description here>
Default: 32
NeighborhoodX [number] <put parameter description here>
Default: 10
NeighborhoodY [number] <put parameter description here>
Default: 10
NumberIteration [number] <put parameter description here>
Default: 5
BetaInit [number] <put parameter description here>
Default: 1
BetaFinal [number] <put parameter description here>
Default: 0.1
InitialValue [number] <put parameter description here>
Default: 0
Available RAM (Mb) [number] <put parameter description here>
Default: 128
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

OutputImage [raster] <put output description here>


SOM Map [raster] <put output description here>
Console usage
processing.runalg(otb:somclassification, -in, -vm, -tp, -ts, -sl, -sx, -sy, -nx, -ny, -ni, -bi,

344

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

TrainImagesClassifier (ann)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 ann
Default: 0
Train Method Type [selection] <put parameter description here>
Options:
0 reg
1 back
Default: 0
Number of neurons in each intermediate layer [string] <put parameter description here>
Default: None
Neuron activation function type [selection] <put parameter description here>
Options:
0 ident
1 sig

18.4. OrfeoToolbox algorithm provider

345

QGIS User Guide, Release 2.6

2 gau
Default: 1
Alpha parameter of the activation function [number] <put parameter description here>
Default: 1
Beta parameter of the activation function [number] <put parameter description here>
Default: 1
Strength of the weight gradient term in the BACKPROP method [number] <put parameter description here>
Default: 0.1

Strength of the momentum term (the difference between weights on the 2 previous iteratio
<put parameter description here>
Default: 0.1
Initial value Delta_0 of update-values Delta_{ij} in RPROP method [number]
<put parameter description here>
Default: 0.1
Update-values lower limit Delta_{min} in RPROP method [number] <put parameter description here>
Default: 1e-07
Termination criteria [selection] <put parameter description here>
Options:
0 iter
1 eps
2 all
Default: 2
Epsilon value used in the Termination criteria [number] <put
here>

parameter

description

Default: 0.01
Maximum number of iterations used in the Termination criteria [number] <put parameter description here>
Default: 1000
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifierann, -io.il, -io.vd, -io.imstat, -elev.default, -samp

346

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

TrainImagesClassifier (bayes)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 bayes
Default: 0
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifierbayes, -io.il, -io.vd, -io.imstat, -elev.default, -sa

18.4. OrfeoToolbox algorithm provider

347

QGIS User Guide, Release 2.6

See also

TrainImagesClassifier (boost)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 boost
Default: 0
Boost Type [selection] <put parameter description here>
Options:
0 discrete
1 real
2 logit
3 gentle
Default: 1
Weak count [number] <put parameter description here>
Default: 100
Weight Trim Rate [number] <put parameter description here>
Default: 0.95

348

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Maximum depth of the tree [number] <put parameter description here>


Default: 1
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifierboost, -io.il, -io.vd, -io.imstat, -elev.default, -sa

See also

TrainImagesClassifier (dt)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 dt
18.4. OrfeoToolbox algorithm provider

349

QGIS User Guide, Release 2.6

Default: 0
Maximum depth of the tree [number] <put parameter description here>
Default: 65535
Minimum number of samples in each node [number] <put parameter description here>
Default: 10
Termination criteria for regression tree [number] <put parameter description here>
Default: 0.01

Cluster possible values of a categorical variable into K <= cat clusters to find a subop
<put parameter description here>
Default: 10
K-fold cross-validations [number] <put parameter description here>
Default: 10
Set Use1seRule flag to false [boolean] <put parameter description here>
Default: True
Set TruncatePrunedTree flag to false [boolean] <put parameter description here>
Default: True
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifierdt, -io.il, -io.vd, -io.imstat, -elev.default, -sampl

See also

TrainImagesClassifier (gbt)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>

350

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Default elevation [number] <put parameter description here>


Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 gbt
Default: 0
Number of boosting algorithm iterations [number] <put parameter description here>
Default: 200
Regularization parameter [number] <put parameter description here>
Default: 0.01
Portion of the whole training set used for each algorithm iteration [number]
<put parameter description here>
Default: 0.8
Maximum depth of the tree [number] <put parameter description here>
Default: 3
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifiergbt, -io.il, -io.vd, -io.imstat, -elev.default, -samp

18.4. OrfeoToolbox algorithm provider

351

QGIS User Guide, Release 2.6

See also

TrainImagesClassifier (knn)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 knn
Default: 0
Number of Neighbors [number] <put parameter description here>
Default: 32
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>

352

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(otb:trainimagesclassifierknn, -io.il, -io.vd, -io.imstat, -elev.default, -samp

See also

TrainImagesClassifier (libsvm)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 libsvm
Default: 0
SVM Kernel Type [selection] <put parameter description here>
Options:
0 linear
1 rbf
2 poly
3 sigmoid
Default: 0

18.4. OrfeoToolbox algorithm provider

353

QGIS User Guide, Release 2.6

Cost parameter C [number] <put parameter description here>


Default: 1
Parameters optimization [boolean] <put parameter description here>
Default: True
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifierlibsvm, -io.il, -io.vd, -io.imstat, -elev.default, -s

See also

TrainImagesClassifier (rf)
Description

<put algortithm description here>


Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class

354

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Classifier to use for the training [selection] <put parameter description here>
Options:
0 rf
Default: 0
Maximum depth of the tree [number] <put parameter description here>
Default: 5
Minimum number of samples in each node [number] <put parameter description here>
Default: 10
Termination Criteria for regression tree [number] <put parameter description here>
Default: 0

Cluster possible values of a categorical variable into K <= cat clusters to find a subop
<put parameter description here>
Default: 10
Size of the randomly selected subset of features at each tree node [number]
<put parameter description here>
Default: 0
Maximum number of trees in the forest [number] <put parameter description here>
Default: 100
Sufficient accuracy (OOB error) [number] <put parameter description here>
Default: 0.01
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifierrf, -io.il, -io.vd, -io.imstat, -elev.default, -sampl

See also

TrainImagesClassifier (svm)
Description

<put algortithm description here>

18.4. OrfeoToolbox algorithm provider

355

QGIS User Guide, Release 2.6

Parameters

Input Image List [multipleinput: rasters] <put parameter description here>


Input Vector Data List [multipleinput: any vectors] <put parameter description here>
Input XML image statistics file [file] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Maximum training sample size per class [number] <put parameter description here>
Default: 1000
Maximum validation sample size per class [number] <put parameter description here>
Default: 1000
On edge pixel inclusion [boolean] <put parameter description here>
Default: True
Training and validation sample ratio [number] <put parameter description here>
Default: 0.5
Name of the discrimination field [string] <put parameter description here>
Default: Class
Classifier to use for the training [selection] <put parameter description here>
Options:
0 svm
Default: 0
SVM Model Type [selection] <put parameter description here>
Options:
0 csvc
1 nusvc
2 oneclass
Default: 0
SVM Kernel Type [selection] <put parameter description here>
Options:
0 linear
1 rbf
2 poly
3 sigmoid
Default: 0
Cost parameter C [number] <put parameter description here>
Default: 1
Parameter nu of a SVM optimization problem (NU_SVC / ONE_CLASS) [number] <put
parameter description here>
Default: 0
356

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameter coef0 of a kernel function (POLY / SIGMOID) [number] <put parameter description here>
Default: 0
Parameter gamma of a kernel function (POLY / RBF / SIGMOID) [number] <put parameter description here>
Default: 1
Parameter degree of a kernel function (POLY) [number] <put parameter description here>
Default: 1
Parameters optimization [boolean] <put parameter description here>
Default: True
set user defined seed [number] <put parameter description here>
Default: 0
Outputs

Output confusion matrix [file] <put output description here>


Output model [file] <put output description here>
Console usage

processing.runalg(otb:trainimagesclassifiersvm, -io.il, -io.vd, -io.imstat, -elev.default, -samp

See also

Unsupervised KMeans image classification


Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Validity Mask [raster] Optional.
<put parameter description here>
Training set size [number] <put parameter description here>
Default: 100
Number of classes [number] <put parameter description here>
Default: 5
Maximum number of iterations [number] <put parameter description here>
Default: 1000

18.4. OrfeoToolbox algorithm provider

357

QGIS User Guide, Release 2.6

Convergence threshold [number] <put parameter description here>


Default: 0.0001
Outputs

Output Image [raster] <put output description here>


Centroid filename [file] <put output description here>
Console usage

processing.runalg(otb:unsupervisedkmeansimageclassification, -in, -ram, -vm, -ts, -nc, -maxit, -

See also

18.4.7 Miscellaneous
Band Math
Description

<put algortithm description here>


Parameters

Input image list [multipleinput: rasters] <put parameter description here>


Available RAM (Mb) [number] <put parameter description here>
Default: 128
Expression [string] <put parameter description here>
Default: None
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:bandmath, -il, -ram, -exp, -out)

See also

ComputeModulusAndPhase-one (OneEntry)
Description

<put algortithm description here>


358

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Number Of inputs [selection] <put parameter description here>


Options:
0 one
Default: 0
Input image [raster] <put parameter description here>
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Modulus [raster] <put output description here>


Phase [raster] <put output description here>
Console usage
processing.runalg(otb:computemodulusandphaseoneoneentry, -nbinput, -nbinput.one.in, -ram, -mod,

See also

ComputeModulusAndPhase-two (TwoEntries)
Description

<put algortithm description here>


Parameters

Number Of inputs [selection] <put parameter description here>


Options:
0 two
Default: 0
Real part input [raster] <put parameter description here>
Imaginary part input [raster] <put parameter description here>
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Modulus [raster] <put output description here>


Phase [raster] <put output description here>

18.4. OrfeoToolbox algorithm provider

359

QGIS User Guide, Release 2.6

Console usage

processing.runalg(otb:computemodulusandphasetwotwoentries, -nbinput, -nbinput.two.re, -nbinput.t

See also

Images comparaison
Description

<put algortithm description here>


Parameters

Reference image [raster] <put parameter description here>


Reference image channel [number] <put parameter description here>
Default: 1
Measured image [raster] <put parameter description here>
Measured image channel [number] <put parameter description here>
Default: 1
Start X [number] <put parameter description here>
Default: 0
Start Y [number] <put parameter description here>
Default: 0
Size X [number] <put parameter description here>
Default: 0
Size Y [number] <put parameter description here>
Default: 0
Outputs
Console usage

processing.runalg(otb:imagescomparaison, -ref.in, -ref.channel, -meas.in, -meas.channel, -roi.st

See also

Image to KMZ Export


Description

<put algortithm description here>

360

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input image [raster] <put parameter description here>


Tile Size [number] <put parameter description here>
Default: 512
Image logo [raster] Optional.
<put parameter description here>
Image legend [raster] Optional.
<put parameter description here>
Default elevation [number] <put parameter description here>
Default: 0
Outputs

Output .kmz product [file] <put output description here>


Console usage
processing.runalg(otb:imagetokmzexport, -in, -tilesize, -logo, -legend, -elev.default, -out)

See also

18.4.8 Segmentation
Connected Component Segmentation
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Mask expression [string] Optional.
<put parameter description here>
Default: None
Connected Component Expression [string] <put parameter description here>
Default: None
Minimum Object Size [number] <put parameter description here>
Default: 2

18.4. OrfeoToolbox algorithm provider

361

QGIS User Guide, Release 2.6

OBIA Expression [string] Optional.


<put parameter description here>
Default: None
Default elevation [number] <put parameter description here>
Default: 0
Outputs

Output Shape [vector] <put output description here>


Console usage

processing.runalg(otb:connectedcomponentsegmentation, -in, -mask, -expr, -minsize, -obia, -elev.

See also

Exact Large-Scale Mean-Shift segmentation, step 2


Description

<put algortithm description here>


Parameters

Filtered image [raster] <put parameter description here>


Spatial image [raster] Optional.
<put parameter description here>
Range radius [number] <put parameter description here>
Default: 15
Spatial radius [number] <put parameter description here>
Default: 5
Minimum Region Size [number] <put parameter description here>
Default: 0
Size of tiles in pixel (X-axis) [number] <put parameter description here>
Default: 500
Size of tiles in pixel (Y-axis) [number] <put parameter description here>
Default: 500
Directory where to write temporary files [file] Optional.
<put parameter description here>
Temporary files cleaning [boolean] <put parameter description here>
Default: True

362

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Output Image [raster] <put output description here>


Console usage

processing.runalg(otb:exactlargescalemeanshiftsegmentationstep2, -in, -inpos, -ranger, -spatialr

See also

Exact Large-Scale Mean-Shift segmentation, step 3 (optional)


Description

<put algortithm description here>


Parameters

Input image [raster] <put parameter description here>


Segmented image [raster] <put parameter description here>
Minimum Region Size [number] <put parameter description here>
Default: 50
Size of tiles in pixel (X-axis) [number] <put parameter description here>
Default: 500
Size of tiles in pixel (Y-axis) [number] <put parameter description here>
Default: 500
Outputs

Output Image [raster] <put output description here>


Console usage
processing.runalg(otb:exactlargescalemeanshiftsegmentationstep3optional, -in, -inseg, -minsize,

See also

Exact Large-Scale Mean-Shift segmentation, step 4


Description

<put algortithm description here>

18.4. OrfeoToolbox algorithm provider

363

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Segmented image [raster] <put parameter description here>
Size of tiles in pixel (X-axis) [number] <put parameter description here>
Default: 500
Size of tiles in pixel (Y-axis) [number] <put parameter description here>
Default: 500
Outputs

Output GIS vector file [vector] <put output description here>


Console usage

processing.runalg(otb:exactlargescalemeanshiftsegmentationstep4, -in, -inseg, -tilesizex, -tiles

See also

Hoover compare segmentation


Description

<put algortithm description here>


Parameters

Input ground truth [raster] <put parameter description here>


Input machine segmentation [raster] <put parameter description here>
Background label [number] <put parameter description here>
Default: 0
Overlapping threshold [number] <put parameter description here>
Default: 0.75
Correct detection score [number] <put parameter description here>
Default: 0.0
Over-segmentation score [number] <put parameter description here>
Default: 0.0
Under-segmentation score [number] <put parameter description here>
Default: 0.0
Missed detection score [number] <put parameter description here>
Default: 0.0

364

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Colored ground truth output [raster] <put output description here>


Colored machine segmentation output [raster] <put output description here>
Console usage

processing.runalg(otb:hoovercomparesegmentation, -ingt, -inms, -bg, -th, -rc, -rf, -ra, -rm, -ou

See also

Segmentation (cc)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Segmentation algorithm [selection] <put parameter description here>
Options:
0 cc
Default: 0
Condition [string] <put parameter description here>
Default: None
Processing mode [selection] <put parameter description here>
Options:
0 vector
Default: 0
Writing mode for the output vector file [selection] <put parameter description here>
Options:
0 ulco
1 ovw
2 ulovw
3 ulu
Default: 0
Mask Image [raster] Optional.
<put parameter description here>
8-neighbor connectivity [boolean] <put parameter description here>
Default: True

18.4. OrfeoToolbox algorithm provider

365

QGIS User Guide, Release 2.6

Stitch polygons [boolean] <put parameter description here>


Default: True
Minimum object size [number] <put parameter description here>
Default: 1
Simplify polygons [number] <put parameter description here>
Default: 0.1
Layer name [string] <put parameter description here>
Default: layer
Geometry index field name [string] <put parameter description here>
Default: DN
Tiles size [number] <put parameter description here>
Default: 1024
Starting geometry index [number] <put parameter description here>
Default: 1
OGR options for layer creation [string] Optional.
<put parameter description here>
Default: None
Outputs

Output vector file [vector] <put output description here>


Console usage

processing.runalg(otb:segmentationcc, -in, -filter, -filter.cc.expr, -mode, -mode.vector.outmode

See also

Segmentation (edison)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Segmentation algorithm [selection] <put parameter description here>
Options:
0 edison
Default: 0
Spatial radius [number] <put parameter description here>
Default: 5
366

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Range radius [number] <put parameter description here>


Default: 15
Minimum region size [number] <put parameter description here>
Default: 100
Scale factor [number] <put parameter description here>
Default: 1
Processing mode [selection] <put parameter description here>
Options:
0 vector
Default: 0
Writing mode for the output vector file [selection] <put parameter description here>
Options:
0 ulco
1 ovw
2 ulovw
3 ulu
Default: 0
Mask Image [raster] Optional.
<put parameter description here>
8-neighbor connectivity [boolean] <put parameter description here>
Default: True
Stitch polygons [boolean] <put parameter description here>
Default: True
Minimum object size [number] <put parameter description here>
Default: 1
Simplify polygons [number] <put parameter description here>
Default: 0.1
Layer name [string] <put parameter description here>
Default: layer
Geometry index field name [string] <put parameter description here>
Default: DN
Tiles size [number] <put parameter description here>
Default: 1024
Starting geometry index [number] <put parameter description here>
Default: 1
OGR options for layer creation [string] Optional.
<put parameter description here>
Default: None

18.4. OrfeoToolbox algorithm provider

367

QGIS User Guide, Release 2.6

Outputs

Output vector file [vector] <put output description here>


Console usage

processing.runalg(otb:segmentationedison, -in, -filter, -filter.edison.spatialr, -filter.edison.

See also

Segmentation (meanshift)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Segmentation algorithm [selection] <put parameter description here>
Options:
0 meanshift
Default: 0
Spatial radius [number] <put parameter description here>
Default: 5
Range radius [number] <put parameter description here>
Default: 15
Mode convergence threshold [number] <put parameter description here>
Default: 0.1
Maximum number of iterations [number] <put parameter description here>
Default: 100
Minimum region size [number] <put parameter description here>
Default: 100
Processing mode [selection] <put parameter description here>
Options:
0 vector
Default: 0
Writing mode for the output vector file [selection] <put parameter description here>
Options:
0 ulco
1 ovw
2 ulovw

368

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

3 ulu
Default: 0
Mask Image [raster] Optional.
<put parameter description here>
8-neighbor connectivity [boolean] <put parameter description here>
Default: True
Stitch polygons [boolean] <put parameter description here>
Default: True
Minimum object size [number] <put parameter description here>
Default: 1
Simplify polygons [number] <put parameter description here>
Default: 0.1
Layer name [string] <put parameter description here>
Default: layer
Geometry index field name [string] <put parameter description here>
Default: DN
Tiles size [number] <put parameter description here>
Default: 1024
Starting geometry index [number] <put parameter description here>
Default: 1
OGR options for layer creation [string] Optional.
<put parameter description here>
Default: None
Outputs

Output vector file [vector] <put output description here>


Console usage

processing.runalg(otb:segmentationmeanshift, -in, -filter, -filter.meanshift.spatialr, -filter.m

See also

Segmentation (mprofiles)
Description

<put algortithm description here>

18.4. OrfeoToolbox algorithm provider

369

QGIS User Guide, Release 2.6

Parameters

Input Image [raster] <put parameter description here>


Segmentation algorithm [selection] <put parameter description here>
Options:
0 mprofiles
Default: 0
Profile Size [number] <put parameter description here>
Default: 5
Initial radius [number] <put parameter description here>
Default: 1
Radius step. [number] <put parameter description here>
Default: 1
Threshold of the final decision rule [number] <put parameter description here>
Default: 1
Processing mode [selection] <put parameter description here>
Options:
0 vector
Default: 0
Writing mode for the output vector file [selection] <put parameter description here>
Options:
0 ulco
1 ovw
2 ulovw
3 ulu
Default: 0
Mask Image [raster] Optional.
<put parameter description here>
8-neighbor connectivity [boolean] <put parameter description here>
Default: True
Stitch polygons [boolean] <put parameter description here>
Default: True
Minimum object size [number] <put parameter description here>
Default: 1
Simplify polygons [number] <put parameter description here>
Default: 0.1
Layer name [string] <put parameter description here>
Default: layer

370

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Geometry index field name [string] <put parameter description here>


Default: DN
Tiles size [number] <put parameter description here>
Default: 1024
Starting geometry index [number] <put parameter description here>
Default: 1
OGR options for layer creation [string] Optional.
<put parameter description here>
Default: None
Outputs

Output vector file [vector] <put output description here>


Console usage

processing.runalg(otb:segmentationmprofiles, -in, -filter, -filter.mprofiles.size, -filter.mprof

See also

Segmentation (watershed)
Description

<put algortithm description here>


Parameters

Input Image [raster] <put parameter description here>


Segmentation algorithm [selection] <put parameter description here>
Options:
0 watershed
Default: 0
Depth Threshold [number] <put parameter description here>
Default: 0.01
Flood Level [number] <put parameter description here>
Default: 0.1
Processing mode [selection] <put parameter description here>
Options:
0 vector
Default: 0
Writing mode for the output vector file [selection] <put parameter description here>
Options:
18.4. OrfeoToolbox algorithm provider

371

QGIS User Guide, Release 2.6

0 ulco
1 ovw
2 ulovw
3 ulu
Default: 0
Mask Image [raster] Optional.
<put parameter description here>
8-neighbor connectivity [boolean] <put parameter description here>
Default: True
Stitch polygons [boolean] <put parameter description here>
Default: True
Minimum object size [number] <put parameter description here>
Default: 1
Simplify polygons [number] <put parameter description here>
Default: 0.1
Layer name [string] <put parameter description here>
Default: layer
Geometry index field name [string] <put parameter description here>
Default: DN
Tiles size [number] <put parameter description here>
Default: 1024
Starting geometry index [number] <put parameter description here>
Default: 1
OGR options for layer creation [string] Optional.
<put parameter description here>
Default: None
Outputs

Output vector file [vector] <put output description here>


Console usage

processing.runalg(otb:segmentationwatershed, -in, -filter, -filter.watershed.threshold, -filter.

See also

372

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

18.4.9 Stereo
Stereo Framework
Description

<put algortithm description here>


Parameters

Input images list [multipleinput: rasters] <put parameter description here>


Couples list [string] Optional.
<put parameter description here>
Default: None
Image channel used for the block matching [number] <put parameter description here>
Default: 1
Default elevation [number] <put parameter description here>
Default: 0
Output resolution [number] <put parameter description here>
Default: 1
NoData value [number] <put parameter description here>
Default: -32768
Method to fuse measures in each DSM cell [selection] <put parameter description here>
Options:
0 max
1 min
2 mean
3 acc
Default: 0
Parameters estimation modes [selection] <put parameter description here>
Options:
0 fit
1 user
Default: 0
Upper Left X [number] <put parameter description here>
Default: 0.0
Upper Left Y [number] <put parameter description here>
Default: 0.0
Size X [number] <put parameter description here>
Default: 0

18.4. OrfeoToolbox algorithm provider

373

QGIS User Guide, Release 2.6

Size Y [number] <put parameter description here>


Default: 0
Pixel Size X [number] <put parameter description here>
Default: 0.0
Pixel Size Y [number] <put parameter description here>
Default: 0.0
Output Cartographic Map Projection [selection] <put parameter description here>
Options:
0 utm
1 lambert2
2 lambert93
3 wgs
4 epsg
Default: 3
Zone number [number] <put parameter description here>
Default: 31
Northern Hemisphere [boolean] <put parameter description here>
Default: True
EPSG Code [number] <put parameter description here>
Default: 4326
Step of the deformation grid (in pixels) [number] <put parameter description here>
Default: 16
Sub-sampling rate for epipolar grid inversion [number] <put parameter description here>
Default: 10
Block-matching metric [selection] <put parameter description here>
Options:
0 ssdmean
1 ssd
2 ncc
3 lp
Default: 0
p value [number] <put parameter description here>
Default: 1
Radius of blocks for matching filter (in pixels) [number] <put parameter description
here>
Default: 2
Minimum altitude offset (in meters) [number] <put parameter description here>
Default: -20

374

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Maximum altitude offset (in meters) [number] <put parameter description here>
Default: 20
Use bijection consistency in block matching strategy [boolean] <put
scription here>

parameter

de-

Default: True
Use median disparities filtering [boolean] <put parameter description here>
Default: True
Correlation metric threshold [number] <put parameter description here>
Default: 0.6
Input left mask [raster] Optional.
<put parameter description here>
Input right mask [raster] Optional.
<put parameter description here>
Discard pixels with low local variance [number] <put parameter description here>
Default: 50
Available RAM (Mb) [number] <put parameter description here>
Default: 128
Outputs

Output DSM [raster] <put output description here>


Console usage

processing.runalg(otb:stereoframework, -input.il, -input.co, -input.channel, -elev.default, -out

See also

18.4.10 Vector
Concatenate
Description

<put algortithm description here>


Parameters

Input VectorDatas to concatenate [multipleinput: any vectors] <put parameter description here>

18.4. OrfeoToolbox algorithm provider

375

QGIS User Guide, Release 2.6

Outputs

Concatenated VectorData [vector] <put output description here>


Console usage
processing.runalg(otb:concatenate, -vd, -out)

See also

18.5 QGIS algorithm provider


QGIS algortihm provider implements various analysis and geoprocessing operations using mostly only QGIS API.
So almost all algorthms from this provider will work out of the box without any additional configuration.
This provider incorporates fTools functionality, some algorithms from mmQGIS plugin and also adds its own
algorithms.
.

18.5.1 Database
Import into PostGIS
Description

<put algortithm description here>


Parameters

Layer to import [vector: any] <put parameter description here>


Database (connection name) [selection] <put parameter description here>
Options:
0 local
Default: 0
Schema (schema name) [string] <put parameter description here>
Default: public
Table to import to (leave blank to use layer name) [string] <put parameter description
here>
Default: (not set)
Primary key field [tablefield: any] Optional.
<put parameter description here>
Geometry column [string] <put parameter description here>
Default: geom

376

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Overwrite [boolean] <put parameter description here>


Default: True
Create spatial index [boolean] <put parameter description here>
Default: True
Convert field names to lowercase [boolean] <put parameter description here>
Default: True
Drop length constraints on character fields [boolean] <put parameter description here>
Default: False
Outputs
Console usage

processing.runalg(qgis:importintopostgis, input, database, schema, tablename, primary_key, geome

See also

PostGIS execute SQL


Description

<put algortithm description here>


Parameters

Database [string] <put parameter description here>


Default: (not set)
SQL query [string] <put parameter description here>
Default: (not set)
Outputs
Console usage
processing.runalg(qgis:postgisexecutesql, database, sql)

See also

18.5. QGIS algorithm provider

377

QGIS User Guide, Release 2.6

18.5.2 Raster general


Set style for raster layer
Description

<put algortithm description here>


Parameters

Raster layer [raster] <put parameter description here>


Style file [file] <put parameter description here>
Outputs

Styled layer [raster] <put output description here>


Console usage
processing.runalg(qgis:setstyleforrasterlayer, input, style)

See also

18.5.3 Raster
Hypsometric curves
Description

Calculate hypsometric curves for features of polygon layer and save them as CSV file for further processing.
Parameters

DEM to analyze [raster] DEM to use for calculating altitudes.


Boundary layer [vector: polygon] Polygonal vector layer with boundaries of areas used to calculate hypsometric curves.
Step [number] Distanse between curves.
Default: 100.0
Use % of area instead of absolute value [boolean] Write area percentage to Area field of the
CSV file instead of absolute area value.
Default: False

378

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Output directory [directory] Directory where output will be saved. For each feature from input vector
layer CSV file with area and altitude values will be created.
File name consists of prefix hystogram_ followed by layer name and feature ID.
Console usage

processing.runalg(qgis:hypsometriccurves, input_dem, boundary_layer, step, use_percentage, outpu

See also

Raster layer statistics


Description

Calculates basic statistics of the raster layer.


Parameters

Input layer [raster] Raster to analyze.


Outputs

Statistics [html] Analysis results in HTML format.


Minimum value [number] Minimum cell value.
Maximum value [number] Maximum cell value.
Sum [number] Sum of all cells values.
Mean value [number] Mean cell value.
valid cells count [number] Number of cell with data.
No-data cells count [number] Number of NODATA cells.
Standard deviation [number] Standard deviation of cells values.
Console usage
processing.runalg(qgis:rasterlayerstatistics, input, output_html_file)

See also

Zonal Statistics
Description

Calculates some statistics values for pixels of input raster inside certain zones, defined as polygon layer.
Following values calculated for each zone:
minimum
18.5. QGIS algorithm provider

379

QGIS User Guide, Release 2.6

maximum
sum
count
mean
standard deviation
number of unique values
range
variance
Parameters

Raster layer [raster] Raster to analyze.


Raster band [number] Number of raster band to analyze.
Default: 1
Vector layer containing zones [vector: polygon] Layer with zones boundaries.
Output column prefix [string] Prefix for output fields.
Default: _
Load whole raster in memory [boolean] Determines if raster band will be loaded in memory (True)
or readed by chunks (False). Useful only when disk IO or raster scanning inefficiencies are your limiting
factor.
Default: True
Outputs

Output layer [vector] The resulting layer. Basically this is same layer as zones layer with new columns
containing statistics added.
Console usage
processing.runalg(qgis:zonalstatistics, input_raster, raster_band, input_vector, column_prefix,

See also

18.5.4 Table
Frequency analysis
Description

<put algortithm description here>

380

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

input [vector: any] <put parameter description here>


fields [string] <put parameter description here>
Default: (not set)
Outputs

output [table] <put output description here>


Console usage
processing.runalg(qgis:frequencyanalysis, input, fields, output)

See also

18.5.5 Vector analysis


Count points in polygon
Description

Counts the number of points present in each feature of a polygon layer.


Parameters

Polygons [vector: polygon] Polygons layer.


Points [vector: point] Points layer.
Count field name [string] The name of the attribute table column containing the points number.
Default: NUMPOINTS
Outputs

Result [vector] Resulting layer with the attribute table containing the new column of the points count.
Console usage
processing.runalg(qgis:countpointsinpolygon, polygons, points, field, output)

18.5. QGIS algorithm provider

381

QGIS User Guide, Release 2.6

See also

Count points in polygon (weighted)


Description

Counts the number of points in each feature of a polygon layer and calculates the mean of the selected field for
each feature of the polygon layer. These values will be added to the attribute table of the resulting polygon layer.
Parameters

Polygons [vector: polygon] Polygons layer.


Points [vector: point] Points layer.
Weight field [tablefield: any] Weight field of the points attribute table.
Count field name [string] Name of the column for the new weighted field.
Default: NUMPOINTS
Outputs

Result [vector] The resulting polygons layer.


Console usage
processing.runalg(qgis:countpointsinpolygonweighted, polygons, points, weight, field, output)

See also

Count unique points in polygon


Description

Counts the number of unique values of a points in a polygons layer. Creates a new polygons layer with an extra
column in the attribute table containing the count of unique values for each feature.
Parameters

Polygons [vector: polygon] Polygons layer.


Points [vector: point] Points layer.
Class field [tablefield: any] Points layer column name of the unique value chosen.
Count field name [string] Column name containing the count of unique values in the resulting polygons
layer.
Default: NUMPOINTS
Outputs

Result [vector] The resulting polygons layer.

382

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(qgis:countuniquepointsinpolygon, polygons, points, classfield, field, output)

See also

Distance matrix
Description

<put algortithm description here>


Parameters

Input point layer [vector: point] <put parameter description here>


Input unique ID field [tablefield: any] <put parameter description here>
Target point layer [vector: point] <put parameter description here>
Target unique ID field [tablefield: any] <put parameter description here>
Output matrix type [selection] <put parameter description here>
Options:
0 Linear (N*k x 3) distance matrix
1 Standard (N x T) distance matrix
2 Summary distance matrix (mean, std. dev., min, max)
Default: 0
Use only the nearest (k) target points [number] <put parameter description here>
Default: 0
Outputs

Distance matrix [table] <put output description here>


Console usage

processing.runalg(qgis:distancematrix, input_layer, input_field, target_layer, target_field, mat

See also

Distance to nearest hub


Description

<put algortithm description here>

18.5. QGIS algorithm provider

383

QGIS User Guide, Release 2.6

Parameters

Source points layer [vector: any] <put parameter description here>


Destination hubs layer [vector: any] <put parameter description here>
Hub layer name attribute [tablefield: any] <put parameter description here>
Output shape type [selection] <put parameter description here>
Options:
0 Point
1 Line to hub
Default: 0
Measurement unit [selection] <put parameter description here>
Options:
0 Meters
1 Feet
2 Miles
3 Kilometers
4 Layer units
Default: 0
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:distancetonearesthub, points, hubs, field, geometry, unit, output)

See also

Generate points (pixel centroids) along line


Description

<put algortithm description here>


Parameters

Raster layer [raster] <put parameter description here>


Vector layer [vector: line] <put parameter description here>
Outputs

Output layer [vector] <put output description here>

384

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(qgis:generatepointspixelcentroidsalongline, input_raster, input_vector, output

See also

Generate points (pixel centroids) inside polygons


Description

<put algortithm description here>


Parameters

Raster layer [raster] <put parameter description here>


Vector layer [vector: polygon] <put parameter description here>
Outputs

Output layer [vector] <put output description here>


Console usage

processing.runalg(qgis:generatepointspixelcentroidsinsidepolygons, input_raster, input_vector, o

See also

Hub lines
Description

Creates hub and spoke diagrams with lines drawn from points on the Spoke Point layer to matching points in
the Hub Point layer. Determination of which hub goes with each point is based on a match between the Hub
ID field on the hub points and the Spoke ID field on the spoke points.
Parameters

Hub point layer [vector: any] <put parameter description here>


Hub ID field [tablefield: any] <put parameter description here>
Spoke point layer [vector: any] <put parameter description here>
Spoke ID field [tablefield: any] <put parameter description here>
Outputs

Output [vector] The resulting layer.

18.5. QGIS algorithm provider

385

QGIS User Guide, Release 2.6

Console usage
processing.runalg(qgis:hublines, hubs, hub_field, spokes, spoke_field, output)

See also

Mean coordinate(s)
Description

Calculates the mean of the coordinates of a layer starting from a field of the attribute table.
Parameters

Input layer [vector: any] <put parameter description here>


Weight field [tablefield: numeric] Optional.
Field to use if you want to perform a weighted mean.
Unique ID field [tablefield: numeric] Optional.
Unique field on which the calculation of the mean will be made.
Outputs

Result [vector] The resulting points layer.


Console usage
processing.runalg(qgis:meancoordinates, points, weight, uid, output)

See also

Nearest neighbour analysis


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Outputs

Result [html] <put output description here>


Observed mean distance [number] <put output description here>
Expected mean distance [number] <put output description here>
Nearest neighbour index [number] <put output description here>

386

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Number of points [number] <put output description here>


Z-Score [number] <put output description here>
Console usage
processing.runalg(qgis:nearestneighbouranalysis, points, output)

See also

Sum line lengths


Description

<put algortithm description here>


Parameters

Lines [vector: line] <put parameter description here>


Polygons [vector: polygon] <put parameter description here>
Lines length field name [string] <put parameter description here>
Default: LENGTH
Lines count field name [string] <put parameter description here>
Default: COUNT
Outputs

Result [vector] <put output description here>


Console usage
processing.runalg(qgis:sumlinelengths, lines, polygons, len_field, count_field, output)

See also

18.5.6 Vector creation


Create grid
Description

Creates a grid.

18.5. QGIS algorithm provider

387

QGIS User Guide, Release 2.6

Parameters

Grid type [selection] Grid type.


Options:
0 Rectangle (line)
1 Rectangle (polygon)
2 Diamond (polygon)
3 Hexagon (polygon)
Default: 0
Width [number] Horizontal extent of the grid.
Default: 360.0
Height [number] Vertical extent of the grid.
Default: 180.0
Horizontal spacing [number] X-axes spacing between the lines.
Default: 10.0
Vertical spacing [number] Y-axes spacing between the lines.
Default: 10.0
Center X [number] X-coordinate of the grid center.
Default: 0.0
Center Y [number] Y-coordinate of the grid center.
Default: 0.0
Output CRS [crs] Coordinate reference system for grid.
Default: EPSG:4326
Outputs

Output [vector] The resulting grid layer (lines or polygons).


Console usage

processing.runalg(qgis:creategrid, type, width, height, hspacing, vspacing, centerx, centery, cr

See also

Points layer from table


Description

Creates points layer from geometryless table with columns that contain point coordinates.

388

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input layer [table] Input table


X field [tablefield: any] Table column containing the X coordinate.
Y field [tablefield: any] Table column containing the Y coordinate.
Target CRS [crs] Coordinate reference system to use for layer.
Default: EPSG:4326
Outputs

Output layer [vector] The resulting layer.


Console usage
processing.runalg(qgis:pointslayerfromtable, input, xfield, yfield, target_crs, output)

See also

Points to path
Description

<put algortithm description here>


Parameters

Input point layer [vector: point] <put parameter description here>


Group field [tablefield: any] <put parameter description here>
Order field [tablefield: any] <put parameter description here>
Date format (if order field is DateTime) [string] Optional.
<put parameter description here>
Default: (not set)
Outputs

Paths [vector] <put output description here>


Directory [directory] <put output description here>
Console usage

processing.runalg(qgis:pointstopath, vector, group_field, order_field, date_format, output_lines

18.5. QGIS algorithm provider

389

QGIS User Guide, Release 2.6

See also

Random points along line


Description

<put algortithm description here>


Parameters

Input layer [vector: line] <put parameter description here>


Number of points [number] <put parameter description here>
Default: 1
Minimum distance [number] <put parameter description here>
Default: 0.0
Outputs

Random points [vector] <put output description here>


Console usage
processing.runalg(qgis:randompointsalongline, vector, point_number, min_distance, output)

See also

Random points in extent


Description

<put algortithm description here>


Parameters

Input extent [extent] <put parameter description here>


Default: 0,1,0,1
Points number [number] <put parameter description here>
Default: 1
Minimum distance [number] <put parameter description here>
Default: 0.0
Outputs

Random points [vector] <put output description here>

390

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(qgis:randompointsinextent, extent, point_number, min_distance, output)

See also

Random points in layer bounds


Description

<put algortithm description here>


Parameters

Input layer [vector: polygon] <put parameter description here>


Points number [number] <put parameter description here>
Default: 1
Minimum distance [number] <put parameter description here>
Default: 0.0
Outputs

Random points [vector] <put output description here>


Console usage
processing.runalg(qgis:randompointsinlayerbounds, vector, point_number, min_distance, output)

See also

Random points inside polygons (fixed)


Description

<put algortithm description here>


Parameters

Input layer [vector: polygon] <put parameter description here>


Sampling strategy [selection] <put parameter description here>
Options:
0 Points count
1 Points density
Default: 0

18.5. QGIS algorithm provider

391

QGIS User Guide, Release 2.6

Number or density of points [number] <put parameter description here>


Default: 1.0
Minimum distance [number] <put parameter description here>
Default: 0.0
Outputs

Random points [vector] <put output description here>


Console usage

processing.runalg(qgis:randompointsinsidepolygonsfixed, vector, strategy, value, min_distance, o

See also

Random points inside polygons (variable)


Description

<put algortithm description here>


Parameters

Input layer [vector: polygon] <put parameter description here>


Sampling strategy [selection] <put parameter description here>
Options:
0 Points count
1 Points density
Default: 0
Number field [tablefield: numeric] <put parameter description here>
Minimum distance [number] <put parameter description here>
Default: 0.0
Outputs

Random points [vector] <put output description here>


Console usage

processing.runalg(qgis:randompointsinsidepolygonsvariable, vector, strategy, field, min_distance

392

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Regular points
Description

<put algortithm description here>


Parameters

Input extent [extent] <put parameter description here>


Default: 0,1,0,1
Point spacing/count [number] <put parameter description here>
Default: 0.0001
Initial inset from corner (LH side) [number] <put parameter description here>
Default: 0.0
Apply random offset to point spacing [boolean] <put parameter description here>
Default: False
Use point spacing [boolean] <put parameter description here>
Default: True
Outputs

Regular points [vector] <put output description here>


Console usage
processing.runalg(qgis:regularpoints, extent, spacing, inset, randomize, is_spacing, output)

See also

Vector grid
Description

<put algortithm description here>


Parameters

Grid extent [extent] <put parameter description here>


Default: 0,1,0,1
X spacing [number] <put parameter description here>
Default: 0.0001
Y spacing [number] <put parameter description here>
Default: 0.0001

18.5. QGIS algorithm provider

393

QGIS User Guide, Release 2.6

Grid type [selection] <put parameter description here>


Options:
0 Output grid as polygons
1 Output grid as lines
Default: 0
Outputs

Grid [vector] <put output description here>


Console usage
processing.runalg(qgis:vectorgrid, extent, step_x, step_y, type, output)

See also

18.5.7 Vector general


Delete duplicate geometries
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:deleteduplicategeometries, input, output)

See also

Join atributes by location


Description

<put algortithm description here>

394

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Target vector layer [vector: any] <put parameter description here>


Join vector layer [vector: any] <put parameter description here>
Attribute summary [selection] <put parameter description here>
Options:
0 Take attributes of the first located feature
1 Take summary of intersecting features
Default: 0
Statistics for summary (comma separated) [string] <put parameter description here>
Default: sum,mean,min,max,median
Output table [selection] <put parameter description here>
Options:
0 Only keep matching records
1 Keep all records (including non-matching target records)
Default: 0
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:joinatributesbylocation, target, join, summary, stats, keep, output)

See also

Join attributes table


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Input layer 2 [table] <put parameter description here>
Table field [tablefield: any] <put parameter description here>
Table field 2 [tablefield: any] <put parameter description here>
Outputs

Output layer [vector] <put output description here>

18.5. QGIS algorithm provider

395

QGIS User Guide, Release 2.6

Console usage

processing.runalg(qgis:joinattributestable, input_layer, input_layer_2, table_field, table_field

See also

Merge vector layers


Description

<put algortithm description here>


Parameters

Input layer 1 [vector: any] <put parameter description here>


Input layer 2 [vector: any] <put parameter description here>
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:mergevectorlayers, layer1, layer2, output)

See also

Polygon from layer extent


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Calculate extent for each feature separately [boolean] <put parameter description here>
Default: False
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:polygonfromlayerextent, input_layer, by_feature, output)

396

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Reproject layer
Description

Reprojects a vector layer in a different CRS.


Parameters

Input layer [vector: any] Layer to reproject.


Target CRS [crs] Destination coordinate reference system.
Default: EPSG:4326
Outputs

Reprojected layer [vector] The resulting layer.


Console usage
processing.runalg(qgis:reprojectlayer, input, target_crs, output)

See also

Save selected features


Description

Saves the selected features as a new layer.


Parameters

Input layer [vector: any] Layer to process.


Outputs

Output layer with selected features [vector] The resulting layer.


Console usage
processing.runalg(qgis:saveselectedfeatures, input_layer, output_layer)

18.5. QGIS algorithm provider

397

QGIS User Guide, Release 2.6

See also

Set style for vector layer


Description

<put algortithm description here>


Parameters

Vector layer [vector: any] <put parameter description here>


Style file [file] <put parameter description here>
Outputs

Styled layer [vector] <put output description here>


Console usage
processing.runalg(qgis:setstyleforvectorlayer, input, style)

See also

Snap points to grid


Description

<put algortithm description here>


Parameters

Input Layer [vector: any] <put parameter description here>


Horizontal spacing [number] <put parameter description here>
Default: 0.1
Vertical spacing [number] <put parameter description here>
Default: 0.1
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:snappointstogrid, input, hspacing, vspacing, output)

398

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Split vector layer


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Unique ID field [tablefield: any] <put parameter description here>
Outputs

Output directory [directory] <put output description here>


Console usage
processing.runalg(qgis:splitvectorlayer, input, field, output)

See also

18.5.8 Vector geometry


Concave hull
Description

<put algortithm description here>


Parameters

Input point layer [vector: point] <put parameter description here>


Threshold (0-1, where 1 is equivalent with Convex Hull) [number] <put
description here>

parameter

Default: 0.3
Allow holes [boolean] <put parameter description here>
Default: True
Split multipart geometry into singleparts geometries [boolean] <put
scription here>

parameter

de-

Default: False

18.5. QGIS algorithm provider

399

QGIS User Guide, Release 2.6

Outputs

Concave hull [vector] <put output description here>


Console usage
processing.runalg(qgis:concavehull, input, alpha, holes, no_multigeometry, output)

See also

Convert geometry type


Description

Converts a geometry type to another one.


Parameters

Input layer [vector: any] Layer in input.


New geometry type [selection] Type of conversion to perform.
Options:
0 Centroids
1 Nodes
2 Linestrings
3 Multilinestrings
4 Polygons
Default: 0
Outputs

Output [vector] The resulting layer.


Console usage
processing.runalg(qgis:convertgeometrytype, input, type, output)

See also

Convex hull
Description

<put algortithm description here>

400

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input layer [vector: any] <put parameter description here>


Field (optional, only used if creating convex hulls by classes) [tablefield: any]
Optional.
<put parameter description here>
Method [selection] <put parameter description here>
Options:
0 Create single minimum convex hull
1 Create convex hulls based on field
Default: 0
Outputs

Convex hull [vector] <put output description here>


Console usage
processing.runalg(qgis:convexhull, input, field, method, output)

See also

Create points along lines


Description

<put algortithm description here>


Parameters

lines [vector: any] <put parameter description here>


distance [number] <put parameter description here>
Default: 1
startpoint [number] <put parameter description here>
Default: 0
endpoint [number] <put parameter description here>
Default: 0
Outputs

output [vector] <put output description here>

18.5. QGIS algorithm provider

401

QGIS User Guide, Release 2.6

Console usage
processing.runalg(qgis:createpointsalonglines, lines, distance, startpoint, endpoint, output)

See also

Delaunay triangulation
Description

<put algortithm description here>


Parameters

Input layer [vector: point] <put parameter description here>


Outputs

Delaunay triangulation [vector] <put output description here>


Console usage
processing.runalg(qgis:delaunaytriangulation, input, output)

See also

Densify geometries given an interval


Description

<put algortithm description here>


Parameters

Input layer [vector: polygon, line] <put parameter description here>


Interval between Vertices to add [number] <put parameter description here>
Default: 1.0
Outputs

Densified layer [vector] <put output description here>


Console usage
processing.runalg(qgis:densifygeometriesgivenaninterval, input, interval, output)

402

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Densify geometries
Description

<put algortithm description here>


Parameters

Input layer [vector: polygon, line] <put parameter description here>


Vertices to add [number] <put parameter description here>
Default: 1
Outputs

Densified layer [vector] <put output description here>


Console usage
processing.runalg(qgis:densifygeometries, input, vertices, output)

See also

Dissolve
Description

<put algortithm description here>


Parameters

Input layer [vector: polygon, line] <put parameter description here>


Dissolve all (do not use field) [boolean] <put parameter description here>
Default: True
Unique ID field [tablefield: any] Optional.
<put parameter description here>
Outputs

Dissolved [vector] <put output description here>


Console usage
processing.runalg(qgis:dissolve, input, dissolve_all, field, output)

18.5. QGIS algorithm provider

403

QGIS User Guide, Release 2.6

See also

Eliminate sliver polygons


Description

<put algortithm description here>


Parameters

Input layer [vector: polygon] <put parameter description here>


Use current selection in input layer (works only if called from toolbox) [boolean]
<put parameter description here>
Default: False
Selection attribute [tablefield: any] <put parameter description here>
Comparison [selection] <put parameter description here>
Options:
0 ==
1 !=
2>
3 >=
4<
5 <=
6 begins with
7 contains
Default: 0
Value [string] <put parameter description here>
Default: 0
Merge selection with the neighbouring polygon with the [selection] <put parameter description here>
Options:
0 Largest area
1 Smallest Area
2 Largest common boundary
Default: 0
Outputs

Cleaned layer [vector] <put output description here>

404

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(qgis:eliminatesliverpolygons, input, keepselection, attribute, comparison, com

See also

Explode lines
Description

<put algortithm description here>


Parameters

Input layer [vector: line] <put parameter description here>


Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:explodelines, input, output)

See also

Extract nodes
Description

<put algortithm description here>


Parameters

Input layer [vector: polygon, line] <put parameter description here>


Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:extractnodes, input, output)

18.5. QGIS algorithm provider

405

QGIS User Guide, Release 2.6

See also

Fill holes
Description

<put algortithm description here>


Parameters

Polygons [vector: any] <put parameter description here>


Max area [number] <put parameter description here>
Default: 100000
Outputs

Results [vector] <put output description here>


Console usage
processing.runalg(qgis:fillholes, polygons, max_area, results)

See also

Fixed distance buffer


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Distance [number] <put parameter description here>
Default: 10.0
Segments [number] <put parameter description here>
Default: 5
Dissolve result [boolean] <put parameter description here>
Default: False
Outputs

Buffer [vector] <put output description here>

406

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(qgis:fixeddistancebuffer, input, distance, segments, dissolve, output)

See also

Keep n biggest parts


Description

<put algortithm description here>


Parameters

Polygons [vector: polygon] <put parameter description here>


To keep [number] <put parameter description here>
Default: 1
Outputs

Results [vector] <put output description here>


Console usage
processing.runalg(qgis:keepnbiggestparts, polygons, to_keep, results)

See also

Lines to polygons
Description

<put algortithm description here>


Parameters

Input layer [vector: line] <put parameter description here>


Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:linestopolygons, input, output)

18.5. QGIS algorithm provider

407

QGIS User Guide, Release 2.6

See also

Multipart to singleparts
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:multiparttosingleparts, input, output)

See also

Points displacement
Description

Moves overlapped points at small distance, that they all become visible. The result is very similar to the output of
the Point displacement renderer but it is permanent.
Parameters

Input layer [vector: point] Layer with overlapped points.


Displacement distance [number] Desired displacement distance NOTE: displacement distance should
be in same units as layer.
Default: 0.00015
Horizontal distribution for two point case [boolean] Controls distrobution direction in case
of two overlapped points. If True points wwill be distributed horizontally, otherwise they will be distributed
vertically.
Default: True
Outputs

Output layer [vector] The resulting layer with shifted overlapped points.
Console usage
processing.runalg(qgis:pointsdisplacement, input_layer, distance, horizontal, output_layer)

408

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Polygon centroids
Description

<put algortithm description here>


Parameters

Input layer [vector: polygon] <put parameter description here>


Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:polygoncentroids, input_layer, output_layer)

See also

Polygonize
Description

<put algortithm description here>


Parameters

Input layer [vector: line] <put parameter description here>


Keep table structure of line layer [boolean] <put parameter description here>
Default: False
Create geometry columns [boolean] <put parameter description here>
Default: True
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:polygonize, input, fields, geometry, output)

18.5. QGIS algorithm provider

409

QGIS User Guide, Release 2.6

See also

Polygons to lines
Description

<put algortithm description here>


Parameters

Input layer [vector: polygon] <put parameter description here>


Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:polygonstolines, input, output)

See also

Simplify geometries
Description

<put algortithm description here>


Parameters

Input layer [vector: polygon, line] <put parameter description here>


Tolerance [number] <put parameter description here>
Default: 1.0
Outputs

Simplified layer [vector] <put output description here>


Console usage
processing.runalg(qgis:simplifygeometries, input, tolerance, output)

410

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Singleparts to multipart
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Unique ID field [tablefield: any] <put parameter description here>
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:singlepartstomultipart, input, field, output)

See also

Variable distance buffer


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Distance field [tablefield: any] <put parameter description here>
Segments [number] <put parameter description here>
Default: 5
Dissolve result [boolean] <put parameter description here>
Default: False
Outputs

Buffer [vector] <put output description here>


Console usage
processing.runalg(qgis:variabledistancebuffer, input, field, segments, dissolve, output)

18.5. QGIS algorithm provider

411

QGIS User Guide, Release 2.6

See also

Voronoi polygons
Description

<put algortithm description here>


Parameters

Input layer [vector: point] <put parameter description here>


Buffer region [number] <put parameter description here>
Default: 0.0
Outputs

Voronoi polygons [vector] <put output description here>


Console usage
processing.runalg(qgis:voronoipolygons, input, buffer, output)

See also

18.5.9 Vector overlay


Clip
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Clip layer [vector: any] <put parameter description here>
Outputs

Clipped [vector] <put output description here>


Console usage
processing.runalg(qgis:clip, input, overlay, output)

412

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Difference
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Difference layer [vector: any] <put parameter description here>
Outputs

Difference [vector] <put output description here>


Console usage
processing.runalg(qgis:difference, input, overlay, output)

See also

Intersection
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Intersect layer [vector: any] <put parameter description here>
Outputs

Intersection [vector] <put output description here>


Console usage
processing.runalg(qgis:intersection, input, input2, output)

18.5. QGIS algorithm provider

413

QGIS User Guide, Release 2.6

See also

Line intersections
Description

<put algortithm description here>


Parameters

Input layer [vector: line] <put parameter description here>


Intersect layer [vector: line] <put parameter description here>
Input unique ID field [tablefield: any] <put parameter description here>
Intersect unique ID field [tablefield: any] <put parameter description here>
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:lineintersections, input_a, input_b, field_a, field_b, output)

See also

Symetrical difference
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Difference layer [vector: any] <put parameter description here>
Outputs

Symetrical difference [vector] <put output description here>


Console usage
processing.runalg(qgis:symetricaldifference, input, overlay, output)

414

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Union
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Input layer 2 [vector: any] <put parameter description here>
Outputs

Union [vector] <put output description here>


Console usage
processing.runalg(qgis:union, input, input2, output)

See also

18.5.10 Vector selection


Extract by attribute
Description

<put algortithm description here>


Parameters

Input Layer [vector: any] <put parameter description here>


Selection attribute [tablefield: any] <put parameter description here>
Operator [selection] <put parameter description here>
Options:
0=
1 !=
2>
3 >=
4<
5 <=
6 begins with
18.5. QGIS algorithm provider

415

QGIS User Guide, Release 2.6

7 contains
Default: 0
Value [string] <put parameter description here>
Default: (not set)
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:extractbyattribute, input, field, operator, value, output)

See also

Extract by location
Description

<put algortithm description here>


Parameters

Layer to select from [vector: any] <put parameter description here>


Additional layer (intersection layer) [vector: any] <put parameter description here>
Include input features that touch the selection features [boolean] <put
description here>

parameter

Default: False
Include input features that overlap/cross the selection features [boolean] <put
parameter description here>
Default: False
Include input features completely within the selection features [boolean] <put
parameter description here>
Default: False
Outputs

Selection [vector] <put output description here>


Console usage
processing.runalg(qgis:extractbylocation, input, intersect, touches, overlaps, within, output)

416

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Random extract
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 Number of selected features
1 Percentage of selected features
Default: 0
Number/percentage of selected features [number] <put parameter description here>
Default: 10
Outputs

Selection [vector] <put output description here>


Console usage
processing.runalg(qgis:randomextract, input, method, number, output)

See also

Random extract within subsets


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


ID Field [tablefield: any] <put parameter description here>
Method [selection] <put parameter description here>
Options:
0 Number of selected features
1 Percentage of selected features
Default: 0

18.5. QGIS algorithm provider

417

QGIS User Guide, Release 2.6

Number/percentage of selected features [number] <put parameter description here>


Default: 10
Outputs

Selection [vector] <put output description here>


Console usage
processing.runalg(qgis:randomextractwithinsubsets, input, field, method, number, output)

See also

Random selection
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 Number of selected features
1 Percentage of selected features
Default: 0
Number/percentage of selected features [number] <put parameter description here>
Default: 10
Outputs

Selection [vector] <put output description here>


Console usage
processing.runalg(qgis:randomselection, input, method, number)

See also

Random selection within subsets


Description

<put algortithm description here>

418

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input layer [vector: any] <put parameter description here>


ID Field [tablefield: any] <put parameter description here>
Method [selection] <put parameter description here>
Options:
0 Number of selected features
1 Percentage of selected features
Default: 0
Number/percentage of selected features [number] <put parameter description here>
Default: 10
Outputs

Selection [vector] <put output description here>


Console usage
processing.runalg(qgis:randomselectionwithinsubsets, input, field, method, number)

See also

Select by attribute
Description

Selects and saves as new layer all features from input layer that satisfy condition.
NOTE: algorithm is case-sensitive (qgis is different from Qgis and QGIS)
Parameters

Input Layer [vector: any] Layer to process.


Selection attribute [tablefield: any] Field on which perform the selection.
Operator [selection] Comparison operator.
Options:
0=
1 !=
2>
3 >=
4<
5 <=
6 begins with
7 contains

18.5. QGIS algorithm provider

419

QGIS User Guide, Release 2.6

Default: 0
Value [string] Value to compare.
Default: (not set)
Outputs

Output [vector] The resulting layer.


Console usage
processing.runalg(qgis:selectbyattribute, input, field, operator, value, output)

See also

Select by expression
Description

<put algortithm description here>


Parameters

Input Layer [vector: any] <put parameter description here>


Expression [string] <put parameter description here>
Default: (not set)
Modify current selection by [selection] <put parameter description here>
Options:
0 creating new selection
1 adding to current selection
2 removing from current selection
Default: 0
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:selectbyexpression, layername, expression, method)

420

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Select by location
Description

<put algortithm description here>


Parameters

Layer to select from [vector: any] <put parameter description here>


Additional layer (intersection layer) [vector: any] <put parameter description here>
Include input features that touch the selection features [boolean] <put
description here>

parameter

Default: False
Include input features that overlap/cross the selection features [boolean] <put
parameter description here>
Default: False
Include input features completely within the selection features [boolean] <put
parameter description here>
Default: False
Modify current selection by [selection] <put parameter description here>
Options:
0 creating new selection
1 adding to current selection
2 removing from current selection
Default: 0
Outputs

Selection [vector] <put output description here>


Console usage
processing.runalg(qgis:selectbylocation, input, intersect, touches, overlaps, within, method)

See also

18.5. QGIS algorithm provider

421

QGIS User Guide, Release 2.6

18.5.11 Vector table


Add autoincremental field
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:addautoincrementalfield, input, output)

See also

Add field to attributes table


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Field name [string] <put parameter description here>
Default: (not set)
Field type [selection] <put parameter description here>
Options:
0 Integer
1 Float
2 String
Default: 0
Field length [number] <put parameter description here>
Default: 10
Field precision [number] <put parameter description here>
Default: 0

422

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Output layer [vector] <put output description here>


Console usage

processing.runalg(qgis:addfieldtoattributestable, input_layer, field_name, field_type, field_len

See also

Advanced Python field calculator


Description

<put algorithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Result field name [string] <put parameter description here>
Default: NewField
Field type [selection] <put parameter description here>
Options:
0 Integer
1 Float
2 String
Default: 0
Field length [number] <put parameter description here>
Default: 10
Field precision [number] <put parameter description here>
Default: 0
Global expression [string] Optional.
<put parameter description here>
Default: (not set)
Formula [string] <put parameter description here>
Default: value =
Outputs

Output layer [vector] <put output description here>

18.5. QGIS algorithm provider

423

QGIS User Guide, Release 2.6

Console usage

processing.runalg(qgis:advancedpythonfieldcalculator, input_layer, field_name, field_type, field

See also

Basic statistics for numeric fields


Description

<put algortithm description here>


Parameters

Input vector layer [vector: any] <put parameter description here>


Field to calculate statistics on [tablefield: numeric] <put parameter description here>
Outputs

Statistics for numeric field [html] <put output description here>


Coefficient of Variation [number] <put output description here>
Minimum value [number] <put output description here>
Maximum value [number] <put output description here>
Sum [number] <put output description here>
Mean value [number] <put output description here>
Count [number] <put output description here>
Range [number] <put output description here>
Median [number] <put output description here>
Number of unique values [number] <put output description here>
Standard deviation [number] <put output description here>
Console usage

processing.runalg(qgis:basicstatisticsfornumericfields, input_layer, field_name, output_html_fil

See also

Basic statistics for text fields


Description

<put algortithm description here>

424

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input vector layer [vector: any] <put parameter description here>


Field to calculate statistics on [tablefield: string] <put parameter description here>
Outputs

Statistics for text field [html] <put output description here>


Minimum length [number] <put output description here>
Maximum length [number] <put output description here>
Mean length [number] <put output description here>
Count [number] <put output description here>
Number of empty values [number] <put output description here>
Number of non-empty values [number] <put output description here>
Number of unique values [number] <put output description here>
Console usage
processing.runalg(qgis:basicstatisticsfortextfields, input_layer, field_name, output_html_file)

See also

Create equivalent numerical field


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Class field [tablefield: any] <put parameter description here>
Outputs

Output layer [vector] <put output description here>


Console usage
processing.runalg(qgis:createequivalentnumericalfield, input, field, output)

18.5. QGIS algorithm provider

425

QGIS User Guide, Release 2.6

See also

Delete column
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Field to delete [tablefield: any] <put parameter description here>
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:deletecolumn, input, column, output)

See also

Export/Add geometry columns


Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Calculate using [selection] <put parameter description here>
Options:
0 Layer CRS
1 Project CRS
2 Ellipsoidal
Default: 0
Outputs

Output layer [vector] <put output description here>


Console usage

426

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

processing.runalg(qgis:exportaddgeometrycolumns, input, calc_method, output)

See also

Field calculator
Description

<put algortithm description here>


Parameters

Input layer [vector: any] <put parameter description here>


Result field name [string] <put parameter description here>
Default: (not set)
Field type [selection] <put parameter description here>
Options:
0 Float
1 Integer
2 String
3 Date
Default: 0
Field length [number] <put parameter description here>
Default: 10
Field precision [number] <put parameter description here>
Default: 3
Create new field [boolean] <put parameter description here>
Default: True
Formula [string] <put parameter description here>
Default: (not set)
Outputs

Output layer [vector] <put output description here>


Console usage

processing.runalg(qgis:fieldcalculator, input_layer, field_name, field_type, field_length, field

18.5. QGIS algorithm provider

427

QGIS User Guide, Release 2.6

See also

List unique values


Description

Lists unique values of an attribute table field and counts their number.
Parameters

Input layer [vector: any] Layer to analyze.


Target field [tablefield: any] Field to analyze.
Outputs

Unique values [html] Analysis results in HTML format.


Total unique values [number] Total number of unique values in given field.
Unique values [string] List of all unique values in given field.
Console usage
processing.runalg(qgis:listuniquevalues, input_layer, field_name, output)

See also

Number of unique values in classes


Description

<put algortithm description here>


Parameters

input [vector: any] <put parameter description here>


class field [tablefield: any] <put parameter description here>
value field [tablefield: any] <put parameter description here>
Outputs

output [vector] <put output description here>


Console usage
processing.runalg(qgis:numberofuniquevaluesinclasses, input, class_field, value_field, output)

428

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Statistics by categories
Description

<put algortithm description here>


Parameters

Input vector layer [vector: any] <put parameter description here>


Field to calculate statistics on [tablefield: numeric] <put parameter description here>
Field with categories [tablefield: any] <put parameter description here>
Outputs

Statistics [table] <put output description here>


Console usage

processing.runalg(qgis:statisticsbycategories, input_layer, values_field_name, categories_field_

See also

Text to float
Description

<put algortithm description here>


Parameters

Input Layer [vector: any] <put parameter description here>


Text attribute to convert to float [tablefield: string] <put parameter description here>
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(qgis:texttofloat, input, field, output)

See also

18.5. QGIS algorithm provider

429

QGIS User Guide, Release 2.6

18.6 R algorithm provider


R also called GNU S, is a strongly functional language and environment to statistically explore data sets, make
many graphical displays of data from custom data sets
Bemerkung: Please remember that Processing contains only R scripts, so you need to install R by yourself and
configure Processing properly.
.

18.6.1 Basic statistics


Frequency table
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Field [tablefield: any] <put parameter description here>
Outputs

R Console Output [html] <put output description here>


Console usage
processing.runalg(r:frequencytable, layer, field, r_console_output)

See also

Kolmogrov-Smirnov test
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Field [tablefield: any] <put parameter description here>
Outputs

R Console Output [html] <put output description here>

430

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(r:kolmogrovsmirnovtest, layer, field, r_console_output)

See also

Summary statistics
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Field [tablefield: any] <put parameter description here>
Outputs

R Console Output [html] <put output description here>


Console usage
processing.runalg(r:summarystatistics, layer, field, r_console_output)

See also

18.6.2 Home range


Characteristic hull method
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Field [tablefield: any] <put parameter description here>
Outputs

Home_ranges [vector] <put output description here>

18.6. R algorithm provider

431

QGIS User Guide, Release 2.6

Console usage
processing.runalg(r:characteristichullmethod, layer, field, home_ranges)

See also

Kernel h ref
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Field [tablefield: any] <put parameter description here>
Grid [number] <put parameter description here>
Default: 10.0
Percentage [number] <put parameter description here>
Default: 10.0
Folder [directory] Optional.
<put parameter description here>
Outputs

Home_ranges [vector] <put output description here>


Console usage
processing.runalg(r:kernelhref, layer, field, grid, percentage, folder, home_ranges)

See also

Minimum convex polygon


Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Percentage [number] <put parameter description here>
Default: 10.0
Field [tablefield: any] <put parameter description here>

432

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Home_ranges [vector] <put output description here>


Console usage
processing.runalg(r:minimumconvexpolygon, layer, percentage, field, home_ranges)

See also

Single-linkage cluster analysis


Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Field [tablefield: any] <put parameter description here>
Percentage [number] <put parameter description here>
Default: 10.0
Outputs

R Plots [html] <put output description here>


Home_ranges [vector] <put output description here>
Console usage

processing.runalg(r:singlelinkageclusteranalysis, layer, field, percentage, rplots, home_ranges)

See also

18.6.3 Point pattern


F function
Description

<put algortithm description here>

18.6. R algorithm provider

433

QGIS User Guide, Release 2.6

Parameters

Layer [vector: any] <put parameter description here>


Nsim [number] <put parameter description here>
Default: 10.0
Outputs

R Plots [html] <put output description here>


Console usage
processing.runalg(r:ffunction, layer, nsim, rplots)

See also

G function
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Nsim [number] <put parameter description here>
Default: 10.0
Outputs

R Plots [html] <put output description here>


Console usage
processing.runalg(r:gfunction, layer, nsim, rplots)

See also

Monte-Carlo spatial randomness


Description

<put algortithm description here>

434

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Layer [vector: any] <put parameter description here>


Simulations [number] <put parameter description here>
Default: 100.0
Optional plot name [string] <put parameter description here>
Default: (not set)
Outputs

R Plots [html] <put output description here>


R Console Output [html] <put output description here>
Console usage

processing.runalg(r:montecarlospatialrandomness, layer, simulations, optional_plot_name, rplots,

See also

Quadrat analysis
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Outputs

R Plots [html] <put output description here>


R Console Output [html] <put output description here>
Console usage
processing.runalg(r:quadratanalysis, layer, rplots, r_console_output)

See also

Random sampling grid


Description

<put algortithm description here>

18.6. R algorithm provider

435

QGIS User Guide, Release 2.6

Parameters

Layer [vector: any] <put parameter description here>


Size [number] <put parameter description here>
Default: 10.0
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(r:randomsamplinggrid, layer, size, output)

See also

Regular sampling grid


Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Size [number] <put parameter description here>
Default: 10.0
Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(r:regularsamplinggrid, layer, size, output)

See also

Relative distribution (distance covariate)


Description

<put algortithm description here>

436

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Layer [vector: any] <put parameter description here>


Covariate [vector: any] <put parameter description here>
Covariate name [string] <put parameter description here>
Default: mandatory_covariate_name_(no_spaces)
x label [string] <put parameter description here>
Default: (not set)
Plot name [string] <put parameter description here>
Default: (not set)
Legend position [string] <put parameter description here>
Default: float
Outputs

R Plots [html] <put output description here>


Console usage

processing.runalg(r:relativedistributiondistancecovariate, layer, covariate, covariate_name, x_l

See also

Relative distribution (raster covariate)


Description

<put algortithm description here>


Parameters

points [vector: any] <put parameter description here>


covariate [raster] <put parameter description here>
covariate name [string] <put parameter description here>
Default: mandatory_covariate_name_(no_spaces)
x label [string] <put parameter description here>
Default: (not set)
plot name [string] <put parameter description here>
Default: (not set)
legend position [string] <put parameter description here>
Default: float

18.6. R algorithm provider

437

QGIS User Guide, Release 2.6

Outputs

R Plots [html] <put output description here>


Console usage

processing.runalg(r:relativedistributionrastercovariate, points, covariate, covariate_name, x_la

See also

Ripley - Rasson spatial domain


Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Outputs

Output [vector] <put output description here>


Console usage
processing.runalg(r:ripleyrassonspatialdomain, layer, output)

See also

18.6.4 Raster processing


Advanced raster histogram
Description

<put algortithm description here>


Parameters

Layer [raster] <put parameter description here>


Dens or Hist [string] <put parameter description here>
Default: Hist

438

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

R Plots [html] <put output description here>


Console usage
processing.runalg(r:advancedrasterhistogram, layer, dens_or_hist, rplots)

See also

Raster histogram
Description

<put algortithm description here>


Parameters

Layer [raster] <put parameter description here>


Outputs

R Plots [html] <put output description here>


Console usage
processing.runalg(r:rasterhistogram, layer, rplots)

See also

18.6.5 Vector processing


Histogram
Description

<put algortithm description here>


Parameters

Layer [vector: any] <put parameter description here>


Field [tablefield: any] <put parameter description here>
Outputs

R Plots [html] <put output description here>


18.6. R algorithm provider

439

QGIS User Guide, Release 2.6

Console usage
processing.runalg(r:histogram, layer, field, rplots)

See also

18.7 SAGA algorithm provider


SAGA (System for Automated Geoscientific Analyses) is a free, hybrid, cross-platform GIS software. SAGA
provides many geoscientific methods which are bundled in so-called module libraries.
Bemerkung: Please remember that Processing contains only the interface description, so you need to install
SAGA by yourself and configure Processing properly.
.

18.7.1 Geostatistics
Directional statistics for single grid
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Points [vector: any] Optional.
<put parameter description here>
Direction [Degree] [number] <put parameter description here>
Default: 0.0
Tolerance [Degree] [number] <put parameter description here>
Default: 0.0
Maximum Distance [Cells] [number] <put parameter description here>
Default: 0
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0

440

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Inverse Distance Weighting Power [number] <put parameter description here>


Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1.0
Outputs

Arithmetic Mean [raster] <put output description here>


Difference from Arithmetic Mean [raster] <put output description here>
Minimum [raster] <put output description here>
Maximum [raster] <put output description here>
Range [raster] <put output description here>
Variance [raster] <put output description here>
Standard Deviation [raster] <put output description here>
Mean less Standard Deviation [raster] <put output description here>
Mean plus Standard Deviation [raster] <put output description here>
Deviation from Arithmetic Mean [raster] <put output description here>
Percentile [raster] <put output description here>
Directional Statistics for Points [vector] <put output description here>
Console usage

processing.runalg(saga:directionalstatisticsforsinglegrid, grid, points, direction, tolerance, m

See also

Fast representativeness
Description

<put algortithm description here>


Parameters

Input [raster] <put parameter description here>


Level of Generalisation [number] <put parameter description here>
Default: 16

18.7. SAGA algorithm provider

441

QGIS User Guide, Release 2.6

Outputs

Output [raster] <put output description here>


Output Lod [raster] <put output description here>
Output Seeds [raster] <put output description here>
Console usage
processing.runalg(saga:fastrepresentativeness, input, lod, result, result_lod, seeds)

See also

Geographically weighted multiple regression (points/grids)


Description

<put algortithm description here>


Parameters

Predictors [multipleinput: rasters] <put parameter description here>


Output of Regression Parameters [boolean] <put parameter description here>
Default: True
Points [vector: point] <put parameter description here>
Dependent Variable [tablefield: any] <put parameter description here>
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1.0
Search Range [selection] <put parameter description here>
Options:
0 [0] search radius (local)
1 [1] no search radius (global)

442

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Default: 0
Search Radius [number] <put parameter description here>
Default: 100
Search Mode [selection] <put parameter description here>
Options:
0 [0] all directions
1 [1] quadrants
Default: 0
Number of Points [selection] <put parameter description here>
Options:
0 [0] maximum number of observations
1 [1] all points
Default: 0
Maximum Number of Observations [number] <put parameter description here>
Default: 10
Minimum Number of Observations [number] <put parameter description here>
Default: 4
Outputs

Regression [raster] <put output description here>


Coefficient of Determination [raster] <put output description here>
Regression Parameters [raster] <put output description here>
Residuals [vector] <put output description here>
Console usage

processing.runalg(saga:geographicallyweightedmultipleregressionpointsgrids, predictors, paramete

See also

Geographically weighted multiple regression (points)


Description

<put algortithm description here>


Parameters

Points [vector: any] <put parameter description here>


Dependent Variable [tablefield: any] <put parameter description here>
Distance Weighting [selection] <put parameter description here>
Options:
18.7. SAGA algorithm provider

443

QGIS User Guide, Release 2.6

0 [0] no distance weighting


1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1.0
Search Range [selection] <put parameter description here>
Options:
0 [0] search radius (local)
1 [1] no search radius (global)
Default: 0
Search Radius [number] <put parameter description here>
Default: 100
Search Mode [selection] <put parameter description here>
Options:
0 [0] all directions
1 [1] quadrants
Default: 0
Number of Points [selection] <put parameter description here>
Options:
0 [0] maximum number of observations
1 [1] all points
Default: 0
Maximum Number of Observations [number] <put parameter description here>
Default: 10
Minimum Number of Observations [number] <put parameter description here>
Default: 4
Outputs

Regression [vector] <put output description here>

444

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:geographicallyweightedmultipleregressionpoints, points, dependent, distan

See also

Geographically weighted multiple regression


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Dependent Variable [tablefield: any] <put parameter description here>
Target Grids [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1
Search Range [selection] <put parameter description here>
Options:
0 [0] search radius (local)
1 [1] no search radius (global)
Default: 0
Search Radius [number] <put parameter description here>
Default: 100
Search Mode [selection] <put parameter description here>
Options:
18.7. SAGA algorithm provider

445

QGIS User Guide, Release 2.6

0 [0] all directions


1 [1] quadrants
Default: 0
Number of Points [selection] <put parameter description here>
Options:
0 [0] maximum number of observations
1 [1] all points
Default: 0
Maximum Number of Observations [number] <put parameter description here>
Default: 10
Minimum Number of Observations [number] <put parameter description here>
Default: 4
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Quality [raster] <put output description here>


Intercept [raster] <put output description here>
Quality [raster] <put output description here>
Intercept [raster] <put output description here>
Console usage

processing.runalg(saga:geographicallyweightedmultipleregression, points, dependent, target, dist

See also

Geographically weighted regression (points/grid)


Description

<put algortithm description here>


Parameters

Predictor [raster] <put parameter description here>


Points [vector: point] <put parameter description here>
Dependent Variable [tablefield: any] <put parameter description here>
Distance Weighting [selection] <put parameter description here>
Options:
446

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

0 [0] no distance weighting


1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1.0
Search Range [selection] <put parameter description here>
Options:
0 [0] search radius (local)
1 [1] no search radius (global)
Default: 0
Search Radius [number] <put parameter description here>
Default: 0
Search Mode [selection] <put parameter description here>
Options:
0 [0] all directions
1 [1] quadrants
Default: 0
Number of Points [selection] <put parameter description here>
Options:
0 [0] maximum number of observations
1 [1] all points
Default: 0
Maximum Number of Observations [number] <put parameter description here>
Default: 10
Minimum Number of Observations [number] <put parameter description here>
Default: 4
Outputs

Regression [raster] <put output description here>


Coefficient of Determination [raster] <put output description here>
Intercept [raster] <put output description here>
Slope [raster] <put output description here>
Residuals [vector] <put output description here>
18.7. SAGA algorithm provider

447

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:geographicallyweightedregressionpointsgrid, predictor, points, dependent,

See also

Geographically weighted regression


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Dependent Variable [tablefield: any] <put parameter description here>
Predictor [tablefield: any] <put parameter description here>
Target Grids [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 0
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 0.0
Search Range [selection] <put parameter description here>
Options:
0 [0] search radius (local)
1 [1] no search radius (global)
Default: 0
Search Radius [number] <put parameter description here>
Default: 100

448

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Search Mode [selection] <put parameter description here>


Options:
0 [0] all directions
1 [1] quadrants
Default: 0
Number of Points [selection] <put parameter description here>
Options:
0 [0] maximum number of observations
1 [1] all points
Default: 0
Maximum Number of Observations [number] <put parameter description here>
Default: 10
Minimum Number of Observations [number] <put parameter description here>
Default: 4
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Quality [raster] <put output description here>
Intercept [raster] <put output description here>
Slope [raster] <put output description here>
Console usage

processing.runalg(saga:geographicallyweightedregression, points, dependent, predictor, target, d

See also

Global morans i for grids


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Case of contiguity [selection] <put parameter description here>
Options:
18.7. SAGA algorithm provider

449

QGIS User Guide, Release 2.6

0 [0] Rook
1 [1] Queen
Default: 0
Outputs

Result [table] <put output description here>


Console usage
processing.runalg(saga:globalmoransiforgrids, grid, contiguity, result)

See also

Minimum distance analysis


Description

Performs a complete distance analysis of a point layer:


minimum distance of points
maximum distance of points
average distance of all the points
standard deviation of the distance
duplicated points
Parameters

Points [vector: point] Layer to analyze.


Outputs

Minimum Distance Analysis [table] The resulting table.


Console usage
processing.runalg(saga:minimumdistanceanalysis, points, table)

See also

Multi-band variation
Description

<put algortithm description here>

450

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Grids [multipleinput: rasters] <put parameter description here>


Radius [Cells] [number] <put parameter description here>
Default: 1
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1.0
Outputs

Mean Distance [raster] <put output description here>


Standard Deviation [raster] <put output description here>
Distance [raster] <put output description here>
Console usage

processing.runalg(saga:multibandvariation, bands, radius, distance_weighting_weighting, distance

See also

Multiple regression analysis (grid/grids)


Description

<put algortithm description here>


Parameters

Dependent [raster] <put parameter description here>


Grids [multipleinput: rasters] <put parameter description here>
Grid Interpolation [selection] <put parameter description here>
Options:

18.7. SAGA algorithm provider

451

QGIS User Guide, Release 2.6

0 [0] Nearest Neighbor


1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Include X Coordinate [boolean] <put parameter description here>
Default: True
Include Y Coordinate [boolean] <put parameter description here>
Default: True
Method [selection] <put parameter description here>
Options:
0 [0] include all
1 [1] forward
2 [2] backward
3 [3] stepwise
Default: 0
P in [number] <put parameter description here>
Default: 5
P out [number] <put parameter description here>
Default: 5
Outputs

Regression [raster] <put output description here>


Residuals [raster] <put output description here>
Details: Coefficients [table] <put output description here>
Details: Model [table] <put output description here>
Details: Steps [table] <put output description here>
Console usage

processing.runalg(saga:multipleregressionanalysisgridgrids, dependent, grids, interpol, coord_x,

See also

Multiple regression analysis (points/grids)


Description

<put algortithm description here>

452

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Grids [multipleinput: rasters] <put parameter description here>


Shapes [vector: any] <put parameter description here>
Attribute [tablefield: any] <put parameter description here>
Grid Interpolation [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Include X Coordinate [boolean] <put parameter description here>
Default: True
Include Y Coordinate [boolean] <put parameter description here>
Default: True
Method [selection] <put parameter description here>
Options:
0 [0] include all
1 [1] forward
2 [2] backward
3 [3] stepwise
Default: 0
P in [number] <put parameter description here>
Default: 5
P out [number] <put parameter description here>
Default: 5
Outputs

Details: Coefficients [table] <put output description here>


Details: Model [table] <put output description here>
Details: Steps [table] <put output description here>
Residuals [vector] <put output description here>
Regression [raster] <put output description here>
Console usage

processing.runalg(saga:multipleregressionanalysispointsgrids, grids, shapes, attribute, interpol

18.7. SAGA algorithm provider

453

QGIS User Guide, Release 2.6

See also

Polynomial regression
Description

<put algortithm description here>


Parameters

Points [vector: any] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Polynom [selection] <put parameter description here>
Options:
0 [0] simple planar surface
1 [1] bi-linear saddle
2 [2] quadratic surface
3 [3] cubic surface
4 [4] user defined
Default: 0
Maximum X Order [number] <put parameter description here>
Default: 4
Maximum Y Order [number] <put parameter description here>
Default: 4
Maximum Total Order [number] <put parameter description here>
Default: 4
Trend Surface [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Residuals [vector] <put output description here>


Grid [raster] <put output description here>

454

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:polynomialregression, points, attribute, polynom, xorder, yorder, torder,

See also

Radius of variance (grid)


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Standard Deviation [number] <put parameter description here>
Default: 1.0
Maximum Search Radius (cells) [number] <put parameter description here>
Default: 20
Type of Output [selection] <put parameter description here>
Options:
0 [0] Cells
1 [1] Map Units
Default: 0
Outputs

Variance Radius [raster] <put output description here>


Console usage
processing.runalg(saga:radiusofvariancegrid, input, variance, radius, output, result)

See also

Regression analysis
Description

<put algortithm description here>

18.7. SAGA algorithm provider

455

QGIS User Guide, Release 2.6

Parameters

Grid [raster] <put parameter description here>


Shapes [vector: any] <put parameter description here>
Attribute [tablefield: any] <put parameter description here>
Grid Interpolation [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Regression Function [selection] <put parameter description here>
Options:
0 [0] Y = a + b * X (linear)
1 [1] Y = a + b / X
2 [2] Y = a / (b - X)
3 [3] Y = a * X^b (power)
4 [4] Y = a e^(b * X) (exponential)
5 [5] Y = a + b * ln(X) (logarithmic)
Default: 0
Outputs

Regression [raster] <put output description here>


Residuals [vector] <put output description here>
Console usage

processing.runalg(saga:regressionanalysis, grid, shapes, attribute, interpol, method, regression

See also

Representativeness
Description

<put algortithm description here>

456

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Grid [raster] <put parameter description here>


Radius (Cells) [number] <put parameter description here>
Default: 10
Exponent [number] <put parameter description here>
Default: 1
Outputs

Representativeness [raster] <put output description here>


Console usage
processing.runalg(saga:representativeness, input, radius, exponent, result)

See also

Residual analysis
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Radius (Cells) [number] <put parameter description here>
Default: 7
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1.0

18.7. SAGA algorithm provider

457

QGIS User Guide, Release 2.6

Outputs

Mean Value [raster] <put output description here>


Difference from Mean Value [raster] <put output description here>
Standard Deviation [raster] <put output description here>
Value Range [raster] <put output description here>
Minimum Value [raster] <put output description here>
Maximum Value [raster] <put output description here>
Deviation from Mean Value [raster] <put output description here>
Percentile [raster] <put output description here>
Console usage

processing.runalg(saga:residualanalysis, grid, radius, distance_weighting_weighting, distance_we

See also

Spatial point pattern analysis


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Vertex Distance [Degree] [number] <put parameter description here>
Default: 5
Outputs

Mean Centre [vector] <put output description here>


Standard Distance [vector] <put output description here>
Bounding Box [vector] <put output description here>
Console usage
processing.runalg(saga:spatialpointpatternanalysis, points, step, centre, stddist, bbox)

See also

Statistics for grids


Description

<put algortithm description here>


458

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Grids [multipleinput: rasters] <put parameter description here>


Outputs

Arithmetic Mean [raster] <put output description here>


Minimum [raster] <put output description here>
Maximum [raster] <put output description here>
Variance [raster] <put output description here>
Standard Deviation [raster] <put output description here>
Mean less Standard Deviation [raster] <put output description here>
Mean plus Standard Deviation [raster] <put output description here>
Console usage

processing.runalg(saga:statisticsforgrids, grids, mean, min, max, var, stddev, stddevlo, stddevh

See also

Variogram cloud
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Maximum Distance [number] <put parameter description here>
Default: 0.0
Skip Number [number] <put parameter description here>
Default: 1
Outputs

Variogram Cloud [table] <put output description here>


Console usage
processing.runalg(saga:variogramcloud, points, field, distmax, nskip, result)

18.7. SAGA algorithm provider

459

QGIS User Guide, Release 2.6

See also

Variogram surface
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Number of Distance Classes [number] <put parameter description here>
Default: 10
Skip Number [number] <put parameter description here>
Default: 1
Outputs

Number of Pairs [raster] <put output description here>


Variogram Surface [raster] <put output description here>
Covariance Surface [raster] <put output description here>
Console usage

processing.runalg(saga:variogramsurface, points, field, distcount, nskip, count, variance, covar

See also

Zonal grid statistics


Description

<put algortithm description here>


Parameters

Zone Grid [raster] <put parameter description here>


Categorial Grids [multipleinput: rasters] Optional.
<put parameter description here>
Grids to analyse [multipleinput: rasters] Optional.
<put parameter description here>
Aspect [raster] Optional.
<put parameter description here>

460

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Short Field Names [boolean] <put parameter description here>


Default: True
Outputs

Zonal Statistics [table] <put output description here>


Console usage

processing.runalg(saga:zonalgridstatistics, zones, catlist, statlist, aspect, shortnames, outtab

See also

18.7.2 Grid analysis


Accumulated cost (anisotropic)
Description

<put algortithm description here>


Parameters

Cost Grid [raster] <put parameter description here>


Direction of max cost [raster] <put parameter description here>
Destination Points [raster] <put parameter description here>
k factor [number] <put parameter description here>
Default: 1
Threshold for different route [number] <put parameter description here>
Default: 0
Outputs

Accumulated Cost [raster] <put output description here>


Console usage

processing.runalg(saga:accumulatedcostanisotropic, cost, direction, points, k, threshold, acccos

18.7. SAGA algorithm provider

461

QGIS User Guide, Release 2.6

See also

Accumulated cost (isotropic)


Description

<put algortithm description here>


Parameters

Cost Grid [raster] <put parameter description here>


Destination Points [raster] <put parameter description here>
Threshold for different route [number] <put parameter description here>
Default: 0.0
Outputs

Accumulated Cost [raster] <put output description here>


Closest Point [raster] <put output description here>
Console usage
processing.runalg(saga:accumulatedcostisotropic, cost, points, threshold, acccost, closestpt)

See also

Aggregation index
Description

<put algortithm description here>


Parameters

Input Grid [raster] <put parameter description here>


Max. Number of Classes [number] <put parameter description here>
Default: 5
Outputs

Result [table] <put output description here>


Console usage
processing.runalg(saga:aggregationindex, input, maxnumclass, result)

462

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Analytical hierarchy process


Description

<put algortithm description here>


Parameters

Input Grids [multipleinput: rasters] <put parameter description here>


Pairwise Comparisons Table [table] <put parameter description here>
Outputs

Output Grid [raster] <put output description here>


Console usage
processing.runalg(saga:analyticalhierarchyprocess, grids, table, output)

See also

Cross-classification and tabulation


Description

<put algortithm description here>


Parameters

Input Grid 1 [raster] <put parameter description here>


Input Grid 2 [raster] <put parameter description here>
Max. Number of Classes [number] <put parameter description here>
Default: 5
Outputs

Cross-Classification Grid [raster] <put output description here>


Cross-Tabulation Table [table] <put output description here>
Console usage

processing.runalg(saga:crossclassificationandtabulation, input, input2, maxnumclass, resultgrid,

18.7. SAGA algorithm provider

463

QGIS User Guide, Release 2.6

See also

Fragmentation (alternative)
Description

<put algortithm description here>


Parameters

Classification [raster] <put parameter description here>


Class Identifier [number] <put parameter description here>
Default: 1
Neighborhood Min [number] <put parameter description here>
Default: 1
Neighborhood Max [number] <put parameter description here>
Default: 1
Level Aggregation [selection] <put parameter description here>
Options:
0 [0] average
1 [1] multiplicative
Default: 0
Add Border [boolean] <put parameter description here>
Default: True
Connectivity Weighting [number] <put parameter description here>
Default: 1.1
Minimum Density [Percent] [number] <put parameter description here>
Default: 10
Minimum Density for Interior Forest [Percent] [number] <put parameter description here>
Default: 99
Search Distance Increment [number] <put parameter description here>
Default: 0.0
Density from Neighbourhood [boolean] <put parameter description here>
Default: True
Outputs

Density [Percent] [raster] <put output description here>


Connectivity [Percent] [raster] <put output description here>
Fragmentation [raster] <put output description here>
Summary [table] <put output description here>

464

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:fragmentationalternative, classes, class, neighborhood_min, neighborhood_

See also

Fragmentation classes from density and connectivity


Description

<put algortithm description here>


Parameters

Density [Percent] [raster] <put parameter description here>


Connectivity [Percent] [raster] <put parameter description here>
Add Border [boolean] <put parameter description here>
Default: True
Connectivity Weighting [number] <put parameter description here>
Default: 0
Minimum Density [Percent] [number] <put parameter description here>
Default: 10
Minimum Density for Interior Forest [Percent] [number] <put parameter description here>
Default: 99
Outputs

Fragmentation [raster] <put output description here>


Console usage

processing.runalg(saga:fragmentationclassesfromdensityandconnectivity, density, connectivity, bo

See also

Fragmentation (standard)
Description

<put algortithm description here>

18.7. SAGA algorithm provider

465

QGIS User Guide, Release 2.6

Parameters

Classification [raster] <put parameter description here>


Class Identifier [number] <put parameter description here>
Default: 1
Neighborhood Min [number] <put parameter description here>
Default: 1
Neighborhood Max [number] <put parameter description here>
Default: 3
Level Aggregation [selection] <put parameter description here>
Options:
0 [0] average
1 [1] multiplicative
Default: 0
Add Border [boolean] <put parameter description here>
Default: True
Connectivity Weighting [number] <put parameter description here>
Default: 1.1
Minimum Density [Percent] [number] <put parameter description here>
Default: 10
Minimum Density for Interior Forest [Percent] [number] <put parameter description here>
Default: 99
Neighborhood Type [selection] <put parameter description here>
Options:
0 [0] square
1 [1] circle
Default: 0
Include diagonal neighbour relations [boolean] <put parameter description here>
Default: True
Outputs

Density [Percent] [raster] <put output description here>


Connectivity [Percent] [raster] <put output description here>
Fragmentation [raster] <put output description here>
Summary [table] <put output description here>
Console usage

processing.runalg(saga:fragmentationstandard, classes, class, neighborhood_min, neighborhood_max

466

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Layer of extreme value


Description

<put algortithm description here>


Parameters

Grids [multipleinput: rasters] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Maximum
1 [1] Minimum
Default: 0
Outputs

Result [raster] <put output description here>


Console usage
processing.runalg(saga:layerofextremevalue, grids, criteria, result)

See also

Least cost paths


Description

<put algortithm description here>


Parameters

Source Point(s) [vector: point] <put parameter description here>


Accumulated cost [raster] <put parameter description here>
Values [multipleinput: rasters] Optional.
<put parameter description here>
Outputs

Profile (points) [vector] <put output description here>


Profile (lines) [vector] <put output description here>

18.7. SAGA algorithm provider

467

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:leastcostpaths, source, dem, values, points, line)

See also

Ordered Weighted Averaging


Description

<put algortithm description here>


Parameters

Input Grids [multipleinput: rasters] <put parameter description here>


Weights [fixedtable] <put parameter description here>
Outputs

Output Grid [raster] <put output description here>


Console usage
processing.runalg(saga:orderedweightedaveraging, grids, weights, output)

See also

Pattern analysis
Description

<put algortithm description here>


Parameters

Input Grid [raster] <put parameter description here>


Size of Analysis Window [selection] <put parameter description here>
Options:
0 [0] 3 X 3
1 [1] 5 X 5
2 [2] 7 X 7
Default: 0
Max. Number of Classes [number] <put parameter description here>
Default: 0

468

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Relative Richness [raster] <put output description here>


Diversity [raster] <put output description here>
Dominance [raster] <put output description here>
Fragmentation [raster] <put output description here>
Number of Different Classes [raster] <put output description here>
Center Versus Neighbours [raster] <put output description here>
Console usage

processing.runalg(saga:patternanalysis, input, winsize, maxnumclass, relative, diversity, domina

See also

Soil texture classification


Description

<put algortithm description here>


Parameters

Sand [raster] Optional.


<put parameter description here>
Silt [raster] Optional.
<put parameter description here>
Clay [raster] Optional.
<put parameter description here>
Outputs

Soil Texture [raster] <put output description here>


Sum [raster] <put output description here>
Console usage
processing.runalg(saga:soiltextureclassification, sand, silt, clay, texture, sum)

See also

18.7. SAGA algorithm provider

469

QGIS User Guide, Release 2.6

18.7.3 Grid calculus


Function
Description

<put algortithm description here>


Parameters

xmin [number] <put parameter description here>


Default: 0.0
xmax [number] <put parameter description here>
Default: 0.0
ymin [number] <put parameter description here>
Default: 0.0
ymax [number] <put parameter description here>
Default: 0.0
Formula [string] <put parameter description here>
Default: (not set)
Outputs

Function [raster] <put output description here>


Console usage
processing.runalg(saga:function, xmin, xmax, ymin, ymax, formul, result)

See also

Fuzzify
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


A [number] <put parameter description here>
Default: 0.0
B [number] <put parameter description here>
Default: 0.0

470

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

C [number] <put parameter description here>


Default: 0.0
D [number] <put parameter description here>
Default: 0.0
Membership Function Type [selection] <put parameter description here>
Options:
0 [0] linear
1 [1] sigmoidal
2 [2] j-shaped
Default: 0
Adjust to Grid [boolean] <put parameter description here>
Default: True
Outputs

Fuzzified Grid [raster] <put output description here>


Console usage
processing.runalg(saga:fuzzify, input, a, b, c, d, type, autofit, output)

See also

Fuzzy intersection (and)


Description

<put algortithm description here>


Parameters

Grids [multipleinput: rasters] <put parameter description here>


Operator Type [selection] <put parameter description here>
Options:
0 [0] min(a, b) (non-interactive)
1 [1] a * b
2 [2] max(0, a + b - 1)
Default: 0
Outputs

Intersection [raster] <put output description here>

18.7. SAGA algorithm provider

471

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:fuzzyintersectionand, grids, type, and)

See also

Fuzzy union (or)


Description

<put algortithm description here>


Parameters

Grids [multipleinput: rasters] <put parameter description here>


Operator Type [selection] <put parameter description here>
Options:
0 [0] max(a, b) (non-interactive)
1 [1] a + b - a * b
2 [2] min(1, a + b)
Default: 0
Outputs

Union [raster] <put output description here>


Console usage
processing.runalg(saga:fuzzyunionor, grids, type, or)

See also

Geometric figures
Description

Draws simple geometric figures.


Parameters

Cell Count [number] Number of cells to use.


Default: 0
Cell Size [number] Size of the single cell.
Default: 0

472

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Figure [selection] Type of the figure.


Options:
0 [0] Cone (up)
1 [1] Cone (down)
2 [2] Plane
Default: 0
Direction of Plane [Degree] [number] Rotation factor in degrees.
Default: 0
Outputs

Result [raster] The resulting layer.


Console usage
processing.runalg(saga:geometricfigures, cell_count, cell_size, figure, plane, result)

See also

Gradient vector from cartesian to polar coordinates


Description

<put algortithm description here>


Parameters

X Component [raster] <put parameter description here>


Y Component [raster] <put parameter description here>
Polar Angle Units [selection] <put parameter description here>
Options:
0 [0] radians
1 [1] degree
Default: 0
Polar Coordinate System [selection] <put parameter description here>
Options:
0 [0] mathematical
1 [1] geographical
2 [2] user defined
Default: 0
User defined Zero Direction [number] <put parameter description here>
Default: 0.0

18.7. SAGA algorithm provider

473

QGIS User Guide, Release 2.6

User defined Orientation [selection] <put parameter description here>


Options:
0 [0] clockwise
1 [1] counterclockwise
Default: 0
Outputs

Direction [raster] <put output description here>


Length [raster] <put output description here>
Console usage

processing.runalg(saga:gradientvectorfromcartesiantopolarcoordinates, dx, dy, units, system, sys

See also

Gradient vector from polar to cartesian coordinates


Description

<put algortithm description here>


Parameters

Direction [raster] <put parameter description here>


Length [raster] <put parameter description here>
Polar Angle Units [selection] <put parameter description here>
Options:
0 [0] radians
1 [1] degree
Default: 0
Polar Coordinate System [selection] <put parameter description here>
Options:
0 [0] mathematical
1 [1] geographical
2 [2] user defined
Default: 0
User defined Zero Direction [number] <put parameter description here>
Default: 0.0
User defined Orientation [selection] <put parameter description here>
Options:
0 [0] clockwise
474

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

1 [1] counterclockwise
Default: 0
Outputs

X Component [raster] <put output description here>


Y Component [raster] <put output description here>
Console usage

processing.runalg(saga:gradientvectorfrompolartocartesiancoordinates, dir, len, units, system, s

See also

Grid difference
Description

Creates a new grid layer as the result of the difference between two other grid layers.
Parameters

A [raster] First layer.


B [raster] Second layer.
Outputs

Difference (A - B) [raster] The resulting layer.


Console usage
processing.runalg(saga:griddifference, a, b, c)

See also

Grid division
Description

Creates a new grid layer as the result of the division between two other grid layers.
Parameters

Dividend [raster] First layer.


Divisor [raster] Second layer.

18.7. SAGA algorithm provider

475

QGIS User Guide, Release 2.6

Outputs

Quotient [raster] The resulting layer.


Console usage
processing.runalg(saga:griddivision, a, b, c)

See also

Grid normalisation
Description

Normalises the grid values according to minimum and maximum values chosen.
Parameters

Grid [raster] Grid to normalize.


Target Range (min) [number] Minimum value.
Default: 0
Target Range (max) [number] Maximum value.
Default: 1
Outputs

Normalised Grid [raster] The resulting layer.


Console usage
processing.runalg(saga:gridnormalisation, input, range_min, range_max, output)

See also

Grids product
Description

<put algortithm description here>


Parameters

Grids [multipleinput: rasters] <put parameter description here>


Outputs

Product [raster] <put output description here>


476

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:gridsproduct, grids, result)

See also

Grids sum
Description

Creates a new grid layer as the result of the sum of two or more grid layers.
Parameters

Grids [multipleinput: rasters] Grid layers to sum


Outputs

Sum [raster] The resulting layer.


Console usage
processing.runalg(saga:gridssum, grids, result)

See also

Grid standardisation
Description

Standardises the grid layer values.


Parameters

Grid [raster] Grid to process.


Stretch Factor [number] stretching factor.
Default: 1.0
Outputs

Standardised Grid [raster] The resulting layer.


Console usage
processing.runalg(saga:gridstandardisation, input, stretch, output)

18.7. SAGA algorithm provider

477

QGIS User Guide, Release 2.6

See also

Grid volume
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Count Only Above Base Level
1 [1] Count Only Below Base Level
2 [2] Subtract Volumes Below Base Level
3 [3] Add Volumes Below Base Level
Default: 0
Base Level [number] <put parameter description here>
Default: 0.0
Outputs
Console usage
processing.runalg(saga:gridvolume, grid, method, level)

See also

Metric conversions
Description

Performs numerical conversions of the grid values.


Parameters

Grid [raster] Grid to process.


Conversion [selection] Conversion type.
Options:
0 [0] radians to degree
1 [1] degree to radians
2 [2] Celsius to Fahrenheit
3 [3] Fahrenheit to Celsius
Default: 0
478

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Converted Grid [raster] The resulting layer.


Console usage
processing.runalg(saga:metricconversions, grid, conversion, conv)

See also

Polynomial trend from grids


Description

<put algortithm description here>


Parameters

Dependent Variables [multipleinput: rasters] <put parameter description here>


Independent Variable (per Grid and Cell) [multipleinput: rasters] Optional.
<put parameter description here>
Independent Variable (per Grid) [fixedtable] <put parameter description here>
Type of Approximated Function [selection] <put parameter description here>
Options:
0 [0] first order polynom (linear regression)
1 [1] second order polynom
2 [2] third order polynom
3 [3] fourth order polynom
4 [4] fifth order polynom
Default: 0
Outputs

Polynomial Coefficients [raster] <put output description here>


Coefficient of Determination [raster] <put output description here>
Console usage

processing.runalg(saga:polynomialtrendfromgrids, grids, y_grids, y_table, polynom, parms, qualit

18.7. SAGA algorithm provider

479

QGIS User Guide, Release 2.6

See also

Random field
Description

Generates a random grid layer.


Parameters

Width (Cells) [number] Width of the layer in cells.


Default: 100
Height (Cells) [number] Height of the layer in cells.
Default: 100
Cellsize [number] Cell size to use.
Default: 100.0
West [number] West coordinate of the bottom-left corner of the grid.
Default: 0.0
South [number] South coordinate of the bottom-left corner of the grid.
Default: 0.0
Method [selection] Statistical method used for the calculation.
Options:
0 [0] Uniform
1 [1] Gaussian
Default: 0
Range Min [number] Minimum cell value to use.
Default: 0.0
Range Max [number] Maximum cell value to use.
Default: 1.0
Arithmetic Mean [number] Mean of all the cell values to use.
Default: 0.0
Standard Deviation [number] Standard deviation of all the cell values to use.
Default: 1.0
Outputs

Random Field [raster] The resulting layer.


Console usage
processing.runalg(saga:randomfield, nx, ny, cellsize, xmin, ymin, method, range_min, range_max,

480

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Random terrain generation


Description

<put algortithm description here>


Parameters

Radius (cells) [number] <put parameter description here>


Default: 10
Iterations [number] <put parameter description here>
Default: 10
Target Dimensions [selection] <put parameter description here>
Options:
0 [0] User defined
Default: 0
Grid Size [number] <put parameter description here>
Default: 1.0
Cols [number] <put parameter description here>
Default: 100
Rows [number] <put parameter description here>
Default: 100
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:randomterraingeneration, radius, iterations, target_type, user_cell_size,

See also

Raster calculator
Description

<put algortithm description here>

18.7. SAGA algorithm provider

481

QGIS User Guide, Release 2.6

Parameters

Main input layer [raster] <put parameter description here>


Additional layers [multipleinput: rasters] Optional.
<put parameter description here>
Formula [string] <put parameter description here>
Default: (not set)
Outputs

Result [raster] <put output description here>


Console usage
processing.runalg(saga:rastercalculator, grids, xgrids, formula, result)

See also

18.7.4 Grid filter


Dtm filter (slope-based)
Description

<put algortithm description here>


Parameters

Grid to filter [raster] <put parameter description here>


Search Radius [number] <put parameter description here>
Default: 2
Approx. Terrain Slope [number] <put parameter description here>
Default: 30.0
Use Confidence Interval [boolean] <put parameter description here>
Default: True
Outputs

Bare Earth [raster] <put output description here>


Removed Objects [raster] <put output description here>

482

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:dtmfilterslopebased, input, radius, terrainslope, stddev, ground, nongrou

See also

Filter clumps
Description

<put algortithm description here>


Parameters

Input Grid [raster] <put parameter description here>


Min. Size [number] <put parameter description here>
Default: 10
Outputs

Filtered Grid [raster] <put output description here>


Console usage
processing.runalg(saga:filterclumps, grid, threshold, output)

See also

Gaussian filter
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Standard Deviation [number] <put parameter description here>
Default: 1
Search Mode [selection] <put parameter description here>
Options:
0 [0] Square
1 [1] Circle
Default: 0
Search Radius [number] <put parameter description here>
Default: 3
18.7. SAGA algorithm provider

483

QGIS User Guide, Release 2.6

Outputs

Filtered Grid [raster] <put output description here>


Console usage
processing.runalg(saga:gaussianfilter, input, sigma, mode, radius, result)

See also

Laplacian filter
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] standard kernel 1
1 [1] standard kernel 2
2 [2] Standard kernel 3
3 [3] user defined kernel
Default: 0
Standard Deviation (Percent of Radius) [number] <put parameter description here>
Default: 0
Radius [number] <put parameter description here>
Default: 1
Search Mode [selection] <put parameter description here>
Options:
0 [0] square
1 [1] circle
Default: 0
Outputs

Filtered Grid [raster] <put output description here>


Console usage
processing.runalg(saga:laplacianfilter, input, method, sigma, radius, mode, result)

484

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Majority filter
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Search Mode [selection] <put parameter description here>
Options:
0 [0] Square
1 [1] Circle
Default: 0
Radius [number] <put parameter description here>
Default: 1
Threshold [Percent] [number] <put parameter description here>
Default: 0
Outputs

Filtered Grid [raster] <put output description here>


Console usage
processing.runalg(saga:majorityfilter, input, mode, radius, threshold, result)

See also

Morphological filter
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Search Mode [selection] <put parameter description here>
Options:
0 [0] Square
1 [1] Circle
Default: 0

18.7. SAGA algorithm provider

485

QGIS User Guide, Release 2.6

Radius [number] <put parameter description here>


Default: 1
Method [selection] <put parameter description here>
Options:
0 [0] Dilation
1 [1] Erosion
2 [2] Opening
3 [3] Closing
Default: 0
Outputs

Filtered Grid [raster] <put output description here>


Console usage
processing.runalg(saga:morphologicalfilter, input, mode, radius, method, result)

See also

Multi direction lee filter


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Estimated Noise (absolute) [number] <put parameter description here>
Default: 1.0
Estimated Noise (relative) [number] <put parameter description here>
Default: 1.0
Weighted [boolean] <put parameter description here>
Default: True
Method [selection] <put parameter description here>
Options:
0 [0] noise variance given as absolute value
1 [1] noise variance given relative to mean standard deviation
2 [2] original calculation (Ringeler)
Default: 0

486

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Filtered Grid [raster] <put output description here>


Minimum Standard Deviation [raster] <put output description here>
Direction of Minimum Standard Deviation [raster] <put output description here>
Console usage

processing.runalg(saga:multidirectionleefilter, input, noise_abs, noise_rel, weighted, method, r

See also

Rank filter
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Search Mode [selection] <put parameter description here>
Options:
0 [0] Square
1 [1] Circle
Default: 0
Radius [number] <put parameter description here>
Default: 1
Rank [Percent] [number] <put parameter description here>
Default: 50
Outputs

Filtered Grid [raster] <put output description here>


Console usage
processing.runalg(saga:rankfilter, input, mode, radius, rank, result)

See also

Simple filter
Description

<put algortithm description here>


18.7. SAGA algorithm provider

487

QGIS User Guide, Release 2.6

Parameters

Grid [raster] <put parameter description here>


Search Mode [selection] <put parameter description here>
Options:
0 [0] Square
1 [1] Circle
Default: 0
Filter [selection] <put parameter description here>
Options:
0 [0] Smooth
1 [1] Sharpen
2 [2] Edge
Default: 0
Radius [number] <put parameter description here>
Default: 2
Outputs

Filtered Grid [raster] <put output description here>


Console usage
processing.runalg(saga:simplefilter, input, mode, method, radius, result)

See also

User defined filter


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Filter Matrix [table] Optional.
<put parameter description here>
Default Filter Matrix (3x3) [fixedtable] <put parameter description here>
Outputs

Filtered Grid [raster] <put output description here>

488

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:userdefinedfilter, input, filter, filter_3x3, result)

See also

18.7.5 Grid gridding


Inverse distance weighted
Description

Inverse distance grid interpolation from irregular distributed points.


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] inverse distance to a power
1 [1] linearly decreasing within search radius
2 [2] exponential weighting scheme
3 [3] gaussian weighting scheme
Default: 0
Inverse Distance Power [number] <put parameter description here>
Default: 2
Exponential and Gaussian Weighting Bandwidth [number] <put parameter description here>
Default: 1
Search Range [selection] <put parameter description here>
Options:
0 [0] search radius (local)
1 [1] no search radius (global)
Default: 0
Search Radius [number] <put parameter description here>
Default: 100.0

18.7. SAGA algorithm provider

489

QGIS User Guide, Release 2.6

Search Mode [selection] <put parameter description here>


Options:
0 [0] all directions
1 [1] quadrants
Default: 0
Number of Points [selection] <put parameter description here>
Options:
0 [0] maximum number of points
1 [1] all points
Default: 0
Maximum Number of Points [number] <put parameter description here>
Default: 10
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:inversedistanceweighted, shapes, field, target, weighting, power, bandwid

See also

Kernel density estimation


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Weight [tablefield: any] <put parameter description here>
Radius [number] <put parameter description here>
Default: 10
Kernel [selection] <put parameter description here>
Options:
0 [0] quartic kernel
1 [1] gaussian kernel
490

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Default: 0
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:kerneldensityestimation, points, population, radius, kernel, target, outp

See also

Modifed quadratic shepard


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Quadratic Neighbors [number] <put parameter description here>
Default: 13
Weighting Neighbors [number] <put parameter description here>
Default: 19
Left [number] <put parameter description here>
Default: 0.0
Right [number] <put parameter description here>
Default: 0.0

18.7. SAGA algorithm provider

491

QGIS User Guide, Release 2.6

Bottom [number] <put parameter description here>


Default: 0.0
Top [number] <put parameter description here>
Default: 0.0
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:modifedquadraticshepard, shapes, field, target, quadratic_neighbors, weig

See also

Natural neighbour
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Sibson [boolean] <put parameter description here>
Default: True
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>

492

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:naturalneighbour, shapes, field, target, sibson, output_extent, user_size

See also

Nearest neighbour
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:nearestneighbour, shapes, field, target, output_extent, user_size, user_g

See also

Shapes to grid
Description

<put algortithm description here>

18.7. SAGA algorithm provider

493

QGIS User Guide, Release 2.6

Parameters

Shapes [vector: any] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Method for Multiple Values [selection] <put parameter description here>
Options:
0 [0] first
1 [1] last
2 [2] minimum
3 [3] maximum
4 [4] mean
Default: 0
Method for Lines [selection] <put parameter description here>
Options:
0 [0] thin
1 [1] thick
Default: 0
Preferred Target Grid Type [selection] <put parameter description here>
Options:
0 [0] Integer (1 byte)
1 [1] Integer (2 byte)
2 [2] Integer (4 byte)
3 [3] Floating Point (4 byte)
4 [4] Floating Point (8 byte)
Default: 0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:shapestogrid, input, field, multiple, line_type, grid_type, output_extent

494

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Triangulation
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:triangulation, shapes, field, target, output_extent, user_size, user_grid

See also

18.7.6 Grid spline


B-spline approximation
Description

<put algortithm description here>

18.7. SAGA algorithm provider

495

QGIS User Guide, Release 2.6

Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Resolution [number] <put parameter description here>
Default: 1.0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:bsplineapproximation, shapes, field, target, level, output_extent, user_s

See also

Cubic spline approximation


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Minimal Number of Points [number] <put parameter description here>
Default: 3
Maximal Number of Points [number] <put parameter description here>
Default: 20

496

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Points per Square [number] <put parameter description here>


Default: 5
Tolerance [number] <put parameter description here>
Default: 140.0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:cubicsplineapproximation, shapes, field, target, npmin, npmax, nppc, k, o

See also

Multilevel b-spline interpolation (from grid)


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Method [selection] <put parameter description here>
Options:
0 [0] without B-spline refinement
1 [1] with B-spline refinement
Default: 0
Threshold Error [number] <put parameter description here>
Default: 0.0001
Maximum Level [number] <put parameter description here>
Default: 11.0
Data Type [selection] <put parameter description here>
Options:
18.7. SAGA algorithm provider

497

QGIS User Guide, Release 2.6

0 [0] same as input grid


1 [1] floating point
Default: 0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:multilevelbsplineinterpolationfromgrid, gridpoints, target, method, epsil

See also

Multilevel b-spline interpolation


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Method [selection] <put parameter description here>
Options:
0 [0] without B-spline refinement
1 [1] with B-spline refinement
Default: 0
Threshold Error [number] <put parameter description here>
Default: 0.0001
Maximum Level [number] <put parameter description here>
Default: 11.0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
498

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Cellsize [number] <put parameter description here>


Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:multilevelbsplineinterpolation, shapes, field, target, method, epsilon, l

See also

Thin plate spline (global)


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Regularisation [number] <put parameter description here>
Default: 0.0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:thinplatesplineglobal, shapes, field, target, regul, output_extent, user_

18.7. SAGA algorithm provider

499

QGIS User Guide, Release 2.6

See also

Thin plate spline (local)


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Regularisation [number] <put parameter description here>
Default: 0.0001
Search Radius [number] <put parameter description here>
Default: 100.0
Search Mode [selection] <put parameter description here>
Options:
0 [0] all directions
1 [1] quadrants
Default: 0
Points Selection [selection] <put parameter description here>
Options:
0 [0] all points in search radius
1 [1] maximum number of points
Default: 0
Maximum Number of Points [number] <put parameter description here>
Default: 10
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>

500

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:thinplatesplinelocal, shapes, field, target, regul, radius, mode, select,

See also

Thin plate spline (tin)


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Regularisation [number] <put parameter description here>
Default: 0.0
Neighbourhood [selection] <put parameter description here>
Options:
0 [0] immediate
1 [1] level 1
2 [2] level 2
Default: 0
Add Frame [boolean] <put parameter description here>
Default: True
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>


Console usage

processing.runalg(saga:thinplatesplinetin, shapes, field, target, regul, level, frame, output_ex

18.7. SAGA algorithm provider

501

QGIS User Guide, Release 2.6

See also

18.7.7 Grid tools


Aggregate
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Aggregation Size [number] <put parameter description here>
Default: 3
Method [selection] <put parameter description here>
Options:
0 [0] Sum
1 [1] Min
2 [2] Max
Default: 0
Outputs
Console usage
processing.runalg(saga:aggregate, input, size, method)

See also

Change grid values


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Replace Condition [selection] <put parameter description here>
Options:
0 [0] Grid value equals low value
1 [1] Low value < grid value < high value

502

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

2 [2] Low value <= grid value < high value


Default: 0
Lookup Table [fixedtable] <put parameter description here>
Outputs

Changed Grid [raster] <put output description here>


Console usage
processing.runalg(saga:changegridvalues, grid_in, method, lookup, grid_out)

See also

Close gaps
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Mask [raster] Optional.
<put parameter description here>
Tension Threshold [number] <put parameter description here>
Default: 0.1
Outputs

Changed Grid [raster] <put output description here>


Console usage
processing.runalg(saga:closegaps, input, mask, threshold, result)

See also

Close gaps with spline


Description

<put algortithm description here>

18.7. SAGA algorithm provider

503

QGIS User Guide, Release 2.6

Parameters

Grid [raster] <put parameter description here>


Mask [raster] Optional.
<put parameter description here>
Only Process Gaps with Less Cells [number] <put parameter description here>
Default: 0
Maximum Points [number] <put parameter description here>
Default: 1000
Number of Points for Local Interpolation [number] <put parameter description here>
Default: 10
Extended Neighourhood [boolean] <put parameter description here>
Default: True
Neighbourhood [selection] <put parameter description here>
Options:
0 [0] Neumann
1 [1] Moore
Default: 0
Radius (Cells) [number] <put parameter description here>
Default: 0
Relaxation [number] <put parameter description here>
Default: 0.0
Outputs

Closed Gaps Grid [raster] <put output description here>


Console usage

processing.runalg(saga:closegapswithspline, grid, mask, maxgapcells, maxpoints, localpoints, ext

See also

Close one cell gaps


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>

504

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Changed Grid [raster] <put output description here>


Console usage
processing.runalg(saga:closeonecellgaps, input, result)

See also

Convert data storage type


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Data storage type [selection] <put parameter description here>
Options:
0 [0] bit
1 [1] unsigned 1 byte integer
2 [2] signed 1 byte integer
3 [3] unsigned 2 byte integer
4 [4] signed 2 byte integer
5 [5] unsigned 4 byte integer
6 [6] signed 4 byte integer
7 [7] 4 byte floating point number
8 [8] 8 byte floating point number
Default: 0
Outputs

Converted Grid [raster] <put output description here>


Console usage
processing.runalg(saga:convertdatastoragetype, input, type, output)

18.7. SAGA algorithm provider

505

QGIS User Guide, Release 2.6

See also

Crop to data
Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Outputs

Cropped layer [raster] <put output description here>


Console usage
processing.runalg(saga:croptodata, input, output)

See also

Grid buffer
Description

<put algortithm description here>


Parameters

Features Grid [raster] <put parameter description here>


Distance [number] <put parameter description here>
Default: 1000
Buffer Distance [selection] <put parameter description here>
Options:
0 [0] Fixed
1 [1] Cell value
Default: 0
Outputs

Buffer Grid [raster] <put output description here>


Console usage

506

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

processing.runalg(saga:gridbuffer, features, dist, buffertype, buffer)

See also

Grid masking
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Mask [raster] <put parameter description here>
Outputs

Masked Grid [raster] <put output description here>


Console usage
processing.runalg(saga:gridmasking, grid, mask, masked)

See also

Grid orientation
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Copy
1 [1] Flip
2 [2] Mirror
3 [3] Invert
Default: 0
Outputs

Changed Grid [raster] <put output description here>

18.7. SAGA algorithm provider

507

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:gridorientation, input, method, result)

See also

Grid proximity buffer


Description

<put algortithm description here>


Parameters

Source Grid [raster] <put parameter description here>


Buffer distance [number] <put parameter description here>
Default: 500.0
Equidistance [number] <put parameter description here>
Default: 100.0
Outputs

Distance Grid [raster] <put output description here>


Allocation Grid [raster] <put output description here>
Buffer Grid [raster] <put output description here>
Console usage
processing.runalg(saga:gridproximitybuffer, source, dist, ival, distance, alloc, buffer)

See also

Grid shrink/expand
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Operation [selection] <put parameter description here>
Options:
0 [0] Shrink
1 [1] Expand

508

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Default: 0
Search Mode [selection] <put parameter description here>
Options:
0 [0] Square
1 [1] Circle
Default: 0
Radius [number] <put parameter description here>
Default: 1
Method [selection] <put parameter description here>
Options:
0 [0] min
1 [1] max
2 [2] mean
3 [3] majority
Default: 0
Outputs

Result Grid [raster] <put output description here>


Console usage
processing.runalg(saga:gridshrinkexpand, input, operation, mode, radius, method_expand, result)

See also

Invert data/no-data
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Outputs

Result [raster] <put output description here>


Console usage
processing.runalg(saga:invertdatanodata, input, output)

18.7. SAGA algorithm provider

509

QGIS User Guide, Release 2.6

See also

Merge raster layers


Description

<put algortithm description here>


Parameters

Grids to Merge [multipleinput: rasters] <put parameter description here>


Preferred data storage type [selection] <put parameter description here>
Options:
0 [0] 1 bit
1 [1] 1 byte unsigned integer
2 [2] 1 byte signed integer
3 [3] 2 byte unsigned integer
4 [4] 2 byte signed integer
5 [5] 4 byte unsigned integer
6 [6] 4 byte signed integer
7 [7] 4 byte floating point
8 [8] 8 byte floating point
Default: 0
Interpolation [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Overlapping Cells [selection] <put parameter description here>
Options:
0 [0] mean value
1 [1] first value in order of grid list
Default: 0
Outputs

Merged Grid [raster] <put output description here>

510

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:mergerasterlayers, grids, type, interpol, overlap, merged)

See also

Patching
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Patch Grid [raster] <put parameter description here>
Interpolation Method [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Outputs

Completed Grid [raster] <put output description here>


Console usage
processing.runalg(saga:patching, original, additional, interpolation, completed)

See also

Proximity grid
Description

<put algortithm description here>


Parameters

Features [raster] <put parameter description here>

18.7. SAGA algorithm provider

511

QGIS User Guide, Release 2.6

Outputs

Distance [raster] <put output description here>


Direction [raster] <put output description here>
Allocation [raster] <put output description here>
Console usage
processing.runalg(saga:proximitygrid, features, distance, direction, allocation)

See also

Reclassify grid values


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] single
1 [1] range
2 [2] simple table
Default: 0
old value (for single value change) [number] <put parameter description here>
Default: 0.0
new value (for single value change) [number] <put parameter description here>
Default: 1.0
operator (for single value change) [selection] <put parameter description here>
Options:
0 [0] =
1 [1] <
2 [2] <=
3 [3] >=
4 [4] >
Default: 0
minimum value (for range) [number] <put parameter description here>
Default: 0.0

512

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

maximum value (for range) [number] <put parameter description here>


Default: 1.0
new value(for range) [number] <put parameter description here>
Default: 2.0
operator (for range) [selection] <put parameter description here>
Options:
0 [0] <=
1 [1] <
Default: 0
Lookup Table [fixedtable] <put parameter description here>
operator (for table) [selection] <put parameter description here>
Options:
0 [0] min <= value < max
1 [1] min <= value <= max
2 [2] min < value <= max
3 [3] min < value < max
Default: 0
replace no data values [boolean] <put parameter description here>
Default: True
new value for no data values [number] <put parameter description here>
Default: 0.0
replace other values [boolean] <put parameter description here>
Default: True
new value for other values [number] <put parameter description here>
Default: 0.0
Outputs

Reclassified Grid [raster] <put output description here>


Console usage

processing.runalg(saga:reclassifygridvalues, input, method, old, new, soperator, min, max, rnew,

See also

Resampling
Description

<put algortithm description here>

18.7. SAGA algorithm provider

513

QGIS User Guide, Release 2.6

Parameters

Grid [raster] <put parameter description here>


Preserve Data Type [boolean] <put parameter description here>
Default: True
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Interpolation Method (Scale Up) [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
5 [5] Mean Value
6 [6] Mean Value (cell area weighted)
7 [7] Minimum Value
8 [8] Maximum Value
9 [9] Majority
Default: 0
Interpolation Method (Scale Down) [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Cellsize [number] <put parameter description here>
Default: 100.0
Outputs

Grid [raster] <put output description here>

514

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:resampling, input, keep_type, target, scale_up_method, scale_down_method,

See also

Sort grid
Description

<put algortithm description here>


Parameters

Input Grid [raster] <put parameter description here>


Down sort [boolean] <put parameter description here>
Default: True
Outputs

Sorted Grid [raster] <put output description here>


Console usage
processing.runalg(saga:sortgrid, grid, down, output)

See also

Split RGB bands


Description

<put algortithm description here>


Parameters

Input layer [raster] <put parameter description here>


Outputs

Output R band layer [raster] <put output description here>


Output G band layer [raster] <put output description here>
Output B band layer [raster] <put output description here>

18.7. SAGA algorithm provider

515

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:splitrgbbands, input, r, g, b)

See also

Threshold buffer
Description

<put algortithm description here>


Parameters

Features Grid [raster] <put parameter description here>


Value Grid [raster] <put parameter description here>
Threshold Grid [raster] Optional.
<put parameter description here>
Threshold [number] <put parameter description here>
Default: 0.0
Threshold Type [selection] <put parameter description here>
Options:
0 [0] Absolute
1 [1] Relative from cell value
Default: 0
Outputs

Buffer Grid [raster] <put output description here>


Console usage

processing.runalg(saga:thresholdbuffer, features, value, thresholdgrid, threshold, thresholdtype

See also

18.7.8 Grid visualization


Histogram surface
Description

<put algortithm description here>

516

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Grid [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] rows
1 [1] columns
2 [2] circle
Default: 0
Outputs

Histogram [raster] <put output description here>


Console usage
processing.runalg(saga:histogramsurface, grid, method, hist)

See also

Rgb composite
Description

<put algortithm description here>


Parameters

R [raster] <put parameter description here>


G [raster] <put parameter description here>
B [raster] <put parameter description here>
Method for R value [selection] <put parameter description here>
Options:
0 0 - 255
1 Rescale to 0 - 255
2 User defined rescale
3 Percentiles
4 Percentage of standard deviation
Default: 0
Method for G value [selection] <put parameter description here>
Options:
0 0 - 255
1 Rescale to 0 - 255

18.7. SAGA algorithm provider

517

QGIS User Guide, Release 2.6

2 User defined rescale


3 Percentiles
4 Percentage of standard deviation
Default: 0
Method for B value [selection] <put parameter description here>
Options:
0 0 - 255
1 Rescale to 0 - 255
2 User defined rescale
3 Percentiles
4 Percentage of standard deviation
Default: 0
Rescale Range for RED min [number] <put parameter description here>
Default: 0
Rescale Range for RED max [number] <put parameter description here>
Default: 255
Percentiles Range for RED max [number] <put parameter description here>
Default: 1
Percentiles Range for RED max [number] <put parameter description here>
Default: 99
Percentage of standard deviation for RED [number] <put parameter description here>
Default: 150.0
Rescale Range for GREEN min [number] <put parameter description here>
Default: 0
Rescale Range for GREEN max [number] <put parameter description here>
Default: 255
Percentiles Range for GREEN max [number] <put parameter description here>
Default: 1
Percentiles Range for GREEN max [number] <put parameter description here>
Default: 99
Percentage of standard deviation for GREEN [number] <put parameter description here>
Default: 150.0
Rescale Range for BLUE min [number] <put parameter description here>
Default: 0
Rescale Range for BLUE max [number] <put parameter description here>
Default: 255
Percentiles Range for BLUE max [number] <put parameter description here>
Default: 1

518

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Percentiles Range for BLUE max [number] <put parameter description here>
Default: 99
Percentage of standard deviation for BLUE [number] <put parameter description here>
Default: 150.0
Outputs

Output RGB [raster] <put output description here>


Console usage

processing.runalg(saga:rgbcomposite, grid_r, grid_g, grid_b, r_method, g_method, b_method, r_ran

See also

18.7.9 Imagery classification


Change detection
Description

<put algortithm description here>


Parameters

Initial State [raster] <put parameter description here>


Look-up Table [table] Optional.
<put parameter description here>
Value [tablefield: any] <put parameter description here>
Value (Maximum) [tablefield: any] <put parameter description here>
Name [tablefield: any] <put parameter description here>
Final State [raster] <put parameter description here>
Look-up Table [table] Optional.
<put parameter description here>
Value [tablefield: any] <put parameter description here>
Value (Maximum) [tablefield: any] <put parameter description here>
Name [tablefield: any] <put parameter description here>
Report Unchanged Classes [boolean] <put parameter description here>
Default: True
Output as... [selection] <put parameter description here>
Options:

18.7. SAGA algorithm provider

519

QGIS User Guide, Release 2.6

0 [0] cells
1 [1] percent
2 [2] area
Default: 0
Outputs

Changes [raster] <put output description here>


Changes [table] <put output description here>
Console usage

processing.runalg(saga:changedetection, initial, ini_lut, ini_lut_min, ini_lut_max, ini_lut_nam,

See also

Cluster analysis for grids


Description

<put algortithm description here>


Parameters

Grids [multipleinput: rasters] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Iterative Minimum Distance (Forgy 1965)
1 [1] Hill-Climbing (Rubin 1967)
2 [2] Combined Minimum Distance / Hillclimbing
Default: 0
Clusters [number] <put parameter description here>
Default: 5
Normalise [boolean] <put parameter description here>
Default: True
Old Version [boolean] <put parameter description here>
Default: True
Outputs

Clusters [raster] <put output description here>


Statistics [table] <put output description here>

520

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:clusteranalysisforgrids, grids, method, ncluster, normalise, oldversion,

See also

Supervised classification
Description

<put algortithm description here>


Parameters

Grids [multipleinput: rasters] <put parameter description here>


Training Areas [vector: polygon] <put parameter description here>
Class Identifier [tablefield: any] <put parameter description here>
Method [selection] <put parameter description here>
Options:
0 [0] Binary Encoding
1 [1] Parallelepiped
2 [2] Minimum Distance
3 [3] Mahalanobis Distance
4 [4] Maximum Likelihood
5 [5] Spectral Angle Mapping
6 [6] Winner Takes All
Default: 0
Normalise [boolean] <put parameter description here>
Default: True
Distance Threshold [number] <put parameter description here>
Default: 0.0
Probability Threshold (Percent) [number] <put parameter description here>
Default: 0.0
Probability Reference [selection] <put parameter description here>
Options:
0 [0] absolute
1 [1] relative
Default: 0
Spectral Angle Threshold (Degree) [number] <put parameter description here>
Default: 0.0

18.7. SAGA algorithm provider

521

QGIS User Guide, Release 2.6

Outputs

Class Information [table] <put output description here>


Classification [raster] <put output description here>
Quality [raster] <put output description here>
Console usage

processing.runalg(saga:supervisedclassification, grids, roi, roi_id, method, normalise, threshol

See also

18.7.10 Imagery RGA


Fast region growing algorithm
Description

<put algortithm description here>


Parameters

Input Grids [multipleinput: rasters] <put parameter description here>


Seeds Grid [raster] <put parameter description here>
Smooth Rep [raster] Optional.
<put parameter description here>
Outputs

Segmente [raster] <put output description here>


Mean [raster] <put output description here>
Console usage
processing.runalg(saga:fastregiongrowingalgorithm, input, start, rep, result, mean)

See also

522

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

18.7.11 Imagery segmentation


Grid skeletonization
Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Standard
1 [1] Hilditchs Algorithm
2 [2] Channel Skeleton
Default: 0
Initialisation [selection] <put parameter description here>
Options:
0 [0] Less than
1 [1] Greater than
Default: 0
Threshold (Init.) [number] <put parameter description here>
Default: 0.0
Convergence [number] <put parameter description here>
Default: 3.0
Outputs

Skeleton [raster] <put output description here>


Skeleton [vector] <put output description here>
Console usage

processing.runalg(saga:gridskeletonization, input, method, init_method, init_threshold, converge

See also

Seed generation
Description

<put algortithm description here>

18.7. SAGA algorithm provider

523

QGIS User Guide, Release 2.6

Parameters

Features [multipleinput: rasters] <put parameter description here>


Bandwidth (Cells) [number] <put parameter description here>
Default: 2
Type of Surface [selection] <put parameter description here>
Options:
0 [0] smoothed surface
1 [1] variance (a)
2 [2] variance (b)
Default: 0
Extraction of... [selection] <put parameter description here>
Options:
0 [0] minima
1 [1] maxima
2 [2] minima and maxima
Default: 0
Feature Aggregation [selection] <put parameter description here>
Options:
0 [0] additive
1 [1] multiplicative
Default: 0
Normalized [boolean] <put parameter description here>
Default: True
Outputs

Surface [raster] <put output description here>


Seeds Grid [raster] <put output description here>
Seeds [vector] <put output description here>
Console usage

processing.runalg(saga:seedgeneration, grids, factor, type_surface, type_seeds, type_merge, norm

See also

Simple region growing


Description

<put algortithm description here>

524

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Seeds [raster] <put parameter description here>


Features [multipleinput: rasters] <put parameter description here>
Method [selection] <put parameter description here>
Options:
0 [0] feature space and position
1 [1] feature space
Default: 0
Neighbourhood [selection] <put parameter description here>
Options:
0 [0] 4 (von Neumann)
1 [1] 8 (Moore)
Default: 0
Variance in Feature Space [number] <put parameter description here>
Default: 1.0
Variance in Position Space [number] <put parameter description here>
Default: 1.0
Threshold - Similarity [number] <put parameter description here>
Default: 0.0
Refresh [boolean] <put parameter description here>
Default: True
Leaf Size (for Speed Optimisation) [number] <put parameter description here>
Default: 256
Outputs

Segments [raster] <put output description here>


Similarity [raster] <put output description here>
Seeds [table] <put output description here>
Console usage

processing.runalg(saga:simpleregiongrowing, seeds, features, method, neighbour, sig_1, sig_2, th

See also

Watershed segmentation
Description

<put algortithm description here>

18.7. SAGA algorithm provider

525

QGIS User Guide, Release 2.6

Parameters

Grid [raster] <put parameter description here>


Output [selection] <put parameter description here>
Options:
0 [0] Seed Value
1 [1] Segment ID
Default: 0
Method [selection] <put parameter description here>
Options:
0 [0] Minima
1 [1] Maxima
Default: 0
Join Segments based on Threshold Value [selection] <put parameter description here>
Options:
0 [0] do not join
1 [1] seed to saddle difference
2 [2] seeds difference
Default: 0
Threshold [number] <put parameter description here>
Default: 0
Allow Edge Pixels to be Seeds [boolean] <put parameter description here>
Default: True
Borders [boolean] <put parameter description here>
Default: True
Outputs

Segments [raster] <put output description here>


Seed Points [vector] <put output description here>
Borders [raster] <put output description here>
Console usage

processing.runalg(saga:watershedsegmentation, grid, output, down, join, threshold, edge, bborder

See also

526

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

18.7.12 Imagery tools


Vegetation index[distance based]
Description

<put algortithm description here>


Parameters

Near Infrared Band [raster] <put parameter description here>


Red Band [raster] <put parameter description here>
Slope of the soil line [number] <put parameter description here>
Default: 0.0
Intercept of the soil line [number] <put parameter description here>
Default: 0.0
Outputs

PVI (Richardson and Wiegand) [raster] <put output description here>


PVI (Perry & Lautenschlager) [raster] <put output description here>
PVI (Walther & Shabaani) [raster] <put output description here>
PVI (Qi, et al) [raster] <put output description here>
Console usage

processing.runalg(saga:vegetationindexdistancebased, nir, red, slope, intercept, pvi, pvi1, pvi2

See also

Vegetation index[slope based]


Description

<put algortithm description here>


Parameters

Near Infrared Band [raster] <put parameter description here>


Red Band [raster] <put parameter description here>

18.7. SAGA algorithm provider

527

QGIS User Guide, Release 2.6

Outputs

Normalized Difference Vegetation Index [raster] <put output description here>


Ratio Vegetation Index [raster] <put output description here>
Transformed Vegetation Index [raster] <put output description here>
Corrected Transformed Vegetation Index [raster] <put output description here>
Thiams Transformed Vegetation Index [raster] <put output description here>
Normalized Ratio Vegetation Index [raster] <put output description here>
Console usage

processing.runalg(saga:vegetationindexslopebased, nir, red, ndvi, ratio, tvi, ctvi, ttvi, nratio

See also

18.7.13 Kriging
Ordinary kriging (global)
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Create Variance Grid [boolean] <put parameter description here>
Default: True
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Variogram Model [selection] <put parameter description here>
Options:
0 [0] Spherical Model
1 [1] Exponential Model
2 [2] Gaussian Model
3 [3] Linear Regression
4 [4] Exponential Regression
5 [5] Power Function Regression

528

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Default: 0
Block Kriging [boolean] <put parameter description here>
Default: True
Block Size [number] <put parameter description here>
Default: 100
Logarithmic Transformation [boolean] <put parameter description here>
Default: True
Nugget [number] <put parameter description here>
Default: 0.0
Sill [number] <put parameter description here>
Default: 0.0
Range [number] <put parameter description here>
Default: 0.0
Linear Regression [number] <put parameter description here>
Default: 1.0
Exponential Regression [number] <put parameter description here>
Default: 0.1
Power Function - A [number] <put parameter description here>
Default: 1.0
Power Function - B [number] <put parameter description here>
Default: 0.5
Grid Size [number] <put parameter description here>
Default: 1.0
Fit Extent [boolean] <put parameter description here>
Default: True
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Outputs

Grid [raster] <put output description here>


Variance [raster] <put output description here>
Console usage

processing.runalg(saga:ordinarykrigingglobal, shapes, field, bvariance, target, model, block, db

18.7. SAGA algorithm provider

529

QGIS User Guide, Release 2.6

See also

Ordinary kriging
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Create Variance Grid [boolean] <put parameter description here>
Default: True
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Variogram Model [selection] <put parameter description here>
Options:
0 [0] Spherical Model
1 [1] Exponential Model
2 [2] Gaussian Model
3 [3] Linear Regression
4 [4] Exponential Regression
5 [5] Power Function Regression
Default: 0
Block Kriging [boolean] <put parameter description here>
Default: True
Block Size [number] <put parameter description here>
Default: 100
Logarithmic Transformation [boolean] <put parameter description here>
Default: True
Nugget [number] <put parameter description here>
Default: 0.0
Sill [number] <put parameter description here>
Default: 10.0
Range [number] <put parameter description here>
Default: 100.0
Linear Regression [number] <put parameter description here>
Default: 1.0

530

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Exponential Regression [number] <put parameter description here>


Default: 0.1
Power Function - A [number] <put parameter description here>
Default: 1
Power Function - B [number] <put parameter description here>
Default: 0.5
Maximum Search Radius (map units) [number] <put parameter description here>
Default: 1000.0
Min.Number of m_Points [number] <put parameter description here>
Default: 4
Max. Number of m_Points [number] <put parameter description here>
Default: 20
Grid Size [number] <put parameter description here>
Default: 1.0
Fit Extent [boolean] <put parameter description here>
Default: True
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Outputs

Grid [raster] <put output description here>


Variance [raster] <put output description here>
Console usage
processing.runalg(saga:ordinarykriging, shapes, field, bvariance, target, model, block, dblock,

See also

Universal kriging (global)


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Create Variance Grid [boolean] <put parameter description here>
Default: True

18.7. SAGA algorithm provider

531

QGIS User Guide, Release 2.6

Target Grid [selection] <put parameter description here>


Options:
0 [0] user defined
Default: 0
Variogram Model [selection] <put parameter description here>
Options:
0 [0] Spherical Model
1 [1] Exponential Model
2 [2] Gaussian Model
3 [3] Linear Regression
4 [4] Exponential Regression
5 [5] Power Function Regression
Default: 0
Block Kriging [boolean] <put parameter description here>
Default: True
Block Size [number] <put parameter description here>
Default: 100
Logarithmic Transformation [boolean] <put parameter description here>
Default: True
Nugget [number] <put parameter description here>
Default: 0.0
Sill [number] <put parameter description here>
Default: 0.0
Range [number] <put parameter description here>
Default: 0.0
Linear Regression [number] <put parameter description here>
Default: 1
Exponential Regression [number] <put parameter description here>
Default: 0.5
Power Function - A [number] <put parameter description here>
Default: 1.0
Power Function - B [number] <put parameter description here>
Default: 0.1
Grids [multipleinput: rasters] <put parameter description here>
Grid Interpolation [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation

532

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

3 [3] Bicubic Spline Interpolation


4 [4] B-Spline Interpolation
Default: 0
Grid Size [number] <put parameter description here>
Default: 1.0
Fit Extent [boolean] <put parameter description here>
Default: True
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Outputs

Grid [raster] <put output description here>


Variance [raster] <put output description here>
Console usage

processing.runalg(saga:universalkrigingglobal, shapes, field, bvariance, target, model, block, d

See also

Universal kriging
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Create Variance Grid [boolean] <put parameter description here>
Default: True
Target Grid [selection] <put parameter description here>
Options:
0 [0] user defined
Default: 0
Variogram Model [selection] <put parameter description here>
Options:
0 [0] Spherical Model
1 [1] Exponential Model
2 [2] Gaussian Model
3 [3] Linear Regression
18.7. SAGA algorithm provider

533

QGIS User Guide, Release 2.6

4 [4] Exponential Regression


5 [5] Power Function Regression
Default: 0
Block Kriging [boolean] <put parameter description here>
Default: True
Block Size [number] <put parameter description here>
Default: 100
Logarithmic Transformation [boolean] <put parameter description here>
Default: True
Nugget [number] <put parameter description here>
Default: 0.0
Sill [number] <put parameter description here>
Default: 0.0
Range [number] <put parameter description here>
Default: 0.0
Linear Regression [number] <put parameter description here>
Default: 1.0
Exponential Regression [number] <put parameter description here>
Default: 0.1
Power Function - A [number] <put parameter description here>
Default: 1
Power Function - B [number] <put parameter description here>
Default: 0.5
Grids [multipleinput: rasters] <put parameter description here>
Grid Interpolation [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Min.Number of m_Points [number] <put parameter description here>
Default: 4
Max. Number of m_Points [number] <put parameter description here>
Default: 20
Maximum Search Radius (map units) [number] <put parameter description here>
Default: 1000.0

534

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Grid Size [number] <put parameter description here>


Default: 1.0
Fit Extent [boolean] <put parameter description here>
Default: True
Output extent [extent] <put parameter description here>
Default: 0,1,0,1
Outputs

Grid [raster] <put output description here>


Variance [raster] <put output description here>
Console usage

processing.runalg(saga:universalkriging, shapes, field, bvariance, target, model, block, dblock,

See also

18.7.14 Shapes grid


Add grid values to points
Description

Creates a new vector layer as a result of the union of a points layer with the interpolated value of one or more
base background grid layer(s). This way, the new layer created will have a new column in the attribute table that
reflects the interpolated value of the background grid.
Parameters

Points [vector: point] Input layer.


Grids [multipleinput: rasters] Background grid layer(s)
Interpolation [selection] interpolation method to use.
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0

18.7. SAGA algorithm provider

535

QGIS User Guide, Release 2.6

Outputs

Result [vector] The resulting layer.


Console usage
processing.runalg(saga:addgridvaluestopoints, shapes, grids, interpol, result)

See also

Add grid values to shapes


Description

<put algortithm description here>


Parameters

Shapes [vector: any] <put parameter description here>


Grids [multipleinput: rasters] <put parameter description here>
Interpolation [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbor
1 [1] Bilinear Interpolation
2 [2] Inverse Distance Interpolation
3 [3] Bicubic Spline Interpolation
4 [4] B-Spline Interpolation
Default: 0
Outputs

Result [vector] <put output description here>


Console usage
processing.runalg(saga:addgridvaluestoshapes, shapes, grids, interpol, result)

See also

Clip grid with polygon


Description

<put algortithm description here>

536

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input [raster] <put parameter description here>


Polygons [vector: polygon] <put parameter description here>
Outputs

Output [raster] <put output description here>


Console usage
processing.runalg(saga:clipgridwithpolygon, input, polygons, output)

See also

Contour lines from grid


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Minimum Contour Value [number] <put parameter description here>
Default: 0.0
Maximum Contour Value [number] <put parameter description here>
Default: 10000.0
Equidistance [number] <put parameter description here>
Default: 100.0
Outputs

Contour Lines [vector] <put output description here>


Console usage
processing.runalg(saga:contourlinesfromgrid, input, zmin, zmax, zstep, contour)

See also

Gradient vectors from directional components


Description

<put algortithm description here>

18.7. SAGA algorithm provider

537

QGIS User Guide, Release 2.6

Parameters

X Component [raster] <put parameter description here>


Y Component [raster] <put parameter description here>
Step [number] <put parameter description here>
Default: 1
Size Range Min [number] <put parameter description here>
Default: 25.0
Size Range Max [number] <put parameter description here>
Default: 100.0
Aggregation [selection] <put parameter description here>
Options:
0 [0] nearest neighbour
1 [1] mean value
Default: 0
Style [selection] <put parameter description here>
Options:
0 [0] simple line
1 [1] arrow
2 [2] arrow (centered to cell)
Default: 0
Outputs

Gradient Vectors [vector] <put output description here>


Console usage

processing.runalg(saga:gradientvectorsfromdirectionalcomponents, x, y, step, size_min, size_max,

See also

Gradient vectors from direction and length


Description

<put algortithm description here>


Parameters

Direction [raster] <put parameter description here>


Length [raster] <put parameter description here>

538

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Step [number] <put parameter description here>


Default: 1
Size Range Min [number] <put parameter description here>
Default: 25.0
Size Range Max [number] <put parameter description here>
Default: 100.0
Aggregation [selection] <put parameter description here>
Options:
0 [0] nearest neighbour
1 [1] mean value
Default: 0
Style [selection] <put parameter description here>
Options:
0 [0] simple line
1 [1] arrow
2 [2] arrow (centered to cell)
Default: 0
Outputs

Gradient Vectors [vector] <put output description here>


Console usage

processing.runalg(saga:gradientvectorsfromdirectionandlength, dir, len, step, size_min, size_max

See also

Gradient vectors from surface


Description

<put algortithm description here>


Parameters

Surface [raster] <put parameter description here>


Step [number] <put parameter description here>
Default: 1
Size Range Min [number] <put parameter description here>
Default: 25.0
Size Range Max [number] <put parameter description here>
Default: 100.0
18.7. SAGA algorithm provider

539

QGIS User Guide, Release 2.6

Aggregation [selection] <put parameter description here>


Options:
0 [0] nearest neighbour
1 [1] mean value
Default: 0
Style [selection] <put parameter description here>
Options:
0 [0] simple line
1 [1] arrow
2 [2] arrow (centered to cell)
Default: 0
Outputs

Gradient Vectors [vector] <put output description here>


Console usage

processing.runalg(saga:gradientvectorsfromsurface, surface, step, size_min, size_max, aggr, styl

See also

Grid statistics for polygons


Description

<put algortithm description here>


Parameters

Grids [multipleinput: rasters] <put parameter description here>


Polygons [vector: polygon] <put parameter description here>
Number of Cells [boolean] <put parameter description here>
Default: True
Minimum [boolean] <put parameter description here>
Default: True
Maximum [boolean] <put parameter description here>
Default: True
Range [boolean] <put parameter description here>
Default: True
Sum [boolean] <put parameter description here>
Default: True

540

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Mean [boolean] <put parameter description here>


Default: True
Variance [boolean] <put parameter description here>
Default: True
Standard Deviation [boolean] <put parameter description here>
Default: True
Quantiles [number] <put parameter description here>
Default: 0
Outputs

Statistics [vector] <put output description here>


Console usage
processing.runalg(saga:gridstatisticsforpolygons, grids, polygons, count, min, max, range, sum,

See also

Grid values to points (randomly)


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Frequency [number] <put parameter description here>
Default: 100
Outputs

Points [vector] <put output description here>


Console usage
processing.runalg(saga:gridvaluestopointsrandomly, grid, freq, points)

See also

Grid values to points


Description

<put algortithm description here>


18.7. SAGA algorithm provider

541

QGIS User Guide, Release 2.6

Parameters

Grids [multipleinput: rasters] <put parameter description here>


Polygons [vector: any] Optional.
<put parameter description here>
Exclude NoData Cells [boolean] <put parameter description here>
Default: True
Type [selection] <put parameter description here>
Options:
0 [0] nodes
1 [1] cells
Default: 0
Outputs

Shapes [vector] <put output description here>


Console usage
processing.runalg(saga:gridvaluestopoints, grids, polygons, nodata, type, shapes)

See also

Local minima and maxima


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Outputs

Minima [vector] <put output description here>


Maxima [vector] <put output description here>
Console usage
processing.runalg(saga:localminimaandmaxima, grid, minima, maxima)

542

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Vectorising grid classes


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Class Selection [selection] <put parameter description here>
Options:
0 [0] one single class specified by class identifier
1 [1] all classes
Default: 0
Class Identifier [number] <put parameter description here>
Default: 0
Vectorised class as... [selection] <put parameter description here>
Options:
0 [0] one single (multi-)polygon object
1 [1] each island as separated polygon
Default: 0
Outputs

Polygons [vector] <put output description here>


Console usage
processing.runalg(saga:vectorisinggridclasses, grid, class_all, class_id, split, polygons)

See also

18.7.15 Shapes lines


Convert points to line(s)
Description

Converts points to lines.

18.7. SAGA algorithm provider

543

QGIS User Guide, Release 2.6

Parameters

Points [vector: point] Points to convert.


Order by... [tablefield: any] Lines will be ordered following this field.
Separate by... [tablefield: any] Lines will be grouped according to this field.
Outputs

Lines [vector] The resulting layer.


Console usage
processing.runalg(saga:convertpointstolines, points, order, separate, lines)

See also

Convert polygons to lines


Description

Creates lines from polygons.


Parameters

Polygons [vector: polygon] Layer to process.


Outputs

Lines [vector] The resulting layer.


Console usage
processing.runalg(saga:convertpolygonstolines, polygons, lines)

See also

Line dissolve
Description

<put algortithm description here>


Parameters

Lines [vector: any] <put parameter description here>


1. Attribute [tablefield: any] <put parameter description here>
2. Attribute [tablefield: any] <put parameter description here>
544

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

3. Attribute [tablefield: any] <put parameter description here>


Dissolve... [selection] <put parameter description here>
Options:
0 [0] lines with same attribute value(s)
1 [1] all lines
Default: 0
Outputs

Dissolved Lines [vector] <put output description here>


Console usage
processing.runalg(saga:linedissolve, lines, field_1, field_2, field_3, all, dissolved)

See also

Line-polygon intersection
Description

<put algortithm description here>


Parameters

Lines [vector: line] <put parameter description here>


Polygons [vector: polygon] <put parameter description here>
Output [selection] <put parameter description here>
Options:
0 [0] one multi-line per polygon
1 [1] keep original line attributes
Default: 0
Outputs

Intersection [vector] <put output description here>


Console usage
processing.runalg(saga:linepolygonintersection, lines, polygons, method, intersect)

18.7. SAGA algorithm provider

545

QGIS User Guide, Release 2.6

See also

Line properties
Description

Calculates some information on each line of the layer.


Parameters

Lines [vector: line] Layer to analyze.


Number of Parts [boolean] Determites whether to calculate number of segments in line.
Default: True
Number of Vertices [boolean] Determites whether to calculate number of vertices in line.
Default: True
Length [boolean] Determites whether to calculate total line lenght.
Default: True
Outputs

Lines with Property Attributes [vector] The resulting layer.


Console usage
processing.runalg(saga:lineproperties, lines, bparts, bpoints, blength, output)

See also

Line simplification
Description

Simplyfies the geometry of a lines layer.


Parameters

Lines [vector: line] Layer to process.


Tolerance [number] Simplification tolerance.
Default: 1.0
Outputs

Simplified Lines [vector] The resulting layer.

546

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:linesimplification, lines, tolerance, output)

See also

18.7.16 Shapes points


Add coordinates to points
Description

Adds the X and Y coordinates of feature in the attribute table of input layer.
Parameters

Points [vector: point] Input layer.


Outputs

Output [vector] Resulting layer with the updated attribute table.


Console usage
processing.runalg(saga:addcoordinatestopoints, input, output)

See also

Add polygon attributes to points


Description

Adds the specified field of the polygons layer to the attribute table of the points layer. The new attributes added
for each point depend on the value of the background polygon layer.
Parameters

Points [vector: point] Points layer.


Polygons [vector: polygon] Background polygons layer.
Attribute [tablefield: any] Attribute of the polygons layer that will be added to the points layer.
Outputs

Result [vector] The resulting layer.

18.7. SAGA algorithm provider

547

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:addpolygonattributestopoints, input, polygons, field, output)

See also

Aggregate point observations


Description

<put algortithm description here>


Parameters

Reference Points [vector: any] <put parameter description here>


ID [tablefield: any] <put parameter description here>
Observations [table] <put parameter description here>
X [tablefield: any] <put parameter description here>
Y [tablefield: any] <put parameter description here>
Track [tablefield: any] <put parameter description here>
Date [tablefield: any] <put parameter description here>
Time [tablefield: any] <put parameter description here>
Parameter [tablefield: any] <put parameter description here>
Maximum Time Span (Seconds) [number] <put parameter description here>
Default: 60.0
Maximum Distance [number] <put parameter description here>
Default: 0.002
Outputs

Aggregated [table] <put output description here>


Console usage
processing.runalg(saga:aggregatepointobservations, reference, reference_id, observations, x, y,

See also

Clip points with polygons


Description

<put algortithm description here>

548

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Points [vector: point] <put parameter description here>


Polygons [vector: polygon] <put parameter description here>
Add Attribute to Clipped Points [tablefield: any] <put parameter description here>
Clipping Options [selection] <put parameter description here>
Options:
0 [0] one layer for all points
1 [1] separate layer for each polygon
Default: 0
Outputs

Clipped Points [vector] <put output description here>


Console usage
processing.runalg(saga:clippointswithpolygons, points, polygons, field, method, clips)

See also

Convert lines to points


Description

Converts lines layer into a points.


Parameters

Lines [vector: line] Lines layer to convert.


Insert Additional Points [boolean] Determines whether to add additional nodes or not.
Default: True
Insert Distance [number] Distance between the additional points.
Default: 1.0
Outputs

Points [vector] The resulting layer.


Console usage
processing.runalg(saga:convertlinestopoints, lines, add, dist, points)

18.7. SAGA algorithm provider

549

QGIS User Guide, Release 2.6

See also

Convert multipoints to points


Description

<put algortithm description here>


Parameters

Multipoints [vector: point] <put parameter description here>


Outputs

Points [vector] <put output description here>


Console usage
processing.runalg(saga:convertmultipointstopoints, multipoints, points)

See also

Convex hull
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Hull Construction [selection] <put parameter description here>
Options:
0 [0] one hull for all shapes
1 [1] one hull per shape
2 [2] one hull per shape part
Default: 0
Outputs

Convex Hull [vector] <put output description here>


Minimum Bounding Box [vector] <put output description here>
Console usage

550

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

processing.runalg(saga:convexhull, shapes, polypoints, hulls, boxes)

See also

Distance matrix
Description

Generates a distance matrix between each point of the input layer. A unique ID will be created in the first row of
the resulting matrix (symmetric matrix), while every other cell reflects the distance between the points.
Parameters

Points [vector: point] Input layer.


Outputs

Distance Matrix Table [table] The resulting table.


Console usage
processing.runalg(saga:distancematrix, points, table)

See also

Fit n points to shape


Description

<put algortithm description here>


Parameters

Shapes [vector: polygon] <put parameter description here>


Number of points [number] <put parameter description here>
Default: 10
Outputs

Points [vector] <put output description here>


Console usage
processing.runalg(saga:fitnpointstoshape, shapes, numpoints, points)

18.7. SAGA algorithm provider

551

QGIS User Guide, Release 2.6

See also

Points filter
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Radius [number] <put parameter description here>
Default: 1
Minimum Number of Points [number] <put parameter description here>
Default: 0
Maximum Number of Points [number] <put parameter description here>
Default: 0
Quadrants [boolean] <put parameter description here>
Default: True
Filter Criterion [selection] <put parameter description here>
Options:
0 [0] keep maxima (with tolerance)
1 [1] keep minima (with tolerance)
2 [2] remove maxima (with tolerance)
3 [3] remove minima (with tolerance)
4 [4] remove below percentile
5 [5] remove above percentile
Default: 0
Tolerance [number] <put parameter description here>
Default: 0.0
Percentile [number] <put parameter description here>
Default: 50
Outputs

Filtered Points [vector] <put output description here>


Console usage

processing.runalg(saga:pointsfilter, points, field, radius, minnum, maxnum, quadrants, method, t

552

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Points thinning
Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Resolution [number] <put parameter description here>
Default: 1.0
Outputs

Thinned Points [vector] <put output description here>


Console usage
processing.runalg(saga:pointsthinning, points, field, resolution, thinned)

See also

Remove duplicate points


Description

<put algortithm description here>


Parameters

Points [vector: any] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Point to Keep [selection] <put parameter description here>
Options:
0 [0] first point
1 [1] last point
2 [2] point with minimum attribute value
3 [3] point with maximum attribute value
Default: 0
Numeric Attribute Values [selection] <put parameter description here>
Options:
0 [0] take value from the point to be kept

18.7. SAGA algorithm provider

553

QGIS User Guide, Release 2.6

1 [1] minimum value of all duplicates


2 [2] maximum value of all duplicates
3 [3] mean value of all duplicates
Default: 0
Outputs

Result [vector] <put output description here>


Console usage
processing.runalg(saga:removeduplicatepoints, points, field, method, numeric, result)

See also

Separate points by direction


Description

<put algortithm description here>


Parameters

Points [vector: point] <put parameter description here>


Number of Directions [number] <put parameter description here>
Default: 4
Tolerance (Degree) [number] <put parameter description here>
Default: 5
Outputs

Ouput [vector] <put output description here>


Console usage
processing.runalg(saga:separatepointsbydirection, points, directions, tolerance, output)

See also

554

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

18.7.17 Shapes polygons


Convert lines to polygons
Description

Converts lines to polygons.


Parameters

Lines [vector: line] Lines to convert.


Outputs

Polygons [vector] The resulting layer.


Console usage
processing.runalg(saga:convertlinestopolygons, lines, polygons)

See also

Convert polygon/line vertices to points


Description

Converts the line or polygon vertices into points.


Parameters

Shapes [vector: any] Layer to process.


Outputs

Points [vector] The resulting layer.


Console usage
processing.runalg(saga:convertpolygonlineverticestopoints, shapes, points)

See also

Polygon centroids
Description

Calculates the centroids of polygons.

18.7. SAGA algorithm provider

555

QGIS User Guide, Release 2.6

Parameters

Polygons [vector: polygon] Input layer.


Centroids for each part [boolean] Determites whether centroids should be calculated for each part of
multipart polygon or not.
Default: True
Outputs

Centroids [vector] The resulting layer.


Console usage
processing.runalg(saga:polygoncentroids, polygons, method, centroids)

See also

Polygon dissolve
Description

<put algortithm description here>


Parameters

Polygons [vector: polygon] <put parameter description here>


1. Attribute [tablefield: any] Optional.
<put parameter description here>
2. Attribute [tablefield: any] Optional.
<put parameter description here>
3. Attribute [tablefield: any] Optional.
<put parameter description here>
Dissolve... [selection] <put parameter description here>
Options:
0 [0] polygons with same attribute value
1 [1] all polygons
2 [2] polygons with same attribute value (keep inner boundaries)
3 [3] all polygons (keep inner boundaries)
Default: 0
Outputs

Dissolved Polygons [vector] <put output description here>

556

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:polygondissolve, polygons, field_1, field_2, field_3, dissolve, dissolved

See also

Polygon-line intersection
Description

<put algortithm description here>


Parameters

Polygons [vector: polygon] <put parameter description here>


Lines [vector: line] <put parameter description here>
Outputs

Intersection [vector] <put output description here>


Console usage
processing.runalg(saga:polygonlineintersection, polygons, lines, intersect)

See also

Polygon parts to separate polygons


Description

<put algortithm description here>


Parameters

Polygons [vector: polygon] <put parameter description here>


Ignore Lakes [boolean] <put parameter description here>
Default: True
Outputs

Polygon Parts [vector] <put output description here>


Console usage
processing.runalg(saga:polygonpartstoseparatepolygons, polygons, lakes, parts)

18.7. SAGA algorithm provider

557

QGIS User Guide, Release 2.6

See also

Polygon properties
Description

<put algortithm description here>


Parameters

Polygons [vector: polygon] <put parameter description here>


Number of Parts [boolean] <put parameter description here>
Default: True
Number of Vertices [boolean] <put parameter description here>
Default: True
Perimeter [boolean] <put parameter description here>
Default: True
Area [boolean] <put parameter description here>
Default: True
Outputs

Polygons with Property Attributes [vector] <put output description here>


Console usage
processing.runalg(saga:polygonproperties, polygons, bparts, bpoints, blength, barea, output)

See also

Polygon shape indices


Description

Calculates spatial statistics for polygons. This includes:


area
perimeter
perimeter / area
perimeter / square root of the area
maximum distance
maximum distance / area
maximum distance / square root of the area
shape index

558

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Shapes [vector: polygon] Layer to analyze.


Outputs

Shape Index [vector] The resulting layer.


Console usage
processing.runalg(saga:polygonshapeindices, shapes, index)

See also

Polygons to edges and nodes


Description

Extracts boundaries and nodes of polygons in separate files.


Parameters

Polygons [vector: polygon] Input layer.


Outputs

Edges [vector] Resulting line layer with polygons boundaries.


Nodes [vector] Resulting line layer with polygons nodes.
Console usage
processing.runalg(saga:polygonstoedgesandnodes, polygons, edges, nodes)

See also

18.7.18 Shapes tools


Create graticule
Description

Creates a grid.

18.7. SAGA algorithm provider

559

QGIS User Guide, Release 2.6

Parameters

Extent [vector: any] Optional.


Grid will be created according to the selected layer.
Output extent [extent] Extent of the grid.
Default: 0,1,0,1
Division Width [number] X-axes spacing between the lines.
Default: 1.0
Division Height [number] Y-axes spacing between the lines.
Default: 1.0
Type [selection] Geometry type of the resulting grid.
Options:
0 [0] Lines
1 [1] Rectangles
Default: 0
Outputs

Graticule [vector] The resulting layer.


Console usage
processing.runalg(saga:creategraticule, extent, output_extent, distx, disty, type, graticule)

See also

Cut shapes layer


Description

<put algortithm description here>


Parameters

Vector layer to cut [vector: any] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] completely contained
1 [1] intersects
2 [2] center
Default: 0
Cutting polygons [vector: any] <put parameter description here>

560

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Result [vector] <put output description here>


Extent [vector] <put output description here>
Console usage
processing.runalg(saga:cutshapeslayer, shapes, method, polygons_polygons, cut, extent)

See also

Get shapes extents


Description

Creates polygons according to the extent of the input layer features.


Parameters

Shapes [vector: any] Input layer.


Parts [boolean] Determines whether create polygon for each feature (True) or just create single polygon for
whole layer (False).
Default: True
Outputs

Extents [vector] The resulting layer.


Console usage
processing.runalg(saga:getshapesextents, shapes, parts, extents)

See also

Merge shapes layers


Description

Merges two or more input layer into a unique resulting layer. You can merge together only layer of the same type
(polygons with polygons, lines with lines, points with points).
The attribute table of the resulting layer will include only the attributes of the first input layer. Two additional
columns will be added: one corresponding to the ID of every merged layer and the other one corresponding to the
original name of the merged layer.

18.7. SAGA algorithm provider

561

QGIS User Guide, Release 2.6

Parameters

Main Layer [vector: any] Initial layer.


Additional Layers [multipleinput: any vectors] Optional.
Layer(s) to merge with.
Outputs

Merged Layer [vector] The resulting layer.


Console usage
processing.runalg(saga:mergeshapeslayers, main, layers, out)

See also

Polar to cartesian coordinates


Description

<put algortithm description here>


Parameters

Polar Coordinates [vector: any] <put parameter description here>


Exaggeration [tablefield: any] <put parameter description here>
Exaggeration Factor [number] <put parameter description here>
Default: 1
Radius [number] <put parameter description here>
Default: 6371000.0
Degree [boolean] <put parameter description here>
Default: True
Outputs

Cartesian Coordinates [vector] <put output description here>


Console usage

processing.runalg(saga:polartocartesiancoordinates, polar, f_exagg, d_exagg, radius, degree, car

562

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Quadtree structure to shapes


Description

<put algortithm description here>


Parameters

Shapes [vector: any] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Outputs

Polygons [vector] <put output description here>


Lines [vector] <put output description here>
Duplicated Points [vector] <put output description here>
Console usage
processing.runalg(saga:quadtreestructuretoshapes, shapes, attribute, polygons, lines, points)

See also

Shapes buffer
Description

Creates buffer around features based on fixed distance or distance field.


Parameters

Shapes [vector: any] Input layer.


Buffer Distance [selection] Buffering method.
Options:
0 [0] fixed value
1 [1] attribute field
Default: 0
Buffer Distance (Fixed) [number] Buffer distance for fixed value method.
Default: 100.0
Buffer Distance (Attribute) [tablefield: any] Name of the distance field for attribute field method.
Scaling Factor for Attribute Value [number] <put parameter description here>
Default: 1.0

18.7. SAGA algorithm provider

563

QGIS User Guide, Release 2.6

Number of Buffer Zones [number] Number of buffer(s) to generate.


Default: 1.0
Circle Point Distance [Degree] [number] Smoothness of the buffer borders: great numbers means
rough borders.
Default: 5.0
Dissolve Buffers [boolean] Determines whether to dissolve results or not.
Default: True
Outputs

Buffer [vector] The resulting layer.


Console usage

processing.runalg(saga:shapesbuffer, shapes, buf_type, buf_dist, buf_field, buf_scale, buf_zones

See also

Split shapes layer randomly


Description

Splits the input layer randomly in two parts.


Parameters

Shapes [vector: any] Layer to split.


Split ratio (%) [number] Split ratio between the resulting layers.
Default: 50
Outputs

Group A [vector] First resulting layer.


Group B [vector] Second resulting layer.
Console usage
processing.runalg(saga:splitshapeslayerrandomly, shapes, percent, a, b)

See also

Transform shapes
Description

<put algortithm description here>

564

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Shapes [vector: any] <put parameter description here>


dX [number] <put parameter description here>
Default: 0.0
dY [number] <put parameter description here>
Default: 0.0
Angle [number] <put parameter description here>
Default: 0.0
Scale Factor X [number] <put parameter description here>
Default: 1.0
Scale Factor Y [number] <put parameter description here>
Default: 1.0
X [number] <put parameter description here>
Default: 0.0
Y [number] <put parameter description here>
Default: 0.0
Outputs

Output [vector] <put output description here>


Console usage

processing.runalg(saga:transformshapes, in, dx, dy, angle, scalex, scaley, anchorx, anchory, out

See also

18.7.19 Shapes transect


Transect through polygon shapefile
Description

<put algortithm description here>


Parameters

Line Transect(s) [vector: line] <put parameter description here>


Theme [vector: any] <put parameter description here>
Theme Field [tablefield: any] <put parameter description here>

18.7. SAGA algorithm provider

565

QGIS User Guide, Release 2.6

Outputs

Result table [table] <put output description here>


Console usage

processing.runalg(saga:transectthroughpolygonshapefile, transect, theme, theme_field, transect_r

See also

18.7.20 Simulation fire


Fire risk analysis
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Fuel Model [raster] <put parameter description here>
Wind Speed [raster] <put parameter description here>
Wind Direction [raster] <put parameter description here>
Dead Fuel Moisture 1H [raster] <put parameter description here>
Dead Fuel Moisture 10H [raster] <put parameter description here>
Dead Fuel Moisture 100H [raster] <put parameter description here>
Herbaceous Fuel Moisture [raster] <put parameter description here>
Wood Fuel Moisture [raster] <put parameter description here>
Value [raster] Optional.
<put parameter description here>
Base Probability [raster] Optional.
<put parameter description here>
Number of Events [number] <put parameter description here>
Default: 1000
Fire Length [number] <put parameter description here>
Default: 100

566

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Danger [raster] <put output description here>


Compound Probability [raster] <put output description here>
Priority Index [raster] <put output description here>
Console usage

processing.runalg(saga:fireriskanalysis, dem, fuel, windspd, winddir, m1h, m10h, m100h, mherb, m

See also

Simulation
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Fuel Model [raster] <put parameter description here>
Wind Speed [raster] <put parameter description here>
Wind Direction [raster] <put parameter description here>
Dead Fuel Moisture 1H [raster] <put parameter description here>
Dead Fuel Moisture 10H [raster] <put parameter description here>
Dead Fuel Moisture 100H [raster] <put parameter description here>
Herbaceous Fuel Moisture [raster] <put parameter description here>
Wood Fuel Moisture [raster] <put parameter description here>
Ignition Points [raster] <put parameter description here>
Update View [boolean] <put parameter description here>
Default: True
Outputs

Time [raster] <put output description here>


Flame Length [raster] <put output description here>
Intensity [raster] <put output description here>
Console usage
processing.runalg(saga:simulation, dem, fuel, windspd, winddir, m1h, m10h, m100h, mherb, mwood,

18.7. SAGA algorithm provider

567

QGIS User Guide, Release 2.6

See also

18.7.21 Simulation hydrology


Overland flow - kinematic wave d8
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Gauges [vector: any] Optional.
<put parameter description here>
Simulation Time [h] [number] <put parameter description here>
Default: 24
Simulation Time Step [h] [number] <put parameter description here>
Default: 0.1
Mannings Roughness [number] <put parameter description here>
Default: 0.03
Max. Iterations [number] <put parameter description here>
Default: 100
Epsilon [number] <put parameter description here>
Default: 0.0001
Precipitation [selection] <put parameter description here>
Options:
0 [0] Homogenous
1 [1] Above Elevation
2 [2] Left Half
Default: 0
Threshold Elevation [number] <put parameter description here>
Default: 0.0
Outputs

Runoff [raster] <put output description here>


Flow at Gauges [table] <put output description here>

568

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:overlandflowkinematicwaved8, dem, gauges, time_span, time_step, roughness

See also

Water retention capacity


Description

<put algortithm description here>


Parameters

Plot Holes [vector: any] <put parameter description here>


DEM [raster] <put parameter description here>
Outputs

Final Parameters [vector] <put output description here>


Water Retention Capacity [raster] <put output description here>
Console usage
processing.runalg(saga:waterretentioncapacity, shapes, dem, output, retention)

See also

18.7.22 Table calculus


Fill gaps in records
Description

<put algortithm description here>


Parameters

Table [table] <put parameter description here>


Order [tablefield: any] <put parameter description here>
Interpolation [selection] <put parameter description here>
Options:
0 [0] Nearest Neighbour
1 [1] Linear

18.7. SAGA algorithm provider

569

QGIS User Guide, Release 2.6

2 [2] Spline
Default: 0
Outputs

Table without Gaps [table] <put output description here>


Console usage
processing.runalg(saga:fillgapsinrecords, table, order, method, nogaps)

See also

Principle components analysis


Description

<put algortithm description here>


Parameters

Table [table] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] correlation matrix
1 [1] variance-covariance matrix
2 [2] sums-of-squares-and-cross-products matrix
Default: 0
Number of Components [number] <put parameter description here>
Default: 3
Outputs

Principle Components [table] <put output description here>


Console usage
processing.runalg(saga:principlecomponentsanalysis, table, method, nfirst, pca)

See also

Running average
Description

<put algortithm description here>


570

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Input [table] <put parameter description here>


Attribute [tablefield: any] <put parameter description here>
Number of Records [number] <put parameter description here>
Default: 10
Outputs

Output [table] <put output description here>


Console usage
processing.runalg(saga:runningaverage, input, field, count, output)

See also

18.7.23 Table tools


Change date format
Description

Converts the date format of the input layer.


Parameters

Table [table] Input table.


Date Field [tablefield: any] Attribute the date.
Input Format [selection] Input date format.
Options:
0 [0] dd.mm.yy
1 [1] yy.mm.dd
2 [2] dd:mm:yy
3 [3] yy:mm:dd
4 [4] ddmmyyyy, fix size
5 [5] yyyymmdd, fix size
6 [6] ddmmyy, fix size
7 [7] yymmdd, fix size
8 [8] Julian Day
Default: 0

18.7. SAGA algorithm provider

571

QGIS User Guide, Release 2.6

Output Format [selection] Output date format.


Options:
0 [0] dd.mm.yy
1 [1] yy.mm.dd
2 [2] dd:mm:yy
3 [3] yy:mm:dd
4 [4] ddmmyyyy, fix size
5 [5] yyyymmdd, fix size
6 [6] ddmmyy, fix size
7 [7] yymmdd, fix size
8 [8] Julian Day
Default: 0
Outputs

Output [table] The resulting table.


Console usage
processing.runalg(saga:changedateformat, table, field, fmt_in, fmt_out, output)

See also

Change time format


Description

Converts the time format of the input layer.


Parameters

Table [table] Input table.


Time Field [tablefield: any] Attribute with time.
Input Format [selection] Input time format.
Options:
0 [0] hh.mm.ss
1 [1] hh:mm:ss
2 [2] hhmmss, fix size
3 [3] hours
4 [4] minutes
5 [5] seconds
Default: 0

572

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Output Format [selection] Output time format.


Options:
0 [0] hh.mm.ss
1 [1] hh:mm:ss
2 [2] hhmmss, fix size
3 [3] hours
4 [4] minutes
5 [5] seconds
Default: 0
Outputs

Output [table] The resulting table.


Console usage
processing.runalg(saga:changetimeformat, table, field, fmt_in, fmt_out, output)

See also

18.7.24 Terrain channels


Channel network and drainage basins
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Threshold [number] <put parameter description here>
Default: 5.0
Outputs

Flow Direction [raster] <put output description here>


Flow Connectivity [raster] <put output description here>
Strahler Order [raster] <put output description here>
Drainage Basins [raster] <put output description here>
Channels [vector] <put output description here>
Drainage Basins [vector] <put output description here>

18.7. SAGA algorithm provider

573

QGIS User Guide, Release 2.6

Junctions [vector] <put output description here>


Console usage

processing.runalg(saga:channelnetworkanddrainagebasins, dem, threshold, direction, connection, o

See also

Channel network
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Flow Direction [raster] Optional.
<put parameter description here>
Initiation Grid [raster] <put parameter description here>
Initiation Type [selection] <put parameter description here>
Options:
0 [0] Less than
1 [1] Equals
2 [2] Greater than
Default: 0
Initiation Threshold [number] <put parameter description here>
Default: 0.0
Divergence [raster] Optional.
<put parameter description here>
Tracing: Max. Divergence [number] <put parameter description here>
Default: 10
Tracing: Weight [raster] Optional.
<put parameter description here>
Min. Segment Length [number] <put parameter description here>
Default: 10
Outputs

Channel Network [raster] <put output description here>


Channel Direction [raster] <put output description here>
Channel Network [vector] <put output description here>

574

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:channelnetwork, elevation, sinkroute, init_grid, init_method, init_value,

See also

Overland flow distance to channel network


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Channel Network [raster] <put parameter description here>
Flow Algorithm [selection] <put parameter description here>
Options:
0 [0] D8
1 [1] MFD
Default: 0
Outputs

Overland Flow Distance [raster] <put output description here>


Vertical Overland Flow Distance [raster] <put output description here>
Horizontal Overland Flow Distance [raster] <put output description here>
Console usage

processing.runalg(saga:overlandflowdistancetochannelnetwork, elevation, channels, method, distan

See also

Strahler order
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>

18.7. SAGA algorithm provider

575

QGIS User Guide, Release 2.6

Outputs

Strahler Order [raster] <put output description here>


Console usage
processing.runalg(saga:strahlerorder, dem, strahler)

See also

Vertical distance to channel network


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Channel Network [raster] <put parameter description here>
Tension Threshold [Percentage of Cell Size] [number] <put parameter description here>
Default: 1
Keep Base Level below Surface [boolean] <put parameter description here>
Default: True
Outputs

Vertical Distance to Channel Network [raster] <put output description here>


Channel Network Base Level [raster] <put output description here>
Console usage

processing.runalg(saga:verticaldistancetochannelnetwork, elevation, channels, threshold, nounder

See also

Watershed basins
Description

<put algortithm description here>

576

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Elevation [raster] <put parameter description here>


Channel Network [raster] <put parameter description here>
Sink Route [raster] Optional.
<put parameter description here>
Min. Size [number] <put parameter description here>
Default: 0
Outputs

Watershed Basins [raster] <put output description here>


Console usage
processing.runalg(saga:watershedbasins, elevation, channels, sinkroute, minsize, basins)

See also

18.7.25 Terrain hydrology


Burn stream network into dem
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Streams [raster] <put parameter description here>
Method [selection] <put parameter description here>
Options:
0 [0] simply decrease cells value by epsilon
1 [1] lower cells value to neighbours minimum value minus epsilon
Default: 0
Epsilon [number] <put parameter description here>
Default: 1.0
Outputs

Processed DEM [raster] <put output description here>

18.7. SAGA algorithm provider

577

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:burnstreamnetworkintodem, dem, stream, method, epsilon, burn)

See also

Catchment area (flow tracing)


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Sink Routes [raster] Optional.
<put parameter description here>
Weight [raster] Optional.
<put parameter description here>
Material [raster] Optional.
<put parameter description here>
Target [raster] Optional.
<put parameter description here>
Step [number] <put parameter description here>
Default: 1
Method [selection] <put parameter description here>
Options:
0 [0] Rho 8
1 [1] Kinematic Routing Algorithm
2 [2] DEMON
Default: 0
DEMON - Min. DQV [number] <put parameter description here>
Default: 0.0
Flow Correction [boolean] <put parameter description here>
Default: True
Outputs

Catchment Area [raster] <put output description here>


Catchment Height [raster] <put output description here>
Catchment Slope [raster] <put output description here>
Total accumulated Material [raster] <put output description here>

578

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Accumulated Material from _left_ side [raster] <put output description here>
Accumulated Material from _right_ side [raster] <put output description here>
Console usage

processing.runalg(saga:catchmentareaflowtracing, elevation, sinkroute, weight, material, target,

See also

Catchment area (recursive)


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Sink Routes [raster] Optional.
<put parameter description here>
Weight [raster] Optional.
<put parameter description here>
Material [raster] Optional.
<put parameter description here>
Target [raster] Optional.
<put parameter description here>
Step [number] <put parameter description here>
Default: 1
Target Areas [raster] Optional.
<put parameter description here>
Method [selection] <put parameter description here>
Options:
0 [0] Deterministic 8
1 [1] Rho 8
2 [2] Deterministic Infinity
3 [3] Multiple Flow Direction
Default: 0
Convergence [number] <put parameter description here>
Default: 1.1

18.7. SAGA algorithm provider

579

QGIS User Guide, Release 2.6

Outputs

Catchment Area [raster] <put output description here>


Catchment Height [raster] <put output description here>
Catchment Slope [raster] <put output description here>
Total accumulated Material [raster] <put output description here>
Accumulated Material from _left_ side [raster] <put output description here>
Accumulated Material from _right_ side [raster] <put output description here>
Flow Path Length [raster] <put output description here>
Console usage

processing.runalg(saga:catchmentarearecursive, elevation, sinkroute, weight, material, target, s

See also

Catchment Area
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Deterministic 8
1 [1] Rho 8
2 [2] Braunschweiger Reliefmodell
3 [3] Deterministic Infinity
4 [4] Multiple Flow Direction
5 [5] Multiple Triangular Flow Directon
Default: 0
Outputs

Catchment Area [raster] <put output description here>


Console usage
processing.runalg(saga:catchmentarea, elevation, method, carea)

580

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Cell balance
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Parameter [raster] Optional.
<put parameter description here>
Default Weight [number] <put parameter description here>
Default: 1.0
Method [selection] <put parameter description here>
Options:
0 [0] Deterministic 8
1 [1] Multiple Flow Direction
Default: 0
Outputs

Cell Balance [raster] <put output description here>


Console usage
processing.runalg(saga:cellbalance, dem, weights, weight, method, balance)

See also

Edge contamination
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Outputs

Edge Contamination [raster] <put output description here>

18.7. SAGA algorithm provider

581

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:edgecontamination, dem, contamination)

See also

Fill Sinks
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Minimum Slope [Degree] [number] <put parameter description here>
Default: 0.01
Outputs

Filled DEM [raster] <put output description here>


Console usage
processing.runalg(saga:fillsinks, dem, minslope, result)

See also

Fill sinks (wang & liu)


Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Minimum Slope [Degree] [number] <put parameter description here>
Default: 0.01
Outputs

Filled DEM [raster] <put output description here>


Flow Directions [raster] <put output description here>
Watershed Basins [raster] <put output description here>

582

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:fillsinkswangliu, elev, minslope, filled, fdir, wshed)

See also

Fill sinks xxl (wang & liu)


Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Minimum Slope [Degree] [number] <put parameter description here>
Default: 0.01
Outputs

Filled DEM [raster] <put output description here>


Console usage
processing.runalg(saga:fillsinksxxlwangliu, elev, minslope, filled)

See also

Flat detection
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Flat Area Values [selection] <put parameter description here>
Options:
0 [0] elevation
1 [1] enumeration
Default: 0

18.7. SAGA algorithm provider

583

QGIS User Guide, Release 2.6

Outputs

No Flats [raster] <put output description here>


Flat Areas [raster] <put output description here>
Console usage
processing.runalg(saga:flatdetection, dem, flat_output, noflats, flats)

See also

Flow path length


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Seeds [raster] Optional.
<put parameter description here>
Seeds Only [boolean] <put parameter description here>
Default: True
Flow Routing Algorithm [selection] <put parameter description here>
Options:
0 [0] Deterministic 8 (D8)
1 [1] Multiple Flow Direction (FD8)
Default: 0
Convergence (FD8) [number] <put parameter description here>
Default: 1.1
Outputs

Flow Path Length [raster] <put output description here>


Console usage

processing.runalg(saga:flowpathlength, elevation, seed, seeds_only, method, convergence, length)

584

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Flow width and specific catchment area


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Total Catchment Area (TCA) [raster] Optional.
<put parameter description here>
Method [selection] <put parameter description here>
Options:
0 [0] Deterministic 8
1 [1] Multiple Flow Direction (Quinn et al. 1991)
2 [2] Aspect
Default: 0
Outputs

Flow Width [raster] <put output description here>


Specific Catchment Area (SCA) [raster] <put output description here>
Console usage
processing.runalg(saga:flowwidthandspecificcatchmentarea, dem, tca, method, width, sca)

See also

Lake flood
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Seeds [raster] <put parameter description here>
Absolute Water Levels [boolean] <put parameter description here>
Default: True

18.7. SAGA algorithm provider

585

QGIS User Guide, Release 2.6

Outputs

Lake [raster] <put output description here>


Surface [raster] <put output description here>
Console usage
processing.runalg(saga:lakeflood, elev, seeds, level, outdepth, outlevel)

See also

Ls factor
Description

<put algortithm description here>


Parameters

Slope [raster] <put parameter description here>


Catchment Area [raster] <put parameter description here>
Area to Length Conversion [selection] <put parameter description here>
Options:
0 [0] no conversion (areas already given as specific catchment area)
1 [1] 1 / cell size (specific catchment area)
2 [2] square root (catchment length)
Default: 0
Method (LS) [selection] <put parameter description here>
Options:
0 [0] Moore et al. 1991
1 [1] Desmet & Govers 1996
2 [2] Boehner & Selige 2006
Default: 0
Rill/Interrill Erosivity [number] <put parameter description here>
Default: 0.0
Stability [selection] <put parameter description here>
Options:
0 [0] stable
1 [1] instable (thawing)
Default: 0

586

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

LS Factor [raster] <put output description here>


Console usage
processing.runalg(saga:lsfactor, slope, area, conv, method, erosivity, stability, ls)

See also

Saga wetness index


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


t [number] <put parameter description here>
Default: 10
Outputs

Catchment area [raster] <put output description here>


Catchment slope [raster] <put output description here>
Modified catchment area [raster] <put output description here>
Wetness index [raster] <put output description here>
Console usage
processing.runalg(saga:sagawetnessindex, dem, t, c, gn, cs, sb)

See also

Sink drainage route detection


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Threshold [boolean] <put parameter description here>
Default: True

18.7. SAGA algorithm provider

587

QGIS User Guide, Release 2.6

Threshold Height [number] <put parameter description here>


Default: 100.0
Outputs

Sink Route [raster] <put output description here>


Console usage
processing.runalg(saga:sinkdrainageroutedetection, elevation, threshold, thrsheight, sinkroute)

See also

Sink removal
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Sink Route [raster] Optional.
<put parameter description here>
Method [selection] <put parameter description here>
Options:
0 [0] Deepen Drainage Routes
1 [1] Fill Sinks
Default: 0
Threshold [boolean] <put parameter description here>
Default: True
Threshold Height [number] <put parameter description here>
Default: 100.0
Outputs

Preprocessed DEM [raster] <put output description here>


Console usage
processing.runalg(saga:sinkremoval, dem, sinkroute, method, threshold, thrsheight, dem_preproc)

588

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Slope length
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Outputs

Slope Length [raster] <put output description here>


Console usage
processing.runalg(saga:slopelength, dem, length)

See also

Stream power index


Description

<put algortithm description here>


Parameters

Slope [raster] <put parameter description here>


Catchment Area [raster] <put parameter description here>
Area Conversion [selection] <put parameter description here>
Options:
0 [0] no conversion (areas already given as specific catchment area)
1 [1] 1 / cell size (pseudo specific catchment area)
Default: 0
Outputs

Stream Power Index [raster] <put output description here>


Console usage
processing.runalg(saga:streampowerindex, slope, area, conv, spi)

18.7. SAGA algorithm provider

589

QGIS User Guide, Release 2.6

See also

Topographic wetness index (twi)


Description

<put algortithm description here>


Parameters

Slope [raster] <put parameter description here>


Catchment Area [raster] <put parameter description here>
Transmissivity [raster] Optional.
<put parameter description here>
Area Conversion [selection] <put parameter description here>
Options:
0 [0] no conversion (areas already given as specific catchment area)
1 [1] 1 / cell size (pseudo specific catchment area)
Default: 0
Method (TWI) [selection] <put parameter description here>
Options:
0 [0] Standard
1 [1] TOPMODEL
Default: 0
Outputs

Topographic Wetness Index [raster] <put output description here>


Console usage
processing.runalg(saga:topographicwetnessindextwi, slope, area, trans, conv, method, twi)

See also

Upslope Area
Description

<put algortithm description here>

590

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Target Area [raster] Optional.


<put parameter description here>
Target X coordinate [number] <put parameter description here>
Default: 0.0
Target Y coordinate [number] <put parameter description here>
Default: 0.0
Elevation [raster] <put parameter description here>
Sink Routes [raster] Optional.
<put parameter description here>
Method [selection] <put parameter description here>
Options:
0 [0] Deterministic 8
1 [1] Deterministic Infinity
2 [2] Multiple Flow Direction
Default: 0
Convergence [number] <put parameter description here>
Default: 1.1
Outputs

Upslope Area [raster] <put output description here>


Console usage

processing.runalg(saga:upslopearea, target, target_pt_x, target_pt_y, elevation, sinkroute, meth

See also

18.7.26 Terrain lighting


Analytical hillshading
Description

<put algortithm description here>

18.7. SAGA algorithm provider

591

QGIS User Guide, Release 2.6

Parameters

Elevation [raster] <put parameter description here>


Shading Method [selection] <put parameter description here>
Options:
0 [0] Standard
1 [1] Standard (max. 90Degree)
2 [2] Combined Shading
3 [3] Ray Tracing
Default: 0
Azimuth [Degree] [number] <put parameter description here>
Default: 315.0
Declination [Degree] [number] <put parameter description here>
Default: 45.0
Exaggeration [number] <put parameter description here>
Default: 4.0
Outputs

Analytical Hillshading [raster] <put output description here>


Console usage

processing.runalg(saga:analyticalhillshading, elevation, method, azimuth, declination, exaggerat

See also

Sky view factor


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Maximum Search Radius [number] <put parameter description here>
Default: 10000
Method [selection] <put parameter description here>
Options:
0 [0] multi scale
1 [1] sectors
Default: 0

592

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Multi Scale Factor [number] <put parameter description here>


Default: 3
Number of Sectors [number] <put parameter description here>
Default: 8
Outputs

Visible Sky [raster] <put output description here>


Sky View Factor [raster] <put output description here>
Sky View Factor (Simplified) [raster] <put output description here>
Terrain View Factor [raster] <put output description here>
Console usage

processing.runalg(saga:skyviewfactor, dem, maxradius, method, level_inc, ndirs, visible, svf, si

See also

Topographic correction
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Original Image [raster] <put parameter description here>
Azimuth [number] <put parameter description here>
Default: 180.0
Height [number] <put parameter description here>
Default: 45.0
Method [selection] <put parameter description here>
Options:
0 [0] Cosine Correction (Teillet et al. 1982)
1 [1] Cosine Correction (Civco 1989)
2 [2] Minnaert Correction
3 [3] Minnaert Correction with Slope (Riano et al. 2003)
4 [4] Minnaert Correction with Slope (Law & Nichol 2004)
5 [5] C Correction
6 [6] Normalization (after Civco, modified by Law & Nichol)
Default: 0

18.7. SAGA algorithm provider

593

QGIS User Guide, Release 2.6

Minnaert Correction [number] <put parameter description here>


Default: 0.5
Maximum Cells (C Correction Analysis) [number] <put parameter description here>
Default: 1000
Value Range [selection] <put parameter description here>
Options:
0 [0] 1 byte (0-255)
1 [1] 2 byte (0-65535)
Default: 0
Outputs

Corrected Image [raster] <put output description here>


Console usage

processing.runalg(saga:topographiccorrection, dem, original, azi, hgt, method, minnaert, maxcell

See also

18.7.27 Terrain morphometry


Convergence index
Description

Calculates an index of convergence/divergence regarding to overland flow. By its meaning it is similar to plan or
horizontal curvature, but gives much smoother results. The calculation uses the aspects of surrounding cells, i.e. it
looks to which degree surrounding cells point to the center cell. The result is given as percentages, negative values
correspond to convergent, positive to divergent flow conditions. Minus 100 would be like a peak of a cone, plus
100 a pit, and 0 an even slope.
Parameters

Elevation [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Aspect
1 [1] Gradient
Default: 0
Gradient Calculation [selection] <put parameter description here>
Options:
0 [0] 2 x 2
594

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

1 [1] 3 x 3
Default: 0
Outputs

Convergence Index [raster] <put output description here>


Console usage
processing.runalg(saga:convergenceindex, elevation, method, neighbours, result)

See also

Koethe, R. / Lehmeier, F. (1996): SARA, System zur Automatischen Relief-Analyse, Benutzerhandbuch,


2. Auflage [Geogr. Inst. Univ. Goettingen, unpublished]
Convergence index (search radius)
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Radius [Cells] [number] <put parameter description here>
Default: 10
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1
Gradient [boolean] <put parameter description here>
Default: True

18.7. SAGA algorithm provider

595

QGIS User Guide, Release 2.6

Difference [selection] <put parameter description here>


Options:
0 [0] direction to the center cell
1 [1] center cells aspect direction
Default: 0
Outputs

Convergence Index [raster] <put output description here>


Console usage

processing.runalg(saga:convergenceindexsearchradius, elevation, radius, distance_weighting_weigh

See also

Curvature classification
Description

<put algortithm description here>


Parameters

Plan Curvature [raster] <put parameter description here>


Profile Curvature [raster] <put parameter description here>
Threshold for plane [number] <put parameter description here>
Default: 0.001
Outputs

Curvature Classification [raster] <put output description here>


Console usage
processing.runalg(saga:curvatureclassification, cplan, cprof, threshold, class)

See also

Diurnal anisotropic heating


Description

<put algortithm description here>

596

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Elevation [raster] <put parameter description here>


Alpha Max (Degree) [number] <put parameter description here>
Default: 202.5
Outputs

Diurnal Anisotropic Heating [raster] <put output description here>


Console usage
processing.runalg(saga:diurnalanisotropicheating, dem, alpha_max, dah)

See also

Downslope distance gradient


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Vertical Distance [number] <put parameter description here>
Default: 10
Output [selection] <put parameter description here>
Options:
0 [0] distance
1 [1] gradient (tangens)
2 [2] gradient (degree)
Default: 0
Outputs

Gradient [raster] <put output description here>


Gradient Difference [raster] <put output description here>
Console usage
processing.runalg(saga:downslopedistancegradient, dem, distance, output, gradient, difference)

18.7. SAGA algorithm provider

597

QGIS User Guide, Release 2.6

See also

Effective air flow heights


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Wind Direction [raster] Optional.
<put parameter description here>
Wind Speed [raster] Optional.
<put parameter description here>
Constant Wind Direction [Degree] [number] <put parameter description here>
Default: 135
Old Version [boolean] <put parameter description here>
Default: True
Search Distance [km] [number] <put parameter description here>
Default: 300
Acceleration [number] <put parameter description here>
Default: 1.5
Use Pyramids with New Version [boolean] <put parameter description here>
Default: True
Lee Factor [number] <put parameter description here>
Default: 0.5
Luv Factor [number] <put parameter description here>
Default: 1.0
Wind Direction Units [selection] <put parameter description here>
Options:
0 [0] radians
1 [1] degree
Default: 0
Wind Speed Scale Factor [number] <put parameter description here>
Default: 1.0
Outputs

Effective Air Flow Heights [raster] <put output description here>

598

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:effectiveairflowheights, dem, dir, len, dir_const, oldver, maxdist, accel

See also

Hypsometry
Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Number of Classes [number] <put parameter description here>
Default: 100.0
Sort [selection] <put parameter description here>
Options:
0 [0] up
1 [1] down
Default: 0
Classification Constant [selection] <put parameter description here>
Options:
0 [0] height
1 [1] area
Default: 0
Use Z-Range [boolean] <put parameter description here>
Default: True
Z-Range Min [number] <put parameter description here>
Default: 0.0
Z-Range Max [number] <put parameter description here>
Default: 1000.0
Outputs

Hypsometry [table] <put output description here>


Console usage

processing.runalg(saga:hypsometry, elevation, count, sorting, method, bzrange, zrange_min, zrang

18.7. SAGA algorithm provider

599

QGIS User Guide, Release 2.6

See also

Land surface temperature


Description

<put algortithm description here>


Parameters

Elevation [m] [raster] <put parameter description here>


Short Wave Radiation [kW/m2] [raster] <put parameter description here>
Leaf Area Index [raster] <put parameter description here>
Elevation at Reference Station [m] [number] <put parameter description here>
Default: 0.0
Temperature at Reference Station [Deg.Celsius] [number] <put
here>

parameter

description

Default: 0.0
Temperature Gradient [Deg.Celsius/km] [number] <put parameter description here>
Default: 6.5
C Factor [number] <put parameter description here>
Default: 1.0
Outputs

Land Surface Temperature [Deg.Celsius] [raster] <put output description here>


Console usage

processing.runalg(saga:landsurfacetemperature, dem, swr, lai, z_reference, t_reference, t_gradie

See also

Mass balance index


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Vertical Distance to Channel Network [raster] Optional.
<put parameter description here>

600

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

T Slope [number] <put parameter description here>


Default: 15.0
T Curvature [number] <put parameter description here>
Default: 0.01
T Vertical Distance to Channel Network [number] <put parameter description here>
Default: 15.0
Outputs

Mass Balance Index [raster] <put output description here>


Console usage
processing.runalg(saga:massbalanceindex, dem, hrel, tslope, tcurve, threl, mbi)

See also

Morphometric protection index


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Radius [number] <put parameter description here>
Default: 2000.0
Outputs

Protection Index [raster] <put output description here>


Console usage
processing.runalg(saga:morphometricprotectionindex, dem, radius, protection)

See also

Multiresolution index of valley bottom flatness (mrvbf)


Description

<put algortithm description here>

18.7. SAGA algorithm provider

601

QGIS User Guide, Release 2.6

Parameters

Elevation [raster] <put parameter description here>


Initial Threshold for Slope [number] <put parameter description here>
Default: 16
Threshold for Elevation Percentile (Lowness) [number] <put parameter description here>
Default: 0.4
Threshold for Elevation Percentile (Upness) [number] <put parameter description here>
Default: 0.35
Shape Parameter for Slope [number] <put parameter description here>
Default: 4.0
Shape Parameter for Elevation Percentile [number] <put parameter description here>
Default: 3.0
Update Views [boolean] <put parameter description here>
Default: True
Classify [boolean] <put parameter description here>
Default: True
Maximum Resolution (Percentage) [number] <put parameter description here>
Default: 100
Outputs

MRVBF [raster] <put output description here>


MRRTF [raster] <put output description here>
Console usage
processing.runalg(saga:multiresolutionindexofvalleybottomflatnessmrvbf, dem, t_slope, t_pctl_v,

See also

Real area calculation


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Outputs

Real Area Grid [raster] <put output description here>


602

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:realareacalculation, dem, area)

See also

Relative heights and slope positions


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


w [number] <put parameter description here>
Default: 0.5
t [number] <put parameter description here>
Default: 10.0
e [number] <put parameter description here>
Default: 2.0
Outputs

Slope Height [raster] <put output description here>


Valley Depth [raster] <put output description here>
Normalized Height [raster] <put output description here>
Standardized Height [raster] <put output description here>
Mid-Slope Positon [raster] <put output description here>
Console usage
processing.runalg(saga:relativeheightsandslopepositions, dem, w, t, e, ho, hu, nh, sh, ms)

See also

Slope, aspect, curvature


Description

<put algortithm description here>

18.7. SAGA algorithm provider

603

QGIS User Guide, Release 2.6

Parameters

Elevation [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Maximum Slope (Travis et al. 1975)
1 [1] Maximum Triangle Slope (Tarboton 1997)
2 [2] Least Squares Fitted Plane (Horn 1981, Costa-Cabral & Burgess 1996)
3 [3] Fit 2.Degree Polynom (Bauer, Rohdenburg, Bork 1985)
4 [4] Fit 2.Degree Polynom (Heerdegen & Beran 1982)
5 [5] Fit 2.Degree Polynom (Zevenbergen & Thorne 1987)
6 [6] Fit 3.Degree Polynom (Haralick 1983)
Default: 5
Outputs

Slope [raster] <put output description here>


Aspect [raster] <put output description here>
Curvature [raster] <put output description here>
Plan Curvature [raster] <put output description here>
Profile Curvature [raster] <put output description here>
Console usage

processing.runalg(saga:slopeaspectcurvature, elevation, method, slope, aspect, curv, hcurv, vcur

See also

Surface specific points


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Method [selection] <put parameter description here>
Options:
0 [0] Mark Highest Neighbour
1 [1] Opposite Neighbours
2 [2] Flow Direction
3 [3] Flow Direction (up and down)

604

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

4 [4] Peucker & Douglas


Default: 0
Threshold [number] <put parameter description here>
Default: 2.0
Outputs

Result [raster] <put output description here>


Console usage
processing.runalg(saga:surfacespecificpoints, elevation, method, threshold, result)

See also

Terrain ruggedness index (tri)


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Radius (Cells) [number] <put parameter description here>
Default: 1
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1.0
Outputs

Terrain Ruggedness Index (TRI) [raster] <put output description here>

18.7. SAGA algorithm provider

605

QGIS User Guide, Release 2.6

Console usage

processing.runalg(saga:terrainruggednessindextri, dem, radius, distance_weighting_weighting, dis

See also

Topographic position index (tpi)


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Standardize [boolean] <put parameter description here>
Default: True
Min Radius [number] <put parameter description here>
Default: 0.0
Max Radius [number] <put parameter description here>
Default: 100.0
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 75.0
Outputs

Topographic Position Index [raster] <put output description here>


Console usage

processing.runalg(saga:topographicpositionindextpi, dem, standard, radius_min, radius_max, dista

606

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

Tpi based landform classification


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Min Radius A [number] <put parameter description here>
Default: 0
Max Radius A [number] <put parameter description here>
Default: 100
Min Radius B [number] <put parameter description here>
Default: 0
Max Radius B [number] <put parameter description here>
Default: 1000
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 75.0
Outputs

Landforms [raster] <put output description here>


Console usage

processing.runalg(saga:tpibasedlandformclassification, dem, radius_a_min, radius_a_max, radius_b

18.7. SAGA algorithm provider

607

QGIS User Guide, Release 2.6

See also

Vector ruggedness measure (vrm)


Description

<put algortithm description here>


Parameters

Elevation [raster] <put parameter description here>


Radius (Cells) [number] <put parameter description here>
Default: 1
Distance Weighting [selection] <put parameter description here>
Options:
0 [0] no distance weighting
1 [1] inverse distance to a power
2 [2] exponential
3 [3] gaussian weighting
Default: 0
Inverse Distance Weighting Power [number] <put parameter description here>
Default: 1
Inverse Distance Offset [boolean] <put parameter description here>
Default: True
Gaussian and Exponential Weighting Bandwidth [number] <put parameter description here>
Default: 1
Outputs

Vector Terrain Ruggedness (VRM) [raster] <put output description here>


Console usage

processing.runalg(saga:vectorruggednessmeasurevrm, dem, radius, distance_weighting_weighting, di

See also

Wind effect
Description

<put algortithm description here>

608

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Parameters

Elevation [raster] <put parameter description here>


Wind Direction [raster] Optional.
<put parameter description here>
Wind Speed [raster] Optional.
<put parameter description here>
Constant Wind Direction [Degree] [number] <put parameter description here>
Default: 135
Old Version [boolean] <put parameter description here>
Default: True
Search Distance [km] [number] <put parameter description here>
Default: 300.0
Acceleration [number] <put parameter description here>
Default: 1.5
Use Pyramids [boolean] <put parameter description here>
Default: True
Wind Direction Units [selection] <put parameter description here>
Options:
0 [0] radians
1 [1] degree
Default: 0
Wind Speed Scale Factor [number] <put parameter description here>
Default: 1.0
Outputs

Wind Effect [raster] <put output description here>


Windward Effect [raster] <put output description here>
Leeward Effect [raster] <put output description here>
Console usage

processing.runalg(saga:windeffect, dem, dir, len, dir_const, oldver, maxdist, accel, pyramids, d

See also

18.7. SAGA algorithm provider

609

QGIS User Guide, Release 2.6

18.7.28 Terrain profiles


Cross profiles
Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Lines [vector: line] <put parameter description here>
Profile Distance [number] <put parameter description here>
Default: 10.0
Profile Length [number] <put parameter description here>
Default: 10.0
Profile Samples [number] <put parameter description here>
Default: 10.0
Outputs

Cross Profiles [vector] <put output description here>


Console usage

processing.runalg(saga:crossprofiles, dem, lines, dist_line, dist_profile, num_profile, profiles

See also

Profile from points table


Description

<put algortithm description here>


Parameters

Grid [raster] <put parameter description here>


Input [table] <put parameter description here>
X [tablefield: any] <put parameter description here>
Y [tablefield: any] <put parameter description here>
Outputs

Result [table] <put output description here>

610

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage
processing.runalg(saga:profilefrompointstable, grid, table, x, y, result)

See also

Profiles from lines


Description

<put algortithm description here>


Parameters

DEM [raster] <put parameter description here>


Values [multipleinput: rasters] Optional.
<put parameter description here>
Lines [vector: line] <put parameter description here>
Name [tablefield: any] <put parameter description here>
Each Line as new Profile [boolean] <put parameter description here>
Default: True
Outputs

Profiles [vector] <put output description here>


Profiles [vector] <put output description here>
Console usage
processing.runalg(saga:profilesfromlines, dem, values, lines, name, split, profile, profiles)

See also

18.8 TauDEM algorithm provider


TauDEM (Terrain Analysis Using Digital Elevation Models) is a set of Digital Elevation Model (DEM) tools
for the extraction and analysis of hydrologic information from topography as represented by a DEM. This is
software developed at Utah State University (USU) for hydrologic digital elevation model analysis and watershed
delineation.
TauDEM is distributed as a set of standalone command line executable programs for a Windows and source code
for compiling and use on other systems.
Bemerkung: Please remember that Processing contains only the interface description, so you need to install
TauDEM 5.0.6 by yourself and configure Processing properly.

18.8. TauDEM algorithm provider

611

QGIS User Guide, Release 2.6

Documentation for TauDEM algorithms derived from official TauDEM documentation


.

18.8.1 Basic Grid Analysis


D8 Contributing Area
Description

Calculates a grid of contributing areas using the single direction D8 flow model. The contribution of each grid cell
is taken as one (or when the optional weight grid is used, the value from the weight grid). The contributing area
for each grid cell is taken as its own contribution plus the contribution from upslope neighbors that drain in to it
according to the D8 flow model.
If the optional outlet point shapefile is used, only the outlet cells and the cells upslope (by the D8 flow model) of
them are in the domain to be evaluated.
By default, the tool checks for edge contamination. This is defined as the possibility that a contributing area value
may be underestimated due to grid cells outside of the domain not being counted. This occurs when drainage
is inwards from the boundaries or areas with no data values for elevation. The algorithm recognizes this and
reports no data for the contributing area. It is common to see streaks of no data values extending inwards
from boundaries along flow paths that enter the domain at a boundary. This is the desired effect and indicates that
contributing area for these grid cells is unknown due to it being dependent on terrain outside of the domain of data
available. Edge contamination checking may be turned off in cases where you know this is not an issue or want to
ignore these problems, if for example, the DEM has been clipped along a watershed outline.
Parameters

D8 Flow Direction Grid [raster] A grid of D8 flow directions which are defined, for each cell, as the
direction of the one of its eight adjacent or diagonal neighbors with the steepest downward slope. This grid
can be obtained as the output of the D8 Flow Directions tool.
Outlets Shapefile [vector: point] Optional.
A point shapefile defining the outlets of interest. If this input file is used, only the cells upslope of these
outlet cells are considered to be within the domain being evaluated.
Weight Grid [raster] Optional.
A grid giving contribution to flow for each cell. These contributions (also sometimes referred to as weights
or loadings) are used in the contributing area accumulation. If this input file is not used, the contribution to
flow will assumed to be one for each grid cell.
Check for edge contamination [boolean] A flag that indicates whether the tool should check for edge
contamination. Edge contamination is defined as the possibility that a contributing area value may be underestimated due to the fact that grid cells outside of the domain have not been evaluated. This occurs when
drainage is inwards from the boundaries or areas with NODATA values for elevation. The algorithm recognizes this and reports NODATA for the impated cells. It is common to see streaks of NODATA values
extending inwards from boundaries along flow paths that enter the domain at a boundary. This is the desired
effect and indicates that contributing area for these grid cells is unknown due to it being dependent on terrain
outside of the domain of available data. Edge contamination checking may be turned off in cases where you
know this is not an issue, or want to ignore these problems, if for example, the DEM has been clipped along
a watershed outline.
Default: True

612

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

D8 Contributing Area Grid [raster] A grid of contributing area values calculated as the cells own contribution plus the contribution from upslope neighbors that drain in to it according to the D8 flow model.
Console usage
processing.runalg(taudem:d8contributingarea, -p, -o, -wg, -nc, -ad8)

See also

D8 Flow Directions
Description

Creates 2 grids. The first contains the flow direction from each grid cell to one of its adjacent or diagonal neighbors,
calculated using the direction of steepest descent. The second contain the slope, as evaluated in the direction of
steepest descent, and is reported as drop/distance, i.e. tan of the angle. Flow direction is reported as NODATA for
any grid cell adjacent to the edge of the DEM domain, or adjacent to a NODATA value in the DEM. In flat areas,
flow directions are assigned away from higher ground and towards lower ground using the method of Garbrecht
and Martz (1997). The D8 flow direction algorithm may be applied to a DEM that has not had its pits filled, but it
will then result in NODATA values for flow direction and slope at the lowest point of each pit.
D8 Flow Direction Coding:
1 East
2 Northeast
3 North
4 Northwest
5 West
6 Southwest
7 South
8 Southeast

The flow direction routing across flat areas is performed according to the method described by Garbrecht, J. and L.
W. Martz, (1997), The Assignment of Drainage Direction Over Flat Surfaces in Raster Digital Elevation Models,
Journal of Hydrology, 193: 204-213.
Parameters

Pit Filled Elevation Grid [raster] A grid of elevation values. This is usually the output of the Pit
Remove tool, in which case it is elevations with pits removed. Pits are low elevation areas in digital
elevation models (DEMs) that are completely surrounded by higher terrain. They are generally taken to
be artifacts of the digitation process that interfere with the processing of flow across DEMs. So they are
removed by raising their elevation to the point where they just drain off the domain. This step is not essential
if you have reason to believe that the pits in your DEM are real. If a few pits actually exist and so should not
be removed, while at the same time others are believed to be artifacts that need to be removed, the actual pits
should have NODATA elevation values inserted at their lowest point. NODATA values serve to define edges
of the domain in the flow field, and elevations are only raised to where flow is off an edge, so an internal
NODATA value will stop a pit from being removed, if necessary.

18.8. TauDEM algorithm provider

613

QGIS User Guide, Release 2.6

Outputs

D8 Flow Direction Grid [raster] A grid of D8 flow directions which are defined, for each cell, as the
direction of the one of its eight adjacent or diagonal neighbors with the steepest downward slope.
D8 Slope Grid [raster] A grid giving slope in the D8 flow direction. This is measured as drop/distance.
Console usage
processing.runalg(taudem:d8flowdirections, -fel, -p, -sd8)

See also

D-Infinity Contributing Area


Description

Calculates a grid of specific catchment area which is the contributing area per unit contour length using the
multiple flow direction D-infinity approach. D-infinity flow direction is defined as steepest downward slope on
planar triangular facets on a block centered grid. The contribution at each grid cell is taken as the grid cell length
(or when the optional weight grid input is used, from the weight grid). The contributing area of each grid cell is
then taken as its own contribution plus the contribution from upslope neighbors that have some fraction draining
to it according to the D-infinity flow model. The flow from each cell either all drains to one neighbor, if the angle
falls along a cardinal (0, /2, , 3/2) or ordinal (/4, 3/4, 5/4, 7/4) direction, or is on an angle falling between
the direct angle to two adjacent neighbors. In the latter case the flow is proportioned between these two neighbor
cells according to how close the flow direction angle is to the direct angle to those cells. The contour length used
here is the grid cell size. The resulting units of the specific catchment area are length units the same as those of
the grid cell size.

When the optional weight grid is not used, the result is reported in terms of specific catchment area, the upslope
area per unit contour length, taken here as the number of cells times grid cell length (cell area divided by cell
length). This assumes that grid cell length is the effective contour length, in the definition of specific catchment
area and does not distinguish any difference in contour length dependent upon the flow direction. When the
optional weight grid is used, the result is reported directly as a summation of weights, without any scaling.
If the optional outlet point shapefile is used, only the outlet cells and the cells upslope (by the D-infinity flow
model) of them are in the domain to be evaluated.
By default, the tool checks for edge contamination. This is defined as the possibility that a contributing area value
may be underestimated due to grid cells outside of the domain not being counted. This occurs when drainage
is inwards from the boundaries or areas with no data values for elevation. The algorithm recognizes this and
reports no data for the contributing area. It is common to see streaks of no data values extending inwards
from boundaries along flow paths that enter the domain at a boundary. This is the desired effect and indicates that
contributing area for these grid cells is unknown due to it being dependent on terrain outside of the domain of data
available. Edge contamination checking may be turned off in cases where you know it is not an issue or want to
ignore these problems, if for example, the DEM has been clipped along a watershed outline.
Parameters

D-Infinity Flow Direction Grid [raster] A grid of flow directions based on the D-infinity flow
method using the steepest slope of a triangular facet. Flow direction is determined as the direction of the
steepest downward slope on the 8 triangular facets of a 3x3 block centered grid. Flow direction is encoded as
an angle in radians, counter-clockwise from east as a continuous (floating point) quantity between 0 and 2.
The resulting flow in a grid is then usually interpreted as being proportioned between the two neighboring
cells that define the triangular facet with the steepest downward slope.
614

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outlets Shapefile [vector: point] Optional.


A point shapefile defining the outlets of interest. If this input file is used, only the cells upslope of these
outlet cells are considered to be within the domain being evaluated.
Weight Grid [raster] Optional.
A grid giving contribution to flow for each cell. These contributions (also sometimes referred to as weights
or loadings) are used in the contributing area accumulation. If this input file is not used, the result is reported
in terms of specific catchment area (the upslope area per unit contour length) taken as the number of cells
times grid cell length (cell area divided by cell length).
Check for edge contamination [boolean] A flag that indicates whether the tool should check for edge
contamination. Edge contamination is defined as the possibility that a contributing area value may be underestimated due to the fact that grid cells outside of the domain have not been evaluated. This occurs when
drainage is inwards from the boundaries or areas with NODATA values for elevation. The algorithm recognizes this and reports NODATA for the impated cells. It is common to see streaks of NODATA values
extending inwards from boundaries along flow paths that enter the domain at a boundary. This is the desired
effect and indicates that contributing area for these grid cells is unknown due to it being dependent on terrain
outside of the domain of available data. Edge contamination checking may be turned off in cases where you
know this is not an issue, or want to ignore these problems, if for example, the DEM has been clipped along
a watershed outline.
Default: True
Outputs

D-Infinity Specific Catchment Area Grid [raster] A grid of specific catchment area which is the
contributing area per unit contour length using the multiple flow direction D-infinity approach. The contributing area of each grid cell is then taken as its own contribution plus the contribution from upslope
neighbors that have some fraction draining to it according to the D-infinity flow model.
Console usage
processing.runalg(taudem:dinfinitycontributingarea, -ang, -o, -wg, -nc, -sca)

See also

D-Infinity Flow Directions


Description

Assigns a flow direction based on the D-infinity flow method using the steepest slope of a triangular facet (Tarboton, 1997, A New Method for the Determination of Flow Directions and Contributing Areas in Grid Digital
Elevation Models, Water Resources Research, 33(2): 309-319). Flow direction is defined as steepest downward
slope on planar triangular facets on a block centered grid. Flow direction is encoded as an angle in radians counterclockwise from east as a continuous (floating point) quantity between 0 and 2. The flow direction angle is determined as the direction of the steepest downward slope on the eight triangular facets formed in a 3 x 3 grid
cell window centered on the grid cell of interest. The resulting flow in a grid is then usually interpreted as being
proportioned between the two neighboring cells that define the triangular facet with the steepest downward slope.

A block-centered representation is used with each elevation value taken to represent the elevation of the center
of the corresponding grid cell. Eight planar triangular facets are formed between each grid cell and its eight
neighbors. Each of these has a downslope vector which when drawn outwards from the center may be at an angle
that lies within or outside the 45 degree (/4 radian) angle range of the facet at the center point. If the slope vector
angle is within the facet angle, it represents the steepest flow direction on that facet. If the slope vector angle is
18.8. TauDEM algorithm provider

615

QGIS User Guide, Release 2.6

outside a facet, the steepest flow direction associated with that facet is taken along the steepest edge. The slope
and flow direction associated with the grid cell is taken as the magnitude and direction of the steepest downslope
vector from all eight facets. Slope is measured as drop/distance, i.e. tan of the slope angle.
In the case where no slope vectors are positive (downslope), the flow direction is set using the method of Garbrecht
and Martz (1997) for the determination of flow across flat areas. This makes flat areas drain away from high ground
and towards low ground. The flow path grid to enforce drainage along existing streams is an optional input, and if
used, takes precedence over elevations for the setting of flow directions.
The D-infinity flow direction algorithm may be applied to a DEM that has not had its pits filled, but it will then
result in no data values for the D-infinity flow direction and slope associated with the lowest point of the pit.
Parameters

Pit Filled Elevation Grid [raster] A grid of elevation values. This is usually the output of the Pit
Remove tool, in which case it is elevations with pits removed.
Outputs

D-Infinity Flow Directions Grid [raster] A grid of flow directions based on the D-infinity flow
method using the steepest slope of a triangular facet. Flow direction is determined as the direction of the
steepest downward slope on the 8 triangular facets of a 3x3 block centered grid. Flow direction is encoded as
an angle in radians, counter-clockwise from east as a continuous (floating point) quantity between 0 and 2.
The resulting flow in a grid is then usually interpreted as being proportioned between the two neighboring
cells that define the triangular facet with the steepest downward slope.
D-Infinity Slope Grid [raster] A grid of slope evaluated using the D-infinity method described in Tarboton, D. G., (1997), A New Method for the Determination of Flow Directions and Contributing Areas in
Grid Digital Elevation Models, Water Resources Research, 33(2): 309-319. This is the steepest outwards
slope on one of eight triangular facets centered at each grid cell, measured as drop/distance, i.e. tan of the
slope angle.
Console usage
processing.runalg(taudem:dinfinityflowdirections, -fel, -ang, -slp)

See also

Grid Network
Description

Creates 3 grids that contain for each grid cell: 1) the longest path, 2) the total path, and 3) the Strahler order
number. These values are derived from the network defined by the D8 flow model.
The longest upslope length is the length of the flow path from the furthest cell that drains to each cell. The total
upslope path length is the length of the entire grid network upslope of each grid cell. Lengths are measured
between cell centers taking into account cell size and whether the direction is adjacent or diagonal.
Strahler order is defined as follows: A network of flow paths is defined by the D8 Flow Direction grid. Source
flow paths have a Strahler order number of one. When two flow paths of different order join the order of the
downstream flow path is the order of the highest incoming flow path. When two flow paths of equal order join
the downstream flow path order is increased by 1. When more than two flow paths join the downstream flow path
order is calculated as the maximum of the highest incoming flow path order or the second highest incoming flow
path order + 1. This generalizes the common definition to cases where more than two flow paths join at a point.

616

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Where the optional mask grid and threshold value are input, the function is evaluated only considering grid cells
that lie in the domain with mask grid value greater than or equal to the threshold value. Source (first order) grid
cells are taken as those that do not have any other grid cells from inside the domain draining in to them, and
only when two of these flow paths join is order propagated according to the ordering rules. Lengths are also only
evaluated counting paths within the domain greater than or equal to the threshold.
If the optional outlet point shapefile is used, only the outlet cells and the cells upslope (by the D8 flow model) of
them are in the domain to be evaluated.
Parameters

D8 Flow Direction Grid [raster] A grid of D8 flow directions which are defined, for each cell, as the
direction of the one of its eight adjacent or diagonal neighbors with the steepest downward slope. This grid
can be obtained as the output of the D8 Flow Directions tool.
Outlets Shapefile [vector: point] Optional.
A point shapefile defining the outlets of interest. If this input file is used, only the cells upslope of these
outlet cells are considered to be within the domain being evaluated.
Mask Grid [raster] Optional.
A grid that is used to determine the domain do be analyzed. If the mask grid value >= mask threshold (see
below), then the cell will be included in the domain. While this tool does not have an edge contamination
flag, if edge contamination analysis is needed, then a mask grid from a function like D8 Contributing
Area that does support edge contamination can be used to achieve the same result.
Mask Threshold [number] This input parameter is used in the calculation mask grid value >= mask threshold
to determine if the grid cell is in the domain to be analyzed.
Default: 100
Outputs

Longest Upslope Length Grid [raster] A grid that gives the length of the longest upslope D8 flow path
terminating at each grid cell. Lengths are measured between cell centers taking into account cell size and
whether the direction is adjacent or diagonal.
Total Upslope Length Grid [raster] The total upslope path length is the length of the entire D8 flow
grid network upslope of each grid cell. Lengths are measured between cell centers taking into account cell
size and whether the direction is adjacent or diagonal.
Strahler Network Order Grid [raster] A grid giving the Strahler order number for each cell. A network of flow paths is defined by the D8 Flow Direction grid. Source flow paths have a Strahler order
number of one. When two flow paths of different order join the order of the downstream flow path is the
order of the highest incoming flow path. When two flow paths of equal order join the downstream flow path
order is increased by 1. When more than two flow paths join the downstream flow path order is calculated
as the maximum of the highest incoming flow path order or the second highest incoming flow path order +
1. This generalizes the common definition to cases where more than two flow paths join at a point.
Console usage

processing.runalg(taudem:gridnetwork, d8_flow_dir_grid, outlets_shape, mask_grid, threshold, lon

18.8. TauDEM algorithm provider

617

QGIS User Guide, Release 2.6

See also

Pit Remove
Description

Identifies all pits in the DEM and raises their elevation to the level of the lowest pour point around their edge. Pits
are low elevation areas in digital elevation models (DEMs) that are completely surrounded by higher terrain. They
are generally taken to be artifacts that interfere with the routing of flow across DEMs, so are removed by raising
their elevation to the point where they drain off the edge of the domain. The pour point is the lowest point on the
boundary of the watershed draining to the pit. This step is not essential if you have reason to believe that the pits
in your DEM are real. If a few pits actually exist and so should not be removed, while at the same time others are
believed to be artifacts that need to be removed, the actual pits should have NODATA elevation values inserted at
their lowest point. NODATA values serve to define edges in the domain, and elevations are only raised to where
flow is off an edge, so an internal NODATA value will stop a pit from being removed, if necessary.
Parameters

Elevation Grid [raster] A digital elevation model (DEM) grid to serve as the base input for the terrain
analysis and stream delineation.
Outputs

Pit Removed Elevation Grid [raster] A grid of elevation values with pits removed so that flow is routed
off of the domain.
Console usage
processing.runalg(taudem:pitremove, -z, -fel)

See also

18.8.2 Specialized Grid Analysis


D8 Distance To Streams
Description

Computes the horizontal distance to stream for each grid cell, moving downslope according to the D8 flow model,
until a stream grid cell is encountered.
Parameters

D8 Flow Direction Grid [raster] This input is a grid of flow directions that are encoded using the D8
method where all flow from a cells goes to a single neighboring cell in the direction of steepest descent.
This grid can be obtained as the output of the D8 Flow Directions tool.

618

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Stream Raster Grid [raster] A grid indicating streams. Such a grid can be created by several of the tools
in the Stream Network Analysis toolset. However, the tools in the Stream Network Analysis toolset
only create grids with a value of 0 for no stream, or 1 for stream cells. This tool can also accept grids
with values greater than 1, which can be used in conjunction with the Threshold parameter to determine
the location of streams. This allows Contributing Area grids to be used to define streams as well as the
normal Stream Raster grids. This grid expects integer (long integer) values and any non-integer values will
be truncated to an integer before being evaluated.
Threshold [number] This value acts as threshold on the Stream Raster Grid to determine the location
of streams. Cells with a Stream Raster Grid value greater than or equal to the Threshold value
are interpreted as streams.
Default: 50
Outputs

Output Distance to Streams [raster] A grid giving the horizontal distance along the flow path as defined by the D8 Flow Directions Grid to the streams in the Stream Raster Grid.
Console usage
processing.runalg(taudem:d8distancetostreams, -p, -src, -thresh, -dist)

See also

D-Infinity Avalanche Runout


Description

Identifies an avalanches affected area and the flow path length to each cell in that affacted area. All cells downslope
from each source area cell, up to the point where the slope from the source to the affected area is less than a
threshold angle called the Alpha Angle can be in the affected area. This tool uses the D-infinity multiple flow
direction method for determining flow direction. This will likely cause very small amounts of flow to be dispersed
to some downslope cells that might overstate the affected area, so a threshold proportion can be set to avoid this
excess dispersion. The flow path length is the distance from the cell in question to the source cell that has the
highest angle.
All points downslope from the source area are potentially in the affected area, but not beyond a point where the
slope from the source to the affected area is less than a threshold angle called the Alpha Angle.

Slope is to be measured using the straight line distance from source point to evaluation point.
It makes more physical sense to me for the angle to be measured along the flow path. Nevertheless it is equally easy
to code straight line angles as angles along the flow path, so an option that allows switching will be provided. The
most practical way to evaluate avalanche runout is to keep track of the source point with the greatest angle to each
point. Then the recursive upslope flow algebra approach will look at a grid cell and all its upslope neighbors that
flow to it. Information from the upslope neighbors will be used to calculate the angle to the grid cell in question
and retain it in the runout zone if the angle exceeds the alpha angle. This procedure makes the assumption that the
maximum angle at a grid cell will be from the set of cells that have maximum angles to the inflowing neighbors.
This will always be true of angle is calculated along a flow path, but I can conceive of cases where flow paths bend
back on themselves where this would not be the case for straight line angles.
The D-infinity multiple flow direction field assigns flow from each grid cell to multiple downslope neighbors using
proportions (Pik) that vary between 0 and 1 and sum to 1 for all flows out of a grid cell. It may be desirable to
specify a threshold T that this proportion has to exceed before a grid cell is counted as flowing to a downslope

18.8. TauDEM algorithm provider

619

QGIS User Guide, Release 2.6

grid cell, e.g. Pik > T (=0.2 say) to avoid dispersion to grid cells that get very little flow. T will be specified as
a user input. If all upslope grid cells are to be used T may be input as 0.
Avalanche source sites are to be input as a short integer grid (name suffix *ass, e.g. demass) comprised of
positive values where avalanches may be triggered and 0 values elsewhere.
The following grids are output:
rz A runout zone indicator with value 0 to indicate that this grid cell is not in the runout zone and value
> 0 to indicate that this grid cell is in the runout zone. Since there may be information in the angle to the
associated source site, this variable will be assigned the angle to the source site (in degrees)
dm Along flow distance from the source site that has the highest angle to the point in question
Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This can be created by the tool DInfinity Flow Directions.
Pit Filled Elevation Grid [raster] This input is a grid of elevation values. As a general rule, it is
recommended that you use a grid of elevation values that have had the pits removed for this input. Pits are
generally taken to be artifacts that interfere with the analysis of flow across them. This grid can be obtained
as the output of the Pit Remove tool, in which case it contains elevation values where the pits have been
filled to the point where they just drain.
Avalanche Source Site Grid [raster] This is a grid of source areas for snow avalanches that are commonly identified manually using a mix of experience and visual interpretation of maps. Avalanche source
sites are to be input as a short integer grid (name suffix *ass, e.g. demass) comprised of positive values
where avalanches may be triggered and 0 values elsewhere.
Proportion Threshold [number] This value is a threshold proportion that is used to limit the disperson
of flow caused by using the D-infinity multiple flow direction method for determining flow direction. The
D-infinity multiple flow direction method often causes very small amounts of flow to be dispersed to some
downslope cells that might overstate the affected area, so a threshold proportion can be set to avoid this
excess dispersion.
Default: 0.2
Alpha Angle Threshold [number] This value is the threshold angle, called the Alpha Angle, that is used
to determine which of the cells downslope from the source cells are in the affected area. Only the cells
downslope from each source area cell, up to the point where the slope from the source to the affected area
is less than a threshold angle are in the affected area.
Default: 18
Measure distance along flow path [boolean] This option selects the method used to measure the
distance used to calculate the slope angle. If option is True then measure it along the flow path, where
the False option causes the slope to be measure along the straight line distance from the source cell to the
evaluation cell.
Default: True
Outputs

Runout Zone Grid [raster] This grid Identifies the avalanches runout zone (affected area) using a runout
zone indicator with value 0 to indicate that this grid cell is not in the runout zone and value > 0 to indicate
that this grid cell is in the runout zone. Since there may be information in the angle to the associated source
site, this variable will be assigned the angle to the source site (in degrees).
Path Distance Grid [raster] This is a grid of the flow distance from the source site that has the highest
angle to each cell.

620

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(taudem:dinfinityavalancherunout, -ang, -fel, -ass, -thresh, -alpha, -direct, -

See also

D-Infinity Concentration Limited Accumulation


Description

This function applies to the situation where an unlimited supply of a substance is loaded into flow at a concentration or solubility threshold Csol over a region indicated by an indicator grid (dg). It a grid of the concentration of
a substance at each location in the domain, where the supply of substance from a supply area is loaded into the
flow at a concentration or solubility threshold. The flow is first calculated as a D-infinity weighted contributing
area of an input Effective Runoff Weight Grid (notionally excess precipitation). The concentation of substance
over the supply area (indicator grid) is at the concentration threshold. As the substance moves downslope with the
D-infinity flow field, it is subject to first order decay in moving from cell to cell as well as dilution due to changes
in flow. The decay multiplier grid gives the fractional (first order) reduction in quantity in moving from grid cell
x to the next downslope cell. If the outlets shapefile is used, the tool only evaluates the part of the domain that
contributes flow to the locations given by the shapefile. This is useful for a tracking a contaminant or compound
from an area with unlimited supply of that compound that is loaded into a flow at a concentration or solubility
threshold over a zone and flow from the zone may be subject to decay or attenuation.
The indicator grid (dg) is used to delineate the area of the substance supply using the (0, 1) indicator function
i(x). A[] denotes the weighted accumulation operator evaluated using the D-Infinity Contributing Area function. The Effective Runoff Weight Grid gives the supply to the flow (e.g. the excess rainfall if this is overland flow)
denoted as w(x). The specific discharge is then given by:
Q(x)=A[w(x)]

This weighted accumulation Q(x) is output as the Overland Flow Specific Discharge Grid. Over the substance
supply area concentration is at the threshold (the threshold is a saturation or solubility limit). If i(x) = 1, then
C(x) = Csol, and L(x) = Csol Q(x),

where L(x) denotes the load being carried by the flow. At remaining locations, the load is determined by load
accumulation and the concentration by dilution:

Here d(x) = d(i, j) is a decay multiplier giving the fractional (first order) reduction in mass in moving
from grid cell x to the next downslope cell. If travel (or residence) times t(x) associated with flow between
cells are available d(x) may be evaluated as exp(-k t(x)) where k is a first order decay parameter. The
Concentration grid output is C(x). If the outlets shapefile is used, the tool only evaluates the part of the domain
that contributes flow to the locations given by the shapefile.

Useful for a tracking a contaminant released or partitioned to flow at a fixed threshold concentration.
Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This grid can be created by the function
D-Infinity Flow Directions.
Disturbance Indicator Grid [raster] A grid that indicates the source zone of the area of substance
supply and must be 1 inside the zone and 0 or NODATA over the rest of the domain.

18.8. TauDEM algorithm provider

621

QGIS User Guide, Release 2.6

Decay Multiplier Grid [raster] A grid giving the factor by which flow leaving each grid cell is multiplied
before accumulation on downslope grid cells. This may be used to simulate the movement of an attenuating
or decaying substance. If travel (or residence) times t(x) associated with flow between cells are available
d(x) may be evaluated as exp(-k t(x)) where k is a first order decay parameter.
Effective Runoff Weight Grid [raster] A grid giving the input quantity (notionally effective runoff or
excess precipitation) to be used in the D-infinity weighted contributing area evaluation of Overland Flow
Specific Discharge.
Outlets shapefile [vector: point] Optional.
This optional input is a point shapefile defining outlets of interest. If this file is used, the tool will only
evaluate the area upslope of these outlets.
Concentration Threshold [number] The concentration or solubility threshold. Over the substance supply area, concentration is at this threshold.
Default: 1.0
Check for edge contamination [boolean] This option determines whether the tool should check for
edge contamination. Edge contamination is defined as the possibility that a value may be underestimated
due to grid cells outside of the domain not being considered when determining contributing area.
Default: True
Outputs

Concentration Grid [raster] A grid giving the resulting concentration of the compound of interest in the
flow.
Console usage

processing.runalg(taudem:dinfinityconcentrationlimitedaccumulation, -ang, -dg, -dm, -q, -o, -cso

See also

D-Infinity Decaying Accumulation


Description

The D-Infinity Decaying Accumulation tool creates a grid of the accumulated quantity at each location in the
domain where the quantity accumulates with the D-infinity flow field, but is subject to first order decay in moving
from cell to cell. By default, the quantity contribution of each grid cell is the cell length to give a per unit width
accumulation, but can optionally be expressed with a weight grid. The decay multiplier grid gives the fractional
(first order) reduction in quantity in accumulating from grid cell x to the next downslope cell.
A decayed accumulation operator DA[.] takes as input a mass loading field m(x) expressed at each grid location
as m(i, j) that is assumed to move with the flow field but is subject to first order decay in moving from cell to
cell. The output is the accumulated mass at each location DA(x). The accumulation of m at each grid cell can be
numerically evaluated.

Here d(x) = d(i ,j) is a decay multiplier giving the fractional (first order) reduction in mass in moving from
grid cell x to the next downslope cell. If travel (or residence) times t(x) associated with flow between cells are
available d(x) may be evaluated as exp(-k t(x)) where k is a first order decay parameter. The weight grid
is used to represent the mass loading m(x). If not specified this is taken as 1. If the outlets shapefile is used the
function is only evaluated on that part of the domain that contributes flow to the locations given by the shapefile.

622

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Useful for a tracking contaminant or compound subject to decay or attenuation.


Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This grid can be created by the function
D-Infinity Flow Directions.
Decay Multiplier Grid [raster] A grid giving the factor by which flow leaving each grid cell is multiplied
before accumulation on downslope grid cells. This may be used to simulate the movement of an attenuating
substance.
Weight Grid [raster] Optional.
A grid giving weights (loadings) to be used in the accumulation. If this optional grid is not specified, weights
are taken as the linear grid cell size to give a per unit width accumulation.
Outlets Shapefile [vector: point] Optional.
This optional input is a point shapefile defining outlets of interest. If this file is used, the tool will only
evaluate ther area upslope of these outlets.
Check for edge contamination [boolean] This option determines whether the tool should check for
edge contamination. Edge contamination is defined as the possibility that a value may be underestimated
due to grid cells outside of the domain not being considered when determining contributing area.
Default: True
Outputs

Decayed Specific Catchment Area Grid [raster] The D-Infinity Decaying Accumulation tool creates a grid of the accumulated mass at each location in the domain where mass moves with the D-infinity
flow field, but is subject to first order decay in moving from cell to cell.
Console usage
processing.runalg(taudem:dinfinitydecayingaccumulation, -ang, -dm, -wg, -o, -nc, -dsca)

See also

D-Infinity Distance Down


Description

Calculates the distance downslope to a stream using the D-infinity flow model. The D-infinity flow model is a
multiple flow direction model, because the outflow from each grid cell is proportioned between up to 2 downslope
grid cells. As such, the distance from any grid cell to a stream is not uniquely defined. Flow that originates at a
particular grid cell may enter the stream at a number of different cells. The statistical method may be selected
as the longest, shortest or weighted average of the flow path distance to the stream. Also one of several ways
of measuring distance may be selected: the total straight line path (Pythagoras), the horizontal component of the
straight line path, the vertical component of the straight line path, or the total surface flow path.
Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This can be created by the tool DInfinity Flow Directions.
18.8. TauDEM algorithm provider

623

QGIS User Guide, Release 2.6

Pit Filled Elevation Grid [raster] This input is a grid of elevation values. As a general rule, it is
recommended that you use a grid of elevation values that have had the pits removed for this input. Pits are
generally taken to be artifacts that interfere with the analysis of flow across them. This grid can be obtained
as the output of the Pit Remove tool, in which case it contains elevation values where the pits have been
filled to the point where they just drain.
Stream Raster Grid [raster] A grid indicating streams, by using a grid cell value of 1 on streams and 0 off
streams. This is usually the output of one of the tools in the Stream Network Analysis toolset.
Weight Path Grid [raster] Optional.
A grid giving weights (loadings) to be used in the distance calculation. This might be used for example
where only flow distance through a buffer is to be calculated. The weight is then 1 in the buffer and 0
outside it. Alternatively the weight may reflect some sort of cost function for travel over the surface, perhaps
representing travel time or attenuation of a process. If this input file is not used, the loadings will assumed
to be one for each grid cell.
Statistical Method [selection] Statistical method used to calculate the distance down to the stream. In the
D-Infinity flow model, the outflow from each grid cell is proportioned between two downslope grid cells.
Therefore, the distance from any grid cell to a stream is not uniquely defined. Flow that originates at a
particular grid cell may enter the stream at a number of cells. The distance to the stream may be defined as
the longest (maximum), shortest (minimum) or weighted average of the distance down to the stream.
Options:
0 Minimum
1 Maximum
2 Average
Default: 2
Distance Method [selection] Distance method used to calculate the distance down to the stream. One of
several ways of measuring distance may be selected: the total straight line path (Pythagoras), the horizontal
component of the straight line path (horizontal), the vertical component of the straight line path (vertical),
or the total surface flow path (surface).
Options:
0 Pythagoras
1 Horizontal
2 Vertical
3 Surface
Default: 1
Check for edge contamination [boolean] A flag that determines whether the tool should check for
edge contamination. This is defined as the possibility that a value may be underestimated due to grid cells
outside of the domain not being counted. In the context of Distance Down this occurs when part of a flow
path traced downslope from a grid cell leaves the domain without reaching a stream grid cell. With edge
contamination checking selected, the algorithm recognizes this and reports no data for the result. This is the
desired effect and indicates that values for these grid cells is unknown due to it being dependent on terrain
outside of the domain of data available. Edge contamination checking may be overridden in cases where you
know this is not an issue or want to evaluate the distance using only the fraction of flow paths that terminate
at a stream.
Default: True
Outputs

D-Infinity Drop to Stream Grid [raster] Grid containing the distance to stream calculated using the
D-infinity flow model and the statistical and path methods chosen.

624

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(taudem:dinfinitydistancedown, dinf_flow_dir_grid, pit_filled_grid, stream_grid

See also

D-Infinity Distance Up
Description

This tool calculates the distance from each grid cell up to the ridge cells along the reverse D-infinity flow directions. Ridge cells are defined to be grid cells that have no contribution from grid cells further upslope. Given the
convergence of multiple flow paths at any grid cell, any given grid cell can have multiple upslope ridge cells. There
are three statictical methods that this tool can use: maximum distance, minimum distance and waited flow average
over these flow paths. A variant on the above is to consider only grid cells that contribute flow with a proportion
greater than a user specified threshold (t) to be considered as upslope of any given grid cell. Setting t=0.5 would
result in only one flow path from any grid cell and would give the result equivalent to a D8 flow model, rather
than D-infinity flow model, where flow is proportioned between two downslope grid cells. Finally there are several
different optional paths that can be measured: the total straight line path (Pythagoras), the horizontal component
of the straight line path, the vertical component of the straight line path, or the total surface flow path.
Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This can be created by the tool DInfinity Flow Directions.
Pit Filled Elevation Grid [raster] This input is a grid of elevation values. As a general rule, it is
recommended that you use a grid of elevation values that have had the pits removed for this input. Pits are
generally taken to be artifacts that interfere with the analysis of flow across them. This grid can be obtained
as the output of the Pit Remove tool, in which case it contains elevation values where the pits have been
filled to the point where they just drain.
Slope Grid [raster] This input is a grid of slope values. This is measured as drop/distance and it is most often
obtained as the output of the D-Infinity Flow Directions tool.
Statistical Method [selection] Statistical method used to calculate the distance down to the stream. In the
D-Infinity flow model, the outflow from each grid cell is proportioned between two downslope grid cells.
Therefore, the distance from any grid cell to a stream is not uniquely defined. Flow that originates at a
particular grid cell may enter the stream at a number of cells. The distance to the stream may be defined as
the longest (maximum), shortest (minimum) or weighted average of the distance down to the stream.
Options:
0 Minimum
1 Maximum
2 Average
Default: 2
Distance Method [selection] Distance method used to calculate the distance down to the stream. One of
several ways of measuring distance may be selected: the total straight line path (Pythagoras), the horizontal
component of the straight line path (horizontal), the vertical component of the straight line path (vertical),
or the total surface flow path (surface).
Options:
0 Pythagoras

18.8. TauDEM algorithm provider

625

QGIS User Guide, Release 2.6

1 Horizontal
2 Vertical
3 Surface
Default: 1
Proportion Threshold [number] The proportion threshold parameter where only grid cells that contribute
flow with a proportion greater than this user specified threshold (t) is considered to be upslope of any given
grid cell. Setting t=0.5 would result in only one flow path from any grid cell and would give the result
equivalent to a D8 flow model, rather than D-Infinity flow model, where flow is proportioned between two
downslope grid cells.
Default: 0.5
Check for edge contamination [boolean] A flag that determines whether the tool should check for
edge contamination. This is defined as the possibility that a value may be underestimated due to grid cells
outside of the domain not being counted.
Default: True
Outputs

D-Infinity Distance Up [raster] Grid containing the distances up to the ridge calculated using the DInfinity flow model and the statistical and path methods chosen.
Console usage

processing.runalg(taudem:dinfinitydistanceup, dinf_flow_dir_grid, pit_filled_grid, slope_grid, s

See also

D-Infinity Reverse Accumulation


Description

This works in a similar way to evaluation of weighted Contributing area, except that the accumulation is by
propagating the weight loadings upslope along the reverse of the flow directions to accumulate the quantity of
weight loading downslope from each grid cell. The function also reports the maximum value of the weight loading
downslope from each grid cell in the Maximum Downslope grid.

This function is designed to evaluate and map the hazard due to activities that may have an effect downslope. The
example is land management activities that increase runoff. Runoff is sometimes a trigger for landslides or debris
flows, so the weight grid here could be taken as a terrain stability map. Then the reverse accumulation provides a
measure of the amount of unstable terrain downslope from each grid cell, as an indicator of the danger of activities
that may increase runoff, even though there may be no potential for any local impact.
Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This can be created by the tool DInfinity Flow Directions.
Weight Grid [raster] A grid giving weights (loadings) to be used in the accumulation.

626

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Reverse Accumulation Grid [raster] The grid giving the result of the Reverse Accumulation function. This works in a similar way to evaluation of weighted Contributing area, except that the accumulation
is by propagating the weight loadings upslope along the reverse of the flow directions to accumulate the
quantity of loading downslope from each grid cell.
Maximum Downslope Grid [raster] The grid giving the maximum of the weight loading grid downslope
from each grid cell.
Console usage
processing.runalg(taudem:dinfinityreverseaccumulation, -ang, -wg, -racc, -dmax)

See also

D-Infinity Transport Limited Accumulation - 2


Description

This function is designed to calculate the transport and deposition of a substance (e.g. sediment) that may be
limited by both supply and the capacity of the flow field to transport it. This function accumulates substance flux
(e.g. sediment transport) subject to the rule that transport out of any grid cell is the minimum between supply
and transport capacity, Tcap. The total supply at a grid cell is calculated as the sum of the transport in from
upslope grid cells, Tin, plus the local supply contribution, E (e.g. erosion). This function also outputs deposition,
D, calculated as total supply minus actual transport.

Here E is the supply. Tout at each grid cell becomes Tin for downslope grid cells and is reported as Transport
limited accumulation (tla). D is deposition (tdep). The function provides the option to evaluate concentration
of a compound (contaminant) adhered to the transported substance. This is evaluated as follows:

Where Lin is the total incoming compound loading and Cin and Tin refer to the Concentration and Transport
entering from each upslope grid cell.

If
else
where Cs is the concentration supplied locally and the difference in the second term on the right represents the
additional supply from the local grid cell. Then,
Cout at each grid cell comprises is the concentration grid output from this function.
If the outlets shapefile is used the tool only evaluates that part of the domain that contributes flow to the locations
given by the shapefile.
Transport limited accumulation is useful for modeling erosion and sediment delivery, including the spatial dependence of sediment delivery ratio and contaminant that adheres to sediment.

18.8. TauDEM algorithm provider

627

QGIS User Guide, Release 2.6

Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This can be created by the tool DInfinity Flow Directions.
Supply Grid [raster] A grid giving the supply (loading) of material to a transport limited accumulation function. In the application to erosion, this grid would give the erosion detachment, or sediment supplied at each
grid cell.
Transport Capacity Grid [raster] A grid giving the transport capacity at each grid cell for the transport
limited accumulation function. In the application to erosion this grid would give the transport capacity of
the carrying flow.
Input Concentration Grid [raster] A grid giving the concentration of a compound of interest in the
supply to the transport limited accumulation function. In the application to erosion, this grid would give the
concentration of say phosphorous adhered to the eroded sediment.
Outlets Shapefile [vector: point] Optional.
This optional input is a point shapefile defining outlets of interest. If this file is used, the tool will only
evaluate the area upslope of these outlets.
Check for edge contamination [boolean] This option determines whether the tool should check for
edge contamination. Edge contamination is defined as the possibility that a value may be underestimated
due to grid cells outside of the domain not being considered when determining the result.
Default: True
Outputs

Transport Limited Accumulation Grid [raster] This grid is the weighted accumulation of supply
accumulated respecting the limitations in transport capacity and reports the transport rate calculated by
accumulating the substance flux subject to the rule that the transport out of any grid cell is the minimum of
the total supply (local supply plus transport in) to that grid cell and the transport capacity.
Deposition Grid [raster] A grid giving the deposition resulting from the transport limited accumulation.
This is the residual from the transport in to each grid cell minus the transport capacity out of the grid cell.
The deposition grid is calculated as the transport in + the local supply - the tranport out.
Output Concentration Grid [raster] If an input concentation in supply grid is given, then this grid is
also output and gives the concentration of a compound (contaminant) adhered or bound to the transported
substance (e.g. sediment) is calculated.
Console usage

processing.runalg(taudem:dinfinitytransportlimitedaccumulation2, dinf_flow_dir_grid, supply_grid

628

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

See also

D-Infinity Transport Limited Accumulation


Description

This function is designed to calculate the transport and deposition of a substance (e.g. sediment) that may be
limited by both supply and the capacity of the flow field to transport it. This function accumulates substance flux
(e.g. sediment transport) subject to the rule that transport out of any grid cell is the minimum between supply
and transport capacity, Tcap. The total supply at a grid cell is calculated as the sum of the transport in from
upslope grid cells, Tin, plus the local supply contribution, E (e.g. erosion). This function also outputs deposition,
D, calculated as total supply minus actual transport.

Here E is the supply. Tout at each grid cell becomes Tin for downslope grid cells and is reported as Transport
limited accumulation (tla). D is deposition (tdep). The function provides the option to evaluate concentration
of a compound (contaminant) adhered to the transported substance. This is evaluated as follows:

Where Lin is the total incoming compound loading and Cin and Tin refer to the Concentration and Transport
entering from each upslope grid cell.

If
else
where Cs is the concentration supplied locally and the difference in the second term on the right represents the
additional supply from the local grid cell. Then,
Cout at each grid cell comprises is the concentration grid output from this function.
If the outlets shapefile is used the tool only evaluates that part of the domain that contributes flow to the locations
given by the shapefile.
Transport limited accumulation is useful for modeling erosion and sediment delivery, including the spatial dependence of sediment delivery ratio and contaminant that adheres to sediment.
Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-infinity method.
Flow direction is measured in radians, counter clockwise from east. This can be created by the tool DInfinity Flow Directions.
Supply Grid [raster] A grid giving the supply (loading) of material to a transport limited accumulation function. In the application to erosion, this grid would give the erosion detachment, or sediment supplied at each
grid cell.
Transport Capacity Grid [raster] A grid giving the transport capacity at each grid cell for the transport
limited accumulation function. In the application to erosion this grid woul give the transport capacity of the
carrying flow.
Outlets Shapefile [vector: point] Optional.
This optional input is a point shapefile defining outlets of interest. If this file is used, the tool will only
evaluate the area upslope of these outlets.
Check for edge contamination [boolean] This option determines whether the tool should check for
edge contamination. Edge contamination is defined as the possibility that a value may be underestimated
due to grid cells outside of the domain not being considered when determining the result.

18.8. TauDEM algorithm provider

629

QGIS User Guide, Release 2.6

Default: True
Outputs

Transport Limited Accumulation Grid [raster] This grid is the weighted accumulation of supply
accumulated respecting the limitations in transport capacity and reports the transport rate calculated by
accumulating the substance flux subject to the rule that the transport out of any grid cell is the minimum of
the total supply (local supply plus transport in) to that grid cell and the transport capacity.
Deposition Grid [raster] A grid giving the deposition resulting from the transport limited accumulation.
This is the residual from the transport in to each grid cell minus the transport capacity out of the grid cell.
The deposition grid is calculated as the transport in + the local supply - the tranport out.
Console usage

processing.runalg(taudem:dinfinitytransportlimitedaccumulation, dinf_flow_dir_grid, supply_grid,

See also

D-Infinity Upslope Dependence


Description

The D-Infinity Upslope Dependence tool quantifies the amount each grid cell in the domain contributes to a destination set of grid cells. D-Infinity flow directions proportion flow from each grid cell between multiple downslope
grid cells. Following this flow field downslope the amount of flow originating at each grid cell that reaches the
destination zone is defined. Upslope influence is evaluated using a downslope recursion, examining grid cells
downslope from each grid cell, so that the map produced identifies the area upslope where flow through the destination zone originates, or the area it depends on, for its flow.
The figures below illustrate the amount each source point in the domain x (blue) contributes to the destination point
or zone y (red). If the indicator weighted contributing area function is denoted I(y; x) giving the weighted
contribution using a unit value (1) from specific grid cells y to grid cells x, then the upslope dependence is: D(x;
y) = I(y; x).
This is useful for example to track where flow or a flow related substance or contaminant that enters a destination
area may come from.
Parameters

D-Infinity Flow Direction Grid [raster] A grid giving flow direction by the D-Infinity method
where the flow direction angle is determined as the direction of the steepest downward slope on the eight
triangular facets formed in a 3x3 grid cell window centered on the grid cell of interest. This grid can be
produced using the D-Infinity Flow Direction tool.
Destination Grid [raster] A grid that encodes the destination zone that may receive flow from upslope.
This grid must be 1 inside the zone y and 0 over the rest of the domain.

630

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Output Upslope Dependence Grid [raster] A grid quantifing the amount each source point in the domain contributes to the zone defined by the destination grid.
Console usage
processing.runalg(taudem:dinfinityupslopedependence, -ang, -dg, -dep)

See also

Slope Average Down


Description

This tool computes slope in a D8 downslope direction averaged over a user selected distance. Distance should be
specified in horizontal map units.
Parameters

D8 Flow Direction Grid [raster] This input is a grid of flow directions that are encoded using the D8
method where all flow from a cells goes to a single neighboring cell in the direction of steepest descent.This
grid can be obtained as the output of the D8 Flow Directions tool.
Pit Filled Elevation Grid [raster] This input is a grid of elevation values. As a general rule, it is
recommended that you use a grid of elevation values that have had the pits removed for this input. Pits are
generally taken to be artifacts that interfere with the analysis of flow across them. This grid can be obtained
as the output of the Pit Remove tool, in which case it contains elevation values where the pits have been
filled to the point where they just drain.
Downslope Distance [number] Input parameter of downslope distance over which to calculate the slope
(in horizontal map units).
Default: 50
Outputs

Slope Average Down Grid [raster] This output is a grid of slopes calculated in the D8 downslope direction, averaged over the selected distance.
Console usage
processing.runalg(taudem:slopeaveragedown, -p, -fel, -dn, -slpd)

18.8. TauDEM algorithm provider

631

QGIS User Guide, Release 2.6

See also

Slope Over Area Ratio


Description

Calculates the ratio of the slope to the specific catchment area (contributing area). This is algebraically related to
the more common ln(a/tan beta) wetness index, but contributing area is in the denominator to avoid divide by 0
errors when slope is 0.
Parameters

Slope Grid [raster] A grid of slope. This grid can be generated using ether the D8 Flow Directions tool or
the D-Infinity Flow Directions tool.
Specific Catchment Area Grid [raster] A grid giving the contributing area value for each cell taken
as its own contribution plus the contribution from upslope neighbors that drain in to it. Contributing area is
counted in terms of the number of grid cells (or summation of weights). This grid can be generated using
either the D8 Contributing Area tool or the D-Infinity Contributing Area tool.
Outputs

Slope Divided By Area Ratio Grid [raster] A grid of the ratio of slope to specific catchment area
(contributing area). This is algebraically related to the more common ln(a/tan beta) wetness index,
but contributing area is in the denominator to avoid divide by 0 errors when slope is 0.
Console usage
processing.runalg(taudem:slopeoverarearatio, -slp, -sca, -sar)

See also

18.8.3 Stream Network Analysis


D8 Extreme Upslope Value
Description

Evaluates the extreme (either maximum or minimum) upslope value from an input grid based on the D8 flow
model. This is intended initially for use in stream raster generation to identify a threshold of the slope times area
product that results in an optimum (according to drop analysis) stream network.
If the optional outlet point shapefile is used, only the outlet cells and the cells upslope (by the D8 flow model) of
them are in the domain to be evaluated.
By default, the tool checks for edge contamination. This is defined as the possibility that a result may be underestimated due to grid cells outside of the domain not being counted. This occurs when drainage is inwards from the
boundaries or areas with no data values for elevation. The algorithm recognizes this and reports no data for
the result for these grid cells. It is common to see streaks of no data values extending inwards from boundaries
along flow paths that enter the domain at a boundary. This is the desired effect and indicates that the result for
these grid cells is unknown due to it being dependent on terrain outside of the domain of data available. Edge

632

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

contamination checking may be turned off in cases where you know this is not an issue or want to ignore these
problems, if for example, the DEM has been clipped along a watershed outline.
Parameters

D8 Flow Directions Grid [raster] A grid of D8 flow directions which are defined, for each cell, as the
direction of the one of its eight adjacent or diagonal neighbors with the steepest downward slope. This grid
can be obtained as the output of the D8 Flow Directions tool.
Upslope Values Grid [raster] This is the grid of values of which the maximum or minimum upslope value
is selected. The values most commonly used are the slope times area product needed when generating stream
rasters according to drop analysis.
Outlets Shapefile [vector: point] Optional.
A point shape file defining outlets of interest. If this input file is used, only the area upslope of these outlets
will be evaluated by the tool.
Check for edge contamination [boolean] A flag that indicates whether the tool should check for edge
contamination.
Default: True
Use max upslope value [boolean] A flag to indicate whether the maximum or minimum upslope value is
to be calculated.
Default: True
Outputs

Extereme Upslope Values Grid [raster] A grid of the maximum/minimum upslope values.
Console usage
processing.runalg(taudem:d8extremeupslopevalue, -p, -sa, -o, -nc, -min, -ssa)

See also

Length Area Stream Source


Description

Creates an indicator grid (1, 0) that evaluates A >= (M)(Ly) based on upslope path length, D8 contributing
area grid inputs, and parameters M and y. This grid indicates likely stream source grid cells. This is an experimental method with theoretical basis in Hacks law which states that for streams L ~ A 0.6. However for
hillslopes with parallel flow L ~ A. So a transition from hillslopes to streams may be represented by L ~ A
0.8 suggesting identifying grid cells as stream cells if A > M (L (1/0.8)).
Parameters

Length Grid [raster] A grid of the maximum upslope length for each cell. This is calculated as the length of
the flow path from the furthest cell that drains to each cell. Length is measured between cell centers taking
into account cell size and whether the direction is adjacent or diagonal. It is this length (L) that is used in
the formula, A >(M)(Ly), to determine which cells are considered stream cells. This grid can be obtained
as an output from the Grid Network tool.

18.8. TauDEM algorithm provider

633

QGIS User Guide, Release 2.6

Contributing Area Grid [raster] A grid of contributing area values for each cell that were calculated using the D8 algorithm. The contributing area for a cell is the sum of its own contribution plus the contribution
from all upslope neighbors that drain to it, measured as a number of cells. This grid is typically obtained as
the output of the D8 Contributing Area tool. In this tool, it is the contributing area (A) that is compared
in the formula A > (M)(Ly) to determine the transition to a stream.
Threshold [number] The multiplier threshold (M) parameter which is used in the formula: A > (M)(Ly),
to identify the beginning of streams.
Default: 0.03
Exponent [number] The exponent (y) parameter which is used in the formula: A > (M)(Ly), to identify
the beginning of streams. In branching systems, Hacks law uggests that L = 1/M A(1/y) with 1/y =
0.6 (or 0.56) (y about 1.7). In parallel flow systems L is proportional to A (y about 1). This method tries
to identify the transition between these two paradigms by using an exponent y somewhere in between (y
about 1.3).
Default: 1.3
Outputs

Stream Source Grid [raster] An indicator grid (1,0) that evaluates A >= (M)(L^y), based on the maximum
upslope path length, the D8 contributing area grid inputs, and parameters M and y. This grid indicates likely
stream source grid cells.
Console usage

processing.runalg(taudem:lengthareastreamsource, length_grid, contrib_area_grid, threshold, expo

See also

Move Outlets To Streams


Description

Moves outlet points that are not aligned with a stream cell from a stream raster grid, downslope along the D8
flow direction until a stream raster cell is encountered, the max_dist number of grid cells are examined, or the
flow path exits the domain (i.e. a no data value is encountered for the D8 flow direction). The output file is a
new outlets shapefile where each point has been moved to coincide with the stream raster grid, if possible. A field
dist_moved is added to the new outlets shapefile to indicate the changes made to each point. Points that are
already on a stream cell are not moved and their dist_moved field is assigned a value 0. Points that are initially
not on a stream cell are moved by sliding them downslope along the D8 flow direction until one of the following
occurs: a) A stream raster grid cell is encountered before traversing the max_dist number of grid cells. In which
case, the point is moved and the dist_moved field is assigned a value indicating how many grid cells the point
was moved. b) More than the max_number of grid cells are traversed, or c) the traversal ends up going out of
the domain (i.e., a no data D8 flow direction value is encountered). In which case, the point is not moved and
the dist_moved field is assigned a value of -1.
Parameters

D8 Flow Direction Grid [raster] A grid of D8 flow directions which are defined, for each cell, as the
direction of the one of its eight adjacent or diagonal neighbors with the steepest downward slope. This grid
can be obtained as the output of the D8 Flow Directions tool.

634

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Stream Raster Grid [raster] This output is an indicator grid (1, 0) that indicates the location of streams,
with a value of 1 for each of the stream cells and 0 for the remainder of the cells. This file is produced by
several different tools in the Stream Network Analysis toolset.
Outlets Shapefile [vector: point] A point shape file defining points of interest or outlets that should ideally be located on a stream, but may not be exactly on the stream due to the fact that the shapefile point
locations may not have been accurately registered with respect to the stream raster grid.
Maximum Number of Grid Cells to traverse [number] This input paramater is the maximum
number of grid cells that the points in the input outlet shapefile will be moved before they are saved to
the output outlet shapefile.
Default: 50
Outputs

Output Outlet Shapefile [vector] A point shape file defining points of interest or outlets. This file has
one point in it for each point in the input outlet shapefile. If the original point was located on a stream,
then the point was not moved. If the origianl point was not on a stream, the point was moved downslope
according to the D8 flow direction until it reached a stream or the maximum distance had been reached.
This file has an additional field dist_moved added to it which is the number of cells that the point was
moved. This field is 0 if the cell was originally on a stream, -1 if it was not moved becuase there was not a
stream within the maximum distance, or some positive value if it was moved.
Console usage
processing.runalg(taudem:moveoutletstostreams, -p, -src, -o, -md, -om)

See also

Peuker Douglas
Description

Creates an indicator grid (1, 0) of upward curved grid cells according to the Peuker and Douglas algorithm.
With this tool, the DEM is first smoothed by a kernel with weights at the center, sides, and diagonals. The Peuker
and Douglas (1975) method (also explained in Band, 1986), is then used to identify upwardly curving grid cells.
This technique flags the entire grid, then examines in a single pass each quadrant of 4 grid cells, and unflags
the highest. The remaining flagged cells are deemed upwardly curved, and when viewed, resemble a channel
network. This proto-channel network generally lacks connectivity and requires thinning, issues that were discussed
in detail by Band (1986).
Parameters

Elevation Grid [raster] A grid of elevation values. This is usually the output of the Pit Remove tool, in
which case it is elevations with pits removed.
Center Smoothing Weight [number] The center weight parameter used by a kernel to smooth the DEM
before the tool identifies upwardly curved grid cells.
Default: 0.4
Side Smoothing Weight [number] The side weight parameter used by a kernel to smooth the DEM before
the tool identifies upwardly curved grid cells.
Default: 0.1

18.8. TauDEM algorithm provider

635

QGIS User Guide, Release 2.6

Diagonal Smoothing Weight [number] The diagonal weight parameter used by a kernel to smooth the
DEM before the tool identifies upwardly curved grid cells.
Default: 0.05
Outputs

Stream Source Grid [raster] An indicator grid (1, 0) of upward curved grid cells according to the Peuker
and Douglas algorithm, and if viewed, resembles a channel network. This proto-channel network generally
lacks connectivity and requires thinning, issues that were discussed in detail by Band (1986).
Console usage

processing.runalg(taudem:peukerdouglas, elevation_grid, center_weight, side_weight, diagonal_wei

See also

Band, L. E., (1986), Topographic partition of watersheds with digital elevation models, Water Resources
Research, 22(1): 15-24.
Peuker, T. K. and D. H. Douglas, (1975), Detection of surface-specific points by local parallel processing
of discrete terrain elevation data, Comput. Graphics Image Process., 4: 375-387.
Slope Area Combination
Description

Creates a grid of slope-area values = (Sm) (An) based on slope and specific catchment area grid inputs, and
parameters m and n. This tool is intended for use as part of the slope-area stream raster delineation method.
Parameters

Slope Grid [raster] This input is a grid of slope values. This grid can be obtained from the D-Infinity Flow
Directions tool.
Contributing Area Grid [raster] A grid giving the specific catchment area for each cell taken as its own
contribution (grid cell length or summation of weights) plus the proportional contribution from upslope
neighbors that drain in to it. This grid is typically obtained from the D-Infinity Contributing Area tool.
Slope Exponent [number] The slope exponent (m) parameter which will be used in the formula:
(Sm)(An), that is used to create the slope-area grid.
Default: 2
Area Exponent [number] The area exponent (n) parameter which will be used in the formula: (Sm)(An),
that is used to create the slope-area grid.
Default: 1
Outputs

Slope Area Grid [raster] A grid of slope-area values = (Sm)(An) calculated from the slope grid, specific
catchment area grid, m slope exponent parameter, and n area exponent parameter.

636

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Console usage

processing.runalg(taudem:slopeareacombination, slope_grid, area_grid, slope_exponent, area_expon

See also

Stream Definition By Threshold


Description

Operates on any grid and outputs an indicator (1, 0) grid identifing cells with input values >= the threshold value.
The standard use is to use an accumulated source area grid to as the input grid to generate a stream raster grid
as the output. If you use the optional input mask grid, it limits the domain being evaluated to cells with mask
values >= 0. When you use a D-infinity contributing area grid (*sca) as the mask grid, it functions as an edge
contamination mask. The threshold logic is:
src = ((ssa >= thresh) & (mask >= s0)) ? 1:0

Parameters

Accumulated Stream Source Grid [raster] This grid nominally accumulates some characteristic or
combination of characteristics of the watershed. The exact characteristic(s) varies depending on the stream
network raster algorithm being used. This grid needs to have the property that grid cell values are monotonically increasing downslope along D8 flow directions, so that the resulting stream network is continuous.
While this grid is often from an accumulation, other sources such as a maximum upslope function will also
produce a suitable grid.
Threshold [number] This parameter is compared to the value in the Accumulated Stream Source grid (*ssa)
to determine if the cell should be considered a stream cell. Streams are identified as grid cells for which ssa
value is >= this threshold.
Default: 100
Mask Grid [raster] Optional.
This optional input is a grid that is used to mask the domain of interest and output is only provided where
this grid is >= 0. A common use of this input is to use a D-Infinity contributing area grid as the mask so
that the delineated stream network is constrained to areas where D-infinity contributing area is available,
replicating the functionality of an edge contamination mask.
Outputs

Stream Raster Grid [raster] This is an indicator grid (1, 0) that indicates the location of streams, with a
value of 1 for each of the stream cells and 0 for the remainder of the cells.
Console usage
processing.runalg(taudem:streamdefinitionbythreshold, -ssa, -thresh, -mask, -src)

18.8. TauDEM algorithm provider

637

QGIS User Guide, Release 2.6

See also

Stream Drop Analysis


Description

Applies a series of thresholds (determined from the input parameters) to the input accumulated stream source
grid (*ssa) grid and outputs the results in the *drp.txt file the stream drop statistics table. This function is
designed to aid in the determination of a geomorphologically objective threshold to be used to delineate streams.
Drop Analysis attempts to select the right threshold automatically by evaluating a stream network for a range
of thresholds and examining the constant drop property of the resulting Strahler streams. Basically it asks the
question: Is the mean stream drop for first order streams statistically different from the mean stream drop for
higher order streams, using a T-test. Stream drop is the difference in elevation from the beginning to the end of
a stream defined as the sequence of links of the same stream order. If the T-test shows a significant difference
then the stream network does not obey this law so a larger threshold needs to be chosen. The smallest threshold
for which the T-test does not show a significant difference gives the highest resolution stream network that obeys
the constant stream drop law from geomorphology, and is the threshold chosen for the objective or automatic
mapping of streams from the DEM. This function can be used in the development of stream network rasters, where
the exact watershed characteristic(s) that were accumulated in the accumulated stream source grid vary based on
the method being used to determine the stream network raster.

The constant stream drop law was identified by Broscoe (1959). For the science behind using this to determine
a stream delineation threshold, see Tarboton et al. (1991, 1992), Tarboton and Ames (2001).
Parameters

D8 Contributing Area Grid [raster] A grid of contributing area values for each cell that were calculated using the D8 algorithm. The contributing area for a cell is the sum of its own contribution plus the
contribution from all upslope neighbors that drain to it, measured as a number of cells or the sum of weight
loadings. This grid can be obtained as the output of the D8 Contributing Area tool. This grid is used in
the evaluation of drainage density reported in the stream drop table.
D8 Flow Direction Grid [raster] A grid of D8 flow directions which are defined, for each cell, as the
direction of the one of its eight adjacent or diagonal neighbors with the steepest downward slope. This grid
can be obtained as the output of the D8 Flow Directions tool.
Pit Filled Elevation Grid [raster] A grid of elevation values. This is usually the output of the Pit
Remove tool, in which case it is elevations with pits removed.
Accumulated Stream Source Grid [raster] This grid must be monotonically increasing along the
downslope D8 flow directions. It it compared to a series of thresholds to determine the beginning of the
streams. It is often generated by accumulating some characteristic or combination of characteristics of the
watershed with the D8 Contributing Area tool, or using the maximum option of the D8 Flow Path
Extreme tool. The exact method varies depending on the algorithm being used.
Outlets Shapefile [vector: point] A point shapefile defining the outlets upstream of which drop analysis
is performed.

638

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Minimum Threshold [number] This parameter is the lowest end of the range searched for possible threshold
values using drop analysis. This technique looks for the smallest threshold in the range where the absolute
value of the t-statistic is less than 2. For the science behind the drop analysis see Tarboton et al. (1991,
1992), Tarboton and Ames (2001).
Default: 5
Maximum Threshold [number] This parameter is the highest end of the range searched for possible threshold
values using drop analysis. This technique looks for the smallest threshold in the range where the absolute
value of the t-statistic is less than 2. For the science behind the drop analysis see Tarboton et al. (1991,
1992), Tarboton and Ames (2001).
Default: 500
Number of Threshold Values [number] The parameter is the number of steps to divide the search range
into when looking for possible threshold values using drop analysis. This technique looks for the smallest
threshold in the range where the absolute value of the t-statistic is less than 2. For the science behind the
drop analysis see Tarboton et al. (1991, 1992), Tarboton and Ames (2001).
Default: 10
Spacing for Threshold Values [selection] This parameter indicates whether logarithmic or linear
spacing should be used when looking for possible threshold values using drop ananlysis.
Options:
0 Logarithmic
1 Linear
Default: 0
Outputs

D-Infinity Drop to Stream Grid [file] This is a comma delimited text file with the following header
line:
:: Threshold,DrainDen,NoFirstOrd,NoHighOrd,MeanDFirstOrd,MeanDHighOrd,StdDevFirstOrd,StdDevHighOrd,T
The file then contains one line of data for each threshold value examined, and then a summary line that
indicates the optimum threshold value. This technique looks for the smallest threshold in the range where
the absolute value of the t-statistic is less than 2. For the science behind the drop analysis, see Tarboton et
al. (1991, 1992), Tarboton and Ames (2001).
Console usage

processing.runalg(taudem:streamdropanalysis, d8_contrib_area_grid, d8_flow_dir_grid, pit_filled_

See also

Broscoe, A. J., (1959), Quantitative analysis of longitudinal stream profiles of small watersheds, Office
of Naval Research, Project NR 389-042, Technical Report No. 18, Department of Geology, Columbia University, New York.
Tarboton, D. G., R. L. Bras and I. Rodriguez-Iturbe, (1991), On the Extraction of Channel Networks from
Digital Elevation Data, Hydrologic Processes, 5(1): 81-100.
Tarboton, D. G., R. L. Bras and I. Rodriguez-Iturbe, (1992), A Physical Basis for Drainage Density,
Geomorphology, 5(1/2): 59-76.
Tarboton, D. G. and D. P. Ames, (2001), Advances in the mapping of flow networks from digital elevation data, World Water and Environmental Resources Congress, Orlando, Florida, May 20-24, ASCE,
http://www.engineering.usu.edu/dtarb/asce2001.pdf.
18.8. TauDEM algorithm provider

639

QGIS User Guide, Release 2.6

Stream Reach and Watershed


Description

This tool produces a vector network and shapefile from the stream raster grid. The flow direction grid is used
to connect flow paths along the stream raster. The Strahler order of each stream segment is computed. The subwatershed draining to each stream segment (reach) is also delineated and labeled with the value identifier that
corresponds to the WSNO (watershed number) attribute in the Stream Reach Shapefile.
This tool orders the stream network according to the Strahler ordering system. Streams that dont have any other
streams draining in to them are order 1. When two stream reaches of different order join the order of the downstream reach is the order of the highest incoming reach. When two reaches of equal order join the downstream
reach order is increased by 1. When more than two reaches join the downstream reach order is calculated as the
maximum of the highest incoming reach order or the second highest incoming reach order + 1. This generalizes
the common definition to cases where more than two reaches join at a point. The network topological connectivity
is stored in the Stream Network Tree file, and coordinates and attributes from each grid cell along the network are
stored in the Network Coordinates file.
The stream raster grid is used as the source for the stream network, and the flow direction grid is used to trace
connections within the stream network. Elevations and contributing area are used to determine the elevation and
contributing area attributes in the network coordinate file. Points in the outlets shapefile are used to logically split
stream reaches to facilitate representing watersheds upstream and downstream of monitoring points. The program
uses the attribute field id in the outlets shapefile as identifiers in the Network Tree file. This tool then translates
the text file vector network representation in the Network Tree and Coordinates files into a shapefile. Further
attributes are also evaluated. The program has an option to delineate a single watershed by representing the entire
area draining to the Stream Network as a single value in the output watershed grid.
Parameters

Pit Filled Elevation Grid [raster] A grid of elevation values. This is usually the output of the Pit
Remove tool, in which case it is elevations with pits removed.
D8 Flow Direction Grid [raster] A grid of D8 flow directions which are defined, for each cell, as the
direction of the one of its eight adjacent or diagonal neighbors with the steepest downward slope. This grid
can be obtained as the output of the D8 Flow Directions tool.
D8 Drainage Area [raster] A grid giving the contributing area value in terms of the number of grid cells (or
the summation of weights) for each cell taken as its own contribution plus the contribution from upslope
neighbors that drain in to it using the D8 algorithm. This is usually the output of the D8 Contributing
Area tool and is used to determine the contributing area attribute in the Network Coordinate file.
Stream Raster Grid [raster] An indicator grid indicating streams, by using a grid cell value of 1 on
streams and 0 off streams. Several of the Stream Network Analysis tools produce this type of grid.
The Stream Raster Grid is used as the source for the stream network.
Outlets Shapefile as Network Nodes [vector: point] Optional.
A point shape file defining points of interest. If this file is used, the tool will only deliiniate the stream
network upstream of these outlets. Additionally, points in the Outlets Shapefile are used to logically split
stream reaches to facilitate representing watersheds upstream and downstream of monitoring points. This
tool REQUIRES THAT THERE BE an integer attribute field id in the Outlets Shapefile, because the id
values are used as identifiers in the Network Tree file.
Delineate Single Watershed [boolean] This option causes the tool to delineate a single watershed by
representing the entire area draining to the Stream Network as a single value in the output watershed grid.
Otherwise a seperate watershed is delineated for each stream reach. Default is False (seperate watershed).
Default: False

640

Kapitel 18. Processing providers and algorithms

QGIS User Guide, Release 2.6

Outputs

Stream Order Grid [raster] The Stream Order Grid has cells values of streams ordered according to the
Strahler order system. The Strahler ordering system defines order 1 streams as stream reaches that dont
have any other reaches draining in to them. When two stream reaches of different order join the order of
the downstream reach is the order of the highest incoming reach. When two reaches of equal order join the
downstream reach order is increased by 1. When more than two reaches join the downstream reach order is
calculated as the maximum of the highest incoming reach order or the second highest incoming reach order
+ 1. This generalizes the common definition to cases where more than two flow paths reaches join at a point.
Watershed Grid [raster] This output grid identified each reach watershed with a unique ID number, or in
the case where the delineate single watershed option was checked, the entire area draining to the stream
network is identified with a single ID.
Stream Reach Shapefile [vector] This output is a polyline shapefile giving the links in a stream network.
The columns in the attribute table are:
LINKNO Link Number. A unique number associated with each link (segment of channel between
junctions). This is arbitrary and will vary depending on number of processes used
DSLINKNO Link Number of the downstream link. -1 indicates that this does not exist
USLINKNO1 Link Number of first upstream link. (-1 indicates no link upstream, i.e. for a source
link)
USLINKNO2 Link Number of second upstream link. (-1 indicates no second link upstream, i.e. for
a source link or an internal monitoring point where the reach is logically split but the network does not
bifurcate)
DSNODEID Node identifier for node at downstream end of stream reach. This identifier corresponds to the id attribute from the Outlets shapefile used to designate nodes
Order Strahler Stream Order
Length Length of the link. The units are the horizontal map units of the underlying DEM grid
Magnitude Shreve Magnitude of the link. This is the total number of sources upstream
DS_Cont_Ar Drainage area at the downstream end of the link. Generally this is one grid cell
upstream of the downstream end because the drainage area at the downstream end grid cell includes
the area of the stream being joined
Drop Drop in elevation from the start to the end of the link
Slope Average slope of the link (computed as drop/length)
Straight_L Straight line distance from the start to the end of the link
US_Cont_Ar Drainage area at the upstream end of the link
WSNO Watershed number. Cross reference to the *w.shp and *w grid files giving the identification number of the watershed draining directly to the link
DOUT_END Distance to the eventual outlet (i.e. the most downstream point in the stream network)
from the downstream end of the link
DOUT_START Distance to the eventual outlet from the upstream end of the link
DOUT_MID Distance to the eventual outlet from the midpoint of the link
Network Connectivity Tree [file] This output is a text file that details the network topological connectivity is stored in the Stream Network Tree file. Columns are as follows:
Link Number (Arbitrary will vary depending on number of processes used)
Start Point Number in Network coordinates (*coord.dat) file (Indexed from 0)
End Point Number in Network coordinates (*coord.dat) file (Indexed from 0)

18.8. TauDEM algorithm provider

641

QGIS User Guide, Release 2.6

Next (Downstream) Link Number. Points to Link Number. -1 indicates no links downstream, i.e. a
terminal link
First Previous (Upstream) Link Number. Points to Link Number. -1 indicates no upstream links
Second Previous (Upstream) Link Numbers. Points to Link Number. -1 indicates no upstream links.
Where only one previous link is -1, it indicates an internal monitoring point where the reach is logically
split, but the network does not bifurcate
Strahler Order of Link
Monitoring point identifier at downstream end of link. -1 indicates downstream end is not a monitoring
point
Network magnitude of the link, calculated as the number of upstream sources (following Shreve)
Network Coordinates [file] This output is a text file that contains the coordinates and attributes of points
along the stream network. Columns are as follows:
X coordinate
Y Coordinate
Distance along channels to the downstream end of a terminal link
Elevation
Contributing area
Console usage

processing.runalg(taudem:streamreachandwatershed, -fel, -p, -ad8, -src, -o, -sw, -ord, -w, -net,

See also

642

Kapitel 18. Processing providers and algorithms

KAPITEL 19

Druckzusammenstellung

Mit der Druckzusammenstellung knnen Sie ansprechende Karten und Atlanten erstellen die als PDF-Datei, als
Bild oder als SVG-Datei geduckt oder gespeichert werden knnen. Dies ist eine leistungsstarke Methode geografische Informationen, die von QGIS erstellt werden in Berichten zu teilen oder zu verffentlichen.
Die Druckzusammenstellung stellt immer mehr Layout- und Druckfunktionen bereit. Sie macht es mglich Elemente wie die QGIS Kartenanzeige, Beschriftungen, Legenden, Mastbe, Grundformen, Pfeile, Attributtabellen
und HTML-Rahmen hinzuzufgen. Sie knnen bei jedem Element die Gre verndern, es gruppieren, ausrichten
und positionieren als auch die Eigenschaften anpassen um Ihr Layout zu erstellen. Das Layout kann in Bildformate wie PostScript, PDF oder SVG (der Export in SVG funktioniert nicht mit einigen aktuellen Qt4 Versionen,
Sie sollten dies individuell aus Ihrem System ausprobieren) gedruckt oder exportiert werden. Sie knnen das
Layout als Vorlage speichern und es wieder in anderen Sitzungen laden. Schlielich kann das Erstellen meherer
Karten basierend auf einer Vorlage mit der Atlaserzeugung durchgefhrt werden. Sie finden eine Liste von Tools
in table_composer_1:

643

QGIS User Guide, Release 2.6

Icon

Zweck

Icon

Zweck

Projekt speichern

Neue Zusammenstellung

Zusammenstellungsduplizierung

Druckzusammenstellung verwalten

Aus Vorlage laden

Als Vorlage speichern

Drucken oder Exportieren als PostScript

Speichern als Rasterbild

Speichern als SVG

Als PDF exportieren

Letzte nderung zurcknehmen

Letzte nderung wiederherstellen

Volle Ausdehnung

Zoom auf 100%

Hineinzoomen

Hinauszoomen

Aktualisiere Ansicht
Druckzusammenstellung verschieben

Auf bestimmte Region zoomen

Eintrag whlen/verschieben

Den Elementinhalt verschieben

Neue Karte aus QGIS Kartenansicht hinzufgen

Bild hinzufgen

Neue Beschriftung hinzufgen

Neue Legende hinzufgen

Einen Mastab zu Druckzusammenstellung hinzufgen

Einfaches Objekt hinzufgen

Pfeil hinzufgen

Fgt Attributtabelle hinzu

Einen HTML-Rahmen hinzufgen


Elemente gruppieren

Gruppe auflsen

Gewhlte Element fixieren

Alle Elemente entsichern

Hervorholen

Versenken

In den Vordergrund holen

In den Hintergrund schicken

Linksbndig

Rechtsbndig

Zentrieren

Vertikal zentrieren

Oben bndig

Unten bndig

Atlasvorschau

Erstes Objekt

Vorheriges Objekt

Nchstes Objekt

Letztes Objekt

Atlas drucken

Atlas als Bilder exportieren

Atlas-Einstellungen

Tabelle Composer 1: Funktionen der Druckzusammenstellung


Alle Werkzeuge der Druckzusammenstellung stehen in Mens und als Icons in der Werkzeugleiste zur Verfgung. Die Werkzeugleiste kann aus und angeschaltet werden, indem Sie rechte Maustaste in der Werkzeugleiste
verwenden.

19.1 Erste Schritte


19.1.1 Ein neues Template ffnen
Bevor Sie mit der Druckzusammenstellung anfangen zu arbeiten mssen Sie einige Raster- und Vektorlayer in das
QGIS Kartenfenster laden und Ihre Eigenschaften Ihren Wnschen anpassen. Wenn alles nach Ihren Wnschen

644

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Neue Druckzusammenstellung
dargestellt und symbolisiert ist klicken Sie das
Icon in der Werkzeugleiste oder whlen
Sie Projekt Neue Druckzusammenstellung. Sie werden aufgefordert einen Titel fr die neue Zusammenstellung
auszuwhlen.

19.1.2 berblick ber die Druckzusammenstellung


Das ffnen der Druckzusammenstellung bietet Ihnen eine leere Seite, die die Blattoberflche beim Benutzen der
Druckoption darstellt. Zunchst finden Sie Knpfe auf der linken Seite der Seite um Druckzusammenstellungselemente hinzuzufgen; die aktuelle QGIS Kartenansicht, Beschriftungen, Bilder, Legenden, Mastbe, einfache
Formen, Pfeile, Attributtabellen und HTML-Rahmen. In dieser Werkzeugleiste finden Sie auch Werkzeugleistenknpfe zum Navigieren, Zoomen in einen Bereich und zum Verschieben der Ansicht in der Zusammenstellung
und Werkzeugleistenknpfe um ein Druckzusammenstellunselement auszuwhlen und den Inhalt des Kartenelements zu verschieben.
Figure_composer_overview zeigt die anfngliche Ansicht der Druckzusammenstellung bevor Elemente hinzugefgt sind.

Abbildung 19.1: Druckzusammenstellung


Rechts von der Seite finden Sie zwei Bedienfelder. Das obere Bedienfeld enthlt die Reiter Elemente und Befehlsprotokoll und das untere Bedienfeld enthlt die Reiter Zusammenstellung, Elementeigenschaften und AtlasErzeugung.
Der Elementeigenschaften Reiter stellt eine Liste aller Kartenzusammenstellungselemente die der Seite
hinzugefgt wurden.
19.1. Erste Schritte

645

QGIS User Guide, Release 2.6

Der Befehlprotokoll Reiter stellt einen Verlauf aller nderungen, die am Druckzusammenstellungslayout
durchgefhrt wurden dar. Mit einem Mausklick ist es mglich Layoutschritte vorwrts oder rckwrts zu
einem bestimmten Status rckgngig zu machen oder wiederherzustellen.
Der Reiter Zusammenstellung ermglicht Ihnen die Papiergre, Orientierung, den Seitenhintergrund, Anzahl der Seiten und die Druckqualitt der Ausgabedatei in dpi einzustellen. Darberhinaus knnen Sie
Als Raster drucken Kontrollkstchen aktivieren. Das heisst, dass alle Elemente vor dem
auch das
Drucken oder Speichern als PostScript oder PDF gerastert werden. In diesem Reiter knnen Sie auch benutzerdefinierte Einstellungen fr Gitter und Ausrichtungen vornehmen.
Select/Move item
icon to select
The Item Properties tab displays the properties for the selected item. Click the
an item (e.g., legend, scale bar or label) on the canvas. Then click the Item Properties tab and customize the
settings for the selected item.

Der Atlas-Erzeugung Reiter ermglicht es Ihnen die Erstellung eines Atlas fr die aktuelle Zusammenstellung zu bewirken und bietet Zugang zu seinen Parametern.
Schlielich knnen Sie Ihre Druckzusammenstellung mit dem

Projekt speichern

Knopf speichern.

Im unteren Teil des Druckzusammenstellungsfensters knnen Sie eine Statusleiste mit der Mausposition, aktuellen
Seitenanzahl und einer Kombobox zum Einstellen der Zoomstufe finden.
Sie knnen der Zusammenstellung mehrere Element hinzufgen. Es ist auch mglich, dass die Druckzusammenstellungsansicht mehr als eine Karte, Legende oder Mastab enthlt, dies auf einer oder mehreren Seiten. Jedes
Element hat seine eigenen Eigenschaften und, im Fall der Karte, seine eigenen Ausmae. Wenn Sie ein Element
aus der Zusammenstellungsansicht entfernen wollen knnen Sie das mit Entf oder Rcktaste tun.
In der Druckzusammenstellung navigieren
Um im Layout navigieren zu knnen bietet die Druckzusammenstellung einige grundlegende Tools:

Hineinzoomen

Hinauszoomen

Volle Ausdehung

Zoom auf 100%

Aktualisiere Ansicht

Druckzusammenstellung verschieben

Zoom

(zu einer bestimmten Region der Zusammenstellung zoomen)

Sie knnen den Zoomlevel auch verndern indem Sie das Mausrad oder die Kombobox in der Statusleiste benutzen. Wenn Sie in den Verschieben Modus beim Arbeiten in der Zusammenstellungsansicht wechseln mssen
knnen sie die Leertaste oder das Mausrad gedrckt halten. Mit Strg+Leertaste knnen Sie zeitweise
zum Zoommodus wechseln und mit Strg+Umschalt+Leertaste zum Hinauszoomen Modus wechseln.

19.1.3 Beispielsitzung
Um zu zeigen wie man eine Karte erstellt folgen Sie den nchsten Anweisungen.
Neue Karte hinzufgen
1. Whlen Sie den
Werkzugleistenknopf aus und zeichnen Sie ein Rechteck auf die Seite
indem Sie die linke Maustaste gedrckt halten. Innerhalb des gezeichneten Rechteckes erscheint die QGIS
Kartenansicht auf der Seite.
Neuen Mastab hinzufgen
2. Whlen Sie den
Werkzeugleistenknopf und plazieren Sie das Kartenelement mit
der linken Maustaste auf der Druckzusammenstellungsseite. Es wird ein Mastab der Seite hinzugefgt.

646

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Neue Legende hinzufgen


3. Whllen Sie den
Werkzeugleistenknopf und zeichnen Sie ein Rechteck auf die Seite
indem sie die linke Maustaste gedrckt halten. Innerhalb des Rechtecks wird die Legende gezeichnet.

4. Whlen Sie das


bisschen.

Den Elementinhalt verschieben

Icon um die Karte auszuwhlen und verschieben Sie es ein

5. Whrend das Kartenelement noch ausgewhlt ist knnen Sie auch die Gre des Kartenelements verndern.
Klicken Sie whrend Sie die linke Maustaste gedrckt halten in eine weies kleines Rechteck in einer der
Ecken des Kartenelements und verschieben Sie es an einen neuen Ort um seine Gre zu verndern.
6. Klicken Sie den Elementeigenschaften Reiter im linken unteren Bedienfeld und suchen Sie die Einstellung
fr die Orientierung. ndern Sie den Wert der Einstellung Kartenorientierung auf 15.00. Sie sollten
sehen wie die Orientierung des Kartenelements sich ndert.
7. Schlielich knnen Sie Ihre Druckzusammenstellung mit dem

Projekt speichern

Knopf speichern.

19.1.4 Druckzusammenstellungsoptionen
Unter Einstellungen Zusammenstellungseinstellungen ... knnen Sie einige Optionen, die als voreingestellt
whrend Ihrer Arbeit benutzt werden, einstellen.
Mit Zusammenstellungsvoreinstellungen knnen Sie die Standardschriftart, die verwendet werden soll, benutzen.
Mit Gitterdarstellung knnen Sie den Gitterstil und seine Farbe festlegen.
Gittervoreinstellungen definiert Zwischenrume, Gitterversatz und Fangtoleranz des Gitters. Es gibt drei
Gitterstile: Punkte, Ausgefllt und Kreuze.
Fhrungsvorgaben definiert die Fangtoleranz fr die Fhrungslinien.

19.1.5 Reiter Zusammenstellung - Allgemeines Zusammenstellung Setup


Im Reiter Zusammenstellung knnen Sie die globalen Einstellungen Ihrer Zusammenstellung definieren.
Sie knnen eine der Voreinstellungen fr Ihre Seite auswhlen oder Ihre benutzerdefinierte Breite und Hhe
eingeben.
Die Zusammenstellung kann nun in mehrere Seiten aufgeteilt werden. Beispielsweise kann die erste Seite
eine Kartenansicht zeigen und eine zweite Seite kann die zum Layer gehrende Attributtabelle zeigen
whrend die dritte einen HTML-Rahmen, der zu der Webseite Ihrer Organisation zeigt, zeigt. Stellen Sie die
Seitenzahl auf den gewnschten Wert ein. Sie knnen die Seiten Orientierung und Ihre exportierte Auflsung whlen. Wenn es aktiviert ist mit
Als Raster drucken gemeint, dass alle Elemente vor dem Drucken
oder Speichern als PostScript oder PDF gerastert werden.
Mit Gitter knnen Sie Gittereinstellungen wie Abstand, Gitterversatz und Toleranz an Ihre Anforderungen
anpassen.
Unter Auf Ausrichtungen einrasten knnen Sie die Toleranz, welches der maximale Abstand, unter dem ein
Element auf die Ausrichtungen snappt, ist, ndern.
Das Snappen auf das Gitter und/oder auf die Ausrichtungen kann im Ansicht Men aktiviert werden. In diesem
Men knnen Sie auch das Gitter und die Fhrungen verstecken oder anzeigen.

19.1.6 Gemeinsame Eigenschaften von Zusammenstellunselementen


Zusammenstellungselemente besitzen eine Reihe von allgemeinen Eigenschaften die Sie am unteren Ende des Elementeigenschaften Reiters finden: Position und Gre, Rahmen, Hintergrund, Elementkennung und Darstellung
(siehe figure_composer_common_1).

19.1. Erste Schritte

647

QGIS User Guide, Release 2.6

Abbildung 19.2: Allgemeiner Elementeigenschaften Dialog


Der Position und Gre Dialog erlaubt es Ihnen die Gre und Position des Rahmens, der das Element
beinhaltet, zu definieren. Sie knnen auch auswhlen welcher Referenzpunkt an den vorher definierten X
und Y Koordinaten gesetzt wird.
Die Drehung stellt die Drehung des Elements (in Grad) ein.
Der
Rahmen zeigt oder versteckt den Rahmen um die Beschriftung. Klicken Sie auf die [Farbe] und
[Dicke] Knpfe um die Eigenschaften anzupassen.
Hintergrund aktiviert oder deaktiviert eine Hintergrundfarbe. Klicken Sie auf den [Farbe...] Knopf
Der
um einen Dialog aufzurufen wo Sie eine Farbe auswhlen oder aus einer Voreinstellung auswhlen knnen.
Die Transparenz kann ebenfalls mit dem Alpha Feld angepasst werden.
Verwenden Sie die Elementkennung um eine Beziehung zu anderen Elementen der Druckzusammenstellung
herzustellen. Dies wird beim QGIS Server und anderen potentiellen Webclients benutzt. Sie knnen eine ID
an ein Element vergeben (z.B. eine Karte und eine Beschriftung) und dann kann der Webclient Daten zum
Einstellen einer Eigenschaft (z.B. Beschriftung) fr das bestimmte Element senden. Der GetProjectSettings
Befehl fhrt auf welche Elemente und welche IDs in einem Layout zur Verfgung stehen.
Darstellung kann im Optionen Feld ausgewhlt werden. Siehe Rendering_Mode.
Bemerkung:
Wenn Sie
Farbauswahldialoge verwenden, die laufend aktualisieren in den QGIS Allgemein Optionen aktiviert haben, wird der Farbknopf sich aktualisieren sobald Sie eine neue Farbe in den Farbdialog
Fenstern ausgewhlt haben. Wenn nicht dann mssen Sie den Farbdialog schlieen.
Datendefinierte bersteuerung
Das
Icon neben einem Feld bedeutet dass Sie einem Feld Daten im Kartenelement zuweisen knnen oder dass Sie Ausdrcke verwenden knnen. Diese sind besonders hilfreich bei der
Atlaserstellung (siehe atlas_data_defined_overrides).

19.2 Darstellung
QGIS ermglicht jetzt eine erweiterte Darstellung fr Zusammenstellungselement wie Vektor- und Rasterlayer.

648

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Abbildung 19.3: Darstellung

Transparenz
: Sie knnen das unten liegende Element in der Zusammenstellung mit
diesem Tool sichtbar machen. Verwenden Sie den Schieberegler um die Sichtbarkeit Ihres Elements an
Ihre Bedrfnisse anzupassen. Sie knnen auch eine genaue Definition des Prozentsatzes der Sichtbarkeit im
Men neben dem Schieberegler machen.

Element aus Export ausnehmen: Sie knnen sich entschlieen ein Element in allen Exporten nicht sichtbar zu machen. Nach dem Aktivieren dieses Kontrollkstchens wird das Element nicht in PDFs, Drucken
etc. enthalten sein

Mischmodus: Sie knnen spezielle Darstellungseffekte mit diesen Tools, die Sie vorher vielleicht nur von
Grafikprogrammen kannten, erzielen. Die Pixel Ihrer oben liegenden und darunterliegenden Elemente werden durch die unten beschriebenen Einstellungen gemischt.
Normal: Dies ist der Standardmischmodus, der den Alphakanal des oben liegenden Pixels mit dem
darunter liegenden Pixel vermischt. Die Farben werden nicht vermischt.
Heller: Dies whlt das Maximum jeder Komponente der Vordergrund- und Hintergrundpixel. Seien
Sie sich bewusst dass die Ergebnisse zackig und hart aussehen knnen.
Bildschirm: Helle Pixel der Quelle werden ber die des Ziels gezeichnet, wohingegen dunkle Pixel
nicht verwendet werden. Dieser Modus ist am ntzlichsten fr das Mischen der Textur eines Layers
mit einem anderen Layer (z.B. kann man eine Schummerung dazu verwenden einen anderen Layer
mit einer Textur zu versehen).
Abwedeln: das Abwedeln erhellt und sttigt unten liegende Pixel auf Basis der Helligkeit des oben
liegenden Pixels. Demzufolge erhhen hellere oben liegende Pixel die Sttigung und Helligkeit des
unten liegenden Pixels. Dies funktioniert am Besten wenn die oben liegenden Pixel nicht zu hell sind;
andernfalls ist der Effekt zu extrem.
Addition: Dieser Mischmodus fgt einfach die Pixelwerte eines Layers denen eines anderen Layers
hinzu. Im Falle von Werten grer 1 (im Fall von RGB) wird wei dargestellt. Dieser Modus ist dafr
geeignet Objekte hervorzuheben.
Dunkler: Dies erstellt ein Ergebnispixel das die kleinste Komponente der Vordergrund und Hintergrundpixel erhlt. Wie das Aufhellen neigen die Ergebnisse dazu zackig und hart zu sein.
Multiplizieren: Hier werden die Nummern fr jedes Pixel des oben liegenden Layers mit den
entsprechenden Pixeln des unteren Layers multipliziert. Das Ergebnis sind dunklere Bilder.
Einbrennen: Dunklere Farben im oben liegenden Layer bewirken ein Verdunkeln des unten liegenden Layers. Einbrennen kann dazu benutzt werden um unten liegende Layer zu optimieren und zu
colorieren.
berlagern: Dieser Modus kombiniert die Multiplizieren und Bildschirm Mischmodi. Im Ergebnispixel werden helle Bereiche heller und dunkle Bereiche dunkler.
Weiches Licht: Dieses ist dem berlagern sehr hnlich nur dass anstelle Multiplizieren/Bildschirm
Einbrennen/Abwedeln verwendet wird. Hier soll das Leuchten eines weichen Lichtes auf ein Bild
nachgeahmt werden.
Hartes Licht: Hartes Licht ist dem berlagern Modus sehr hnlich. Es soll die Projektion eines sehr
intensiven Lichts auf das Bild nachahmen.
Unterschied: Unterschied subtrahiert das oben liegende Pixel von dem unten liegenden Pixel oder
andersherum um immer einen positiven Wert zu bekommen. Das Mischen mit Schwarz produziert

19.2. Darstellung

649

QGIS User Guide, Release 2.6

keinen Unterschied, da die Differenz mit allen Farben Null ist.


Abziehen: Dieser Mischmodus zieht einfach die Pixelwerte eines Layers von dem anderen ab. Im Fall
von negativen Werten wird Schwarz dargestellt.

19.3 Zusammenstellungselemente
19.3.1 Das Kartenelement
Neue Karte hinzufgen
Werkzeugleistenknopf in der Druckzusammenstellung um die QGIS
Klicken Sie auf den
Kartenansicht hinzuzufgen. Ziehen Sie jetzt ein Rechteck mit der linken Maustaste ber die Zusammenstellungsansicht um die Karte hinzuzufgen. Um die aktuelle Karte anzuzeigen knnen Sie zwischen drei verschiedenen Modi im Elementeigenschaften Reiter whlen:

Rechteck ist die Standardeinstellung. Es wird eine leeres Kstchen mit der Meldung Karte wird hier
gedruckt angezeigt.
Cache zeichnet die Karte in der aktuellen Bildschirmauflsung. Wenn Sie in das Zusammenstellungsfenster
hinein- oder hinauszoomen, wird die Karte nicht wieder gerendert aber das Bild wird skaliert.
Zeichnen meint dass wenn Sie in das Zusammenstellungsfenster hineinzoomen oder nicht, die Karte wieder
gerendert wird, aber aus Platzgrnden nur bis zu einer maximalen Auflsung.
Cache ist der voreingestellte Vorschaumodus fr neu hinzugefgte Druckzusammenstellungskarten.
Eintrag whlen/verschieben
Knopf verndern indem
Sie knnen die Gre des Kartenelements durch Klicken auf den
Sie das Element auswhlen und eins der blauen Kstchen an der Ecke der Karte verschieben. Mit der ausgewhlten
Karte knnen Sie jetzt mehr Eigenschaften im Elementeigenschaften Reiter anpassen.

Um Layer innerhalb des Kartenelements zu verschieben whlen sie das Kartenelement aus, klicken Sie das
Den Elementinhalt verschieben
Icon und verschieben Sie die Layer innerhalb des Karteninhaltsrahmen mit der linken
Maustaste. Nachdem Sie den richtigen Platz fr das Element gefunden haben, knnen Sie die Elementposition
innerhalb der Druckzusammenstellungsseite sichern. Whlen Sie das Kartenelement und verwenden Sie aus der
Lock Selected Items
Werkzeugleiste
oder das Elemente Bedienfeld. Einmal ausgewhlt knnen Sie das Elemente
Bedienfeld verwenden um individuelle Elemente zu entsichern.

Haupteigenschaften
Der Haupteigenschaften Dialog des Karten Elementeigenschaften Reiters stellt die folgenden Funktionalitten
bereit (siehe figure_composer_map_1):
Der Vorschau Bereich ermglicht es Ihnen die Vorschaumodi Rechteck, Cache und Zeichnen wie
oben beschrieben zu definieren. Wenn Sie die Ansicht im QGIS Kartenfenster verndern indem Sie Vektoroder Rastereigenschaften verndern, knnen Sie die Druckzusammenstellung aktualisieren, indem Sie das
Kartenelement in der Druckzusammenstellung auswhlen und den [Vorschau aktualisieren] Knopf klicken.
Das Feld Mastab

stellt einen Mastab manuell ein.

Das Feld Drehung


ermglicht es Ihnen die Kartenelementinhalte im Uhrzeigersinn in Grad zu
drehen. Beachten Sie, dass ein Koordinatenrahmen nur beim Standardwert 0 hinzugefgt werden kann.
Mit
Kartenelemente zeichnen knnen Sie Beschriftungen zeigen, die in der Kartenanzeige im QGIS
Hauptfenster platziert worden sind.
Sie knnen sich dazu entschlieen Layer, die in einem Kartenelement gezeigt werden zu sichern. Aktivieren
Sie
Layer des Kartenelements festhalten. Nachdem dies aktiviert ist wird jeder Layer, der im QGIS
Hauptfenster angezeigt oder versteckt wird, nicht erscheinen oder versteckt sein im Kartenelement der

650

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Abbildung 19.4: Elementeigenschaften Reiter


Zusammenstellung. Stil und Beschriftung eines gesicherten Layers werden immer noch gem dem QGIS
Hauptfenster aktualisiert.
Der

Knopf ermglicht es Ihnen schnell alle Voreinstellungen, die Sie in QGIS vorbereitet haben,

hinzuzufgen. Wenn Sie auf den


Knopf drcken werden Sie die Liste aller Voreinstellungen sehen:
whlen Sie einfach die Voreinstellung aus, die sie darstellen wollen. Die Kartenansicht wird automatisch
die voreingestellten Layer sichern indem

Layer des Kartenelements festhalten aktiviert wird: wenn sie

und drcken Sie auf den


die Voreinstellung abwhlen wollen, deaktivieren Sie die
Legende um herauszufinden wie man Voreinstellungen erstellt.

Knopf. Siehe

Ausdehnung
Der Ausdehung Dialog der Karten Elementeigenschaften stellt die folgenden Funktionalitten bereit (siehe figure_composer_map_2):

Abbildung 19.5: Kartenausdehnung Dialog


Der Kartenausdehnung Bereich ermglicht es Ihnen die Kartenausdehnung anhand von X und Y min/max

19.3. Zusammenstellungselemente

651

QGIS User Guide, Release 2.6

Werten anzugeben indem Sie den [Anzeigegrenzen bernehmen] Knopf klicken. Dieser Knopf setzt die
Kartenausdehnung der Zusammenstellunskarte auf die Ausmae der aktuellen Kartenansicht in der QGIS
Hauptansicht. Der Knopf [Ausmae in der Karte anzeigen] macht genau das Gegenteil, es aktualisiert die
Ausmae der Kartenansicht in der QGIS Anwendung auf die Ausdehnung der Zusammenstellungskarte.
Wenn Sie die Ansicht in der QGIS Kartenanzeige ndern indem Sie Vektorlayer- oder Rasterlayereigenschaften
ndern knnen Sie die Druckzusammenstellungsansicht aktualisieren indem Sie das Kartenelement in der Druckzusammenstellung auswhlen und den [Vorschau aktualisieren] Knopf im Elementeigenschaften Reiter der Karte
klicken (siehe figure_composer_map_1).
Gitter
Der Gitter anzeigen Dialog des Karten Elementeigenschaften Reiters bietet die Mglichkeit dem Kartenelement
mehrere Gitter hinzuzufgen.
Mit dem Plus- und Minusknopf knne Sie ein ausgewhltes Gitter hinzufgen oder auswhlen.
Mit den Hoch und Runterknpfen knnen Sie ein Gitter aus der Liste verschieben und die Zeichenprioritt
festlegen.
Wenn Sie auf das hinzugefgte Gitter doppelklicken knnen Sie ihm einen anderen Namen geben.

Abbildung 19.6: Kartengitterdialog

Nachdem Sie ein Gitter hinzugefgt haben knnen Sie das Kontrollkstchen
Gitter zeichnen aktivieren um
das Kartenelement mit einem Gitter zu berlagern. Rollen Sie diese Option aus um zu einer groen Menge von
Konfigurationsoptionen zu gelangen, siehe Figure_composer_map_4.
Als Gittertyp knnen Sie festlegen dass eine ausgefllte Linie oder ein Kreuz verwendet werden. Die Darstellung
des Gitters kann ausgewhlt werden. Siehe Abschnitt Rendering_Mode. Darberhinaus knnen Sie ein Intervall
in X und Y Richtung definieren, einen X- und Y-Versatz und die Breite die fr den Kreuz- oder Liniengittertyp
verwendet wird.
Es gibt verschiedene Optionen um den Rahmen der die Karte hlt zu gestalten. Folgende Optionen sind erhltlich: Kein Rahmen, Zebra, Markierungen innen, Markierungen auen, Innere und uere Markierungen
und Liniengrenze.
Der erweiterte Darstellungsmodus steht auch fr Gitter zur Verfgung (siehe Abschnitt Rendering_mode).
Das
Koordinaten zeichnen Kontrollkstchen ermglicht es Ihnen dem Kartenrahmen Koordinaten
hinzuzufgen. Die Beschriftung kann innerhalb oder auerhalb des Kartenrahmens gezeichnet werden. Die
Beschriftungsrichtung kann als horizontal, vertikal, horizontal und vertikal oder Grenzrichtung fr jede
Grenze individuell definiert werden. Die Einheiten knnen in Metern oder Grad sein. Schlielich knnen Sie
die Gitterfarbe, die Schriftart, den Abstand zum Kartenrahmen und die Koordinatengenauigkeit definieren.
bersichten
Der bersichten Dialog des Elementeigenschaften Reiters stellt die folgenden Funktionalitten zur Verfgung:
Sie knnen sich entschlieen eine bersichtskarte zu erstellen welche die Ausmae anderer Karten, die in der
Zusammenstellung zut Verfgung stehen, zeigen. Als erstes mssen Sie die Karte(n), die sie in die bersichtskarte
652

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Abbildung 19.7: Gitter zeichnen Dialog

Abbildung 19.8: Gitterrahmendialog

19.3. Zusammenstellungselemente

653

QGIS User Guide, Release 2.6

Abbildung 19.9: Gitter-Koordinaten-Zeichnen-Dialog

Abbildung 19.10: Kartenbersichtendialog

654

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

einfgen wollen, erstellen. Als nchstes erstellen Sie die Karte die Sie wollen, um sie als bersichtskarte zu
benutzen, genau iwe eine normale Karte.
Mit dem Plus- und Minusknopf knnen Sie bersichten hinzufgen oder entfernen.
Mit dem Rauf- und Runterknopf knnen Sie eine bersicht in der Liste verschieben und die Zeichenprioritt
setzen.
ffnen Sie bersichten und drcken Sie den grnen Plusknopf um eine bersicht hinzuzufgen. Zunchst wird
diese bersicht bersicht 1 genannt (siehe Figure_composer_map_7). Sie knnen den Namen verndern wenn
Sie auf das bersichtelement in der Liste genannt berblick 1 doppelklicken und ihm einen anderen Namen
geben.
Wenn Sie da bersichtselement in der Liste auswhlen knnen Sie es anpassen.

:guilabel:bersicht <name_bersicht> muss aktiviert sein um die Ausmae des gewhlten Kartenrahmens zu zeichnen.

Die bersichtsrahmen Auswahlliste verweist auf das Kartenelement, dessen Ausmae auf das aktuelle
Kartenelement gezeichnet werden.
Der Rahmenstil ermglicht es Ihnen die bersichtsrahmenfarbe zu ndern.
Der Mischmodus ermglicht verschiedene Transparenzmischmodi einzustellen. Siehe Rendering_Mode.

bersicht invertieren erstellt eine Maske um die Ausmae wenn es aktiviert ist: die referenzierte Kartenausmae werden deutlich angezeigt, whrenddessen alles andere mit einer Rahmenkarte ausgeblendet
wird.

Auf bersicht zentrieren setzt die Ausmae des bersichtsrahmens in die Mitte der bersichtskarte. Sie
knnen nur eine bersicht zum Zentrieren aktivieren wenn Sie mehrere bersichten hinzugefgt haben.

19.3.2 Das Beschriftungselement


Neue Beschriftung hinzufgen
Icon, platzieren Sie das Element
Um eine Beschriftung hinzuzufgen klicken Sie das
mit der linken Maustaste auf der Druckzusammenstellungsansicht und positionieren und passen Sie sein Aussehen
im Beschriftung Elementeigenschaften Reiter an.

Der Elementeigenschaften Reiter eines Beschriftungselements stellt die folgenden Funktionalitten fr das
Beschriftungselement zur Verfgung (siehe Figure_composer_label):
Haupteigenschaften
Im Haupteigenschaften Dialog wird der Text (HTML oder nicht) oder der Ausdruck, der bentigt wird um
die Beschriftung auszufllen, zur Zusammenstellungsansicht hinzugefgt.
Beschriftungen knnen als HTML-Code interpretiert werden: aktivieren Sie
Als HTML darstellen. Sie
knnen jetzt eine URL, ein klickbares Bild, das zu einer Webseite fhrt oder etwas komplexeres eingeben.
Sie knnen auch einen Ausdruck eingeben. Klicken Sie auf [Einen Ausdruck einfgen] um einen neuen
Dialog zu ffnen. Erstellen Sie einen Ausdruck, indem Sie auf die auf der linken Seite zur Verfgung stehenden Funktionen klicken. Zwei spezielle Kategorien knnen ntzlich sein, insbesondere im Zusammenhang
mit der Atlasfunktionalitt: Geometriefunktionen und Datensatzfunktionen. Unten wird eine Vorschau des
Ausdrucks gezeigt.
Definieren Sie Schrift indem Sie auf den **[Schriftart ...] Knopf klicken oder eine Schriftfarbe indem Sie
eine Farbe mit Hilfe des Farbauswahlwerkzeuges auswhlen.

19.3. Zusammenstellungselemente

655

QGIS User Guide, Release 2.6

Abbildung 19.11: Beschriftungselementeigenschaften Dialog


Ausrichtung und Anzeigen
Sie knnen die horizontale und vertikale Ausrichtung im Bereich Ausrichtung definieren.
Im Darstellung Tag knnen Sie einen Rand in mm definieren. Dies ist der Rand von der Kante des Zusammenstellungselementes.

19.3.3 Das Bildelement


Bild hinzufgen
Um ein Bild hinzuzufgen klicken Sie das
Icon, platzieren Sie das Element mit der linken
Maustaste in der Druckzusammenstellungsanzeige und positionieren und passen Sie sein Aussehen im Bild Elementeigenschaften Reiter an.

Der Bild Elementeigenschaften Reiter stellt die folgenden Funktionalitten zur Verfgung (siehe figure_composer_image_1):
Sie mssen zuerst das Bild, das Sie anzeigen wollen auswhlen. Es gibt mehere Wege die Bildquelle in den
Haupteigenschaften festzulegen.
von Bildquelle um eine Datei auf Ihrem Computer anhand des Suchen1. Verwenden Sie den Suchknopf
Dialogs auszuwhlen. Der Browser starten in den SVG-Bibliotheken die mit QGIS zur Verfgung gestellt
werden. Neben SVG knnen Sie auch noch andere Bildformate auswhlen Sie .png oder .jpg.
2. Sie knnen die Quelle direkt in das Bildquelle Textfeld eingeben. Sie knnen fr ein Bild sogar eine Remote
URL-Adresse vergeben.
3. From the Search directories area you can also select an image from loading preview.. to set the image
source.
4. Use the data defined button

to set the image source from a record or using a regular expression.

With the Resize mode option, you can set how the image is displayed when the frame is changed, or choose to
resize the frame of the image item so it matches the original size of the image.
You can select one of the following modes:
Zoom: Enlarges the image to the frame while maintaining aspect ratio of picture.
656

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Abbildung 19.12: Bildelementeigenschaften Reiter


Stretch: Stretches image to fit inside the frame, ignores aspect ratio.
Clip: Use this mode for raster images only, it sets the size of the image to original image size without scaling
and the frame is used to clip the image, so only the part of the image inside the frame is visible.
Zoom and resize frame: Enlarges image to fit frame, then resizes frame to fit resultant image.
Resize frame to image size: Sets size of frame to match original size of image without scaling.
Selected resize mode can disable the item options Placement and Image rotation. The Image rotation is active
for the resize mode Zoom and Clip.
With Placement you can select the position of the image inside its frame. The Search directories area allows you
to add and remove directories with images in SVG format to the picture database. A preview of the pictures found
in the selected directories is shown in a pane and can be used to select and set the image source.
Images can be rotated with the Image rotation field. Activating the
Sync with map checkbox synchronizes the
rotation of a picture in the QGIS map canvas (i.e., a rotated north arrow) with the appropriate Print Composer
image.
It is also possible to select a north arrow directly. If you first select a north arrow image from Search directories
and then use the browse button
of the field Image source, you can now select one of the north arrow from
the list as displayed in figure_composer_image_2.
Bemerkung: Many of the north arrows do not have an N added in the north arrow, this is done on purpose for
languages that do not use an N for North, so they can use another letter.

19.3. Zusammenstellungselemente

657

QGIS User Guide, Release 2.6

Abbildung 19.13: North arrows available for selection in provided SVG library

19.3.4 The Legend item


Neue Legende hinzufgen
Um ein Kartenelement hinzuzufgen, klicken Sie das
Icon, platzieren Sie das Element mit
der linken Maustaste auf der Druckzusammenstellungsansicht und positionieren und passen Sie das Aussehen der
Legende im Elementeigenschaften Reiter.

The Item properties of a legend item tab provides the following functionalities (see figure_composer_legend_1):
Haupteigenschaften
The Main properties dialog of the legend Item Properties tab provides the following functionalities (see figure_composer_legend_2):
In Main properties you can:
Change the title of the legend.
Set the title alignment to Left, Center or Right.
You can choose which Map item the current legend will refer to in the select list.
You can wrap the text of the legend title on a given character.
Legendenelemente
The Legend items dialog of the legend Item Properties tab provides the following functionalities (see figure_composer_legend_3):
The legend will be updated automatically if
Auto-update is checked. When Auto-update is unchecked
this will give you more control over the legend items. The icons below the legend items list will be activated.
The legend items window lists all legend items and allows you to change item order, group layers, remove
and restore items in the list, edit layer names and add a filter.

658

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Abbildung 19.14: Legendenelementeigenschaften Reiter

Abbildung 19.15: Legenden Haupteigenschaften Dialog

Abbildung 19.16: Legendenelemente Dialog

19.3. Zusammenstellungselemente

659

QGIS User Guide, Release 2.6

The item order can be changed using the [Up] and [Down] buttons or with drag-and-drop functionality. The order can not be changed for WMS legend graphics.
Use the [Add group] button to add a legend group.
Use the [plus] and [minus] button to add or remove layers.
The [Edit] button is used to edit the layer-, groupname or title, first you need to select the legend item.
The [Sigma] button adds a feature count for each vector layer.
Use the [filter] button the filter the legend by map content, only the legend items visible in the map
will be listed in the legend.
After changing the symbology in the QGIS main window, you can click on [Update] to adapt the changes
in the legend element of the Print Composer.
Fonts, Columns, Symbol
The Fonts, Columns and Symbol dialogs of the legend Item Properties tab provide the following functionalities
(see figure_composer_legend_4):

Abbildung 19.17: Legenden Schriftart, Spalten, Symbol und Zwischenrume Dialoge


Sie knnen die Schriftart des Legendentitels, der Gruppe, der Untergruppe und des Elements (Layers) ndern. Klicken Sie auf einen Kategorieknopf um einen Schriftart auswhlen Dialog zu ffnen.
You provide the labels with a Color using the advanced color picker, however the selected color will be
given to all font items in the legen..
Legend items can be arranged over several columns. Set the number of columns in the Count

field.

Gleiche Spaltenbreite stellt ein, wie Legendenspalten angepasst werden sollen.

Die
Layer aufteilen Option ermglicht es eine kategorisierte oder abgestufte Layerlegende in Spalten aufzuteilen.
Sie knnen die Breite und Hhe des Legendensymbols in diesem Dialog ndern.

660

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

WMS legendGraphic and Spacing


The WMS legendGraphic and Spacing dialogs of the legend Item Properties tab provide the following functionalities (see figure_composer_legend_5):

Abbildung 19.18: WMS legendGraphic Dialogs


When you have added a WMS layer and you insert a legend composer item, a request will be send to the WMS
server to provide a WMS legend, This Legend will only be shown if the WMS server provides the GetLegendGraphic capability. The WMS legend content will be provided as a raster image.
WMS legendGraphic is used to be able to adjust the Legend width and the legend hight of the WMS legend raster
image.
Spacing around title, group, subgroup, symbol, icon label, box space or column space can be customized through
this dialog.

19.3.5 The Scale Bar item


Neuen Mastab hinzufgen
Um einen Mastab hinzuzufgen klicken Sie das
Icon, platzieren Sie das Element mit
der linken Maustaste auf der Druckzusammenstellungsansicht und positionieren und passen Sie das Aussehen im
Mastab Elementeigenschaften Reiter an.

The Item properties of a scale bar item tab provides the following functionalities (see figure_composer_scalebar_1):
Haupteigenschaften
The Main properties dialog of the scale bar Item Properties tab provides the following functionalities (see figure_composer_scalebar_2):
Whlen Sie zuerst die Karte aus, an der der Mastab befestigt werden soll.
Whlen Sie dann den Stil des Mastabs. Sechs Stile stehen zur Verfgung:
Einfacher Rahmen und Doppelter Rahmen Stile, die eine oder zwei Linien von Rahmen mit abwechselnden Farben enthalten.
Mittige, Oben oder Unten Linieneinteilung.
Numerisch, wobei das Mastabsverhltnis gedruckt wird (z.B. 1:50000).

19.3. Zusammenstellungselemente

661

QGIS User Guide, Release 2.6

Abbildung 19.19: Mastab Elementeigenschaften Reiter

Abbildung 19.20: Mastab Haupteigenschaften Dialog


Einheiten und Segmente
The Units and Segments dialogs of the scale bar Item Properties tab provide the following functionalities (see
figure_composer_scalebar_3):

Abbildung 19.21: Mastab Einheiten und Segmente Dialoge


In diesen beiden Dialogen knnen Sie einstellen, wie der Mastab dargestellt wird.
Select the map units used. There are four possible choices: Map Units is the automated unit selection;
Meters, Feet or Nautical Miles force unit conversions.
Das Beschriftung Feld definiert den Text, der verwendet wird, um die Einheiten des Mastabs zu
beschreiben.
Karteneinheit pro Mastabseinheit ermglicht Ihnen das Verhltnis zwischen einer Karteneinheit und seiner
Darstellung im Mastab festzulegen.
662

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Sie knnen definieren wie viele Segmente links und rechts vom Mastab gezeichnet werden und wie lang
jedes Segment sein wird (Gre Feld). Hhe kann ebenfalls definiert werden.
Display
The Display dialog of the scale bar Item Properties tab provide the following functionalities (see figure_composer_scalebar_4):

Abbildung 19.22: Scale Bar Display


You can define how the scale bar will be displayed in its frame.
Box margin : space between text and frame borders
Labels margin : space between text and scale bar drawing
Line width : line widht of the scale bar drawing
Join style : Corners at the end of scalebar in style Bevel, Rounded or Square (only available for Scale bar
style Single Box & Double Box)
Cap style : End of all lines in style Square, Round or Flat (only available for Scale bar style Line Ticks Up,
Down and Middle)
Alignment : Puts text on the left, middle or right side of the frame (works only for Scale bar style Numeric)
Fonts and colors
The Fonts and colors dialog of the scale bar Item Properties tab provide the following functionalities (see figure_composer_scalebar_5):

Abbildung 19.23: Scale Bar Fonts and colors Dialogs


You can define the fonts and colors used for the scale bar.
Use the [Font] button to set the font
Font color: set the font color
19.3. Zusammenstellungselemente

663

QGIS User Guide, Release 2.6

Fill color: set the first fill color


Secondary fill color: set the second fill color
Stroke color: set the color of the lines of the Scale Bare
Fill colors are only used for scale box styles Single Box and Double Box. To select a color you can use the list
option using the dropdown arrow to open a simple color selection option or the more advanced color selection
option, that is started when you click in the colored box in the dialog.

19.3.6 The Basic Shape Items


Add basic shape
Add Arrow
icon or the
icon, place
To add a basic shape (ellipse, rectangle, triangle), click the
the element holding down the left mouse. Customize the appearance in the Item Properties tab.

When you also hold down the Shift key while placing the basic shape you can create a perfect square, circle or
triangle.

Abbildung 19.24: Formelementeigenschaften Reiter


The Shape item properties tab allows you to select if you want to draw an ellipse, rectangle or triangle inside the
given frame.
You can set the style of the shape using the advanced symbol style dialog with which you can define its outline
and fill color, fill pattern, use markers etcetera.
For the rectangle shape, you can set the value of the corner radius to round of the corners.
Bemerkung: Unlike other items, you can not style the frame or the background color of the frame.

19.3.7 The Arrow item


Add Arrow
To add an arrow, click the
icon, place the element holding down the left mouse button and drag a line
to draw the arrow on the Print Composer canvas and position and customize the appearance in the scale bar Item
Properties tab.

When you also hold down the Shift key while placing the arrow, it is placed in an angle of exactly 45 .
The arrow item can be used to add a line or a simple arrow that can be used, for example, to show the relation
between other print composer items. To create a north arrow, the image item should be considered first. QGIS has
a set of North arrows in SVG format. Furthermore you can connect an image item with a map so it can rotate
automatically with the map (see the_image_item).

664

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Abbildung 19.25: Pfeilelementeigenschaften Reiter


Item Properties
The Arrow item properties tab allows you to configure an arrow item.
The [Line style ...] button can be used to set the line style using the line style symbol editor.
In Arrows markers you can select one of three radio buttons.
Default : To draw a regular arrow, gives you options to style the arrow head
None : To draw a line without arrow head
SVG Marker : To draw a line with an SVG Start marker and/or End marker
For Default Arrow marker you can use following options to style the arrow head.
Arrow outline color : Set the outline color of the arrow head
Arrow fill color : Set the fill color of the arrow head
Arrow outline width : Set the outline width of the arrow head
Arrow head width: Set the size of the arrow head
For SVG Marker you can use following options.
Start marker : Choose an SVG image to draw at the beginning of the line
End marker : Choose an SVG image to draw at the end of the line
Arrow head width: Sets the size of Start and/or headmarker
SVG images are automatically rotated with the line. The color of the SVG image can not be changed.

19.3.8 The Attribute Table item


Es ist mglich Teile einer Vektorattributtabelle der Druckzusammenstellungsansicht hinzuzufgen: Klicken Sie
Fgt Attributtabelle hinzu
das
Icon, platzieren Sie das Element mit der linken Maustaste auf der Druckzusammenstellungsansicht und positionieren und passen Sie das Aussehen im Elementeigenschaften Reiter an.

The Item properties of an attribute table item tab provides the following functionalities (see figure_composer_table_1):

19.3. Zusammenstellungselemente

665

QGIS User Guide, Release 2.6

Abbildung 19.26: Attribute table Item properties Tab


Haupteigenschaften
The Main properties dialogs of the attribute table Item Properties tab provide the following functionalities (see
figure_composer_table_2):

Abbildung 19.27: Attribute table Main properties Dialog


For Source you can normally select only Layer features.
With Layer you can choose from the vector layers loaded in the project.
The button [Refresh table data] can be used to refresh the table when the actual contents of the table has
changed.
The button [Attributes...] starts the Select attributes menu, see figure_composer_table_3, that can be used
to change the visible contents of the table. After making changes use the [OK] button to apply changes to
the table.
In the Columns section you can:
Remove an attribute, just select an attribute row by clicking anywhere in a row and press the minus
button to remove the selected attribute.
Add a new attribute use the plus button. At the end a new empty row appears and you can select empty
cell of the column Attribute. You can select a field attribute from the list or you can select to build a
new attribute using a regular expression.
Use the up and down arrows to change the order of the attributes in the table.
Select a cel in the Headings column to change the Heading, just type a new name.
666

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Select a cel in the Alignment column and you can choose between Left, Center or Right alignment.
Select a cel in the Width column and you can change it from Automatic to a width in mm, just type a
number. When you want to change it back to Automatic, use the cross.
The [Reset] button can allways be used to restore it to the original attribute settings.
In the Sorting section you can:
Add an attribute to sort the table with. Select an attribute and set the sorting order to Ascending or
Descending and press the plus button. A new line is added to the sort order list.
select a row in the list and use the up and down button to change the sort priority on attribute level.
use the minus button to remove an attribute from the sort order list.

Abbildung 19.28: Attributtabelle Attribute whlen Dialog

Feature filtering
The Feature filtering dialogs of the attribute table Item Properties tab provide the following functionalities (see
figure_composer_table_4):

Abbildung 19.29: Attribute table Feature filtering Dialog


You can:

19.3. Zusammenstellungselemente

667

QGIS User Guide, Release 2.6

Define the Maximum rows to be displayed.


Activate

Remove duplicate rows from table to show unique records only.

Activate
Show only visible features within a map and select the corresponding Composer map to display
the attributes of features only visible on selected map.
Show only features intersecting Atlas feature is only available when
Generate an atlas is
Activate
activated. When activated it will show a table with only the features shown on the map of that particular
page of the atlas.
Activate
Filter with and provide a filter by typing in the input line or insert a regular expressing use
the given expression button. A few examples of filtering statements you can use when you have loaded the
airports layer from the Sample dataset:
ELEV > 500
NAME = ANIAK
NAME NOT LIKE AN%
regexp_match( attribute( $currentfeature, USE ) , [i])
The last regular expression will include only the arpoirts that have a letter i in the attribute field USE.
Appearance
The Appearance dialogs of the attribute table Item Properties tab provide the following functionalities (see figure_composer_table_5):

Abbildung 19.30: Attribute table appearance Dialog


With Cell margins you can define the margin around text in each cell of the table.
With Display header you can select from a list one of On first frame, On all frames default option, or
No header.
The option Empty table controls what will be displayed when the result selection is empty.
Draw headers only, will only draw the header except if you have choosen No header for Display
header.
Hide entire table, will only draw the background of the table. You can activate
ground if frame is empty in Frames to completely hide the table.

Dont draw back-

Draw empty cells, will fill the attribute table with empty cells, this option can also be used to provide
additional empty cells when you have a result to show!
Show set message, will draw the header and adds a cell spanning all columns and display a message
like No result that can be provided in the option Message to display
The option Message to display is only activated when you have selected Show set message for Empty table.
The message provided will be shown in the table in the first row, when the result is an empty table.

668

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

With Background color you can set the background color of the table.
Show grid
The Show grid dialog of the attribute table Item Properties tab provide the following functionalities (see figure_composer_table_6):

Abbildung 19.31: Attribute table Show grid Dialog


Activate

Show grid when you want to display the grid, the outlines of the table cells.

With Stroke width you can set the thickness of the lines used in the grid.
The Color of the grid can be set using the color selection dialog.
Fonts and text styling
The Fonts and text styling dialog of the attribute table Item Properties tab provide the following functionalities
(see figure_composer_table_7):

Abbildung 19.32: Attribute table Fonts and text styling Dialog


You can define Font and Color for Table heading and Table contents.
For Table heading you can additionally set the Alignment and choose from Follow column alignment, Left, Center or Right. The column alignment is set using the Select Attributes dialog (see Figure_composer_table_3 ).
Frames
The Frames dialog of the attribute table Item Properties tab provide the following functionalities (see figure_composer_table_8):

With Resize mode you can select how to render the attribute table contents:
Use existing frames displays the result in the first frame and added frames only.
19.3. Zusammenstellungselemente

669

QGIS User Guide, Release 2.6

Abbildung 19.33: Attribute table Frames Dialog


Extent to next page will create as many frames (and corresponding pages) as necessary to display the
full selection of attribute table. Each frame can be moved around on the layout. If you resize a frame,
the resulting table will be divided up between the other frames. The last frame will be trimmed to fit
the table.
Repeat until finished will also create as many frames as the Extend to next page option, except all
frames will have the same size.
Use the [Add Frame] button to add another frame with the same size as selected frame. The result of the
table that will not fit in the first frame will continue in the next frame when you use the Resize mode Use
existing frames.
Dont export page if frame is empty prevents the page to be exported when the table frame has
Activate
no contents. This means all other composer items, maps, scalebars, legends etc. will not be visible in the
result.
Activate
Dont draw background if frame is empty prevents the background to be drawn when the table
frame has no contents.

19.3.9 The HTML frame item


It is possible to add a frame that displays the contents of a website or even create and style your own HTML page
and display it!
Add HTML frame
Click the
icon, place the element by dragging a rectangle holding down the left mouse button on the Print Composer canvas and position and customize the appearance in the Item Properties tab (see
figure_composer_html_1).

Abbildung 19.34: HTML frame, the item properties Tab

670

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

HTML Source
As an HTML source, you can either set a URL and activate the URL radiobutton or enter the HTML source
directly in the textbox provided and activate the Source radiobutton.
The HTML Source dialog of the HTML frame Item Properties tab provides the following functionalities (see
figure_composer_html_2):

Abbildung 19.35: HTML frame, the HTML Source properties


In URL you can enter the URL of a webpage you copied from your internet browser or select an HTML file
using the browse button
. There is also the option to use the Data defined override button, to provide
an URL from the contents of an attribute field of a table or using a regular expression.
In Source you can enter text in the textbox with some HTML tags or provide a full HTML page.
The [insert an expression] button can be used to insert an expression like [%Year($now)%] in the
Source textbox to display the current year. This button is only activated when radiobutton Source is selected.
After inserting the expression click somewhere in the textbox before refreshing the HTML frame, otherwise
you will lose the expression.
Activate
Evaluate QGIS expressions in HTML code to see the result of the expression you have included,
otherwise you will see the expression instead.
Use the [Refresh HTML] button to refresh the HTML frame(s) to see the result of changes.
Frames
The Frames dialog of the HTML frame Item Properties tab provides the following functionalities (see figure_composer_html_3):

Abbildung 19.36: HTML frame, the Frames properties


With Resize mode you can select how to render the HTML contents:
Use existing frames displays the result in the first frame and added frames only.

19.3. Zusammenstellungselemente

671

QGIS User Guide, Release 2.6

Extent to next page will create as many frames (and corresponding pages) as necessary to render the
height of the web page. Each frame can be moved around on the layout. If you resize a frame, the
webpage will be divided up between the other frames. The last frame will be trimmed to fit the web
page.
Repeat on every page will repeat the upper left of the web page on every page in frames of the same
size.
Repeat until finished will also create as many frames as the Extend to next page option, except all
frames will have the same size.
Use the [Add Frame] button to add another frame with the same size as selected frame. If the HTML page
that will not fit in the first frame it will continue in the next frame when you use Resize mode or Use existing
frames.
Dont export page if frame is empty prevents the map layout from being exported when the
Activate
frame has no HTML contents. This means all other composer items, maps, scalebars, legends etc. will not
be visible in the result.
Activate
is empty.

Dont draw background if frame is empty prevents the HTML frame being drawn if the frame

Use smart page breaks and User style sheet


The Use smart page breaks dialog and Use style sheet dialog of the HTML frame Item Properties tab provides the
following functionalities (see figure_composer_html_4):

Abbildung 19.37: HTML frame, Use smart page breaks and User stylesheet properties

Activate
Use smart page breaks to prevent the html frame contents from breaking mid-way a line of text
so it continues nice and smooth in the next frame.
Set the Maximum distance allowed when calculating where to place page breaks in the html. This distance is
the maximum amount of empty space allowed at the bottom of a frame after calculating the optimum break
location. Setting a larger value will result in better choice of page break location, but more wasted space at
the bottom of frames. This is only used when Use smart page breaks is activated.
Activate
User stylesheet to apply HTML styles that often is provided in cascading style sheets. An
example of style code is provide below to set the color of <h1> header tag to green and set the font and
fontsize of text included in paragraph tags <p>.
h1 {color: #00ff00;
}
p {font-family: "Times New Roman", Times, serif;
font-size: 20px;
}

Use the [Update HTML] button to see the result of the stylesheet settings.

672

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

19.4 Elemente verwalten


19.4.1 Gre und Position
Jedes Element in der Zusammenstellung kann verschoben/in der Gre verndert werden um ein perfektes Layout
Eintrag whlen/verschieben
Werkzeug zu aktivieren und
zu erstellen. Bei beiden Operationen ist der erste Schritt das
auf das Element zu klicken; Sie knnen es dann verschieben, indem Sie die linke Maustaste gedrckt halten. Wenn
Sie die Bewegungen auf die horizontale oder vertikale Achse einschrnken wollen, halten Sie einfach Umschalt
whrend Sie die Maus bewegen. Wenn Sie eine hhere Genauigkeit brauchen knnen Sie das ausgewhlte Element
mit den Pfeiltasten auf der Tastatur verschieben; wenn die Bewegung zu langsam ist knnen Sie dies mit
Halten von Umschalt verbessern.

A selected item will show squares on its boundaries; moving one of them with the mouse, will resize the item
in the corresponding direction. While resizing, holding Shift will maintain the aspect ratio. Holding Alt will
resize from the item center.
The correct position for an item can be obtained using snapping to grid or smart guides. Guides are set by clicking
and dragging in the rulers. Guide are moved by clicking in the ruler, level with the guide and dragging to a new
place. To delete a guide move it off the canvas. If you need to disable the snap on the fly just hold Ctrl while
moving the mouse.
Eintrag whlen/verschieben
Knopf whlen. Halten Sie einfach den
Sie knnen mehrere Element auf einmal mit dem
Umschalt Knopf und klicken Sie auf alle Elemente, die Sie brauchen. Sie knnen bei dieser Gruppe dann die
Gre verndern oder Sie wie ein einziges Element verschieben.

Once you have found the correct position for an item, you can lock it by using the items on the toolbar or ticking
the box next to the item in the Items tab. Locked items are not selectable on the canvas.
Locked items can be unlocked by selecting the item in the Items tab and unchecking the tickbox or you can use
the icons on the toolbar.
Um ein Element zu deselektieren klicken Sie einfach darauf whrend Sie die Umschalt Taste halten.
Innerhalb des Bearbeiten Mens knnen Sie Aktionen um alle Elemente auszuwhlen, um eine Auswahl
aufzuheben und um die aktuelle Auswahl zu invertieren finden.

19.4.2 Ausrichtung
Raise selected items
Raising or lowering functionalities for elements are inside the
pull-down menu. Choose an
element on the Print Composer canvas and select the matching functionality to raise or lower the selected element
compared to the other elements (see table_composer_1). This order is shown in the Items tab. You can also raise
or lower objects in the Items tab by clicking and dragging an objects label in this list.
Alle gewhlten Elemente linksbndig ausrichten
Es gibt mehrere Ausrichtungsfunktionalitten im
Pulldownmen (siehe
table_composer_1). Um eine Ausrichtungsfunktionalitt zu verwenden suchen Sie zuerst einige Elemente aus
und klicken Sie dann auf das zutreffende Ausrichtungsicon. Alle ausgewhlten Elemente werden dann an Ihrem
gemeinsamen Begrenzungsrahmen ausgerichtet.

19.4.3 Elemente Kopieren/Ausschneiden und Einfgen


Die Druckzusammenstellung enthlt Aktionen um die gemeinsame Kopieren/Ausschneiden/Einfgen Funktionalitt fr die Elemente im Layout zu verwenden. Wie gewhnlich mssen Sie erst die Elemente anhand einer
der oben zu sehenden Optionen auswhlen; an dieser Stelle knnen die Aktionen im Bearbeiten Men gefunden werden. Wenn Sie die Einfgen Aktion verwenden werden die Elemente gem der aktuellen Mausposition
eingefgt.
Bemerkung: HTML items can not be copied in this way. As a workaround, use the [Add Frame] button in the

19.4. Elemente verwalten

673

QGIS User Guide, Release 2.6

Abbildung 19.38: Ausrichtungshilfslinien in der Druckzusammenstellung

674

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

Item Properties tab.

19.5 Schritte rckgngig machen und wiederherstellen


Whrend des Layoutens ist es mglich nderungen zurckzunehmen und wiederherzustellen. Dies kann mit den
Zurcknehmen und Wiederherstellen Werkzeugen getan werden:

Letzte nderung zurcknehmen

Letzte nderung wiederherstellen

This can also be done by mouse click within the Command history tab (see figure_composer_29).

Abbildung 19.39: Befehlsprotokoll in der Druckzusammenstellung

19.6 Atlas-Erzeugung
Die Druckzusammenstellung enthlt Erstellungsfunktionen, die es Ihnen mglich machen ein Kartenbuch auf automatisierte Weise zu erstellen. Das Konzept ist es einen Abdeckungslayer zu verwenden, der Geometrien und
Felder enthlt. Fr jede Geometrie im Abdeckungslayer wird eine neue Ausgabe erstellt in der der Inhalt einer
Karte verschoben wird um die aktuelle Geometrie hervorzuheben. Felder die mit diesen Geometrien in Zusammenhang stehen knnen innerhalb von Beschriftungen verwendet werden.
Every page will be generated with each feature. To enable the generation of an atlas and access generation parameters, refer to the Atlas generation tab. This tab contains the following widgets (see Figure_composer_atlas):

Abbildung 19.40: Atlas-Erzeugung Reiter

19.5. Schritte rckgngig machen und wiederherstellen

675

QGIS User Guide, Release 2.6

Einen Atlas erzeugen, was die Atlaserstellung aktiviert oder deaktiviert.

Ein Abdeckungslayer
Kombobox mit der Sie einen (Vektor)Layer, der die Geometrien, ber denen
eine Iteration durchgefhrt werden soll, enthlt.
Ein optionaler
Abdeckungslayer verstecken das, wenn es aktiviert ist, den Abdeckungslayer (aber nicht
die anderen) whrend der Erstellung versteckt.
Ein optionales Filtern nach Textfeld das es Ihnen mglich macht einen Ausdruck zum Filtern von Objekten
aus dem Abdeckungslayer anzugeben. Wenn der Ausdruck nicht leer ist werden nur Objekte auf die True
zutrifft ausgewhlt. Mit dem Knopf auf der rechten Seite knnen Sie den Ausdrucksbasierten Filter aufrufen.
Ein Ausgabedateiausdruck Textfeld, das dazu benutzt wird einen Dateinamen fr jede Geometrie, falls
bentigt, zu erzeugen. Es beruht auf Ausdrcken. Dieses Feld ist nur von Bedeutung wenn mehrere Dateien
gerendert werden sollen.
Einzeldatei wenn mglich ermglicht die Erstellung einer einzelnen Datei wenn dies mglich ist mit
Ein
dem ausgewhlten Ausgabeformat (PDF beispielsweise). Wenn dieses Feld aktiviert ist, wird der Wert des
Ausgabedateiausdruck nicht bercksichtigt.
Sortieren nach ermglicht es Ihnen, falls aktiviert, Objekte des Abdeckungslayers
Ein optionales
zu sortieren. Die entsprechende Kombobox ermglicht es Ihnen auszuwhlen welche Spalte als Sortierschlssel verwendet wird. Die Sortierreihenfolge (entweder aufsteigend oder absteigend) wird durch einen
Zweizustandsknopf, der einen nach oben Pfeil oder nach unten Pfeil darstellt, festgelegt.
Sie knnen mehrere Kartenelemente mit der Atlaserzeugung verwenden; jede Karte wird gem den Abdeckungsobjekten dargestellt. Um die Atlaserstellung fr ein bestimmtes Kartenelement einzustellen mssen Sie
Gesteuert durch Atlas in den Elementeigenschaften des Kartenelements aktivieren. Nach dem Aktivieren knnen Sie einstellen:
Ein Eingabefenster Rand um Objekte das es Ihnen ermglicht die Gre des Abstandes, der um jede Geometrie innerhalb der zugeordneten Karte hinzugefgt wird, auszuwhlen. Sein Wert ist nur von Bedeutung
wenn der auto-skalierungs Modus verwendet wird.
Fester Mastab, der es Ihnen ermglicht zwischen Auto-Skalierung und festem Mastab umzuschal Ein
ten. Beim festen Mastab wird die Karte nur fr jede zu zentrierende Geometrie bersetzt. Bei der AutoSkalierung werden die Kartenausschnitte so berechnet, dass jede Geometrie im Ganzen erscheint.

19.6.1 Beschriftungen
In order to adapt labels to the feature the atlas plugin iterates over, you can include expressions. For example, for
a city layer with fields CITY_NAME and ZIPCODE, you could insert this:
The area of [% upper(CITY_NAME) || , || ZIPCODE || is format_number($area/1000000,2) %] km2

The information [% upper(CITY_NAME) || , || ZIPCODE || is format_number($area/1000000,2) %] is an


expression used inside the label. That would result in the generated atlas as:
The area of PARIS,75001 is 1.94 km2

19.6.2 Data Defined Override Buttons


Data Defined Override
There are several places where you can use a
button to override the selected setting. These
options are particularly usefull with Atlas Generation.

For the following examples the Regions layer of the QGIS sample dataset is used and selected for Atlas Generation.
We also assume the paper format A4 (210X297) is selected in the Composite tab for field Presets.

676

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

With a Data Defined Override button you can dynamically set the paper orientation. When the height (north-south)
of the extents of a region is greater than its width (east-west), you rather want to use portrait instead of landscape
orientation to optimize the use of paper.
In the Composition you can set the field Orientation and select Landscape or Portrait. We want to set the orientabutton of field Orientation,
tion dynamically using an expression depending on the region geometry. press the
select Edit ... so the Expression string builder dialog opens. Give following expression:

CASE WHEN bounds_width($atlasgeometry) > bounds_height($atlasgeometry) THEN Landscape ELSE Port

Now the paper orients itself automatically for each Region you need to reposition the location of the composer
item as well. For the map item you can use the
expression:

button of field Width to set it dynamically using following

(CASE WHEN bounds_width($atlasgeometry) > bounds_height($atlasgeometry) THEN 297 ELSE 210 END) - 2

Use the

button of field Heigth to provide following expression:

(CASE WHEN bounds_width($atlasgeometry) > bounds_height($atlasgeometry) THEN 210 ELSE 297 END) - 2

When you want to give a title above map in the center of the page, insert a label item above the map. First use the
item properties of the label item to set the horizontal alignment to
Center. Next activate from Reference point
the upper middle checkbox. You can provide following expression for field X :

(CASE WHEN bounds_width($atlasgeometry) > bounds_height($atlasgeometry) THEN 297 ELSE 210 END) / 2

For all other composer items you can set the position in a similar way so they are correctly positioned when page
is automatically rotated in portrait or landscape.
Information provided is derived from the excellent blog (in english and portugese) on the Data Defined Override
options Multiple_format_map_series_using_QGIS_2.6 .
This is just one example of how you can use Data Defined Overrides.

19.6.3 Vorschau
Wenn Sie die Atlaseinstellungen konfiguriert haben und die Kartenelemente ausgewhlt, knnen Sie eine Vorschau
von allen Seiten machen indem Sie auf Atlas Atlasvorschau anzeigen klicken und die Pfeile im gleichen Men
zum Navigieren durch alle Objekte verwenden.

19.6.4 Erstellung
Die Atlaserstellung kann auf verschiedene Arten durchgefhrt werden. Zum Beispiel knnen sie ihn mit Atlas
Atlas drucken ... direkt drucken. Sie knnen auch ein PDF erstellen indem Sie Atlas Atlas als PDF exportieren
verwenden: Der Benutzer wird nach einem Verzeichnis gefragt, in das alle erstellten PDF-Dateien gespeichert
werden sollen (auer Sie haben
Einzeldatei, wenn mglich ausgewhlt). Wenn Sie nur eine Seite des Atlas
drucken mssen, starten Sie einfach die Vorschaufunktion, whlen Sie die Seite, die Sie brauchen, aus und klicken
Sie Zusammenstellung Drucken... (oder PDF erstellen).

19.7 Eine Ausgabe erzeugen


Figure_composer_output shows the Print Composer with an example print layout, including each type of map
item described in the sections above.
Die Druckzusammenstellung ermglicht es Ihnen mehere Ausgabeformate zu erstellen, und es ist mglich die
Auflsung (Druckqualitt) und Seitengre zu definieren:

19.7. Eine Ausgabe erzeugen

677

QGIS User Guide, Release 2.6

Abbildung 19.41: Druckzusammenstellung mit Kartenansicht, Legende, Bild, Mastab, Koordinaten, Text und
hinzugefgtem HTML-Rahmen

Drucken
Das
Icon ermglicht es Ihnen das Layout in einen angeschlossenen Drucker oder in eine
PostScipt Datei zu drucken, je nach installierten Druckertreibern.
Speichern als Rasterbild
Das
Icon exportiert die Zusammenstellungsansicht in diverse Bildformate wie PNG,
BPM, TIF, JPG, ...

Als PDF exportieren

Das
ic).

speichert die definierte Druckzusammenstellungsansicht direkt als PDF.

Speichern als SVG

Icon speichet die Druckzusammenstellungsansicht als SVG (Scalable Vector Graph-

If you need to export your layout as a georeferenced image (i.e., to load back inside QGIS), you need to enable
this feature under the Composition tab. Check
World file on and choose the map item to use. With this option,
the Export as image action will also create a world file.
Bemerkung:
Currently, the SVG output is very basic. This is not a QGIS problem, but a problem with the underlying Qt
library. This will hopefully be sorted out in future versions.
Exporting big rasters can sometimes fail, even if there seems to be enough memory. This is also a problem
with the underlying Qt management of rasters.

678

Kapitel 19. Druckzusammenstellung

QGIS User Guide, Release 2.6

19.8 Die Druckzusammenstellung verwalten


Save as template
Add items from template
and
icons, you can save the current state of a Print Composer
With the
session as a .qpt template and load the template again in another session.
Druckzusammenstellung verwalten
Der
Knopf in der QGIS Werkzeugleiste und unter Zusammenstellung Druckzusammenstellung verwalten ermglicht es Ihnen eine neune Zusammenstellungsvorlage hinzuzufgen, eine neue
Zusammenstellung auf Basis einer vorher abgespeicherten Vorlage zu erstellen oder schon bestehende Vorlagen
zu verwalten.

Abbildung 19.42: Die Druckzusammenstellung verwalten


Standardmig sucht der Zusammenstellungsmanager nach Vorlagen in ~/.qgis2/composer_template.
Neue Druckzusammenstellung
Zusammenstellunsduplizierung
Die
und
Knpfe in der Werkzeugleiste und in Zusammenstellung Neue Zusammenstellung sowie in Zusammenstellung Zusammenstellung kopieren ermglicht es
Ihnen einen neuen Zusammenstellungsdialog zu ffnen oder eine bestehende Zusammenstellung von einer vorher
erstellten zu duplizieren.
Projekt speichern
Schlielich knnen Sie Ihre Druckzusammenstellung mit dem
Knopf speichern. Dies ist die
gleiche Funktion wie im QGIS Hauptfenster. Alle nderungen werden in einer QGIS Projektdatei gespeichert.

19.8. Die Druckzusammenstellung verwalten

679

QGIS User Guide, Release 2.6

680

Kapitel 19. Druckzusammenstellung

KAPITEL 20

Erweiterungen

20.1 QGIS Erweiterungen


QGIS wurde mit einer Plugin-Architektur geplant. Dies erlaubt das einfache Einfgen weiterer Funktionalitten
in das Programm. Viele der Funktionalitten in QGIS sind als Plugins implementiert.
Sie knnen Ihre Erweiterungen im Erweiterungen Dialog, der mit Erweiterungen > Erweiterungen verwalten und
installieren ... geffnet werden kann, verwalten.
Wenn eine Erweiterung geupdatet werden muss und die Erweiterungseinstellungen dementsprechend vorgenommen wurden kann das QGIS Hauptfenster einen blauen Link in der Statusleiste anzeigen um Ihnen mitzuteilen,
dass Erweiterungsupdates angewendet werden knnen.

20.1.1 Der Erweiterungen Dialog


Die Mens im Erweiterungen Dialog ermglichen es dem Anwender Erweiterungen auf verschiedene Arten zu
installieren und zu aktualisieren. Fr jede Erweiterung werden Metadaten im rechten Bedienfeld angezeigt:
Informationen falls die Erweiterung experimentell ist
Beschreibung
Bewertungen (Sie knnen eine Bewertung fr Ihre bevorzugte Erweiterung abgeben!)
Elemente
einige ntzliche Links wie die Homepage, die Fehlerverfolgung und das Quellcode-Repositum
Autoren
verfgbare Version
Sie knnen den Filter benutzen um eine bestimmte Erweiterung zu finden.
Alle
Hier sind alle zur Verfgung stehenden Plugins aufgelistet, darunter sowohl Kern- als auch externe Plugins. Verwenden Sie [Alle aktualisieren] um nach neuen Versionen fr die Plugins zu schauen. Des weiteren knnen Sie
[Erweiterung installieren] verwenden wenn ein Plugin aufgelistet aber nicht installiert ist und [Gewhlte Erweiterung deinstallieren] genauso wie [Erweiterung erneut installieren] wenn ein Plugin installiert ist. Wenn
ein Plugin installiert ist kann es anhand des Kontrollkstchens de/aktiviert werden.
Installiert

681

QGIS User Guide, Release 2.6

Abbildung 20.1: Das

Alle Men

In diesem Men knnen Sie nur die installierten Plugins finden. Die externen Plugins knnen deinstalliert und
erneut installiert werden mit den [Gewhlte Erweiterung deinstallieren] und [Erweiterung erneut installieren].
Sie knnen hier auch [Alle aktualisieren].
Nicht installiert
Dieses Men listet alle zur Verfgung stehenden Plugins, die nicht installiert sind, auf. Sie knnen den [Erweiterung installieren] Knopf um eine Erweiterung in QGIS zu implementieren.
Erweiterbar
Wenn Sie
Auch experimentelle Erweiterungen anzeigen im
Einstellungen Men aktivieren knnen Sie
dieses Men zum Suchen nach weiteren aktuellen Pluginversionen verwenden. Dies kann mit den [Erweiterung
erneut installieren] oder [Alle aktualisieren] Knpfen getan werden.
Einstellungen
In diesem Men knnen Sie die folgenden Optionen verwenden:

Beim Start nach Aktualisierungen suchen. Wann immer ein neues Plugin oder ein Pluginupdate zur
Verfgung steht wird QGIS Sie bei jedem QGIS-Start, einmal am Tag, alle drei Tage, jede Woche,
alle zwei Wochen oder jeden Monat informieren.

Auch experimentelle Erweiterungen zeigen. QGIS wird Ihnen Plugins in frhen Entwicklungsphasen
zeigen, die im Allgemeinen fr den Produktiveinsatz ungeeignet sind.

Auch veraltete Erweiterungen anzeigen. Diese Erweiterungen sind veraltet und im Allgemeinen fr den
Produktiveinsatz ungeeignet.

Um ein externes Anwender-Repository hinzuzufgen, klicken Sie [Hinzufgen...] im Erweiterungsrepositorien


Abschnitt. Wenn Sie eins oder mehrere hinzugefgte Repositories nicht haben wollen knnen diese ber den
[Bearbeiten...] Knopf deaktiviert werden oder vollstndig gelscht mit dem [Lschen] Knopf werden.
Die Suchen Funktion steht in fast jedem Men zur Verfgung (mit Ausnahme von
Sie nach bestimmten Erweiterungen suchen.

682

Einstellungen). Hier knnen

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Abbildung 20.2: Das

Abbildung 20.3: Das

20.1. QGIS Erweiterungen

Installiert Men

Nicht installiert Men

683

QGIS User Guide, Release 2.6

684

Abbildung 20.4: Das

Erweiterbar Men

Abbildung 20.5: Das

Einstellungen Men

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Tipp: Kernerweiterungen und externe Erweiterungen


QGIS Plugins sind entweder als Kern-Plugins oder Externe Plugins implementiert. Kern-Plugins werden durch
das QGIS Development Team gewartet und sind automatisch Teil jeder QGIS Distribution. Sie sind entweder in
C++ oder in Python geschrieben. Externe Plugins sind derzeit alle in Python geschrieben. Sie sind in externen
Repositories gespeichert und werden von den individuellen Autoren gewartet.
Eine ausfhrliche Dokumentation ber die Verwendung, notwendige QGIS Version, Homepage, Autoren, und
weitere Informationen werden fr das Official QGIS Repository unter der URL http://plugins.qgis.org/plugins/
bereitgestellt. Fr andere externe Repositories knnen Dokumentationen mit dem externen Plugin selber zur Verfgung stehen. Sie sind in diesem Handbuch im Alllgemeinen nicht enthalten.
.

20.1. QGIS Erweiterungen

685

QGIS User Guide, Release 2.6

20.2 QGIS Kernplugins verwenden


Icon

Plugin

Beschreibung

Handbuch Referenz

Koordinaten
aufnehmen

Koordinaten in anderem KBS verfolgen

Koordinaten aufnehmen
Plugin

DB Manager

Datenbanken in QGIS verwalten

DB Manager Plugin

DXF2Shape
Konverter

Wandelt vom DXF- ins Shapeformat um

Dxf2Shape Konverter
Plugin

eVis

Ein Ereignisvisualisierungswerkzeug

eVis Plugin

fTools

Werkzeuge fr Vektoranalyse und Management

fTools Plugin

GPS Werkzeuge

Werkzeuge zum Laden und Importieren von


GPS-Daten

GPS Plugin

GRASS

Einbinden von GRASS Daten und Modulen

GRASS GIS Integration

GDALTools

Integration der GDAL Tools in QGIS

GDALTools Plugin

GDAL
Georeferenzierung

Rasterdateien mit GDAL georeferenzieren

Georeferenzier Plugin

Heatmap

Erzeugt ein Heatmap-Raster fr einen


Eingabepunktlayer.

Heatmap-Erweiterung

Interpolationserweiterung

Sttzpunktinterpolation von Vektorlayern

Interpolationsplugin

Offline Editing

Offline-Bearbeitung und Datensynchronisation

Offline-Bearbeitung
Plugin

Oracle-SpatialGeoraster

Auf OracleSpatial-GeoRaster zugreifen

Oracle-Spatial-GeoRaster
Plugin

Erweiterungsmanager

Kernerweiterungen und externe Erweiterungen


verwalten

Der Erweiterungen
Dialog

Rastergelndeanalyse

Berechnung geomorphologischer Parameter auf


Basis eines DGM

RastergelndeanalyseErweiterung

Road Graph
Erweiterung

Lsen des Krzeste Wege Problems

Straengraph Plugin

SQL-Anywhere

Speichert Vektorlayer in einer SQL-Anywhere


Datenbank

SQL-Anywhere Plugin

Rumliche Abfrage

Rumliche Abfrage von Vektorlayern

Rumliche Abfrage Plugin

SPIT

Shapes in PostgreSQL/PosftGIS importieren


Werkzeug

SPIT Plugin

Rumliche Statistik

Berechnung von Rasterstatik fr Vektorflchen

Zonenstatistikerweiterung

MetaSearch

Mit Metadata Catalogue Services (CSW)


interagieren

MetaSearch Katalog
Client

20.3 Koordinaten aufnehmen Plugin


Das Plugin Koordinaten aufnehmen ist einfach zu bedienen und erlaubt es, Koordinaten fr zwei ausgewhlte
Koordinatenbezugssysteme (KBS) im Kartenfenster abzufragen.
686

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Abbildung 20.6: Koordinaten aufnehmen Erweiterung


1. Starten Sie QGIS, whlen Sie Projekteigenschaften aus dem Einstellungen Men (KDE, Windows) oder
aus dem Datei (Gnome, OSX) Men und klicken Sie auf den KBS Reiter. Als Alternative knnen Sie auch
auf das

KBS-Status

Icon in der rechten unteren Ecke des Statusleiste klicken.

2. Aktivieren Sie die Checkbox


On-the-Fly-KBS-Transformation aktivieren und whlen Sie ein KBS Ihrer
Wahl (siehe auch Arbeiten mit Projektionen).
3. Aktiveren Sie die Koordinaten aufnehmen Erweiterung im Erweiterungsmanager (siehe Der Erweiterungen
Dialog) und stellen Sie sicher, dass der Dialog sichtbar ist indem Sie zu Einstellungen Bedienfelder
Koordinaten aufnehmen aktiviert ist. Der Koordinaten aufnehmen
gehen und sich vergewissern dass
Dialog erscheint wie in Abbildung figure_coordinate_capture_1. Alternativ dazu knnen Sie auch in das
Men Vektor Koordinaten aufnehmen gehen und gucken ob

Koordinaten aufnehmen aktiviert ist.

Klicken Sie, um das KBS zur Koordinatenanzeige auszuwhlen


4. Klicken Sie nun auf das Icon
und whlen Sie ein anderes
Koordinatenbezugsystem (KBS) als eben.

5. Klicken Sie nun auf [Aufnahme starten] und dann auf einen Punkt im Kartenfenster. Das Plugin zeigt
ihnen die Koordinaten fr diesen Punkt in beiden zuvor gewhlten KBS an.
6. Um die Mausverfolgungs-Funktion zu starten, klicken Sie auf das Icon

Mausverfolgung

7. Sie knnen die ausgewhlten Koordinaten auch in die Zwischenablage kopieren.


.

20.4 DB Manager Plugin


Die DB Manager Erweiterung ist offiziell Teil des QGIS Kerns und soll das SPIT Plugin ersetzen und zustzlich
alle anderen Datenbankformate, die von QGIS untersttzt werden in einer Benutzeroberflche integrieren. Die
DB Manager

Erweiterung bietet mehrere Funktionen. Sie knnen Layer aus dem QGIS Browser in den DB
Manager ziehen und diese werden dann in Ihre rumliche Datenbank importiert. Sie knnen ein Drag-And-Drop
mit Tabellen zwischen rumlichen Datenbanken machen und diese werden dann importiert. Sie knnen den DB
Manager zum Ausfhren von SQL Abfragen an Ihre rumliche Datenbank verwenden und dann die rumliche
Ausgabe fr Abfragen anschauen indem Sie QGIS die Ergebnisse als Abfragelayer hinzufgen.
Das Datenbank Men ermglicht es Ihnen sicht mit einer bestehenden Datenbank zu verbinden, das SQL Fenster zu starten und die DB Manager Erweiterung zu verlassen. Nachdem Sie mit einer bestehenden Datenbank
verbunden sind, erscheinen zustzlich die Mens Schema und Tabelle.
Das Schema Men enthlt Werkzeuge zum Erstellen und lschen von (leeren) Schemata und, falls es eine Topologie gibt (z.B. PostGIS 2), eins zum Starten von TopoViewer.
Das Tabelle Men ermglicht es Ihnen Tabellen zu erstellen und zu bearbeiten und Tabellen und Views zu lschen.
Als weitere Funktionalitt knnen Sie ein VACUUM und dann ein ANALYZE fr jede ausgewhlte Tabelle durchfhren. Ein einfaches VACUUM fordet einfach Platz und stellt ihn fr das erneute Anwenden zu Verfgung. ANALYZE updatet Statistiken um den effizientesten Weg eine Abfrage durchzufhren zu bestimmen. Schlielich
knnen Sie Layer/Dateien importieren, wenn diese in QGIS geladen sind oder im Dateisystem existieren. Und Sie
knnen Datenbanktabellen nach Shape mit der Export File Funktion exportieren.
20.4. DB Manager Plugin

687

QGIS User Guide, Release 2.6

Abbildung 20.7: DB Manager Dialog


Das Tree Fenster listet alle existierenden Datenbanken auf, die in QGIS integriert wurden. Mit einem Doppelklick
knnen Sie sich mit der jeweiligen Datenbank verbinden. Mit der rechten Maustaste knnen Sie eine existierende
Tabelle oder Schema umbenennen oder lschen oder eine neue Tabellen hinzugefgen. Tabellen knnen auch mit
dem Kontextmen zum QGIS Kartenfenster hinzugefgt werden.
Wenn Sie mit einer Datenbank verbunden sind, bietet das Hauptfenster des DB Managers drei Reiter. Der Info
Reiter zeigt Information zur Tabelle und Geometrie, zu existierenden Spalten, Constraints und Indices. Ausserdem kann man die Vacuum Analyze Funktion starten und einen rumlichen Index fr eine ausgewhlte Tabelle
erzeugen. Der Tabelle Reiter zeigt die Attribute und der Reiter Vorschau zeigt eine Vorschau der Tabelle.
.

20.5 Dxf2Shape Konverter Plugin


Die Dxf2shape-Konverter Erweiterung kann dazu benutzt werden im Vektordaten vom DXF zum Shapedateiformat zu konvertieren. Es erfordert die folgenden Parameter, die vor dem Laufen angegeben werden mssen:

Abbildung 20.8: Dxf2Shape-Konverter Erweiterung

688

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Eingabe-DXF-Datei: Geben Sie den Pfad zur zu konvertierenden DXF-Datei ein.


Ausgabedatei: Geben Sie den gewnschten Namen der Shapedatei, die erstellt werden soll, ein.
ausgabedateityp: Geben Sie den Geometrietyp der Ausgabedatei an. Derzeit untersttzte Typen sind
Polylinie, Polygon und Punkt.
Beschriftungen exportieren: Wenn Sie dieses Kontrollkstchen aktivieren, wird ein zustzlicher Shapefile
Punktlayer erstellt, und die damit verknpfte DBF-Datei enthlt die Beschriftungen und Informationen dazu,
die sich im TEXT-Feld der Datei befinden.

20.5.1 Das Plugin anwenden


1. Starten Sie QGIS, laden Sie das Dxf2Shape Plugin mit dem Plugin Manager (siehe Kapitel
Dxf2Shape Converter
in der Werkzeugleiste. Der DXF-Import
load_core_plugin) und klicken Sie auf das Icon
Dialog erscheint wie in Abbildung Figure_dxf2shape_1.

2. Geben Sie die Eingabe-DXF-Datei ein, einen Namen fr die Ausgabedatei und den Ausgabedateityp.
3. Aktivieren Sie das Kontrollkstchen
Beschriftungen exportieren, wenn Sie einen zustzlichen Shapefile
Punktlayer mit den Beschriftungen erstellen wollen.
4. Klicken Sie [OK].
.

20.6 eVis Plugin


(Dieses Kapitel ist von Horning, N., K. Koy, P. Ersts. 2009. eVis (v1.1.0) Users Guide abgeleitet. American Museum of Natural History, Center for Biodiversity and Conservation. Erhltlich unter
http://biodiversityinformatics.amnh.org/, and released under the GNU FDL.)
Der Biodiversitts-Informatik Fachbereich am American Museum of Natural Historys (AMNH) Center for Biodiversity and Conservation (CBC) hat das Event Viualization Tool (eVis) entwickelt, ein weiteres Softwaretool
das der Reihe der Konservationsmonitoring- und Entscheidungstools fr das Managen von Schutzgebieten und
Landschaftsplanung hinzugefgt werden kann. Mit diesem Plugin kann der Benutzer auf einfache Weise georeferenzierte (z.B. mit Lnge und Breite oder mit X und Y Koordinaten) Fotos und andere untersttzende Dokumente
mit Vektordaten in QGIS verlinken.
Das eVis Plugin wird jetzt automatisch in neuen Versionen von QGIS installiert und aktiviert und wie bei allen Plugins kann es mit dem Erweiterungsmanager deaktiviert und aktiviert werden (siehe Abschnitt Der Erweiterungen
Dialog).
Es besteht aus drei Modulen: der eVis-Datenbankverbindung, dem eVis-Ereignis-ID-Werkzeug und dem eVisEreignisbrowser. Diese Werkzeuge arbeiten zusammen, damit das Darstellen von georeferenzierten Fotos und
anderen Dokumenten, die mit Vektorobjekten, Datenbanken oder Tabellen verlinkt sind, funktioniert.

20.6.1 Ereignisbrowser
Der Ereignisbrowser verfgt ber Funktionen, um georeferenzierte Fotos anzuzeigen, die mit Vektorobjekten
verknpft sind, die im Kartenfenster dargestellt sind. Die Punktdaten knnen dabei z.B. ein in QGIS geladener
Vektorlayer oder das Ergebnis einer Datenbankabfrage sein. Das Vektorobjekt muss Attribute mit Informationen
zu dem Ort und dem Namen der darzustellenden Datei mit dem Foto enthalten und gegebenenfalls auch die Himmelsrichtung, in welche die Kamera gerichtet war, als das Bild geschossen wurde. Der Vektorlayer muss bereits
in QGIS geladen sein, bevor Sie den Ereignisbrowser starten knnen.

20.6. eVis Plugin

689

QGIS User Guide, Release 2.6

Den eVis-Ereignisbrowser starten


eVis Event Browser
Icon oder auf Datenbank
Um den Ereignisbrowser zu starten, klicken Sie entweder auf das
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 enthlt eine Reihe
von Einstellungen, die angepasst werden, um das Verhalten des Plugins zu verndern. Schlielich 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 knnen.
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 verknpfte Attribute
anzuzeigen.

Abbildung 20.9: 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 knnen.
3. Herauszoomen: Aus dem Bild herauszoomen, um einen berblick zu haben.
4. Zur vollen Ausdehnung zoomen: Zeigt die volle Ausdehnung des Fotos an.

690

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

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
knnen den Inhalt anschauen oder anhren. Wenn die Datenendung erkannt wird, wird sie automatisch in
grn angezeigt.
6. Navigation: Verwenden Sie den Vorheriges und Nchstes Knopf, um weitere Objekte zu laden, falls
vorhanden und selektiert.
Der Optionen-Reiter

Abbildung 20.10: Das eVis Optionen Fenster


1. Dateipfad: Eine Dropdown-Liste, um das Attributfeld zu definieren, welches den Verzeichnispfad oder die
URL fr die Fotos oder anderen Dokumente enthlt. Wenn es ein relativer Pfad ist, dann whlen Sie das
Kontrollkstchen
Pfad ist relaitiv, links neben dem Dropdown-Men. Der Grundpfad fr 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 enthlt. Wenn Kompassversatzinformationen zur Verfgung stehen, ist es erforderlich
das Kontrollkstchen unter dem Dropdownmentitel zu klicken.
3. Kompassversatz: Kompassverstze knnen dazu benutzt werden Deklinationen zu kompensieren (um Verstze, 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

20.6. eVis Plugin

691

QGIS User Guide, Release 2.6

Aus Attribut Radiobutton um das Attributfeld, das die Verstze enthlt, auszuwhlen. Fr beide dieser Optionen sollten Ostdeklinationen mit positiven Werten und Westdeklinationen mit negativen Werten eingegeben
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 angehngt.
5. Gesamten Pfad ersetzen: Wenn dieses Kontrollkstchen aktiviert ist, wird nur der Dateiname an den
Grundpfad angehngt, der als Attributspalte im Bereich Dateipfad definiert wurde.
6. Bildpfad auf alle Dokumente anwenden: Wenn dieses Kontrollkstchen aktiviert ist, wird derselbe
Grundpfad, der fr Fotos verwendet wird, auch auf alle anderen Dokumente wie Filme, Texte, usw. verwendet. Ansonsten werden die definierten Pfadangaben nur fr die Fotos verwendet. Alle anderen Dokumente
ignorieren den Grundpfad.
7. Dies merken: Wenn dieses Kontrollkstchen aktiviert ist, werden alle damit in Verbindung stehenden Parameter fr die nchste Sitzung gespeichert. Sie knnen dazu auch global den Knopf [Speichern] drcken.
8. Zurcksetzen: Setzt die Werte der jeweiligen Zeile auf die Standardwerte zurck.
9. Voreinstellungen. This setzt alle Felder auf ihre voreingestellten Einstellungen. Es hat den gleichen Effekt
wie das Klicken auf die [Zurcksetzen] Knpfe.
10. Speichern: Dieser Knopf speichert alle Einstellungen, ohne den Dialog zu schlieen.
Der Externe Applikationen konfigurieren Reiter

Abbildung 20.11: Das eVis Externe Anwendungen konfigurieren Fenster


1. Datei Referenztabelle: Eine Tabelle mit den Datentypen, die mit eVis geffnet werden knnen. Jeder Datentyp bentigt eine Dateiendung, und den Pfad zu einer Anwendung, die den entsprechenden Datentyp
anzeigen oder ausfhren kann. Dies schliet neben Fotos u.a. auch Textdokumente, Filme oder Hrspiele
mit ein.
2. Neuen Dateityp hinzufgen: Fge einen neuen Dateityp mit einer einzigartigen Dateiendung hinzu, sowie
einen Pfad zu der Applikation, mit der dieser Datentyp geffnet werden kann.
3. Aktuelle Zeile lschen: Lschen Sie den ausgewhlten Dateityp aus der Referenztabelle.

20.6.2 Den Ort und Namen eines Fotos festlegen


Der Ort und Name eines Fotos kann ber einen absoluten oder relativen Pfad festgelegt werden. Wenn das Foto
auf einem Webserver liegt, kann auch eine URL verwendet werden. Beispiele fr die verschiedenen Varianten
finden Sie in Tabelle evis_examples.

692

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

X
780596
780596
780819

Y
1784017
1784017
1784015

780596

1784017

FILE
C:\Workshop\eVis_Data\groundphotos\DSC_0168.JPG
/groundphotos/DSC_0169.JPG
http://biodiversityinformatics.amnh.org/\
evis_testdata/DSC_0170.JPG
pdf:http://www.testsite.com/attachments.php?\
attachment_id-12

BEARING
275
80
10
76

20.6.3 Den Ort und Namen anderer Dokumente und Dateien festlegen
Belege wie Text-Dokumente, Videos und Sound-Clips knnen ebenfalls angezeigt oder abgespielt werden. Dazu
ist es notwendig, einen Eintrag in der Referenztabelle zu erstellen, ber den die Quelle dann geffnet werden kann. Auerdem ist es notwendig, den Pfad oder eine URL in die Attributtabelle des Vektorlayers fr das
entsprechende Objekt einzutragen. Eine weitere Regel, die fr URLs verwendet werden kann, die keine Dateiendung fr das Dokument enthalten, das Sie ffnen mchten, besteht darin, die Dateierweiterung vor der URL
anzugeben. Das Format ist dann Dateiendung:URL. Vor die URL wird die Dateiendung mit einem Doppelpunkt geschrieben. Dies ist besonders ntzlich fr den Zugriff auf Dokumente in Wikis und anderen Webseiten,
die eine Datenbank verwenden, um die Webseiten zu verwalten (siehe Tabelle evis_examples).

20.6.4 Den eVis-Ereignisbrowser anwenden


Wenn Sie den Ereignisbrowser starten, ffnet sich ein Foto und wird im Display angezeigt, wenn in der Attributtabelle auf das entsprechende Foto verwiesen wird, und wenn der Speicherort der Datei im Reiter Optionen richtig
eingestellt ist. Wenn Sie ein Foto erwarten, es aber nicht angezeigt wird, kontrollieren Sie die Parameter nochmals
im Optionen Fenster.
Wenn auf ein Dokument (oder ein Bild, das nicht ber eine eVis bekannte Dateierweiterung verfgt) in der Attributtabelle verwiesen wird, wird das Feld mit dem Dateipfad grn hervorgehoben dargestellt, wenn die Dateierweiterung sich in der definierten Referenztabelle im Reiter Externe Applikationen konfigurieren befindet. Um das
Dokument zu ffnen, doppelklicken Sie auf die grn markierte Zeile im Attribut Informationsfenster. Wenn auf
ein Objekt in der Attributtabelle verwiesen wird und der Dateipfad nicht grn markiert ist, dann mssen Sie einen
Eintrag fr die Dateierweiterung entsprechend ergnzen. Wenn der Dateipfad grn markiert ist, sich aber nicht
bei einem Doppelklick ffnet, mssen Sie die Parameter im Reiter Optionen einstellen, damit die Datei von eVis
gefunden und dargestellt werden kann.
Wenn keine Kompassrichtung vorhanden ist, wird im Reiter Optionen ein rotes Sternchen angezeigt, sofern das
Vektorobjekt, das mit dem Foto verlinkt ist, angezeigt wird. Wenn eine Kompassrichtung vorhanden ist, erscheint
ein Pfeil und weist in die Richtung, die durch die der Wert in der Anzeige Kompassrichtung definiert ist. Der Pfeil
wird ber dem Vektorpunkt, der mit dem Foto oder einem anderen Dokument verknpft ist, zentriert dargestellt.
Um den Ereignisbrowser zu schlieen, klicken Sie auf den Knopf [Schlieen] im Dialogfenster.

20.6.5 Ereignis-ID-Werkzeug
Das Ereignis-ID-Werkzeug ermglicht es Ihnen, ein Foto oder Dokument anzuzeigen, indem Sie auf ein Objekt
eines aktivierten Vektorlayers im QGIS Kartenfenster klicken. Das Vektorobjekt muss auf Attribute verweisen,
welche Informationen zum Pfad und Namen der Datei und gegebenenfalls der Kompassrichtung whrend der
Aufnahme mit einer Kamera enthalten. Der Vektorlayer muss vor der Ausfhrung des Ereignis-ID-Werkzeugs
in QGIS geladen worden sein.
Starten des Ereignis-ID-Werkzeugs
eVis-Ereignis-ID
Icon oder Datenbank
Um das Ereignis-ID Modul zu ffnen klicken Sie entweder auf das
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.

20.6. eVis Plugin

693

QGIS User Guide, Release 2.6

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 geffnet und die Fotos auf oder in der Nhe des angeklickten Ortes werden
angezeigt. Wenn mehr als ein Foto zur Verfgung steht, knnen Sie durch die verschiedenen Objekte wandeln, indem Sie auf die Schaltflchen [Vorheriges] und [Nchstes] drcken. Die anderen Steuerelemente sind in Kapitel
Ereignisbrowser beschrieben.

20.6.6 Datenbankverbindung
Der Dialog Datenbankverbindung ermglicht es, sich mit einer Datenbank oder anderen ODBC Quelle, z.B.
Excel-Tabellen zu verbinden.
eVis kann sich direkt mit den folgenden Typen von Datenbanken verbinden: PostgreSQL, MySQL und SQLite;
es kann auch ODBC-Verbindungen auslesen (z.B. MS Access). Wenn Sie eine ODBC Datenbank auslesen (wie
eine Excel Tabellenblatt) ist es erforderlich Ihren ODBC-Treiber fr das Betriebssystem, das Sie verwenden, zu
konfigurieren.
Starten des Dialogs Datenbankverbindung
eVis Datenbankverbindung
Um das Datenbankverbindung Modul zu starten klicken Sie auf das entsprechende Icon
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


Drcken 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, knnen 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 Verfgung
wenn Sie MS Access als Datenbanktyp ausgewhlt 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, mssen Sie den Datenquellenname eingeben.
Nachdem Sie alle Parameter angegeben haben, klicken Sie auf den [Verbinden] Knopf. Wenn die Verbindung
erfolgreich ist, wird dies in der Ausgabekonsole angezeigt. Im anderen Fall mssen Sie die Parameter nochmal
berprfen, die Sie eingegeben haben.
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 passwortgeschtzten Datenbank zu verbinden.
8. Passwort: Passwort, wenn die Datenbank passwortgeschtzt ist.
9. Vordefinierte Abfragen: Reiter, um den Dialog Vordefinierte Abfragen zu ffnen.
10. Datenbankverbindung: Reiter, um den Dialog Datenbankverbindung zu ffnen.

694

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Abbildung 20.12: Das eVis Datenbankverbindung Fenster


11. SQL-Abfrage: Reiter, um den Dialog SQL-Abfrage zu ffnen.
12. Hilfe: Zeigt die Online-Hilfe an.
13. OK: Schliet das Fenster Datenbankverbindung.
SQL-Abfrage durchfhren
SQL-Abfragen werden verwendet, um Informationen aus einer Datenbank oder ODBC-Ressource zu extrahieren.
In eVis wird die Abfrage als Vektorlayer zum QGIS Kartenfenster hinzugefgt. Klicken Sie auf den Reiter
SQL-Abfrage, um die SQL-Abfrage-Schnittstelle zu ffnen. Sie knnen 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, knnen Sie eingeben select * from
[Blatt1\$] wobei Blatt1 der Name des Arbeitsblattes ist.
Klicken Sie dann auf die Knopf [Abfrage ausfhren], um den Befehl auszufhren. 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.
1. SQL-Abfrage: Ein Fenster zur Eingabe von SQL-Abfragen.
2. Abfrage ausfhren: Knopf, um die SQL-Abfrage auszufhren.
3. Ausgabekonsole: Hier werden Informationen zu den Prozessen angezeigt.
4. Hilfe: Zeigt die Online-Hilfe an.
5. OK: Schliet das Fenster Datenbankverbindung.

20.6. eVis Plugin

695

QGIS User Guide, Release 2.6

Abbildung 20.13: Der eVis SQL-Abfrage Reiter

und Y Koordinate
, um die Spalten der Datenbank
Verwenden Sie die Dropdown-Mens X Koordinate
zu selektieren, in denen die X (oder Longitude) and Y (oder Latitude) Koordinaten abgelegt sind. Wenn Sie nun
auf den [OK] Knopf drcken, wird ein Vektorlayer entsprechend der SQL-Abfrage erstellt und als neuer Layer in
QGIS angezeigt.
Sie knnen 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...
Tipp: Einen Vektorlayer von einem Microsoft Excel Arbeitsblatt erstellen
Beim Erstellen eines Vektorlayers aus einem Microsoft Excel-Arbeitsblattes entdecken Sie vielleicht, dass unerwnschte Nullwerte (0) gemeinsam mit gltigen Daten in den Tabellenzeilen vorhanden sind. Dies kann verursacht werden, wenn Sie die Felder in Excel mit der Rcktaste Taste gelscht haben. Um dieses Problem zu
beheben, mssen Sie die Excel-Datei ffnen. (Sie mssen dazu QGIS und die Verbindung zur Excel-Tabelle zuerst
beenden.) Dann knnen Sie die Datei in Excel bearbeiten und die leeren Zeilen ber das Bearbeiten Lschen
entfernen und dann wieder abspeichern. Um dieses Problem zu verhindern knnen Sie einfach mehrere Zeilen in
der Exceltabelle lschen indem Sie Bearbeiten Lschen vor dem Speichern der Datei verwenden.

Vordefinierte Abfragen starten


ber den Reiter Vordefinierte Abfragen knnen 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 SQLBefehlen sind. Klicken Sie auf den Reiter Vordefinierte Abfragen, um die vordefinierte Abfrage-Schnittstelle zu
ffnen.
Datei ffnen
Um eine Reihe von vordefinierten Abfragen zu laden, klicken Sie auf das
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

696

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Datei ffnen
dem
Icon. Die ausfhrliche Beschreibung der Abfrage wird im Textfenster unter dem Dopdownmen
dargestellt.

Whlen Sie die Abfrage, die Sie aus dem Dropdownmen ausfhren wollen und klicken Sie dann auf den SQLAbfrage Reiter um zu sehen, dass die Abfrage in das Abfragefenster geladen worden ist. Wenn Sie das erste Mal
eine vordefinierte Abfrage ausfhren oder die Datenbank wechseln mssen Sie sich vergewissern, dass Sie mit der
Datenbank verbunden sind.
Klicken Sie auf den Knopf [Abfrage ausfhren] 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.

Abbildung 20.14: Der eVis Vordefinierte Abfragen Reiter


1. Datei ffnen: ffnet den Datei ffnen Dateibrowser um nach der XML-Datei, die die vordefinierten
Abfragen vorhlt, 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: Schliet das Fenster Datenbankverbindung.
XML-Format fr vordefinierte Abfragen in eVis
Die von eVis gelesenen XML-Tags

20.6. eVis Plugin

697

QGIS User Guide, Release 2.6

Tag
Beschreibung
query
Definiert den Anfang und das Ende einer Abfrage.
shortdeEine kurze Beschreibung der Abfrage, die im eVis Dropdown-Men erscheint.
scription
descripEine detailiertere Beschreibung der Abfrage, die in der eVis Abfragebeschreibung angezeigt
tion
wird.
databaseDer Datenbanktyp, definiert im Datenbanktyp Dropdownmen im Datenbankverbindung Reiter.
type
databaseDer Port, wie er in der Port Textfenster im Datenbankverbindung Reiter definiert ist.
port
databaseDer definierte Datenbankname aus dem Datenbankname Textfeld im Reiter
name
Datenbankverbindung.
databaseuser-Der Datenbank Benutzername wie im Username Textfeld im Datenbankverbindung Reiter
name
definiert.
databasep- Das Datenbank Passwort wie im Passwort Textfeld im Reiter Datenbankverbindung definiert.
assword
sqlstateDie SQL-Abfrage.
ment
autoconEine Option (true oder false), die festlegt, ob automatisch anhand der oben angegeben Tags
nect
mit der Datenbank verbunden werden soll, ohne die Routine aus dem Reiter
Datenbankverbindung zu durchlaufen.
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 />

698

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

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

20.7 fTools Plugin


Das Ziel des fTool Plugins besteht darin, eine Quelle fr alltgliche, vektorbasierte GIS Aufgaben bereitzustellen,
ohne zustzliche Software, Bibliotheken oder komplexe Workarounds notwendig zu machen. Das Plugin bietet
eine wachsende Zahl effektiver Werkzeuge, um rumliche Daten zu verwalten und zu analysieren.
Die fTools sind automatisch in QGIS aktiviert, knnen aber natrlich wie alle Plugins mit dem Plugin Manager
geladen und entladen werden (Abschnitt Der Erweiterungen Dialog). Die Funktionen befinden sich im Men Vektor, in dem Funktionen zu Analyse, Forschung, Geoverarbeitung, Geometrie und Datenmanagement bereitgestellt
werden.

20.7.1 fTools Funktionen


Icon Werkzeug

Zweck

Distanzmatrix

Messen von Distanzen zwischen zwei Punktlayern. Ausgabe ist a) Standard


Distanzmatrix, b) Lineare Distanzmatrix oder c) Zusammenfassende Distanzmatrix.
Die Distanzen knnen auf die jeweils nchsten Ziele rediziert werden.

Linienlngen
summieren

Berechnet die Gesamtsumme der Linienlngen fr jedes Polygon eines Polygonlayers.

Punkte in
Polygonen

Zhlt die Anzahl der Punkte eines Punktlayers, die innerhalb jedes Polygons eines
Polygonlayers auftreten.

Eindeutige
Werte
auflisten

Listet alle eindeutigen Werte in einem Eingabe Vektorlayerfeld auf.

Grundstatistik

Berechnet Statistikwerte fr eine Attributspalte (Mittelwert, Max, Min,


Standardabweichung, Anzahl, Summe, Varianzkoeffizient).

Nchster
Nachbaranalyse

Berechnet Nchste Nachbar Statistik zur Bestimmung des Clustergrades eines


Punktlayers.

Mittlere Koordinate(n)

Berechnet entweder den normalen oder gewichteten Mittelwert eines Vektorlayers oder
mehrerer Objekte mit eindeutiger Schlsselspalte.

Linienschnittpunkte

Findet berschneidungen zwischen Linien und gibt diese als Shapefile aus.
Linienberschneidungen mit einer Lnge > 0 werden ignoriert.

Table Ftools 1: fTools Analysewerkzeuge

20.7. fTools Plugin

699

QGIS User Guide, Release 2.6

20.7.2 Forschungswerkzeuge
Icon Werkzeug

Zweck

Zufllige Auswahl

Whlt zufllig n Objekte oder n Prozent der Objekte aus.

Zufllige Auswahl
in Untermengen

Whlt zufllig n Objekte aus einer Untermenge mit eindeutiger Schlsselspalte.

Zufllige Punkte

Erstellt pseudo-zufllige Punkte im Bereich eines Eingabelayers.

Regelmige
Punkte

Erstellt ein regelmiges Punktegitter fr ein bestimmtes Gebiet und exportiert


diese als Shape.

Vektorraster

Erstellt ein Linien- oder Polygongitter mit definierten Abstnden.

Nach Position
selektieren

Whle Objekte nach relativer Position zu einem anderen Layer fr eine neue
Auswahl, oder addiere oder subtrahiere aus aktueller Auswahl.

Polygon aus
Layergrenzen

Erstelle ein rechteckiges Polygon auf Basis der Ausdehnung eines Raster- oder
Vektorlayers.

Table Ftools 2: fTools Forschungswerkzeuge

20.7.3 Geoverarbeitungswerkzeuge
Icon Werkzeug

Zweck

Konvexe Hlle

Erstelle kleinste konvexe Hlle fr einen Layer oder eine Schlsselspalte.

Puffer

Erstelle einen Puffer um Objekte mit definierter Distanz oder auf Basis einer
Schlsselspalte.

Schnittmengen

Verschneide Layer, so dass die Ausgabe Flchen enthlt, an denen beide Layer
berlagern.

Vereinigungen

Verschneide Layer, so dass die Ausgabe berlagernde und nicht-berlagernde


Flchen enthlt.

Symetrische
Differenz

Verschneide Layer, so dass die Ausgabe Flchen enthlt, an denen beide Layer
nicht berlagern.

Clip

Verschneide Layer, so dass die Ausgabe nur die Flchen enthlt, die mit dem clip
Layer berlagern.

Differenz

Verschneide Layer, so dass die Ausgabe nur die Flchen enthlt, die nicht mit
dem clip Layer berlagern.

Auflsen

Verschmelze Objekte auf Basis einer Schlsselspalte. Objekte mit gleichen


Werten werden zusammengefgt.

Splitterpolygone
beseitigen

Fhrt ausgewhlte Objekte mit dem benachbarten Polygon der grten Flche
oder grten gemeinsamen Grenze zusammen.

Table Ftools 3: fTools Geoverarbeitungswerkzeuge

700

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

20.7.4 Geometriewerkzeuge
Icon Werkzeug

Zweck

Geometriegltigkeit
berprfen

berprft Polygone nach berschneidungen, geschlossenen Lchern und


berprft die Knotenreihenreihenfolge.

Geometriespalte
exportieren/hinzufgen

Geometrieinformationen fr Punkte (XCOORD, YCOORD), Linie (Lnge)


oder Polygon (Flche, Durchmesser) hinzufgen.

Polygonschwerpunkt

Berechne den wahren Schwerpunkt (Zentroid) von Polygonen eines


Vektorlayer.

Delaunay Triangulation

Berechnet und gibt die Delaunay Triangulation fr einen Eingabe


Punktvektorlayer aus (als Polygone).
Berechnen von Voronoi Polygonen auf Basis eines Vektor-Punktlayers.

Voronoipolygone
Geometrie vereinfachen
Geometrien verdichten

Generalisiere Linien oder Polygone mit modifiziertem Douglas-Peucker


Algorithmus.
Linien oder Polgone durch Hinzufgen von Sttzpunkten verdichten.

Mehr- zu einteilig

Konvertiere mehrteilige Objekte zu vielen einteiligen Objekten. Erstellt


einfache Polygone und Linien.

Ein- zu mehrteilig

Verbinde viele Objekte zu einem mehrteiligen Objekt auf Basis einer


Schlsselspalte.

Polygon zu Linie

Konvertiert Polygone zu Linien, mehrteilige Polygone zu vielen einteiligen


Linien.

Linien zu Polygonen

Konvertiert Linien zu Polygonen, viele einteilige Linien zu mehrteiligen


Polygonen.

Knoten extrahieren

Extrahiere Knotenpunkte aus Linien und Polygonen und gebe sie als Punkte
aus.

Table Ftools 4: fTools Geometriewerkzeuge


Bemerkung: Das Geometrie vereinfachen Werkzeug kann auch verwendet werden um doppelte Sttzpunkte in
Linien und Polygonen zu lschen. Setzen Sie dazu einfach die Vereinfachungstoleranz auf den Wert 0.

20.7.5 Datenmanagementwerkzeuge
Icon Werkzeug

Zweck

Aktuelle
Projektion
definieren

Definiere ein KBS fr ein Shapefile, fr das kein KBS definiert ist.

Attribute nach
Position
zusammenfgen

Fge zustzliche Attribute zu einem Layer auf Basis der rumlichen Lage hinzu.
Attribute eines Layers werden an die Attributtabelle eines anderen Layer
angehngt und als Shape exportiert.

Vektorlayer teilen

Teile Vektorlayer in einzelne Layer auf Basis einer Schlsselspalte.

Shapedateien
zusammenfhren
Rumlichen Index
erzeugen

Fge mehrere Shapedateien aus einem Ordner zu einer neuen Shapedatei des
Typs Punkt, Linie oder Polygon zusammen.
Erzeugt einen rumlichen Index fr OGR-Datenformate.

Table Ftools 5: fTools Datenmanagementwerkzeuge


.

20.7. fTools Plugin

701

QGIS User Guide, Release 2.6

20.8 GDALTools Plugin


20.8.1 Was sind die GDALTools?
Die GDALTools stellen eine grafische Benutzeroberflche bereit, ber die die verschiedenen Werkzeuge der
Geospatial Data Abstraction Library, http://gdal.osgeo.org, angesprochen werden knnen. Dabei handelt es sich
um Raster Management Tools, z.B. fr die Abfrage, Umprojizierung, Transformierung oder Verschneidung von
Rasterlayern in unterschiedlichen Formaten. Auerdem stehen Werkzeuge zur Verfgung, um Konturen als (Vektor) linien zu extrahieren, eine Schummerungskarte aus Hhendaten zu erzeugen oder ein VRT (Virtual Raster
Tile in XML format) aus einer oder mehreren Rasterkarten zu erzeugen. Diese Werkzeuge knnen benutzt werden, wenn das Plugin installiert und aktiviert wurde.
Die GDAL Bibliothek
Die GDAL Bibliothek besteht aus einer Reihe von Kommandozeilen-Tools, jedes mit zahlreichen Optionen. Anwender, die sich mit der Kommandozeile auskennen, werden diese Art der Anwendung sicher bevorzugen, um
so den vollen Funktionsumfang nutzen zu knnen. Das GDAL Tools Plugin ermglicht hingegen einen einfachen
Zugang zu den Funktionen, und stellt daher auch nur die am hufigsten benutzten Optionen zur Verfgung.

20.8.2 Liste der GDALTools

Abbildung 20.15: Die GDALTools Menliste

Projektionen

Transformieren
(Reprojizieren)

Das Werkzeug kann mosaikieren, umprojizieren und konvertieren. Es kann in alle


untersttzten Projektion projizieren und kann dabei sogar mit dem Bild bereitgestellte
GCPs nutzen, wenn der Rasterlayer noch im Rohzustand ist. Weitere Informationen
finden sich unter http://www.gdal.org/gdalwarp.html .

Projektion
zuweisen

Das Werkzeug ermglicht es, Rasterlayern, die bereits georeferenziert sind, eine
Projektionsinformation zuzuweisen oder bestehende Projektionsinformationen zu
verndern. Dabei wird Einzeldatei- und Stapelverarbeitung untersttzt. Weitere
Informationen finden sich unter http://www.gdal.org/gdalwarp.html

Projektion
extrahieren

Dieses Werkzeug hilft Ihnen Projektionsinformationen aus einer Eingabedatei zu


extrahieren. Wenn Sie Projektionsinformationen aus einem ganzen Verzeichnis
extrahieren wollen, knnen Sie den Stapelverarbeitungsmodus verwenden. Es erstellt
sowohl .prj als auch .wld Dateien.

702

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Konvertierung
Rastern (Vektor
nach Raster)

Dieses Programm brennt Vektorgeometrien (Punkte, Linien und Polygone) in


Rasterkanl(e) eines Rasterbildes. Die Vektoren werden aus OGR-untersttzten
Vektorformaten gelesen. Beachten Sie, dass Vektordaten das gleiche
Koordinatensystem wie die Rasterdaten haben mssen; Spontan-Reprojektion wird
nicht bereitgestellt. Weitere Informationen knnen Sie unter
http://www.gdal.org/gdal_rasterize.html nachschlagen.

Polygonisieren
(Raster nach Vektor)

Dieses Werkzeug erstellt Vektorpolygone fr alle Flchen eines Rasterlayers, in denen


die Pixelwerte gleich sind. Jedes Polygon erhlt ein Attribut, das den Pixelwert
widergibt. Das Werkzeug erstellt die Ausgabevektor Datenquelle wenn diese nicht
bereits besteht, standardmig als ESRI Shapedateiformat. Weitere Informationen
finden sich unter http://www.gdal.org/gdal_polygonize.html.

bersetzen
(Format
konvertieren)

Das Werkzeug kann Rasterlayer zwischen verschiedenen Formaten konvertieren.


Dabei knnen zustzlich Prozesse wie Ausschnitte bilden, Resampling oder auch
Reskalierung angewendet werden. Weitere Informationen finden sich unter
http://www.gdal.org/gdal_translate.html

RGB nach PCT

Dieses Werkzeug errechnet eine optimale Pseudo-Farbtabelle fr einen


RGB-Rasterlayer mittels eines median cut Algorithmus, der auf einem
downgesampleten RGB-Histogramm basiert. Darauf basierend wird das Bild in ein
Pseudo-Farb-Raster konvertiert. Dazu wird Floyd-Steinberg dithering (error diffusion)
verwendet, um die Qualitt der Ausgabe zu maximieren. Weitere Informationen
finden sich unter http://www.gdal.org/rgb2pct.html.

PCT nach RGB

Dieses Werkzeug konvertiert die Pseudo-Farbtabelle eines Kanals in einen


RGB-Rasterlayer eines festgelegten Formats. Weitere Informationen finden sich unter
http://www.gdal.org/pct2rgb.html.

Extraktion

Kontur

Dieses Werkzeug erstellt einen Vektorlayer mit den Konturlinien eines Hhenmodells (DGM).
Unter http://www.gdal.org/gdal_contour.html finden sich weitere Informationen.

Clipper

Dieses Werkzeug ermglicht das Ausschneiden eines Rasterlayers (extrahieren eines Subsets) auf
Basis einer definierten Ausdehnung oder eines anderen Layers/Maske. Weitere Informationen
finden sich unter http://www.gdal.org/gdal_translate.html.

20.8. GDALTools Plugin

703

QGIS User Guide, Release 2.6

Analyse
Sieben

Das Werkzeug lscht Rasterflchen, die kleiner als eine festgelegter Schwellwert (in
Pixeln) sind und ersetzt diese Flche durch Pixelwerte der grten Nachbarflche. Das
Eingangsraster kann dabei berschrieben werden, oder das Ergebnis wird in einen neuen
Rasterlayer abgespeichert. Weitere Informationen finden sich unter
http://www.gdal.org/gdal_sieve.html.

Fast Schwarz

Dieses Werkzeug scanned einen Rasterlayer und versucht alle Pixel, die fast schwarz
(oder fast weiss) entlang von Rndern sind, in exakt schwarze (bzw. weisse) Pixel
umzuwandeln. Dies wird oft verwendet, um verlusthaft komprimierte Luftbilder zu
reparieren, so dass Farbpixel bei der Mosaikierung als transparent behandelt werden
knnen. Siehe auch http://www.gdal.org/nearblack.html.

Leerwert
fllen

Dieses Werkzeug fllt selektierte Bereiche eines Rasterlayers (normalerweise


Nullwerte) durch Interpolation vorhandener Werte entlang der Rnder auf. Siehe auch
http://www.gdal.org/gdal_fillnodata.html.

Nachbarschaft
(Rasterabstand)

Werkzeug erstellt einen Raster-Abstandslayer, in dem der Abstand vom Zentrum jedes
Pixels zum Zentrum eines Nachbarpixels gespeichert wird, das als Zielpixel festgelegt
ist. Zielpixel sind jene Pixel im Ausganslayer, bei denen der Pixelwert des
Nachbarpixels sich in der angegebenen Liste der Zielpixelwerte befindet. Weitere
Informationen unter http://www.gdal.org/gdal_proximity.html.

Gitter
(Interpolation)

Dieses Werkzeug erstellt ein regelmiges Gitter (als Raster) aus den verstreuten Daten,
die aus einer OGR-Vektordatenquelle gelesen werden. Die Eingabedaten werden dabei
interpoliert, um die Gitterknoten mit Werten zu fllen. Dabei kann zwischen
verschiedenen Interpolationsmethoden gewhlt werden. Siehe auch
http://www.gdal.org/gdal_grid.html.

DHM
(Gelndemodelle)

Werkzeuge zum Visualisieren und Analysieren von Digitalen Hhenmodellen. Es


erstellt Schummerung, Neigung, Perspektive, Farbrelief, Oberflchenrauhigkeit,
topographische Position und Rauhigkeit. Weitere Informationen unter
http://www.gdal.org/gdaldem.html.

704

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Sonstiges
Virtuelles
Raster ezeugen
(Katalog)

Dieses Werkzeug erstellt ein VRT (Virtueller Datensatz), das ein Mosaik der GDAL
Eingaberaster darstellt. Siehe auch http://www.gdal.org/gdalbuildvrt.html.

Verschmelzen

Dieses Werkzeug mosaikiert einen Satz von Bilddaten. Alle Layer mssen in
derselben Projektion vorliegen und die gleiche Anzahl von Kanlen aufweisen. Sie
knnen aber berlappen und eine unterschiedliche Auflsung aufweisen. Bei
berlappung wird der letzte Layer ber die anderen gelegt. Siehe auch
http://www.gdal.org/gdal_merge.html.

Information

Das Werkzeug listet zahlreiche Informationen ber einen Rasterlayer, dessen Format
von GDAL gelesen werden kann. Unter http://www.gdal.org/gdalinfo.html finden Sie
weitere Informationen.

bersichten
erzeugen
(Pyramiden)

Das gdaladdo Werkzeug wird benutzt, um bersichten zu erstellen oder zu


aktualisieren. Dabei werden one over several downsampling Methoden angewendet.
Siehe auch http://www.gdal.org/gdaladdo.html.

Kachelindex

Dieses Werkzeug erstellt eine Shapedatei mit einem Eintrag fr jede


Eingaberasterdatei, einem Attribut, das den Dateinamen enthlt sowie einer
Polygongeometrie, die das Raster umrandet. Siehe auch
http://www.gdal.org/gdaltindex.html.

GDALTools-Einstellungen
Verwenden Sie diesen Dialog um Ihre GDAL Variablen einzubetten.
.

20.9 Georeferenzier Plugin


Das Plugin Georeferenzierung erlaubt die Erstellung von Worldfiles fr existierende Rasterlayer und das Entzerren
von Rasterlayern in ein neues GeoTiff. Es ermglicht damit das Georeferenzieren von Rasterdaten in geografische
und projizierte Koordinatensysteme oder die Transformation des Rasters in ein neues Koordinatensystem. Der
Ansatz besteht darin, Bezugspunkte auf der Rasterkarte zu finden, denen eindeutige Koordinaten zugewiesen
werden knnen.
Funktionalitten

20.9. Georeferenzier Plugin

705

QGIS User Guide, Release 2.6

Icon

Funktion

Icon

Funktion

Raster ffnen

Georeferenzierung beginnen

GDAL Skript erzeugen

GCP Punkte laden

GCP Punkte speichern als

Transformationseinstellungen

Punkt hinzufgen

Punkt lschen

GCP-Punkt verschieben

Verschieben

Hineinzoomen

Herauszoomen

Auf den Layer zoomen

Zoom zurck

Zoom vor

Georeferenzierung mit QGIS verbinden

QGIS mit Georeferenzierung verbinden

Volle Histogrammstreckung

Lokale Histogrammstreckung
Table Georeferencer 1: Georeferenzierfunktionen

20.9.1 Wie benutzt man den Georeferenzierer


Es gibt zwei Mglichkeiten, um X und Y Koordinaten (DMS (dd mm ss.ss), DD (dd.dd) einer Rohkarte oder die
Koordinaten (mmmm.mm) ) einer projizierten Karte an ausgewhlten Punkten eines Bildes zu georeferenzieren:
Das Raster verfgt manchmal ber Kreuze mit Koordinaten, die auf das Bild geschrieben sind. In diesem
Fall knnen Sie die Koordinaten manuell eintragen.
Bereits georeferenzierte Layer verwenden. Dies knnen entweder Vektor- oder Rasterdaten sein, die die
gleichen Objekte/Features, die Sie auf dem Bild haben, das Sie georeferenzieren wollen, haben mit der
Projektion, die Sie fr Ihr Bild brauchen. In diesem Fall knnen Sie die Koordinaten eingeben, indem Sie
auf den Referenzdatensatz, der im QGIS Kartenfenster geladen ist, klicken.
Die allgemeine Vorgehensweise besteht normalerweise darin, dass man eine Reihe von Punkten auf dem zu georeferenzierenden Bild auswhlt, diesen die entsprechenden Koordinaten der Zielprojektion zuweist und dann eine
passende Transformationsmethode auswhlt. Entsprechend der Eingabeparameter erstellt das Plugin dann entweder einen Worldfile fr das Bild oder erzeugt eine entzerrte Version des Bildes als GeoTiff. Allgemein gilt, je mehr
Punkte gesetzt werden, desto besser ist das Resultat.
Der erste Schritt ist es, QGIS zu starten, das Georeferenzierung Plugin zu laden (siehe Der Erweiterungen Dialog)
und auf Raster Georeferenzierung, was in der QGIS Menleiste erscheint, zu klicken. Der Georeferenzierung
Plugin Dialog erscheint wie gezeigt in figure_georeferencer_1.
In diesem Beispiel soll ein Worldfile fr eine topografische Karte aus der Gegend Sd-Dakotas erstellt werden,
welche zu dem GRASS Spearfish-Datensatz passt. Diese Karte kann spter zusammen mit den erstellten Daten in
der GRASS spearfish60 Location dargestellt werden. Die topopgrafische Karte steht unter folgender Adresse
zum Download bereit - http://grass.osgeo.org/sampledata/spearfish_toposheet.tar.gz.
Eingabe von Bezugspunkten (Ground Control Points (GCP))
1. Um die Georeferenzierung eines unreferenzierten Rasters zu starten mssen wir es zuerst mit dem
Knopf laden. Das Raster erscheint im Hauptarbeitsbereich des Dialogs. Nachdem das Raster geladen wurde
knnen wir anfangen Referenzpunkte einzugeben.
2. Fgen Sie Punkte der Hauptarbeitsflche hinzu und geben Sie ihre Koordinaten ein (siehe Abbildung figure_georeferencer_2). Fr diesen Ablauf haben Sie drei Optionen:
Sie klicken auf einen Punkt in der Rasterkarte und geben die X- und Y-Koordinaten ein.

706

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Abbildung 20.16: Georeferenzierung Plugin Dialog


aus Karte
, um die X- und
Sie klicken auf einen Punkt in der Rasterkarte und whlen den Knopf
Y-Koordinaten mit Hilfe einer georeferenzierten, in QGIS geladenen Karte hinzuzufgen.

Mit dem
sind.

Knopf knnen Sie die GCPs in beiden Fenstern verschieben, wenn Sie am falschen Platz

3. Geben Sie weitere Bezugspunkte an. Sie sollten mindestens 4 Punkte festlegen, und je mehr Punkte Sie gut
verteilt angeben, desto besser wird normalerweise das Ergebnis. Es gibt zustzliche Werkzeuge im Plugin
Dialog um in der Arbeitsumgebung zu zoomen und zu verschieben um einen relevanten Satz von GCP
Punkten ausfindig zu machen.

Abbildung 20.17: Dem Rasterbild Punkte hinzufgen


Die Punkte die der Karte hinzugefgt werden werden in einer getrennten Textdatei gespeichert
([filename].points), in der Regel zusammen mit dem Rasterbild. Dies ermglicht es uns das Georeferenzierung Plugin wieder zu einem spteren Zeitpunkt zu ffnen und neue Punkte hinzuzufgen oder bestehende zu
lschen um das Ergebnis zu optimieren. Die Punktedatei enthalt Wert vom Format: mapX, mapY, pixelX,
pixelY. Sie knnen die
den.

Passpunkte laden

20.9. Georeferenzier Plugin

und

Passpunkte speichern als

Knpfe zum verwalten der Dateien verwen-

707

QGIS User Guide, Release 2.6

Festlegen der Transformationseinstellungen


Nachdem Sie in dem Bild eine ausreichende Anzahl an Punkten gesetzt haben, gilt es nun, die Transformationseinstellungen fr die Georeferenzierung zu definieren.

Abbildung 20.18: Definieren der Georeferenzierung Transformationseinstellungen

Auswahl des Transformationstyps


Abhngig davon, wieviele Bezugspunkte Sie gesetzt haben, stehen unterschiedliche Transformationstypen zur
Verfgung. Der zu whlende Transformationstyp ist auerdem vom Typ und der Qualitt der Eingangsdaten,
sowie der Anzahl geometrischer Strungen, die in dem Ergebnis auftreten knnen, abhngig.
Derzeit stehen die folgenden Transformationstypen zur Verfgung:
Der Linear Algorithmus wird verwendet eine Worlddatei zu erstellen und unterscheidet sich von der anderen Algorithmen, da er das Raster nicht wirklich transformiert. Dieser Algorithmus wird wahrscheinlich
nicht ausreichen wenn Sie mit gescanntem Material zu tun haben.
Die **Helmert* Transformation fhrt einfache Skalierungs- und Rotationstransformationen durch.
Die Polynomial Algorithmen 13 sind unter den am meisten verwendeten Algorithmen, die eingefhrt wurden, um Quell- und Zielkontrollpunkten zu entsprechen. Der am weitesten verbreitete polynomische Algorithmus ist die Polynomische Transformation zweiter Ordnung, die eine gewisse Krmmung ermglicht.
Die Polynomische Transformation erster Ordnung (Affintransformation) bewahrt nur die Kollinearitt und
erlaubt nur die Skalierung, bersetzung und Drehung.
Der Thin Plate Spline (TPS) Algorithmus ist eine modernere Georeferenzierungsmethode, die lokale Deformationen in die Daten einfhren kann. Dieser Algorithmus ist ntzlich wenn Originalbilder mit sehr
schlechter Qualitt georeferenziert werden.
Die Projektiv* Transformation ist eine lineare Drehung und bersetzung von Koordinaten.

708

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Festlegen der Resampling Methode


Die verwendete Resampling Methode wird wahrscheinlich von den Eingabedaten und dem Ziel der bung abhngig sein. Wenn die Bildstatistik nicht verndert werden soll, whlen Sie wahrscheinlich die Nchster Nachbar
Methode, wo hingegen die Kubische Methode ein eher weicheres Ergebnis ergibt.
Es ist mglich zwischen 5 verschiedenen Resamplingmethoden auszuwhlen:
1. Nchster Nachbar
2. Linear
3. Kubisch
4. Kubisches Spline
5. Lanczos
Festlegen der Transformationseinstellungen
Es gibt mehrere Optionen, die fr die Ausgabe der Georeferenzierung festgelegt werden mssen.
World-Datei erzeugen Kontrollkstchen steht nur zur Verfgung wenn Sie sich entschlieen den
Das
linearen Transformationstyp zu verwenden, das dies heisst dass das Rasterbild tatschlich nicht umgewandelt wird. In diesem Fall ist das Ausgaberaster Feld nicht aktiviert, da nur eine neue World-Datei erstellt
wird.
Fr alle anderen Transformationstypen mssen Sie ein Ausgaberaster angeben. Als Standard wird eine Datei
mit dem Namen ([filename]_modified) in demselben Ordner, indem sich auch die Originaldatei befindet
geschrieben.
Als nchstten Schritt mssen Sie das Ziel-KBS (Koordinatenbezugssystem) fr die georeferenzierte Rasterdatei definieren (siehe Arbeiten mit Projektionen).
Wenn Sie mgen knnen Sie eine PDF-Karte erzeugen und auch einen PDF-Bericht erzeugen. Der
Bericht enthlt Informationen ber die verwendeten Parameter, ein Bild mit den Residuen und eine Liste
mit allen GCPs und ihrer RMS Fehler.
Darberhinaus knnen Sie das
Zielauflsung Kontrollkstchen aktivieren und die Pixelauflsung des
Ausgaberasters definieren. Die voreingestellte horizontale und vertikale Auflsung ist 1.

Falls ntig 0 fr Transparenz verwenden kann aktiviert werden wenn Pixel mit dem Wert 0 transparent
dargestellt werden sollen. In unserer topografischen Karte wren alle weien Bereiche transparent.

Schlielich ldt
Wenn fertig in QGIS laden das Ausgaberaster automatisch in das QGIS Kartenfenster
wenn die Transformation abgeschlossen ist.
Rastereigenschaften anziegen und anpassen
Wenn Sie auf den Knopf Raster properties im Men Einstellungen klicken, ffnet sich ein Dialog, um die
Rastereigenschaften des zu referenzierenden Layers zu verndern.
Den Georeferenzierer konfigurieren
Sie knnen definieren, ob Sie GCP Koordinaten und/oder IDs anzeigen wollen.
Als Resteinheiten knnen Pixel und Karteneinheiten ausgewhlt werden.
Fr den PDF-Bericht kann ein linker und rechter Rand definiert werden und Sie knnen auch das Papierformat fr die PDF-Karte festlegen.
Schlielich knnen Sie

20.9. Georeferenzier Plugin

Georeferenzierungsfenster docken aktivieren.

709

QGIS User Guide, Release 2.6

Starten der Georeferenzierung


Nachdem alle GCPs gesetzt worden sind und alle Transformationseinstellungen definiert worden sind dcken Sie
einfach den

Georeferenzierung beginnen

Knopf um eine neue georeferenzierte Rasterdatei zu erstellen.

20.10 Interpolationsplugin
Die Interpolationserweiterung kann verwendet werden um eine TIN oder IDW Interpolation aus einem Punktvektorlayer zu erzeugen. Es ist sehr einfach zu bedienen und stell eine intuitive Benutzeroberflche zum Erstellen von
interpolierten Rasterlayern bereit (siehe Figure_interpolation_1). Die Erweiterung bentigt die folgenden Parameter, die vor dem Ausfhren angegeben werden mssen:
Eingabevektor: Whlen Sie einen in QGIS geladenen Vektor Punktlayer(s). Wenn mehrere Layer
angegeben werden, werden die Daten aller Layer fr die Interpolation verwendet. Beachten Sie auch, dass
es mglich ist, Linien und Polygone als Randbedingungen fr die Triangulation zu verwenden, indem Sie
:guilabelTyp des geladenen Layers entweder Punkte, Strukturlinien oder
in der Kombobox
Bruchkanten auswhlen.
Interpolationsattribut: Whlen Sie die Attributspalte fr die Interpolation oder aktivieren Sie
Koordinate fr Interpolation verwenden um die im Layer gespeicherten Z-Werte zu verwenden.

Z-

Interpolationsmethode: Whlen Sie die Interpolationsmethode. Dies kann entweder Unregelmiges


Dreiecksnetz (TIN) oder Inverse Distanzgewichtung (IDW) sein.
Spalten-/Zeilenanzahl: Geben Sie die Anzahl von Zeilen und Spalten fr die Ausgaberasterdatei an.
Ausgabedatei: Legen Sie einen Namen fr den Ausgabelayer fest.

Ergebnis zum Projekt hinzufgen um das Ergebnis in die Kartenansicht zu laden.

Abbildung 20.19: Interpolationserweiterung

20.10.1 Das Plugin anwenden


1. Starten Sie QGIS und laden Sie einen Punktvektorlayer (z.B. elevp.csv).
2. Laden Sie die Interpolationserweiterung in den Plugin Manager (siehe Der Erweiterungen Dialog) und
klicken Sie auf Raster Interpolation
Interpolation, was in der QGIS Menleiste erscheint. Der
Interpolationserweitertungsdialog erscheint wie in Figure_interpolation_1 gezeigt.

710

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

3. Whlen Sie den Layer elevp als Eingabevektorlayer und Spalte ELEV als Interpolationsattribut.
4. Whlen Sie eine Interpolationsmethode (z.B. Unregelmiges Dreiecksnetz (TIN)), und geben Sie eine
Zellgre von 5000 genauso wie den Ausgabedateinamen (z.B. elevation_tin) an.
5. Klicken Sie auf [OK].
.

20.11 Offline-Bearbeitung Plugin


Bei der Datenerfassung ist es eine alltgliche Situation, um mit einem Laptop oder Smartphone im Gelnde offline
zu arbeiten. Nach der Rckkehr mssen die nderungen wieder mit der Master-Datenquelle (z.B. einer PostGIS
Datenbank) synchronisiert werden. Wenn mehrere Personen gleichzeitig mit denselben Datenbestnden arbeiten,
ist es meist schwierig, die nderungen von Hand zu verschmelzen, selbst wenn unterschiedliche Objekte verndert
wurden.
Offline-Bearbeitung
Plugin automatisiert die Synchronisation durch Kopieren des Inhalts einer Datenquelle (in
Das
der Regel PostGIS oder WFS-T) zu einer SpatiaLite Datenbank mit dedizierten Tabellen. Nachdem man wieder
mit dem Netzwerk verbunden ist, knnen die Offline-nderungen wieder an die Master-Datenquell zurckgespielt
werden.

20.11.1 Verwendung der Erweiterung


ffnen Sie einige Vektorlayer (z.B. von einer PostGIS- oder WFS-T-Datenquelle).
Speichern Sie es als Projekt.
Zu Offline-Projekt konvertieren und whlen Sie die
Gehen Sie zu Datenbank Offline-Bearbeitung
zu speichernden Layer. Der Inhalt der Layer wird in SpatiaLite gespeichert.
Editieren Sie die Layers offline.
Nachdem Sie sich wieder verbunden haben laden Sie die nderungen mit Datenbank OfflineBearbeitung

Synchronisieren hoch.

20.12 Oracle-Spatial-GeoRaster Plugin


Oracle Datenbanken mit Oracle Spatial Erweiterung ermglichen es, Rasterlayer als SDO_GEORASTER Objekte
Oracle-Spatial-GeoRaster
zu speichern. In QGIS existiert das
Plugin. Es basiert auf der GDAL Bibliothek und setzt
voraus, dass eine entsprechende Oracle Datenbank auf ihrem Rechner luft. Obwohl Oracle keine freie Software
ist, stellen Sie ihre Software fr Entwickler und zu Testzwecken kostenlos zur Verfgung. Ein einfaches Beispiel,
wie man ber GDAL ein Raster in ein GeoRaster laden kann sieht folgendermaen aus:

$ gdal_translate -of georaster input_file.tif geor:scott/tiger@orcl

Das Raster wird in diesem Beispiel in die Standard GDAL_IMPORT Tabelle als Spalte mit dem Namen RASTER
geladen.

20.12.1 Mit der Datenbank verbinden


Als erstes muss das Oracle GeoRaster Plugin mit dem Plugin Manager geladen werden (siehe Kapitel Der Erweiterungen Dialog). Wenn Sie zum ersten Mal ein GeoRaster in QGIS laden wollen, mssen Sie zuvor eine
Verbindung zu der Oracle Datenbank erstellen, in der sich die Daten befinden. Hierzu klicken Sie auf das
20.11. Offline-Bearbeitung Plugin

711

QGIS User Guide, Release 2.6

Abbildung 20.20: Ein Offline-Projekt aus PostGIS- oder WFS-Layern erstellen


Oracle-GeoRaster-Layer hinzufgen

Icon in der Werkzeugleiste. In dem Dialog klicken Sie auf [Neu] und geben dann die
notwendigen Verbindungsparameter ein (siehe Abbildung Figure_oracle_raster_1):
Name: Geben Sie einen Namen fr die Datenbankverbindung ein.
Datenbankinstanz: Geben Sie den Namen der Datenbank mit der Sie sich verbinden werden ein.
Benutzername: Geben Sie Ihren eigenen Benutzernamen, den Sie verwenden werden um sich mit der
Datenbank zu verbinden, an.
Passwort: Vergeben Sie das Passwort das Ihrem Benutzernamen zugeordnet ist und das erforderlich ist um
die Datenbank anzubinden.

Abbildung 20.21: Oracle-Verbindung herstellen Dialog


Zurck im Hauptfenster des Oracle Spatial GeoRaster Plugins (siehe Abbildung Figure_oracle_raster_2), whlen
Sie die Dropdown Liste, um die neue Verbindung auszuwhlen und klicken dann auf [Verbinden], um die
Verbindung herzustellen. Sie knnen die Verbindung auch nochmals [Bearbeiten] und Vernderungen vornehmen

712

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

oder mit dem Knopf [Lschen] die Verbindung aus der Dropdown Liste entfernen.

20.12.2 Ein GeoRaster auswhlen


Nachdem eine Verbindung eingerichtet wurde, zeigt das Unterdaten Fenster die Namen aller Tabellen die
GeoRaster-Spalten in der Datenbank enthalten und das Format von GDAL Unterdatennamen haben.
Whlen Sie einen der subdatasets und klicken dann auf [Whlen], um den Tabellennamen auszuwhlen. Daraufhin erscheint eine weitere Liste mit den GeoRaster Spalten, die sich in der Tabelle befinden. Dies ist normalerweise eine kurze Liste, da es eher selten vorkommt, dass mehr als ein oder zwei GeoRaster Spalten in einer
Tabelle abgelegt sind.
Klicken Sie auf einen der aufgelisteten Unterdatenstze und klicken Sie dann auf [OK] um eine der Tabellen/Spaltenkombinationen auszuwhlen. Der Dialog zeigt nun alle Zeilen die GeoRaster-Objekte enthalten. Beachten
Sie, dass die Unterdaten-Liste jetzt die Raster Data Table und Raster Id pairs zeigt.
Der Auswahleintrag kann zu jeder Zeit bearbeitet werden um direkt zu einem bekannten GeoRaster zu gehen oder
zurck zum Anfang zu gehen und einen anderen Tabellennamen auszuwhlen.

Abbildung 20.22: Oracle-Spatial-GeoRaster whlen Dialog


Der Auswahl Dateneintrag kann auch dazu verwendet werden eine WHERE Klausel am Ende des Identifikationsstrings (z.B. geor:scott/tiger@orcl,gdal_import,raster,geoid=) einzugeben. Siehe
http://www.gdal.org/frmt_georaster.html fr weitere Informationen.

20.12.3 Ein GeoRaster laden


Schlielich wird das Rasterbild durch Auswhlen eines GeoRasters aus der Liste der Raster Data Tables und
Raster Ids in QGIS geladen.
Der Oracle-Spatial-GeoRaster whlen Dialog kann jetzt geschlossen werden und wenn er das nchste Mal
geffnet wird, wird die gleiche Verbindung beibehalten und wird die gleiche vorherige Liste von Unterdatenstzen
gezeigt, was es sehr einfach macht ein anderes Bild aus dem gleichen Kontext zu ffnen.
Bemerkung: GeoRaster, die mit Pyramiden abgelegt sind, werden in QGIS wesentlich schneller visualisiert. Die
Pyramiden mssen aber im Vorfeld und auerhalb von QGIS mit Oracle PL/SQL oder gdaladdo erstellt werden.
20.12. Oracle-Spatial-GeoRaster Plugin

713

QGIS User Guide, Release 2.6

Das folgende ist ein Beispiel, bei dem gdaladdo verwendet wird:
gdaladdo georaster:scott/tiger@orcl,georaster\_table,georaster,georid=6 -r
nearest 2 4 6 8 16 32

Beispiel zum Erstellen von Pyramiden mit PL/SQL:


$ sqlplus scott/tiger
SQL> DECLARE
gr sdo_georaster;
BEGIN
SELECT image INTO gr FROM cities WHERE id = 1 FOR UPDATE;
sdo_geor.generatePyramid(gr, rLevel=5, resampling=NN);
UPDATE cities SET image = gr WHERE id = 1;
COMMIT;
END;

20.13 Rastergelndeanalyse-Erweiterung
Die Rastergelndeanalyse-Erweiterung kann verwendet werden um Neigung, Perspektive, Schummerung,
Rauhigkeitsindex und Relief von Digitalen Gelndemodellen (DGM) zu berechnen. Es ist sehr einfach
anzuwenden und stellt eine intuitive Benutzeroberflche zum Erstellen neuer Rasterlayer bereit (siehe Figure_raster_terrain_1).
Description of the analysis:
Neigung: Berechnet den Neigungswinkel fr jede Zelle in Grad (beruht auf Ableitung erster Ordnung).
Perspektive: Berechnung der Exposition. Beginnend mit 0 fr Nord und dann in Grad gegen den
Uhrzeigersinn.
Schummerung: Erstellen einer Schummerungskarte auf Basis von Licht und Schatten, um ein 3D-hnliches
Erscheinungsbild zu schaffen.
Rauhigkeitsindex: Eine quantitative Bestimmung der Heterogenitt eines Gelndes beschrieben durch Riley et al. (1999). Es wird fr jeden Ort mit einem 3x3 Pixel Fenster berechnet.
Relief: Erstellen einer Shaded Relief Karte auf Basis eines DGM. Integriert ist eine Methode, um auf Basis
der Hufigkeitsverteilung der Hhenwerte Farbwerte zuzuweisen.

Abbildung 20.23: Rastergelndeanalyse-Erweiterung (Neigungsberechnung)

20.13.1 Das Plugin anwenden


1. Starten Sie QGIS und laden Sie den gtopo30 Rasterlayer aus der GRASS Beispiel-Location.
714

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

2. Laden Sie die Rastergelndeanalyse-Erweiterung im Plugin Manager (siehe Abschnitt Der Erweiterungen
Dialog).
3. Whlen Sie eine Analysemethode (z.B.: Raster Gelndeanalyse Neigung). Der Neigung Dialog erscheint wie in Figure_raster_terrain_1 gezeigt.
4. Geben Sie eine Ausgabedatei mit Pfad und Dateiformat an.
5. Klicken Sie [OK].
.

20.14 Heatmap-Erweiterung
Die Heatmap-Erweiterung verwendet Kernel Density Estimation um ein Dichte- (Heatmap) Raster eines Eingabe
Punktvektorlayers zu erstellen. Die Dichte wird auf Grundlage der Anzahl von Punkten an einem Ort berechnet,
wobei eine grere Anzahl von geclusterten Punkten hhere Werte zum Ergebnis haben. Heatmaps ermglichen
die einfache Identifikation von Hotspots und Punktclustern.

20.14.1 Das Heatmap Plugin starten


Zuerst muss diese Kernerweiterung anhand des Erweiterungsmanagers aktiviert werden (siehe Der Erweiterungen
Dialog). Nach der Aktivierung kann das Heatmap Icon
Heatmap Men gefunden werden.

in der Rasterwerkzeugleiste sowie im Raster

Whlen Sie das Men Einstellungen Werkzeugksten Raster um die Rasterwerkzeugleiste anzuzeigen falls
diese nicht sichtbar ist.

20.14.2 Das Heatmap Plugin verwenden


Das Klicken auf das

Heatmap Werkzeug ffnet den Heatmap-Erweiterung Dialog (siehe figure_heatmap_2).

Der Dialog hat folgende Optionen:


Eingabepunktlayer: Listet alle Vektorpunktlayer im aktuelle Projekt auf und wird dazu benutzt den Layer,
der analysiert werden soll, auszuwhlen.
Ausgaberaster: Ermglicht es Ihnen den
Knopf zum Auswhlen des Ordners und Dateinamens fr
das Ausgaberaster, das die Heatmap-Erweiterung erzeugt, zu verwenden. Eine Dateierweiterung ist nicht
erforderlich.
Ausgabeformat: Whlt das Ausgabeformat aus. Wenn auch alle von GDAL untersttzten Formate ausgewhlt werden knnen ist GeoTIFF in den meisten Fllen das am besten geeignete Format.
Radius: Wird verwendet um den Heatmap Suchradius (oder Kernbandbreite) in Metern oder Karteneinheiten anzugeben. Der Radius gibt den Abstand um einen Punkt ab dem der Einfluss des Punktes sprbar wird
an. Grere Werte haben eine strkere Glttung zur Folge, kleinere Werte knnen aber feinere Details und
eine Abwechslung in der Punktdichte zeigen.
Wenn das

Erweitert Kontrollkstchen aktiviert ist, stehen zustzliche Optionen zur Verfgung:

Zeilen und Spalten: Werden dafr verwendet die Abmessungen des Ausgaberasters zu verndern. Diese
Werte sind auch mit den Zellengre X und Zellengre Y Werten verbunden. Das Erhhen der Anzahl
Zeilen oder Spalten verringert die Zellgre und vergrert die Dateigre der Ausgabedatei. Die Werte in
den Zeilen und Spalten sind ebenfalls verbunden, also verdoppelt das Verdoppeln der Anzahl von Zeilen
automatisch die Anzahl von Spalten und die Zellgren werden ebenfalls halbiert. Das geografische Gebiet
des Ausgaberasters bleibt das Gleiche!

20.14. Heatmap-Erweiterung

715

QGIS User Guide, Release 2.6

Zellengre X und Zellengre Y: Kontrollieren Sie die geografische Gre jedes Pixels im Ausgaberaster.
Das Verndern dieser Wert verndert ebenfalls die Anzahl von Zeilen und Spalten im Ausgaberaster.
Kernform: Die Kernform kontrolliert die Rate mit der der Einfluss auf einen Punkt abnimmt whrend der
Abstand zum Punkt steigt. Verschiedene Kernel verfallen in verschiedenen Raten, also legt ein TriweightKernel greres Gewicht auf Objekte, die nher am Punkt liegen, als der Epanechnikov Kernel. Folglich hat
Triweight schrfere Hotspots zum Ergebnis und Epanechnikov weichere Hotspots. In QGIS steht eine
Reihe von Standard-Kernel-Funktionen zur Verfgung, wie beschrieben und illustriert auf Wikipedia.
Verfallrate: Kann bei Dreieck Kernformen verwendet werden um weiter zu kontrollieren wie der Heat eines
Objekts mit der Entfernung zum Objekt sinkt.
Ein Wert von 0 (=Minimum) zeigt an, dass das Heat im Zentrum des vorgegebenen Radius konzentriert
wird und an der Kante vollstndig gelscht wird.
Ein Wert von 0.5 gibt an dass Pixel am Rand von Radius den halben heat wie Pixel im Zentrum des
Suchradius erhalten.
Ein Wert von 1 heisst das der heat gleichmig ber den gesamten Suchradiuskreis verteilt wird. (Dies
entspricht dem Uniform Kernel.)
Ein Wert grer als 1 gibt an, dass das Heat entgegen der Kante des Suchradius grer ist als im
Zentrum.
Der Eingabepunktlayer kann ebenfalls Attributfelder, die das Heatmap beeinflussen, beinhalten:
Feld fr Radius: Setzt den Suchradius fr jedes Objekt aus einem Attributfeld im Eingabelayer.
Feld fr Gewichtung: Ermglicht es Eingabeobjekte anhand eines Attributfeldes zu gewichten. Dies kann
verwendet werden um den Einfluss, den bestimmte Objekte auf die Ergebniskarte haben, zu erhhen.
Wenn ein Ausgaberaster-Dateiname angegeben ist, kann der [OK] Knopf dazu verwendet werden, das Heatmap
zu erstellen.

20.14.3 Tutorial: Erstellen eines Heatmap


Fr das folgende Beispiel werden wir den airports Punktvektorlayer aus dem QGIS Beispieldatensatz (siehe
Beispieldaten) verwenden. Einen anderes exzellentes QGIS Tutorial ber das Erstellen von Heatmaps finden Sie
unter http://qgis.spatialthoughts.com.
In Figure_Heatmap_1 werden die airports von Alaska gezeigt.
1. Das Klicken auf das
ure_heatmap_2).

Heatmap Werkzeug ffnet den Heatmap-Erweiterung Dialog (siehe Fig-

2. Whlen Sie im Eingabepunktlayer


tuelle Projekt geladen sind, aus.

Feld die airports aus der Liste von Punktlayern, die ins ak-

3. Geben Sie einen Ausgabedateinamen an indem Sie den


Knopf neben dem Ausgaberaster Feld klicken.
Geben Sie den Dateinamen heatmap_airports ein (es ist keine Dateierweiterung erforderlich).
4. Lassen Sie das Ausgabeformat als voreingestelltes Format GeoTIFF.
5. ndern Sie den Radius auf 1000000 Meter.
6. Klicken Sie auf [OK] um das airports Heatmap zu erstellen und zu laden (siehe Figure_Heatmap_3).
QGIS erstellt das Heatmap und fgt die Ergebnisse Ihrem Kartenfenster hinzu. Standardmig wird das Heatmap
in Graustufen schattiert, wobei hellere Bereiche hhere Konzentrationen von aiports zeigen. Das Heatmap kann
jetzt in QGIS dargestellt werden um sein Aussehen zu verbessern.
1. ffnen Sie den Eigenschaftendialog des heatmap_airports Layers (whlen Sie den Layer
heatmap_airports, ffnen Sie das Kontextmen mit der rechten Maustaste und whlen Sie Eigenschaften).
2. Whlen Sie den Reiter Stil.

716

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Abbildung 20.24: Aiports von Alaska

3. ndern Sie die Darstellungsart

in Einkanalpseudofarbe.

4. Whlen Sie eine geeignete Farbabbildung

, beispielsweise YlOrRed.

5. Klicken Sie den [Laden] Knopf um die Minimum- und Maximumwerte aus dem Raster zu holen und
klicken Sie dann auf den [Klassifizieren] Knopf.
6. Klicken Sie [OK] um den Layer zu updaten.
Das Endergebnis sehen Sie in Figure_Heatmap_4.
.

20.15 MetaSearch Katalog Client

20.15. MetaSearch Katalog Client

717

QGIS User Guide, Release 2.6

Abbildung 20.25: Der Heatmap-Erweiterung Dialog

718

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Abbildung 20.26: Nach dem Laden sieht das Heatmap wie eine graue Oberflche aus

Abbildung 20.27: Heatmap der airports von Alaska mit geeignetem Stil

20.15. MetaSearch Katalog Client

719

QGIS User Guide, Release 2.6

20.15.1 Einleitung
MetaSearch ist eine QGIS Erweiterung um mit Metadatenkatalogservices zu interagieren und untersttzt den OGC
Katalogservice fr das Web (CSW) Standard.
MetaSearch stellt eine einfache und intuitiv zu benutzende Benutzerfreundliche Bedienoberflche um Metadatenkataloge innerhalb von QGIS zu durchsuchen zur Verfgung.

20.15.2 Installation
MetaSearch ist standardmig in QGIS 2.0 und hher enthalten. Alle Abhngigkeiten sind in MetaSearch enthalten.
Metasearch
wird
ber
den
QGIS
http://plugins.qgis.org/plugins/MetaSearch installiert.

Erweiterungsmanager

oder

manuell

von

20.15.3 Arbeiten mit Metadatenkatalogen in QGIS


CSW (Katalog Services fr das Web)
CSW (Catalogue Service for the Web) ist eine OGC (Open Geospatial Consortium) Spezifikation die allgemeine
Schnittstellen definiert um Metadaten ber Daten, Services und andere potentielle Ressourcen zu entdecken, zu
durchsuchen und abzufragen.
Start
Um Metasearch zu starten klicke das MetaSearch Icon oder whle Web / MetaSearch / MetaSearch mittels des
QGIS Hauptmens. Der MetaSearch Dialog taucht auf. Das Hauptmen besteht aus zwei TABS: Services und
Suche.
Verwaltung von Katalogservices

Der Services TAB erlaubt die Verwaltung aller verfgbaren Katalogservices. MetaSearch stellt eine Standardliste
von Katalogservices zur Verfgung die man ber den Fge Standard Services hinzu Button erreicht.
Fr alle aufgefhrten Catalogue Service Eintrge klicken Sie die Drop-down-Auswahl-Box.

720

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Um einen Katalog Service hinzuzufgen klicken sie auf Neu und geben sie einen Namen und die Adresse des
Service ein. Beachten Sie das nur die BasisURL notwendig ist (nicht die Vollstndige GetCapabilities URL). Ein
Klick auf OK fgt den Service hinzu.
Um einen existierenden Katalogservice zu editieren whlen sie den betreffenden Eintrag aus und klicken die Edit
Schaltflche. ndern Sie Namen und/oder URL und klicken auf OK.
Um einen Katalogservice zu lschen whlen Sie den Eintrag den Sie lschen wollen und klicken auf Lschen.
Eine Sicherheitsabfrage die Sie besttigen mssen wird erscheinen.
MetaSearch erlaubt Verbindungen in XML Dateien zu speichern. Dies ist ntzlich um Einstellungen mit anderen
Programmen zu teilen. Unterhalb findet sich ein Beispiel des XML Dateiformats.

<?xml version="1.0" encoding="UTF-8"?>


<qgsCSWConnections version="1.0">
<csw name="Data.gov CSW" url="http://catalog.data.gov/csw-all"/>
<csw name="Geonorge - National CSW service for Norway" url="http://www.geonorge.no/geonetwork/
<csw name="Geoportale Nazionale - Servizio di ricerca Italiano" url="http://www.pcn.minambient
<csw name="LINZ Data Service" url="http://data.linz.govt.nz/feeds/csw"/>
<csw name="Nationaal Georegister (Nederland)" url="http://www.nationaalgeoregister.nl/geonetwo
<csw name="RNDT - Repertorio Nazionale dei Dati Territoriali - Servizio di ricerca" url="http:
<csw name="UK Location Catalogue Publishing Service" url="http://csw.data.gov.uk/geonetwork/sr
<csw name="UNEP/GRID-Geneva Metadata Catalog" url="http://metadata.grid.unep.ch:8080/geonetwor
</qgsCSWConnections>

Um eine Liste von Eintrgen zu laden klicken Sie den Laden Knopf. Ein neues Fenster erscheint; klicken Sie
den Durchsuchen Knopf und navigieren Sie zu der XML Datei von Eintrgen die Sie laden wollen und klicken
Sie ffnen. Die Liste von Eintrgen wird angezeigt. Whlen Sie die Eintrge die Sie von der Liste hinzufgen
wollen und klicken Sie Laden.
The Service info button displays information about the selected Catalogue Service such as service identification,
service provider and contact information. If you would like to view the raw XML response, click the GetCapabilities response button. A separate window will open displaying Capabilities XML.
Catalogue Services suchen

Der Suchen Reiter ermglicht es dem Benutzer Catalogue Services nach Daten und Diensten abzufragen, zahlreiche Suchparameter einzusetzen und Ergebnisse anzuschauen.
Die folgenden Suchparameter stehen zur Verfgung:
Schlsselworte: freie Textsuchschlsselwrter

20.15. MetaSearch Katalog Client

721

QGIS User Guide, Release 2.6

Von: der Catalogue Service mit dem die Abfrage durchgefhrt werden soll
Begrenzungsbox: das rumliche Interessengebiet das gefiltert werden soll. Die voreingestellte Begrenzungsbox ist die Kartenansicht. Klicken Sie Welt setzen um eine globale Suche durchzufhren oder geben
Sie benutzerdefinierte Werte nach Wunsch ein
Ergebnisse: die Anzahl von Eintrgen die bei der Suche wiedergegeben werden. Voreingestellt sind 10
Eintrge
Das Klicken des Suche Knopfes sucht den ausgewhlten Metadata Catalogue. Suchergebnisse werden in einer
Liste dargestellt und knnen mit einem Klick auf den Spaltennamen sortiert werden. Sie knnen durch Suchergebnisse navigieren mit den Richtungsknpfen unter den Suchergebnisssen. Das Klicken des Suchergebnisse als
XML betrachten Knopfes ffnet ein Fenster mit der Dienstantwort im rohen XML Format.
Das Klicken eines Ergebnisses zeigt eine Zusammenfassung im Zusammenfassung Fenster und stellt die folgenden Optionen zur Verfgung:
wenn der Metadata Eintrag eine damit verbundene Begrenzungsbox hat wird ein Footprint auf der Karte
angezeigt
das Doppelklicken des Eintrages stellt die Metadaten des Eintrags mit allen damit verbundenen Zugangslinks dar. Das Klicken des Links ffnet den Link im Webbrowser des Anwenders
wenn der Eintrag ein OGC Webservice ist (WMS/WMTS, WFS, WCS) werden die entsprechenden
WMS/WMTS|WFS|WCS hinzufgen Knpfe fr den Anwender aktiviert um diese QGIS hinzuzufgen. Der OWS wird dann zur entsprechenden QGIS Verbindungsliste hinzugefgt und der entsprechende
WMS/WMTS|WFS|WCS Verbindungsdialog erscheint dann

Einstellungen
Sie knnen mit den folgenden Einstellungen eine Feineinstellung von MetaSearch durchfhren:
Ergebnisseiten: wenn nach Metadata Catalogues gesucht wird die Anzahl von Ergebnissen die pro Seite
gezeigt werden
Timeout: wenn nach Metadata Catalogues gesucht wird die Anzahl von Sekunden whrend der
Verbindungsversuche blockiert werden. Vorgabewert ist 10
.

722

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

20.16 Straengraph Plugin


Das Straengraph-Erweiterung ist ein C++ Plugin, mit dem man die krzeste Verbindung zwischen zwei Punkten
entlang eines Polyline Vektorlayers berechnen kann und den Pfad ber dem Straennetz plottet.

Abbildung 20.28: Straengraph-Erweiterung


Hauptfunktionen:
Berechnet den Pfad genauso wie die Lnge und Reisezeit.
Optimiert anhand der Lnge oder der Reisezeit.
Exportiert dem Pfad in einen Vektorlayer.
Hebt Straenrichtungen hervor (dies ist langsam und wird hauptschlich fr Debug-Zwecke und fr das
Testen von Einstellungen verwendet).
Als Netzwerk kann jeder Polyline Vektorlayer verwendet werden, der in einem von QGIS untersttzten Format
gespeichert ist. Zwei Linien mit einem gemeinsamen Punkt werden dabei als verknpft angesehen. Wichtig ist,
dass das Layer-KBS als Projekt-KBS gesetzt werden muss. Dies ist wichtig, da Neuberechnungen von Koordinaten ansonsten zu Fehlern fhren knnen, selbst eine Fangtoleranz eintgestellt ist.
In der Attributtabelle des Layers knnen die folgenden Felder benutzt werden:
Geschwindigkeit auf der Strae Abschnitt (numerisches Feld).
Richtung (jeder Typ, der in einen String umgewandelt werden kann). Vorwrts und Rckwrts Richtungen
beziehen sich auf eine Einbahnstrae, beide Richtungen zeigen eine zweispurige Strae an.
Wenn einige Zeilen keine Werte haben, werden die Defaultwerte verwendet. Sie knnen bei Bedarf gendert
werden, gemeinsam mit ein paar weiteren Einstellungsmglichkeiten im Erweiterungseinstellungen Dialog .

20.16. Straengraph Plugin

723

QGIS User Guide, Release 2.6

20.16.1 Verwendung der Erweiterung


Nach der Aktivierung des Plugins sehen Sie ein zustzliches Bedienfeld auf der linken Seite des QGIS Hauptfensters. Geben Sie jetzt einige Parameter im Straengraphen-Erweiterungseinstellungen Dialog aus dem Vektor
Straengraph Men ein (siehe figure_road_graph_2).

Abbildung 20.29: Straengraph-Erweiterung Einstellungen


Nachdem Sie die Zeiteinheit, Distanzeinheit und Topologietoleranz gesetzt haben knnen Sie den Vektorlayer im
Verkehrslayer Reiter auswhlen. Hier knnen Sie auch das Richtungsfeld und das Geschwindigkeitsfeld whlen.
Im Reiter Voreinstellungen knnen Sie die Richtung fr die Berechnung setzen.
Whlen Sie schlielich im Krzester Weg Bedienfeld einen Start und einen Stopp Punkt im Straennetzwerk Layer
und klicken Sie auf [Berechnen].
.

20.17 Rumliche Abfrage Plugin


Die Rumliche Abfrageerweiterung
Das
ermglicht es Ihnen eine rumliche Abfrage (z.B. Objekte auswhlen) in einem
Ziellayer mit Bezug auf einen anderen Layer zu erstellen. Die Funktionalitt basiert auf der GEOS Bibliothek und
hngt vom ausgewhlten Quellobjekt Layer ab.

Mgliche Operatoren sind:


Enthlt
Gleicht
berlappt
Kreuzt
berschneidet
Ist ausserhalb
Berhrt
Innerhalb
724

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

20.17.1 Verwendung der Erweiterung


Als Beispiel sollen die regions Alaskas gefunden werden, die airports enthalten. Folgende Schritte sind notwendig:
1. Starten Sie QGIS und laden Sie die Vektorlayer regions.shp und airports.shp.
2. Laden Sie die Rumliche Abfrageerweiterung in den Plugin Manager (siehe Der Erweiterungen Dialog) und
Rumliche Abfrage

klicken Sie auf das


dialog erscheint.

Icon, das in der QGIS Werkzeugleiste erscheint. Der Erweiterungs-

3. Whlen Sie den Layer regions als Quelllayer und airports als Referenzobjektlayer.
4. Whlen Sie Innerhalb als Operator und klicken Sie [Anwenden].
Jetzt erhalten Sie eine Liste von Objekt IDs aus der Abfrage und Sie haben mehrere Optionen, wie in figure_spatial_query_1 gezeigt.
Klicken Sie auf

Layer mit Liste von Elementen erzeugen

Whlen Sie eine ID aus der Liste und klicken Sie auf

Layer mit gewhlten erzeugen

Whlen Sie Aus aktueller Auswahl entfernen im Feld Das Ergebnis speichern in
Zustzlich knnen Sie

Zum Element zoomen oder ein

Protokoll anzeigen.

Abbildung 20.30: Rumliche Abfrage Analyse - regions enthalten airports


.

20.18 SPIT Plugin


QGIS bietet ein Plugin mit dem Namen SPIT (Shapefile to PostGIS Import Tool). SPIT kann dazu benutzt werden,
gleichzeitig mehrere Shapes zu laden und bietet dabei auch Support fr Schemas. Um das Plugin zu benutzen,

20.18. SPIT Plugin

725

QGIS User Guide, Release 2.6

ffnen Sie den Plugin Manager aus dem Erweiterungen Men, whlen das Plugin SPIT im Installiert Men aus,
aktivieren Sie das Kontrollkstchen neben

SPIT und drcken auf [OK].

Um eine Shapedatei zu importieren verwenden Sie Datenbank Spit Shapedateien nach PostgreSQL importieren aus der Menleiste um den SPIT - Shapedatei nach PostGIS-Importwerkzeug Dialog zu ffnen. Whlen
Sie die PostGIS Datenbank, mit der Sie sich verbinden wollen, aus und klicken Sie auf [Verbinden]. Wenn Sie
wollen knnen Sie einige Importoptionen definieren oder verndern. Jetzt knnen Sie eine oder mehrere Dateien
zur Warteschlange hinzufgen indem Sie auf den [Hinzufgen] Knopf klicken. Um die Dateien zu prozessieren
klicken Sie auf den [OK] Knopf. Der Fortschritt des Imports genauso wie Fehler/Warnungen werden angezeit
sowie eine Shapedatei prozessiert ist. .

Abbildung 20.31: Verwenden Sie die SPIT-Erweiterung um Shapedateien nach PostGIS zu importieren

20.19 SQL-Anywhere Plugin


SQL-Anywhere ist ein proprietres relationales Datenbank-Managementsystem (RDBMS) von Sybase. SQLAnywhere umfasst Untersttzung fr rumliche Daten einschlielich OGC, Shape-Dateien etc. sowie eingebaute
Funktionen fr den Export nach KML, GML und ins SVG-Format.
SQL-Anywhere
Das
Plugin erlaubt die Anbindung an rumliche SQL Anywhere Datenbanken. Der SQLAnywhere-Layer hinzufgen Dialog ist in der Funktionalitt hnlich den Dialogen fr das Laden von PostGIS
oder SpatiaLite Layern.

20.20 Topologieprfung Erweiterung


Topologie bschreibt die Beziehungen zwischen Punkten, Linien und Polygonen, die die Objekte eines Geografischen Gebiets repsentieren. Mit dem Topologie-Prfung Plugin knnen Sie Ihre Vektordateien anschauen und

726

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Abbildung 20.32: Der SQL-Anywhere Dialog (KDE)

Abbildung 20.33: Das Topologie-Prfung Plugin

20.20. Topologieprfung Erweiterung

727

QGIS User Guide, Release 2.6

die Topologie mit mehreren Topologieregeln berprfen. Diese Regeln berprfen mit rumlichen Beziehungen
ob sich Ihre Objekte Gleichen, Enthalten, Abdecken, Abgedeckt werden von, Kreuzen, Disjunkt sind,
berschneiden, berlappen, Berhren oder Innerhalb voneinander sind. Es hngt von Ihren individuellen
Fragestellungen ab welche Topologieregel Sie auf Ihre Vektordaten anwenden (z.B. werden Sie normalerweise
keine Overshoots in Linienlayer akzeptieren, aber wenn Sie Sackgassen darstellen werden Sie sie nicht aus Ihrem
Vektorlayer entfernen).
QGIS besitzt eine eingebaute Bearbeitungsfunktion, die toll fr das Erstellen neuer Objekte ohne Fehler ist. Aber
Datenfehler und benutzergemachte Fehler sind schwierig zu finden. Diese Erweiterung hilft Ihnen solche Fehler
anhand einer Liste von Regeln zu finden.
Es ist sehr einfach Topologieregeln mit dem Topologie-Prfung Plugin zu erstellen.
Fr Punktlayer stehen die folgenden Regeln zu Verfgung:
Must be covered by: Hier knnen Sie einen Vektorlayer aus Ihrem Projekt auswhlen. Punkte die nicht
vom vorgegebenen Vektorlayer abgedeckt sind erscheinen im Fehler Feld.
Must be covered by endpoints of: Hier knnen Sie einen Linienlayer aus Ihrem Projekt auswhlen.
Must be inside: Hier knnen Sie einen Polygonlayer aus Ihrem Projekt auswhlen. Die Punkte mssen
innerhalb eines Ploygons sein. Andernfalls schreibt QGIS einen Fehler fr den Punkt.
Must not have duplicates: Wann immer ein Punkt zweifach oder mehr reprsentiert wird erscheint dies im
Fehler Feld.
Must not have invalid geometries: berprft ob die Geometrien gltig sind.
Must not have multi-part-geometries: Alle Mulit-Part Punkte werden in das Fehler Feld geschrieben.
Fr Linienlayer stehen die folgenden Regeln zur Verfgung:
End points must be covered by: Hier knnen Sie einen Punktlayer aus Ihrem Projekt auswhlen.
Must not have dangles: Dies zeigt die Overshoots in Ihrem Linienlayer.
Must not have duplicates: Wann immer ein Objekt zweimal oder mehr reprsentiert wird erscheint dies im
Fehler Feld.
Must not have invalid geometries: berprft ob die Geometrien gltig sind.
Must not have multi-part geometries: Manchmal ist eine Geometrie eigentlich eine Sammlung von einfachen (single-part) Geometrien. Solch eine Geometrie wird Mulit-Part Geometrie genannt. Wenn es nur
einen Typ von einfacher Geometrie enthlt nennen wir dies Multi-Point, Multi-Linestring oder MultiPolygon. Alle Multi-Part Linien werden in das Fehler Feld geschrieben.
Must not have pseudos: Ein Liniengeometrie-Endpunkt sollte mit den Endpunkten von zwei anderen Geometrien verbunden sein. Wenn der Endpunkt nur mit einem anderen Endpunkt verbunden ist, wird der
Endpunkt ein Pseudonode genannt.
Fr Polygonlayer stehen die folgenden Regeln zu Verfgung:
Must contain: Polygonlayer mssen mindestens eine Punktgeometrie von einem zweiten Layer enthalten.
Must not have duplicates: Polygonlayer aus dem gleichen Layer drfen keine indentischen Geomtrie
haben. Wann immer ein Polygonobjekt zweimal oder mehr reprsentiert wird, erscheint dies im Fehler
Feld.
Must not have gaps: Aneinander hngende Polygon drfen keine Lcher zwischeneinander bilden. Als
Beispiel knnen hier administrative Grenzen genannt werden (US Staaten Polygone haben keine Lcher
zwischeneinander ...).
Must not have invalid geometries: berprft ob die Geometrien gltig sind. Einige der Regeln, die eine
gltige Geometrie definieren sind:
Polygonringe mssen geschlossen sein.
Ringe, die Lcher definieren, sollten innerhalb von Ringen sein, die uere Grenzen definieren.
Ringe knnen sich nicht schneiden (sie drfen sich weder berhren noch kreuzen).

728

Kapitel 20. Erweiterungen

QGIS User Guide, Release 2.6

Ringe drfen keine anderen Ringe berhren, es sei denn an einem Punkt.
Must not have multi-part geometries: Manchmal ist eine Geometrie eigentlich eine Sammlung von einfachen (single-part) Geometrien. Solch eine Geometrie wird Mulit-Part Geometrie genannt. Wenn es nur
einen Typ von einfacher Geometrie enthlt nennen wir dies Multi-Point, Multi-Linestring oder MultiPolygon.
Must not overlap: Aneinanderhngende Polygone sollten keine gemeinsame Flche bilden.
Must not overlap with: Aneinanderhngende Polygone aus einem Layer sollten keine gemeinsame Flche
mit Polygonen eines anderen Layers bilden.
.

20.21 Zonenstatistikerweiterung
Zonenstatistikerweiterung
knnen Sie das Ergebnis einer thematischen Klassifikation analysieren. Es erMit der
mgicht, verschiedene, descriptive statitische Werte von Rasterpixeln innerhalb von Flchen eines Vektorlayers
zu berechnen (see figure_zonal_statistics). Sie knnen Summe, Mittelwert und die Anzahl der Pixel innerhalb der
einzelnen Flchen berechnen. Das Plugin erstellt fr jeden zu berechnenden Wert eine Attributspalte, die man mit
einem Prfix definieren kann.

Abbildung 20.34: Zonenstatistik Dialog (KDE)


.

20.21. Zonenstatistikerweiterung

729

QGIS User Guide, Release 2.6

730

Kapitel 20. Erweiterungen

KAPITEL 21

Hilfe und Support

21.1 Mailinglisten
QGIS wird immer weiterentwickelt und wird nicht immer so funktionieren wie Sie es erwarten. Der beste Weg
Hilfe zu bekommen ist sich in die qgis-users Mailingliste einzutragen. Ihre Fragen werden ein breiteres Publikumt
erreichen und die Antworten werden anderen ntzen.

21.1.1 qgis-users
Diese Mailingliste wird dazu benutzt um QGIS allgemein zu diskutieren und auch fr gezielte Fragen zur Installation und Benutzung. Sie knnen sich in die qgis-users Mailingliste eintragen indem Sie die folgende URL
besuchen: http://lists.osgeo.org/mailman/listinfo/qgis-user

21.1.2 fossgis-talk-liste
Fr das deutschsprachige Publikum bietet der deutsche FOSSGIS e.V. die fossgis-talk-liste Mailingliste.
Diese Mailingliste wird dazu benutzt um Open Source GIS im allgemeinen, darunter QGIS, zu diskutieren. Sie knnen sich in die fossgis-talk-liste Mailingliste eintragen wenn Sie die folgende URL whlen:
https://lists.fossgis.de/mailman/listinfo/fossgis-talk-liste

21.1.3 qgis-developer
Wenn Sie ein Entwickler sind und technische Probleme haben, knnen Sie sich in die qgis-developer Mailingliste
eintragen unter der URL: http://lists.osgeo.org/mailman/listinfo/qgis-developer

21.1.4 qgis-commit
Jedes mal wenn ein Commit im QGIS Code Repository gemacht wurde wird eine Email an diese Liste gesendet.
Wenn Sie ber jede nderung zum aktuellen Code Base aufgeklrt werden wollen, knnen Sie sich in diese Liste
eintragen: http://lists.osgeo.org/mailman/listinfo/qgis-commit

21.1.5 qgis-trac
Diese Mailingliste stellt Nachrichten in Bezug auf das Projekt Management bereit. Dazu gehren Fehlerberichte,
Aufgaben und Anfragen fr neue Funktionen. Sie knnen sich fr diese Mailingliste eintragen unter der URL:
http://lists.osgeo.org/mailman/listinfo/qgis-trac

731

QGIS User Guide, Release 2.6

21.1.6 qgis-community-team
Diese Liste befasst sich mit Themen wie Dokumentation, Kontexthilfe, Benutzerhandbuch, Webseiten, Blog, Mailinglisten, Foren und bersetzungen. Wenn Sie auch an dem Benutzerhandbuch arbeiten wollen ist diese Liste
eine gute Mglichkeit um Fragen zu stellen. Sie knnen sich unter http://lists.osgeo.org/mailman/listinfo/qgiscommunity-team in die Liste eintragen.

21.1.7 qgis-release-team
Diese Liste befasst sich mit Themen wie der Verffentlichung von QGIS , Binrpaketen fr zahlreiche Betriebssysteme und der Ankndigung von neuen Erscheinungen an die ganze Welt. Sie knnen sich unter
http://lists.osgeo.org/mailman/listinfo/qgis-release-team in die Liste eintragen.

21.1.8 qgis-tr
Diese Liste beschftigt sich mit der bersetzung der QGIS GUI und der Dokumentation. Sie knnen sich fr diese
Mailingliste eintragen unter der URL: http://lists.osgeo.org/mailman/listinfo/qgis-tr

21.1.9 qgis-edu
Diese Liste befasst sich mit der Umsetzung des QGIS Education Projektes. Wenn Sie mit an den QGIS
Education Materialien arbeiten wollen knnen Sie hier mit Ihren Fragen anfangen. Sie knnen sich unter
http://lists.osgeo.org/mailman/listinfo/qgis-edu in die Liste eintragen.

21.1.10 qgis-psc
Diese Liste wird dazu benutzt Themen zu diskutieren die den Lenkungsausschu betreffen, also Fragen zum
bergreifenden Management und zur Leitung. Sie knnen sich unter http://lists.osgeo.org/mailman/listinfo/qgispsc in die Liste eintragen.
Wir heien Sie herzlich Willkommen, sich auf jeder dieser Listen einzuschreiben und den anderen QGIS Benutzern und Entwicklern mit ihrer Erfahrung zu helfen. Beachten Sie bitte auch, dass die Mailinglisten qgiscommit und qgis-trac nur dazu erstellt wurden, um Benachrichtigungen zu verteilen und nicht fr Anwenderfragen
geeignet ist.

21.2 IRC
Wir sind auerdem im IRC prsent - Sie knnen uns im #qgis Kanal unter irc.freenode.net treffen. Bitte warten
Sie ein wenig auf Antworten, da die meisten nur zwischendurch mal vorbeischauen, was gerade so passiert. Wenn
Sie eine Diskussion im IRC verpasst haben - kein Problem ! Wir loggen alle Diskussionen, damit Sie diese auch
spter lesen knnen. Lesen die Logs unter der URL: http://qgis.org/irclogs .
Kommerzieller
Support
ist
auch
mglich.
http://www.qgis.org/de/kommerzieller-support.html.

Schauen

Sie

dazu

auf

die

Internetseite

21.3 BugTracker
Whrend die qgis-users Mailingliste ntzlich ist, wenn es um allgemeine Fragen zu wie mache ich dies oder jenes
in QGIS geht, mchten Sie uns vielleicht auch auf richtige Fehler (Bugs) aufmerksam machen. Sie knnen dazu
Fehlermeldungen mit Hilfe des QGIS BugTracker unter http://hub.qgis.org/projects/quantum-gis/issues erstellen.
Wenn Sie ein neues Ticket fr einen Fehler erstellen, geben Sie bitte auch eine Emailadresse an, ber die wir
weitere Informationen von Ihnen erfragen knnen.

732

Kapitel 21. Hilfe und Support

QGIS User Guide, Release 2.6

Denken Sie auch bitte daran, dass ein fr Sie wichtiger Fehler nicht immer die gleiche Prioritt bei anderen
Personen und besonders den Entwicklern hat. Einige Fehler sind sehr aufwendig zu reparieren und daher kann es
schon mal ein wenig dauern, bis gengend Zeit vorhanden ist, ein Problem zu lsen.
Anfragen fr neue Funktionen knnen auch in demselben System gestellt werden. Bitte geben Sie dann den Typ
Feature an.
Wenn Sie einen Fehler gefunden haben und selbst repariert haben knnen Sie diesen auch als Patch schicken.
Dafr hat das schne Redmine Ticketsystem unter http://hub.qgis.org/wiki/quantum-gis/issues wiederum einen
Typ dafr. Kreuzen Sie das Patch supplied Kontrollkstchen an und hngen Sie Ihren Patch an bevor Sie
Ihren Fehler einreichen. Einer der Entwickler wird sich den Patch anschauen und ihn auf QGIS anwenden. Bitte
seien Sie nicht beunruhigt wenn Ihr Patch nicht gleich angewendet wird - die Entwickler sind dann mit anderen
Aufgaben beschftigt.

21.4 Blog
Die QGIS-Gemeinschaft stellt auch einen Weblog (BLOG) unter http://planet.qgis.org/planet/ bereit, mit vielen
interessanten Artikeln fr Anwender und Entwickler zum Thema QGIS. Es handelt sich dabei um eine Sammlung verschiedener Blogs zum Thema QGIS. Sie sind natrlich herzlich eingeladen, ihren eigenen QGIS Blog zu
integrieren !

21.5 Plugins
Die Internetseite http://plugins.qgis.org stellt das offizielle QGIS Plugin Webportal dar. Hier finden Sie eine Liste
mit allen stabilen und experimentellen QGIS Plugins, die ber das Official QGIS Plugin Repository zur Verfgung stehen.

21.6 Wiki
Schlielich gibt es auch ein QGIS WIKI unter http://hub.qgis.org/projects/quantum-gis/wiki , wo Sie eine Vielzahl
ntzlicher Informationen ber die QGIS-Entwicklung, Plne fr neue Versionen, Links zum Herunterladen von
Daten oder zu vorhandenen bersetzungen finden. Schauen Sie mal rein, da gibt es ein paar wirkliche Attraktionen!
.

21.4. Blog

733

QGIS User Guide, Release 2.6

734

Kapitel 21. Hilfe und Support

KAPITEL 22

Anhang

22.1 GNU General Public License


Deutsche bersetzung der Version 2, Juni 1991. Den offiziellen englischen Originaltext finden Sie unter
http://www.gnu.org/licenses/gpl.html. Diese bersetzung wird mit der Absicht angeboten, das Verstndnis der
GNU General Public License (GNU GPL) zu erleichtern. Es handelt sich jedoch nicht um eine offizielle oder im
rechtlichen Sinne anerkannte bersetzung. Diese bersetzung wurde ursprnglich erstellt von Katja Lachmann.
bersetzungen im Auftrag der S.u.S.E. GmbH - http://www.suse.de. Sie wurde berarbeitet von Peter Gerwinski,
G-N-U GmbH - http://www.g-n-u.de (31. Oktober 1996, 4. Juni 2000)
Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place - Suite 330, Boston, MA 02111-1307,
USA
Es ist jedermann gestattet, diese Lizenzurkunde zu vervielfltigen und unvernderte Kopien zu verbreiten; nderungen sind jedoch nicht erlaubt.
Vorwort
Die meisten Softwarelizenzen sind daraufhin entworfen worden, Ihnen die Freiheit zu nehmen, die Software weiterzugeben und zu verndern. Im Gegensatz dazu soll Ihnen die GNU General Public License, die Allgemeine ffentliche GNU-Lizenz, ebendiese Freiheit garantieren. Sie soll sicherstellen, da die Software fr alle Benutzer frei
ist. Diese Lizenz gilt fr den Groteil der von der Free Software Foundation herausgegebenen Software und fr alle
anderen Programme, deren Autoren ihr Werk dieser Lizenz unterstellt haben. Auch Sie knnen diese Mglichkeit
der Lizenzierung fr Ihre Programme anwenden. (Ein anderer Teil der Software der Free Software Foundation
unterliegt stattdessen der GNU Lesser General Public License, der Kleineren Allgemeinen ffentlichen GNULizenz).
Die Bezeichnung freie Software bezieht sich auf Freiheit, nicht auf den Preis. Unsere Lizenzen sollen Ihnen die
Freiheit garantieren, Kopien freier Software zu verbreiten (und etwas fr diesen Service zu berechnen, wenn Sie
mchten), die Mglichkeit, die Software im Quelltext zu erhalten oder den Quelltext auf Wunsch zu bekommen.
Die Lizenzen sollen garantieren, da Sie die Software ndern oder Teile davon in neuen freien Programmen
verwenden drfen - und da Sie wissen, da Sie dies alles tun drfen.
Um Ihre Rechte zu schtzen, mssen wir Einschrnkungen machen, die es jedem verbieten, Ihnen diese Rechte zu
verweigern oder Sie aufzufordern, auf diese Rechte zu verzichten. Aus diesen Einschrnkungen folgen bestimmte
Verantwortlichkeiten fr Sie, wenn Sie Kopien der Software verbreiten oder sie verndern.
Beispielsweise mssen Sie den Empfngern alle Rechte gewhren, die Sie selbst haben, wenn Sie - kostenlos
oder gegen Bezahlung - Kopien eines solchen Programms verbreiten. Sie mssen sicherstellen, da auch die
Empfnger den Quelltext erhalten bzw. erhalten knnen. Und Sie mssen ihnen diese Bedingungen zeigen, damit
sie ihre Rechte kennen.
Wir schtzen Ihre Rechte in zwei Schritten: (1) Wir stellen die Software unter ein Urheberrecht (Copyright), und
(2) wir bieten Ihnen diese Lizenz an, die Ihnen das Recht gibt, die Software zu vervielfltigen, zu verbreiten
und/oder zu verndern.
Um die Autoren und uns zu schtzen, wollen wir darberhinaus sicherstellen, da jeder erfhrt, da fr diese
freie Software keinerlei Garantie besteht. Wenn die Software von jemand anderem modifiziert und weitergegeben

735

QGIS User Guide, Release 2.6

wird, mchten wir, da die Empfnger wissen, da sie nicht das Original erhalten haben, damit irgendwelche von
anderen verursachte Probleme nicht den Ruf des ursprnglichen Autors schdigen.
Schlielich und endlich ist jedes freie Programm permanent durch Software-Patente bedroht. Wir mchten die
Gefahr ausschlieen, da Distributoren eines freien Programms individuell Patente lizensieren - mit dem Ergebnis,
da das Programm proprietr wrde. Um dies zu verhindern, haben wir klargestellt, da jedes Patent entweder fr
freie Benutzung durch jedermann lizenziert werden mu oder berhaupt nicht lizenziert werden darf.
Es folgen die genauen Bedingungen fr die Vervielfltigung, Verbreitung und Bearbeitung
0. Diese Lizenz gilt fr jedes Programm und jedes andere Werk, in dem ein entsprechender Vermerk des
Copyright-Inhabers darauf hinweist, da das Werk unter den Bestimmungen dieser General Public License
verbreitet werden darf. Im folgenden wird jedes derartige Programm oder Werk als das Programm bezeichnet; die Formulierung auf dem Programm basierendes Werk bezeichnet das Programm sowie jegliche
Bearbeitung des Programms im urheberrechtlichen Sinne, also ein Werk, welches das Programm, auch
auszugsweise, sei es unverndert oder verndert und/oder in eine andere Sprache bersetzt, enthlt. (Im folgenden wird die bersetzung ohne Einschrnkung als Bearbeitung eingestuft.) Jeder Lizenznehmer wird
im folgenden als Sie angesprochen.
Andere Handlungen als Vervielfltigung, Verbreitung und Bearbeitung werden von dieser Lizenz nicht
berhrt; sie fallen nicht in ihren Anwendungsbereich. Der Vorgang der Ausfhrung des Programms wird
nicht eingeschrnkt, und die Ausgaben des Programms unterliegen dieser Lizenz nur, wenn der Inhalt ein
auf dem Programm basierendes Werk darstellt (unabhngig davon, da die Ausgabe durch die Ausfhrung
des Programmes erfolgte). Ob dies zutrifft, hngt von den Funktionen des Programms ab.
1. Sie drfen auf beliebigen Medien unvernderte Kopien des Quelltextes des Programms, wie sie ihn erhalten
haben, anfertigen und verbreiten. Voraussetzung hierfr ist, da Sie mit jeder Kopie einen entsprechenden
Copyright-Vermerk sowie einen Haftungsausschlu verffentlichen, alle Vermerke, die sich auf diese Lizenz
und das Fehlen einer Garantie beziehen, unverndert lassen und desweiteren allen anderen Empfngern des
Programms zusammen mit dem Programm eine Kopie dieser Lizenz zukommen lassen.
Sie drfen fr den eigentlichen Kopiervorgang eine Gebhr verlangen. Wenn Sie es wnschen, drfen Sie
auch gegen Entgelt eine Garantie fr das Programm anbieten.
2. Sie drfen Ihre Kopie(n) des Programms oder eines Teils davon verndern, wodurch ein auf dem Programm
basierendes Werk entsteht; Sie drfen derartige Bearbeitungen unter den Bestimmungen von Paragraph
1 vervielfltigen und verbreiten, vorausgesetzt, da zustzlich alle im folgenden genannten Bedingungen
erfllt werden:
(a) Sie mssen die vernderten Dateien mit einem aufflligen Vermerk versehen, der auf die von Ihnen
vorgenommene Modifizierung und das Datum jeder nderung hinweist.
(b) Sie mssen dafr sorgen, da jede von Ihnen verbreitete oder verffentlichte Arbeit, die ganz oder
teilweise von dem Programm oder Teilen davon abgeleitet ist, Dritten gegenber als Ganzes unter den
Bedingungen dieser Lizenz ohne Lizenzgebhren zur Verfgung gestellt wird.
(c) Wenn das vernderte Programm normalerweise bei der Ausfhrung interaktiv Kommandos einliest,
mssen Sie dafr sorgen, da es, wenn es auf dem blichsten Wege fr solche interaktive Nutzung
gestartet wird, eine Meldung ausgibt oder ausdruckt, die einen geeigneten Copyright-Vermerk enthlt
sowie einen Hinweis, da es keine Gewhrleistung gibt (oder anderenfalls, da Sie Garantie leisten),
und da die Benutzer das Programm unter diesen Bedingungen weiter verbreiten drfen. Auch mu
der Benutzer darauf hingewiesen werden, wie er eine Kopie dieser Lizenz ansehen kann. (Ausnahme:
Wenn das Programm selbst interaktiv arbeitet, aber normalerweise keine derartige Meldung ausgibt,
mu Ihr auf dem Programm basierendes Werk auch keine solche Meldung ausgeben.)
Diese Anforderungen gelten fr das bearbeitete Werk als Ganzes. Wenn identifizierbare Teile des Werkes
nicht von dem Programm abgeleitet sind und vernnftigerweise als unabhngige und eigenstndige Werke
fr sich selbst zu betrachten sind, dann gelten diese Lizenz und ihre Bedingungen nicht fr die betroffenen
Teile, wenn Sie diese als eigenstndige Werke weitergeben. Wenn Sie jedoch dieselben Abschnitte als Teil
eines Ganzen weitergeben, das ein auf dem Programm basierendes Werk darstellt, dann mu die Weitergabe
des Ganzen nach den Bedingungen dieser Lizenz erfolgen, deren Bedingungen fr weitere Lizenznehmer
somit auf das gesamte Ganze ausgedehnt werden - und somit auf jeden einzelnen Teil, unabhngig vom
jeweiligen Autor.

736

Kapitel 22. Anhang

QGIS User Guide, Release 2.6

Somit ist es nicht die Absicht dieses Abschnittes, Rechte fr Werke in Anspruch zu nehmen oder Ihnen
die Rechte fr Werke streitig zu machen, die komplett von Ihnen geschrieben wurden; vielmehr ist es die
Absicht, die Rechte zur Kontrolle der Verbreitung von Werken, die auf dem Programm basieren oder unter
seiner auszugsweisen Verwendung zusammengestellt worden sind, auszuben.
Ferner bringt auch das einfache Zusammenlegen eines anderen Werkes, das nicht auf dem Programm basiert,
mit dem Programm oder einem auf dem Programm basierenden Werk auf ein- und demselben Speicher- oder
Vertriebsmedium dieses andere Werk nicht in den Anwendungsbereich dieser Lizenz.
3. Sie drfen das Programm (oder ein darauf basierendes Werk gem Paragraph 2) als Objectcode oder in ausfhrbarer Form unter den Bedingungen der Paragraphen 1 und 2 kopieren und weitergeben - vorausgesetzt,
da Sie auerdem eine der folgenden Leistungen erbringen:
(a) Liefern Sie das Programm zusammen mit dem vollstndigen zugehrigen maschinenlesbaren Quelltext auf einem fr den Datenaustausch blichen Medium aus, wobei die Verteilung unter den Bedingungen der Paragraphen 1 und 2 erfolgen mu. Oder,
(b) Liefern Sie das Programm zusammen mit einem mindestens drei Jahre lang gltigen schriftlichen
Angebot aus, jedem Dritten eine vollstndige maschinenlesbare Kopie des Quelltextes zur Verfgung
zu stellen - zu nicht hheren Kosten als denen, die durch den physikalischen Kopiervorgang anfallen -,
wobei der Quelltext unter den Bedingungen der Paragraphen 1 und 2 auf einem fr den Datenaustausch
blichen Medium weitergegeben wird. Oder,
(c) Liefern Sie das Programm zusammen mit dem schriftlichen Angebot der Zurverfgungstellung des
Quelltextes aus, das Sie selbst erhalten haben. (Diese Alternative ist nur fr nicht-kommerzielle Verbreitung zulssig und nur, wenn Sie das Programm als Objectcode oder in ausfhrbarer Form mit
einem entsprechenden Angebot gem Absatz b erhalten haben.)
Unter dem Quelltext eines Werkes wird diejenige Form des Werkes verstanden, die fr Bearbeitungen
vorzugsweise verwendet wird. Fr ein ausfhrbares Programm bedeutet der komplette Quelltext: Der
Quelltext aller im Programm enthaltenen Module einschlielich aller zugehrigen ModulschnittstellenDefinitionsdateien sowie der zur Compilation und Installation verwendeten Skripte. Als besondere Ausnahme jedoch braucht der verteilte Quelltext nichts von dem zu enthalten, was blicherweise (entweder als
Quelltext oder in binrer Form) zusammen mit den Hauptkomponenten des Betriebssystems (Kernel, Compiler usw.) geliefert wird, unter dem das Programm luft - es sei denn, diese Komponente selbst gehrt zum
ausfhrbaren Programm.
Wenn die Verbreitung eines ausfhrbaren Programms oder von Objectcode dadurch erfolgt, da der
Kopierzugriff auf eine dafr vorgesehene Stelle gewhrt wird, so gilt die Gewhrung eines gleichwertigen Zugriffs auf den Quelltext als Verbreitung des Quelltextes, auch wenn Dritte nicht dazu gezwungen
sind, den Quelltext zusammen mit dem Objectcode zu kopieren.
4. Sie drfen das Programm nicht vervielfltigen, verndern, weiter lizenzieren oder verbreiten, sofern es
nicht durch diese Lizenz ausdrcklich gestattet ist. Jeder anderweitige Versuch der Vervielfltigung, Modifizierung, Weiterlizenzierung und Verbreitung ist nichtig und beendet automatisch Ihre Rechte unter dieser
Lizenz. Jedoch werden die Lizenzen Dritter, die von Ihnen Kopien oder Rechte unter dieser Lizenz erhalten
haben, nicht beendet, solange diese die Lizenz voll anerkennen und befolgen.
5. Sie sind nicht verpflichtet, diese Lizenz anzunehmen, da Sie sie nicht unterzeichnet haben. Jedoch gibt
Ihnen nichts anderes die Erlaubnis, das Programm oder von ihm abgeleitete Werke zu verndern oder zu
verbreiten. Diese Handlungen sind gesetzlich verboten, wenn Sie diese Lizenz nicht anerkennen. Indem
Sie das Programm (oder ein darauf basierendes Werk) verndern oder verbreiten, erklren Sie Ihr Einverstndnis mit dieser Lizenz und mit allen ihren Bedingungen bezglich der Vervielfltigung, Verbreitung und
Vernderung des Programms oder eines darauf basierenden Werks.
6. Jedesmal, wenn Sie das Programm (oder ein auf dem Programm basierendes Werk) weitergeben, erhlt der
Empfnger automatisch vom ursprnglichen Lizenzgeber die Lizenz, das Programm entsprechend den hier
festgelegten Bestimmungen zu vervielfltigen, zu verbreiten und zu verndern. Sie drfen keine weiteren
Einschrnkungen der Durchsetzung der hierin zugestandenen Rechte des Empfngers vornehmen. Sie sind
nicht dafr verantwortlich, die Einhaltung dieser Lizenz durch Dritte durchzusetzen.
7. Sollten Ihnen infolge eines Gerichtsurteils, des Vorwurfs einer Patentverletzung oder aus einem anderen
Grunde (nicht auf Patentfragen begrenzt) Bedingungen (durch Gerichtsbeschlu, Vergleich oder anderweitig) auferlegt werden, die den Bedingungen dieser Lizenz widersprechen, so befreien Sie diese Umstnde
22.1. GNU General Public License

737

QGIS User Guide, Release 2.6

nicht von den Bestimmungen dieser Lizenz. Wenn es Ihnen nicht mglich ist, das Programm unter gleichzeitiger Beachtung der Bedingungen in dieser Lizenz und Ihrer anderweitigen Verpflichtungen zu verbreiten, dann drfen Sie als Folge das Programm berhaupt nicht verbreiten. Wenn zum Beispiel ein Patent
nicht die gebhrenfreie Weiterverbreitung des Programms durch diejenigen erlaubt, die das Programm direkt oder indirekt von Ihnen erhalten haben, dann besteht der einzige Weg, sowohl das Patentrecht als auch
diese Lizenz zu befolgen, darin, ganz auf die Verbreitung des Programms zu verzichten.
Sollte sich ein Teil dieses Paragraphen als ungltig oder unter bestimmten Umstnden nicht durchsetzbar
erweisen, so soll dieser Paragraph seinem Sinne nach angewandt werden; im brigen soll dieser Paragraph
als Ganzes gelten.
Zweck dieses Paragraphen ist nicht, Sie dazu zu bringen, irgendwelche Patente oder andere Eigentumsansprche zu verletzen oder die Gltigkeit solcher Ansprche zu bestreiten; dieser Paragraph hat einzig
den Zweck, die Integritt des Verbreitungssystems der freien Software zu schtzen, das durch die Praxis
ffentlicher Lizenzen verwirklicht wird. Viele Leute haben grozgige Beitrge zu dem groen Angebot
der mit diesem System verbreiteten Software im Vertrauen auf die konsistente Anwendung dieses Systems
geleistet; es liegt am Autor/Geber, zu entscheiden, ob er die Software mittels irgendeines anderen Systems
verbreiten will; ein Lizenznehmer hat auf diese Entscheidung keinen Einflu.
Dieser Paragraph ist dazu gedacht, deutlich klarzustellen, was als Konsequenz aus dem Rest dieser Lizenz
betrachtet wird.
8. Wenn die Verbreitung und/oder die Benutzung des Programms in bestimmten Staaten entweder durch
Patente oder durch urheberrechtlich geschtzte Schnittstellen eingeschrnkt ist, kann der Urheberrechtsinhaber, der das Programm unter diese Lizenz gestellt hat, eine explizite geographische Begrenzung der Verbreitung angeben, in der diese Staaten ausgeschlossen werden, so da die Verbreitung nur innerhalb und
zwischen den Staaten erlaubt ist, die nicht ausgeschlossen sind. In einem solchen Fall beinhaltet diese
Lizenz die Beschrnkung, als wre sie in diesem Text niedergeschrieben.
9. Die Free Software Foundation kann von Zeit zu Zeit berarbeitete und/oder neue Versionen der General
Public License verffentlichen. Solche neuen Versionen werden vom Grundprinzip her der gegenwrtigen
entsprechen, knnen aber im Detail abweichen, um neuen Problemen und Anforderungen gerecht zu werden.
Jede Version dieser Lizenz hat eine eindeutige Versionsnummer. Wenn in einem Programm angegeben wird,
da es dieser Lizenz in einer bestimmten Versionsnummer oder jeder spteren Version (any later version) unterliegt, so haben Sie die Wahl, entweder den Bestimmungen der genannten Version zu folgen oder
denen jeder beliebigen spteren Version, die von der Free Software Foundation verffentlicht wurde. Wenn
das Programm keine Versionsnummer angibt, knnen Sie eine beliebige Version whlen, die je von der Free
Software Foundation verffentlicht wurde.
10. Wenn Sie den Wunsch haben, Teile des Programms in anderen freien Programmen zu verwenden, deren
Bedingungen fr die Verbreitung anders sind, schreiben Sie an den Autor, um ihn um die Erlaubnis zu
bitten. Fr Software, die unter dem Copyright der Free Software Foundation steht, schreiben Sie an die
Free Software Foundation; wir machen zu diesem Zweck gelegentlich Ausnahmen. Unsere Entscheidung
wird von den beiden Zielen geleitet werden, zum einen den freien Status aller von unserer freien Software
abgeleiteten Werke zu erhalten und zum anderen das gemeinschaftliche Nutzen und Wiederverwenden von
Software im allgemeinen zu frdern.
Keine Gewhrleistung
11. Da das Programm ohne jegliche Kosten lizenziert wird, besteht keinerlei Gewhrleistung fr das Programm,
soweit dies gesetzlich zulssig ist. Sofern nicht anderweitig schriftlich besttigt, stellen die CopyrightInhaber und/oder Dritte das Programm so zur Verfgung, wie es ist, ohne irgendeine Gewhrleistung,
weder ausdrcklich noch implizit, einschlielich - aber nicht begrenzt auf - Marktreife oder Verwendbarkeit
fr einen bestimmten Zweck. Das volle Risiko bezglich Qualitt und Leistungsfhigkeit des Programms
liegt bei Ihnen. Sollte sich das Programm als fehlerhaft herausstellen, liegen die Kosten fr notwendigen
Service, Reparatur oder Korrektur bei Ihnen.
12. In keinem Fall, auer wenn durch geltendes Recht gefordert oder schriftlich zugesichert, ist irgendein
Copyright-Inhaber oder irgendein Dritter, der das Programm wie oben erlaubt modifiziert oder verbreitet
hat, Ihnen gegenber fr irgendwelche Schden haftbar, einschlielich jeglicher allgemeiner oder spezieller
Schden, Schden durch Seiteneffekte (Nebenwirkungen) oder Folgeschden, die aus der Benutzung des

738

Kapitel 22. Anhang

QGIS User Guide, Release 2.6

Programms oder der Unbenutzbarkeit des Programms folgen (einschlielich - aber nicht beschrnkt auf Datenverluste, fehlerhafte Verarbeitung von Daten, Verluste, die von Ihnen oder anderen getragen werden
mssen, oder dem Unvermgen des Programms, mit irgendeinem anderen Programm zusammenzuarbeiten),
selbst wenn ein Copyright-Inhaber oder Dritter ber die Mglichkeit solcher Schden unterrichtet worden
war.
QGIS Qt Ausnahme fr die GPL
Zustzlich, als eine besondere Ausnahme, gibt das QGIS Development Team das Recht, den Quellcode dieses Programms mit der Qt-Bibliothek, einschliesslich aber nicht begrenzt auf die folgenden
Versionen (frei und kommerziell): Qt/Non-commerical Windows, Qt/Windows, Qt/X11, Qt/Mac, und
Qt/Embedded (oder mit modifizierten Qt-Versionen, welche die gleiche Lizenz wie Qt nutzen) zu
verlinken und zu vertreiben. Fr jeglichen Quellcode ausser dem Qt-Quellcode, mssen Sie die GNU
General Public License in jeder Hinsicht befolgen. Wenn Sie diesen Text ndern, knnen Sie diese
Ausnahmen erweitern zu Ihrer Version dieses Textes, aber Sie sind dazu nicht verpflichtet. Wenn Sie
es nicht mchten, lschen Sie diese Ausnahme aus Ihrer Version.

22.2 GNU Free Documentation License


Dies ist eine inoffizielle bersetzung der GNU Free Documentation License (FDLv1.3) ins Deutsche.
Sie wurde nicht von der Free Software Foundation verffentlicht, und legt keine rechtsgltigen Bestimmungen zur Verteilung fr Dokumentation fest, welche die GNU FDL verwendet - nur der englische Originaltext der GNU FDL gewhrleistet dies. Dennoch hoffen wir, dass diese bersetzung
Deutsch sprechenden dazu verhilft, die GNU FDL besser zu verstehen
Copyright 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc
http://fsf.org/
Es ist jedermann gestattet, diese Lizenzurkunde zu vervielfltigen und unvernderte Kopien zu verbreiten; nderungen sind jedoch nicht erlaubt.
Einleitung
Der Zweck dieser Lizenz ist es, ein Handbuch, Fachbuch, oder ein anderes sachliches sowie ntzliches Dokument
frei im Sinne von Freiheit anzufertigen: um jedermann die wirkliche Freiheit zuzusichern, es zu kopieren und neu
zu verteilen, mit oder ohne Modifikation daran, entweder kommerziell oder nicht kommerziell. Zweitrangig erhlt
diese Lizenz fr den Autor und Herausgeber die Mglichkeit aufrecht, Anerkennung fr ihr Werk zu bekommen,
whrend Sie nicht als verantwortlich betrachtet werden frvorgenommene Modifikationen anderer.
Diese Lizenz ist eine Art Copyleft, was bedeutet, dass abgeleitete Werke des Dokuments ihrerseits im selben
Sinne frei sein mssen. Sie ergnzt die GNU General Public License, welche eine Copyleft-Lizenz darstellt, die
fr freie Software vorgesehen ist.
Wir haben diese Lizenz zur Verwendung fr Handbcher von freier Software konzipiert, da freie Software freie
Dokumentation bentigt: Ein freies Programm sollte mit Handbchern erhltlich sein, welche dieselben Freiheiten
zur Verfgung stellen wie es die Software tut. Doch diese Lizenz ist nicht auf Software-Handbcher beschrnkt;
sie kann fr jedes textliche Werk verwendet werden, unabhngig vom Thema oder ob es als ein gedrucktes Buch
verffentlicht wird. Wir empfehlen diese Lizenz vorwiegend fr Werke, deren Einsatzzweck Anleitung oder Referenz ist.
1. Anwendbarkeit und Definitionen
Diese Lizenz trifft auf jedes Handbuch oder sonstiges Werk zu, in beliebiger Form, das einen vom Urheberrechtsinhaber untergebrachten Hinweis mit den Worten enthlt, dass es unter den Bestimmungen dieser Lizenz
verteilt werden kann. Solch ein Hinweis gewhrt eine weltweite, vergtungsfreie Lizenz von unbefristeter Dauer,
um dieses Werk unter den hier festgelegten Bedingungen zu verwenden. Das Dokument, nachstehend, bezieht
sich auf jedes derartige Handbuch oder Werk. Jedes Mitglied der ffentlichkeit ist ein Lizenznehmer und wird als
Sie angesprochen. Sie akzeptieren die Lizenz, wenn Sie die Werke kopieren, modifizieren oder verteilen, was
gewissermaen unter dem Urheberrechtsgesetz die Erlaubnis erfordert.

22.2. GNU Free Documentation License

739

QGIS User Guide, Release 2.6

Eine modifizierte Version des Dokumentes bedeutet, dass jedes Werk das Dokument selbst oder einen Teil davon
beinhaltet, entweder unverndert kopiert, oder mit Modifikationen und/oder bersetzt in eine andere Sprache.
Ein untergeordneter Abschnitt ist ein benannter Anhang oder ein Titelei-Abschnitt des Dokuments, der sich
ausschlielich mit dem Verhltnis der Herausgeber oder Autoren des Dokuments zum Gesamtthema des Dokuments befasst (oder damit in Verbindung stehende Bewandtnisse), und nichts beinhaltet was direkt innerhalb des
Gesamtthemas fallen knnte. (Wenn das Dokument zu einem Fachbuch ber Mathematik gehrt, kann ein untergeordneter Abschnitt folglich nichts Mathematisches erlutern.) Die Beziehung knnte ein Anliegen mit historischer Verbindung zum Thema oder hnlicher Angelegenheiten, oder bezglich ihrer rechtlichen, kommerziellen,
philosophischen, ethischen oder politischen Position sein.
Die unvernderlichen Abschnitte sind bestimmte untergeordnete Abschnitte, deren Titel zum Beispiel in dem
Hinweis, der besagt, dass das Dokument unter dieser Lizenz freigegeben ist, als jene unvernderlichen Abschnitte
gekennzeichnet sind. Wenn ein Abschnitt nicht zur obigen Definition von untergeordnet passt, dann ist es nicht
erlaubt ihn als unvernderlich zu kennzeichnen. Das Dokument kann null unvernderliche Abschnitte enthalten.
Wenn das Dokument keine unvernderlichen Abschnitte kennzeichnet, dann gibt es keine.
Die Umschlagtexte sind bestimmte kurze Textpassagen die als vordere Umschlagtexte oder hintere Umschlagtexte in dem Hinweis, der besagt, dass das Dokument unter dieser Lizenz freigegeben ist, verzeichnet sind. Ein
vorderer Umschlagtext darf hchstens 5 Wrter lang sein, und ein hinterer Umschlagtext darf hchstens 25 Wrter
lang sein.
Eine transparente Kopie des Dokumentes bedeutet eine maschinenlesbare Kopie, in einem ansehnlichen Format, dessen Spezifikation fr die Allgemeinheit verfgbar ist, welches geeignet ist das Dokument unkompliziert
mit allgemeinen Texteditoren oder (fr aus Pixeln bestehende Bilder) allgemeinen Malprogrammen oder (fr
Zeichnungen) irgendeinem weit verbreiteten Zeicheneditor zu berarbeiten, und das geeignet ist zur Eingabe in
Textformatierer oder zur automatischen bersetzung in eine Variante von geeigneten Formaten zur Eingabe in
Textformatierer. Eine Kopie, erstellt in einem ansonsten transparenten Dateiformat, dessen Auszeichnung oder
fehlende Auszeichnung derart ausgestaltet wurde, um nachtrgliche Modifikation durch Leser zu behindern oder
zu verhindern, ist nicht transparent. Ein Bildformat ist nicht transparent, wenn es fr irgendeine betrchtliche
Menge von Text verwendet wird. Eine Kopie, die nicht transparent ist, wird undurchlssig genannt.
Beispiele von geeigneten Formaten fr transparente Kopien beinhalten einfachen ASCII ohne Auszeichnung, Texinfo Eingabeformat, LaTeX Eingabeformat, SGML oder XML unter Verwendung einer ffentlich zugnglichen
DTD, und standardkonformes einfaches HTML, PostScript oder PDF, vorgesehen fr humane Modifikation.
Beispiele fr transparente Bildformate beinhalten PNG, XCF und JPG. Undurchlssige Formate beinhalten proprietre Formate die nur mit proprietren Textverarbeitungssystemen gelesen und bearbeitet werden knnen, SGML
oder XML fr welche die DTD und/oder Bearbeitungswerkzeuge nicht allgemein verfgbar sind, und das maschinengenerierte HTML, PostScript oder PDF, erzeugt mit irgendwelchen Textverarbeitungssystemen, nur fr Ausgabezwecke.
Das Titelblatt bedeutet, fr ein gedrucktes Buch, das Titelblatt an sich zzgl. solcher nachfolgenden Seiten die
notwendig sind, die Lesbarkeit des Materials beizubehalten, wie von dieser Lizenz erfordert, um im Titelblatt zu
erscheinen. Fr Werke in Formaten, welche kein Titelblatt als solches haben, bedeutet Titelblatt der Text nahe
dem bedeutendsten Auftreten des Titels dieses Werkes, ausgehend vom Anfang des Textkrpers.
Der Herausgeber ist jede Person oder Instanz, welche Kopien des Dokuments an die ffentlichkeit verteilt.
Ein Abschnitt Mit dem Titel XYZ bedeutet eine benannte Untereinheit des Dokuments, dessen Titel entweder
genau XYZ ist, oder XYZ in runden Klammern, gefolgt von Text, welcher XYZ in eine andere Sprache bersetzt.
(Hier steht XYZ fr einen spezifischen Abschnittsnamen, weiter unten erwhnt, wie zum Beispiel Danksagungen, Widmungen, Befrwortungen oder Verlauf.) Den Titel eines solchen Abschnitts zu erhalten, wenn
Sie das Dokument modifizieren, bedeutet, dass dieser ein Abschnitt Mit dem Titel XYZ gem seiner Definition
bleibt.
Das Dokument kann neben dem Hinweis, der festlegt, dass diese Lizenz auf das Dokument zutrifft, GarantieAusschlussklauseln beinhalten. Diese Garantie-Ausschlussklauseln werden als aufgenommen betrachtet, durch
Verweis in dieser Lizenz, aber nur was die Ausschlieung von Garantien betrifft: Jede andere Auswirkung, die
diese Garantie-Ausschlussklauseln haben knnen, ist ungltig und hat keine Wirkung auf die Bedeutung dieser
Lizenz.
2. Unvernderte Vervielfltigung

740

Kapitel 22. Anhang

QGIS User Guide, Release 2.6

Sie drfen das Dokument in beliebiger Form kopieren und verteilen, entweder kommerziell oder nicht kommerziell, vorausgesetzt, dass diese Lizenz, die Urheberrechtshinweise und der Lizenzhinweis mit den Worten,
dass diese Lizenz auf das Dokument zutrifft, in allen Kopien wiedergegeben werden, und dass Sie keine anderen
Bedingungen, welcher Art auch immer, zu jenen dieser Lizenz hinzufgen. Sie drfen keine technischen Manahmen anwenden die das Lesen oder weitere Vervielfltigung von den Kopien, die Sie erstellen oder verteilen,
behindern oder kontrollieren. Allerdings knnen Sie Bezahlung im Austausch fr Kopien entgegennehmen. Wenn
Sie eine ausreichend groe Anzahl von Kopien verteilen, mssen Sie auerdem die Bedingungen in Abschnitt 3
beachten.
Sie drfen auerdem Kopien verleihen, unter den selben, oben angegebenen Bedingungen, und Sie drfen Kopien
ffentlich auslegen.
3. Vervielfltigung grosser Mengen
Wenn Sie, mehr als 100 umfassend, gedruckte Kopien eines Dokuments verffentlichen (oder Kopien in Medien,
die blicherweise gedruckte Umschlge haben) und der Lizenzhinweis des Dokuments Umschlagtexte erfordert,
mssen Sie die Kopien in Umschlge beifgen, welche eindeutig und leserlich alle diese Umschlagtexte tragen: vordere Umschlagtexte auf vordere Umschlge, und hintere Umschlagtexte auf hintere Umschlge. Beide
Umschlge mssen, ebenso eindeutig und leserlich, Sie, als den Herausgeber dieser Kopien, identifizieren. Der
vordere Umschlag muss den vollstndigen Titel, mit allen Wrtern des Titels, in gleicher Weise auffallend und
leicht erkennbar darstellen. Sie drfen darber hinaus sonstiges Material auf die Umschlge anbringen. Vervielfltigung mit nderungen, begrenzt auf die Umschlge, sofern sie den Titel des Dokuments erhalten und diese Bedingungen erfllen, knnen ansonsten als unvernderte Vervielfltigung behandelt werden.
Wenn die erforderlichen Texte fr beide Umschlge zu umfangreich sind, um lesbar zu passen, sollten Sie die
ersten verzeichneten (so viele, um angemessen zu passen) auf den aktuellen Umschlag setzen, und den Rest auf
den nachfolgenden Seiten fortsetzen.
Wenn Sie, mehr als 100 umfassend, undurchlssige Kopien des Dokuments verffentlichen oder verteilen, mssen
Sie entweder eine maschinenlesbare transparente Kopie zusammen mit jeder undurchlssigen Kopie einbeziehen,
oder in bzw. mit jeder undurchlssigen Kopie eine Computer-Netzwerkadresse angeben, von welcher die allgemeine netzwerknutzende ffentlichkeit, unter Verwendung von Netzwerkprotokollen ffentlicher Standards,
Zugang hat, um eine vollstndig transparente Kopie, frei von hinzugefgtem Material, herunterzuladen. Falls Sie
die letzte Option verwenden, mssen Sie angemessen berlegte Schritte unternehmen, wenn Sie mit der Verteilung
von undurchlssigen Kopien in groen Mengen beginnen, um sicherzustellen, dass diese transparente Kopie unter
der angegebenen Adresse auf diese Weise zugnglich bleibt, bis mindestens ein Jahr nachdem Sie zum letzten
Mal eine undurchlssige Kopie (unmittelbar oder durch Ihre Vertreter oder Einzelhndler) in dieser Ausgabe an
die ffentlichkeit verteilen.
Es ist erwnscht, aber nicht erforderlich, dass Sie in Kontakt mit den Autoren des Dokuments treten, kurz bevor Sie
irgendeine groe Anzahl von Kopien neu verteilen, um ihnen die Mglichkeit zu geben, Sie mit einer aktualisierten
Version des Dokuments zu versorgen.
4. Modifikationen
Sie drfen eine modifizierte Version des Dokuments unter den oben erwhnten Bedingungen der Abschnitte 2 und
3 kopieren und verteilen, vorausgesetzt, dass Sie die modifizierte Version unter genau dieser Lizenz freigeben,
mit der modifizierten Version wird die Rolle des Dokuments besetzt, und somit der Lizenzierung von Verteilung
und Modifikation der modifizierten Version, fr jeden der eine Kopie davon besitzt. Zustzlich mssen Sie diese
Sachen in der modifizierten Version erledigen:
1. Verwenden Sie auf dem Titelblatt (und gegebenenfalls auf den Umschlgen) einen Titel der sich von dem des
Dokuments unterscheidet, und von jenen der vorhergehenden Versionen (die, wenn es irgendwelche gab, in
dem Verlaufs-Abschnitt des Dokuments verzeichnet sein sollten). Sie drfen denselben Titel wie den einer
vorhergehenden Version verwenden, wenn der ursprngliche Herausgeber dieser Version die Erlaubnis gibt.
2. Verzeichnen Sie auf dem Titelblatt, als Autoren, eine oder mehrere Personen oder Organe, verantwortlich
fr die Autorschaft der Modifikationen in der modifizierten Version, zusammen mit mindestens fnf der
Hauptautoren des Dokuments (alle seine Hauptautoren, wenn es weniger als fnf hat), es sei denn, dass sie
Sie von dieser Anforderung befreien.
3. Geben Sie auf dem Titelblatt den Namen des Herausgebers der modifizierten Version als den des Herausgebers an.

22.2. GNU Free Documentation License

741

QGIS User Guide, Release 2.6

4. Erhalten Sie alle Urheberrechtshinweise des Dokumentes.


5. Fgen Sie einen entsprechenden Urheberrechtshinweis fr Ihre Modifikationen, angrenzend zu den anderen
Urheberrechtshinweisen, hinzu.
6. Nehmen Sie, direkt nach den Urheberrechtshinweisen, einen Lizenzhinweis auf, der die ffentliche Erlaubnis gibt, die modifizierte Version unter den Bestimmungen dieser Lizenz zu verwenden, in der Form, wie
weiter unten im Anhang gezeigt.
7. Erhalten Sie in diesem Lizenzhinweis die vollstndigen Listen der unvernderlichen Abschnitte und erforderlichen Umschlagtexte, aufgefhrt in dem Lizenzhinweis des Dokuments.
8. Nehmen Sie eine ungenderte Kopie dieser Lizenz auf.
9. Erhalten Sie den Abschnitt mit dem Titel Verlauf, erhalten Sie seinen Titel und fgen Sie ihm einen Punkt
hinzu, der mindestens den Titel, das Jahr, neue Autoren und Herausgeber der modifizierte Version angibt,
wie auf dem Titelblatt aufgefhrt. Wenn es keinen Abschnitt Verlauf in dem Dokument gibt, erzeugen
Sie einen, der den Titel, das Jahr, die Autoren und Herausgeber des Dokuments angibt, wie auf seinem
Titelblatt aufgefhrt, dann fgen Sie einen Punkt hinzu, der die modifizierte Version beschreibt, wie in dem
vorhergehenden Satz angegeben.
10. Erhalten Sie gegebenenfalls die Netzwerkadresse, aufgefhrt in dem Dokument, fr den ffentlichen Zugang zu einer transparenten Kopie des Dokuments, und ebenso die in dem Dokument aufgefhrten Netzwerkadressen, fr vorhergehende Versionen, auf dem es beruht. Diese knnen in den Abschnitt Verlauf
untergebracht werden. Sie drfen eine Netzwerkadresse fr ein Werk auslassen, das mindestens vier Jahre
vor dem Dokument selbst verffentlicht wurde, oder der ursprngliche Herausgeber der Version, auf die es
sich bezieht, die Erlaubnis gibt.
11. Fr jeden Abschnitt mit dem Titel Danksagungen oder Widmungen, erhalten Sie den Titel des Abschnitts, und erhalten Sie in dem Abschnitt vollstndig den wesentlichen Gehalt und Umgangston der, von
jeglichen Mitwirkenden darin aufgefhrten, Danksagungen und/oder Widmungen.
12. Erhalten Sie alle unvernderlichen Abschnitte des Dokuments, ungendert in ihrem Text und ihren Titeln.
Abschnittsnummern oder Entsprechendes werden nicht als Teil der Abschnittstitel betrachtet.
13. Lschen Sie jeden Abschnitt mit dem Titel Befrwortungen. Solch ein Abschnitt darf nicht in die modifizierte Version aufgenommen werden.
14. Betiteln Sie keinen Titel eines vorhandenen Abschnitts neu, der mit Befrwortung betitelt ist oder in
Konflikt zum Titel irgendeines unvernderlichen Abschnitts steht.
15. Erhalten Sie jegliche Garantie-Ausschlussklauseln.
Wenn die modifizierte Version neue Titelei-Abschnitte oder Anhnge beinhaltet, die als untergeordnete Abschnitte
qualifiziert sind und kein kopiertes Material aus dem Dokument enthalten, knnen Sie Ihrer Wahl nach einige oder
alle diese Abschnitte als unvernderlich bestimmen. Um dies zu tun, fgen Sie ihre Titel zur Liste der unvernderlichen Abschnitte in den Lizenzhinweis der modifizierten Version hinzu. Diese Titel mssen sich von allen
anderen Abschnittstitel unterscheiden.
Sie knnen einen Abschnitt mit dem Titel Befrwortungen hinzufgen, vorausgesetzt, dass dieser nichts enthlt
als nur Befrwortungen Ihrer modifizierten Version durch verschiedene Parteien Beispiel Aussagen der Begutachtung oder dass der Text von einer Organisation als magebliche Definition eines Standards anerkannt worden
ist.
Sie knnen eine Textpassage von bis zu fnf Wrtern als einen vorderen Umschlagtext, und eine Textpassage
von bis zu 25 Wrtern als hinteren Umschlagtext in der modifizierten Version hinzufgen. Nur eine Textpassage
des vorderen Umschlagtextes und eine des hinteren Umschlagtextes kann von (oder durch, von ihr, angefertigte
Zusammenstellung) irgendeiner Person hinzugefgt werden. Wenn das Dokument bereits einen Umschlagtext
fr denselben Umschlag beinhaltet, zuvor von Ihnen hinzugefgt oder durch Zusammenstellung, angefertigt von
derselben Person, in dessen Namen Sie handeln, knnen Sie keinen weiteren hinzufgen; aber Sie drfen den alten
ersetzen, mit ausdrcklicher Erlaubnis des vorherigen Herausgebers, welcher den alten hinzufgte.
Der/die Autor(en) und Herausgeber des Dokuments geben durch diese Lizenz fr keine modifizierte Version die
Erlaubnis ihre Namen fr Werbung zu verwenden oder Befrwortung zu behaupten oder anzudeuten.
5. Dokumente kombinieren

742

Kapitel 22. Anhang

QGIS User Guide, Release 2.6

Sie drfen das Dokument mit anderen, unter dieser Lizenz freigegeben, Dokumenten kombinieren, unter den Bestimmungen, definiert in Abschnitt 4 fr modifizierte Versionen, vorausgesetzt, dass Sie in die Kombination alle
unvernderlichen Abschnitte aller Originaldokumente, nicht modifiziert, einbeziehen und sie alle als unvernderliche Abschnitte Ihres kombinierten Werkes in dessen Lizenzhinweis verzeichnen, und dass Sie alle ihre GarantieAusschlussklauseln erhalten.
Das kombinierte Werk muss nur eine Kopie dieser Lizenz enthalten, und mehrfach identische unvernderliche
Abschnitte knnen gegen eine einzelne Kopie ausgetauscht werden. Wenn es mehrfach identische unvernderliche Abschnitte mit demselben Namen, aber unterschiedlichem Inhalt gibt, erzeugen Sie den Titel eines jeden
solchen Abschnitts an seinem Ende eindeutig durch Hinzufgen, in runden Klammern, des Namens, falls bekannt, des ursprnglichen Autors oder Herausgebers dieses Abschnittes, oder andernfalls einer eindeutigen Nummer.
Nehmen Sie dieselbe Anpassung bei den Abschnittstiteln in der Liste von unvernderlichen Abschnitten in dem
Lizenzhinweis des kombinierten Werkes vor.
In der Kombination mssen Sie jegliche Abschnitte mit dem Titel Verlauf in den verschiedenen Originaldokumenten kombinieren und einen Abschnitt mit dem Titel Verlauf bilden; ebenso kombinieren Sie jegliche Abschnitte mit dem Titel Danksagungen, und jegliche Abschnitte mit dem Titel Widmungen. Sie mssen alle
Abschnitte mit dem Titel Befrwortungen lschen.
6. Sammlungen von Dokumenten
Sie drfen eine Sammlung erzeugen, bestehend aus dem Dokument und anderen Dokumenten, freigegeben unter
dieser Lizenz, und die Einzel-Kopien dieser Lizenz in den verschiedenen Dokumenten gegen eine einzelne Kopie,
die in die Sammlung aufgenommen wird, austauschen, vorausgesetzt, dass Sie die Regeln dieser Lizenz fr unvernderte Vervielfltigung jedes Dokuments in jeder anderen Hinsicht befolgen.
Sie drfen ein einzelnes Dokument aus solch einer Sammlung entnehmen, und es individuell unter dieser Lizenz
verteilen, vorausgesetzt, dass Sie eine Kopie dieser Lizenz in das extrahierte Dokument einfgen, und diese Lizenz
in jeder anderen Hinsicht, bezglich der unvernderten Vervielfltigung dieses Dokuments, befolgen.
7. Gruppierung mit unabhngigen Werken
Eine Zusammentragung des Dokuments oder seiner Ableitungen mit anderen gesonderten und unabhngigen
Dokumenten oder Werken, in oder zu einem Band auf einem Speicher- oder Verteilungsmedium, wird eine Gruppierung genannt, wenn das Urheberrecht, das sich aus der Zusammentragung ergibt, nicht verwendet wird, um
die gltigen Rechte der Benutzer dieser Zusammentragungen darber hinaus, was die Einzel-Werke gestatten, zu
beschrnken. Wenn das Dokument in eine Gruppierung aufgenommen ist, trifft diese Lizenz nicht auf die anderen
Werke in der Gruppierung zu, welche nicht selbst abgeleitete Werke des Dokuments sind.
Wenn die Anforderung fr Umschlagtext von Abschnitt 3 auf diese Kopien des Dokuments anwendbar ist, wenn
auerdem das Dokument weniger als eine Hlfte der gesamten Gruppierung darstellt, kann der Umschlagtext des
Dokuments auf Umschlge, die das Dokument innerhalb der Gruppierung einklammern, untergebracht werden,
oder der elektronischen Entsprechung von Umschlgen, wenn das Dokument in elektronischer Form vorliegt. Andernfalls mssen sie auf gedruckten Umschlgen vorkommen, welche die vollstndige Gruppierung einklammern.
8. bersetzung
bersetzung wird als eine Art von Modifikation betrachtet, also drfen Sie bersetzungen unter den Bestimmungen von Abschnitt 4 verteilen. Das Austauschen unvernderlicher Abschnitte mit bersetzungen erfordert
besondere Erlaubnis von ihren Urheberrechtsinhabern, aber Sie knnen bersetzungen von einigen oder allen unvernderlichen Abschnitten aufnehmen, zustzlich zu den Originalversionen dieser unvernderlichen Abschnitte.
Sie knnen eine bersetzung dieser Lizenz aufnehmen, und alle Lizenzhinweise in dem Dokument, und jegliche
Garantie-Ausschlussklauseln, vorausgesetzt, dass Sie auerdem die englische Originalversion dieser Lizenz und
die Originalversionen jener Hinweise und Ausschlussklauseln aufnehmen. Im Falle eines Widerspruchs zwischen
der bersetzung und der Originalversion dieser Lizenz oder eines Hinweises oder einer Ausschlussklausel, wird
sich die Originalversion durchsetzen.
Wenn ein Abschnitt in dem Dokument mit Danksagungen, Widmungen oder Verlauf betitelt ist, wird die
Anforderung (Abschnitt 4), seinen Titel (Abschnitt 1) zu erhalten, normalerweise die nderung des tatschlichen
Titels erfordern.
9. Schlussbestimmung
Sie drfen das Dokument nicht kopieren, modifizieren, unterlizenzieren oder verteilen, auer, als ausdrcklich

22.2. GNU Free Documentation License

743

QGIS User Guide, Release 2.6

unter dieser Lizenz zur Verfgung gestellt. Jeder andere Versuch es zu kopieren, zu modifizieren, zu unterlizenzieren oder zu verteilen ist ungltig, und wird automatisch Ihre Rechte unter dieser Lizenz aufkndigen.
Jedoch, wenn Sie jeglichen Versto gegen diese Lizenz beenden, dann ist ihre Lizenz eines bestimmten Urheberrechtsinhabers wieder (a) vorlufig, sofern und solange der Urheberrechtsinhaber nicht ihre Lizenz beendet,
und (b) dauerhaft, wenn der Urheberrechtsinhaber es versumt, Sie ber den Versto zu benachrichtigen, mit
angemessenen Mitteln, vorzeitig 60 Tage nach der Beendigung.
Darber hinaus ist Ihre Lizenz eines bestimmten Urheberrechtsinhabers wieder dauerhaft, wenn der Urheberrechtsinhaber Sie ber den Versto mit angemessenen Mitteln benachrichtigt, es das erste Mal ist, dass Sie eine
Benachrichtigung ber den Versto dieser Lizenz (fr jedes Werk) vom Urheberrechtsinhaber erhalten, und Sie
den Versto vorzeitig 30 Tage nach Erhalt der Benachrichtigung beseitigen.
Die Beendigung Ihrer Rechte unter diesem Abschnitt beendet nicht die Lizenzen der Parteien, welche Kopien oder
Rechte von Ihnen unter dieser Lizenz erhalten haben. Wenn Ihre Rechte aufgekndigt und nicht wieder dauerhaft
geworden sind, gibt Ihnen der Erhalt einer Kopie von Teilen oder Smtlichem des gleichen Materials keine Rechte,
diese zu verwenden.
10. Zuknftige berarbeitungen dieser Lizenz
Die Free Software Foundation kann von Zeit zu Zeit neue, berarbeitete Versionen der GNU-Lizenz fr freie
Dokumentation verffentlichen. Solche neuen Versionen werden im Geist zur gegenwrtigen Version gleich
sein, aber knnen sich im Detail unterscheiden, um neue Probleme oder Anliegen anzusprechen. Sehen Sie
http://www.gnu.org/copyleft/.
Jeder Version der Lizenz wird eine charakteristische Versionsnummer gegeben. Wenn das Dokument spezifiziert,
dass eine besonders nummerierte Version dieser Lizenz oder jede sptere Version auf sich zutrifft, haben Sie die
Wahl den Bestimmungen und Bedingungen entweder dieser spezifizierten Version oder jeder spteren Version, die
(nicht als Entwurf) durch die Free Software Foundation verffentlicht worden ist, zu folgen. Wenn das Dokument
spezifiziert, dass ein Bevollmchtigter entscheiden darf welche zuknftigen Versionen dieser Lizenz verwendet
werden knnen, berechtigt Sie das dauerhaft, durch die ffentliche Aussage desjenigen Bevollmchtigten ber die
Akzeptanz einer Version, diese Version fr das Dokument zu whlen.
11. Relizenzierung
Massive Multiauthor Collaboration Site (or MMC Site) meint jeglichen World Wide Web Server, welcher
urheberrechtsfhige Werke verffentlicht und ferner bedeutende Mglichkeiten fr jeden bietet, solche Werke
zu editieren. Ein ffentliches Wiki, welches jeder bearbeiten kann, ist ein Beispiel eines solchen Servers. Eine
Massives Multiautor Collaboration (oder MMC), enthalten im Standort, bedeutet jegliche Zusammenstellung
urheberrechtsfhiger Werke, die folglich auf dem MMC-Standort verffentlicht werden.
CC-BY-SA meint die Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Lizenz, verffentlicht von der Creative Commons Corporation, einem gemeinntzigen Unternehmen mit Hauptgeschftssitz in San Francisco, Californien, sowie zuknftige Copyleft-Versionen dieser Lizenz, welche durch
dieselbe Organisation verffentlicht wird.
Einbeziehen bedeutet, ein Dokument zu verffentlichen oder neu zu verffentlichen, ganz oder teilweise, als
Bestandteil eines anderen Dokuments.
Eine MMC ist geeignet zur Relizenzierung, wenn sie unter dieser Lizenz lizenziert wird, und wenn alle Werke,
die zuerst unter dieser Lizenz irgendwo anders als auf der MMC verffentlicht, und nachtrglich ganz oder teilweise in der MMC einbezogen wurden, (1) keine Umschlagtexte oder unvernderliche Abschnitte hatten, und (2)
folglich vor dem 1. November 2008 einbezogen wurden.
Betreiber eines MMC-Standortes kann eine MMC, enthalten im Standort unter CC-BY-SA des gleichen Standortes, jederzeit vor dem 1. August 2009 neu verffentlichen, vorausgesetzt, die MMC ist fr die Relizenzierung
geeignet.
Anhang: Wie Sie diese Lizenz fr Ihre Dokumente verwenden
Um diese Lizenz in einem Dokument, das Sie geschrieben haben, zu verwenden, nehmen Sie eine Kopie der
Lizenz in das Dokument auf und setzen Sie die folgenden Urheberrechts- und Lizenzhinweise unmittelbar hinter
das Titelblatt:
Copyright JAHR IHR NAME. Es wird die Erlaubnis gewhrt, dieses Dokument zu kopieren, zu
verteilen und/oder zu modifizieren, unter den Bestimmungen der GNU Free Documentation License,
744

Kapitel 22. Anhang

QGIS User Guide, Release 2.6

Version 1.3 oder jeder spteren Version, verffentlicht von der Free Software Foundation; ohne unvernderliche Abschnitte, ohne vordere Umschlagtexte und ohne hintere Umschlagtexte. Eine Kopie
der Lizenz wird im Abschnitt mit dem Titel GNU Free Documentation License bereitgestellt.
Wenn Sie unvernderliche Abschnitte, vordere Umschlagtexte und hintere Umschlagtexte haben, ersetzen Sie die
Zeile ohne ...Umschlagtexte. durch diese:
mit den unvernderlichen Abschnitten AUFGELISTET NACH TITELN, mit den vorderen Umschlagtexten AUFGELISTET und mit den hinteren Umschlagtexten AUFGELISTET.
Wenn Sie unvernderliche Abschnitte ohne Umschlagtexte haben oder eine andere Kombination der drei, vermischen Sie jene zwei Alternativen zu einer bereinstimmenden Situation.
Wenn Ihr Dokument nicht-triviale Beispiele eines Programmcodes enthlt, empfehlen wir, diese Beispiele
entsprechend unter einer freien Software-Lizenz ihrer Wahl, wie der GNU General Public License freizugeben,
um deren Verwendung in freier Software zu gestatten.
.

22.2. GNU Free Documentation License

745

QGIS User Guide, Release 2.6

746

Kapitel 22. Anhang

KAPITEL 23

Literatur und Internetreferenzen

GDAL-SOFTWARE-SUITE. Geospatial data abstraction library. http://www.gdal.org, 2013.


GRASS-PROJECT. Geographic ressource analysis support system. http://grass.osgeo.org , 2013.
NETELER, M., AND MITASOVA, H. Open source gis: A grass gis approach, 2008.
OGR-SOFTWARE-SUITE. Geospatial data abstraction library. http://www.gdal.org/ogr , 2013.
OPEN-GEOSPATIAL-CONSORTIUM.
http://portal.opengeospatial.org, 2002.

Web

map

service

(1.1.1)

implementation

specification.

OPEN-GEOSPATIAL-CONSORTIUM.
http://portal.opengeospatial.org, 2004.

Web

map

service

(1.3.0)

implementation

specification.

POSTGIS-PROJECT. Rumliche Untersttzung fr Postgresql. http://postgis.refractions.net/ , 2013.

747

QGIS User Guide, Release 2.6

748

Kapitel 23. Literatur und Internetreferenzen

Stichwortverzeichnis

%%, 105
Aktionen, 105
apache, 164
apache2, 164
Arc/Info_ASCII_Grid, 143
Arc/Info_Binary_Grid, 143
ArcInfo_Binary_Coverage, 68
Atlas_Generation, 675
Attribute von Objekten vereinen, 128
Attribute_Actions, 105
Attribute_Table, 665
Attribute_Table_Selection, 132
Attributtabelle, 132
Ausgabe als Bild speichern, 20
Avoid_Intersections_Of_Polygons, 120
Bearbeitungsstatus umschalten, 121
Beispielaktionen, 106
Beschriftung, 40
Beziehungen, 134
Browse_Maps, 63
Calculator_Field, 139
CAT, 155
Categorized_Renderer, 84
CGI, 164
Colliding_labels, 95
Color_interpolation , 147
color_Ramp, 80
colorBrewer, 80
Comma Separated Values, 68
Common_Gateway_Interface, 164
Compose_Maps, 643
Composer_Manager, 678
Composer_Template, 644
Contrast_enhancement , 147
Coordinate_Reference_System, 159
Create_Maps, 643
Create_New_Layers, 129
CRS, 159
CSV, 68, 123
Current_Edits, 122
Custom_color_Ramp, 80
Custom_CRS, 60

Darstellung anhalten, 34
Darstellungsqualitt, 35
Darstellungsupdate whrend der Wiedergabe, 35
Datum_transformation, 61
DB_Manager, 75
Debian_Squeeze, 164
default_CRS, 57
Derived_Fields, 139
Digitalisieren, 121
Diskret, 147
Displacement_plugin, 88
Dokumentation, 7
Drucken
Export_Map, 677
Druckzusammenstellung Schnelldruck, 20
eine Aktion zu definieren, 105
eine Shapedatei zu laden, 66
Elements_Alignment, 672
EPSG, 57
Equal_Interval, 86
Erdas Imagine, 143
Erweiterungen , 681
ESRI, 65
European_Petroleom_Search_Group, 57
Export_as_image, 677
Export_as_PDF, 677
Export_as_SVG, 677
Expressions, 112
Fangen, 118
Farbabbildung, 147
FastCGI, 164
Field_Calculator, 139
Field_Calculator_Functions, 113
Forschungswerkzeuge, 699
fTools Funktionen, 699
GDAL, 143
Georeferenzierwerkzeuge, 705
GeoTIFF, 143
GiST (Generalized Search Tree) Index, 74
Gitter
Grids
Map_Grid, 652

749

QGIS User Guide, Release 2.6

GML, 155
Gradient_color_Ramp, 80
Graduated_Renderer, 86
GRASS,
181,
siehe
Creating
new
tors;editing;creating a new layer
attribute linkage, 186
attribute storage, 186
category settings, 188
digitizing tools, 187
display results, 194, 196
region, 191
region display, 191
region editing, 191
snapping tolerance, 189
symbology settings, 189
table editing, 189
toolbox, 197
GRASS toolbox, 191
Browser, 199
customize, 201
GRASS Vektordatenmodell, 186
Hauptfenster, 21
Hilfe, 33
Histogramm, 151
HTML_Frame, 670
IGNF, 57
Import_Maps, 63
Institut_Geographique_National_de_France, 57
InteProxy, 162
Inverted_Polygon_Renderer, 91
join, 109
join layer, 109
Kartenbersicht, 45
KBS, 57
Knoten, 123
Koordinatenbezugssystem, 57
Layeranzeige kontrollieren, 33
Layersichtbarkeit, 29
Layout_Maps, 643
Legende, 29
Lesezeichen, 42
Lizenzurkunde, 735
loading_raster, 143
Mastab, 34
Mastab berechnen, 32
Mastabsabhngige Layerdarstellung, 34
Map_Legend, 657
Map_Navigation, 120
Map_Template, 644
MapInfo, 68
Mens, 22
Merge_Attributes_of_Selected_Features, 128
Merge_Selected_Features, 128

750

vec-

Messen, 35
Flchen, 35
Linienlnge, 35
Winkel, 35
Metadaten, 151
mit den Pfeiltasten verschieben, 32
MSSQL Spatial, 75
Multi_Band_Raster , 145
multipolygon, 127
Natural_Breaks_(Jenks), 86
New_GPX_Layer, 129, 131
New_Shapefile_Layer, 129
New_SpatiaLite_Layer, 129
New_Spatialite_Layer, 129
Node_Tool, 122
Non_Spatial_Attribute_Tables, 134
Objekte abfragen, 37
OGC, 155
OGR, 65
OGR Simple Feature Library, 65
ogr2ogr, 73
Open_Geospatial_Consortium, 155
OpenStreetMap, 70
Optionen in der Kommandozeile, 17
Oracle Spatial, 76
OSM, 70
pgsql2shp, 73
Picture_database, 656
Point_Displacement_Renderer, 88
PostGIS, 70
PostGIS rumlicher Index, 74
PostgreSQL, 70
Pretty_Breaks, 86
print_composer
tools, 643
Proj.4, 60
Proj4, 59
Proj4_text, 59
Projekte verschachteln, 43
Projektionen, 57
Proxy, 157
proxy-server, 157
Pyramiden, 150
QGIS_mapserver, 162
QGIS_Server, 164
QSpatiaLite, 75
Quantile, 86
Query_Builder, 137
Rumliche Lesezeichen
siehe Lesezeichen, 42
Raster, 143
Raster_Calculator, 152
Renderer_Categorized, 84
Renderer_Graduated, 86

Stichwortverzeichnis

QGIS User Guide, Release 2.6

Renderer_Point_Displacement, 88
Renderer_Single_Symbol, 84
Rendering_Mode, 648
Rendering_Rule-based, 88
Revert_Layout_Actions, 673
Ring-Polygone, 127
Rotate_Point_symbols, 128
Rotated_North_Arrow, 656
Rule-based_Rendering, 88
Scalebar
Map_Scalebar, 661
Search_Radius, 119
Secured_OGC_Authentication, 162
Select_using_Query, 139
SFS, 155
Shapedatei, 65
Shapefile_to_Postgis_Import_Tool, 725
Shared_Polygon_Boundaries, 120
shp2pgsql, 72
Single_Band_Raster , 145
Single_Symbol_Renderer, 84
SLD, 164
SLD/SE, 164
Snapping_On_Intersections, 120
Snapping_Tolerance, 118
Spatialite, 75
Spatialite_Manager, 75
SPIT, 725
Split_Features, 128
SQLite, 75
SRS, 159
ST_Shift_Longitude, 74
Sttzpunkt, 123
Sttzpunkte, 123
Symbolisierung, 94
Symbologie, 145

WMS, 155
WMS-C, 160
WMS_1.3.0, 162
WMS_client, 155
WMS_identify, 160
WMS_layer_transparency, 159
WMS_metadata, 161
WMS_properties, 161
WMS_tiles, 160
WMTS, 160
WMTS_client, 155
Work_with_Attribute_Table, 132
Zoom_In Zoom_Out, 120
Zoomen mit dem Mausrad, 31

Tastenkrzel, 33
Three_Band_Color_Raster, 145
Tiger_Format, 68
Topological_Editing, 120
Transparenz, 149
UK_National_Transfer_Format, 68
US_Census_Bureau, 68
Vektorlayer, der ber den Lngengrad 180 hinausgeht,
74
Verschieben, 120
WCS, 155, 163
Web Coverage Service, 163
Werkzeugleiste, 28
Werkzeugleisten gestalten, 28
WFS, 155, 163
WFS-T, 163
WFS_Transactional, 163
WKT, 57, 123

Stichwortverzeichnis

751

Das könnte Ihnen auch gefallen