Base class representing target-matrix construction algorithms for mesh optimization via the target-matrix optimization paradigm (TMOP). More...

#include <tmop.hpp>

Inheritance diagram for mfem::TargetConstructor:

[legend]

Collaboration diagram for mfem::TargetConstructor:

[legend]

Public Types
enum	TargetType { IDEAL_SHAPE_UNIT_SIZE, IDEAL_SHAPE_EQUAL_SIZE, IDEAL_SHAPE_GIVEN_SIZE, GIVEN_SHAPE_AND_SIZE, GIVEN_FULL }
	Target-matrix construction algorithms supported by this class. More...

Public Member Functions
	TargetConstructor (TargetType ttype)
	Constructor for use in serial. More...

	TargetConstructor (TargetType ttype, MPI_Comm mpicomm)
	Constructor for use in parallel. More...

virtual	~TargetConstructor ()

bool	Parallel () const

MPI_Comm	GetComm () const

bool	Parallel () const

void	SetNodes (const GridFunction &n)
	Set the nodes to be used in the target-matrix construction. More...

const GridFunction *	GetNodes () const
	Get the nodes to be used in the target-matrix construction. More...

void	SetVolumeScale (double vol_scale)
	Used by target type IDEAL_SHAPE_EQUAL_SIZE. The default volume scale is 1. More...

TargetType	GetTargetType () const

bool	UsesPhysicalCoordinates () const
	Return true if the methods ComputeElementTargets(), ComputeAllElementTargets(), and ComputeElementTargetsGradient() use the physical node coordinates provided by the parameters 'elfun', or 'xe'. More...

virtual bool	ContainsVolumeInfo () const
	Checks if the target matrices contain non-trivial size specification. More...

virtual void	ComputeElementTargets (int e_id, const FiniteElement &fe, const IntegrationRule &ir, const Vector &elfun, DenseTensor &Jtr) const
	Given an element and quadrature rule, computes ref->target transformation Jacobians for each quadrature point in the element. The physical positions of the element's nodes are given by elfun. More...

virtual void	ComputeAllElementTargets (const FiniteElementSpace &fes, const IntegrationRule &ir, const Vector &xe, DenseTensor &Jtr) const
	Computes reference-to-target transformation Jacobians for all quadrature points in all elements. More...

virtual void	ComputeElementTargetsGradient (const IntegrationRule &ir, const Vector &elfun, IsoparametricTransformation &Tpr, DenseTensor &dJtr) const

Protected Member Functions
void	ComputeAvgVolume () const

template<int DIM>
bool	ComputeAllElementTargets (const FiniteElementSpace &fes, const IntegrationRule &ir, const Vector &xe, DenseTensor &Jtr) const

void	ComputeAllElementTargets_Fallback (const FiniteElementSpace &fes, const IntegrationRule &ir, const Vector &xe, DenseTensor &Jtr) const

template<>
bool	ComputeAllElementTargets (const FiniteElementSpace &fes, const IntegrationRule &ir, const Vector &, DenseTensor &Jtr) const

template<>
bool	ComputeAllElementTargets (const FiniteElementSpace &fes, const IntegrationRule &ir, const Vector &, DenseTensor &Jtr) const

Protected Attributes
const GridFunction *	nodes

double	avg_volume

double	volume_scale

const TargetType	target_type

bool	uses_phys_coords

MPI_Comm	comm

Detailed Description

Base class representing target-matrix construction algorithms for mesh optimization via the target-matrix optimization paradigm (TMOP).

This class is used by class TMOP_Integrator to construct the target Jacobian matrices (reference-element to target-element) at quadrature points. It supports a set of algorithms chosen by the TargetType enumeration.

New target-matrix construction algorithms can be defined by deriving new classes and overriding the methods ComputeElementTargets() and ContainsVolumeInfo().

Definition at line 1234 of file tmop.hpp.

Member Enumeration Documentation

◆ TargetType

enum mfem::TargetConstructor::TargetType

Target-matrix construction algorithms supported by this class.

