MFEM v4.7.0
Finite element discretization library
Loading...
Searching...
No Matches
mfem::GaussianSpacingFunction Class Reference

Gaussian spacing function of the general form g(x) = a exp(-(x-m)^2 / c^2) for some scalar parameters a, m, c. More...

#include <spacing.hpp>

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

Public Member Functions

 GaussianSpacingFunction (int n, bool r, real_t s0, real_t s1, bool s)
 Constructor for BellSpacingFunction.
 
void SetSize (int size) override
 Sets the size, or number of intervals (elements).
 
void ScaleParameters (real_t a) override
 Scales parameters by the factor a associated with Size().
 
real_t Eval (int p) const override
 Returns the width of interval p (between 0 and Size() - 1).
 
void Print (std::ostream &os) const override
 Prints all the data necessary to define the spacing function and its current state (size and other parameters).
 
SpacingType GetSpacingType () const override
 Returns the spacing type, indicating the derived class.
 
int NumIntParameters () const override
 Returns the number of integer parameters defining the spacing function.
 
int NumDoubleParameters () const override
 Returns the number of double parameters defining the spacing function.
 
void GetIntParameters (Array< int > &p) const override
 
void GetDoubleParameters (Vector &p) const override
 
bool Nested () const override
 Returns true if the spacing function is nested during refinement.
 
std::unique_ptr< SpacingFunctionClone () const override
 Returns a clone (deep-copy) of this spacing function.
 
- Public Member Functions inherited from mfem::SpacingFunction
 SpacingFunction (int n, bool r=false, bool s=false)
 Base class constructor.
 
int Size () const
 Returns the size, or number of intervals (elements).
 
void SetReverse (bool r)
 Sets the property that determines whether the spacing is reversed.
 
void EvalAll (Vector &s) const
 Returns the width of all intervals, resizing s to Size().
 
virtual ~SpacingFunction ()=default
 

Additional Inherited Members

- Protected Attributes inherited from mfem::SpacingFunction
int n
 Size, or number of intervals (elements)
 
bool reverse
 Whether to reverse the spacing.
 
bool scale
 Whether to scale parameters in ScaleParameters.
 

Detailed Description

Gaussian spacing function of the general form g(x) = a exp(-(x-m)^2 / c^2) for some scalar parameters a, m, c.

The widths of the first and last intervals (elements) are prescribed, and the remaining interior spacings are computed by using Newton's method to compute parameters that fit the endpoint widths. The results of this spacing function are very similar to those of BellSpacingFunction, but they may differ by about 1%. If the first and last intervals are wide enough, the spacing may decrease in the middle of the domain. The first and last interval widths can be scaled. This function is not nested.

Definition at line 447 of file spacing.hpp.

Constructor & Destructor Documentation

◆ GaussianSpacingFunction()

mfem::GaussianSpacingFunction::GaussianSpacingFunction ( int n,
bool r,
real_t s0,
real_t s1,
bool s )
inline

Constructor for BellSpacingFunction.

Parameters
[in]nSize or number of intervals, which defines elements.
[in]rWhether to reverse the spacings.
[in]s0Width of the first interval (element).
[in]s1Width of the last interval (element).
[in]sWhether to scale parameters by the refinement or coarsening factor, in the function SpacingFunction::ScaleParameters.

Definition at line 458 of file spacing.hpp.

Member Function Documentation

◆ Clone()

std::unique_ptr< SpacingFunction > mfem::GaussianSpacingFunction::Clone ( ) const
inlineoverridevirtual

Returns a clone (deep-copy) of this spacing function.

Reimplemented from mfem::SpacingFunction.

Definition at line 514 of file spacing.hpp.

◆ Eval()

real_t mfem::GaussianSpacingFunction::Eval ( int p) const
inlineoverridevirtual

Returns the width of interval p (between 0 and Size() - 1).

Implements mfem::SpacingFunction.

Definition at line 480 of file spacing.hpp.

◆ GetDoubleParameters()

void mfem::GaussianSpacingFunction::GetDoubleParameters ( Vector & p) const
inlineoverridevirtual

Returns the array of double parameters defining the spacing function.

Parameters
[out]pArray of double parameters, resized appropriately.

Implements mfem::SpacingFunction.

Definition at line 505 of file spacing.hpp.

◆ GetIntParameters()

void mfem::GaussianSpacingFunction::GetIntParameters ( Array< int > & p) const
inlineoverridevirtual

Returns the array of integer parameters defining the spacing function.

Parameters
[out]pArray of integer parameters, resized appropriately.

Implements mfem::SpacingFunction.

Definition at line 497 of file spacing.hpp.

◆ GetSpacingType()

SpacingType mfem::GaussianSpacingFunction::GetSpacingType ( ) const
inlineoverridevirtual

Returns the spacing type, indicating the derived class.

Implements mfem::SpacingFunction.

Definition at line 493 of file spacing.hpp.

◆ Nested()

bool mfem::GaussianSpacingFunction::Nested ( ) const
inlineoverridevirtual

Returns true if the spacing function is nested during refinement.

Implements mfem::SpacingFunction.

Definition at line 512 of file spacing.hpp.

◆ NumDoubleParameters()

int mfem::GaussianSpacingFunction::NumDoubleParameters ( ) const
inlineoverridevirtual

Returns the number of double parameters defining the spacing function.

Implements mfem::SpacingFunction.

Definition at line 495 of file spacing.hpp.

◆ NumIntParameters()

int mfem::GaussianSpacingFunction::NumIntParameters ( ) const
inlineoverridevirtual

Returns the number of integer parameters defining the spacing function.

Implements mfem::SpacingFunction.

Definition at line 494 of file spacing.hpp.

◆ Print()

void mfem::GaussianSpacingFunction::Print ( std::ostream & os) const
inlineoverridevirtual

Prints all the data necessary to define the spacing function and its current state (size and other parameters).

The format is generally SpacingType numIntParam numDoubleParam {int params} {double params}

Implements mfem::SpacingFunction.

Definition at line 486 of file spacing.hpp.

◆ ScaleParameters()

void mfem::GaussianSpacingFunction::ScaleParameters ( real_t a)
inlineoverridevirtual

Scales parameters by the factor a associated with Size().

Note that parameters may be scaled inversely during coarsening and refining, so the scaling should be linear in the sense that scaling by a number followed by scaling by its inverse has no effect on parameters.

Reimplemented from mfem::SpacingFunction.

Definition at line 470 of file spacing.hpp.

◆ SetSize()

void mfem::GaussianSpacingFunction::SetSize ( int size)
inlineoverridevirtual

Sets the size, or number of intervals (elements).

Implements mfem::SpacingFunction.

Definition at line 464 of file spacing.hpp.


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