%vim:set tw=68:
% $Source: /home/bricks/source/greater/cvs/greaterrepository/greater-pre-processing/doc/greater-preprocessing-manual.tex,v $
% $Id: greater-preprocessing-manual.tex,v 1.9 2007-06-06 16:30:05 frank Exp $
\documentclass[a4paper,twoside,BCOR19mm]{scrbook}
\usepackage[latin1]{inputenc}
\usepackage{graphicx}
\usepackage{epsf}
\usepackage{lscape}
\usepackage{color}
\usepackage{Manual}
\usepackage{ManualTabular}
\usepackage{fancyhdr}
\usepackage{times}
\usepackage{lastpage}

\def\CVS$#1: #2 ${\expandafter\def\csname CVS#1\endcsname{#2}}
\CVS$Id: greater-preprocessing-manual.tex,v 1.9 2007-06-06 16:30:05 frank Exp $

%----------------------------------------------
% Document DATE and VERSION
% set these values when releasing a new version

\newcommand{\documentdate}{06.June.2007}
\newcommand{\documentversion}{1.2.0p2}
\newcommand{\documentID}{\CVSId}

%----------------------------------------------

\newcommand{\FigExplanation}[3]%
{
	\refstepcounter{FigCnt}
	\addcontentsline{lof}{figure}%
		{\protect\numberline{\thechapter.\arabic{FigCnt}}{#2}}
	\mbox{#1}
\nopagebreak

	{Figure \thechapter.\arabic{FigCnt}: \it #3}
}

\begin{document}

%-----------------------------------
% define header/footer
% The settings here are for single page documents (only odd page set)

% for some pages latex switches back to pagestyle plain :-(
\fancypagestyle{plain}{%
	\fancyhf{} % clear all header and footer fields
	\fancyhead[LO,RE]{\footnotesize GREAT-ER Preprocessing Manual\\ \leftmark}
	\fancyfoot[RO,LE]{\footnotesize Intevation GmbH} % Author
	\fancyfoot[CO,CE]{\footnotesize \thepage/\pageref{LastPage}}
	% set the document title for the footer here!
	\fancyfoot[LO,RE]{\footnotesize \documentdate 
	\\\documentID}
	\renewcommand{\footrulewidth}{0.4pt}
}

% and now define pagestyle fancy
\fancyhead{} % clear all fields
\fancyhead[LO,RE]{\footnotesize GREAT-ER Preprocessing Manual\\ \leftmark}

\fancyfoot{}% clear all fields
\fancyfoot[RO,LE]{\footnotesize Intevation GmbH} % Author
\fancyfoot[CO,CE]{\footnotesize \thepage/\pageref{LastPage}}
% set the document title for the footer here!
\fancyfoot[LO,RE]{\footnotesize \documentdate 
\\\documentID}

\renewcommand{\footrulewidth}{0.4pt}

\pagestyle{fancy}

%-----------------------------------

\parindent0cm

%-----------------------------------
% TITLE PAGE
{
	\includegraphics[width=0.3\textwidth]{./images/intevation-logo.eps}\\[0.1cm]

	 {\tt http://intevation.net}\\[2.0cm] 
}

% reenter the TITLE here
{
	\sffamily\bfseries\Large 
% e.g.:
	GREAT-ER II\\[0.5cm]
	\huge GREAT-ER Preprocessing Manual\\[4cm]

}

% a possible SUBTITLE
%\begin{flushleft}
%	\sffamily\bfseries\large 
%    	by Intevation GmbH\\[0.5cm]
%\end{flushleft}

\thispagestyle{empty}

\vfill

{\sffamily\small
	Intevation GmbH\\
	Georgstraße 4\\
	D-49074 Osnabrück\\
	Germany\\
	\\
	Date: \documentdate
}


\newpage

\vfill

This document has been designed with \LaTeX{}.
It is available as source code, PDF- and HTML-format.\\

Version: \documentversion \\
Date: \documentdate \\
Authors: Jan-Oliver Wagner $\cdot$ Frank Koormann

\vfill

\begin{center}Copyright (c) 2002 - 2007 Intevation GmbH.\end{center}

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled ``GNU
Free Documentation License''.

\tableofcontents

\chapter{Introduction}

The \GREATER\ pre-processing is a script-based routine to prepare
a \GREATER\ catchment dataset from raw data in a pre-defined text format.

This document intends to enable the reader to prepare catchments
for use with the \GREATER\ simulation system. The process as a whole
is described as well as technical details on how the procedure works
and on how to apply the associated software tools that actually perform
the processing. The commented source code itself (released as Free Software)
completes the documentation on all details.

Current information, all source codes, documentation and a mailing list
can be found at the \GREATER\ development homepage:

\verb"http://great-er.intevation.org/"

\section{History}

The pre-processing routines originate from the GREAT-ER 1 project as
a script collection and have been further improved since then.

The major changes from \GREATER\ version 1.0 to version 2.0 are:

\begin{itemize}

\item	Availability as Free Software.

\item	Independency from proprietary software (especially ArcInfo
		which was a major drawback due to its high license costs).

\item	Replacement of ArcInfo coverage format by ESRI Shapefile format
		for all geographic data.

\end{itemize}

The detailed changes of the present version are listed in the file
\verb"Changes.txt" of the pre-processing software package.

\newpage

\section{Requirements}

Applying the \GREATER\ pre-processing requires experience
with Unix-like systems; principle programming skills are helpful.

The basic requirements are

\begin{itemize}

\item	a usual Unix-like system 
		including the standard GNU software tools
		(recommended is a GNU/Linux system).
		
\item	The programming language Python which is usually available on
		such systems, but they may not be updated to Python version 2.2.1
		as required for the pre-processing.

\item	The special tools \verb"gen2shp", \verb"txt2dbf" and \verb"dbf2txt".

\end{itemize}

Details, e.g. on specific versions on the required tools are given
in the Howto-section (see below).

%
% *************************************************************************
%

\include{howto}

\include{sourcefiles}

\include{resultfiles}

\include{theory}

\begin{appendix}

\chapter*{References}
\addcontentsline{toc}{chapter}{References}

\begin{description}
\item Boeije, G. (1999).
	Chemical Fate Prediction for Use in Geo-Referenced Environmental
	Exposure Assessment. PhD thesis, University of Ghent, Belgium.

\item Chapra, Steven C. (1997).
	Surface Water-Quality Modeling. McGraw-Hill, New York.

\item
	Deutscher Kanu-Verband (1985).
	Deutsches Flußwanderbuch,
	22. Auflage, DKV Wirtschafts- und Verlags GmbH, Duisburg.

\item Dyck, S. \& Peschke, G. (1989).
	Grundlagen der Hydrologie. Verlag für Bauwesen, Berlin.

\item Gustard, A., Bullock, A. \& Dixon, J.M. (1992).
	Low flow estimation in the United Kingdom.
	Institute of Hydrology report 108, Wallingford.

\item Koorman, F. (1997).
	Organische Schadstoffe im Fließgewässernetz Rhein 
	Modellierung, Simulation, Visualisierung 
	von chemischen Zwischenprodukten. Diplomarbeit, University of Osnabrück. 

\item Koormann, F., Matthies, M., Trapp, S. (1998).
       Simulation and Visualisation of Spatial Exposure Patterns:
       Intermediates in the Rhine River System,
       In: Regulation for Chemical Safety in Europe:
       Analysis, Comment and Criticism (Eds.
       D.M. Pugh, J.V. Tarazona), Kluwer Academic Publishers,
       Dordrecht, pp. 65 - 96.

\item Leopold, L.B. \& Maddock, T. (1953).
	The Hydraulic Geometry Channels and Some Physiographic Implications.
	Geographical Survey Professional Paper 252, Washington DC, USA.

\item
	Miller, S.N., D.P. Guertin and D.C. Goodrich (1996).
	Linking GIS and Geomorphologic Field Research at Walnut Gulch
	Experimental Watershed.
	Proceedings of the AWRA's 32nd Annual Conference and
	Symposium: "GIS and Water Resources", Sept. 22-26, 1996,
	Fort Lauderdale, FL. pp. 327-335.

\item
	Miller, S.N., M. Hernandez and L.J. Lane (1997).
	GIS applications in the spatial extrapolation of hydrologic data
	from experimental watersheds.
	Proceedings of the Conference on Management of Landscapes
	Disturbed by Channel Incision, Oxford, MS, USA, May 20-22, 1997.

\item Römpp Lexikon Umwelt (1997).
	Version 1.0, Georg Thieme    
	Verlag, Stuttgart / New York.

\item
	Round, C.E., Young, A.R. \& Fox, K. (1998).
	A Regionally Applicable Model for Estimating
	Flow Velocity at Ungauged River Sites in the UK - Contribution to
	GREAT-ER \#4. Water and Environmental Management 12, pp. 402-405.

\item Schulze, C. (1998).
	Modellierung und Visualisierung der Konzentration von
	Waschmittelinhaltsstoffen in der Itter. Diplomarbeit,
	University of Osnabrück.

\item Schulze, C., Matthies, M., Trapp, S., Schröder, F.R. (1999).
	Georeferenced Fate Modelling of LAS in the Itter Stream.
	Chemosphere, 39(11), 1833-1852.

\item Simons, D. B. \& Albertson, M. L. (1960).
	Uniform water conveyance channels in alluvial material.
	Proc. Am. Soc. Civ. Engg., J. Hydraulics Div., 86, pp.33ff.

\end{description}

\include{gnufdl}

\end{appendix}

\end{document}
