From 0bb6ce89729ab0c85a2e4fe90e8699cb0e9a9f92 Mon Sep 17 00:00:00 2001 From: Christoph Grueninger <christoph.grueninger@iws.uni-stuttgart.de> Date: Fri, 4 Sep 2015 15:47:51 +0000 Subject: [PATCH] [handbook] Improve sub-section concerning available models. git-svn-id: svn://svn.iws.uni-stuttgart.de/DUMUX/dumux/trunk@15445 2fb0f335-1f38-0410-981e-8018bf24f1b0 --- doc/handbook/4_newtoninanutshell.tex | 2 +- doc/handbook/5_models.tex | 30 ++++++++++++---------------- 2 files changed, 14 insertions(+), 18 deletions(-) diff --git a/doc/handbook/4_newtoninanutshell.tex b/doc/handbook/4_newtoninanutshell.tex index a034ee0a50..1bb2748c92 100644 --- a/doc/handbook/4_newtoninanutshell.tex +++ b/doc/handbook/4_newtoninanutshell.tex @@ -104,7 +104,7 @@ used to order the blocks. \node at (10,4) {${eqIdx}$}; \node at (10,3.4) {$0$}; \node at (10,2.8) {$1$}; - \node at (10,2.2) {$\dots$}; + \node at (10,2.2) {$\vdots$}; \node at (10,1.6) {$m-1$}; \fill (11.1,2.1) rectangle (11.3,2.9); diff --git a/doc/handbook/5_models.tex b/doc/handbook/5_models.tex index 6e8e6a408a..673364e66a 100644 --- a/doc/handbook/5_models.tex +++ b/doc/handbook/5_models.tex @@ -124,35 +124,31 @@ $\boldsymbol{v}_\alpha$ & velocity (Darcy or free flow)& & \\ \end{figure} \subsection{Available Models} -\todo{modelliste einfügen, auf doxygen verweisen, Text überarbeiten (Christoph)} - -The following description of the available models is automatically extracted -from the Doxygen documentation. - -\subsection{Implicit and Decoupled Models} +We distinguish fully-implicit and decoupled models. A list of all available models can be found +in the Doxygen documentation at +\url{http://www.dumux.org/doxygen-stable/html-2.8/modules.php}. +The documentation includes a detailed description for every model. \subsubsection{Fully-Implicit Models} -\todo{überarbeiten (Christoph)} -The fully-implicit models described in this section are using the box or the -cell centered finite volume method as described in section \ref{box} and \ref{cc} +The fully-implicit models are using the box or the +cell-centered finite volume method as described in section \ref{box} and \ref{cc} for spatial and the implicit Euler -method as temporal discretization. The models themselves are located in -subdirectories of \texttt{dumux/implicit} of the \Dumux distribution. +method as temporal discretization. The models are located in +subdirectories of \texttt{dumux/implicit}. \subsubsection{Decoupled Models} -\todo{überarbeiten (Christoph)} -The basic idea the so-called decoupled models have in common is to reformulate the +The basic idea of the decoupled models is to reformulate the equations of multi-phase flow into one equation for -pressure and equations for phase-/component-/etc. transport. The pressure equation +pressure and equations for phase/component/... transport. The pressure equation is the sum of the mass balance equations and thus considers the total flow of the fluid system. The new set of equations is considered as decoupled (or weakly coupled) -and can thus be solved sequentially. The most popular decoupled model is the so-called +and can thus be solved sequentially. The most popular decoupled model is the fractional flow formulation for two-phase flow which is usually implemented applying an IMplicit Pressure Explicit Saturation algorithm (IMPES). In comparison to a fully implicit model, the decoupled structure allows the use of different discretization methods for the different equations. The standard method -used in the decoupled models is a cell centered finite volume method. Further schemes, -so far only available for the two-phase pressure equation, are cell centered finite +used in the decoupled models is a cell-centered finite volume method. Further schemes, +so far only available for the two-phase pressure equation, are cell-centered finite volumes with multi-point flux approximation (MPFA O-method) and mimetic finite differences. An $h$-adaptive implementation of both decoupled models is provided for two dimensions. -- GitLab