[PATCH] Importer Doc: partly completed geo-importer parsers (with layout issues)
Wald Commits
scm-commit at wald.intevation.org
Mon Aug 5 18:39:16 CEST 2013
# HG changeset patch
# User Tom Gottfried <tom.gottfried at intevation.de>
# Date 1375720752 -7200
# Branch double-precision
# Node ID b5b54e8da1cfe80a6dc4784c2e222d471e554053
# Parent 012f79123d48c3cd0383dbbd3d6522e344d84140
Importer Doc: partly completed geo-importer parsers (with layout issues)
diff -r 012f79123d48 -r b5b54e8da1cf backend/doc/documentation/de/importer-geodaesie.tex
--- 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}
More information about the Dive4elements-commits
mailing list