[Wsplgen-commits] r46 - trunk/doc/Dokumentation
scm-commit@wald.intevation.org
scm-commit at wald.intevation.org
Wed Apr 12 09:51:43 CEST 2006
Author: mrchip
Date: 2006-04-12 09:51:43 +0200 (Wed, 12 Apr 2006)
New Revision: 46
Modified:
trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex
Log:
Es wurden zwei neue Parameter aufgenommen: -STRECKE und -MAXKNOTEN
Modified: trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex
===================================================================
--- trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex 2006-04-08 21:52:17 UTC (rev 45)
+++ trunk/doc/Dokumentation/WSPLGEN-Dokumentation.tex 2006-04-12 07:51:43 UTC (rev 46)
@@ -31,9 +31,9 @@
% EDIT HERE
\def\RCS$#1: #2 ${\expandafter\def\csname RCS#1\endcsname{#2}}
\RCS$Id$
-\RCS$Revision: 38 $
+\RCS$Revision: 44 $
-\newcommand{\documentdate}{08. April 2006}
+\newcommand{\documentdate}{11. April 2006}
\newcommand{\documentrevision}{\RCSRevision}
\newcommand{\documentversion}{0.9.11}
\newcommand{\documentID}{\RCSId}
@@ -807,6 +807,34 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{MAXKNOTEN (Anzahl der Geländepunkte)}\label{subsec:param-maxknoten}
+
+\begin{tabular}{p{2.4cm}p{2.5cm}p{2.5cm}p{2.5cm}p{3.0cm}}
+{\bf Kurzfassung} & \multicolumn{4}{l}{Anzahl der Geländepunkte}\\
+{\bf Format} & \multicolumn{4}{l}{-MAXKNOTEN=$<$Anzahl$>$}\\
+{\bf Status} & \multicolumn{4}{l}{Optional}\\
+{\bf Argumente} & \em Name & \em Typ & \em Einheit & \em Standardwert\\
+ & Anzahl & Ganzzahl & - & - \\
+{\bf Beispiel} & \multicolumn{4}{l}{-MAXKNOTEN=200000}\\
+\end{tabular}
+
+\vspace{1cm plus 0.5cm minus 0.5cm}
+
+Der Parameter \verb;MAXKNOTEN; dient dazu das Verhalten von WSPLGEN reproduzierbar
+zu machen.
+
+Da das Programm ohne den Parameter die Anzahl von Geländepunkte im DGM, die gleichzeitig
+in einem Bearbeitungsschritt geladen werden selbst anhand des aktuell zur Verfügung stehenden
+Arbeitsspeichers und der Rechneleistung bestimmt, kann es immer wieder zu einer anderen Bildung
+von Bearbeitungsabschnitten kommen. Mit diesem Parameter wird der Wert nicht mehr von WSPLGEN ermittelt,
+sondern vom Benutzer fest vorgegeben. Man sollte den Wert aber nicht ohne zwingenden Grund deutlich
+von dem Wert abweichen lassen, den WSPLGEN ohne den Parameter ermittelt hätte.
+
+Ohne das Argument ist der Parameter sinnlos.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
\subsection{PRO (Profilspuren)}\label{subsec:param-profile}
\begin{tabular}{p{2.4cm}p{2.5cm}p{2.5cm}p{2.5cm}p{3.0cm}}
@@ -838,6 +866,42 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{STRECKE (Begrenzung des Berechnungsstrecke)}\label{subsec:param-strecke}
+
+\begin{tabular}{p{2.4cm}p{2.5cm}p{2.5cm}p{2.5cm}p{3.0cm}}
+{\bf Kurzfassung} & \multicolumn{4}{l}{Begrenzung der Berechnungsstrecke}\\
+{\bf Format} & \multicolumn{4}{l}{-STRECKE=$<$Von$>$,$<$Bis$>$}\\
+{\bf Status} & \multicolumn{4}{l}{Optional}\\
+{\bf Argumente} & \em Name & \em Typ & \em Einheit & \em Standardwert\\
+ & Von & Float & km & $-\infty$ \\
+ & Bis & Float & km & $+\infty$ \\
+{\bf Beispiel} & \multicolumn{4}{l}{-STRECKE=100.5,123.0}\\
+\end{tabular}
+
+\vspace{1cm plus 0.5cm minus 0.5cm}
+
+Die Option \verb;-STRECKE; bestimmt, welche Profile für die Berechnung verwendet werden sollen und
+damit auch die Berechnungsstrecke. Es werden also nur die Profile eingelesen, die eine Station haben,
+die zwischen \verb;<Von>; und \verb;<Bis>; liegt (siehe auch Abschnitt~\ref{subsubsec:file-profile}).
+
+Der Parameter \verb;-STRECKE; sollte nur verwendet werden, wenn nur ein Gewässer bearbeitet wird, da
+er für alle Gewässer gleich angewendet wird, was selten sinnvoll sein dürfte.
+
+Wird das Argument \verb;<Bis>; weggelassen, so werden alle Profile bearbeitet, die eine
+Station größer gleich \verb;<Von>; aufweisen.
+
+Beispiel: \verb;-STECKE=20.450;
+
+Wird das Argument \verb;<Von>; weggelassen, so werden alle Profile bearbeitet, die eine
+Station kleiner gleich \verb;<Bis>; aufweisen.
+
+Beispiel: \verb;-STECKE=,20.450;
+
+Ganz ohne die Argumente ist der Parameter sinnlos.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
\subsection{WSP (Wasserstände)}\label{subsec:param-wsp}
\begin{tabular}{p{2.4cm}p{2.5cm}p{2.5cm}p{2.5cm}p{3.0cm}}
@@ -1553,16 +1617,18 @@
\newpage
\section{Parameter}\label{sec:parameter}
-\begin{tabular}{|l|p{3.3cm}|p{2.6cm}|p{2.6cm}|p{4.4cm}|}\hline
+\begin{tabular}{|l|p{3.2cm}|p{2.4cm}|p{2.2cm}|p{4.1cm}|}\hline
Parameter & Argumente & Typ & Einheit & Standardwert\\\hline
-PAR & Parameter-Datei & Pfadangabe & - & keiner - $<$optional$>$ \\\hline
-DELTA & \verb;<Von>;\newline \verb;<Bis>;\newline \verb;<Diff>; & Kommazahl \newline Kommazahl \newline Kommazahl & Meter\newline Meter\newline Meter & 0\newline Maximaler Wasserstand\newline (BIS - VON) / 10 \\\hline
-GEL & \verb;<Typ>; & Auswahl & SPERRE \newline NOSPERRE & SPERRE \\\hline
-DGM & DGM-Datei & Pfadangabe & - & keiner $<$erforderlich$>$\\\hline
-PRO & Profilspuren-Datei & Pfadangabe & - & keiner $<$erforderlich$>$\\\hline
-WSP & WSP-Datei & Pfadangabe & - & keiner $<$erforderlich$>$\\\hline
-LIN & Linien-Datei & Pfadangabe & - & keiner - $<$optional$>$ \\\hline
-AUSGABE & Ausgabe-Datei & Pfadangabe & - & WSPLGEN.SHP \\\hline
+PAR & Parameter-Datei & Pfadangabe & - & keiner - $<$optional$>$\\\hline
+DELTA & \verb;<Von>;\newline \verb;<Bis>;\newline \verb;<Diff>; & Kommazahl \newline Kommazahl \newline Kommazahl & Meter\newline Meter\newline Meter & 0\newline Maximaler Wasserstand\newline (BIS - VON) / 10\\\hline
+GEL & \verb;<Typ>; & Auswahl & SPERRE \newline NOSPERRE & SPERRE\\\hline
+DGM & DGM-Datei & Pfadangabe & - & keiner $<$erforderlich$>$\\\hline
+PRO & Profilspuren-Datei & Pfadangabe & - & keiner $<$erforderlich$>$\\\hline
+STRECKE & \verb;<Von>;\newline \verb;<Bis>; & Kommazahl \newline Kommazahl & Kilometer\newline Kilometer & $-\infty$\newline $+\infty$\\\hline
+WSP & WSP-Datei & Pfadangabe & - & keiner $<$erforderlich$>$\\\hline
+LIN & Linien-Datei & Pfadangabe & - & keiner - $<$optional$>$\\\hline
+MAXKNOTEN & \verb;<Anzahl>; & Ganzzahl & - & keiner - $<$optional$>$\\\hline
+AUSGABE & Ausgabe-Datei & Pfadangabe & - & WSPLGEN.SHP \\\hline
\end{tabular}
@@ -1635,7 +1701,7 @@
ungeschützte Leerzeichen verwendet (siehe Abschnit~\ref{sec:param}).
\textbf{Rückgabewert: 1108}\\
-Warnung: Parameter DELTA ohne Argumente aufgerufen\\
+Warnung: Parameter DELTA Argumente aufgerufen\\
Beschreibung: Der Parameter DELTA kann auch ohne Parameter aufgerufen werden. Es werden dann nur
Standardwerte für alle drei Argumente verwendet. Wenn dies gewünscht ist, braucht der Parameter
überhaupt nicht angegeben zu werden. Das er doch gefunden wurde, könnte an einer falschen Aufrufsyntax liegen.
@@ -1722,6 +1788,20 @@
die WSPLGEN nicht bekannt sind. Der Parameter bzw. die Zeichenkette werden ignoriert.
Wahrscheinlich wurde ein Parameter falsch geschrieben.
+\textbf{Rückgabewert: 1225}\\
+Fehler: Parameter \verb;-MAXKNOTEN; ohne Argumente aufgerufen\\
+Beschreibung: Der Parameter \verb;-MAXKNOTEN; braucht immer das Argument \verb;<Anzahl>;.
+Wird es nicht angegeben, so handelt es sich sicher um einen Tippfehler in der Kommandozeile
+oder der Parameterdatei, wenn eine verwendet wurde.
+
+\textbf{Rückgabewert: 1226}\\
+Fehler: Parameter \verb;-STRECKE; ohne Argumente aufgerufen\\
+Beschreibung: Der Parameter \verb;-STRECKE; braucht mindestens eines der Argumente
+\verb;<Von>; oder \verb;<Bis>;. Werden sie beide nicht angegeben, so handelt es
+sich sicher um einen Tippfehler in der Kommandozeile oder der Parameterdatei,
+wenn eine verwendet wurde.
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -1920,10 +2000,15 @@
muss verständlicherweise immer positiv sein.
\textbf{Rückgabewert: 3112}\\
-Fehler: Das Attribut für die ,,Sperren'' und ,,Brüche'' ist weder \verb;SPERRE; noch \verb;BRUCH;.\\
+Warnung: Das Attribut für die ,,Sperren'' und ,,Brüche'' ist weder \verb;SPERRE; noch \verb;BRUCH;.\\
Erklärung: Für das Attribut \verb;TYP; sind nur die Werte \verb;SPERRE; oder verb;BRUCH;
erlaubt. Jedes Linienobjekt mit einem anderen Attribut wird ignoriert.
+\textbf{Rückgabewert: 3113}\\
+Warnung: Der Parameter \verb;-STECKE; wurde verwendet, aber es wird mehr als ein Gewässer bearbeitet.
+Erklärung: Der Parameter \verb;-STECKE; wird für alle Gewässer gleich angewendet, was in
+den seltensten Fällen sinnvolle Ergebnisse liefern wird.
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -2010,6 +2095,16 @@
Tippfehler bzgl. der ,,Sperren'' und ,,Brüche'' behoben. In diesem Abschnitt war aber
sogar der Wertebereich des Attributes \verb;TYP; nicht korrekt.
+{\bf Version: 0.9.11, Datum: 11.04.2006}
+
+Abschnitte \ref{subsec:param-strecke} und \ref{sec:fehlermeldungen}, Fehlercode 1226, 3113:
+Es wurde der Parameter \verb;-STRECKE; hinzugefügt.
+
+Abschnitte \ref{subsec:param-maxknoten} und \ref{sec:fehlermeldungen}, Fehlercode 1225:
+Es wurde der Parameter \verb;-MAXKNOTEN; hinzugefügt.
+
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
More information about the Wsplgen-commits
mailing list