A TMOP integrator class based on any given TMOP_QualityMetric and TargetConstructor. More...

#include <tmop.hpp>

Inheritance diagram for mfem::TMOP_Integrator:

Collaboration diagram for mfem::TMOP_Integrator:

Public Member Functions
	TMOP_Integrator (TMOP_QualityMetric m, TargetConstructor tc, TMOP_QualityMetric *hm)

	TMOP_Integrator (TMOP_QualityMetric m, TargetConstructor tc)

	~TMOP_Integrator ()

void	ReleasePADeviceMemory (bool copy_to_host=true)

void	SetIntegrationRules (IntegrationRules &irules, int order)
	Prescribe a set of integration rules; relevant for mixed meshes. More...

void	SetCoefficient (Coefficient &w1)
	Sets a scaling Coefficient for the quality metric term of the integrator. More...

void	EnableLimiting (const GridFunction &n0, const GridFunction &dist, Coefficient &w0, TMOP_LimiterFunction *lfunc=NULL)
	Limiting of the mesh displacements (general version). More...

void	EnableLimiting (const GridFunction &n0, Coefficient &w0, TMOP_LimiterFunction *lfunc=NULL)
	Adds a limiting term to the integrator with limiting distance function (dist in the general version of the method) equal to 1. More...

void	EnableAdaptiveLimiting (const GridFunction &z0, Coefficient &coeff, AdaptivityEvaluator &ae)
	Restriction of the node positions to certain regions. More...

void	EnableAdaptiveLimiting (const ParGridFunction &z0, Coefficient &coeff, AdaptivityEvaluator &ae)
	Parallel support for adaptive limiting. More...

void	EnableSurfaceFitting (const GridFunction &s0, const Array< bool > &smarker, Coefficient &coeff, AdaptivityEvaluator &ae)
	Fitting of certain DOFs to the zero level set of a function. More...

void	EnableSurfaceFitting (const ParGridFunction &s0, const Array< bool > &smarker, Coefficient &coeff, AdaptivityEvaluator &ae)
	Parallel support for surface fitting. More...

void	GetSurfaceFittingErrors (double &err_avg, double &err_max)

bool	IsSurfaceFittingEnabled ()

void	SetLimitingNodes (const GridFunction &n0)
	Update the original/reference nodes used for limiting. More...

virtual double	GetElementEnergy (const FiniteElement &el, ElementTransformation &T, const Vector &elfun)
	Computes the integral of W(Jacobian(Trt)) over a target zone. More...

virtual double	GetRefinementElementEnergy (const FiniteElement &el, ElementTransformation &T, const Vector &elfun, const IntegrationRule &irule)
	Computes the mean of the energies of the given element's children. More...

virtual double	GetDerefinementElementEnergy (const FiniteElement &el, ElementTransformation &T, const Vector &elfun)

virtual void	AssembleElementVector (const FiniteElement &el, ElementTransformation &T, const Vector &elfun, Vector &elvect)
	Perform the local action of the NonlinearFormIntegrator. More...

virtual void	AssembleElementGrad (const FiniteElement &el, ElementTransformation &T, const Vector &elfun, DenseMatrix &elmat)
	Assemble the local gradient matrix. More...

TMOP_QualityMetric &	GetAMRQualityMetric ()

void	UpdateAfterMeshTopologyChange ()

void	ParUpdateAfterMeshTopologyChange ()

virtual void	AssemblePA (const FiniteElementSpace &)
	Method defining partial assembly. More...

virtual void	AssembleGradPA (const Vector &, const FiniteElementSpace &)
	Prepare the integrator for partial assembly (PA) gradient evaluations on the given FE space fes at the state x. More...

virtual double	GetLocalStateEnergyPA (const Vector &) const
	Compute the local (to the MPI rank) energy with partial assembly. More...

virtual void	AddMultPA (const Vector &, Vector &) const
	Method for partially assembled action. More...

virtual void	AddMultGradPA (const Vector &, Vector &) const
	Method for partially assembled gradient action. More...

virtual void	AssembleGradDiagonalPA (Vector &) const
	Method for computing the diagonal of the gradient with partial assembly. More...

DiscreteAdaptTC *	GetDiscreteAdaptTC () const

void	EnableNormalization (const GridFunction &x)
	Computes the normalization factors of the metric and limiting integrals using the mesh position given by x. More...

void	ParEnableNormalization (const ParGridFunction &x)

void	EnableFiniteDifferences (const GridFunction &x)
	Enables FD-based approximation and computes dx. More...

void	EnableFiniteDifferences (const ParGridFunction &x)

void	SetFDhScale (double dxscale_)

bool	GetFDFlag () const

double	GetFDh () const

void	SetExactActionFlag (bool flag_)
	Flag to control if exact action of Integration is effected. More...

void	UpdateSurfaceFittingWeight (double factor)
	Update the surface fitting weight as surf_fit_coeff *= factor;. More...

double	GetSurfaceFittingWeight ()
	Get the surface fitting weight. More...

void	ComputeUntangleMetricQuantiles (const Vector &x, const FiniteElementSpace &fes)

Public Member Functions inherited from mfem::NonlinearFormIntegrator
virtual void	SetIntRule (const IntegrationRule *ir)
	Prescribe a fixed IntegrationRule to use (when ir != NULL) or let the integrator choose (when ir == NULL). More...

