ingo@3661: \section{Geodatenimport} ingo@3661: ingo@3661: Der Geodaten Importer ist ein in Python geschriebenes Kommandozeilen Tool zum ingo@3661: Import von Shapefiles in eine Datenbank. Zum Lesen der Shapefiles und zum ingo@3661: Schreiben der Geodaten in die Datenbank wird GDAL verwendet. Zum Import in eine ingo@3661: Oracle Datenbank ist es erforderlich, dass GDAL und GDAL Python Bindungs mit ingo@3661: Oracle Unterstützung installiert sind. Weitere Details hierzu befinden sich im ingo@3661: Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}. ingo@3661: ingo@3661: Der Importer kann mit einem Shellscript von der Kommandozeilen gestartet werden ingo@3661: (siehe Kapitel \ref{Starten des Geodaten Importers}). Nach dem Start wird anhand der ingo@3661: Konfiguration festgestellt, welche Klassen von Shapefiles aus dem Dateisystem ingo@3661: importiert werden sollen. Für jede Klasse gibt es hierzu einen speziellen ingo@3661: Parser, der die speziellen Attribute eines Shapefiles liest und in die ent- ingo@3661: sprechende Relation der Datenbank schreibt. Die Parser sind speziell auf das ingo@3661: Dateisystem der BfG ausgerichtet. So wird z.B. erwartet, dass die Shapefiles der ingo@3661: Gewässerachse im Ordner $Geodaesie/Flussachse+km$ liegen. Weitere Informationen zu ingo@3661: den einzelnen Parsern sind dem nächsten Kapitel \ref{Beschreibung der Parser} zu ingo@3661: entnehmen. Der Erfolg oder Misserfolg eines Shape-Imports wird je nach ingo@3661: Konfiguration im Logfile vermerkt. Folgende Einträge können dem Logfile ingo@3661: entnommen werden: ingo@3661: ingo@3661: \textbf{INFO: Inserted 4 features} ingo@3661: \\Gibt die Anzahl der erfolgreich importierten Features an.\\ ingo@3661: ingo@3661: \textbf{INFO: Failed to create 2 features} ingo@3661: \\Gibt die Anzahl der Features an, die nicht importiert werden konnten.\\ ingo@3661: ingo@3661: \textbf{INFO: Found 3 unsupported features} ingo@3661: \\Gibt die Anzahl der Features an, die aufgrund ihres Datentyps nicht importiert ingo@3661: werden konnten. Z.B: es werden Linien erwartet, im Shapefile sind jedoch ingo@3661: Polygone enthalten.\\ ingo@3661: ingo@3661: \textbf{ERROR: Unable to insert feature: DETAIL} ingo@3661: \\Beim Lesen der Attribute eines Features ist ein Fehler aufgetreten. ingo@3661: Das Feature konnte nicht in die Datenbank geschrieben werden.\\ ingo@3661: ingo@3661: \textbf{ERROR: Exception while committing transaction} ingo@3661: \\Beim Abschluss des Schreib-Vorgangs in die Datenbank ist ein unerwarteter ingo@3661: Fehler aufgetreten. Die Features des Shapes sind nicht importiert worden.\\ ingo@3661: ingo@3661: Damit die Geodaten eines Shapes später eindeutig in der Datenbank identifiziert ingo@3661: werden können, wird für jede Geometrie der Pfad des Shapes im Dateisystem in ingo@3661: einer Spalte der Datenbank gespeichert. Anwendungen, die auf der Datenbank ingo@3661: aufbauen, können die Geodaten eines Shapefiles später anhand dieses Merkmals ingo@3661: gruppieren und anzeigen. ingo@3661: ingo@3661: ingo@3661: \subsection{Beschreibung der Parser} ingo@3661: \label{Beschreibung der Parser} ingo@3661: ingo@3661: Wie im letzten Kapitel beschrieben, sind die Parser speziell an das Dateisystem ingo@3661: der BfG ausgerichtet. Im folgenden werden zu jedem Parser folgende Informationen ingo@3661: angegeben: ingo@3661: ingo@3661: \textbf{Pfad} ingo@3661: \\Der Pfad, in dem die Shapefiles im Dateisystem abgelegt sein müssen ausgehend ingo@3661: vom Gewässer Verzeichnis. ingo@3661: ingo@3661: \textbf{Geometrie} ingo@3661: \\Der Geometrie Typ, der für diese Klasse von Shapefiles erwartet wird. ingo@3661: ingo@3661: \textbf{Attribute} ingo@3661: \\Eine Liste der Attribute, die vom Parser aus dem Shape gelesen werden. ingo@3661: ingo@3661: ingo@3661: \subsubsection{Achsen} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Geodaesie/Flussachse+km \\ ingo@3661: Geometrie & LINESTRING \\ ingo@3661: Attribute & name, kind \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Hydrologische Grenzen} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Hydrologie/Hydr.Grenzen/Linien \\ ingo@3661: Geometrie & LINESTRING, POLYGON \\ ingo@3661: Attribute & name, kind \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: \subsubsection{Bauwerke} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Geodaesie/Bauwerke \\ ingo@3661: Geometrie & LINESTRING \\ ingo@3661: Attribute & name, Name, KWNAAM \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Einzugsgebiete} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Hydrologie/Einzugsgebiet \\ ingo@3661: Geometrie & POLYGON, MULTIPOLYGON \\ ingo@3661: Attribute & name, Name, AREA, area \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Querprofilspuren} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Geodaesie/Querprofile \\ ingo@3661: Geometrie & LINESTRING \\ ingo@3661: Attribute & KILOMETER, KM, STATION, ELEVATION \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Festpunkte} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Geodaesie/Festpunkte \\ ingo@3661: Geometrie & POINT \\ ingo@3661: Attribute & name, KM, ELBE\_KM, X, Y, HPGP \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Talaue} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Hydrologie/Hydr.Grenzen \\ ingo@3661: Geometrie & POLYGON, MULTIPOLYGON \\ ingo@3661: Attribute & name \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Pegelstationen} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Hydrologie/Streckendaten \\ ingo@3661: Geometrie & POINT \\ ingo@3661: Attribute & Name, name, MPNAAM \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Hochwasserschutzanlagen} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Hydrologie/HW-Schutzanlagen \\ ingo@3661: Geometrie & LINESTRING \\ ingo@3661: Attribute & TYP, Bauart, Name, name \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Kilometrierung} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Geodaesie/Flussachse+km \\ ingo@3661: Geometrie & POINT \\ ingo@3661: Attribute & name, km, KM \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Linien} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Geodaesie/Linien \\ ingo@3661: Geometrie & LINESTRING, MULTILINESTRING \\ ingo@3661: Attribute & name, TYP, Z \\ ingo@3661: ingo@3661: Anmerkung & Wenn kein Attribut 'TYP' definiert ist, wird standardmäßig der Wert \\ ingo@3661: & 'DAMM' angenommen. Fehlt ein Attribut 'Z' wird als '9999' als Höhe \\ ingo@3661: & angenommen. \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsubsection{Überschwemmungsfläche} ingo@3661: \hspace{1cm} ingo@3661: \begin{tabular}[t]{ll} ingo@3661: Pfad & Hydrologie/UeSG/Berechnung \\ ingo@3661: Geometrie & POLYGON, MULTIPOLYGON \\ ingo@3661: Attribut & name, diff, count, area, perimeter \\ ingo@3661: \end{tabular} ingo@3661: ingo@3661: ingo@3661: \subsection{Systemanforderungen} ingo@3661: \label{Systemanforderungen} ingo@3661: \begin{itemize} ingo@3661: \item Oracle Datenbank inkl. Schema für FLYS ingo@3661: \item GDAL Binding für Python mit Oracle Support ingo@3661: \item ogr2ogr ingo@3661: \item Python $>=$ 2.6 ingo@3661: \end{itemize} ingo@3661: ingo@3661: ingo@3661: \subsection{Installationsanleitung} ingo@3661: \label{Installationsanleitung} ingo@3661: \begin{itemize} ingo@3670: ingo@3670: \item Python\\ ingo@3670: Zum Starten des Importers ist es notwendig Python zu installieren. Dies können ingo@3670: Sie mit folgendem Befehl auf der Kommandozeile erledigen: ingo@3670: ingo@3670: \begin{lstlisting} ingo@3670: zypper in python ingo@3670: \end{lstlisting} ingo@3670: ingo@3670: \item \todo ogr2ogr installieren? ingo@3670: ingo@3670: \item \todo python-gdal; woher? ingo@3670: ingo@3670: \item Oracle Instantclient\\ ingo@3670: Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python ingo@3670: und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es ingo@3670: erforderlich, folgende Archive von Oracle herunterzuladen: ingo@3670: ingo@3670: \begin{itemize} ingo@3670: \item \todo URL zu instantclient-basic-linux-x86-64-11.2.0.2.0.zip ingo@3670: \item \todo URL zu instantclient-sdk-linux-x86-64-11.2.0.2.0.zip ingo@3670: \item \todo URL zu instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip ingo@3670: \end{itemize} ingo@3670: ingo@3670: Anschließend führen Sie folgende Befehle auf der Kommandozeile aus: ingo@3670: ingo@3670: \begin{lstlisting} ingo@3670: ingo@3670: mkdir /opt ingo@3670: ingo@3670: unzip ~/instantclient-basic-linux-x86-64-11.2.0.2.0.zip -d /opt ingo@3670: unzip ~/instantclient-sdk-linux-x86-64-11.2.0.2.0.zip -d /opt ingo@3670: unzip ~/instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip -d /opt ingo@3670: ingo@3670: mkdir /opt/instantclient_11_2/lib ingo@3670: cd /opt/instantclient_11_2/lib ingo@3670: ln -s ../libclntsh.so.11.1 . ingo@3670: ln -s ../libclntsh.so.11.1 libclntsh.so ingo@3670: ln -s ../libnnz11.so . ingo@3670: ln -s ../libocci.so.11.1 . ingo@3670: ln -s ../libocci.so.11.1 libocci.so ingo@3670: ln -s ../libociei.so . ingo@3670: ln -s ../libocijdbc11.so . ingo@3670: ln -s ../libsqlplusic.so . ingo@3670: ln -s ../libsqlplus.so . ingo@3670: ingo@3670: rpm -i --nodeps ~/flys-importer/rpm/RPMS/x86_64/libgdal1180-1.8.0-intevation1.x86_64.rpm ingo@3670: rpm -i --nodeps ~/flys-importer/rpm/RPMS/x86_64/libgdal180-devel-1.8.0-intevation1.x86_64.rpm ingo@3670: rpm -i --nodeps ~/flys-importer/rpm/RPMS/x86_64/gdal180-1.8.0-intevation1.x86_64.rpm ingo@3670: ingo@3670: \end{lstlisting} ingo@3670: ingo@3670: Sollten keine Fehler aufgetreten sein, haben Sie den \textit{Oracle ingo@3670: Instantclient 11.2} erfolgreich entpackt und im Dateisystem unter ingo@3670: \textit{/opt/instantclient\_11\_2} abgelegt. Mit den Befehlen $rpm -i --nodeps$ ingo@3670: haben Sie anschließend die notwendigen Bindings installiert, damit der Importer ingo@3670: die Geodaten in die Oracle Datenbank schreiben kann. ingo@3670: ingo@3661: \end{itemize} ingo@3661: ingo@3661: ingo@3661: \subsection{Konfiguration} ingo@3661: \label{Konfiguration} ingo@3661: Der Geodaten Importer kann über die Datei `contrib/shpimporter/run.sh` ingo@3661: konfiguriert werden. Öffnen Sie die Datei mit einem Texteditor Ihrer Wahl. ingo@3661: In den Zeilen 4-9 werden Optionen definiert, die zwangsläufig angepasst ingo@3661: werden müssen: ingo@3661: ingo@3661: \textbf{RIVER\_PATH} ingo@3661: \\Der Pfad zum Gewässer im Dateisystem. ingo@3661: ingo@3661: \textbf{RIVER\_ID} ingo@3661: \\Die Datenbank ID des zu importierenden Gewässers. ingo@3661: ingo@3661: \textbf{TARGET\_SRS} ingo@3661: \\Das EPSG Referenzsystem in das die Geodaten beim Import projeziert werden ingo@3661: sollen. ingo@3661: ingo@3661: \textbf{HOST} ingo@3661: \\Der Host der Datenbank. ingo@3661: ingo@3661: \textbf{USER} ingo@3661: \\Der Nutzer, der zum Verbinden zur Datenbank verwendet wird. ingo@3661: ingo@3661: \textbf{PASS} ingo@3661: \\Das Passwort für USER zum Verbinden zur Datenbank. ingo@3661: ingo@3661: In den Zeilen 12-23 werden weitere Optionen definiert, die bei Bedarf angepasst ingo@3661: werden können. Falls nicht anders angegeben, können die Optionen mit den Werten ingo@3661: `0` und `1` belegt werden. ingo@3661: ingo@3661: \textbf{VERBOSE} ingo@3661: \\Dieser Wert gibt die Granularität der Log-Ausgaben während des ingo@3661: Imports an. Je höher der Wert, desto mehr Informationen werden ingo@3661: in das Logfile geschrieben. Aktuell sind die Werte `0`, `1` und ingo@3661: `2` definiert. Wird der Wert `0` gesetzt, werden nur Fehler und ingo@3661: Warnungen in das Logfile geschrieben. Bei `1` werden neben ingo@3661: Fehlern und Warnungen auch Infos in das Logfile geschrieben. Bei ingo@3661: `2` werden sämtliche Ausgaben des Programms geschrieben. Dieser ingo@3661: Modus ist hauptsächlich für die Entwicklung gedacht. ingo@3661: ingo@3661: \textbf{SKIP\_AXIS} ingo@3661: \\Bei gesetztem Wert `1` werden keine Flussachsen importiert. ingo@3661: ingo@3661: \textbf{SKIP\_KMS} ingo@3661: \\Bei gesetztem Wert `1` werden keine Kilometrierungen importiert. ingo@3661: ingo@3661: \textbf{SKIP\_CROSSSECTIONS} ingo@3661: \\Bei gesetztem Wert `1` werden keine Querprofilespuren importiert. ingo@3661: ingo@3661: \textbf{SKIP\_LINES} ingo@3661: \\Bei gesetztem Wert `1` werden keine Linien importiert. ingo@3661: ingo@3661: \textbf{SKIP\_FIXPOINTS} ingo@3661: \\Bei gesetztem Wert `1` werden keine Festpunkte importiert. ingo@3661: ingo@3661: \textbf{SKIP\_BUILDINGS} ingo@3661: \\Bei gesetztem Wert `1` werden keine Bauwerke importiert. ingo@3661: ingo@3661: \textbf{SKIP\_FLOODPLAINS} ingo@3661: \\Bei gesetztem Wert `1` werden keine Talauen importiert. ingo@3661: ingo@3661: \textbf{SKIP\_HYDR\_BOUNDARIES} ingo@3661: \\Bei gesetztem Wert `1` werden keine hydrologischen Grenzen importiert. ingo@3661: ingo@3661: \textbf{SKIP\_HWS} ingo@3661: \\Bei gesetztem Wert `1` werden kein Hochwasserschutzanlagen importiert. ingo@3661: ingo@3661: \textbf{SKIP\_GAUGE\_LOCATION} ingo@3661: \\Bei gesetztem Wert `1` werden keine Pegelort importiert. ingo@3661: ingo@3661: \textbf{SKIP\_CATCHMENTS} ingo@3661: \\Bei gesetztem Wert `1` werden keine Einzugsgebiet importiert. ingo@3661: ingo@3661: \textbf{SKIP\_UESG} ingo@3661: \\Bei gesetztem Wert `1` werden keine Überschwemmungsflächen importiert. ingo@3661: ingo@3661: ingo@3661: \subsection{Starten des Geodaten Importers} ingo@3661: \label{Starten des Geodaten Importers} ingo@3661: Der Geodaten Importer wird mittels eines Shellskripts von einer Konsole ingo@3661: gestartet. Dazu wechseln Sie auf der Konsole in das Verzeichnis \todo und ingo@3661: führen Sie folgenden Befehl aus:\\ ingo@3661: ingo@3661: \begin{lstlisting} ingo@3661: sh contrib/shpimporter/run.sh > import.log ingo@3661: \end{lstlisting} ingo@3661: Der Importer wird nun gestartet. Sämtliche Log-Ausgaben werden in die Datei ingo@3661: $import.log$ geschrieben.