From: Timo Heister Date: Tue, 14 May 2019 03:44:14 +0000 (-0600) Subject: address change requests X-Git-Tag: v9.2.0-rc1~1494^2~2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9a9030e5d60f774d5ae10e8e0e16b0573daae621;p=dealii.git address change requests --- diff --git a/examples/step-63/doc/intro.dox b/examples/step-63/doc/intro.dox index 13b887749d..d18a9fc56a 100644 --- a/examples/step-63/doc/intro.dox +++ b/examples/step-63/doc/intro.dox @@ -6,85 +6,76 @@ The creation of this tutorial was partially supported by NSF Award DMS-1522191, DMS-1901529, OAC-1835452, by the Computational Infrastructure in Geodynamics initiative (CIG), through the NSF under Award EAR-0949446 and EAR-1550901 and The University of California - -Davis, and by Technical Data Analysis, Inc. through US Navy STTR -N16A-T003. +Davis.

Introduction

-This program solves an advection-diffusion problem using a geometric -multigrid preconditioner. The basics of this preconditioner are -discussed in step-16; here we discuss the necessary changes needed for -a non-symmetric PDE, we introduce the idea of block smoothing (as -compared to point smoothing), and examine the effects of DoF -renumbering for additive and multiplicative methods. +This program solves an advection-diffusion problem using a geometric multigrid +preconditioner. The basics of this preconditioner are discussed in step-16; +here we discuss the necessary changes needed for a non-symmetric +PDE. Additionally, we introduce the idea of block smoothing (as compared to +point smoothing in step-16), and examine the effects of DoF renumbering for +additive and multiplicative smoothers.

Equation

The advection-diffusion equation is given by - @f{align*}{ --\varepsilon \Delta u + \vec{\beta}\cdot \nabla u & =& f & -\text{ on } \Omega\\ -u &=& g & \text{ on } \partial\Omega +-\varepsilon \Delta u + \boldsymbol{\beta}\cdot \nabla u & = f & +\text{ in } \Omega\\ +u &= g & \text{ on } \partial\Omega @f} +where $\varepsilon>0$, $\boldsymbol{\beta}$ is the advection +direction, and $f$ is a source. A few notes: -where $\varepsilon>0$, $\vec{\beta}$ is the \textit{advection -direction}, and $f$ is a source. A few notes: - -1. If $\vec{\beta}=\vec{0}$, this is the Laplace equation solved in -step-16 (and many other places). +1. If $\boldsymbol{\beta}=\boldsymbol{0}$, this is the Laplace equation solved in step-16 +(and many other places). -2. If $\varepsilon=0$ then this is the advection equation solved in +2. If $\varepsilon=0$ then this is the stationary advection equation solved in step-9. -3. If $\varepsilon \ll \norm{\vec{\beta}},$ we say the problem is -\textit{advection-dominated}, else we say the problem is -\textit{diffusion-dominated}. +3. If $\varepsilon \ll \|\boldsymbol{\beta}\|$, we say the problem is +advection-dominated, else we say the problem is +diffusion-dominated. For the discussion in this tutorial we will be concerned with advection-dominated flow. Using the standard Galerkin finite element method, for suitable test -function $v_h$, the discretized weak form of the PDE reads - +functions $v_h$, the discrete weak form of the PDE reads @f{align*}{ -a(u_h,\v_h) = F(v_h) +a(u_h,v_h) = F(v_h) @f} - where - @f{align*}{ -a(u_h,\v_h) &= (\nabla u_h,\, \nabla v_h) + (\vec{\beta}\cdot\nabla u_h,\,v_h)\\ -F(v_h) &= (f,\,v) +a(u_h,v_h) &= (\varepsilon \nabla u_h,\, \nabla v_h) + (\boldsymbol{\beta}\cdot\nabla u_h,\,v_h),\\ +F(v_h) &= (f,\,v_h). @f}

Streamline diffusion

The following error estimate can be shown for this PDE: - @f{align*}{ -\norm{\nabla (u-u_h)} \leq (1+\mathcal{P}) \inf_{v_h} \norm (\nabla (u-v_h)} +\|\nabla (u-u_h)\| \leq (1+\mathcal{P}) \inf_{v_h} \|\nabla (u-v_h)\| @f} - -where $\mathcal{P} \sim \norm{\vec{\beta}}/\varepsilon$ (referred -to as the \textit{Peclet} number). This implies that we may have poor -numerical solutions when $\varepsilon \ll \norm{\vec{\beta}}$. To +where $\mathcal{P} \sim \|\boldsymbol{\beta}\|/\varepsilon$ (referred +to as the Peclet number). This implies that we may have poor +numerical solutions when $\varepsilon \ll \|\boldsymbol{\beta}\|$. To combat this, we will consider the new weak form - @f{align*}{ -a(u_h,\,v_h) + (-\varepsilon \Delta u_h + \vec{\beta}\cdot -\nabla u_h-f,\,\delta \vec{\beta}\cdot \nabla v_h) = F(v_h) +a(u_h,\,v_h) + \sum_K (-\varepsilon \Delta u_h + \boldsymbol{\beta}\cdot +\nabla u_h-f,\,\delta \boldsymbol{\beta}_K\cdot \nabla v_h)_K = F(v_h) @f} - -where $\delta$ is a stabilization parameter defined in -On Discontinuity—Capturing Methods for Convection—Diffusion Equations -by Volker and Petr. Essentially, adding in the discrete strong -form residual enhances the coercivity of the bilinear form -$a(\cdot,\cdot)$ which increases the stability of the discrete -solution. This method is commonly referred to as \textit{streamline -diffusion} or \textit{SUPG} (streamline upwind/Petrov-Galerkin). +where the sum is done over all cells $K$ with the inner product is understood +on that cell, and $\delta_K$ is a cell-wise constant stabilization parameter +defined in On +Discontinuity-Capturing Methods for Convection-Diffusion Equations by Volker +John and Petr Knobloch. Essentially, adding in the discrete strong form +residual enhances the coercivity of the bilinear form $a(\cdot,\cdot)$ which +increases the stability of the discrete solution. This method is commonly +referred to as streamline diffusion or SUPG (streamline +upwind/Petrov-Galerkin).