void	SetIntegrationRule (const IntegrationRule &ir)
	Prescribe a fixed IntegrationRule to use. More...

void	SetPAMemoryType (MemoryType mt)

const IntegrationRule *	GetIntegrationRule () const
	Get the integration rule of the integrator (possibly NULL). More...

virtual void	AssembleFaceVector (const FiniteElement &el1, const FiniteElement &el2, FaceElementTransformations &Tr, const Vector &elfun, Vector &elvect)
	Perform the local action of the NonlinearFormIntegrator resulting from a face integral term. More...

virtual void	AssembleFaceGrad (const FiniteElement &el1, const FiniteElement &el2, FaceElementTransformations &Tr, const Vector &elfun, DenseMatrix &elmat)
	Assemble the local action of the gradient of the NonlinearFormIntegrator resulting from a face integral term. More...

virtual void	AssemblePA (const FiniteElementSpace &trial_fes, const FiniteElementSpace &test_fes)

virtual bool	SupportsCeed () const
	Indicates whether this integrator can use a Ceed backend. More...

virtual void	AssembleMF (const FiniteElementSpace &fes)
	Method defining fully unassembled operator. More...

virtual void	AddMultMF (const Vector &x, Vector &y) const

ceed::Operator &	GetCeedOp ()

virtual	~NonlinearFormIntegrator ()

Protected Member Functions
void	ComputeNormalizationEnergies (const GridFunction &x, double &metric_energy, double &lim_energy, double &surf_fit_gf_energy)

void	AssembleElementVectorExact (const FiniteElement &el, ElementTransformation &T, const Vector &elfun, Vector &elvect)

void	AssembleElementGradExact (const FiniteElement &el, ElementTransformation &T, const Vector &elfun, DenseMatrix &elmat)

void	AssembleElementVectorFD (const FiniteElement &el, ElementTransformation &T, const Vector &elfun, Vector &elvect)

void	AssembleElementGradFD (const FiniteElement &el, ElementTransformation &T, const Vector &elfun, DenseMatrix &elmat)

void	AssembleElemVecAdaptLim (const FiniteElement &el, IsoparametricTransformation &Tpr, const IntegrationRule &ir, const Vector &weights, DenseMatrix &mat)

void	AssembleElemGradAdaptLim (const FiniteElement &el, IsoparametricTransformation &Tpr, const IntegrationRule &ir, const Vector &weights, DenseMatrix &m)

void	AssembleElemVecSurfFit (const FiniteElement &el_x, IsoparametricTransformation &Tpr, DenseMatrix &mat)

void	AssembleElemGradSurfFit (const FiniteElement &el_x, IsoparametricTransformation &Tpr, DenseMatrix &mat)

double	GetFDDerivative (const FiniteElement &el, ElementTransformation &T, Vector &elfun, const int nodenum, const int idir, const double baseenergy, bool update_stored)

void	ComputeFDh (const Vector &x, const FiniteElementSpace &fes)
	Determines the perturbation, h, for FD-based approximation. More...

void	ComputeMinJac (const Vector &x, const FiniteElementSpace &fes)

void	UpdateAfterMeshPositionChange (const Vector &new_x, int new_x_ordering=Ordering::byNODES)

void	DisableLimiting ()

const IntegrationRule &	EnergyIntegrationRule (const FiniteElement &el) const

const IntegrationRule &	ActionIntegrationRule (const FiniteElement &el) const

const IntegrationRule &	GradientIntegrationRule (const FiniteElement &el) const

void	AssembleGradPA_2D (const Vector &) const

void	AssembleGradPA_3D (const Vector &) const

void	AssembleGradPA_C0_2D (const Vector &) const

void	AssembleGradPA_C0_3D (const Vector &) const

double	GetLocalStateEnergyPA_2D (const Vector &) const

double	GetLocalStateEnergyPA_C0_2D (const Vector &) const

double	GetLocalStateEnergyPA_3D (const Vector &) const

double	GetLocalStateEnergyPA_C0_3D (const Vector &) const

void	AddMultPA_2D (const Vector &, Vector &) const

void	AddMultPA_3D (const Vector &, Vector &) const

void	AddMultPA_C0_2D (const Vector &, Vector &) const

void	AddMultPA_C0_3D (const Vector &, Vector &) const

void	AddMultGradPA_2D (const Vector &, Vector &) const

void	AddMultGradPA_3D (const Vector &, Vector &) const

void	AddMultGradPA_C0_2D (const Vector &, Vector &) const

void	AddMultGradPA_C0_3D (const Vector &, Vector &) const

void	AssembleDiagonalPA_2D (Vector &) const

void	AssembleDiagonalPA_3D (Vector &) const

void	AssembleDiagonalPA_C0_2D (Vector &) const

void	AssembleDiagonalPA_C0_3D (Vector &) const

void	AssemblePA_Limiting ()

void	ComputeAllElementTargets (const Vector &xe=Vector()) const

double	ComputeMinDetT (const Vector &x, const FiniteElementSpace &fes)

double	ComputeUntanglerMaxMuBarrier (const Vector &x, const FiniteElementSpace &fes)

