\renewcommand{\documentID}{}

\chapter{Catchment Result Files Formats}

Currently two versions of the results files can be created:

OUT-VERSION = 1.0: creates catchment datasets compatible with GREAT-ER 1.

OUT-VERSION = 2.0: creates catchment datasets compatible with GREAT-ER 2 and 3.
The difference is additional columns down1 and down2 in river.dbf
and different Stretch-Types for lakes. Furthermore, no background
file backgroundlst.dbf is created.
\\

A special result is the logfile, ID.log. It contains among various
standard logging, the results of a number of plausibility checks
(e.g. test for plausible river flows).
\\

Another special results file is catchment.thuban, which is a session
file for Thuban, a viewer for geographic information (thuban.intevation.org).
GREAT-ER 3 is implemented ontop of Thuban.

\section{Map Layers}

\begin{itemize}
\item	River Network Map Layer, Files rivernet.(shp,shx,dbf)
\item	Discharge Sites Map Layer, Files discharges.(shp,shx,dbf)
\item	Catchment Boundary Map Layer, Files catchbound.(shp,shx,dbf)
\item	Discharge-River Connection Map Layer, Files disch\_river.(shp,shx,dbf)
\item	Picture Sites Map Layer, Files pics.(shp,shx,dbf)
\end{itemize}

\section{River Network Attributes, File river.dbf}

\begin{tabular}{l|l|p{10cm}}
Fieldname & Type & Description \\
\hline
StretchID	& I(10)		& ID of the stretch (unique) \\
type		& I(2)		& -2, 0, 1 or 2 for OUT-FORMAT == 1.0.
							For OUT-FORMAT == 2.0, the type 6,8,9 and 10
							(ie. base type +8) are the corresponding types
							indicating lakes.\\
IsDisch		& I(1)		& 1 if a discharge site is connected to this
							stretch. Else 0.\\
up1			& I(10)		& StrethID of upstream stretch (corresponds to type) \\
up2			& I(10)		& StrethID of upstream stretch (corresponds to type) \\
down1		& I(10)		& StrethID of downstream stretch.
							Only for OUT-FORMAT == 2.0 \\
down2		& I(10)		& StrethID of downstream stretch.
							Only for OUT-FORMAT == 2.0 \\
rivclass	& I(5)		& ID for river class. \\
QMean		& R(12,5)	& Mean flow volume (assuming log-normal distribution)
							in $m^2/s$.\\
Q5			& R(12,5)	& 5th percentile of flow volume (assuming log-normal
							distribution) in $m^2/s$. Sometimes also referred
							to as "95 percentile low flow" \\
vMean		& R(12,5)	& Mean flow velocity (assuming log-normal distribution)
							in $m/s$.\\
v5			& R(12,5)	& 5th percentile of flow velocity (assuming log-normal
							distribution) in $m/s$.\\
RealLength	& R(20,10)	& The length of the stretch in $m$. \\
depthMean	& R(12,5)	& Mean depth (assuming log-normal distribution) in
							$m$.\\
