Chapter 3
Computational Exercises

3.1 One dimensional integration in a standard segment

In this first exercise we will demonstrate how to integrate the function f(ξ) = ξ12 on the standard segment ξ ∈ [-1,1] using Gaussian quadrature. The Gaussian quadrature weights and zeros are coded in the LIbUtilities library and for future reference this can be found under the directory $NEKDIST/library/LibUtilities/Foundations/. For the following exercises we will access the zero and points from the PointsManager. The PointsManager is a type of map (or manager) which requires a key defining known Gaussian quadrature types called PointsKey.

In the $NEKDIST/tutorial/fundamentals-integration/tutorial directory open the file named StdIntegration1D.cpp. Look over the comments supplied in the file which outline how to define the number of quadrature points to apply, the type of Gaussian quadrature and some arrays to hold the zeros, weights and solution. Finally a PointsKey is defined which is then used to obtain the zeros and weights in two arrays called quadZeros and quadWeights.

Task: 3.1

Implement a short block of code where you see the comments “Write your code here” which evaluates the loop

∫ 1         i<Q∑max
   f (ξ)dξ ≃       wif (zi).
 -1           i=0

To compile your code type

make StdIntegation1D

in the tutorial directory. When your code compiles successfully1 then type

./StdIntegration1D

You should now get some output similar to

====================================================== 
|        INTEGRATION ON A 1D STANDARD REGION         | 
====================================================== 
Integrate the function f(xi) = xi^12 on the standard 
segment xi=[-1,1] with Gaussian quadrature 
         Q = 4: Error = 0.179594

Task: 3.2 Evaluate the previous integral for a quadrature order of Q = Qmax where Qmax = 7 is the number of quadrature points required for an exact evaluation of the integral (calculate this value analytically). Verify that the error is zero (up to numerical precision).

We can also use Gauss-Lobatto-Legendre type integration rather than Gauss-Legendre type in the previous exercises. To do this we replace

LibUtilities::PointsType quadPointsType = 
                        LibUtilities::eGaussGaussLegendre;

with

LibUtilities::PointsType quadPointsType = 
                        LibUtilities::eGaussLobattoLegendre;

Task: 3.3 Evaluate the previous integral for a quadrature order of Q = Qmax where Qmax = 7 and 8 to verify that to exactly integrate with Gauss-Lobatto type integration you require an additional quadrature point and weights.

3.2 Two-dimensional integration in a standard and local region

3.2.1 Quadrilateral element in a standard region

A straightforward extension of the one-dimensional Gaussian rule is to the two-dimensional standard quadrilateral region and similarly to the three-dimensional hexahedral region. Integration over Q2 = {-1 ≤ ξ12 ≤ 1} is mathematically defined as two one-dimensional integrals of the form

                         {                  }
∫                    ∫ 1   ∫ 1       ||
   2 u(ξ1,ξ2) dξ1 dξ2 =        u(ξ1,ξ2)||   dξ1  dξ2.
 Q                    - 1   -1        ξ2

So if we replace the right-hand-side integrals with our one-dimensional Gaussian integration rules we obtain

                           (                 )
∫                    q∑1- 1  { q∑2-1            }
 Q2 u(ξ1,ξ2) dξ1 dξ2 ≃    wi(     wj u(ξ1i,ξ2j)) ,
                     i=0     j=0

where q1 and q2 are the number of quadrature points in the ξ1 and ξ2 directions. This expression will be exact if u(ξ12) is a polynomial and q1,q2 are chosen appropriately. To numerically evaluate this expression the summation over ‘i’ must be performed q1 times at every ξ2i point, that is,

∫                      q -1
                        1∑
 Q2 u (ξ1,ξ2) dξ1 dξ2 ≃     wi f(ξ1i),
                        i=0
                       q2∑-1
             f(ξ1i)  =      wj u(ξ1i,ξ2j).
                        j=0

Task: 3.4 Integrate the function f(ξ12) = ξ112 ξ214 on the standard quadrilateral element Q ∈ [-1,1] × [-1,1] using Gaussian quadrature.

Using a series of one-dimensional Gaussian quadrature rules as outlined above evaluate the integral by completing the first part of the code in the file StdIntegration2D.cpp in the directory

$NekDist/tutorial/fundamentals-integration/tutorial.

