Abstract parallel finite element space. More...

#include <pfespace.hpp>

Inheritance diagram for mfem::ParFiniteElementSpace:

Collaboration diagram for mfem::ParFiniteElementSpace:

Public Member Functions
	ParFiniteElementSpace (const ParFiniteElementSpace &orig, ParMesh pmesh=NULL, const FiniteElementCollection fec=NULL)
	Copy constructor: deep copy all data from orig except the ParMesh, the FiniteElementCollection, and some derived data. More...

	ParFiniteElementSpace (const FiniteElementSpace &orig, ParMesh &pmesh, const FiniteElementCollection *fec=NULL)
	Convert/copy the local (Par)FiniteElementSpace orig to ParFiniteElementSpace: deep copy all data from orig except the Mesh, the FiniteElementCollection, and some derived data. More...

	ParFiniteElementSpace (ParMesh pm, const FiniteElementSpace global_fes, const int partitioning, const FiniteElementCollection f=NULL)
	Construct the local ParFiniteElementSpace corresponding to the global FE space, global_fes. More...

	ParFiniteElementSpace (ParMesh pm, const FiniteElementCollection f, int dim=1, int ordering=Ordering::byNODES)

	ParFiniteElementSpace (ParMesh pm, NURBSExtension ext, const FiniteElementCollection *f, int dim=1, int ordering=Ordering::byNODES)
	Construct a NURBS FE space based on the given NURBSExtension, ext. More...

MPI_Comm	GetComm () const

int	GetNRanks () const

int	GetMyRank () const

ParMesh *	GetParMesh () const

int	GetDofSign (int i)

HYPRE_BigInt *	GetDofOffsets () const

HYPRE_BigInt *	GetTrueDofOffsets () const

HYPRE_BigInt	GlobalVSize () const

HYPRE_BigInt	GlobalTrueVSize () const

virtual int	GetTrueVSize () const
	Return the number of local vector true dofs. More...

virtual DofTransformation *	GetElementDofs (int i, Array< int > &dofs) const
	Returns indexes of degrees of freedom in array dofs for i'th element. More...

virtual DofTransformation *	GetBdrElementDofs (int i, Array< int > &dofs) const
	Returns indexes of degrees of freedom for i'th boundary element. More...

virtual int	GetFaceDofs (int i, Array< int > &dofs, int variant=0) const

virtual const FiniteElement *	GetFE (int i) const

virtual const FaceRestriction *	GetFaceRestriction (ElementDofOrdering e_ordering, FaceType type, L2FaceValues mul=L2FaceValues::DoubleValued) const

void	GetSharedEdgeDofs (int group, int ei, Array< int > &dofs) const

void	GetSharedTriangleDofs (int group, int fi, Array< int > &dofs) const

void	GetSharedQuadrilateralDofs (int group, int fi, Array< int > &dofs) const

HypreParMatrix *	Dof_TrueDof_Matrix () const
	The true dof-to-dof interpolation matrix. More...

HypreParMatrix *	GetPartialConformingInterpolation ()
	For a non-conforming mesh, construct and return the interpolation matrix from the partially conforming true dofs to the local dofs. More...

HypreParVector *	NewTrueDofVector ()

void	DivideByGroupSize (double *vec)
	Scale a vector of true dofs. More...

GroupCommunicator &	GroupComm ()
	Return a reference to the internal GroupCommunicator (on VDofs) More...

const GroupCommunicator &	GroupComm () const
	Return a const reference to the internal GroupCommunicator (on VDofs) More...

GroupCommunicator *	ScalarGroupComm ()
	Return a new GroupCommunicator on scalar dofs, i.e. for VDim = 1. More...

void	Synchronize (Array< int > &ldof_marker) const
	Given an integer array on the local degrees of freedom, perform a bitwise OR between the shared dofs. More...

virtual void	GetEssentialVDofs (const Array< int > &bdr_attr_is_ess, Array< int > &ess_dofs, int component=-1) const
	Determine the boundary degrees of freedom. More...

virtual void	GetEssentialTrueDofs (const Array< int > &bdr_attr_is_ess, Array< int > &ess_tdof_list, int component=-1)

int	GetLocalTDofNumber (int ldof) const

HYPRE_BigInt	GetGlobalTDofNumber (int ldof) const
	Returns the global tdof number of the given local degree of freedom. More...

HYPRE_BigInt	GetGlobalScalarTDofNumber (int sldof)

HYPRE_BigInt	GetMyDofOffset () const

HYPRE_BigInt	GetMyTDofOffset () const

virtual const Operator *	GetProlongationMatrix () const
	The returned Operator is owned by the FiniteElementSpace. More...

virtual const Operator *	GetRestrictionTransposeOperator () const
	Return logical transpose of restriction matrix, but in non-assembled optimized matrix-free form. More...

virtual const Operator *	GetRestrictionOperator () const

virtual const SparseMatrix *	GetRestrictionMatrix () const
	Get the R matrix which restricts a local dof vector to true dof vector. More...

void	ExchangeFaceNbrData ()

int	GetFaceNbrVSize () const

DofTransformation *	GetFaceNbrElementVDofs (int i, Array< int > &vdofs) const

void	GetFaceNbrFaceVDofs (int i, Array< int > &vdofs) const