Protected Member Functions inherited from mfem::NonlinearFormIntegrator
	NonlinearFormIntegrator (const IntegrationRule *ir=NULL)

Protected Attributes
TMOP_QualityMetric *	h_metric

TMOP_QualityMetric *	metric

const TargetConstructor *	targetC

IntegrationRules *	IntegRules

int	integ_order

Coefficient *	metric_coeff

double	metric_normal

const GridFunction *	lim_nodes0

Coefficient *	lim_coeff

const GridFunction *	lim_dist

TMOP_LimiterFunction *	lim_func

double	lim_normal

const GridFunction *	adapt_lim_gf0

const ParGridFunction *	adapt_lim_pgf0

GridFunction *	adapt_lim_gf

Coefficient *	adapt_lim_coeff

AdaptivityEvaluator *	adapt_lim_eval

GridFunction *	surf_fit_gf

const Array< bool > *	surf_fit_marker

Coefficient *	surf_fit_coeff

AdaptivityEvaluator *	surf_fit_eval

double	surf_fit_normal

DiscreteAdaptTC *	discr_tc

bool	fdflag

double	dx

double	dxscale

bool	fd_call_flag

bool	exact_action

Array< Vector * >	ElemDer

Array< Vector * >	ElemPertEnergy

DenseMatrix	DSh

DenseMatrix	DS

DenseMatrix	Jrt

DenseMatrix	Jpr

DenseMatrix	Jpt

DenseMatrix	P

DenseMatrix	PMatI

DenseMatrix	PMatO

struct {
bool enabled

int dim

int ne

int nq

DenseTensor Jtr

bool Jtr_needs_update

bool Jtr_debug_grad

Vector E

Vector O

Vector X0

Vector H

Vector C0

Vector LD

Vector H0

const DofToQuad * maps

const DofToQuad * maps_lim = nullptr

const GeometricFactors * geom

const FiniteElementSpace * fes

const IntegrationRule * ir

}	PA

Protected Attributes inherited from mfem::NonlinearFormIntegrator
const IntegrationRule *	IntRule

ceed::Operator *	ceedOp

MemoryType	pa_mt = MemoryType::DEFAULT

Friends
class	TMOPNewtonSolver

class	TMOPComboIntegrator

Detailed Description

A TMOP integrator class based on any given TMOP_QualityMetric and TargetConstructor.

Represents \( \int W(Jpt) dx \) over a target zone, where W is the metric's strain energy density function, and Jpt is the Jacobian of the target->physical coordinates transformation. The virtual target zone is defined by the TargetConstructor.

Definition at line 1565 of file tmop.hpp.

Constructor & Destructor Documentation

mfem::TMOP_Integrator::TMOP_Integrator	(	TMOP_QualityMetric *	m,
		TargetConstructor *	tc,
		TMOP_QualityMetric *	hm
	)

inline

Parameters

[in]	m	TMOP_QualityMetric for r-adaptivity (not owned).
[in]	tc	Target-matrix construction algorithm to use (not owned).
[in]	hm	TMOP_QualityMetric for h-adaptivity (not owned).

Definition at line 1797 of file tmop.hpp.

mfem::TMOP_Integrator::TMOP_Integrator	(	TMOP_QualityMetric *	m,
		TargetConstructor *	tc
	)

inline

Definition at line 1812 of file tmop.hpp.

mfem::TMOP_Integrator::~TMOP_Integrator ( )

Definition at line 2678 of file tmop.cpp.

Member Function Documentation

const IntegrationRule& mfem::TMOP_Integrator::ActionIntegrationRule ( const FiniteElement & el ) const

inlineprotected

Definition at line 1746 of file tmop.hpp.

void mfem::TMOP_Integrator::AddMultGradPA	(	const Vector &	x,
		Vector &	y
	)		const

virtual

Method for partially assembled gradient action.

All arguments are E-vectors. This method can be called only after the method AssembleGradPA() has been called.

Parameters

[in]	x	The gradient Operator is applied to the Vector x.
[in,out]	y	The result Vector: \( y += G x \).

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 271 of file tmop_pa.cpp.

void mfem::TMOP_Integrator::AddMultGradPA_2D	(	const Vector &	R,
		Vector &	C
	)		const

protected

Definition at line 114 of file tmop_pa_h2m.cpp.

void mfem::TMOP_Integrator::AddMultGradPA_3D	(	const Vector &	R,
		Vector &	C
	)		const

protected

Definition at line 117 of file tmop_pa_h3m.cpp.

void mfem::TMOP_Integrator::AddMultGradPA_C0_2D	(	const Vector &	R,
		Vector &	C
	)		const

protected

Definition at line 94 of file tmop_pa_h2m_c0.cpp.

void mfem::TMOP_Integrator::AddMultGradPA_C0_3D	(	const Vector &	R,
		Vector &	C
	)		const

protected

Definition at line 98 of file tmop_pa_h3m_c0.cpp.

void mfem::TMOP_Integrator::AddMultPA	(	const Vector &	x,
		Vector &	y
	)		const

virtual

Method for partially assembled action.

Perform the action of integrator on the input x and add the result to the output y. Both x and y are E-vectors, i.e. they represent the element-wise discontinuous version of the FE space.

