Operator.h 103 KB
Newer Older
1
2
3
4
5
6
// ============================================================================
// ==                                                                        ==
// == AMDiS - Adaptive multidimensional simulations                          ==
// ==                                                                        ==
// ============================================================================
// ==                                                                        ==
7
// ==  TU Dresden                                                            ==
8
// ==                                                                        ==
9
10
11
// ==  Institut fr Wissenschaftliches Rechnen                               ==
// ==  Zellescher Weg 12-14                                                  ==
// ==  01069 Dresden                                                         ==
12
13
14
15
// ==  germany                                                               ==
// ==                                                                        ==
// ============================================================================
// ==                                                                        ==
16
// ==  https://gforge.zih.tu-dresden.de/projects/amdis/                      ==
17
18
19
20
21
22
23
24
25
// ==                                                                        ==
// ============================================================================

/** \file Operator.h */

#ifndef AMDIS_OPERATOR_H
#define AMDIS_OPERATOR_H

#include <vector>
26
#include "AMDiS_fwd.h"
27
28
29
30
31
#include "FixVec.h"
#include "Flag.h"
#include "MatrixVector.h"
#include "ElInfo.h"
#include "AbstractFunction.h"
32
#include "OpenMP.h"
33
#include "SubAssembler.h"
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

namespace AMDiS {

  /** 
   * \ingroup Assembler
   * 
   * \brief
   * Base class for ZeroOrderTerm, FirstOrderTerm and SecondOrderTerm. 
   * OperatorTerms are the building blocks of an Operator. Each OperatorTerm
   * has its properties which are regarded, when constructing 
   * an Assembler for the corresponding Operator.
   */
  class OperatorTerm
  {
  public:
    /** \brief
     * Constructs an OperatorTerm with initially no properties.
     * degree_ is used to determine the degree of the needed quadrature
     * for the assemblage.  
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
54
    OperatorTerm(int deg) 
55
      : properties(0), 
Thomas Witkowski's avatar
Thomas Witkowski committed
56
57
	degree(deg),
	auxFESpaces(0)
58
    {}
59

Thomas Witkowski's avatar
Thomas Witkowski committed
60
61
    /// Destructor.
    virtual ~OperatorTerm() {}
62
63
64

    /** \brief
     * Virtual method. It's called by SubAssembler::initElement() for
Thomas Witkowski's avatar
Thomas Witkowski committed
65
66
     * each OperatorTerm belonging to this SubAssembler. E.g., vectors
     * and coordinates at quadrature points can be calculated here.
67
68
     */
    virtual void initElement(const ElInfo*, 
Thomas Witkowski's avatar
Thomas Witkowski committed
69
70
			     SubAssembler*,
			     Quadrature *quad = NULL) 
71
    {}
72

Thomas Witkowski's avatar
Thomas Witkowski committed
73
74
75
76
77
78
79
    virtual void initElement(const ElInfo* largeElInfo,
			     const ElInfo* smallElInfo,
			     SubAssembler*,
			     Quadrature *quad = NULL)
    {}

    /// Returs \auxFESpaces, the list of all aux fe spaces the operator makes use off.
80
81
    std::vector<const FiniteElemSpace*>& getAuxFESpaces() 
    {
Thomas Witkowski's avatar
Thomas Witkowski committed
82
83
84
85
      return auxFESpaces;
    }

    /// Specifies whether the matrix of the term is symmetric
86
87
    void setSymmetric(bool symm);

Thomas Witkowski's avatar
Thomas Witkowski committed
88
    /// Returns true, if the term is piecewise constant, returns false otherwise
89
90
    inline bool isPWConst() 
    { 
91
      return (degree == 0);
92
    }
93

Thomas Witkowski's avatar
Thomas Witkowski committed
94
    /// Returns true, if the term has a symmetric matrix, returns false otherwise.
95
96
    bool isSymmetric();

Thomas Witkowski's avatar
Thomas Witkowski committed
97
    /// Returns \ref degree.
98
99
    inline int getDegree() 
    { 
100
      return degree; 
101
    }
102

Thomas Witkowski's avatar
Thomas Witkowski committed
103
    /// Evaluation of the OperatorTerm at all quadrature points.
Thomas Witkowski's avatar
Thomas Witkowski committed
104
105
    virtual void eval(int nPoints,
		      const double *uhAtQP,
106
107
		      const WorldVector<double> *grdUhAtQP,
		      const WorldMatrix<double> *D2UhAtQP,
Thomas Witkowski's avatar
Thomas Witkowski committed
108
		      double *result,
109
110
111
		      double factor) const = 0;

