comparison flys-backend/doc/documentation/de/importer-geodaesie.tex @ 3661:3ea5e835ecce

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

http://dive4elements.wald.intevation.org