changeset 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 1785ec25930c
children c37effda3655
files flys-backend/ChangeLog flys-backend/doc/documentation/de/importer-geodaesie.tex flys-backend/doc/documentation/de/importer-manual.tex
diffstat 3 files changed, 36 insertions(+), 22 deletions(-) [+]
line wrap: on
line diff
--- 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 <ingo@intevation.de>
+
+	* 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 <ingo@intevation.de>
 
 	* doc/documentation/de/importer-hydr-morph.tex: Added manual line breaks.
--- 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.
+
--- 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}
 %----------------------------------------------
 

http://dive4elements.wald.intevation.org