dive4elements/river: backend/doc/documentation/de/importer-geodaesie.tex comparison

comparison backend/doc/documentation/de/importer-geodaesie.tex @ 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	1976350aa8dc

comparison

equal deleted inserted replaced

-:012f79123d48
+:b5b54e8da1cf
 \subsection{Beschreibung der Parser}
 \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
+\\Der Pfad, in dem die Shapefiles im Dateisystem abgelegt sein müssen (ausgehend
-vom Gewässer Verzeichnis.
+vom Gewässer Verzeichnis).
 \textbf{Geometrie}
 \\Der Geometrie Typ, der für diese Klasse von Shapefiles erwartet wird.
 \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 \\
+Geometrie   &   LINESTRING, MULTILINESTRING \\
-Attribute   &   name, kind \\
+\end{tabular}
-\end{tabular}
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
+Zusätzlich wird das Attribut 'kind\_id' gesetzt, welches
-\subsubsection{Hydrologische Grenzen}
+für die aktuelle Achse (\textit{achse.shp}) 1 ist und für sonstige Achsen (weitere Linien-Shapes) 2.
-\hspace{1cm}
-\begin{tabular}[t]{ll}
+\subsubsection{Hydr. Grenzen}
-Pfad        &   Hydrologie/Hydr.Grenzen/Linien \\
+\hspace{1cm}
-Geometrie   &   LINESTRING, POLYGON \\
+\begin{tabular}[t]{ll}
-Attribute   &   name, kind, sectie, sobek \\
+Pfad        &   Hydrologie/Hydr.Grenzen \\
-\end{tabular}
+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),
-\end{tabular}
+km (alternativ: station, wsv-km),
+z (alternativ: Höhe, Hoehe, m+NHN)\\
+\end{tabular}
-\subsubsection{Einzugsgebiete}
-\hspace{1cm}
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
-\begin{tabular}[t]{ll}
+Das Attribut 'kind\_id' ist 0 für Sonstige,
-Pfad        &   Hydrologie/Einzugsgebiet \\
+1 für Brücken, 2 für Wehre, 3 für Pegel.
-Geometrie   &   POLYGON, MULTIPOLYGON \\
+Es wird aus dem Dateinamen hergeleitet
-Attribute   &   name, Name, AREA, area \\
+(\textit{bruecken.shp, wehre.shp, pegel.shp}, teilweise auch alternative Schreibweisen unterstützt)
-\end{tabular}
+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}
-\end{tabular}
+Es werden nur Dateien betrachtet, in deren Namen das Wort 'Talaue'
+(Groß-Klein-Schreibung irrelevant) vorkommt.
-\subsubsection{Pegelstationen}
+Das Attribut 'name' wird auf den Namen des Shapefiles gesetzt.
-\hspace{1cm}
+Das Attribut 'kind\_id' wird 1 gesetzt für die Datei \textit{talaue.shp} (aktuelle Talaue)
-\begin{tabular}[t]{ll}
+und 0 für alle weiteren.
-Pfad        &   Hydrologie/Streckendaten \\
-Geometrie   &   POINT \\
-Attribute   &   Name, name, MPNAAM \\
-\end{tabular}
 \subsubsection{Hochwasserschutzanlagen}
 \hspace{1cm}
 \begin{tabular}[t]{ll}
 Pfad        &   Hydrologie/HW-Schutzanlagen \\
-Geometrie   &   LINESTRING, POINT \\
+Geometrie   &   LINESTRING, MULTILINESTRING, POINT \\
-Attribute   &   name, source, description, status\_date, agency,
+Attribute   &   Name, Art, Quelle, Anmerkung, Stand, Verband,
-dike\_km, range, z\_target, rated\_level, z \\
+km (alternativ: Deich\_km), Bereich,
-\end{tabular}
+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}
 \begin{tabular}[t]{ll}
 \begin{tabular}[t]{ll}
 Pfad        &   Hydrologie/UeSG/Berechnung \\
 Geometrie   &   POLYGON, MULTIPOLYGON \\
 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}
 konfiguriert werden. Öffnen Sie die Datei mit einem Texteditor Ihrer Wahl.

Mercurial > dive4elements > river

comparison backend/doc/documentation/de/importer-geodaesie.tex @ 6751:b5b54e8da1cf double-precision