Smoothers

@@ -98,12 +89,13 @@ best be explained within the framework of additive and multiplicative Schwarz methods. In contrast to step-16, our test problem contains an advective -term. Especially with small viscosity, information is transported along -streamlines in the given advection direction. This means that smoothers are -likely to be more effective, if they allow information to travel in downstream -direction within a single smoother application. This requires reordering -degrees of freedom or cells (for the cell-based smoothers) accordingly. The -influence of the ordering will be visible in the results section. +term. Especially with a small diffusion constant $\varepsilon$, information is +transported along streamlines in the given advection direction. This means +that smoothers are likely to be more effective, if they allow information to +travel in downstream direction within a single smoother application. This +requires reordering degrees of freedom or cells (for the cell-based smoothers) +accordingly. The influence of the ordering will be visible in the results +section. Let us now briefly define the smoothers used in this tutorial. A Schwarz preconditioner requires a decomposition @@ -137,12 +129,13 @@ logic for the Schwarz operator operating on the subproblems (in deal.II they are called "blocks"), is done in the class RelaxationBlock. The "Block Jacobi" method is implemented in the class RelaxationBlockJacobi. Many aspects of the class (for example how the blocks are defined and how to invert -the local subproblems $A_j$ can be configured in the smoother data (see -RelaxationBlock::AdditionalData and DoFTools::make_cell_patches). +the local subproblems $A_j$) can be configured in the smoother data, see +RelaxationBlock::AdditionalData and DoFTools::make_cell_patches for details. So far, we discussed additive smoothers where the updates can be applied independently and there is no information flowing within a single smoother -application. A multiplicative Schwarz preconditioner addresses this by +application. A multiplicative Schwarz preconditioner addresses this +and is defined by @f{align*}{ B^{-1} = \left( I- \prod_{j=1}^J I-P_J \right) A^{-1}. @f} @@ -162,29 +155,27 @@ seen as a multiplicative Schwarz method with a subproblem for each DoF.

Test problem

We will be considering the following test problem: $\Omega = -[-1,\,1]\times[-1,\,1]$ with circle of radius 0.3 centered at the -origin removed, $\varepsilon=0.005$, $\vec{\beta} = +[-1,\,1]\times[-1,\,1]$ with a circle of radius 0.3 centered at the +origin removed, $\varepsilon=0.005$, $\boldsymbol{\beta} = [-\sin(\pi/6),\,\cos(\pi/6)]$, $f=0$, and the boundary function - @f{align*}{ g = \left\{\begin{array}{ll} 1 & x=-1 \text{ OR } y=-1,\,x\geq 0.5 \\ 0 & \text{else} \end{array}\right. @f} The following figures depict the solutions with (left) and without -(right) streamline diffusion. Without streamline diffusion we see high +(right) streamline diffusion. Without streamline diffusion we see large oscillations around the boundary layer, demonstrating the instability -of the standard Galerkin finite elements for this problem. +of the standard Galerkin finite element method for this problem. - +
- -
+ +
- diff --git a/examples/step-63/doc/results.dox b/examples/step-63/doc/results.dox index c89903afdf..fe3193f73b 100644 --- a/examples/step-63/doc/results.dox +++ b/examples/step-63/doc/results.dox @@ -9,11 +9,22 @@ tutorial is also $\mathcal{O}(n)$, all one needs to do is show that the iteration counts for the GMRES solve stay roughly constant as we refine the mesh. -Each of the following tables gives the GMRES iteration counts to -reduce the initial residual by 1e8. +Each of the following tables gives the GMRES iteration counts to reduce the +initial residual by 1e8. We selected a sufficient number of smoothing steps +(based on the method) to get iteration numbers independent of mesh size. In +this case, the method is indeed $\mathcal{O}(n)$.

DoF/Cell Renumbering

+The point-wise smoothers ("Jacobi" and "SOR") get applied in the order the +DoFs are numbered on each level. We can influence this using the +DoFRenumbering namespace. The block smoothers are applied based on the +ordering we set in @p setup_smoother. We can visualize this numbering. The +following picture shows the cell numbering of the active cells in upstream, +random, and downstream numbering (left to right): + + + Starting with the additive smoothers, we see that renumbering the DoFs/cells has no effect on convergence speed. This is because these smoothers compute operations on each DoF (point-smoother) or cell diff --git a/examples/step-63/step-63.cc b/examples/step-63/step-63.cc index a53c43ed3e..0e061b3f2c 100644 --- a/examples/step-63/step-63.cc +++ b/examples/step-63/step-63.cc @@ -200,7 +200,7 @@ namespace Step63 smoother_type = prm.get("Smoother type"); smoothing_steps = prm.get_integer("Smoothing steps"); - std::string renumbering = prm.get("DoF renumbering"); + const std::string renumbering = prm.get("DoF renumbering"); if (renumbering == "none") dof_renumbering = DoFRenumberingStrategy::none; else if (renumbering == "downstream") @@ -1143,7 +1143,7 @@ namespace Step63 data_out.add_data_vector(cell_indices, "cell_index"); data_out.build_patches(); - std::string filename = + const std::string filename = "solution-" + Utilities::int_to_string(cycle) + ".vtu"; std::ofstream output(filename.c_str()); data_out.write_vtu(output);