Mercurial > dive4elements > river
comparison backend/doc/documentation/de/importer-hydr-morph.tex @ 6675:c4e69a97e223 double-precision
Importer doc: fixed typos, language and formatting issues for hydrological data
| author | Tom Gottfried <tom.gottfried@intevation.de> |
|---|---|
| date | Fri, 26 Jul 2013 16:25:36 +0200 |
| parents | 516032b7df62 |
| children | d226f76f880a |
comparison
equal
deleted
inserted
replaced
| 6674:516032b7df62 | 6675:c4e69a97e223 |
|---|---|
| 13 Sollte beim Lese- oder Schreib-Vorgang eines Gewässers ein Fehler auftreten, so | 13 Sollte beim Lese- oder Schreib-Vorgang eines Gewässers ein Fehler auftreten, so |
| 14 werden sämtliche Daten des Gewässers verworfen. Beide Phasen zusammen bilden | 14 werden sämtliche Daten des Gewässers verworfen. Beide Phasen zusammen bilden |
| 15 somit eine Transaktion. | 15 somit eine Transaktion. |
| 16 | 16 |
| 17 \textbf{Hinweis} | 17 \textbf{Hinweis} |
| 18 \\Der Import geht wie auch Desktop-FLYS davon aus, dass die Dateien Latin-1 | 18 \\Der Import geht, wie auch Desktop-FLYS, davon aus, dass die Dateien Latin-1 |
| 19 encodiert vorliegen! Stellen Sie also sicher, dass das von Ihnen verwendete | 19 encodiert vorliegen! Stellen Sie also sicher, dass das von Ihnen verwendete |
| 20 Encoding korrekt ist. Andernfalls ist es möglich, dass es während des Imports zu | 20 Encoding korrekt ist. Andernfalls ist es möglich, dass es während des Imports zu |
| 21 unerwarteten Problemen kommt. | 21 unerwarteten Problemen kommt. |
| 22 | 22 |
| 23 Der Importer ist ein in Java geschriebenes Werkzeug und kann von der Konsole aus | 23 Der Importer ist ein in Java geschriebenes Werkzeug und kann von der Konsole aus |
| 30 \begin{lstlisting} | 30 \begin{lstlisting} |
| 31 java -Dflys.backend.importer.dry.run=true de.intevation.flys.importer.Importer | 31 java -Dflys.backend.importer.dry.run=true de.intevation.flys.importer.Importer |
| 32 \end{lstlisting} | 32 \end{lstlisting} |
| 33 | 33 |
| 34 Auf gleiche Weise können dem Importer sämtliche Optionen zur Konfiguration | 34 Auf gleiche Weise können dem Importer sämtliche Optionen zur Konfiguration |
| 35 beim Start mitgegeben werden. Im Folgenden werden die möglichen System-Properties und | 35 beim Start mitgegeben werden. Im Folgenden werden die möglichen \textit{System-Properties} und |
| 36 ihre Auswirkung auf den Import genauer beschrieben. In den Kapiteln | 36 ihre Auswirkung auf den Import genauer beschrieben. In den Kapiteln |
| 37 \ref{configuration} und \ref{start-hydr} wird zur Einfachheit jedoch ein | 37 \ref{configuration} und \ref{start-hydr} wird zur Einfachheit jedoch ein |
| 38 Shellskript verwendet, das eine Standardkonfiguration vorgibt und den Importer | 38 Shellskript verwendet, das eine Standardkonfiguration vorgibt und den Importer |
| 39 mit allen erforderlichen Konfigurationen startet. | 39 mit allen erforderlichen Konfigurationen startet. |
| 40 | 40 |
| 41 | 41 |
| 42 \subsection{Importierte Daten} | 42 \subsection{Importierte Daten} |
| 43 In diesem Kapitel werden die Datentypen aufgelistet und erläutert, wie sie vom | 43 In diesem Kapitel werden die verschiedenen Daten aufgelistet und erläutert, wie sie vom |
| 44 Importer eingelesen werden. | 44 Importer eingelesen werden. |
| 45 | 45 |
| 46 \subsubsection{Streckenfavoriten (*.km-Dateien)} | 46 \subsubsection{Streckenfavoriten (*.km-Dateien)} |
| 47 Der Import der Streckenfavoriten kann mit \textbf{-Dflys.backend.importer.skip.annotations=true} | 47 Der Import der Streckenfavoriten kann mit \textbf{-Dflys.backend.importer.skip.annotations=true} |
| 48 unterdrückt werden. | 48 unterdrückt werden. |
| 52 XML-Datei angegeben werden. In dieser Datei werden die Typen und Regeln | 52 XML-Datei angegeben werden. In dieser Datei werden die Typen und Regeln |
| 53 festgelegt, anhand derer die Klassifikation während des Import-Vorgangs | 53 festgelegt, anhand derer die Klassifikation während des Import-Vorgangs |
| 54 vorgenommen wird. Details hierzu befinden sich im Kapitel \ref{annotation-types}. | 54 vorgenommen wird. Details hierzu befinden sich im Kapitel \ref{annotation-types}. |
| 55 | 55 |
| 56 \subsubsection{Bundeswasserstraßen-IDs} | 56 \subsubsection{Bundeswasserstraßen-IDs} |
| 57 Der Import und die Zuweisung der Bundeswasserstraßen-IDs kann mit | 57 Der Import und die Zuweisung der Bundeswasserstraßen-IDs kann unterbunden werden |
| 58 \textbf{-Dflys.backend.importer.skip.bwastr=true} unterbunden werden. | 58 mit \textbf{-Dflys.backend.importer.skip.bwastr=true}. |
| 59 Beim Import wird davon ausgegangen dass sich die Datei \textbf{BWASTR\_ID.csv} | 59 Beim Import wird davon ausgegangen, dass sich die Datei \textbf{BWASTR\_ID.csv} |
| 60 neben der oder den zu importierenden gew-Dateien befindet. | 60 neben der oder den zu importierenden gew-Dateien befindet. |
| 61 | 61 |
| 62 \subsubsection{Pegel, Stammdaten (*.glt, *.at und *.sta-Dateien)} | 62 \subsubsection{Pegel- und Stammdaten (*.glt, *.at und *.sta-Dateien)} |
| 63 Der Import von Pegel- und Stammdaten kann mit \textbf{'-Dflys.backend.importer.skip.gauges=true'} | 63 Der Import von Pegel- und Stammdaten kann mit \textbf{'-Dflys.backend.importer.skip.gauges=true'} |
| 64 unterdrückt werden. Die .glt-Datei, die neben der .wst-Datei liegt, wird zuerst | 64 unterdrückt werden. Die .glt-Datei, die neben der .wst-Datei liegt, wird zuerst |
| 65 ausgelesen. Es werden nur Stammdaten von Pegeln geladen, die in der .glt-Datei | 65 ausgelesen. Es werden nur Stammdaten von Pegeln geladen, die in der .glt-Datei |
| 66 vermerkt sind. | 66 vermerkt sind. |
| 67 | 67 |
| 70 Praxis ist \textit{QWD} eine sinnvolle Belegung. | 70 Praxis ist \textit{QWD} eine sinnvolle Belegung. |
| 71 | 71 |
| 72 Der Import von Wasserständen kann mit \textbf{-Dflys.backend.importer.skip.wst=true} unterdrückt werden. | 72 Der Import von Wasserständen kann mit \textbf{-Dflys.backend.importer.skip.wst=true} unterdrückt werden. |
| 73 | 73 |
| 74 \subsubsection{Historische Abflusstafeln (*.at-Dateien)} | 74 \subsubsection{Historische Abflusstafeln (*.at-Dateien)} |
| 75 Der Import von historischen Abflusstafeln kann mit | 75 Mit \textbf{'-Dflys.backend.importer.skip.historical.discharge.tables=true'} |
| 76 \textbf{'-Dflys.backend.importer.skip.historical.discharge.tables=true'} | 76 kann der Import von historischen Abflusstafeln |
| 77 unterdrückt werden. Diese Flagge wird nur ausgewertet, wenn überhaupt | 77 unterdrückt werden. Diese Flagge wird nur ausgewertet, wenn überhaupt |
| 78 Pegel-Daten (siehe oben) importiert werden. | 78 Pegel-Daten (siehe oben) importiert werden. |
| 79 | 79 |
| 80 % Mittels \textbf{-Dflys.backend.sta.parse.gauge.numbers=true} wird versucht, die | 80 % Mittels \textbf{-Dflys.backend.sta.parse.gauge.numbers=true} wird versucht, die |
| 81 % offiziellen Pegelnummern aus den Stammdaten zu extrahieren. | 81 % offiziellen Pegelnummern aus den Stammdaten zu extrahieren. |
| 82 % \textbf{Dies ist mit Vorsicht zu behandeln, denn die meisten STA-Dateien | 82 % \textbf{Dies ist mit Vorsicht zu behandeln, denn die meisten STA-Dateien |
| 83 % enthalten invalide Pegelnummern.} | 83 % enthalten invalide Pegelnummern.} |
| 84 | 84 |
| 85 \subsubsection{Zusätzliche Längsschnitte (*.zus, *.wst-Dateien)} | 85 \subsubsection{Zusätzliche Längsschnitte (*.zus, *.wst-Dateien)} |
| 86 Der Import von zusätzlichen Längsschnitten kann mit \textbf{-Dflys.backend.importer.skip.extra.wsts=true} | 86 Mit \textbf{-Dflys.backend.importer.skip.extra.wsts=true} kann |
| 87 der Import von zusätzlichen Längs\-schnitten | |
| 87 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis | 88 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis |
| 88 \textit{../Zus.Längsschnitte} relativ zur gewaesser.wst-Datei betrachtet. | 89 \textit{../Zus.Längsschnitte} relativ zur |
| 90 \textit{gewaesser}.wst-Datei betrachtet. | |
| 89 | 91 |
| 90 \subsubsection{Fixierungen (*.wst-Dateien)} | 92 \subsubsection{Fixierungen (*.wst-Dateien)} |
| 91 Der Import von Fixierungen kann mit \textbf{-Dflys.backend.importer.skip.fixations=true} | 93 Der Import von Fixierungen kann mit \textbf{-Dflys.backend.importer.skip.fixations=true} |
| 92 unterdrückt werden. Es werden die *.wst-Dateien aus dem Verzeichnis | 94 unterdrückt werden. Es werden die *.wst-Dateien aus |
| 93 \textit{../Fixierungen} relativ zur gewaesser.wst-Datei betrachtet. | 95 \textit{../Fixierungen} relativ zur \textit{gewaesser}.wst-Datei betrachtet. |
| 94 | 96 |
| 95 \subsubsection{Amtliche Linien (*.wst-Dateien)} | 97 \subsubsection{Amtliche Linien (*.wst-Dateien)} |
| 96 Der Import von amtlichen Linien kann mit \textbf{-Dflys.backend.importer.skip.official.lines=true} | 98 Der Import von amtlichen Linien kann mit \textbf{-Dflys.backend.importer.skip.official.lines=true} |
| 97 unterdrückt werden. Es werden die \textit{Amtl\_Linien.wst}-Dateien aus dem | 99 unterdrückt werden. Es werden die \textit{Amtl\_Linien.wst}-Dateien aus dem |
| 98 Verzeichnis \textit{../Basisdaten} und \textit{../Fixierungen} relativ zur | 100 Verzeichnis \textit{../Basisdaten} und \textit{../Fixierungen} relativ zur |
| 99 \textit{gewaesser.wst}-Datei betrachtet. | 101 \textit{gewaesser.wst}-Datei betrachtet. |
| 100 | 102 |
| 101 Für die Zuordnung zu den Hauptwerten wird zudem die Datei | 103 Für die Zuordnung zu den Hauptwerten wird zudem die Datei |
| 102 \textit{Amtl_Linien.config} benötigt. | 104 \textit{Amtl\_Linien.config} benötigt. |
| 103 | 105 |
| 104 \subsubsection{Profilspuren (*.prf-Dateien)} | 106 \subsubsection{Profilspuren (*.prf-Dateien)} |
| 105 Der Import von Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.prfs=true} | 107 Der Import von Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.prfs=true} |
| 106 unterdrückt werden. Es werden rekursiv alle *.prf-Dateien aus \textit{../../..} | 108 unterdrückt werden. Es werden rekursiv alle *.prf-Dateien aus \textit{../../..} |
| 107 relativ zur gewaesser.wst-Datei betrachtet. | 109 relativ zur gewaesser.wst-Datei betrachtet. |
| 111 ausgeschlossen. | 113 ausgeschlossen. |
| 112 | 114 |
| 113 \subsubsection{Profilspuren (*.w80-Dateien)} | 115 \subsubsection{Profilspuren (*.w80-Dateien)} |
| 114 Der Import von W80-Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.w80s=true} | 116 Der Import von W80-Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.w80s=true} |
| 115 unterdrückt werden. Es werden rekursiv alle *.w80-Dateien aus \textit{../../..} | 117 unterdrückt werden. Es werden rekursiv alle *.w80-Dateien aus \textit{../../..} |
| 116 relativ zur \textid{gewaesser}.wst-Datei betrachtet. | 118 relativ zur \textit{gewaesser}.wst-Datei betrachtet. |
| 117 | 119 |
| 118 \subsubsection{Profilspuren (*.d50-Dateien)} | 120 \subsubsection{Profilspuren (*.d50-Dateien)} |
| 119 Der Import von D50-Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.da50s=true} | 121 Der Import von D50-Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.da50s=true} |
| 120 unterdrückt werden. Es werden rekursiv alle *.d50-Dateien aus \textit{../../..} | 122 unterdrückt werden. Es werden rekursiv alle *.d50-Dateien aus \textit{../../..} |
| 121 relativ zur \textid{gewaesser}.wst-Datei betrachtet. | 123 relativ zur \textit{gewaesser}.wst-Datei betrachtet. |
| 122 | 124 |
| 123 \subsubsection{Profilspuren (*.d66-Dateien)} | 125 \subsubsection{Profilspuren (*.d66-Dateien)} |
| 124 Der Import von D66-Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.da66s=true} | 126 Der Import von D66-Profilspuren kann mit \textbf{-Dflys.backend.importer.skip.da66s=true} |
| 125 unterdrückt werden. Es werden rekursiv alle *.d66-Dateien aus \textit{../../..} | 127 unterdrückt werden. Es werden rekursiv alle *.d66-Dateien aus \textit{../../..} |
| 126 relativ zur \textid{gewaesser}.wst-Datei betrachtet. | 128 relativ zur \textit{gewaesser}.wst-Datei betrachtet. |
| 127 | 129 |
| 128 \subsubsection{Profilspuren (*.csv-Dateien)} | 130 \subsubsection{Profilspuren (*.csv-Dateien)} |
| 129 Der Import von CSV-Profilspuren kann mit | 131 Der Import von CSV-Profilspuren kann mit |
| 130 \textbf{-Dflys.backend.importer.skip.w80.csvs=true} | 132 \textbf{-Dflys.backend.importer.skip.w80.csvs=true} |
| 131 unterdrückt werden. | 133 unterdrückt werden. |
| 134 Gewässers betrachtet. | 136 Gewässers betrachtet. |
| 135 | 137 |
| 136 \subsubsection{Hydraulische Kennzahlen (*.hyk)} | 138 \subsubsection{Hydraulische Kennzahlen (*.hyk)} |
| 137 Der Import von hydraulischen Kennzahlen kann mit \textbf{-Dflys.backend.importer.skip.hyks=true} unterdrückt | 139 Der Import von hydraulischen Kennzahlen kann mit \textbf{-Dflys.backend.importer.skip.hyks=true} unterdrückt |
| 138 werden. Es werden rekursiv alle *.hyk-Dateien aus \textit{../../..} relativ zur | 140 werden. Es werden rekursiv alle *.hyk-Dateien aus \textit{../../..} relativ zur |
| 139 gewaesser.wst-Datei betrachtet. Vor dem Import werden mit Hilfe eines Längen- und | 141 \textit{gewaesser}.wst-Datei betrachtet. Vor dem Import werden mit Hilfe eines Längen- und |
| 140 eines MD5-Summen-Vergleichs inhaltliche Duplikate ausgeschlossen. | 142 eines MD5-Summen-Vergleichs inhaltliche Duplikate ausgeschlossen. |
| 141 | 143 |
| 142 \subsubsection{Hochwassermarken (*.zus, *.wst)} | 144 \subsubsection{Hochwassermarken (*.zus, *.wst)} |
| 143 Der Import von Hochwassermarken kann mit \textbf{-Dflys.backend.importer.skip.flood.water=true} | 145 Der Import von Hochwassermarken kann mit \textbf{-Dflys.backend.importer.skip.flood.water=true} |
| 144 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis | 146 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis |
| 145 \textit{../HW-Marken} relativ zur gewaesser.wst-Datei betrachtet. | 147 \textit{../HW-Marken} relativ zur \textit{gewaesser}.wst-Datei betrachtet. |
| 146 | 148 |
| 147 \subsubsection{Hochwasserschutzanlagen (*.zus)} | 149 \subsubsection{Hochwasserschutzanlagen (*.zus, *.wst)} |
| 148 Der Import von Hochwasserschutzanlagen kann mit \textbf{-Dflys.backend.importer.skip.flood.protection=true} | 150 Mit \textbf{-Dflys.backend.importer.skip.flood.protection=true} |
| 151 kann der Import von Hochwasserschutzanlagen | |
| 149 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis | 152 unterdrückt werden. Es werden die *.zus- und *.wst-Dateien aus dem Verzeichnis |
| 150 \textit{../HW-Schutzanlagen} relativ zur \textit{gewaesser.wst}-Datei betrachtet. | 153 \textit{../HW-Schutzanlagen} relativ zur \textit{gewaesser.wst}-Datei betrachtet. |
| 151 | 154 |
| 152 \subsubsection{Sohlhöhen (Peilungen)} | 155 \subsubsection{Sohlhöhen (Peilungen)} |
| 153 Der Import von Sohlhöhen-Peilungen kann mit \textbf{-Dflys.backend.importer.skip.bed.height.single=true} | 156 Der Import von Sohlhöhen-Peilungen kann mit \textbf{-Dflys.backend.importer.skip.bed.height.single=true} |