const FiniteElement *	GetFaceNbrFE (int i) const

const FiniteElement *	GetFaceNbrFaceFE (int i) const

const HYPRE_BigInt *	GetFaceNbrGlobalDofMap ()

ElementTransformation *	GetFaceNbrElementTransformation (int i) const

void	Lose_Dof_TrueDof_Matrix ()

void	LoseDofOffsets ()

void	LoseTrueDofOffsets ()

bool	Conforming () const

bool	Nonconforming () const

bool	SharedNDTriangleDofs () const

virtual void	GetTrueTransferOperator (const FiniteElementSpace &coarse_fes, OperatorHandle &T) const
	Construct and return an Operator that can be used to transfer true-dof data from coarse_fes, defined on a coarse mesh, to this FE space, defined on a refined mesh. More...

virtual void	Update (bool want_transform=true)

virtual void	UpdatesFinished ()
	Free ParGridFunction transformation matrix (if any), to save memory. More...

virtual	~ParFiniteElementSpace ()

void	PrintPartitionStats ()

int	TrueVSize () const
	Obsolete, kept for backward compatibility. More...

Public Member Functions inherited from mfem::FiniteElementSpace
	FiniteElementSpace ()
	Default constructor: the object is invalid until initialized using the method Load(). More...

	FiniteElementSpace (const FiniteElementSpace &orig, Mesh mesh=NULL, const FiniteElementCollection fec=NULL)
	Copy constructor: deep copy all data from orig except the Mesh, the FiniteElementCollection, and some derived data. More...

	FiniteElementSpace (Mesh mesh, const FiniteElementCollection fec, int vdim=1, int ordering=Ordering::byNODES)

	FiniteElementSpace (Mesh mesh, NURBSExtension ext, const FiniteElementCollection *fec, int vdim=1, int ordering=Ordering::byNODES)
	Construct a NURBS FE space based on the given NURBSExtension, ext. More...

FiniteElementSpace &	operator= (const FiniteElementSpace &)=delete
	Copy assignment not supported. More...

Mesh *	GetMesh () const
	Returns the mesh. More...

const NURBSExtension *	GetNURBSext () const

NURBSExtension *	GetNURBSext ()

NURBSExtension *	StealNURBSext ()

bool	Conforming () const

bool	Nonconforming () const

void	SetElementOrder (int i, int p)
	Sets the order of the i'th finite element. More...

int	GetElementOrder (int i) const
	Returns the order of the i'th finite element. More...

int	GetMaxElementOrder () const
	Return the maximum polynomial order. More...

bool	IsVariableOrder () const
	Returns true if the space contains elements of varying polynomial orders. More...

const SparseMatrix *	GetConformingProlongation () const
	The returned SparseMatrix is owned by the FiniteElementSpace. More...

const SparseMatrix *	GetConformingRestriction () const
	The returned SparseMatrix is owned by the FiniteElementSpace. More...

const SparseMatrix *	GetHpConformingRestriction () const
	The returned SparseMatrix is owned by the FiniteElementSpace. More...

virtual const SparseMatrix *	GetHpRestrictionMatrix () const
	The returned SparseMatrix is owned by the FiniteElementSpace. More...

const ElementRestrictionOperator *	GetElementRestriction (ElementDofOrdering e_ordering) const
	Return an Operator that converts L-vectors to E-vectors. More...

const QuadratureInterpolator *	GetQuadratureInterpolator (const IntegrationRule &ir) const
	Return a QuadratureInterpolator that interpolates E-vectors to quadrature point values and/or derivatives (Q-vectors). More...

const QuadratureInterpolator *	GetQuadratureInterpolator (const QuadratureSpace &qs) const
	Return a QuadratureInterpolator that interpolates E-vectors to quadrature point values and/or derivatives (Q-vectors). More...

const FaceQuadratureInterpolator *	GetFaceQuadratureInterpolator (const IntegrationRule &ir, FaceType type) const
	Return a FaceQuadratureInterpolator that interpolates E-vectors to quadrature point values and/or derivatives (Q-vectors). More...

int	GetOrder (int i) const
	Returns the polynomial degree of the i'th finite element. More...

int	GetEdgeOrder (int edge, int variant=0) const

int	GetFaceOrder (int face, int variant=0) const
	Returns the polynomial degree of the i'th face finite element. More...

int	GetVDim () const
	Returns vector dimension. More...

int	GetNDofs () const
	Returns number of degrees of freedom. More...

int	GetVSize () const
	Return the number of vector dofs, i.e. GetNDofs() x GetVDim(). More...

int	GetNConformingDofs () const

int	GetConformingVSize () const

Ordering::Type	GetOrdering () const
	Return the ordering method. More...

const FiniteElementCollection *	FEColl () const

int	GetNVDofs () const
	Number of all scalar vertex dofs. More...

int	GetNEDofs () const
	Number of all scalar edge-interior dofs. More...

int	GetNFDofs () const
	Number of all scalar face-interior dofs. More...

int	GetNV () const
	Returns number of vertices in the mesh. More...

int	GetNE () const
	Returns number of elements in the mesh. More...

int	GetNF () const
	Returns number of faces (i.e. co-dimension 1 entities) in the mesh. More...

int	GetNBE () const
	Returns number of boundary elements in the mesh. More...

