annotate flys-backend/doc/shapeimporter/documentation.txt @ 3658:55c4b7442236

Initial checkin of documentation of the shape importer. flys-backend/trunk@5252 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Ingo Weinzierl <ingo.weinzierl@intevation.de>
date Thu, 23 Aug 2012 15:46:01 +0000
parents
children
rev   line source
3658
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
1 Geodaten Importer
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
2 =================
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
3 Der Geodaten Importer ist ein in Python geschriebenes Kommandozeilen Tool zum
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
4 Import von Shapefiles in eine Datenbank. Zum Lesen der Shapefiles und zum
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
5 Schreiben der Geodaten in die Datenbank wird GDAL verwendet. Zum Import in eine
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
6 Oracle Datenbank ist es erforderlich, dass GDAL und GDAL Python Bindungs mit
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
7 Oracle Unterstützung installiert sind. Weitere Details hierzu befinden sich im
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
8 Kapitel `Systemanforderungen` und `Installationsanleitung`.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
9 Der Importer kann mit einem Shellscript von der Kommandozeilen gestartet werden
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
10 (siehe Kapitel `Starten des Geodaten Importers`). Nach dem Start wird anhand der
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
11 Konfiguration festgestellt, welche Klassen von Shapefiles aus dem Dateisystem
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
12 importiert werden sollen. Für jede Klasse gibt es hierzu einen speziellen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
13 Parser, der die speziellen Attribute eines Shapefiles liest und in die ent-
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
14 sprechende Relation der Datenbank schreibt. Die Parser sind speziell auf das
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
15 Dateisystem der BfG ausgerichtet. So wird z.B. erwartet, dass die Shapefiles der
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
16 Gewässerachse im Ordner `Geodaesie/Flussachse+km` liegen. Weitere Informationen zu
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
17 den einzelnen Parsern sind dem nächsten Kapitel `Beschreibung der Parser` zu
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
18 entnehmen. Der Erfolg oder Misserfolg eines Shape-Imports wird je nach
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
19 Konfiguration im Logfile vermerkt. Folgende Einträge können dem Logfile
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
20 entnommen werden:
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
21
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
22 INFO: Inserted 4 features Gibt die Anzahl der erfolgreich importierten
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
23 Features an.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
24
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
25 INFO: Failed to create 2 features Gibt die Anzahl der Features an, die nicht
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
26 importiert werden konnten.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
27
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
28 INFO: Found 3 unsupported features Gibt die Anzahl der Features an, die
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
29 aufgrund ihres Datentyps nicht importiert
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
30 werden konnten. Z.B: es werden Linien
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
31 erwartet, im Shapefile sind jedoch
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
32 Polygone enthalten.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
33
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
34 ERROR: Unable to insert feature: $DETAIL Beim Lesen der Attribute eines
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
35 Features ist ein Fehler aufgetreten.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
36 Das Feature konnte nicht in die
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
37 Datenbank geschrieben werden.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
38
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
39 ERROR: Exception while committing transaction Beim Abschluss des
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
40 Schreib-Vorgangs in die
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
41 Datenbank ist ein unerwarteter
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
42 Fehler aufgetreten. Die
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
43 Features des Shapes sind
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
44 nicht importiert worden.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
45
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
46 Damit die Geodaten eines Shapes später eindeutig in der Datenbank identifiziert
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
47 werden können, wird für jede Geometrie der Pfad des Shapes im Dateisystem in
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
48 einer Spalte der Datenbank gespeichert. Anwendungen, die auf der Datenbank
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
49 aufbauen, können die Geodaten eines Shapefiles später anhand dieses Merkmals
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
50 gruppieren und anzeigen.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
51
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
52
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
53 Beschreibung der Parser
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
54 -----------------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
55 Wie im letzten Kapitel beschrieben, sind die Parser speziell an das Dateisystem
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
56 der BfG ausgerichtet. Im folgenden werden zu jedem Parser folgende Informationen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
57 angegeben:
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
58
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
59 Pfad Der Pfad, in dem die Shapefiles im Dateisystem abgelegt sein
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
60 müssen ausgehend vom Gewässer Verzeichnis.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
61
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
62 Geometrie Der Geometrie Typ, der für diese Klasse von Shapefiles
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
63 erwartet wird.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
64
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
65 Attribute Eine Liste der Attribute, die vom Parser aus dem Shape
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
66 gelesen werden.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
67
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
68
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
69 Achsen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
70 ------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
71 Pfad Geodaesie/Flussachse+km
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
72 Geometrie LINESTRING
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
73 Attribute name, kind
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
74
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
75
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
76 Hydrologische Grenzen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
77 ---------------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
78 Pfad Hydrologie/Hydr.Grenzen/Linien
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
79 Geometrie LINESTRING, POLYGON
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
80 Attribute name, kind
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
81
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
82
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
83 Bauwerke
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
84 --------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
85 Pfad Geodaesie/Bauwerke
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
86 Geometrie LINESTRING
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
87 Attribute name, Name, KWNAAM
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
88
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
89
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
90 Einzugsgebiete
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
91 --------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
92 Pfad Hydrologie/Einzugsgebiet
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
93 Geometrie POLYGON, MULTIPOLYGON
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
94 Attribute name, Name, AREA, area
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
95
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
96
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
97 Querprofilspuren
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
98 ----------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
99 Pfad Geodaesie/Querprofile
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
100 Geometrie LINESTRING
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
101 Attribute KILOMETER, KM, STATION, ELEVATION
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
102
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
103
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
104 Festpunkte
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
105 ----------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
106 Pfad Geodaesie/Festpunkte
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
107 Geometrie POINT
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
108 Attribute name, KM, ELBE_KM, X, Y, HPGP
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
109
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
110
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
111 Talaue
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
112 ------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
113 Pfad Hydrologie/Hydr.Grenzen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
114 Geometrie POLYGON, MULTIPOLYGON
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
115 Attribute name
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
116
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
117
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
118 Pegelstationen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
119 --------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
120 Pfad Hydrologie/Streckendaten
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
121 Geometrie POINT
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
122 Attribute Name, name, MPNAAM
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
123
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
124
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
125 Hochwasserschutzanlagen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
126 -----------------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
127 Pfad Hydrologie/HW-Schutzanlagen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
128 Geometrie LINESTRING
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
129 Attribute TYP, Bauart, Name, name
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
130
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
131
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
132 Kilometrierung
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
133 --------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
134 Pfad Geodaesie/Flussachse+km
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
135 Geometrie POINT
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
136 Attribute name, km, KM
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
137
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
138
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
139 Linien
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
140 ------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
141 Pfad Geodaesie/Linien
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
142 Geometrie LINESTRING, MULTILINESTRING
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
143 Attribute name, TYP, Z
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
144
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
145 Anmerkung: Wenn kein Attribut 'TYP' definiert ist, wird standardmäßig der
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
146 Wert 'DAMM' angenommen. Fehlt ein Attribut 'Z' wird als '9999' als Höhe
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
147 angenommen.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
148
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
149
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
150 Überschwemmungsfläche
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
151 ----------------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
152 Pfad Hydrologie/UeSG/Berechnung
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
153 Geometrie POLYGON, MULTIPOLYGON
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
154 Attribut name, diff, count, area, perimeter
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
155
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
156
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
157 Systemanforderungen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
158 -------------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
159 * Oracle Datenbank inkl. Schema für FLYS
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
160 * GDAL Binding für Python mit Oracle Support
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
161 * ogr2ogr
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
162 * Python >= 2.6
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
163
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
164
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
165 Installationsanleitung
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
166 ----------------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
167 * TODO: GDAL Binding installieren
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
168 * TODO: Python installieren
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
169 * TODO: ogr2ogr installieren
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
170
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
171
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
172 Konfiguration
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
173 -------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
174 Der Geodaten Importer kann über die Datei `contrib/shpimporter/run.sh`
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
175 konfiguriert werden. Öffnen Sie die Datei mit einem Texteditor Ihrer Wahl.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
176 In den Zeilen 4-9 werden Optionen definiert, die zwangsläufig angepasst
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
177 werden müssen:
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
178
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
179 RIVER_PATH Der Pfad zum Gewässer im Dateisystem.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
180 RIVER_ID Die Datenbank ID des zu importierenden Gewässers.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
181 TARGET_SRS Das EPSG Referenzsystem in das die Geodaten beim Import
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
182 projeziert werden sollen.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
183 HOST Der Host der Datenbank.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
184 USER Der Nutzer, der zum Verbinden zur Datenbank verwendet wird.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
185 PASS Das Passwort für USER zum Verbinden zur Datenbank.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
186
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
187 In den Zeilen 12-23 werden weitere Optionen definiert, die bei Bedarf angepasst
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
188 werden können. Falls nicht anders angegeben, können die Optionen mit den Werten
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
189 `0` und `1` belegt werden.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
190
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
191 VERBOSE Dieser Wert gibt die Granularität der Log-Ausgaben während des
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
192 Imports an. Je höher der Wert, desto mehr Informationen werden
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
193 in das Logfile geschrieben. Aktuell sind die Werte `0`, `1` und
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
194 `2` definiert. Wird der Wert `0` gesetzt, werden nur Fehler und
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
195 Warnungen in das Logfile geschrieben. Bei `1` werden neben
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
196 Fehlern und Warnungen auch Infos in das Logfile geschrieben. Bei
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
197 `2` werden sämtliche Ausgaben des Programms geschrieben. Dieser
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
198 Modus ist hauptsächlich für die Entwicklung gedacht.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
199
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
200 SKIP_AXIS Bei gesetztem Wert `1` werden keine Flussachsen importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
201 SKIP_KMS Bei gesetztem Wert `1` werden keine Kilometrierungen importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
202 SKIP_CROSSSECTIONS Bei gesetztem Wert `1` werden keine Querprofilespuren
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
203 importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
204 SKIP_LINES Bei gesetztem Wert `1` werden keine Linien importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
205 SKIP_FIXPOINTS Bei gesetztem Wert `1` werden keine Festpunkte importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
206 SKIP_BUILDINGS Bei gesetztem Wert `1` werden keine Bauwerke importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
207 SKIP_FLOODPLAINS Bei gesetztem Wert `1` werden keine Talauen importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
208 SKIP_HYDR_BOUNDARIES Bei gesetztem Wert `1` werden keine hydrologischen
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
209 Grenzen importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
210 SKIP_HWS Bei gesetztem Wert `1` werden keine
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
211 Hochwasserschutzanlagen importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
212 SKIP_GAUGE_LOCATION Bei gesetztem Wert `1` werden keine Pegelorte importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
213 SKIP_CATCHMENTS Bei gesetztem Wert `1` werden keine Einzugsgebiete importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
214 SKIP_UESG Bei gesetztem Wert `1` werden keine
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
215 Überschwemmungsflächen importiert.
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
216
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
217
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
218 Starten des Geodaten Importers
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
219 ------------------------------
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
220 Der Geodaten Importer wird mittels eines Shellskripts von einer Konsole
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
221 gestartet. Dazu wechseln Sie auf der Konsole in das Verzeichnis 'TODO' und
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
222 führen Sie folgenden Befehl aus:
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
223
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
224 $> sh contrib/shpimporter/run.sh > import.log
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
225
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
226 Der Importer wird nun gestartet. Sämtliche Log-Ausgaben werden in die Datei
55c4b7442236 Initial checkin of documentation of the shape importer.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
227 `import.log` geschrieben.

http://dive4elements.wald.intevation.org