[Wsplgen-commits] r65 - trunk/doc/Dokumentation

[scm-commit@wald.intevation.org]

Author: mrchip
Date: 2006-10-05 21:21:36 +0200 (Thu, 05 Oct 2006)
New Revision: 65

Modified:
   trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex
Log:
Nur ein Test

Modified: trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex
===================================================================
--- trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex	2006-09-25 20:54:55 UTC (rev 64)
+++ trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex	2006-10-05 19:21:36 UTC (rev 65)
@@ -34,7 +34,7 @@
 \RCS$Id$
 \RCS$Revision$
 
-\newcommand{\documentdate}{17. September 2006}
+\newcommand{\documentdate}{20. September 2006}
 \newcommand{\documentrevision}{\RCSRevision}
 \newcommand{\documentversion}{0.9.17}
 \newcommand{\documentID}{\RCSId}
@@ -1113,10 +1113,21 @@
 
 \subsection{Digitales Geländemodell (DGM)}\label{subsec:file-dgm}
 
-Das digitale Geländemodell darf in drei verschiedenen Dateiformaten vorliegen,
-die im Folgenden näher beschrieben werden.
+Das digitale Geländemodell darf in fünf verschiedenen Dateiformaten vorliegen,
+die im Folgenden näher beschrieben werden. Die Unterscheidung welches Dateiformat vorliegt, trifft WSPLGEN
+anhand der Endung des Dateinames.
 
+\begin{tabular}{lclcl}
+{\bf Endung} & {\bf Dateiformat} \\
+ADF & ESRI TIN-Format \\
+GRD & ESRI ASCII Raster-Datei-Format \\
+SHP & ESRI POINT-Shape-Format \\
+TXT & ASCII-Format mit X,Y,Z-Tripeln \\
+XYZ & ASCII-Format mit X,Y,Z-Tripeln \\
+2DM & Generic-Format der Software SMS \\
+\end{tabular}
 
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
@@ -1296,6 +1307,64 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+\subsubsection{ESRI-POINT-Shape-Format}
+
+\begin{tabular}{lp{4cm}lcl}
+{\bf Name} & {\bf Beschreibung} &{\bf Datentyp} & {\bf Wertebereich} & {\bf Einheit}\\
+X & X-Koordinate & Float & - & m \\
+Y & Y-Koordinate & Float & - & m \\
+Z & Z-Koordinate & Float & - & m \\
+\end{tabular}
+
+\vspace{1cm minus 0.5cm}
+
+Beim POINT-Shape-Format handelt es sich um das Standard-Shape-Format von ESRI, das entweder Punkte mit oder ohne Z-Anteil
+enthalten darf (POINT oder POINTZ). Wenn nur Punkte ohne Z-Anteil vorliegen, wird versucht die Höhe über ein Attribut
+zu bestimmen. Das Attribut muss dann vom Typ Fließkommazahl (Float) sein. Der Name das Attributes lautet dann \verb;Z.
+
+Hinweis: Für den Attributnamen werden aber auch verschiedene andere Namen akzeptiert (z.B. Hoehe, Topo, mNN).
+ 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\subsubsection{2DM-Format}
+
+\begin{tabular}{lp{4cm}lcl}
+{\bf Name} & {\bf Beschreibung} &{\bf Datentyp} & {\bf Wertebereich} & {\bf Einheit}\\
+X & X-Koordinate & Float & - & m \\
+Y & Y-Koordinate & Float & - & m \\
+Z & Z-Koordinate & Float & - & m \\
+Nr1 & Punkt-Nr & Integer & - & - \\
+Nr2 & Punkt-Nr & Integer & - & - \\
+Nr3 & Punkt-Nr & Integer & - & - \\
+\end{tabular}
+
+\vspace{1cm minus 0.5cm}
+
+Das 2DM-Format wird von der Software SMS benutzt, um Modelle für die zweidimensionale Modellierung zu speichern.
+Es ist in zwei Bereich aufgeteilt. Zuerst werden die Elemente eines Netztes definiert und danach die Knoten.
+Jeder Zeile enthält dabei genau ein Element oder einen Knoten oder weitere Informatioen, die für WSPLGEn nicht relevant sind.
+
+Jedes Element beginnt mit der Zeichenkette ET3 gefolgt von einer Nummer und den 3 Nummern der Knoten die das Element bilden. Am Ende steht noch ein
+Wert für die Rauhheiten, der genau wie die Elementnummer für WSPLGEN unwichtig ist.
+
+Die Knoten beginnen immer mit ND gefolgt von der Knotennummer, die von den Elementen verwendet wird und den X-, Y- und Z- Koordinaten.
+Format Beispiel:
+
+\begin{verbatim}
+ET3 1 1 2 3
+ET3 1 2 1 4
+ET3 1 2 4 5
+ND 1 3456453.23 5345312.13 23.23
+ND 2 3456465.12 5345323.34 34.54
+ND 3 3456423.02 5345328.46 1.23
+ND 4 3456412.34 5345328.21 456.4
+ND 5 3456412.00 5345393.02-1.2
+\end{verbatim}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 \subsection{Profilspuren}\label{subsubsec:file-profile}
 
 \begin{tabular}{lp{4cm}lcl}
@@ -2023,7 +2092,7 @@
 
 \textbf{Rückgabewert: 1222}\\
 Fehler: Der Parameter \verb;-DGM; liefert einen Dateinamen mit einer ungültigen Erweiterung.\\
-Erklärung: Es sind nur die Erweiterungen ,,.ADF'', ,,.XYZ'' oder ,,.GRD'' erlaubt.
+Erklärung: Es sind nur die Erweiterungen ,,.ADF'', ,,.GRD'', ,,.SHP'', ,,.XYZ'', ,,.TXT'' oder ,,.2DM'' erlaubt.
 
 \textbf{Rückgabewert: 1123}\\
 Warnung: Der Parameter \verb;-ACHSE; wurde verwendet, obwohl der Parameter \verb;-GEL;
@@ -2323,6 +2392,12 @@
 
 \subsection{Sonstige Fehler: Fehlergruppe 9xxx}
 
+\textbf{Rückgabewert: 9201}\\
+Fehler: Es steht nicht genug Speicher zur Verfügung.\\
+Erklärung: Es steht nicht genug Arbeitsspeicher zur Verfügung. Die Ausführung des Programmes
+muss beendet werden. Man kann versuchen andere Programme zu beenden oder eine kleinere
+Gewässerstrecke zu bearbeiten (siehe Abschnitt~\ref{subsec:param-strecke}).
+
 \textbf{Rückgabewert: 9197}\\
 Warnung: Es ist ein abgefangener logischer Programmfehler aufgetreten.\\
 Erklärung: Dieser Fehler deutet auf einen Programmfehler hin, der nicht erwartet
@@ -2470,6 +2545,10 @@
 Im gesamten Text wurde das Attribut \verb;GRADIENT; durch \verb;ROHR2; ersetzt.
 Entsprechend heisst das Attribut \verb;ROHR; nun \verb;ROHR1;.
 
+{\bf Version: 0.9.17, Datum: 20.09.2006}
+
+Abschnitt~\ref{subsec:file-dgm}: Die verschiedenen Dateitypen für DGM-Dateien
+und die Erkennung ihres Formates durch die Endung der Dateinamen wurde erklärt.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%