depth5		& R(12,5)	& 5th percentile of depth (assuming log-normal
							distribnution in $m$. \\
Name		& C(60)		& A name for the stretch (river name).\\
\end{tabular}

\section{Discharge Site Data, File disch.dbf}

\begin{tabular}{l|l|p{10cm}}
Fieldname & Type & Description \\
\hline
DischID		& I(10)		& ID of the discharge site (unique). \\
StretchID	& I(10)		& ID of the stretch the discharge is connected to. \\
MarketID	& I(10)		& ID of the Market information connected to this
							discharge.\\
Pop			& I(10)		& Population connected to the dischage (real population,
							not population equivalents). \\
DWF			& R(20,10)	& Dry Whether Flow in $m^3/s$. \\
flow\_dom	& R(20,10)	& Domestic flow in $m^3/s$. \\
flow\_nondo	& R(20,10)	& Non-domestic flow in $m^3/s$. \\
flow\_runof	& R(20,10)	& Runoff-flow in $m^3/s$. \\
Flow		& R(20,10)	& Actual effluent flow in $m^3/s$ \\
treated		& R(10,5)	& Fraction of flow that is treated. \\
WWTPID		& I(10)		& ID of the WWTP class of this discharge. \\
wwtp\_frac	& R(10,5)	& Fraction that is removed by the WWTP. \\
Name		& C(40)		& Name of the discharge. \\
\end{tabular}

\section{Discharge Classes, File wwtp.dbf}

This file is created as a constant file by the pre-processing.
For GREAT-ER 3, the classes are already incorporated into the
database and will likely not require an update.

For units and further description, please refer to the corresponding
documentation of GREAT-ER 3.\\

\begin{tabular}{l|l|p{10cm}}
Fieldname & Type & Description \\
\hline
WWTPID			& I(4)		& ID of the WWWP (unique). \\
mode			& I(1)		& (only GREAT-ER 1.X) default mode. \\
WWTPtype		& I(1)		& Sewage treatment processing type. \\
prim\_pres		& I(1)		& (only GREAT-ER 1.X) Is a primary settler present
							  (1), else (0). \\
cap\_prim		& R(10,5)	& (only GREAT-ER 1.X) capacity primary settler. \\
depth\_prim		& R(10,5)	& Primary settler depth. \\
v\_over\_pri	& R(10,5)	& Primary settler overflow rate. \\
R\_SS\_prim		& R(10,5)	& Maximum primary settler solids removal. \\
depth\_sec		& R(10,5)	& Second settler depth. \\
v\_over\_sec	& R(10,5)	& Second settler overflow rate. \\
R\_SS\_sec		& R(10,5)	& Maximum second settler solids removal. \\
capa\_sec		& R(10,5)	& (only GREAT-ER 1.X) capacity secondary settler. \\
nr\_PE			& I(10)		& (only GREAT-ER 1.X) number of Population
							  Equivalents.\\
SS\_ML			& R(10,5)	& Mixed liqor SS. \\
recycle			& R(10,5)	& Sludge recycling ratio. \\
a\_biomass		& R(10,5)	& Biomass activity correction. \\
depth\_ML		& R(10,5)	& Mixed liquor tank depth. \\
B\_X			& R(10,5)	& Sludge loading rate. \\
Y				& R(10,5)	& Biomass yield. \\
DO				& R(10,5)	& Actual DO inaeration tank.  \\
aer\_type		& I(1)		& Aeration type: 0=Bubble, 1=Surface. \\
f\_aerobic		& R(10,5)	& Aerobic redox fraction in mixed liquor tank. \\
f\_anoxic		& R(10,5)	& Anoxic redox fraction in mixed liquor tank. \\
f\_anaerob		& R(10,5)	& Anaerobic redox fraction in mixed liquor tank. \\
eps\_N			& R(10,5)	& Nitrification efficiency. \\
eps\_DN			& R(10,5)	& Denitrification efficiency. \\
WWTPdescr		& C(40)		& Description of the WWTP class. \\
\end{tabular}

\section{River Classes, File rivclass.dbf}

This file is created as a constant file by the pre-processing.
For GREAT-ER 3, the classes are already incorporated into the
database and will likely not require an update.

For units and further description, please refer to the corresponding
documentation of GREAT-ER 3.\\

\begin{tabular}{l|l|p{10cm}}
Fieldname & Type & Description \\
\hline
RivClassID		& I(4)		& ID of the river class (unique). \\
mode			& I(1)		& (only GREAT-ER 1.X) default mode. \\
IsLake			& I(1)		& (only GREAT-ER 1.X) is this river a lake? \\
cor\_riv\_cs	& R(10,5)	& (only GREAT-ER 1.X) \\
SS\_mean		& R(10,5)	& Mean river suspended solids concentration. \\
SS\_stdev		& R(10,5)	& Standard deviation river suspended solids
							  concentration.\\
k\_SS\_mean		& R(10,5)	& (only GREAT-ER 1.X) \\
k\_SS\_stdev	& R(10,5)	& (only GREAT-ER 1.X) \\
f\_oc			& R(10,5)	& River suspended solids organic carbon fraction. \\
v\_sed\_grow	& R(10,5)	& Sediment growth velocity. \\
eps\_sed		& R(10,5)	& Sediment porosity. \\
ro\_SS\_sed		& R(10,5)	& Sediments solid particle density. \\
X				& R(10,5)	& Lumped river biomass level. \\
DO\_mean		& R(10,5)	& Mean Dissolved Oxygen. \\
DO\_setdev		& R(10,5)	& Standard deviation Dissolved Oxygen. \\
BOD\_mean		& R(10,5)	& (only GREAT-ER 1.X) \\
BOD\_stdev		& R(10,5)	& (only GREAT-ER 1.X) \\
pH\_mean		& R(10,5)	& Mean acidity value. \\
pH\_stdev		& R(10,5)	& Standard deviation acidity value. \\
a\_rivclass		& R(10,5)	& (only GREAT-ER 1.X) \\
k\_light		& R(10,5)	& Light extinction coefficient. \\
\end{tabular}

\section{Background Data List, File backgroundlst.dbf}

Only for OUT-FORMAT == 1.0.

\begin{tabular}{l|l|p{7cm}}
Fieldname 	& Type  & Description \\
\hline
Name		& C[30]	& Title of the layer. \\ 
Mapname		& C[25] & Filename of the layer. \\
Type		& C[20] & Type (e.g. polygon, image, grid). \\
Legendfile	& C[25] & Filename of legend file. \\
ctch\_fl	& C[8]	& "yes" or "no" indicating whether there is some
					  some special treatmemt (eg. for DCW). \\
\end{tabular}