The quadrature weights and zeros in each of the coordinate directions have already been setup and are initially set to q1 = 6,q2 = 7 using a Gauss-Lobatto-Legendre quadrature rule. Complete the code by writing a structure of loops which implement the two-dimensional Gaussian quadrature rule2 . The expected output is given below). Also verify that the error is zero when q1 = 8,q2 = 9.

Recall that to compile the file you type

make StdIntegration2D

When executing the tutorial with the quadrature order q1 = 6,q2 = 7 you should get an output of the form:

============================================================= 
|        INTEGRATION ON 2 DIMENSIONAL ELEMENTS              | 
============================================================= 
 
Integrate the function f(x1,x2) = (x1)^12*(x2)^14 
on the standard quadrilateral element: 
         q1 = 6, q2 = 7: Error = 0.00178972

3.2.2 General straight-sided quadrilateral element


PIC

Figure 3.1: To construct a C0 expansion from multiple elements of specified shapes (for example, triangles or rectangles), each elemental region Ωe is mapped to a standard region Ωst in which all local operations are evaluated.


For elemental shapes with straight sides a simple mapping may be constructed using a linear mapping similar to the vertex modes of a hierarchical/modal expansion. For the straight-sided quadrilateral with vertices labeled as shown in figure 3.1(b) the mapping can be defined as:

                    A(1---ξ1)(1--ξ2)-   B(1-+-ξ1)(1--ξ2)-
xi  =   χi(ξ1,ξ2) = xi   2       2    + xi   2       2
           D(1 - ξ1) (1+ ξ2)    C(1 + ξ1)(1+ ξ2)
        +x i---2-------2---+  xi---2-------2---.  i = 1,2       (3.1)

If we denote an arbitrary quadrilateral region by Ωe which is a function of the global Cartesian coordinate system (x1,x2) in two-dimensions. To integrate over Ωe we transform this region into the standard region Ωst defined in terms of (ξ12) and we have

∫                     ∫
   u(x1,x2) dx1 dx2 =     u(ξ1,ξ2)|J2D| dξ1 dξ2,
 Ωe                    Ωst

where J2D is the two-dimensional Jacobian due to the transformation, defined as:

      || ∂x   ∂x   ||
      || --1- ---1 ||
J2D = || ∂ξ1   ∂ξ2 ||=  ∂x1∂x2--  ∂x1∂x2-.
      || ∂x2- ∂x2- ||   ∂ξ1∂ ξ2   ∂ξ2 ∂ξ1
        ∂ξ1   ∂ξ2
(3.2)

As we have assumed that we know the form of the mapping [i.e., x1 = χ112), x2 = χ212)] we can evaluate all the partial derivatives required to determine the Jacobian. If the elemental region is straight-sided then we have seen that a mapping from (x1,x2) → (ξ12) is given by equations (3.1).

Task: 3.5 We now consider how to integrate the function f(x1,x2) = x112 x214 on a local rectangular quadrilateral element using Gaussian quadrature. Consider the local quadrilateral element with vertices

  A   A                B   B
(x1 ,x2) = (0,- 1),   (x1 ,x2 ) = (1,- 1),
  (xC1 ,xC2 ) = (1,1), (xD1 ,xD2 ) = (0,0).

This is clearly similar to the previous exercise. However, as we are calculating the integral of a function defined on a local element rather than on a reference element, we have to take into account the geometry of the element. Therefore, the implementation is altered in two ways:

  1. The quadrature zeros should be transformed to local coordinates to evaluate the integrand f(x1,x2) at the quadrature points.
  2. The Jacobian of the transformation between local and reference coordinates should be taken into account when evaluating the integral.

In the file LocIntegration2D.cpp you are provided with the same set up as the previous task but now with a definition of the coordinate mapping included. Evaluate the expression for the Jacobian analytically. Then write a line of code in the loop for the Jacobian as indicated by the comments “Write your code here”. When you have written your expression you can compile the code with the command

make LocIntegration2D

Verify that the error is not equal to zero when q1 = 8,q2 = 9. Why might this be the case?3 .

Using the quadrature order specified in the file your output should look like:

=========================================================== 
|      INTEGRATION ON 2D ELEMENT in Local Region          | 
=========================================================== 
 
Integrate the function f(x1,x2) = x1^12 * x2^14 
on a local quadrilateral element: 
         Error = 0.000424657