Mercurial > dive4elements > river
comparison flys-backend/doc/documentation/de/importer-geodaesie.tex @ 3676:ae16bd95879e
Finalized geo part of importer documentation; set document revision and date.
flys-backend/trunk@5308 c6561f87-3c4e-4783-a992-168aeb5c3f6f
| author | Ingo Weinzierl <ingo.weinzierl@intevation.de> |
|---|---|
| date | Thu, 30 Aug 2012 08:59:50 +0000 |
| parents | 924055b11545 |
| children | 61a6d226b7a4 |
comparison
equal
deleted
inserted
replaced
| 3675:1785ec25930c | 3676:ae16bd95879e |
|---|---|
| 1 \section{Geodatenimport} | 1 \section{Geodatenimport} |
| 2 | 2 |
| 3 Der Geodaten Importer ist ein in Python geschriebenes Kommandozeilen Tool zum | 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 | 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 | 5 Schreiben der Geodaten in die Datenbank wird GDAL verwendet. Der Import in eine |
| 6 Oracle Datenbank ist es erforderlich, dass GDAL und GDAL Python Bindungs mit | 6 Oracle Datenbank erfordert, dass GDAL und GDAL Python Bindungs mit |
| 7 Oracle Unterstützung installiert sind. Weitere Details hierzu befinden sich im | 7 Oracle Unterstützung installiert sind. Weitere Details hierzu befinden sich im |
| 8 Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}. | 8 Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}. |
| 9 | 9 |
| 10 Der Importer kann mit einem Shellscript von der Kommandozeilen gestartet werden | 10 Der Importer kann mit einem Shellscript von der Kommandozeile gestartet werden |
| 11 (siehe Kapitel \ref{Starten des Geodaten Importers}). Nach dem Start wird anhand der | 11 (siehe Kapitel \ref{Starten des Geodaten Importers}). Nach dem Start wird anhand der |
| 12 Konfiguration festgestellt, welche Klassen von Shapefiles aus dem Dateisystem | 12 Konfiguration festgestellt, welche Klassen von Shapefiles aus dem Dateisystem |
| 13 importiert werden sollen. Für jede Klasse gibt es hierzu einen speziellen | 13 importiert werden sollen. Für jede Klasse gibt es einen speziellen |
| 14 Parser, der die speziellen Attribute eines Shapefiles liest und in die ent- | 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 | 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 | 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 | 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 | 18 den einzelnen Parsern sind dem nächsten Kapitel \ref{Beschreibung der Parser} zu |
| 52 | 52 |
| 53 \subsection{Beschreibung der Parser} | 53 \subsection{Beschreibung der Parser} |
| 54 \label{Beschreibung der Parser} | 54 \label{Beschreibung der Parser} |
| 55 | 55 |
| 56 Wie im letzten Kapitel beschrieben, sind die Parser speziell an das Dateisystem | 56 Wie im letzten Kapitel beschrieben, sind die Parser speziell an das Dateisystem |
| 57 der BfG ausgerichtet. Im folgenden werden zu jedem Parser folgende Informationen | 57 der BfG ausgerichtet. Im Folgenden werden zu jedem Parser folgende Informationen |
| 58 angegeben: | 58 angegeben: |
| 59 | 59 |
| 60 \textbf{Pfad} | 60 \textbf{Pfad} |
| 61 \\Der Pfad, in dem die Shapefiles im Dateisystem abgelegt sein müssen ausgehend | 61 \\Der Pfad, in dem die Shapefiles im Dateisystem abgelegt sein müssen ausgehend |
| 62 vom Gewässer Verzeichnis. | 62 vom Gewässer Verzeichnis. |
| 163 Pfad & Geodaesie/Linien \\ | 163 Pfad & Geodaesie/Linien \\ |
| 164 Geometrie & LINESTRING, MULTILINESTRING \\ | 164 Geometrie & LINESTRING, MULTILINESTRING \\ |
| 165 Attribute & name, TYP, Z \\ | 165 Attribute & name, TYP, Z \\ |
| 166 | 166 |
| 167 Anmerkung & Wenn kein Attribut 'TYP' definiert ist, wird standardmäßig der Wert \\ | 167 Anmerkung & Wenn kein Attribut 'TYP' definiert ist, wird standardmäßig der Wert \\ |
| 168 & 'DAMM' angenommen. Fehlt ein Attribut 'Z' wird als '9999' als Höhe \\ | 168 & 'DAMM' angenommen. Fehlt ein Attribut 'Z' wird '9999' als Höhe \\ |
| 169 & angenommen. \\ | 169 & angenommen. \\ |
| 170 \end{tabular} | 170 \end{tabular} |
| 171 | 171 |
| 172 | 172 |
| 173 \subsubsection{Überschwemmungsfläche} | 173 \subsubsection{Überschwemmungsfläche} |
| 199 | 199 |
| 200 \begin{lstlisting} | 200 \begin{lstlisting} |
| 201 zypper in python | 201 zypper in python |
| 202 \end{lstlisting} | 202 \end{lstlisting} |
| 203 | 203 |
| 204 \item \todo ogr2ogr installieren? | |
| 205 | |
| 206 \item \todo python-gdal; woher? | |
| 207 | |
| 208 \item Oracle Instantclient\\ | 204 \item Oracle Instantclient\\ |
| 209 Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python | 205 Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python |
| 210 und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es | 206 und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es |
| 211 erforderlich, folgende Archive von Oracle herunterzuladen: | 207 erforderlich, folgende Archive von Oracle herunterzuladen. Zu finden sind die |
| 208 folgenden Pakete unter\\ | |
| 209 \href{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html} | |
| 212 | 210 |
| 213 \begin{itemize} | 211 \begin{itemize} |
| 214 \item \todo URL zu instantclient-basic-linux-x86-64-11.2.0.2.0.zip | 212 \item instantclient-basic-linux-x86-64-11.2.0.2.0.zip |
| 215 \item \todo URL zu instantclient-sdk-linux-x86-64-11.2.0.2.0.zip | 213 \item instantclient-sdk-linux-x86-64-11.2.0.2.0.zip |
| 216 \item \todo URL zu instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip | 214 \item instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip |
| 217 \end{itemize} | 215 \end{itemize} |
| 218 | 216 |
| 219 Anschließend führen Sie folgende Befehle auf der Kommandozeile aus: | 217 Anschließend führen Sie folgende Befehle auf der Kommandozeile aus: |
| 220 | 218 |
| 221 \begin{lstlisting} | 219 \begin{lstlisting} |
| 319 | 317 |
| 320 \textbf{SKIP\_HWS} | 318 \textbf{SKIP\_HWS} |
| 321 \\Bei gesetztem Wert `1` werden kein Hochwasserschutzanlagen importiert. | 319 \\Bei gesetztem Wert `1` werden kein Hochwasserschutzanlagen importiert. |
| 322 | 320 |
| 323 \textbf{SKIP\_GAUGE\_LOCATION} | 321 \textbf{SKIP\_GAUGE\_LOCATION} |
| 324 \\Bei gesetztem Wert `1` werden keine Pegelort importiert. | 322 \\Bei gesetztem Wert `1` werden keine Pegelorte importiert. |
| 325 | 323 |
| 326 \textbf{SKIP\_CATCHMENTS} | 324 \textbf{SKIP\_CATCHMENTS} |
| 327 \\Bei gesetztem Wert `1` werden keine Einzugsgebiet importiert. | 325 \\Bei gesetztem Wert `1` werden keine Einzugsgebiete importiert. |
| 328 | 326 |
| 329 \textbf{SKIP\_UESG} | 327 \textbf{SKIP\_UESG} |
| 330 \\Bei gesetztem Wert `1` werden keine Überschwemmungsflächen importiert. | 328 \\Bei gesetztem Wert `1` werden keine Überschwemmungsflächen importiert. |
| 331 | 329 |
| 332 | 330 |
| 333 \subsection{Starten des Geodaten Importers} | 331 \subsection{Starten des Geodaten Importers} |
| 334 \label{Starten des Geodaten Importers} | 332 \label{Starten des Geodaten Importers} |
| 335 Der Geodaten Importer wird mittels eines Shellskripts von einer Konsole | 333 Der Geodaten Importer wird mittels eines Shellskripts von einer Konsole |
| 336 gestartet. Dazu wechseln Sie auf der Konsole in das Verzeichnis \todo und | 334 gestartet. Dazu führen Sie folgenden Befehl aus:\\ |
| 337 führen Sie folgenden Befehl aus:\\ | |
| 338 | 335 |
| 339 \begin{lstlisting} | 336 \begin{lstlisting} |
| 340 sh contrib/shpimporter/run.sh > import.log | 337 sh contrib/run_geo.sh > geo-import.log |
| 341 \end{lstlisting} | 338 \end{lstlisting} |
| 339 | |
| 342 Der Importer wird nun gestartet. Sämtliche Log-Ausgaben werden in die Datei | 340 Der Importer wird nun gestartet. Sämtliche Log-Ausgaben werden in die Datei |
| 343 $import.log$ geschrieben. | 341 $geo-import.log$ geschrieben. |
| 342 | |
| 343 \textbf{Hinweis} | |
| 344 \\Bitte beachten Sie, dass der Geodaten Importer aufgrund der eingesetzten | |
| 345 Technologien derzeit nicht in der Lage ist, lesend auf die Oracle Datenbank | |
| 346 zuzugreifen. Entsprechend kann beim Import nicht festgestellt werden, ob sich | |
| 347 Shapefiles bereits in der Datenbank befinden, oder nicht. Ein erneuter Import | |
| 348 Vorgang der Geodaten würde also dazu führen, dass Geometrien doppelt in der | |
| 349 Datenbank abgelegt werden. | |
| 350 |