    /** \brief
Thomas Witkowski's avatar
Thomas Witkowski committed
112
113
     * Determines the value of a dof vector at the quadrature points of a given 
     * element. It is used by all VecAtQP like operator terms.
114
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
    double *getVectorAtQPs(DOFVectorBase<double>* vec,
			   const ElInfo* elInfo, 
			   SubAssembler* subAssembler,
			   Quadrature *quad);		   

    /** \brief
     * Determines the value of a dof vector at the quadrature points of a given 
     * element. This function is used, if an operator is assembled on two different
     * meshes using the dual traverse. The element, i.e. the small or the large one,
     * is choosen, which corresponds to the mesh the dof vector is defined on.
     */
    double *getVectorAtQPs(DOFVectorBase<double>* vec,
			   const ElInfo* smallElInfo, 
			   const ElInfo* largeElInfo, 
			   SubAssembler* subAssembler,
			   Quadrature *quad);	

Thomas Witkowski's avatar
Thomas Witkowski committed
132
    ///
Thomas Witkowski's avatar
Thomas Witkowski committed
133
134
135
136
137
    WorldVector<double>* getGradientsAtQPs(DOFVectorBase<double>* vec,
					   const ElInfo* elInfo,
					   SubAssembler* subAssembler,
					   Quadrature *quad);

Thomas Witkowski's avatar
Thomas Witkowski committed
138
    ///
Thomas Witkowski's avatar
Thomas Witkowski committed
139
140
141
142
143
144
145
146
    WorldVector<double>* getGradientsAtQPs(DOFVectorBase<double>* vec,
					   const ElInfo* smallElInfo, 
					   const ElInfo* largeElInfo,
					   SubAssembler* subAssembler,
					   Quadrature *quad);

  protected:
    /// Evaluation of \f$ \Lambda \cdot A \cdot \Lambda^t\f$.
147
    static void lalt(const DimVec<WorldVector<double> >& Lambda,
Thomas Witkowski's avatar
Thomas Witkowski committed
148
149
150
151
		     const WorldMatrix<double>& matrix,
		     DimMat<double>& LALt,
		     bool symm,
		     double factor);
152
153
154
155
156
157
158
159

    /** \brief
     * Evaluation of \f$ \Lambda \cdot A \cdot \Lambda^t\f$ for \f$ A \f$
     * the matrix having a ONE in the position \f$ (K,L) \f$
     * and ZEROS in all other positions.
     */
    static void lalt_kl(const DimVec<WorldVector<double> >& Lambda,
			int k, int l,
Thomas Witkowski's avatar
Thomas Witkowski committed
160
161
			DimMat<double>& LALt,
			double factor);
162

163
164
    /// Evaluation of \f$ \Lambda \cdot A \cdot \Lambda^t\f$ for A equal to the identity.
    static void l1lt(const DimVec<WorldVector<double> >& Lambda, 
Thomas Witkowski's avatar
Thomas Witkowski committed
165
166
		     DimMat<double>& LALt,
		     double factor);
167

Thomas Witkowski's avatar
Thomas Witkowski committed
168
    /// Evaluation of \f$ \Lambda \cdot b\f$.
169
170
171
172
173
174
    static inline void lb(const DimVec<WorldVector<double> >& Lambda,
			  const WorldVector<double>& b,
			  DimVec<double>& Lb,
			  double factor)
    {
      const int dimOfWorld = Global::getGeo(WORLD);
175
176
177
      const int dim = Lambda.size() - 1;

      for (int i = 0; i <= dim; i++) {
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
	double val = 0.0;
	
	for (int j = 0; j < dimOfWorld; j++)
	  val += Lambda[i][j] * b[j];
	
	Lb[i] += val * factor;
      }    
    }

    /** \brief
     * Evaluation of \f$ \Lambda \cdot b\f$ if b contains the value 1.0 in 
     * each component.
     */
    static inline void l1(const DimVec<WorldVector<double> >& Lambda,
			  DimVec<double>& Lb,
			  double factor)
194
    {
195
      const int dimOfWorld = Global::getGeo(WORLD);
196
      const int dim = Lambda.size() - 1;
197

198
      for (int i = 0; i <= dim; i++) {
199
200
	double val = 0.0;
      
201
	for (int j = 0; j < dimOfWorld; j++)
202
	  val += Lambda[i][j];
203

204
	Lb[i] += val * factor;
205
      }    
206
    }
207
208

  protected:
Thomas Witkowski's avatar
Thomas Witkowski committed
209
    /// Stores the properties of this OperatorTerm
210
211
    Flag properties;

Thomas Witkowski's avatar
Thomas Witkowski committed
212
    /// Polynomial degree of the term. Used to detemine the degree of the quadrature.
213
214
    int degree;

Thomas Witkowski's avatar
Thomas Witkowski committed
215
216
217
218
    /// List off all fe spaces, the operator term makes use off.
    std::vector<const FiniteElemSpace*> auxFESpaces;

    /// Pointer to the Operator this OperatorTerm belongs to.
219
220
    Operator* operat;

Thomas Witkowski's avatar
Thomas Witkowski committed
221
    /// Flag for piecewise constant terms
222
223
    static const Flag PW_CONST;

Thomas Witkowski's avatar
Thomas Witkowski committed
224
    /// Flag for symmetric terms
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
    static const Flag SYMMETRIC;

    friend class SubAssembler;
    friend class ZeroOrderAssembler;
    friend class FirstOrderAssembler;
    friend class SecondOrderAssembler;
    friend class Operator;
  };

