# HG changeset patch # User Ingo Weinzierl # Date 1346317190 0 # Node ID ae16bd95879ec4cc692b1dd14bd59ebabc04fb63 # Parent 1785ec25930cd2e848d39f130e432626883b5e42 Finalized geo part of importer documentation; set document revision and date. flys-backend/trunk@5308 c6561f87-3c4e-4783-a992-168aeb5c3f6f diff -r 1785ec25930c -r ae16bd95879e flys-backend/ChangeLog --- a/flys-backend/ChangeLog Thu Aug 30 08:39:03 2012 +0000 +++ b/flys-backend/ChangeLog Thu Aug 30 08:59:50 2012 +0000 @@ -1,3 +1,10 @@ +2012-08-30 Ingo Weinzierl + + * doc/documentation/de/importer-geodaesie.tex: Bugfixes and added hint. + + * doc/documentation/de/importer-manual.tex: Set document revision and + date. + 2012-08-30 Ingo Weinzierl * doc/documentation/de/importer-hydr-morph.tex: Added manual line breaks. diff -r 1785ec25930c -r ae16bd95879e flys-backend/doc/documentation/de/importer-geodaesie.tex --- 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. + diff -r 1785ec25930c -r ae16bd95879e flys-backend/doc/documentation/de/importer-manual.tex --- a/flys-backend/doc/documentation/de/importer-manual.tex Thu Aug 30 08:39:03 2012 +0000 +++ b/flys-backend/doc/documentation/de/importer-manual.tex Thu Aug 30 08:59:50 2012 +0000 @@ -24,9 +24,9 @@ % Document DATE and VERSION % set these values when releasing a new version -\newcommand{\documentdate}{27. August 2012} +\newcommand{\documentdate}{30. August 2012} \newcommand{\documentversion}{1.0} -\newcommand{\documentrevision}{rev5271} +\newcommand{\documentrevision}{rev5302} \newcommand{\documentID}{importer-manual.tex} %----------------------------------------------