changeset 6751:b5b54e8da1cf double-precision

Importer Doc: partly completed geo-importer parsers (with layout issues)
author Tom Gottfried <tom.gottfried@intevation.de>
date Mon, 05 Aug 2013 18:39:12 +0200
parents 012f79123d48
children f3730c727473
files backend/doc/documentation/de/importer-geodaesie.tex
diffstat 1 files changed, 86 insertions(+), 34 deletions(-) [+]
line wrap: on
line diff
--- a/backend/doc/documentation/de/importer-geodaesie.tex	Mon Aug 05 11:39:59 2013 +0200
+++ b/backend/doc/documentation/de/importer-geodaesie.tex	Mon Aug 05 18:39:12 2013 +0200
@@ -81,12 +81,12 @@
 \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 angepasst. 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.
+\\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.
@@ -94,87 +94,136 @@
 \textbf{Attribute}
 \\Eine Liste der Attribute, die vom Parser aus dem Shape gelesen werden.
 
+Zudem werden Datenbank-Attribute beschrieben, die nicht direkt aus 
+Attribut-Spalten des Shapefiles gelesen werden.
 
 \subsubsection{Achsen}
 \hspace{1cm}
 \begin{tabular}[t]{ll}
 Pfad        &   Geodaesie/Flussachse+km \\
-Geometrie   &   LINESTRING \\
-Attribute   &   name, kind \\
+Geometrie   &   LINESTRING, MULTILINESTRING \\
 \end{tabular}
 
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
+Zusätzlich wird das Attribut 'kind\_id' gesetzt, welches 
+für die aktuelle Achse (\textit{achse.shp}) 1 ist und für sonstige Achsen (weitere Linien-Shapes) 2.
 
-\subsubsection{Hydrologische Grenzen}
+\subsubsection{Hydr. Grenzen}
 \hspace{1cm}
 \begin{tabular}[t]{ll}
-Pfad        &   Hydrologie/Hydr.Grenzen/Linien \\
-Geometrie   &   LINESTRING, POLYGON \\
-Attribute   &   name, kind, sectie, sobek \\
+Pfad        &   Hydrologie/Hydr.Grenzen \\
+Geometrie   &   LINESTRING, MULTILINESTRING, POLYGON, MULTIPOLYGON \\
+Attribute   &   SECTIE, STROVOER \\
 \end{tabular}
 
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
+Das Attribut 'kind' wird 1 gesetzt für Daten aus dem 
+Unterverzeichnis \textit{Linien/BfG}, 
+2 für Daten aus \textit{Linien/Land},
+3 für Daten aus \textit{Sonstige}
+und für alle übrigen 0.
+Ausgenommen sind Dateien, in deren Namen 'Talaue' 
+(Groß-Klein-Schreibung irrelevant) vorkommt.
+
+Linien und Polygone werden in der Datenbank in unterschiedlichen
+Tabellen gespeichert.
+
 \subsubsection{Bauwerke}
 \hspace{1cm}
 \begin{tabular}[t]{ll}
 Pfad        &   Geodaesie/Bauwerke \\
 Geometrie   &   LINESTRING \\
-Attribute   &   name, Name, KWNAAM \\
+Attribute   &   Name (alternativ: KWNAAM), 
+  km (alternativ: station, wsv-km), 
+  z (alternativ: Höhe, Hoehe, m+NHN)\\
 \end{tabular}
 
-
-\subsubsection{Einzugsgebiete}
-\hspace{1cm}
-\begin{tabular}[t]{ll}
-Pfad        &   Hydrologie/Einzugsgebiet \\
-Geometrie   &   POLYGON, MULTIPOLYGON \\
-Attribute   &   name, Name, AREA, area \\
-\end{tabular}
-
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
+Das Attribut 'kind\_id' ist 0 für Sonstige,
+1 für Brücken, 2 für Wehre, 3 für Pegel.
+Es wird aus dem Dateinamen hergeleitet 
+(\textit{bruecken.shp, wehre.shp, pegel.shp}, teilweise auch alternative Schreibweisen unterstützt)
+oder je Feature gesetzt, wenn in einer Attributspalte 
+die Werte 'bruecke' und 'wehr' (teilweise auch alternative Schreibweisen unterstützt) vorkommen.
+Ausgenommen sind Dateien, in deren Namen 'Buhnen' 
+(Groß-Klein-Schreibung irrelevant) vorkommt.
 
 \subsubsection{Querprofilspuren}
 \hspace{1cm}
 \begin{tabular}[t]{ll}
 Pfad        &   Geodaesie/Querprofile \\
 Geometrie   &   LINESTRING \\