int	GetNFbyType (FaceType type) const
	Returns the number of faces according to the requested type. More...

int	GetElementType (int i) const
	Returns the type of element i. More...

void	GetElementVertices (int i, Array< int > &vertices) const
	Returns the vertices of element i. More...

int	GetBdrElementType (int i) const
	Returns the type of boundary element i. More...

ElementTransformation *	GetElementTransformation (int i) const
	Returns ElementTransformation for the i-th element. More...

void	GetElementTransformation (int i, IsoparametricTransformation *ElTr)
	Returns the transformation defining the i-th element in the user-defined variable ElTr. More...

ElementTransformation *	GetBdrElementTransformation (int i) const
	Returns ElementTransformation for the i-th boundary element. More...

int	GetAttribute (int i) const

int	GetBdrAttribute (int i) const

int	GetEdgeDofs (int edge, Array< int > &dofs, int variant=0) const
	Returns the indices of the degrees of freedom for the specified edge, including the DOFs for the vertices of the edge. More...

void	GetVertexDofs (int i, Array< int > &dofs) const

void	GetElementInteriorDofs (int i, Array< int > &dofs) const

void	GetFaceInteriorDofs (int i, Array< int > &dofs) const

int	GetNumElementInteriorDofs (int i) const

void	GetEdgeInteriorDofs (int i, Array< int > &dofs) const

void	GetVDofs (int vd, Array< int > &dofs, int ndofs=-1) const
	Returns the indices of all of the VDofs for the specified dimension 'vd'. More...

void	DofsToVDofs (Array< int > &dofs, int ndofs=-1) const

void	DofsToVDofs (int vd, Array< int > &dofs, int ndofs=-1) const

int	DofToVDof (int dof, int vd, int ndofs=-1) const

int	VDofToDof (int vdof) const

DofTransformation *	GetElementVDofs (int i, Array< int > &vdofs) const
	Returns indexes of degrees of freedom in array dofs for i'th element. More...

DofTransformation *	GetBdrElementVDofs (int i, Array< int > &vdofs) const
	Returns indexes of degrees of freedom for i'th boundary element. More...

void	GetFaceVDofs (int i, Array< int > &vdofs) const
	Returns indexes of degrees of freedom for i'th face element (2D and 3D). More...

void	GetEdgeVDofs (int i, Array< int > &vdofs) const
	Returns indexes of degrees of freedom for i'th edge. More...

void	GetVertexVDofs (int i, Array< int > &vdofs) const

void	GetElementInteriorVDofs (int i, Array< int > &vdofs) const

void	GetEdgeInteriorVDofs (int i, Array< int > &vdofs) const