Enumerator
IDEAL_SHAPE_UNIT_SIZE	Ideal shape, unit size; the nodes are not used.
IDEAL_SHAPE_EQUAL_SIZE	Ideal shape, equal size/volume; the given nodes define the total target volume; for each mesh element, the target volume is the average volume multiplied by the volume scale, set with SetVolumeScale().
IDEAL_SHAPE_GIVEN_SIZE	Ideal shape, given size/volume; the given nodes define the target volume at all quadrature points.
GIVEN_SHAPE_AND_SIZE	Given shape, given size/volume; the given nodes define the exact target Jacobian matrix at all quadrature points.
GIVEN_FULL	Full target tensor is specified at every quadrature point.

Definition at line 1238 of file tmop.hpp.

Constructor & Destructor Documentation

◆ TargetConstructor() [1/2]

mfem::TargetConstructor::TargetConstructor ( TargetType ttype )

inline

Constructor for use in serial.

Definition at line 1286 of file tmop.hpp.

◆ TargetConstructor() [2/2]

mfem::TargetConstructor::TargetConstructor	(	TargetType	ttype,
		MPI_Comm	mpicomm
	)

inline

Constructor for use in parallel.

Definition at line 1296 of file tmop.hpp.

◆ ~TargetConstructor()

virtual mfem::TargetConstructor::~TargetConstructor ( )

inlinevirtual

Definition at line 1300 of file tmop.hpp.

Member Function Documentation

◆ ComputeAllElementTargets() [1/4]

template<>

bool mfem::TargetConstructor::ComputeAllElementTargets	(	const FiniteElementSpace &	fes,
		const IntegrationRule &	ir,
		const Vector &	,
		DenseTensor &	Jtr
	)		const

protected

Definition at line 113 of file tmop_pa_tc2.cpp.

◆ ComputeAllElementTargets() [2/4]

template<>

bool mfem::TargetConstructor::ComputeAllElementTargets	(	const FiniteElementSpace &	fes,
		const IntegrationRule &	ir,
		const Vector &	,
		DenseTensor &	Jtr
	)		const

protected

Definition at line 117 of file tmop_pa_tc3.cpp.

◆ ComputeAllElementTargets() [3/4]

template<int DIM>

bool mfem::TargetConstructor::ComputeAllElementTargets	(	const FiniteElementSpace &	fes,
		const IntegrationRule &	ir,
		const Vector &	xe,
		DenseTensor &	Jtr
	)		const

protected

◆ ComputeAllElementTargets() [4/4]

void mfem::TargetConstructor::ComputeAllElementTargets	(	const FiniteElementSpace &	fes,
		const IntegrationRule &	ir,
		const Vector &	xe,
		DenseTensor &	Jtr
	)		const

virtual

Computes reference-to-target transformation Jacobians for all quadrature points in all elements.

Parameters

[in]	fes	The nodal FE space
[in]	ir	The quadrature rule to use for all elements
[in]	xe	E-vector with the current physical coordinates/positions; this parameter is used only when needed by the target constructor, see UsesPhysicalCoordinates()
[out]	Jtr	The computed ref->target Jacobian matrices.

Reimplemented in mfem::DiscreteAdaptTC, and mfem::AnalyticAdaptTC.

Definition at line 124 of file tmop_pa.cpp.

◆ ComputeAllElementTargets_Fallback()

void mfem::TargetConstructor::ComputeAllElementTargets_Fallback	(	const FiniteElementSpace &	fes,
		const IntegrationRule &	ir,
		const Vector &	xe,
		DenseTensor &	Jtr
	)		const

protected

Definition at line 1468 of file tmop.cpp.

◆ ComputeAvgVolume()

void mfem::TargetConstructor::ComputeAvgVolume ( ) const

protected

Definition at line 1426 of file tmop.cpp.

◆ ComputeElementTargets()

void mfem::TargetConstructor::ComputeElementTargets	(	int	e_id,
		const FiniteElement &	fe,
		const IntegrationRule &	ir,
		const Vector &	elfun,
		DenseTensor &	Jtr
	)		const

virtual

Given an element and quadrature rule, computes ref->target transformation Jacobians for each quadrature point in the element. The physical positions of the element's nodes are given by elfun.

Reimplemented in mfem::DiscreteAdaptTC, and mfem::AnalyticAdaptTC.

Definition at line 1554 of file tmop.cpp.

◆ ComputeElementTargetsGradient()