This method can be called only after the method AssemblePA() has been called.

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 249 of file tmop_pa.cpp.

void mfem::TMOP_Integrator::AddMultPA_2D	(	const Vector &	X,
		Vector &	Y
	)		const

protected

Definition at line 167 of file tmop_pa_p2.cpp.

void mfem::TMOP_Integrator::AddMultPA_3D	(	const Vector &	X,
		Vector &	Y
	)		const

protected

Definition at line 192 of file tmop_pa_p3.cpp.

void mfem::TMOP_Integrator::AddMultPA_C0_2D	(	const Vector &	X,
		Vector &	Y
	)		const

protected

Definition at line 130 of file tmop_pa_p2_c0.cpp.

void mfem::TMOP_Integrator::AddMultPA_C0_3D	(	const Vector &	X,
		Vector &	Y
	)		const

protected

Definition at line 140 of file tmop_pa_p3_c0.cpp.

void mfem::TMOP_Integrator::AssembleDiagonalPA_2D ( Vector & D ) const

protected

Definition at line 147 of file tmop_pa_h2d.cpp.

void mfem::TMOP_Integrator::AssembleDiagonalPA_3D ( Vector & D ) const

protected

Definition at line 136 of file tmop_pa_h3d.cpp.

void mfem::TMOP_Integrator::AssembleDiagonalPA_C0_2D ( Vector & D ) const

protected

Definition at line 84 of file tmop_pa_h2d_c0.cpp.

void mfem::TMOP_Integrator::AssembleDiagonalPA_C0_3D ( Vector & D ) const

protected

Definition at line 111 of file tmop_pa_h3d_c0.cpp.

void mfem::TMOP_Integrator::AssembleElementGrad	(	const FiniteElement &	el,
		ElementTransformation &	Tr,
		const Vector &	elfun,
		DenseMatrix &	elmat
	)

virtual

Assemble the local gradient matrix.

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 3132 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElementGradExact	(	const FiniteElement &	el,
		ElementTransformation &	T,
		const Vector &	elfun,
		DenseMatrix &	elmat
	)

protected

Definition at line 3286 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElementGradFD	(	const FiniteElement &	el,
		ElementTransformation &	T,
		const Vector &	elfun,
		DenseMatrix &	elmat
	)

protected

Definition at line 3709 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElementVector	(	const FiniteElement &	el,
		ElementTransformation &	Tr,
		const Vector &	elfun,
		Vector &	elvect
	)

virtual

Perform the local action of the NonlinearFormIntegrator.

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 3118 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElementVectorExact	(	const FiniteElement &	el,
		ElementTransformation &	T,
		const Vector &	elfun,
		Vector &	elvect
	)

protected

Definition at line 3147 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElementVectorFD	(	const FiniteElement &	el,
		ElementTransformation &	T,
		const Vector &	elfun,
		Vector &	elvect
	)

protected

Definition at line 3643 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElemGradAdaptLim	(	const FiniteElement &	el,
		IsoparametricTransformation &	Tpr,
		const IntegrationRule &	ir,
		const Vector &	weights,
		DenseMatrix &	m
	)

protected

Definition at line 3430 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElemGradSurfFit	(	const FiniteElement &	el_x,
		IsoparametricTransformation &	Tpr,
		DenseMatrix &	mat
	)

protected

Definition at line 3545 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElemVecAdaptLim	(	const FiniteElement &	el,
		IsoparametricTransformation &	Tpr,
		const IntegrationRule &	ir,
		const Vector &	weights,
		DenseMatrix &	mat
	)

protected

Definition at line 3394 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleElemVecSurfFit	(	const FiniteElement &	el_x,
		IsoparametricTransformation &	Tpr,
		DenseMatrix &	mat
	)

protected

Definition at line 3491 of file tmop.cpp.

void mfem::TMOP_Integrator::AssembleGradDiagonalPA ( Vector & diag ) const

virtual

Method for computing the diagonal of the gradient with partial assembly.

The result Vector diag is an E-Vector. This method can be called only after the method AssembleGradPA() has been called.

Parameters

[in,out] diag The result Vector: \( diag += diag(G) \).

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 224 of file tmop_pa.cpp.

void mfem::TMOP_Integrator::AssembleGradPA	(	const Vector &	x,
		const FiniteElementSpace &	fes
	)

virtual

Prepare the integrator for partial assembly (PA) gradient evaluations on the given FE space fes at the state x.

The result of the partial assembly is stored internally so that it can be used later in the methods AddMultGradPA() and AssembleGradDiagonalPA(). The state Vector x is an E-vector.

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 23 of file tmop_pa.cpp.

void mfem::TMOP_Integrator::AssembleGradPA_2D ( const Vector & X ) const

protected

Definition at line 271 of file tmop_pa_h2s.cpp.

void mfem::TMOP_Integrator::AssembleGradPA_3D ( const Vector & X ) const

protected

Definition at line 337 of file tmop_pa_h3s.cpp.

void mfem::TMOP_Integrator::AssembleGradPA_C0_2D ( const Vector & X ) const

protected

Definition at line 103 of file tmop_pa_h2s_c0.cpp.

void mfem::TMOP_Integrator::AssembleGradPA_C0_3D ( const Vector & X ) const