  /**
   * \ingroup Assembler
   * 
   * \brief
   * Describes the second order terms: \f$ \nabla \cdot A \nabla u(\vec{x}) \f$
   */
  class SecondOrderTerm : public OperatorTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
243
    /// Constructor.
244
245
246
    SecondOrderTerm(int deg) 
      : OperatorTerm(deg) 
    {}
247

248
    /// Destructor.
249
250
    virtual ~SecondOrderTerm() 
    {}
251

252
    /// Evaluation of \f$ \Lambda A \Lambda^t \f$ at all quadrature points.
253
    virtual void getLALt(const ElInfo *elInfo, 
Thomas Witkowski's avatar
Thomas Witkowski committed
254
			 int nPoints, 
255
256
			 DimMat<double> **result) const = 0;

257
    /// Evaluation of \f$ A \nabla u(\vec{x}) \f$ at all quadrature points.
Thomas Witkowski's avatar
Thomas Witkowski committed
258
    virtual void weakEval(int nPoints,
259
260
261
262
263
264
265
266
267
268
269
270
271
272
			  const WorldVector<double> *grdUhAtQP,
			  WorldVector<double> *result) const = 0;

  };

  /**
   * \ingroup Assembler
   * 
   * \brief
   * Implements the laplace operator: \f$ \Delta u(\vec{x}) \f$
   */
  class Laplace_SOT : public SecondOrderTerm 
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
273
    /// Constructor.
274
275
276
277
    Laplace_SOT() 
      : SecondOrderTerm(0) 
    {
      setSymmetric(true);
278
    }
279

280
    /// Implenetation of SecondOrderTerm::getLALt().
Thomas Witkowski's avatar
Thomas Witkowski committed
281
    inline void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const
282
283
284
    {
      const DimVec<WorldVector<double> > &Lambda = elInfo->getGrdLambda();

285
      for (int iq = 0; iq < nPoints; iq++)
286
	l1lt(Lambda, *(LALt[iq]), 1.0);
287
    }
288

289
    /// Implementation of SecondOrderTerm::eval().
Thomas Witkowski's avatar
Thomas Witkowski committed
290
    inline void eval(int nPoints,
291
292
		     const double *,
		     const WorldVector<double> *,
Thomas Witkowski's avatar
Thomas Witkowski committed
293
294
295
		     const WorldMatrix<double> *D2UhAtQP,
		     double *result,
		     double factor) const
296
297
298
299
    {
      int dow = Global::getGeo(WORLD);
    
      if (D2UhAtQP) {
Thomas Witkowski's avatar
Thomas Witkowski committed
300
	for (int iq = 0; iq < nPoints; iq++) {
301
	  double resultQP = 0.0;
302
	  for (int i = 0; i < dow; i++) 
303
304
305
306
	    resultQP += D2UhAtQP[iq][i][i];
	  result[iq] += factor * resultQP;
	}
      }
307
    }
308

309
    /// Implenetation of SecondOrderTerm::weakEval().
Thomas Witkowski's avatar
Thomas Witkowski committed
310
    void weakEval(int nPoints,
311
312
313
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const
    {
314
      if (grdUhAtQP)
315
	for (int iq = 0; iq < nPoints; iq++)
316
	  result[iq] += grdUhAtQP[iq];
317
318
    }
  };
319
320
321
322
323
324
325
326
327
328
329

  /**
   * \ingroup Assembler
   * 
   * \brief
   * Implements the laplace operator multiplied with a scalar factor:
   * \f$ f \cdot \Delta u(\vec{x}) \f$
   */
  class FactorLaplace_SOT : public SecondOrderTerm 
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
330
    /// Constructor.
331
    FactorLaplace_SOT(double f) 
332
333
      : SecondOrderTerm(0)  
    {
334
335
336
337
      factor = new double;
      *factor = f;

      setSymmetric(true);
338
    }
339

Thomas Witkowski's avatar
Thomas Witkowski committed
340
    /// Constructor.
341
    FactorLaplace_SOT(double *fptr) 
342
343
      : SecondOrderTerm(0), 
	factor(fptr)
344
345
    {
      setSymmetric(true);
346
    }
347

348
    /// Implements SecondOrderTerm::getLALt().
Thomas Witkowski's avatar
Thomas Witkowski committed
349
    inline void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const
350
    {
351
      const DimVec<WorldVector<double> > &Lambda = elInfo->getGrdLambda();
Thomas Witkowski's avatar
Thomas Witkowski committed
352
      for (int iq = 0; iq < nPoints; iq++) 
353
	l1lt(Lambda, *(LALt[iq]), (*factor));
354
    }
355

356
    /// Implenetation of SecondOrderTerm::eval().
Thomas Witkowski's avatar
Thomas Witkowski committed
357
    void eval(int nPoints,
358
	      const double *,
359
360
361
362
363
	      const WorldVector<double> *,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double f) const
    {
Thomas Witkowski's avatar
Thomas Witkowski committed
364
      int dow = Global::getGeo(WORLD);
365

Thomas Witkowski's avatar
Thomas Witkowski committed
366
      if (D2UhAtQP) {
Thomas Witkowski's avatar
Thomas Witkowski committed
367
	for (int iq = 0; iq < nPoints; iq++) {
368
	  double resultQP = 0.0;
Thomas Witkowski's avatar
Thomas Witkowski committed
369
	  for (int i = 0; i < dow; i++) {
370
371
372
373
374
	    resultQP += D2UhAtQP[iq][i][i];
	  }
	  result[iq] += resultQP * f * (*factor);
	}
      }
375
    }
376

377
    /// Implenetation of SecondOrderTerm::weakEval().
Thomas Witkowski's avatar
Thomas Witkowski committed
378
    void weakEval(int nPoints,
379
380
381
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const
    {
382
383
      if (grdUhAtQP)
	for (int iq = 0; iq < nPoints; iq++)
384
	  axpy(*factor, grdUhAtQP[iq], result[iq]);
385
    }
386
387

  private:
388
    /// Pointer to the factor.
389
390
391
392
393
394
395
396
397
398
399
400
401
402
    double *factor;
  };

  /**
   * \ingroup Assembler
   * 
   * \brief
   * SecondOrderTerm where A is a function which maps a DOFVector evaluated at
   * a given quadrature point to a WolrdMatrix:
   * \f$ \nabla \cdot A(v(\vec{x})) \nabla u(\vec{x}) \f$
   */
  class MatrixFct_SOT : public SecondOrderTerm 
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
403
    /// Constructor.
404
405
406
    MatrixFct_SOT(DOFVectorBase<double> *dv, 
		  AbstractFunction<WorldMatrix<double>, double> *fct,
		  AbstractFunction<WorldVector<double>, WorldMatrix<double> > *div,
Thomas Witkowski's avatar
Thomas Witkowski committed
407
		  bool sym = false);
408
409
410
411
412
413
414
415
416
417

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
418
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
419
420
421
422
  
    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
423
424
    void eval(int nPoints,
	      const double *uhAtQP,
425
426
427
428
429
430
431
432
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
433
    void weakEval(int nPoints,
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
    /** \brief
     * DOFVector to be evaluated at quadrature points.
     */
    DOFVectorBase<double>* vec;

    /** \brief
     * Pointer to the values of the DOFVector at quadrature points.
     */
    double* vecAtQPs;

    /** \brief
     * Function for A.
     */
    AbstractFunction<WorldMatrix<double>, double>* matrixFct;

Thomas Witkowski's avatar
Thomas Witkowski committed
453
454
455
    /** \brief
     *
     */
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
    AbstractFunction<WorldVector<double>, WorldMatrix<double> >* divFct;

    /** \brief
     * True, if \ref matrixFct produces always symmetric matrices.
     */
    bool symmetric;
  };

  /** 
   * \ingroup Assembler
   *
   * \brief
   * SecondOrderTerm where A is a given fixed WorldMatrix<double>:
   * \f$ \nabla \cdot A \nabla u(\vec{x}) \f$
   */
  class Matrix_SOT : public SecondOrderTerm {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
473
    /// Constructor
474
    Matrix_SOT(WorldMatrix<double> mat) 
Thomas Witkowski's avatar
Thomas Witkowski committed
475
      : SecondOrderTerm(0), matrix(mat)
476
477
478
    {
      symmetric = matrix.isSymmetric();
      setSymmetric(symmetric);
479
    }
480

481
    /// Implements SecondOrderTerm::getLALt().
482
483
484
485
    inline void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const
    {
      const DimVec<WorldVector<double> >& Lambda = elInfo->getGrdLambda();
      for (int iq = 0; iq < nPoints; iq++) 
486
	lalt(Lambda, matrix, *(LALt[iq]), symmetric, 1.0);
487
    }
488
  
489
    /// Implenetation of SecondOrderTerm::eval().
Thomas Witkowski's avatar
Thomas Witkowski committed
490
491
    void eval(int nPoints,
	      const double *uhAtQP,
492
493
494
495
496
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

497
    /// Implenetation of SecondOrderTerm::weakEval().
Thomas Witkowski's avatar
Thomas Witkowski committed
498
    void weakEval(int nPoints,
499
500
501
502
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
503
    /// Matrix stroring A.
504
505
    WorldMatrix<double> matrix;

506
    /// True, if \ref matrix is symmetric.
507
508
509
510
511
512
513
514
515
516
517
518
519
520
    bool symmetric;
  };

  /** 
   * \ingroup Assembler
   *
   * \brief
   * SecondOrderTerm where A is a WorldMatrix<double> having a ONE in position IJ
   * and ZERO in all other positions
   * \f$ \nabla \cdot A \nabla u(\vec{x}) \f$
   */
  class FactorIJ_SOT : public SecondOrderTerm 
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
521
    /// Constructor.
522
    FactorIJ_SOT(int x_i, int x_j, double f) 
Thomas Witkowski's avatar
Thomas Witkowski committed
523
      : SecondOrderTerm(0), xi(x_i), xj(x_j)
524
525
526
527
528
    {
      factor = new double;
      *factor = f;

      setSymmetric(xi == xj);
529
    }
530

Thomas Witkowski's avatar
Thomas Witkowski committed
531
    /// Constructor.
532
    FactorIJ_SOT(int x_i, int x_j, double *fptr) 
Thomas Witkowski's avatar
Thomas Witkowski committed
533
      : SecondOrderTerm(0), xi(x_i), xj(x_j), factor(fptr)
534
535
    {
      setSymmetric(xi == xj);
536
    }
537

538
    /// Implements SecondOrderTerm::getLALt().
Thomas Witkowski's avatar
Thomas Witkowski committed
539
    inline void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const
540
    {
541
      const DimVec<WorldVector<double> > &Lambda = elInfo->getGrdLambda();
542
      for (int iq = 0; iq < nPoints; iq++)
543
	lalt_kl(Lambda, xi, xj, *(LALt[iq]), (*factor));
544
    }
545
546
547
548

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
549
    void eval(int nPoints,
550
551
552
553
554
555
	      const double              *,
	      const WorldVector<double> *,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double fac) const
    {
556
557
      if (D2UhAtQP)
	for (int iq = 0; iq < nPoints; iq++)
558
	  result[iq] += (*factor) * D2UhAtQP[iq][xi][xj] * fac;
559
    }
560
561
562
563

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
564
    void weakEval(int nPoints,
565
566
567
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const
    {
568
569
      if (grdUhAtQP)
	for (int iq = 0; iq < nPoints; iq++)
570
	  result[iq][xi] += (*factor) * grdUhAtQP[iq][xj];
571
    }
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594

  private:
    /** \brief
     * Directions for the derivatives.
     */
    int xi, xj;

    /** \brief
     * Pointer to the factor.
     */
    double *factor;
  };

  /**
   * \ingroup Assembler
   *  
   * \brief
   * Laplace operator multiplied with a function evaluated at the quadrature
   * points of a given DOFVector:
   * \f$ f(v(\vec{x})) \Delta u(\vec{x}) \f$
   */
  class VecAtQP_SOT : public SecondOrderTerm {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
595
596
    /// Constructor.
    VecAtQP_SOT(DOFVectorBase<double> *dv, AbstractFunction<double, double> *af);
597

Thomas Witkowski's avatar
Thomas Witkowski committed
598
    /// Implementation of \ref OperatorTerm::initElement().
599
600
601
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

Thomas Witkowski's avatar
Thomas Witkowski committed
602
603
604
605
606
    /// Implementation of \ref OperatorTerm::initElement() for multilpe meshes.
    void initElement(const ElInfo* smallElInfo,
		     const ElInfo* largeElInfo,
		     SubAssembler* subAssembler,
		     Quadrature *quad = NULL);
607

Thomas Witkowski's avatar
Thomas Witkowski committed
608
609
610
611
612
613
    /// Implements SecondOrderTerm::getLALt().
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;    

    /// Implenetation of SecondOrderTerm::eval().
    void eval(int nPoints,
	      const double *uhAtQP,
614
615
616
617
618
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

Thomas Witkowski's avatar
Thomas Witkowski committed
619
620
    /// Implenetation of SecondOrderTerm::weakEval().
    void weakEval(int nPoints,
621
622
623
624
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
Thomas Witkowski's avatar
Thomas Witkowski committed
625
    /// DOFVector to be evaluated at quadrature points.
626
627
    DOFVectorBase<double>* vec;

Thomas Witkowski's avatar
Thomas Witkowski committed
628
    /// Pointer to an array containing the DOFVector evaluated at quadrature points.
629
630
    double* vecAtQPs;

Thomas Witkowski's avatar
Thomas Witkowski committed
631
    /// Function evaluated at \ref vecAtQPs.
632
633
634
    AbstractFunction<double, double> *f;
  };

635
636
637
638
639
640
641
642
643
644
  /**
   * \ingroup Assembler
   *  
   * \brief
   * Laplace operator multiplied with a function evaluated at the quadrature
   * points of a given DOFVector:
   * \f$ f(v(\vec{x}), w(\vec{x})) \Delta u(\vec{x}) \f$
   */
  class Vec2AtQP_SOT : public SecondOrderTerm {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
645
    /// Constructor.
646
    Vec2AtQP_SOT(DOFVectorBase<double> *dv1, DOFVectorBase<double> *dv2, 
Thomas Witkowski's avatar
Thomas Witkowski committed
647
		 BinaryAbstractFunction<double, double, double> *af);
648
649
650
651
652
653
654
655
656
657

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
658
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;    
659
660
661
662
    
    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
663
    void eval(int nPoints,
664
665
666
667
668
669
670
671
672
	      const double *uhAtQP,
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;
    
    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
673
    void weakEval(int nPoints,
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;
    
  protected:
    /** \brief
     * DOFVector to be evaluated at quadrature points.
     */
    DOFVectorBase<double>* vec1;
    DOFVectorBase<double>* vec2;
    
    /** \brief
     * Pointer to an array containing the DOFVector evaluated at quadrature
     * points.
     */
    double* vecAtQPs1;
    double* vecAtQPs2;
    
    /** \brief
     * Function evaluated at \ref vecAtQPs.
     */
    BinaryAbstractFunction<double, double, double> *f;
  };

697
698
699
700
701
702
703
704
705
  /**
   * \ingroup Assembler
   * 
   * \brief
   * Laplace multiplied with a function evaluated at each quadrature point:
   * \f$ f(\vec{x}) \Delta u(\vec{x}) \f$
   */
  class CoordsAtQP_SOT : public SecondOrderTerm {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
706
707
708
    /// Constructor.
    CoordsAtQP_SOT(AbstractFunction<double, WorldVector<double> > *af)
      : SecondOrderTerm(af->getDegree()), g(af)
709
710
    {
      setSymmetric(true);
Thomas Witkowski's avatar
Thomas Witkowski committed
711
    }
712
713
714
715
716
717
718
719
720
721

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
722
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;    
723
724
725
726

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
727
728
    void eval(int nPoints,
	      const double *uhAtQP,
729
730
731
732
733
734
735
736
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
737
    void weakEval(int nPoints,
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;


  protected:
    /** \brief
     * Stores coordinates at quadrature points. Set in \ref initElement().
     */
    WorldVector<double>* coordsAtQPs;

    /** \brief
     * Function evaluated at quadrature points.
     */
    AbstractFunction<double, WorldVector<double> > *g;
  };

  /**
   * \ingroup Assembler
   *
   * \brief
   * SecondOrderTerm where A is a function which maps the gradient of a 
   * DOFVector at each quadrature point to WorldMatrix<double>:
   * \f$ \nabla \cdot A(\nabla v(\vec{x})) \nabla u(\vec{x})\f$
   */
  class MatrixGradient_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
765
    /// Constructor.
766
    MatrixGradient_SOT(DOFVectorBase<double> *dv,
Thomas Witkowski's avatar
Thomas Witkowski committed
767
768
769
		       AbstractFunction<WorldMatrix<double>, WorldVector<double> > *af,
		       AbstractFunction<WorldVector<double>, WorldMatrix<double> > *divAf,
		       bool symm = false);
770
771
772
773
774
775
776
777
778
779

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
780
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
781
782
783
784

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
785
786
    void eval(int nPoints,
	      const double *uhAtQP,
787
788
789
790
791
792
793
794
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
795
    void weakEval(int nPoints,
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
    DOFVectorBase<double>* vec;

    /** \brief
     * Function which maps each entry in \ref gradAtQPs to a WorldMatrix<double>.
     */
    AbstractFunction<WorldMatrix<double>, WorldVector<double> > *f;

    AbstractFunction<WorldVector<double>, WorldMatrix<double> > *divFct;

    /** \brief
     * Pointer to a WorldVector<double> array containing the gradients of the DOFVector
     * at each quadrature point.
     */
    WorldVector<double>* gradAtQPs;

    /** \brief
     * True, if \ref f provides always a symmetric WorldMatrix<double>.
     */
    bool symmetric;
  };

  /**
   * \ingroup Assembler
   *
   * \brief
   * Laplace multiplied with a function which maps the gradient of a DOFVector
   * at each quadrature point to a double:
   * \f$ f(\nabla v(\vec{x})) \Delta u(\vec{x}) \f$
   */
  class FctGradient_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
832
833
834
    /// Constructor.
    FctGradient_SOT(DOFVectorBase<double> *dv,  
		    AbstractFunction<double, WorldVector<double> > *af);
835
836
837
838
839
840
841
842
843
844

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
845
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
846
847
848
849

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
850
851
    void eval(int nPoints,
	      const double *uhAtQP,
852
853
854
855
856
857
858
859
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
860
    void weakEval(int nPoints,
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
    DOFVectorBase<double>* vec;

    /** \brief
     * Function wich maps \ref gradAtQPs to a double.
     */
    AbstractFunction<double, WorldVector<double> > *f;

    /** \brief
     * Pointer to a WorldVector<double> array containing the gradients of the DOFVector
     * at each quadrature point.
     */
    WorldVector<double>* gradAtQPs;
  };


  /**
   * \ingroup Assembler
   *
   * \brief
   * Laplace multiplied with a function which maps the gradient of a DOFVector
   * at each quadrature point to a double:
   * \f$ f(\nabla v(\vec{x})) \Delta u(\vec{x}) \f$
   */
  class VecAndGradientAtQP_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
891
    /// Constructor.
892
    VecAndGradientAtQP_SOT(DOFVectorBase<double> *dv,
Thomas Witkowski's avatar
Thomas Witkowski committed
893
			   BinaryAbstractFunction<double, double, WorldVector<double> > *af);
894
895
896
897
898
899
900
901
902
903

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
904
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
905
906
907
908

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
909
910
    void eval(int nPoints,
	      const double *uhAtQP,
911
912
913
914
915
916
917
918
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
919
    void weakEval(int nPoints,
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
    DOFVectorBase<double>* vec;

    /** \brief
     * Function wich maps \ref gradAtQPs to a double.
     */
    BinaryAbstractFunction<double, double, WorldVector<double> > *f;

    /** \brief
     * Pointer to a WorldVector<double> array containing the gradients of the DOFVector
     * at each quadrature point.
     */
    double* vecAtQPs;
    WorldVector<double>* gradAtQPs;
  };

939
940
941
942
943
944
945
946
947
948
949
  /**
   * \ingroup Assembler
   *
   * \brief
   * Laplace multiplied with a function which maps the gradient of a DOFVector
   * at each quadrature point to a double:
   * \f$ \nabla \cdot A(v(\vec{x}), \nabla v(\vec{x})) \nabla u(\vec{x}) \f$
   */
  class VecMatrixGradientAtQP_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
950
    /// Constructor.
951
    VecMatrixGradientAtQP_SOT(DOFVectorBase<double> *dv,
Thomas Witkowski's avatar
Thomas Witkowski committed
952
953
954
			      BinaryAbstractFunction<WorldMatrix<double>, double, WorldVector<double> > *af,
			      AbstractFunction<WorldVector<double>, WorldMatrix<double> > *divAf,
			      bool symm = false);
955
956
957
958
959
960
961
962
963
964

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
965
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
966
967
968
969

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
970
971
    void eval(int nPoints,
	      const double *uhAtQP,
972
973
974
975
976
977
978
979
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
980
    void weakEval(int nPoints,
981
982
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;
Thomas Witkowski's avatar
Thomas Witkowski committed
983
    
984
985
  protected:
    DOFVectorBase<double>* vec;
Thomas Witkowski's avatar
Thomas Witkowski committed
986
    
987
988
989
990
991
    /** \brief
     * Function wich maps \ref gradAtQPs to a double.
     */
    BinaryAbstractFunction<WorldMatrix<double>, 
			   double, WorldVector<double> > *f;
Thomas Witkowski's avatar
Thomas Witkowski committed
992
993
994
995
996
997
998
999
1000
1001
1002
1003
    
    AbstractFunction<WorldVector<double>, WorldMatrix<double> > *divFct;
    
    /** \brief
     * Pointer to a WorldVector<double> array containing the gradients of the DOFVector
     * at each quadrature point.
     */
    double* vecAtQPs;
    WorldVector<double>* gradAtQPs;
    
    bool symmetric;
  };
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015

  /**
   * \ingroup Assembler
   *
   * \brief
   * Laplace multiplied with a function which maps the gradient of a DOFVector
   * at each quadrature point to a double:
   * \f$ f(\nabla v(\vec{x})) \Delta u(\vec{x}) \f$
   */
  class VecGradCoordsAtQP_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
1016
    /// Constructor.
1017
1018
    VecGradCoordsAtQP_SOT(DOFVectorBase<double> *dv,
			  TertiaryAbstractFunction<double, double,
Thomas Witkowski's avatar
Thomas Witkowski committed
1019
			  WorldVector<double>, WorldVector<double> > *af);
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1030
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
1031
1032
1033
1034

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1035
1036
    void eval(int nPoints,
	      const double *uhAtQP,
1037
1038
1039
1040
1041
1042
1043
1044
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1045
    void weakEval(int nPoints,
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
    DOFVectorBase<double>* vec;

    /** \brief
     * Function wich maps \ref gradAtQPs to a double.
     */
    TertiaryAbstractFunction<double, double, WorldVector<double>,
			     WorldVector<double> > *f;

    /** \brief
     * Pointer to a WorldVector<double> array containing the gradients of the DOFVector
     * at each quadrature point.
     */
    double* vecAtQPs;
    WorldVector<double>* gradAtQPs;
    WorldVector<double>* coordsAtQPs;
  
  };


  /**
   * \ingroup Assembler
   *  
   * \brief
   * Laplace operator multiplied with a function evaluated at the quadrature
   * points of a given DOFVector:
   * \f$ -f(v(\vec{x})) \Delta u(\vec{x}) \f$
   */
  class VecAndCoordsAtQP_SOT : public SecondOrderTerm {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
1079
    /// Constructor.
1080
    VecAndCoordsAtQP_SOT(DOFVectorBase<double> *dv, 
Thomas Witkowski's avatar
Thomas Witkowski committed
1081
			 BinaryAbstractFunction<double, double, WorldVector<double> > *af);
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1092
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;    
1093

Thomas Witkowski's avatar
Thomas Witkowski committed
1094
1095
    void eval(int nPoints,
	      const double *uhAtQP,
1096
1097
1098
1099
1100
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

Thomas Witkowski's avatar
Thomas Witkowski committed
1101
    void weakEval(int nPoints,
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
    /** \brief
     * DOFVector to be evaluated at quadrature points.
     */
    DOFVectorBase<double>* vec;

    /** \brief
     * Pointer to an array containing the DOFVector evaluated at quadrature
     * points.
     */
    double* vecAtQPs;
  
    WorldVector<double>* coordsAtQPs;

    /** \brief
     * Function evaluated at \ref vecAtQPs.
     */
    BinaryAbstractFunction<double, double,  WorldVector<double> > *f;
  };

  /**
   * \ingroup Assembler
   *
   * \brief
   * SecondOrderTerm where A is a function which maps the gradient of a 
   * DOFVector at each quadrature point to WorldMatrix<double>:
   * \f$ \nabla \cdot A(\nabla v(\vec{x})) \nabla u(\vec{x})\f$
   */
  class MatrixGradientAndCoords_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
1136
    /// Constructor.
1137
1138
1139
    MatrixGradientAndCoords_SOT(DOFVectorBase<double> *dv,
				BinaryAbstractFunction<WorldMatrix<double>,
				WorldVector<double> , 
Thomas Witkowski's avatar
Thomas Witkowski committed
1140
				WorldVector<double> > *af,
1141
				AbstractFunction<WorldVector<double>,
Thomas Witkowski's avatar
Thomas Witkowski committed
1142
1143
				WorldMatrix<double> > *divAf,
				bool symm = false);
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo* elInfo, SubAssembler* subAssembler,
		     Quadrature *quad = NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1154
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
1155
1156
1157
1158

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1159
1160
    void eval(int nPoints,
	      const double *uhAtQP,
1161
1162
1163
1164
1165
1166
1167
1168
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1169
    void weakEval(int nPoints,
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
    DOFVectorBase<double>* vec;

    /** \brief
     * Function which maps each entry in \ref gradAtQPs to a WorldMatrix<double>.
     */
    BinaryAbstractFunction<WorldMatrix<double>,
			   WorldVector<double>, WorldVector<double> > *f;

    AbstractFunction<WorldVector<double>, WorldMatrix<double> > *divFct;

    /** \brief
     * Pointer to a WorldVector<double> array containing the gradients of the DOFVector
     * at each quadrature point.
     */
    WorldVector<double>* gradAtQPs;

    WorldVector<double>* coordsAtQPs;

    /** \brief
     * True, if \ref f provides always a symmetric WorldMatrix<double>.
     */
    bool symmetric;
  };

  class General_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
1201
    /// Constructor.
1202
1203
    General_SOT(std::vector<DOFVectorBase<double>*> vecs,
		std::vector<DOFVectorBase<double>*> grads,
1204
1205
		TertiaryAbstractFunction<WorldMatrix<double>, 
		  WorldVector<double>,
1206
1207
		  std::vector<double>, 
		  std::vector<WorldVector<double> > > *f,
1208
1209
		AbstractFunction<WorldVector<double>, 
		  WorldMatrix<double> > *divFct,
Thomas Witkowski's avatar
Thomas Witkowski committed
1210
		bool symmetric);
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo*, 
		     SubAssembler* ,
		     Quadrature *quad= NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1222
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
1223
1224
1225
1226

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1227
1228
    void eval(int nPoints,
	      const double *uhAtQP,
1229
1230
1231
1232
1233
1234
1235
1236
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1237
    void weakEval(int nPoints,
1238
1239
1240
1241
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
1242
    std::vector<DOFVectorBase<double>*> vecs_; 
1243

1244
    std::vector<DOFVectorBase<double>*> grads_;
1245
1246
1247

    TertiaryAbstractFunction<WorldMatrix<double>, 
			     WorldVector<double>,
1248
1249
			     std::vector<double>, 
			     std::vector<WorldVector<double> > > *f_;
1250
1251
1252
1253
1254
1255

    AbstractFunction<WorldVector<double>, 
		     WorldMatrix<double> > *divFct_;

    WorldVector<double> *coordsAtQPs_;

1256
    std::vector<double*> vecsAtQPs_;
1257

1258
    std::vector<WorldVector<double>*> gradsAtQPs_;
1259
1260
1261
1262
1263
1264
1265

    bool symmetric_;
  };

  class GeneralParametric_SOT : public SecondOrderTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
1266
    /// Constructor.
1267
1268
    GeneralParametric_SOT(std::vector<DOFVectorBase<double>*> vecs,
			  std::vector<DOFVectorBase<double>*> grads,
1269
1270
1271
			  QuartAbstractFunction<WorldMatrix<double>, 
			  WorldVector<double>,
			  WorldVector<double>,
1272
1273
			  std::vector<double>, 
			  std::vector<WorldVector<double> > > *f,
1274
1275
			  AbstractFunction<WorldVector<double>, 
			  WorldMatrix<double> > *divFct,
Thomas Witkowski's avatar
Thomas Witkowski committed
1276
			  bool symmetric);
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287

    /** \brief
     * Implementation of \ref OperatorTerm::initElement().
     */
    void initElement(const ElInfo*, 
		     SubAssembler* ,
		     Quadrature *quad= NULL);

    /** \brief
     * Implements SecondOrderTerm::getLALt().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1288
    void getLALt(const ElInfo *elInfo, int nPoints, DimMat<double> **LALt) const;
1289
1290
1291
1292

    /** \brief
     * Implenetation of SecondOrderTerm::eval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1293
1294
    void eval(int nPoints,
	      const double *uhAtQP,
1295
1296
1297
1298
1299
1300
1301
1302
	      const WorldVector<double> *grdUhAtQP,
	      const WorldMatrix<double> *D2UhAtQP,
	      double *result,
	      double factor) const;

    /** \brief
     * Implenetation of SecondOrderTerm::weakEval().
     */
Thomas Witkowski's avatar
Thomas Witkowski committed
1303
    void weakEval(int nPoints,
1304
1305
1306
1307
		  const WorldVector<double> *grdUhAtQP,
		  WorldVector<double> *result) const;

  protected:
1308
    std::vector<DOFVectorBase<double>*> vecs_; 
1309

1310
    std::vector<DOFVectorBase<double>*> grads_;
1311
1312
1313
1314

    QuartAbstractFunction<WorldMatrix<double>, 
			  WorldVector<double>,
			  WorldVector<double>,
1315
1316
			  std::vector<double>, 
			  std::vector<WorldVector<double> > > *f_;
1317
1318
1319
1320
1321
1322
1323

    AbstractFunction<WorldVector<double>, 
		     WorldMatrix<double> > *divFct_;

    WorldVector<double> *coordsAtQPs_;
    WorldVector<double> elementNormal_;

1324
    std::vector<double*> vecsAtQPs_;
1325

1326
    std::vector<WorldVector<double>*> gradsAtQPs_;
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344

    bool symmetric_;
  };


  // ============================================================================
  // ===== class FirstOrderTerm =================================================
  // ============================================================================

  /**
   * \ingroup Assembler
   * 
   * \brief
   * Describes the first order terms: \f$ b \cdot \nabla u(\vec{x}) \f$
   */
  class FirstOrderTerm : public OperatorTerm
  {
  public:
Thomas Witkowski's avatar
Thomas Witkowski committed
1345
    /// Constructor.
1346
1347
    FirstOrderTerm(int deg) 
      : OperatorTerm(deg) 
Thomas Witkowski's avatar
Thomas Witkowski committed
1348
    {}