void mfem::TargetConstructor::ComputeElementTargetsGradient	(	const IntegrationRule &	ir,
		const Vector &	elfun,
		IsoparametricTransformation &	Tpr,
		DenseTensor &	dJtr
	)		const

virtual

Reimplemented in mfem::DiscreteAdaptTC, and mfem::AnalyticAdaptTC.

Definition at line 1625 of file tmop.cpp.

◆ ContainsVolumeInfo()

bool mfem::TargetConstructor::ContainsVolumeInfo ( ) const

virtual

Checks if the target matrices contain non-trivial size specification.

Definition at line 1540 of file tmop.cpp.

◆ GetComm()

MPI_Comm mfem::TargetConstructor::GetComm ( ) const

inline

Definition at line 1304 of file tmop.hpp.

◆ GetNodes()

const GridFunction* mfem::TargetConstructor::GetNodes ( ) const

inline

Get the nodes to be used in the target-matrix construction.

Definition at line 1317 of file tmop.hpp.

◆ GetTargetType()

TargetType mfem::TargetConstructor::GetTargetType ( ) const

inline

Definition at line 1322 of file tmop.hpp.

◆ Parallel() [1/2]

bool mfem::TargetConstructor::Parallel ( ) const

inline

Definition at line 1303 of file tmop.hpp.

◆ Parallel() [2/2]

bool mfem::TargetConstructor::Parallel ( ) const

inline

Definition at line 1306 of file tmop.hpp.

◆ SetNodes()

void mfem::TargetConstructor::SetNodes ( const GridFunction & n )

inline

Set the nodes to be used in the target-matrix construction.

This method should be called every time the target nodes are updated externally and recomputation of the target average volume is needed. The nodes are used by all target types except IDEAL_SHAPE_UNIT_SIZE.

Definition at line 1314 of file tmop.hpp.

◆ SetVolumeScale()

void mfem::TargetConstructor::SetVolumeScale ( double vol_scale )

inline

Used by target type IDEAL_SHAPE_EQUAL_SIZE. The default volume scale is 1.

Definition at line 1320 of file tmop.hpp.

◆ UsesPhysicalCoordinates()

bool mfem::TargetConstructor::UsesPhysicalCoordinates ( ) const

inline

Return true if the methods ComputeElementTargets(), ComputeAllElementTargets(), and ComputeElementTargetsGradient() use the physical node coordinates provided by the parameters 'elfun', or 'xe'.

Definition at line 1327 of file tmop.hpp.

Member Data Documentation

◆ avg_volume

double mfem::TargetConstructor::avg_volume

mutableprotected

Definition at line 1259 of file tmop.hpp.

◆ comm

MPI_Comm mfem::TargetConstructor::comm

protected

Definition at line 1265 of file tmop.hpp.

◆ nodes

const GridFunction* mfem::TargetConstructor::nodes

protected

Definition at line 1258 of file tmop.hpp.

◆ target_type

const TargetType mfem::TargetConstructor::target_type

protected

Definition at line 1261 of file tmop.hpp.

◆ uses_phys_coords

bool mfem::TargetConstructor::uses_phys_coords

protected

Definition at line 1262 of file tmop.hpp.

◆ volume_scale

double mfem::TargetConstructor::volume_scale

protected

Definition at line 1260 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_tc2.cpp
fem/tmop/tmop_pa_tc3.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ TargetType

Constructor & Destructor Documentation

◆ TargetConstructor() [1/2]

◆ TargetConstructor() [2/2]

◆ ~TargetConstructor()

Member Function Documentation

◆ ComputeAllElementTargets() [1/4]

◆ ComputeAllElementTargets() [2/4]

◆ ComputeAllElementTargets() [3/4]

◆ ComputeAllElementTargets() [4/4]

◆ ComputeAllElementTargets_Fallback()

◆ ComputeAvgVolume()

◆ ComputeElementTargets()

◆ ComputeElementTargetsGradient()

◆ ContainsVolumeInfo()

◆ GetComm()

◆ GetNodes()

◆ GetTargetType()

◆ Parallel() [1/2]

◆ Parallel() [2/2]

◆ SetNodes()

◆ SetVolumeScale()

◆ UsesPhysicalCoordinates()

Member Data Documentation

◆ avg_volume

◆ comm

◆ nodes

◆ target_type

◆ uses_phys_coords

◆ volume_scale