protected

Definition at line 110 of file tmop_pa_h3s_c0.cpp.

void mfem::TMOP_Integrator::AssemblePA ( const FiniteElementSpace & fes )

virtual

Method defining partial assembly.

The result of the partial assembly is stored internally so that it can be used later in the methods AddMultPA().

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 178 of file tmop_pa.cpp.

void mfem::TMOP_Integrator::AssemblePA_Limiting ( )

protected

Definition at line 51 of file tmop_pa.cpp.

void mfem::TMOP_Integrator::ComputeAllElementTargets ( const Vector & xe = Vector() ) const

protected

Definition at line 166 of file tmop_pa.cpp.

void mfem::TMOP_Integrator::ComputeFDh	(	const Vector &	x,
		const FiniteElementSpace &	fes
	)

protected

Determines the perturbation, h, for FD-based approximation.

Definition at line 3977 of file tmop.cpp.

double mfem::TMOP_Integrator::ComputeMinDetT	(	const Vector &	x,
		const FiniteElementSpace &	fes
	)

protected

Definition at line 4021 of file tmop.cpp.

void mfem::TMOP_Integrator::ComputeMinJac	(	const Vector &	x,
		const FiniteElementSpace &	fes
	)

protected

Definition at line 3923 of file tmop.cpp.

void mfem::TMOP_Integrator::ComputeNormalizationEnergies	(	const GridFunction &	x,
		double &	metric_energy,
		double &	lim_energy,
		double &	surf_fit_gf_energy
	)

protected

Definition at line 3852 of file tmop.cpp.

void mfem::TMOP_Integrator::ComputeUntangleMetricQuantiles	(	const Vector &	x,
		const FiniteElementSpace &	fes
	)

Computes quantiles needed for UntangleMetrics. Note that in parallel, the ParFiniteElementSpace must be passed as argument for consistency across MPI ranks.

Definition at line 4125 of file tmop.cpp.

double mfem::TMOP_Integrator::ComputeUntanglerMaxMuBarrier	(	const Vector &	x,
		const FiniteElementSpace &	fes
	)

protected

Definition at line 4063 of file tmop.cpp.

void mfem::TMOP_Integrator::DisableLimiting ( )

inlineprotected

Definition at line 1731 of file tmop.hpp.

void mfem::TMOP_Integrator::EnableAdaptiveLimiting	(	const GridFunction &	z0,
		Coefficient &	coeff,
		AdaptivityEvaluator &	ae
	)

Restriction of the node positions to certain regions.

Adds the term \( \int c (z(x) - z_0(x_0))^2 \), where z0(x0) is a given function on the starting mesh, and z(x) is its image on the new mesh. Minimizing this term means that a node at x0 is allowed to move to a position x(x0) only if z(x) ~ z0(x0). Such term can be used for tangential mesh relaxation.

Parameters

[in]	z0	Function z0 that controls the adaptive limiting.
[in]	coeff	Coefficient c for the above integral.
[in]	ae	AdaptivityEvaluator to compute z(x) from z0(x0).

Definition at line 2715 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableAdaptiveLimiting	(	const ParGridFunction &	z0,
		Coefficient &	coeff,
		AdaptivityEvaluator &	ae
	)

Parallel support for adaptive limiting.

Definition at line 2732 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableFiniteDifferences ( const GridFunction & x )

Enables FD-based approximation and computes dx.

Definition at line 3993 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableFiniteDifferences ( const ParGridFunction & x )

Definition at line 4007 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableLimiting	(	const GridFunction &	n0,
		const GridFunction &	dist,
		Coefficient &	w0,
		TMOP_LimiterFunction *	lfunc = `NULL`
	)

Limiting of the mesh displacements (general version).

Adds the term \( \int w_0 f(x, x_0, d) dx \), where f is a measure of the displacement between x and x_0, given the max allowed displacement d.

Parameters

[in]	n0	Original mesh node coordinates (x0 above).
[in]	dist	Allowed displacement in physical space (d above).
[in]	w0	Coefficient scaling the limiting integral.
[in]	lfunc	TMOP_LimiterFunction defining the function f. If NULL, a TMOP_QuadraticLimiter will be used. The TMOP_Integrator assumes ownership of this pointer.

Definition at line 2690 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableLimiting	(	const GridFunction &	n0,
		Coefficient &	w0,
		TMOP_LimiterFunction *	lfunc = `NULL`
	)

Adds a limiting term to the integrator with limiting distance function (dist in the general version of the method) equal to 1.

Definition at line 2704 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableNormalization ( const GridFunction & x )

Computes the normalization factors of the metric and limiting integrals using the mesh position given by x.

Definition at line 3829 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableSurfaceFitting	(	const GridFunction &	s0,
		const Array< bool > &	smarker,
		Coefficient &	coeff,
		AdaptivityEvaluator &	ae
	)

Fitting of certain DOFs to the zero level set of a function.

Having a level set function s0(x0) on the starting mesh, and a set of marked nodes (or DOFs), we move these nodes to the zero level set of s0. If s(x) is the image of s0(x0) on the current mesh, this function adds to the TMOP functional the term \( \int c \bar{s}(x))^2 \), where \(\bar{s}(x)\) is the restriction of s(x) on the aligned DOFs. Minimizing this term means that a marked node at x0 is allowed to move to a position x(x0) only if s(x) ~ 0. Such term can be used for surface fitting and tangential relaxation.