-Attribute   &   KILOMETER, KM, STATION, ELEVATION \\
+Attribute   &   KILOMETER (alternativ: KM, STATION), ELEVATION \\
 \end{tabular}
 
+Das Attribut 'kind\_id' wird 1 gesetzt für die Datei \textit{qps.shp} (aktuelle Querprofilspuren)
+und 0 für alle weiteren.
 
 \subsubsection{Festpunkte}
 \hspace{1cm}
 \begin{tabular}[t]{ll}
 Pfad        &   Geodaesie/Festpunkte \\
 Geometrie   &   POINT \\
-Attribute   &   name, KM, ELBE\_KM, X, Y, HPGP \\
+Attribute   &   KM (alternativ: ELBE\_KM), X, Y, HPGP (alternativ: ART) \\
 \end{tabular}
 
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
+
+\subsubsection{Hochwassermarken}
+\hspace{1cm}
+\begin{tabular}[t]{ll}
+Pfad        &   Hydrologie/HW-Marken/hw-marken.shp \\
+Geometrie   &   POINT \\
+Attribute   &   Ort (alternativ: Pegel),
+  km (alternativ: station, wsv-km, FlussKm), 
+  z (alternativ: z mit anschließender Zahl, m+NHN)\\
+\end{tabular}
+
+Groß-Klein-Schreibung im Dateinamen ist irrelevant.
+Für das Attribut 'year' im Dateinamen nach einer Jahreszahl
+nach folgendem Muster gesucht: \textit{\_YYYY\_} oder \textit{-YYYY-}. Gelingt dies nicht, erscheint im Logfile die Warnung
+'Could not extract year from filename: ...'.
 
 \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}
-
+Es werden nur Dateien betrachtet, in deren Namen das Wort 'Talaue'
+(Groß-Klein-Schreibung irrelevant) vorkommt.
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
+Das Attribut 'kind\_id' wird 1 gesetzt für die Datei \textit{talaue.shp} (aktuelle Talaue)
+und 0 für alle weiteren.
 
 \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 \\
+Geometrie   &   LINESTRING, MULTILINESTRING, POINT \\
+Attribute   &   Name, Art, Quelle, Anmerkung, Stand, Verband,
+                km (alternativ: Deich\_km), Bereich, 
+                Hoehe, Hoehe\_soll, WSP\_Bfg100, Bundesland
+                (Teilweise auch alternative Schreibweisen unterstützt)\\
 \end{tabular}
 
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt, 
+wenn kein Attribut 'Name' im Shapefile vorhanden ist.
+Das Feld 'kind\_id' wird per Default auf 2 (für Damm) gesetzt.
+Wird ein Attribut 'ART' im Shapefile gefunden, 
+so wird 'kind\_id' entsprechend dieses Feldes gesetzt 
+(1 für die Werte 'Durchlass', 'Rohr1', 'Rohr 1', 'Rohr 2',
+2 für die Werte 'Damm', 'Deich', 'Hochufer', 'Hauptdeich', 'Sommerdeich',
+3 für den Wert 'Graben').
+Es wird versucht das Bundesland aus dem Dateinamen zu ermitteln,
+wenn das Shapefile kein Attribut 'Bundesland' enthält.
+
+Linien und Punkte werden in der Datenbank in unterschiedlichen
+Tabellen gespeichert.
+
+\subsubsection{Buhnen}
+
 
 \subsubsection{Kilometrierung}
 \hspace{1cm}
@@ -193,6 +242,9 @@
 Attribut    &   name, diff, count, area, perimeter \\
 \end{tabular}
 
+\subsubsection{Digitale Gelände-Modelle}
+% Zeitpunkt mit 'Jahr_von' angeben.
+
 \subsection{Konfiguration}
 \label{Konfiguration}
 Der Geodaten Importer kann über die Datei \textit{contrib/run\_geo.sh}

http://dive4elements.wald.intevation.org