MFEM_DEPRECATED void	RebuildElementToDofTable ()
	( More...

void	ReorderElementToDofTable ()
	Reorder the scalar DOFs based on the element ordering. More...

const Table *	GetElementToFaceOrientationTable () const

const Table &	GetElementToDofTable () const
	Return a reference to the internal Table that stores the lists of scalar dofs, for each mesh element, as returned by GetElementDofs(). More...

const Table &	GetBdrElementToDofTable () const
	Return a reference to the internal Table that stores the lists of scalar dofs, for each boundary mesh element, as returned by GetBdrElementDofs(). More...

const Table &	GetFaceToDofTable () const
	Return a reference to the internal Table that stores the lists of scalar dofs, for each face in the mesh, as returned by GetFaceDofs(). In this context, "face" refers to a (dim-1)-dimensional mesh entity. More...

void	BuildDofToArrays ()
	Initialize internal data that enables the use of the methods GetElementForDof() and GetLocalDofForDof(). More...

int	GetElementForDof (int i) const
	Return the index of the first element that contains dof i. More...

int	GetLocalDofForDof (int i) const
	Return the local dof index in the first element that contains dof i. More...

const FiniteElement *	GetBE (int i) const
	Returns pointer to the FiniteElement in the FiniteElementCollection associated with i'th boundary face in the mesh object. More...

const FiniteElement *	GetFaceElement (int i) const
	Returns pointer to the FiniteElement in the FiniteElementCollection associated with i'th face in the mesh object. Faces in this case refer to the MESHDIM-1 primitive so in 2D they are segments and in 1D they are points. More...

const FiniteElement *	GetEdgeElement (int i, int variant=0) const
	Returns pointer to the FiniteElement in the FiniteElementCollection associated with i'th edge in the mesh object. More...

const FiniteElement *	GetTraceElement (int i, Geometry::Type geom_type) const
	Return the trace element from element 'i' to the given 'geom_type'. More...

void	GetBoundaryTrueDofs (Array< int > &boundary_dofs, int component=-1)
	Get a list of all boundary true dofs, boundary_dofs. For spaces with 'vdim' > 1, the 'component' parameter can be used to restricts the marked tDOFs to the specified component. Equivalent to FiniteElementSpace::GetEssentialTrueDofs with all boundary attributes marked as essential. More...

void	ConvertToConformingVDofs (const Array< int > &dofs, Array< int > &cdofs)
	For a partially conforming FE space, convert a marker array (nonzero entries are true) on the partially conforming dofs to a marker array on the conforming dofs. A conforming dofs is marked iff at least one of its dependent dofs is marked. More...

void	ConvertFromConformingVDofs (const Array< int > &cdofs, Array< int > &dofs)
	For a partially conforming FE space, convert a marker array (nonzero entries are true) on the conforming dofs to a marker array on the (partially conforming) dofs. A dof is marked iff it depends on a marked conforming dofs, where dependency is defined by the ConformingRestriction matrix; in other words, a dof is marked iff it corresponds to a marked conforming dof. More...

SparseMatrix *	D2C_GlobalRestrictionMatrix (FiniteElementSpace *cfes)
	Generate the global restriction matrix from a discontinuous FE space to the continuous FE space of the same polynomial degree. More...

SparseMatrix *	D2Const_GlobalRestrictionMatrix (FiniteElementSpace *cfes)
	Generate the global restriction matrix from a discontinuous FE space to the piecewise constant FE space. More...

SparseMatrix *	H2L_GlobalRestrictionMatrix (FiniteElementSpace *lfes)
	Construct the restriction matrix from the FE space given by (this) to the lower degree FE space given by (lfes) which is defined on the same mesh. More...

void	GetTransferOperator (const FiniteElementSpace &coarse_fes, OperatorHandle &T) const
	Construct and return an Operator that can be used to transfer GridFunction data from coarse_fes, defined on a coarse mesh, to this FE space, defined on a refined mesh. More...

const Operator *	GetUpdateOperator ()
	Get the GridFunction update operator. More...

void	GetUpdateOperator (OperatorHandle &T)
	Return the update operator in the given OperatorHandle, T. More...

void	SetUpdateOperatorOwner (bool own)
	Set the ownership of the update operator: if set to false, the Operator returned by GetUpdateOperator() must be deleted outside the FiniteElementSpace. More...

void	SetUpdateOperatorType (Operator::Type tid)
	Specify the Operator::Type to be used by the update operators. More...

long	GetSequence () const

bool	IsDGSpace () const
	Return whether or not the space is discontinuous (L2) More...

void	SetRelaxedHpConformity (bool relaxed=true)

void	Save (std::ostream &out) const
	Save finite element space to output stream out. More...

FiniteElementCollection *	Load (Mesh *m, std::istream &input)
	Read a FiniteElementSpace from a stream. The returned FiniteElementCollection is owned by the caller. More...

virtual	~FiniteElementSpace ()

Public Attributes
int	num_face_nbr_dofs

Table	face_nbr_element_dof

Table	face_nbr_element_fos

Table	face_nbr_ldof

Array< HYPRE_BigInt >	face_nbr_glob_dof_map

Table	send_face_nbr_ldof

Additional Inherited Members
Static Public Member Functions inherited from mfem::FiniteElementSpace
static void	AdjustVDofs (Array< int > &vdofs)

static void	MarkerToList (const Array< int > &marker, Array< int > &list)
	Convert a Boolean marker array to a list containing all marked indices. More...

static void	ListToMarker (const Array< int > &list, int marker_size, Array< int > &marker, int mark_val=-1)
	Convert an array of indices (list) to a Boolean marker array where all indices in the list are marked with the given value and the rest are set to zero. More...

Protected Types inherited from mfem::FiniteElementSpace
using	key_face = std::tuple< bool, ElementDofOrdering, FaceType, L2FaceValues >
	The face restriction operators, see GetFaceRestriction(). More...

using	map_L2F = std::unordered_map< const key_face, FaceRestriction *, key_hash >

typedef std::uint64_t	VarOrderBits
	Bit-mask representing a set of orders needed by an edge/face. More...

Protected Member Functions inherited from mfem::FiniteElementSpace
void	UpdateNURBS ()

void	Construct ()

void	Destroy ()

void	ConstructDoFTrans ()

void	DestroyDoFTrans ()

void	BuildElementToDofTable () const

void	BuildBdrElementToDofTable () const

void	BuildFaceToDofTable () const

void	BuildNURBSFaceToDofTable () const
	Generates partial face_dof table for a NURBS space. More...

int	GetElementOrderImpl (int i) const
	Return element order: internal version of GetElementOrder without checks. More...

void	CalcEdgeFaceVarOrders (Array< VarOrderBits > &edge_orders, Array< VarOrderBits > &face_orders) const

int	MakeDofTable (int ent_dim, const Array< int > &entity_orders, Table &entity_dofs, Array< char > *var_ent_order)

int	FindDofs (const Table &var_dof_table, int row, int ndof) const
	Search row of a DOF table for a DOF set of size 'ndof', return first DOF. More...

int	FindEdgeDof (int edge, int ndof) const

int	FindFaceDof (int face, int ndof) const
	Similar to FindEdgeDof, but used for mixed meshes too. More...

int	FirstFaceDof (int face, int variant=0) const

int	GetNVariants (int entity, int index) const
	Return number of possible DOF variants for edge/face (var. order spaces). More...

int	GetEntityDofs (int entity, int index, Array< int > &dofs, Geometry::Type master_geom=Geometry::INVALID, int variant=0) const
	Helper to get vertex, edge or face DOFs (entity=0,1,2 resp.). More...

int	GetDegenerateFaceDofs (int index, Array< int > &dofs, Geometry::Type master_geom, int variant) const

int	GetNumBorderDofs (Geometry::Type geom, int order) const

void	BuildConformingInterpolation () const
	Calculate the cP and cR matrices for a nonconforming mesh. More...

void	AddEdgeFaceDependencies (SparseMatrix &deps, Array< int > &master_dofs, const FiniteElement master_fe, Array< int > &slave_dofs, int slave_face, const DenseMatrix pm) const

void	MakeVDimMatrix (SparseMatrix &mat) const
	Replicate 'mat' in the vector dimension, according to vdim ordering mode. More...

SparseMatrix *	RefinementMatrix_main (const int coarse_ndofs, const Table &coarse_elem_dof, const Table *coarse_elem_fos, const DenseTensor localP[]) const

void	GetLocalRefinementMatrices (Geometry::Type geom, DenseTensor &localP) const

void	GetLocalDerefinementMatrices (Geometry::Type geom, DenseTensor &localR) const

SparseMatrix *	RefinementMatrix (int old_ndofs, const Table old_elem_dof, const Table old_elem_fos)

SparseMatrix *	DerefinementMatrix (int old_ndofs, const Table old_elem_dof, const Table old_elem_fos)
	Calculate GridFunction restriction matrix after mesh derefinement. More...

void	GetLocalRefinementMatrices (const FiniteElementSpace &coarse_fes, Geometry::Type geom, DenseTensor &localP) const
	Return in localP the local refinement matrices that map between fespaces after mesh refinement. More...

void	Constructor (Mesh mesh, NURBSExtension ext, const FiniteElementCollection *fec, int vdim=1, int ordering=Ordering::byNODES)
	Help function for constructors + Load(). More...

void	UpdateElementOrders ()
	Resize the elem_order array on mesh change. More...

Static Protected Member Functions inherited from mfem::FiniteElementSpace
static int	MinOrder (VarOrderBits bits)
	Return the minimum order (least significant bit set) in the bit mask. More...

static int	EncodeDof (int entity_base, int idx)
	Helper to encode a sign flip into a DOF index (for Hcurl/Hdiv shapes). More...

static int	DecodeDof (int dof)
	Helpers to remove encoded sign from a DOF. More...

static int	DecodeDof (int dof, double &sign)

static void	AddDependencies (SparseMatrix &deps, Array< int > &master_dofs, Array< int > &slave_dofs, DenseMatrix &I, int skipfirst=0)

static bool	DofFinalizable (int dof, const Array< bool > &finalized, const SparseMatrix &deps)

Protected Attributes inherited from mfem::FiniteElementSpace
Mesh *	mesh
	The mesh that FE space lives on (not owned). More...

const FiniteElementCollection *	fec
	Associated FE collection (not owned). More...

int	vdim
	Vector dimension (number of unknowns per degree of freedom). More...

Ordering::Type	ordering

int	ndofs
	Number of degrees of freedom. Number of unknowns is ndofs * vdim. More...

Array< char >	elem_order

int	nvdofs

int	nedofs

int	nfdofs

int	nbdofs

int	uni_fdof
	of single face DOFs if all faces uniform; -1 otherwise More...

int *	bdofs
	internal DOFs of elements if mixed/var-order; NULL otherwise More...

Table	var_edge_dofs

Table	var_face_dofs
	NOTE: also used for spaces with mixed faces. More...

Array< char >	var_edge_orders

Array< char >	var_face_orders

Table *	elem_dof

Table *	elem_fos

Table *	bdr_elem_dof

Table *	bdr_elem_fos

Table *	face_dof

Array< int >	dof_elem_array

Array< int >	dof_ldof_array

NURBSExtension *	NURBSext

int	own_ext

Array< int >	face_to_be

Array< DofTransformation * >	DoFTrans

VDofTransformation	VDoFTrans

SparseMatrix *	cP

SparseMatrix *	cR
	Conforming restriction matrix such that cR.cP=I. More...

SparseMatrix *	cR_hp
	A version of the conforming restriction matrix for variable-order spaces. More...

bool	cP_is_set

OperatorHandle	Th
	Transformation to apply to GridFunctions after space Update(). More...

OperatorHandle	L2E_nat
	The element restriction operators, see GetElementRestriction(). More...

OperatorHandle	L2E_lex

map_L2F	L2F

Array< QuadratureInterpolator * >	E2Q_array

Array < FaceQuadratureInterpolator * >	E2IFQ_array

Array < FaceQuadratureInterpolator * >	E2BFQ_array

long	sequence

long	mesh_sequence

bool	orders_changed
	True if at least one element order changed (variable-order space only). More...

bool	relaxed_hp

Static Protected Attributes inherited from mfem::FiniteElementSpace
static constexpr int	MaxVarOrder = 8*sizeof(VarOrderBits) - 1

Detailed Description

Abstract parallel finite element space.

Definition at line 28 of file pfespace.hpp.

Constructor & Destructor Documentation

mfem::ParFiniteElementSpace::ParFiniteElementSpace	(	const ParFiniteElementSpace &	orig,
		ParMesh *	pmesh = `NULL`,
		const FiniteElementCollection *	fec = `NULL`
	)

Copy constructor: deep copy all data from orig except the ParMesh, the FiniteElementCollection, and some derived data.

If the pmesh or fec pointers are NULL (default), then the new ParFiniteElementSpace will reuse the respective pointers from orig. If any of these pointers is not NULL, the given pointer will be used instead of the one used by orig.

Note: The objects pointed to by the pmesh and fec parameters must be either the same objects as the ones used by orig, or copies of them. Otherwise, the behavior is undefined.; Derived data objects, such as the parallel prolongation and restriction operators, the update operator, and any of the face-neighbor data, will not be copied, even if they are created in the orig object.

Definition at line 29 of file pfespace.cpp.

mfem::ParFiniteElementSpace::ParFiniteElementSpace	(	const FiniteElementSpace &	orig,
		ParMesh &	pmesh,
		const FiniteElementCollection *	fec = `NULL`
	)

Convert/copy the local (Par)FiniteElementSpace orig to ParFiniteElementSpace: deep copy all data from orig except the Mesh, the FiniteElementCollection, and some derived data.

Definition at line 37 of file pfespace.cpp.

mfem::ParFiniteElementSpace::ParFiniteElementSpace	(	ParMesh *	pm,
		const FiniteElementSpace *	global_fes,
		const int *	partitioning,
		const FiniteElementCollection *	f = `NULL`
	)

Construct the local ParFiniteElementSpace corresponding to the global FE space, global_fes.

The parameter pm is the local ParMesh obtained by decomposing the global Mesh used by global_fes. The array partitioning represents the parallel decomposition - it maps global element ids to MPI ranks. If the FiniteElementCollection, f, is NULL (default), the FE collection used by global_fes will be reused. If f is not NULL, it must be the same as, or a copy of, the FE collection used by global_fes.

Definition at line 45 of file pfespace.cpp.

mfem::ParFiniteElementSpace::ParFiniteElementSpace	(	ParMesh *	pm,
		const FiniteElementCollection *	f,
		int	dim = `1`,
		int	ordering = `Ordering::byNODES`
	)

Definition at line 61 of file pfespace.cpp.

mfem::ParFiniteElementSpace::ParFiniteElementSpace	(	ParMesh *	pm,
		NURBSExtension *	ext,
		const FiniteElementCollection *	f,
		int	dim = `1`,
		int	ordering = `Ordering::byNODES`
	)

Construct a NURBS FE space based on the given NURBSExtension, ext.

The parameter ext will be deleted by this constructor, replaced by a ParNURBSExtension owned by the ParFiniteElementSpace.

Note: If the pointer ext is NULL, this constructor is equivalent to the standard constructor with the same arguments minus the NURBSExtension, ext.

Definition at line 68 of file pfespace.cpp.

virtual mfem::ParFiniteElementSpace::~ParFiniteElementSpace ( )

inlinevirtual

Definition at line 429 of file pfespace.hpp.

Member Function Documentation

bool mfem::ParFiniteElementSpace::Conforming ( ) const

inline

Definition at line 407 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::DivideByGroupSize ( double * vec )

Scale a vector of true dofs.

Definition at line 975 of file pfespace.cpp.

HypreParMatrix* mfem::ParFiniteElementSpace::Dof_TrueDof_Matrix ( ) const

inline

The true dof-to-dof interpolation matrix.

Definition at line 321 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::ExchangeFaceNbrData ( )

Definition at line 1223 of file pfespace.cpp.

DofTransformation * mfem::ParFiniteElementSpace::GetBdrElementDofs	(	int	i,
		Array< int > &	dofs
	)		const

virtual

Returns indexes of degrees of freedom for i'th boundary element.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 495 of file pfespace.cpp.

MPI_Comm mfem::ParFiniteElementSpace::GetComm ( ) const

inline

Definition at line 273 of file pfespace.hpp.

HYPRE_BigInt* mfem::ParFiniteElementSpace::GetDofOffsets ( ) const

inline

Definition at line 281 of file pfespace.hpp.

int mfem::ParFiniteElementSpace::GetDofSign ( int i )

inline

Definition at line 279 of file pfespace.hpp.

DofTransformation * mfem::ParFiniteElementSpace::GetElementDofs	(	int	i,
		Array< int > &	dofs
	)		const

virtual

Returns indexes of degrees of freedom in array dofs for i'th element.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 471 of file pfespace.cpp.

void mfem::ParFiniteElementSpace::GetEssentialTrueDofs	(	const Array< int > &	bdr_attr_is_ess,
		Array< int > &	ess_tdof_list,
		int	component = `-1`
	)

virtual

Get a list of essential true dofs, ess_tdof_list, corresponding to the boundary attributes marked in the array bdr_attr_is_ess.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 1032 of file pfespace.cpp.

void mfem::ParFiniteElementSpace::GetEssentialVDofs	(	const Array< int > &	bdr_attr_is_ess,
		Array< int > &	ess_dofs,
		int	component = `-1`
	)		const

virtual

Determine the boundary degrees of freedom.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 1021 of file pfespace.cpp.

int mfem::ParFiniteElementSpace::GetFaceDofs	(	int	i,
		Array< int > &	dofs,
		int	variant = `0`
	)		const

virtual

Returns the indexes of the degrees of freedom for i'th face including the dofs for the edges and the vertices of the face.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 519 of file pfespace.cpp.

ElementTransformation* mfem::ParFiniteElementSpace::GetFaceNbrElementTransformation ( int i ) const

inline

Definition at line 400 of file pfespace.hpp.

DofTransformation * mfem::ParFiniteElementSpace::GetFaceNbrElementVDofs	(	int	i,
		Array< int > &	vdofs
	)		const

Definition at line 1464 of file pfespace.cpp.

const FiniteElement * mfem::ParFiniteElementSpace::GetFaceNbrFaceFE ( int i ) const

Definition at line 1531 of file pfespace.cpp.

void mfem::ParFiniteElementSpace::GetFaceNbrFaceVDofs	(	int	i,
		Array< int > &	vdofs
	)		const

Definition at line 1489 of file pfespace.cpp.

const FiniteElement * mfem::ParFiniteElementSpace::GetFaceNbrFE ( int i ) const

Definition at line 1517 of file pfespace.cpp.

const HYPRE_BigInt* mfem::ParFiniteElementSpace::GetFaceNbrGlobalDofMap ( )

inline

Definition at line 399 of file pfespace.hpp.

int mfem::ParFiniteElementSpace::GetFaceNbrVSize ( ) const

inline

Definition at line 394 of file pfespace.hpp.

const FaceRestriction * mfem::ParFiniteElementSpace::GetFaceRestriction	(	ElementDofOrdering	e_ordering,
		FaceType	type,
		L2FaceValues	mul = `L2FaceValues::DoubleValued`
	)		const

virtual

Returns an Operator that converts L-vectors to E-vectors on each face. The parallel version is different from the serial one because of the presence of shared faces. Shared faces are treated as interior faces, the returned operator handles the communication needed to get the shared face values from other MPI ranks

Reimplemented from mfem::FiniteElementSpace.

Definition at line 542 of file pfespace.cpp.

const FiniteElement * mfem::ParFiniteElementSpace::GetFE ( int i ) const

virtual

Returns pointer to the FiniteElement in the FiniteElementCollection associated with i'th element in the mesh object. If i is greater than or equal to the number of local mesh elements, i will be interpreted as a shifted index of a face neighbor element.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 535 of file pfespace.cpp.

HYPRE_BigInt mfem::ParFiniteElementSpace::GetGlobalScalarTDofNumber ( int sldof )

Returns the global tdof number of the given local degree of freedom in the scalar version of the current finite element space. The input should be a scalar local dof.

Definition at line 1106 of file pfespace.cpp.

HYPRE_BigInt mfem::ParFiniteElementSpace::GetGlobalTDofNumber ( int ldof ) const

Returns the global tdof number of the given local degree of freedom.

Definition at line 1083 of file pfespace.cpp.

int mfem::ParFiniteElementSpace::GetLocalTDofNumber ( int ldof ) const

If the given ldof is owned by the current processor, return its local tdof number, otherwise return -1

Definition at line 1062 of file pfespace.cpp.

HYPRE_BigInt mfem::ParFiniteElementSpace::GetMyDofOffset ( ) const

Definition at line 1143 of file pfespace.cpp.

int mfem::ParFiniteElementSpace::GetMyRank ( ) const

inline

Definition at line 275 of file pfespace.hpp.

HYPRE_BigInt mfem::ParFiniteElementSpace::GetMyTDofOffset ( ) const

Definition at line 1148 of file pfespace.cpp.

int mfem::ParFiniteElementSpace::GetNRanks ( ) const

inline

Definition at line 274 of file pfespace.hpp.

ParMesh* mfem::ParFiniteElementSpace::GetParMesh ( ) const

inline

Definition at line 277 of file pfespace.hpp.

HypreParMatrix * mfem::ParFiniteElementSpace::GetPartialConformingInterpolation ( )

For a non-conforming mesh, construct and return the interpolation matrix from the partially conforming true dofs to the local dofs.

Note: The returned pointer must be deleted by the caller.

Definition at line 964 of file pfespace.cpp.

const Operator * mfem::ParFiniteElementSpace::GetProlongationMatrix ( ) const

virtual

The returned Operator is owned by the FiniteElementSpace.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 1153 of file pfespace.cpp.

virtual const SparseMatrix* mfem::ParFiniteElementSpace::GetRestrictionMatrix ( ) const

inlinevirtual

Get the R matrix which restricts a local dof vector to true dof vector.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 389 of file pfespace.hpp.

const Operator * mfem::ParFiniteElementSpace::GetRestrictionOperator ( ) const

virtual

Get an Operator that performs the action of GetRestrictionMatrix(), but potentially with a non-assembled optimized matrix-free implementation.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 1184 of file pfespace.cpp.

const Operator * mfem::ParFiniteElementSpace::GetRestrictionTransposeOperator ( ) const

virtual

Return logical transpose of restriction matrix, but in non-assembled optimized matrix-free form.

The implementation is like GetProlongationMatrix, but it sets local DOFs to the true DOF values if owned locally, otherwise zero.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 1217 of file pfespace.cpp.

void mfem::ParFiniteElementSpace::GetSharedEdgeDofs	(	int	group,
		int	ei,
		Array< int > &	dofs
	)		const

Definition at line 584 of file pfespace.cpp.

void mfem::ParFiniteElementSpace::GetSharedQuadrilateralDofs	(	int	group,
		int	fi,
		Array< int > &	dofs
	)		const

Definition at line 631 of file pfespace.cpp.

void mfem::ParFiniteElementSpace::GetSharedTriangleDofs	(	int	group,
		int	fi,
		Array< int > &	dofs
	)		const

Definition at line 607 of file pfespace.cpp.

HYPRE_BigInt* mfem::ParFiniteElementSpace::GetTrueDofOffsets ( ) const

inline

Definition at line 282 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::GetTrueTransferOperator	(	const FiniteElementSpace &	coarse_fes,
		OperatorHandle &	T
	)		const

virtual

Construct and return an Operator that can be used to transfer true-dof data from coarse_fes, defined on a coarse mesh, to this FE space, defined on a refined mesh.

This method calls GetTransferOperator() and multiplies the result by the prolongation operator of coarse_fes on the right, and by the restriction operator of this FE space on the left.

The Operator::Type of T can be set to request an Operator of the set type. In serial, the supported types are: Operator::MFEM_SPARSEMAT and Operator::ANY_TYPE (matrix-free). In parallel, the supported types are: Operator::Hypre_ParCSR and Operator::ANY_TYPE. Any other type is treated as Operator::ANY_TYPE: the operator representation choice is made by this method.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 3260 of file pfespace.cpp.

virtual int mfem::ParFiniteElementSpace::GetTrueVSize ( ) const

inlinevirtual

Return the number of local vector true dofs.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 289 of file pfespace.hpp.

HYPRE_BigInt mfem::ParFiniteElementSpace::GlobalTrueVSize ( ) const

inline

Definition at line 285 of file pfespace.hpp.

HYPRE_BigInt mfem::ParFiniteElementSpace::GlobalVSize ( ) const

inline

Definition at line 283 of file pfespace.hpp.

GroupCommunicator& mfem::ParFiniteElementSpace::GroupComm ( )

inline

Return a reference to the internal GroupCommunicator (on VDofs)

Definition at line 338 of file pfespace.hpp.

const GroupCommunicator& mfem::ParFiniteElementSpace::GroupComm ( ) const

inline

Return a const reference to the internal GroupCommunicator (on VDofs)

Definition at line 341 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::Lose_Dof_TrueDof_Matrix ( )

Definition at line 1543 of file pfespace.cpp.

void mfem::ParFiniteElementSpace::LoseDofOffsets ( )

inline

Definition at line 404 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::LoseTrueDofOffsets ( )

inline

Definition at line 405 of file pfespace.hpp.

HypreParVector* mfem::ParFiniteElementSpace::NewTrueDofVector ( )

inline

Create and return a new HypreParVector on the true dofs, which is owned by (i.e. it must be destroyed by) the calling function.

Definition at line 331 of file pfespace.hpp.

bool mfem::ParFiniteElementSpace::Nonconforming ( ) const

inline

Definition at line 408 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::PrintPartitionStats ( )

Definition at line 195 of file pfespace.cpp.

GroupCommunicator * mfem::ParFiniteElementSpace::ScalarGroupComm ( )

Return a new GroupCommunicator on scalar dofs, i.e. for VDim = 1.

Note: The returned pointer must be deleted by the caller.

Definition at line 995 of file pfespace.cpp.

bool mfem::ParFiniteElementSpace::SharedNDTriangleDofs ( ) const

inline

Definition at line 410 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::Synchronize ( Array< int > & ldof_marker ) const

Given an integer array on the local degrees of freedom, perform a bitwise OR between the shared dofs.

For non-conforming mesh, synchronization is performed on the cut (aka "partially conforming") space.

Definition at line 1009 of file pfespace.cpp.

int mfem::ParFiniteElementSpace::TrueVSize ( ) const

inline

Obsolete, kept for backward compatibility.

Definition at line 434 of file pfespace.hpp.

void mfem::ParFiniteElementSpace::Update ( bool want_transform = true )

virtual

Reflect changes in the mesh. Calculate one of the refinement/derefinement /rebalance matrices, unless want_transform is false.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 3287 of file pfespace.cpp.

virtual void mfem::ParFiniteElementSpace::UpdatesFinished ( )

inlinevirtual

Free ParGridFunction transformation matrix (if any), to save memory.

Reimplemented from mfem::FiniteElementSpace.

Definition at line 423 of file pfespace.hpp.

Member Data Documentation

Table mfem::ParFiniteElementSpace::face_nbr_element_dof

Definition at line 212 of file pfespace.hpp.

Table mfem::ParFiniteElementSpace::face_nbr_element_fos

Definition at line 214 of file pfespace.hpp.

Array<HYPRE_BigInt> mfem::ParFiniteElementSpace::face_nbr_glob_dof_map

Definition at line 218 of file pfespace.hpp.

Table mfem::ParFiniteElementSpace::face_nbr_ldof

Definition at line 216 of file pfespace.hpp.

int mfem::ParFiniteElementSpace::num_face_nbr_dofs

Definition at line 210 of file pfespace.hpp.

Table mfem::ParFiniteElementSpace::send_face_nbr_ldof

Definition at line 220 of file pfespace.hpp.

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

fem/pfespace.hpp
fem/pfespace.cpp

Public Member Functions

Public Attributes

Additional Inherited Members

of single face DOFs if all faces uniform; -1 otherwise

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation