MFEM v4.8.0
Finite element discretization library
Loading...
Searching...
No Matches
mfem::SymmetricMatrixCoefficient Class Referenceabstract

Base class for symmetric matrix coefficients that optionally depend on time and space. More...

#include <coefficient.hpp>

Inheritance diagram for mfem::SymmetricMatrixCoefficient:
[legend]
Collaboration diagram for mfem::SymmetricMatrixCoefficient:
[legend]

Public Member Functions

 SymmetricMatrixCoefficient (int dimension)
 Construct a dim x dim matrix coefficient.
 
int GetSize () const
 Get the size of the matrix.
 
virtual void ProjectSymmetric (QuadratureFunction &qf)
 Fill the QuadratureFunction qf by evaluating the coefficient at the quadrature points.
 
virtual void Eval (DenseSymmetricMatrix &K, ElementTransformation &T, const IntegrationPoint &ip)=0
 Evaluate the matrix coefficient in the element described by T at the point ip, storing the result as a symmetric matrix K.
 
void Eval (DenseMatrix &K, ElementTransformation &T, const IntegrationPoint &ip) override
 Evaluate the matrix coefficient in the element described by T at the point ip, storing the result as a dense matrix K.
 
MFEM_DEPRECATED const DenseSymmetricMatrixGetMatrix ()
 
virtual ~SymmetricMatrixCoefficient ()
 
- Public Member Functions inherited from mfem::MatrixCoefficient
 MatrixCoefficient (int dim, bool symm=false)
 Construct a dim x dim matrix coefficient.
 
 MatrixCoefficient (int h, int w, bool symm=false)
 Construct a h x w matrix coefficient.
 
virtual void SetTime (real_t t)
 Set the time for time dependent coefficients.
 
real_t GetTime ()
 Get the time for time dependent coefficients.
 
int GetHeight () const
 Get the height of the matrix.
 
int GetWidth () const
 Get the width of the matrix.
 
int GetVDim () const
 For backward compatibility get the width of the matrix.
 
bool IsSymmetric () const
 
virtual void Project (QuadratureFunction &qf, bool transpose=false)
 Fill the QuadratureFunction qf by evaluating the coefficient at the quadrature points. The matrix will be transposed or not according to the boolean argument transpose.
 
virtual void EvalSymmetric (Vector &K, ElementTransformation &T, const IntegrationPoint &ip)
 (DEPRECATED) Evaluate a symmetric matrix coefficient.
 
virtual ~MatrixCoefficient ()
 

Protected Attributes

DenseSymmetricMatrix mat_aux
 Internal matrix used when evaluating this coefficient as a DenseMatrix.
 
- Protected Attributes inherited from mfem::MatrixCoefficient
int height
 
int width
 
real_t time
 
bool symmetric
 

Detailed Description

Base class for symmetric matrix coefficients that optionally depend on time and space.

Definition at line 1484 of file coefficient.hpp.

Constructor & Destructor Documentation

◆ SymmetricMatrixCoefficient()

mfem::SymmetricMatrixCoefficient::SymmetricMatrixCoefficient ( int dimension)
inlineexplicit

Construct a dim x dim matrix coefficient.

Definition at line 1492 of file coefficient.hpp.

◆ ~SymmetricMatrixCoefficient()

virtual mfem::SymmetricMatrixCoefficient::~SymmetricMatrixCoefficient ( )
inlinevirtual

Definition at line 1530 of file coefficient.hpp.

Member Function Documentation

◆ Eval() [1/2]

void mfem::SymmetricMatrixCoefficient::Eval ( DenseMatrix & K,
ElementTransformation & T,
const IntegrationPoint & ip )
overridevirtual

Evaluate the matrix coefficient in the element described by T at the point ip, storing the result as a dense matrix K.

This function allows the use of SymmetricMatrixCoefficient in situations where the symmetry is not taken advantage of.

Note
When this method is called, the caller must make sure that the IntegrationPoint associated with T is the same as ip. This can be achieved by calling T.SetIntPoint(&ip).

Implements mfem::MatrixCoefficient.

Reimplemented in mfem::SymmetricMatrixConstantCoefficient, and mfem::SymmetricMatrixFunctionCoefficient.

Definition at line 829 of file coefficient.cpp.

◆ Eval() [2/2]

virtual void mfem::SymmetricMatrixCoefficient::Eval ( DenseSymmetricMatrix & K,
ElementTransformation & T,
const IntegrationPoint & ip )
pure virtual

Evaluate the matrix coefficient in the element described by T at the point ip, storing the result as a symmetric matrix K.

Note
When this method is called, the caller must make sure that the IntegrationPoint associated with T is the same as ip. This can be achieved by calling T.SetIntPoint(&ip).

Implemented in mfem::SymmetricMatrixConstantCoefficient, and mfem::SymmetricMatrixFunctionCoefficient.

◆ GetMatrix()

MFEM_DEPRECATED const DenseSymmetricMatrix & mfem::SymmetricMatrixCoefficient::GetMatrix ( )
inline
Deprecated
Return a reference to the internal matrix used when evaluating this coefficient as a DenseMatrix.

Definition at line 1528 of file coefficient.hpp.

◆ GetSize()

int mfem::SymmetricMatrixCoefficient::GetSize ( ) const
inline

Get the size of the matrix.

Definition at line 1496 of file coefficient.hpp.

◆ ProjectSymmetric()

void mfem::SymmetricMatrixCoefficient::ProjectSymmetric ( QuadratureFunction & qf)
virtual

Fill the QuadratureFunction qf by evaluating the coefficient at the quadrature points.

Note
As opposed to MatrixCoefficient::Project, this function stores only the symmetric part of the matrix at each quadrature point.

The vdim of the coefficient should be equal to height*(height+1)/2.

Definition at line 803 of file coefficient.cpp.

Member Data Documentation

◆ mat_aux

DenseSymmetricMatrix mfem::SymmetricMatrixCoefficient::mat_aux
mutableprotected

Internal matrix used when evaluating this coefficient as a DenseMatrix.

Definition at line 1489 of file coefficient.hpp.


The documentation for this class was generated from the following files: