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

comparison backend/doc/documentation/de/importer-geodaesie.tex @ 8826:2ba30caa5571

Whitespace cleanup.

author	Tom Gottfried <tom@intevation.de>
date	Tue, 16 May 2017 16:00:55 +0200
parents	884617654878
children	21e276cef740

comparison

equal deleted inserted replaced

-:3e212106455c
+:2ba30caa5571
 Parser, der die speziellen Attribute eines Shapefiles liest und in die entsprechende
 Relation der Datenbank schreibt. Die Parser sind speziell auf das
 Dateisystem der BfG ausgerichtet. So wird beispielsweise erwartet, dass die Shapefiles der
 Gewässerachse im Ordner $Geodaesie/Flussachse+km$ liegen. Weitere Informationen zu
 den einzelnen Parsern sind Kapitel \ref{Beschreibung der Parser} zu
 entnehmen.
 Damit die Geodaten eines Shapes später eindeutig in der Datenbank identifiziert
 werden können, wird für jede Geometrie der Pfad des Shapes im Dateisystem
 im Datenbankfeld 'path' gespeichert. Anwendungen, die auf der Datenbank
 aufbauen, können die Geodaten eines Shapefiles später anhand dieses Merkmals
 gruppieren und anzeigen.
 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
 die Daten eines Shapefiles bereits in der Datenbank befinden, oder nicht.
 Ein erneuter Import der Geodaten würde also dazu führen, dass Geometrien doppelt in der
 Datenbank abgelegt werden.
 \subsection{Koordination-Transformation}
 Für die Transformation der Daten verwendet GDAL wiederum die PROJ4-Bibliothek.
 Die Daten werden vor dem Schreiben in die Datenbank alle
 in die Gauß-Krüger-Projektion Zone 3 (EPSG-Code 31467) transformiert.
 Ist für die zu importierenden Daten keine Projektion ersichtlich
 (fehlende \textit{*.prj}-Datei), so findet keine Transformation statt.
 Dies führt nur zu Problemen mit dem Fachdienst FLYS, falls die Daten nicht
 bereits in der genannten Projektion vorlagen.
 Im Falle der Digitalen Geländemodelle (DGM) findet keine Transformation statt,
 da zu diesen lediglich Metadaten in der Datenbank gespeichert werden
 (siehe Kapitel \ref{dgm_parser}),
 während die Daten selbst von der Anwendung Dive4Elements River
 aus dem Dateisystem geholt werden.
 Für Berechnungen mit den DGM werden die Geometrien aus der Datenbank
 in Dive4Elements River in die Projektion des jeweiligen DGM transformiert.
 Daher ist es besonders wichtig, dass die Angaben des EPSG-Codes
 in der Spalte SRID in DGMs.csv korrekt sind (siehe Kapitel \ref{dgm_parser})
 \subsection{Logfile}
 Der Erfolg oder Misserfolg eines Shape-Imports wird
 im Logfile vermerkt. Folgende Einträge können dem Logfile
 entnommen werden:
 \textbf{INFO: Inserted \# features}
 \\Gibt die Anzahl der erfolgreich importierten Features an.
 werden konnten. Wenn etwa Punkte erwartet wurden aber sich im Shapefile
 Polygone befanden.
 \textbf{INFO: Did not import values from fields: '...' ...}
 \\Der Importer schreibt neben der geographischen Information weitere
 Attribut-Daten in die Datenbank.
 Attribut-Spalten die nicht importiert wurden (z.B. auf Grund
 von Tippfehlern oder unterschiedlicher Schreibweise),
 werden wie angegeben im Logfile aufgeführt.
 \textbf{ERROR: No source SRS given! No transformation possible!}
 \textbf{ERROR 1: ORA-01017: invalid username/password; logon denied}
 \\Es konnte keine Verbindung zur Oracle Datenbank hergestellt werden. Prüfen Sie
 die Verbindungseinstellungen.
 Weitere Fehler, die von der Oracle-Datenbank kommen, können ebenfalls im
 Logfile angezeigt werden.
 \subsection{Beschreibung der Parser}
 \label{Beschreibung der Parser}
 \textbf{Attribute}
 \\Eine Liste der Attribute, die vom Parser aus dem Shape gelesen werden.
 In Klammern als alternativ bezeichnete Attribut-Namen werden in
 das gleiche Datenbankfeld geschrieben, wie das vorgenannte Feld.
 Die alternativen Namen werden vom Importer zusätzlich unterstützt,
 um Dateien aus dem heterogenen Bestand der BfG unverändert
 importieren zu können.
 Zudem werden Datenbank-Attribute beschrieben, die nicht direkt aus
 Attribut-Spalten des Shapefiles gelesen werden.
 \subsubsection{Achsen}
 \hspace{5mm}
 \begin{tabular*}{155mm}[t]{l@{\extracolsep\fill}p{125mm}}
 Pfad        &   Geodaesie/Flussachse+km \\
 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.
 Hinweis:
 Da die Layer-Konfiguration (Mapfiles) für die Flussachsen beim Start des
 Artefakt-Servers generiert werden, muss der Artefakt-Server neugestartet
 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{5mm}
 \begin{tabular*}{155mm}[t]{l@{\extracolsep\fill}p{125mm}}
 Pfad        &   Geodaesie/Bauwerke \\
 Geometrie   &   LINESTRING \\
 Attribute   &   Name (alternativ: KWNAAM),
 km (alternativ: station, wsv-km),
 z (alternativ: Höhe, Hoehe, m+NHN)\\
 \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{5mm}
 \begin{tabular*}{155mm}[t]{l@{\extracolsep\fill}p{125mm}}
 \hspace{5mm}
 \begin{tabular*}{155mm}[t]{l@{\extracolsep\fill}p{125mm}}
 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' wird 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{5mm}
 \hspace{5mm}
 \begin{tabular*}{155mm}[t]{l@{\extracolsep\fill}p{125mm}}
 Pfad        &   Hydrologie/HW-Schutzanlagen \\
 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.
 \subsubsection{Buhnen}
 \hspace{5mm}
 \begin{tabular*}{155mm}[t]{l@{\extracolsep\fill}p{125mm}}
 Pfad        &   Geodaesie/Bauwerke/Buhnen.shp \\
 Geometrie   &   POINT \\
 Attribute   &   station (alternativ: km, wsv-km),
 z (alternativ: Hoehe, Höhe, m+NHN) \\
 \end{tabular*}
 Das Attribut 'kind\_id' wird für
 Buhnenkopf (\textit{bkl, bkr, bk}) 0,
 für Buhnenfuß (\textit{bfl, bfr, bf}) 1 und
 für Buhnenwurzel (\textit{bwl, bwr, bw}) 2 gesetzt,
 \subsubsection{Stationierung}
 Attribut    &   Projektion, Höhenstatus, Format, Bruchkanten,
 Auflösung, SRID, Pfad\_Bestand,
 km\_von, km\_bis, Jahr\_von, Jahr\_bis \\
 \end{tabular*}
 Aus der Spalte 'Gewässer' in DGMs.csv wird entnommen,
 für welches Gewässer das angegebene DGM verwendet wird.
 Die Spalte muss daher den exakt gleichen Namen enthalten
 wie in der *.gew-Datei des Gewässers angegeben
 (siehe auch Kapitel \ref{start-hydr}).
 Die eigentlichen Geo-Daten der DGM werden nicht in die Datenbank importiert.
 Diese werden von der Anwendung Dive4Elements River aus dem Dateisystem geholt.
 \subsection{Konfiguration}
 \textbf{HOST}
 \\Der Host der Datenbank.
 \textbf{BACKEND\_NAME}
 \\Der Name der Datenbank Instanz.
 Beispielsweise \textit{XE} bei einer Oracle XE Instanz.
 \textbf{USER}
 \\Der Nutzer, der zum Verbinden zur Datenbank verwendet wird.

Mercurial > dive4elements > river

comparison backend/doc/documentation/de/importer-geodaesie.tex @ 8826:2ba30caa5571