Mercurial > dive4elements > river
diff 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 |
line wrap: on
line diff
--- a/flys-backend/doc/documentation/de/importer-geodaesie.tex Thu Aug 30 08:39:03 2012 +0000 +++ b/flys-backend/doc/documentation/de/importer-geodaesie.tex Thu Aug 30 08:59:50 2012 +0000 @@ -2,15 +2,15 @@ Der Geodaten Importer ist ein in Python geschriebenes Kommandozeilen Tool zum Import von Shapefiles in eine Datenbank. Zum Lesen der Shapefiles und zum -Schreiben der Geodaten in die Datenbank wird GDAL verwendet. Zum Import in eine -Oracle Datenbank ist es erforderlich, dass GDAL und GDAL Python Bindungs mit +Schreiben der Geodaten in die Datenbank wird GDAL verwendet. Der Import in eine +Oracle Datenbank erfordert, dass GDAL und GDAL Python Bindungs mit Oracle Unterstützung installiert sind. Weitere Details hierzu befinden sich im Kapitel \ref{Systemanforderungen} und \ref{Installationsanleitung}. -Der Importer kann mit einem Shellscript von der Kommandozeilen gestartet werden +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 hierzu einen speziellen +importiert werden sollen. Für jede Klasse gibt es einen speziellen Parser, der die speziellen Attribute eines Shapefiles liest und in die ent- sprechende Relation der Datenbank schreibt. Die Parser sind speziell auf das Dateisystem der BfG ausgerichtet. So wird z.B. erwartet, dass die Shapefiles der @@ -54,7 +54,7 @@ \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 +der BfG ausgerichtet. Im Folgenden werden zu jedem Parser folgende Informationen angegeben: \textbf{Pfad} @@ -165,7 +165,7 @@ Attribute & name, TYP, Z \\ Anmerkung & Wenn kein Attribut 'TYP' definiert ist, wird standardmäßig der Wert \\ - & 'DAMM' angenommen. Fehlt ein Attribut 'Z' wird als '9999' als Höhe \\ + & 'DAMM' angenommen. Fehlt ein Attribut 'Z' wird '9999' als Höhe \\ & angenommen. \\ \end{tabular} @@ -201,19 +201,17 @@ zypper in python \end{lstlisting} - \item \todo ogr2ogr installieren? - - \item \todo python-gdal; woher? - \item Oracle Instantclient\\ Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es - erforderlich, folgende Archive von Oracle herunterzuladen: + erforderlich, folgende Archive von Oracle herunterzuladen. Zu finden sind die + folgenden Pakete unter\\ + \href{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html} \begin{itemize} - \item \todo URL zu instantclient-basic-linux-x86-64-11.2.0.2.0.zip - \item \todo URL zu instantclient-sdk-linux-x86-64-11.2.0.2.0.zip - \item \todo URL zu instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip + \item instantclient-basic-linux-x86-64-11.2.0.2.0.zip + \item instantclient-sdk-linux-x86-64-11.2.0.2.0.zip + \item instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip \end{itemize} Anschließend führen Sie folgende Befehle auf der Kommandozeile aus: @@ -321,10 +319,10 @@ \\Bei gesetztem Wert `1` werden kein Hochwasserschutzanlagen importiert. \textbf{SKIP\_GAUGE\_LOCATION} -\\Bei gesetztem Wert `1` werden keine Pegelort importiert. +\\Bei gesetztem Wert `1` werden keine Pegelorte importiert. \textbf{SKIP\_CATCHMENTS} -\\Bei gesetztem Wert `1` werden keine Einzugsgebiet importiert. +\\Bei gesetztem Wert `1` werden keine Einzugsgebiete importiert. \textbf{SKIP\_UESG} \\Bei gesetztem Wert `1` werden keine Überschwemmungsflächen importiert. @@ -333,11 +331,20 @@ \subsection{Starten des Geodaten Importers} \label{Starten des Geodaten Importers} Der Geodaten Importer wird mittels eines Shellskripts von einer Konsole -gestartet. Dazu wechseln Sie auf der Konsole in das Verzeichnis \todo und -führen Sie folgenden Befehl aus:\\ +gestartet. Dazu führen Sie folgenden Befehl aus:\\ \begin{lstlisting} - sh contrib/shpimporter/run.sh > import.log + sh contrib/run_geo.sh > geo-import.log \end{lstlisting} + Der Importer wird nun gestartet. Sämtliche Log-Ausgaben werden in die Datei -$import.log$ geschrieben. +$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. +