Parameters

[in]	s0	The level set function on the initial mesh.
[in]	smarker	Indicates which DOFs will be aligned.
[in]	coeff	Coefficient c for the above integral.
[in]	ae	AdaptivityEvaluator to compute s(x) from s0(x0).

Definition at line 2750 of file tmop.cpp.

void mfem::TMOP_Integrator::EnableSurfaceFitting	(	const ParGridFunction &	s0,
		const Array< bool > &	smarker,
		Coefficient &	coeff,
		AdaptivityEvaluator &	ae
	)

Parallel support for surface fitting.

Definition at line 2768 of file tmop.cpp.

const IntegrationRule& mfem::TMOP_Integrator::EnergyIntegrationRule ( const FiniteElement & el ) const

inlineprotected

Definition at line 1737 of file tmop.hpp.

TMOP_QualityMetric& mfem::TMOP_Integrator::GetAMRQualityMetric ( )

inline

Definition at line 1937 of file tmop.hpp.

double mfem::TMOP_Integrator::GetDerefinementElementEnergy	(	const FiniteElement &	el,
		ElementTransformation &	T,
		const Vector &	elfun
	)

virtual

This function is similar to GetElementEnergy, but ignores components such as limiting etc. to compute the element energy.

Definition at line 3064 of file tmop.cpp.

DiscreteAdaptTC* mfem::TMOP_Integrator::GetDiscreteAdaptTC ( ) const

inline

Definition at line 1958 of file tmop.hpp.

double mfem::TMOP_Integrator::GetElementEnergy	(	const FiniteElement &	el,
		ElementTransformation &	T,
		const Vector &	elfun
	)

virtual

Computes the integral of W(Jacobian(Trt)) over a target zone.

Parameters

[in]	el	Type of FiniteElement.
[in]	T	Mesh element transformation.
[in]	elfun	Physical coordinates of the zone.

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 2841 of file tmop.cpp.

double mfem::TMOP_Integrator::GetFDDerivative	(	const FiniteElement &	el,
		ElementTransformation &	T,
		Vector &	elfun,
		const int	nodenum,
		const int	idir,
		const double	baseenergy,
		bool	update_stored
	)

protected

Definition at line 3621 of file tmop.cpp.

bool mfem::TMOP_Integrator::GetFDFlag ( ) const

inline

Definition at line 1974 of file tmop.hpp.

double mfem::TMOP_Integrator::GetFDh ( ) const

inline

Definition at line 1975 of file tmop.hpp.

double mfem::TMOP_Integrator::GetLocalStateEnergyPA ( const Vector & x ) const

virtual

Compute the local (to the MPI rank) energy with partial assembly.

Here the state x is an E-vector. This method can be called only after the method AssemblePA() has been called.

Reimplemented from mfem::NonlinearFormIntegrator.

Definition at line 296 of file tmop_pa.cpp.

double mfem::TMOP_Integrator::GetLocalStateEnergyPA_2D ( const Vector & X ) const

protected

Definition at line 145 of file tmop_pa_w2.cpp.

double mfem::TMOP_Integrator::GetLocalStateEnergyPA_3D ( const Vector & X ) const

protected

Definition at line 155 of file tmop_pa_w3.cpp.

double mfem::TMOP_Integrator::GetLocalStateEnergyPA_C0_2D ( const Vector & X ) const

protected

Definition at line 119 of file tmop_pa_w2_c0.cpp.

double mfem::TMOP_Integrator::GetLocalStateEnergyPA_C0_3D ( const Vector & X ) const

protected

Definition at line 132 of file tmop_pa_w3_c0.cpp.

double mfem::TMOP_Integrator::GetRefinementElementEnergy	(	const FiniteElement &	el,
		ElementTransformation &	T,
		const Vector &	elfun,
		const IntegrationRule &	irule
	)

virtual

Computes the mean of the energies of the given element's children.

In addition to the inputs for GetElementEnergy, this function requires an IntegrationRule to be specified that will give the decomposition of the given element based on the refinement type being considered.

Definition at line 2978 of file tmop.cpp.

void mfem::TMOP_Integrator::GetSurfaceFittingErrors	(	double &	err_avg,
		double &	err_max
	)

Definition at line 2786 of file tmop.cpp.

double mfem::TMOP_Integrator::GetSurfaceFittingWeight ( )

Get the surface fitting weight.

Definition at line 3818 of file tmop.cpp.

const IntegrationRule& mfem::TMOP_Integrator::GradientIntegrationRule ( const FiniteElement & el ) const

inlineprotected

Definition at line 1751 of file tmop.hpp.

bool mfem::TMOP_Integrator::IsSurfaceFittingEnabled ( )

inline

Definition at line 1900 of file tmop.hpp.

void mfem::TMOP_Integrator::ParEnableNormalization ( const ParGridFunction & x )

Definition at line 3839 of file tmop.cpp.

void mfem::TMOP_Integrator::ParUpdateAfterMeshTopologyChange ( )

Definition at line 2828 of file tmop.cpp.

void mfem::TMOP_Integrator::ReleasePADeviceMemory ( bool copy_to_host = true )

Release the device memory of large PA allocations. This will copy device memory back to the host before releasing.

Definition at line 2664 of file tmop.cpp.

void mfem::TMOP_Integrator::SetCoefficient ( Coefficient & w1 )

inline

Sets a scaling Coefficient for the quality metric term of the integrator.

With this addition, the integrator becomes \( \int w1 W(Jpt) dx \).

Note that the Coefficient is evaluated in the physical configuration and not in the target configuration which may be undefined.

Definition at line 1835 of file tmop.hpp.

void mfem::TMOP_Integrator::SetExactActionFlag ( bool flag_ )

inline

Flag to control if exact action of Integration is effected.

Definition at line 1978 of file tmop.hpp.

void mfem::TMOP_Integrator::SetFDhScale ( double dxscale_ )

inline

Definition at line 1973 of file tmop.hpp.

void mfem::TMOP_Integrator::SetIntegrationRules	(	IntegrationRules &	irules,
		int	order
	)

inline

Prescribe a set of integration rules; relevant for mixed meshes.

This function has priority over SetIntRule(), if both are called.

Definition at line 1823 of file tmop.hpp.

void mfem::TMOP_Integrator::SetLimitingNodes ( const GridFunction & n0 )

inline

Update the original/reference nodes used for limiting.

Definition at line 1903 of file tmop.hpp.

void mfem::TMOP_Integrator::UpdateAfterMeshPositionChange	(	const Vector &	new_x,
		int	new_x_ordering = `Ordering::byNODES`
	)

protected

Definition at line 3957 of file tmop.cpp.

void mfem::TMOP_Integrator::UpdateAfterMeshTopologyChange ( )

Definition at line 2815 of file tmop.cpp.

void mfem::TMOP_Integrator::UpdateSurfaceFittingWeight ( double factor )

Update the surface fitting weight as surf_fit_coeff *= factor;.

Definition at line 3806 of file tmop.cpp.

Friends And Related Function Documentation

friend class TMOPComboIntegrator

friend

Definition at line 1569 of file tmop.hpp.

friend class TMOPNewtonSolver

friend

Definition at line 1568 of file tmop.hpp.

Member Data Documentation

Coefficient* mfem::TMOP_Integrator::adapt_lim_coeff

protected

Definition at line 1602 of file tmop.hpp.

AdaptivityEvaluator* mfem::TMOP_Integrator::adapt_lim_eval

protected

Definition at line 1603 of file tmop.hpp.

GridFunction* mfem::TMOP_Integrator::adapt_lim_gf

protected

Definition at line 1601 of file tmop.hpp.

const GridFunction* mfem::TMOP_Integrator::adapt_lim_gf0

protected

Definition at line 1597 of file tmop.hpp.

const ParGridFunction* mfem::TMOP_Integrator::adapt_lim_pgf0

protected

Definition at line 1599 of file tmop.hpp.

Vector mfem::TMOP_Integrator::C0

mutable

Definition at line 1671 of file tmop.hpp.

int mfem::TMOP_Integrator::dim

Definition at line 1667 of file tmop.hpp.

DiscreteAdaptTC* mfem::TMOP_Integrator::discr_tc

protected

Definition at line 1612 of file tmop.hpp.

DenseMatrix mfem::TMOP_Integrator::DS

protected

Definition at line 1638 of file tmop.hpp.

DenseMatrix mfem::TMOP_Integrator::DSh

protected

Definition at line 1638 of file tmop.hpp.

double mfem::TMOP_Integrator::dx

protected

Definition at line 1616 of file tmop.hpp.

double mfem::TMOP_Integrator::dxscale

protected

Definition at line 1617 of file tmop.hpp.

Vector mfem::TMOP_Integrator::E

mutable

Definition at line 1671 of file tmop.hpp.

Array<Vector *> mfem::TMOP_Integrator::ElemDer

protected

Definition at line 1625 of file tmop.hpp.

Array<Vector *> mfem::TMOP_Integrator::ElemPertEnergy

protected

Definition at line 1626 of file tmop.hpp.

bool mfem::TMOP_Integrator::enabled

Definition at line 1666 of file tmop.hpp.

bool mfem::TMOP_Integrator::exact_action

protected

Definition at line 1623 of file tmop.hpp.

bool mfem::TMOP_Integrator::fd_call_flag

protected

Definition at line 1620 of file tmop.hpp.

bool mfem::TMOP_Integrator::fdflag

protected

Definition at line 1615 of file tmop.hpp.

const FiniteElementSpace* mfem::TMOP_Integrator::fes

Definition at line 1675 of file tmop.hpp.

const GeometricFactors* mfem::TMOP_Integrator::geom

Definition at line 1674 of file tmop.hpp.

Vector mfem::TMOP_Integrator::H

mutable

Definition at line 1671 of file tmop.hpp.

Vector mfem::TMOP_Integrator::H0

mutable

Definition at line 1671 of file tmop.hpp.

TMOP_QualityMetric* mfem::TMOP_Integrator::h_metric

protected

Definition at line 1571 of file tmop.hpp.

int mfem::TMOP_Integrator::integ_order

protected

Definition at line 1577 of file tmop.hpp.

