Mercurial > dive4elements > river
view backend/doc/documentation/de/importer-geodaesie.tex @ 6495:d1d503584d34
added recommendation for official lines in cross sections
author | Sascha L. Teichmann <teichmann@intevation.de> |
---|---|
date | Fri, 28 Jun 2013 13:37:00 +0200 |
parents | 5aa05a7a34b7 |
children | 46c6ff16c422 |
line wrap: on
line source
\section{Geodatenimport} Der Geodaten Importer ist ein in der Programmiersprache Python geschriebenes Kommandozeilen Werkzeug zum Import von Shapefiles in eine Datenbank. Zum Lesen der Shapefiles und zum schreiben der Geodaten in die Datenbank wird die GDAL Bibliothek verwendet. Um Daten in eine Oracle Datenbank zu importieren ist es n�tig, dass GDAL und GDAL Python Bindungs mit Oracle Unterst�tzung installiert sind. Bei der Verwendung von PostgreSQL entf�llt dieser Schritt. Weitere Details hierzu befinden sich im Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}. Der Importer kann mit einem Shellscript von der Kommandozeile gestartet werden (siehe Kapitel \ref{Starten des Geodaten Importers}). Nach dem Start wird anhand der Konfiguration festgestellt, welche Klassen von Shapefiles aus dem Dateisystem importiert werden sollen. F�r jede Klasse gibt es einen speziellen Parser, der die speziellen Attribute eines Shapefiles liest und in die entsprechende Relation der Datenbank schreibt. Die Parser sind speziell auf das Dateisystem der BfG ausgerichtet. So wird beispielsweise erwartet, dass die Shapefiles der Gew�sserachse im Ordner $Geodaesie/Flussachse+km$ liegen. Weitere Informationen zu den einzelnen Parsern sind dem n�chsten Kapitel \ref{Beschreibung der Parser} zu entnehmen. Der Erfolg oder Misserfolg eines Shape-Imports wird je nach Konfiguration im Logfile vermerkt. Folgende Eintr�ge k�nnen dem Logfile entnommen werden: %TODO etwas zum srs schreiben. \textbf{INFO: Inserted 4 features} \\Gibt die Anzahl der erfolgreich importierten Features an.\\ \textbf{INFO: Failed to create 2 features} \\Gibt die Anzahl der Features an, die nicht importiert werden konnten.\\ \textbf{INFO: Found 3 unsupported features of type: wbkMultiLineString} \\Gibt die Anzahl der Features an, die aufgrund ihres Datentyps nicht importiert werden konnten. Wenn etwa Punkte erwartet wurden aber sich im Shapefile Polygone befanden.\\ \textbf{INFO: Did not import values from fields: TYP ID GRUENDUNG BHW} \\Manche Importer versuchen neben der Geographischen Information weitere Felder in die Datenbank einzulesen. Um festzustellen ob ein Feld aufgrund von Tippfehlern oder unterschiedlicher Schreibweise nicht importiert wurde, gibt diese Information Auskunft dar�ber welche Felder aus der Shape Datei nicht verwendet wurden.\\ \textbf{ERROR: No source SRS given! No transformation possible!} \\Das Shapefile enth�lt keine Information, in welcher Projektion die Geometrien vorliegen. Es findet keine Transformation in die Zielprojektion statt. Bitte beachten Sie, dass FLYS diese Geometrien sp�ter ggf nicht korrekt darstellen kann. \textbf{ERROR: Unable to insert feature: DETAIL} \\Beim Lesen der Attribute eines Features ist ein Fehler aufgetreten. Das Feature konnte nicht in die Datenbank geschrieben werden.\\ \textbf{ERROR: Exception while committing transaction} \\Beim Abschluss des Schreib-Vorgangs in die Datenbank ist ein unerwarteter Fehler aufgetreten. Die Features des Shapes sind nicht importiert worden.\\ \textbf{ERROR 1: ORA-01017: invalid username/password; logon denied} \\Es konnte keine Verbindung zur Oracle Datenbank hergestellt werden. Pr�fen Sie die Verbindungseinstellungen. Damit die Geodaten eines Shapes sp�ter eindeutig in der Datenbank identifiziert werden k�nnen, wird f�r jede Geometrie der Pfad des Shapes im Dateisystem in einer Spalte der Datenbank gespeichert. Anwendungen, die auf der Datenbank aufbauen, k�nnen die Geodaten eines Shapefiles sp�ter anhand dieses Merkmals gruppieren und anzeigen. \subsection{Beschreibung der Parser} \label{Beschreibung der Parser} Wie im letzten Kapitel beschrieben, sind die Parser speziell an das Dateisystem der BfG ausgerichtet. Im Folgenden werden zu jedem Parser folgende Informationen angegeben: \textbf{Pfad} \\Der Pfad, in dem die Shapefiles im Dateisystem abgelegt sein m�ssen ausgehend vom Gew�sser Verzeichnis. \textbf{Geometrie} \\Der Geometrie Typ, der f�r diese Klasse von Shapefiles erwartet wird. \textbf{Attribute} \\Eine Liste der Attribute, die vom Parser aus dem Shape gelesen werden. \subsubsection{Achsen} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Geodaesie/Flussachse+km \\ Geometrie & LINESTRING \\ Attribute & name, kind \\ \end{tabular} \subsubsection{Hydrologische Grenzen} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Hydrologie/Hydr.Grenzen/Linien \\ Geometrie & LINESTRING, POLYGON \\ Attribute & name, kind, sectie, sobek \\ \end{tabular} \subsubsection{Bauwerke} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Geodaesie/Bauwerke \\ Geometrie & LINESTRING \\ Attribute & name, Name, KWNAAM \\ \end{tabular} \subsubsection{Einzugsgebiete} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Hydrologie/Einzugsgebiet \\ Geometrie & POLYGON, MULTIPOLYGON \\ Attribute & name, Name, AREA, area \\ \end{tabular} \subsubsection{Querprofilspuren} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Geodaesie/Querprofile \\ Geometrie & LINESTRING \\ Attribute & KILOMETER, KM, STATION, ELEVATION \\ \end{tabular} \subsubsection{Festpunkte} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Geodaesie/Festpunkte \\ Geometrie & POINT \\ Attribute & name, KM, ELBE\_KM, X, Y, HPGP \\ \end{tabular} \subsubsection{Talaue} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Hydrologie/Hydr.Grenzen \\ Geometrie & POLYGON, MULTIPOLYGON \\ Attribute & name \\ \end{tabular} \subsubsection{Pegelstationen} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Hydrologie/Streckendaten \\ Geometrie & POINT \\ Attribute & Name, name, MPNAAM \\ \end{tabular} \subsubsection{Hochwasserschutzanlagen} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Hydrologie/HW-Schutzanlagen \\ Geometrie & LINESTRING, POINT \\ Attribute & name, source, description, status\_date, agency, dike\_km, range, z\_target, rated\_level, z \\ \end{tabular} \subsubsection{Kilometrierung} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Geodaesie/Flussachse+km \\ Geometrie & POINT \\ Attribute & name, km, KM \\ \end{tabular} \subsubsection{�berschwemmungsfl�che} \hspace{1cm} \begin{tabular}[t]{ll} Pfad & Hydrologie/UeSG/Berechnung \\ Geometrie & POLYGON, MULTIPOLYGON \\ Attribut & name, diff, count, area, perimeter \\ \end{tabular} \subsection{Konfiguration} \label{Konfiguration} Der Geodaten Importer kann �ber die Datei \textit{contrib/run\_geo.sh} konfiguriert werden. �ffnen Sie die Datei mit einem Texteditor Ihrer Wahl. In den Zeilen 4-9 werden Optionen definiert, die zwangsl�ufig angepasst werden m�ssen: \textbf{RIVER\_PATH} \\Der Pfad zum Gew�sser im Dateisystem. \textbf{RIVER\_NAME} \\Der Datenbank Name des zu importierenden Gew�ssers. Wird dieser Parameter nicht �bergeben werden die Ordnernamen im mit dem Parameter RIVER\_PATH angegebenen Verzeichnis als Flussnamen interpretiert und es wird versucht diese zu Importieren. \textbf{HOST} \\Der Host der Datenbank. \textbf{USER} \\Der Nutzer, der zum Verbinden zur Datenbank verwendet wird. \textbf{PASS} \\Das Passwort f�r USER zum Verbinden zur Datenbank. In den Zeilen 12-23 werden weitere Optionen definiert, die bei Bedarf angepasst werden k�nnen. Falls nicht anders angegeben, k�nnen die Optionen mit den Werten `0` und `1` belegt werden. \textbf{VERBOSE} \\Dieser Wert gibt die Granularit�t der Log-Ausgaben w�hrend des Imports an. Je h�her der Wert, desto mehr Informationen werden in das Logfile geschrieben. Aktuell sind die Werte `0`, `1` und `2` definiert. Wird der Wert `0` gesetzt, werden nur Fehler und Warnungen in das Logfile geschrieben. Bei `1` werden neben Fehlern und Warnungen auch Infos in das Logfile geschrieben. Bei `2` werden s�mtliche Ausgaben des Programms geschrieben. Dieser Modus ist haupts�chlich f�r die Entwicklung gedacht. \textbf{OGR\_CONNECTION} \\Hiermit kann direkt ein beliebiger Verbindungs string angegegeben werden, welcher die host, user und passwort werde �berschreibt. Dieser Option wird direkt an die OGR Bibliothek weitergegeben und erm�glicht verbesserte Tests und Entwicklung mit verschiedenen Daten Backends. \textbf{SKIP\_AXIS} \\Bei gesetztem Wert `1` werden keine Flussachsen importiert. \textbf{SKIP\_KMS} \\Bei gesetztem Wert `1` werden keine Kilometrierungen importiert. \textbf{SKIP\_CROSSSECTIONS} \\Bei gesetztem Wert `1` werden keine Querprofilespuren importiert. \textbf{SKIP\_FIXPOINTS} \\Bei gesetztem Wert `1` werden keine Festpunkte importiert. \textbf{SKIP\_BUILDINGS} \\Bei gesetztem Wert `1` werden keine Bauwerke importiert. \textbf{SKIP\_FLOODPLAINS} \\Bei gesetztem Wert `1` werden keine Talauen importiert. \textbf{SKIP\_HYDR\_BOUNDARIES} \\Bei gesetztem Wert `1` werden keine hydrologischen Grenzen importiert. \textbf{SKIP\_HWS\_LINES} \\Bei gesetztem Wert `1` werden kein Hochwasserschutz Liniendaten importiert. \textbf{SKIP\_HWS\_POINTS} \\Bei gesetztem Wert `1` werden kein Hochwasserschutz Punktdaten importiert. \textbf{SKIP\_CATCHMENTS} \\Bei gesetztem Wert `1` werden keine Einzugsgebiete importiert. \textbf{SKIP\_UESG} \\Bei gesetztem Wert `1` werden keine �berschwemmungsfl�chen importiert. \textbf{SKIP\_DGM} \\Bei gesetztem Wert `1` werden keine Informationen �ber Digitale Gel�ndemodelle importiert. \textbf{SKIP\_JETTIES} \\Bei gesetztem Wert `1` werden keine Informationen �ber Buhnen importiert. \textbf{SKIP\_FLOODMARKS} \\Bei gesetztem Wert `1` werden keine Informationen �ber HW-Marken importiert. \subsection{Starten des Geodaten Importers} \label{Starten des Geodaten Importers} Der Geodaten Importer wird mittels eines Shellskripts von einer Konsole gestartet. Dazu f�hren Sie folgenden Befehl aus:\\ \begin{lstlisting} sh contrib/run_geo.sh > geo-import.log \end{lstlisting} Der Importer wird nun gestartet. S�mtliche Log-Ausgaben werden in die Datei $geo-import.log$ geschrieben. \textbf{Hinweis} \\Bitte beachten Sie, dass der Geodaten Importer aufgrund der eingesetzten Technologien derzeit nicht in der Lage ist, lesend auf die Oracle Datenbank zuzugreifen. Entsprechend kann beim Import nicht festgestellt werden, ob sich Shapefiles bereits in der Datenbank befinden, oder nicht. Ein erneuter Import Vorgang der Geodaten w�rde also dazu f�hren, dass Geometrien doppelt in der Datenbank abgelegt werden.