IntegrationRules* mfem::TMOP_Integrator::IntegRules

protected

Definition at line 1576 of file tmop.hpp.

const IntegrationRule* mfem::TMOP_Integrator::ir

Definition at line 1676 of file tmop.hpp.

DenseMatrix mfem::TMOP_Integrator::Jpr

protected

Definition at line 1638 of file tmop.hpp.

DenseMatrix mfem::TMOP_Integrator::Jpt

protected

Definition at line 1638 of file tmop.hpp.

DenseMatrix mfem::TMOP_Integrator::Jrt

protected

Definition at line 1638 of file tmop.hpp.

DenseTensor mfem::TMOP_Integrator::Jtr

mutable

Definition at line 1668 of file tmop.hpp.

bool mfem::TMOP_Integrator::Jtr_debug_grad

mutable

Definition at line 1670 of file tmop.hpp.

bool mfem::TMOP_Integrator::Jtr_needs_update

mutable

Definition at line 1669 of file tmop.hpp.

Vector mfem::TMOP_Integrator::LD

mutable

Definition at line 1671 of file tmop.hpp.

Coefficient* mfem::TMOP_Integrator::lim_coeff

protected

Definition at line 1588 of file tmop.hpp.

const GridFunction* mfem::TMOP_Integrator::lim_dist

protected

Definition at line 1590 of file tmop.hpp.

TMOP_LimiterFunction* mfem::TMOP_Integrator::lim_func

protected

Definition at line 1592 of file tmop.hpp.

const GridFunction* mfem::TMOP_Integrator::lim_nodes0

protected

Definition at line 1587 of file tmop.hpp.

double mfem::TMOP_Integrator::lim_normal

protected

Definition at line 1594 of file tmop.hpp.

const DofToQuad* mfem::TMOP_Integrator::maps

Definition at line 1672 of file tmop.hpp.

const DofToQuad* mfem::TMOP_Integrator::maps_lim = nullptr

Definition at line 1673 of file tmop.hpp.

TMOP_QualityMetric* mfem::TMOP_Integrator::metric

protected

Definition at line 1572 of file tmop.hpp.

Coefficient* mfem::TMOP_Integrator::metric_coeff

protected

Definition at line 1580 of file tmop.hpp.

double mfem::TMOP_Integrator::metric_normal

protected

Definition at line 1582 of file tmop.hpp.

int mfem::TMOP_Integrator::ne

Definition at line 1667 of file tmop.hpp.

int mfem::TMOP_Integrator::nq

Definition at line 1667 of file tmop.hpp.

Vector mfem::TMOP_Integrator::O

mutable

Definition at line 1671 of file tmop.hpp.

DenseMatrix mfem::TMOP_Integrator::P

protected

Definition at line 1638 of file tmop.hpp.

struct { ... } mfem::TMOP_Integrator::PA

DenseMatrix mfem::TMOP_Integrator::PMatI

protected

Definition at line 1638 of file tmop.hpp.

DenseMatrix mfem::TMOP_Integrator::PMatO

protected

Definition at line 1638 of file tmop.hpp.

Coefficient* mfem::TMOP_Integrator::surf_fit_coeff

protected

Definition at line 1608 of file tmop.hpp.

AdaptivityEvaluator* mfem::TMOP_Integrator::surf_fit_eval

protected

Definition at line 1609 of file tmop.hpp.

GridFunction* mfem::TMOP_Integrator::surf_fit_gf

protected

Definition at line 1606 of file tmop.hpp.

const Array<bool>* mfem::TMOP_Integrator::surf_fit_marker

protected

Definition at line 1607 of file tmop.hpp.

double mfem::TMOP_Integrator::surf_fit_normal

protected

Definition at line 1610 of file tmop.hpp.

const TargetConstructor* mfem::TMOP_Integrator::targetC

protected

Definition at line 1573 of file tmop.hpp.

Vector mfem::TMOP_Integrator::X0

mutable

Definition at line 1671 of file tmop.hpp.

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

fem/tmop.hpp
fem/tmop.cpp
fem/tmop/tmop_pa.cpp
fem/tmop/tmop_pa_h2d.cpp
fem/tmop/tmop_pa_h2d_c0.cpp
fem/tmop/tmop_pa_h2m.cpp
fem/tmop/tmop_pa_h2m_c0.cpp
fem/tmop/tmop_pa_h2s.cpp
fem/tmop/tmop_pa_h2s_c0.cpp
fem/tmop/tmop_pa_h3d.cpp
fem/tmop/tmop_pa_h3d_c0.cpp
fem/tmop/tmop_pa_h3m.cpp
fem/tmop/tmop_pa_h3m_c0.cpp
fem/tmop/tmop_pa_h3s.cpp
fem/tmop/tmop_pa_h3s_c0.cpp
fem/tmop/tmop_pa_p2.cpp
fem/tmop/tmop_pa_p2_c0.cpp
fem/tmop/tmop_pa_p3.cpp
fem/tmop/tmop_pa_p3_c0.cpp
fem/tmop/tmop_pa_w2.cpp
fem/tmop/tmop_pa_w2_c0.cpp
fem/tmop/tmop_pa_w3.cpp
fem/tmop/tmop_pa_w3_c0.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation