MFEM  v4.5.0
Finite element discretization library
Public Member Functions | Public Attributes | List of all members
mfem::ParFiniteElementSpace Class Reference

Abstract parallel finite element space. More...

#include <pfespace.hpp>

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

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
 
ParMeshGetParMesh () const
 
int GetDofSign (int i)
 
HYPRE_BigIntGetDofOffsets () const
 
HYPRE_BigIntGetTrueDofOffsets () const
 
HYPRE_BigInt GlobalVSize () const
 
HYPRE_BigInt GlobalTrueVSize () const
 
virtual int GetTrueVSize () const
 Return the number of local vector true dofs. More...
 
virtual DofTransformationGetElementDofs (int i, Array< int > &dofs) const
 Returns indexes of degrees of freedom in array dofs for i'th element. More...
 
virtual DofTransformationGetBdrElementDofs (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 FiniteElementGetFE (int i) const
 
virtual const FaceRestrictionGetFaceRestriction (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
 
HypreParMatrixDof_TrueDof_Matrix () const
 The true dof-to-dof interpolation matrix. More...
 
HypreParMatrixGetPartialConformingInterpolation ()
 For a non-conforming mesh, construct and return the interpolation matrix from the partially conforming true dofs to the local dofs. More...
 
HypreParVectorNewTrueDofVector ()
 
void DivideByGroupSize (double *vec)
 Scale a vector of true dofs. More...
 
GroupCommunicatorGroupComm ()
 Return a reference to the internal GroupCommunicator (on VDofs) More...
 
const GroupCommunicatorGroupComm () const
 Return a const reference to the internal GroupCommunicator (on VDofs) More...
 
GroupCommunicatorScalarGroupComm ()
 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 OperatorGetProlongationMatrix () const
 The returned Operator is owned by the FiniteElementSpace. More...
 
virtual const OperatorGetRestrictionTransposeOperator () const
 Return logical transpose of restriction matrix, but in non-assembled optimized matrix-free form. More...
 
virtual const OperatorGetRestrictionOperator () const
 
virtual const SparseMatrixGetRestrictionMatrix () const
 Get the R matrix which restricts a local dof vector to true dof vector. More...
 
void ExchangeFaceNbrData ()
 
int GetFaceNbrVSize () const
 
DofTransformationGetFaceNbrElementVDofs (int i, Array< int > &vdofs) const
 
void GetFaceNbrFaceVDofs (int i, Array< int > &vdofs) const
 
const FiniteElementGetFaceNbrFE (int i) const
 
const FiniteElementGetFaceNbrFaceFE (int i) const
 
const HYPRE_BigIntGetFaceNbrGlobalDofMap ()
 
ElementTransformationGetFaceNbrElementTransformation (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...
 
FiniteElementSpaceoperator= (const FiniteElementSpace &)=delete
 Copy assignment not supported. More...
 
MeshGetMesh () const
 Returns the mesh. More...
 
const NURBSExtensionGetNURBSext () const
 
NURBSExtensionGetNURBSext ()
 
NURBSExtensionStealNURBSext ()
 
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 SparseMatrixGetConformingProlongation () const
 The returned SparseMatrix is owned by the FiniteElementSpace. More...
 
const SparseMatrixGetConformingRestriction () const
 The returned SparseMatrix is owned by the FiniteElementSpace. More...
 
const SparseMatrixGetHpConformingRestriction () const
 The returned SparseMatrix is owned by the FiniteElementSpace. More...
 
virtual const SparseMatrixGetHpRestrictionMatrix () const
 The returned SparseMatrix is owned by the FiniteElementSpace. More...
 
const ElementRestrictionOperatorGetElementRestriction (ElementDofOrdering e_ordering) const
 Return an Operator that converts L-vectors to E-vectors. More...
 
const QuadratureInterpolatorGetQuadratureInterpolator (const IntegrationRule &ir) const
 Return a QuadratureInterpolator that interpolates E-vectors to quadrature point values and/or derivatives (Q-vectors). More...
 
const QuadratureInterpolatorGetQuadratureInterpolator (const QuadratureSpace &qs) const
 Return a QuadratureInterpolator that interpolates E-vectors to quadrature point values and/or derivatives (Q-vectors). More...
 
const FaceQuadratureInterpolatorGetFaceQuadratureInterpolator (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 FiniteElementCollectionFEColl () 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...
 
ElementTransformationGetElementTransformation (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...
 
ElementTransformationGetBdrElementTransformation (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
 
DofTransformationGetElementVDofs (int i, Array< int > &vdofs) const
 Returns indexes of degrees of freedom in array dofs for i'th element. More...
 
DofTransformationGetBdrElementVDofs (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 TableGetElementToFaceOrientationTable () const
 
const TableGetElementToDofTable () 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 TableGetBdrElementToDofTable () 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 TableGetFaceToDofTable () 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 FiniteElementGetBE (int i) const
 Returns pointer to the FiniteElement in the FiniteElementCollection associated with i'th boundary face in the mesh object. More...
 
const FiniteElementGetFaceElement (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 FiniteElementGetEdgeElement (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 FiniteElementGetTraceElement (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...
 
SparseMatrixD2C_GlobalRestrictionMatrix (FiniteElementSpace *cfes)
 Generate the global restriction matrix from a discontinuous FE space to the continuous FE space of the same polynomial degree. More...
 
SparseMatrixD2Const_GlobalRestrictionMatrix (FiniteElementSpace *cfes)
 Generate the global restriction matrix from a discontinuous FE space to the piecewise constant FE space. More...
 
SparseMatrixH2L_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 OperatorGetUpdateOperator ()
 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...
 
FiniteElementCollectionLoad (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_BigIntface_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...
 
SparseMatrixRefinementMatrix_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
 
SparseMatrixRefinementMatrix (int old_ndofs, const Table *old_elem_dof, const Table *old_elem_fos)
 
SparseMatrixDerefinementMatrix (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
Meshmesh
 The mesh that FE space lives on (not owned). More...
 
const FiniteElementCollectionfec
 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
 
Tableelem_dof
 
Tableelem_fos
 
Tablebdr_elem_dof
 
Tablebdr_elem_fos
 
Tableface_dof
 
Array< int > dof_elem_array
 
Array< int > dof_ldof_array
 
NURBSExtensionNURBSext
 
int own_ext
 
Array< int > face_to_be
 
Array< DofTransformation * > DoFTrans
 
VDofTransformation VDoFTrans
 
SparseMatrixcP
 
SparseMatrixcR
 Conforming restriction matrix such that cR.cP=I. More...
 
SparseMatrixcR_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

◆ ParFiniteElementSpace() [1/5]

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.

◆ ParFiniteElementSpace() [2/5]

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.

◆ ParFiniteElementSpace() [3/5]

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.

◆ ParFiniteElementSpace() [4/5]

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

Definition at line 61 of file pfespace.cpp.

◆ ParFiniteElementSpace() [5/5]

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.

◆ ~ParFiniteElementSpace()

virtual mfem::ParFiniteElementSpace::~ParFiniteElementSpace ( )
inlinevirtual

Definition at line 429 of file pfespace.hpp.

Member Function Documentation

◆ Conforming()

bool mfem::ParFiniteElementSpace::Conforming ( ) const
inline

Definition at line 407 of file pfespace.hpp.

◆ DivideByGroupSize()

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

Scale a vector of true dofs.

Definition at line 975 of file pfespace.cpp.

◆ Dof_TrueDof_Matrix()

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

The true dof-to-dof interpolation matrix.

Definition at line 321 of file pfespace.hpp.

◆ ExchangeFaceNbrData()

void mfem::ParFiniteElementSpace::ExchangeFaceNbrData ( )

Definition at line 1223 of file pfespace.cpp.

◆ GetBdrElementDofs()

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.

◆ GetComm()

MPI_Comm mfem::ParFiniteElementSpace::GetComm ( ) const
inline

Definition at line 273 of file pfespace.hpp.

◆ GetDofOffsets()

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

Definition at line 281 of file pfespace.hpp.

◆ GetDofSign()

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

Definition at line 279 of file pfespace.hpp.

◆ GetElementDofs()

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.

◆ GetEssentialTrueDofs()

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.

◆ GetEssentialVDofs()

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.

◆ GetFaceDofs()

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.

◆ GetFaceNbrElementTransformation()

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

Definition at line 400 of file pfespace.hpp.

◆ GetFaceNbrElementVDofs()

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

Definition at line 1464 of file pfespace.cpp.

◆ GetFaceNbrFaceFE()

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

Definition at line 1531 of file pfespace.cpp.

◆ GetFaceNbrFaceVDofs()

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

Definition at line 1489 of file pfespace.cpp.

◆ GetFaceNbrFE()

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

Definition at line 1517 of file pfespace.cpp.

◆ GetFaceNbrGlobalDofMap()

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

Definition at line 399 of file pfespace.hpp.

◆ GetFaceNbrVSize()

int mfem::ParFiniteElementSpace::GetFaceNbrVSize ( ) const
inline

Definition at line 394 of file pfespace.hpp.

◆ GetFaceRestriction()

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.

◆ GetFE()

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.

◆ GetGlobalScalarTDofNumber()

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.

◆ GetGlobalTDofNumber()

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.

◆ GetLocalTDofNumber()

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.

◆ GetMyDofOffset()

HYPRE_BigInt mfem::ParFiniteElementSpace::GetMyDofOffset ( ) const

Definition at line 1143 of file pfespace.cpp.

◆ GetMyRank()

int mfem::ParFiniteElementSpace::GetMyRank ( ) const
inline

Definition at line 275 of file pfespace.hpp.

◆ GetMyTDofOffset()

HYPRE_BigInt mfem::ParFiniteElementSpace::GetMyTDofOffset ( ) const

Definition at line 1148 of file pfespace.cpp.

◆ GetNRanks()

int mfem::ParFiniteElementSpace::GetNRanks ( ) const
inline

Definition at line 274 of file pfespace.hpp.

◆ GetParMesh()

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

Definition at line 277 of file pfespace.hpp.

◆ GetPartialConformingInterpolation()

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.

◆ GetProlongationMatrix()

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.

◆ GetRestrictionMatrix()

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.

◆ GetRestrictionOperator()

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.

◆ GetRestrictionTransposeOperator()

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.

◆ GetSharedEdgeDofs()

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

Definition at line 584 of file pfespace.cpp.

◆ GetSharedQuadrilateralDofs()

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

Definition at line 631 of file pfespace.cpp.

◆ GetSharedTriangleDofs()

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

Definition at line 607 of file pfespace.cpp.

◆ GetTrueDofOffsets()

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

Definition at line 282 of file pfespace.hpp.

◆ GetTrueTransferOperator()

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.

◆ GetTrueVSize()

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.

◆ GlobalTrueVSize()

HYPRE_BigInt mfem::ParFiniteElementSpace::GlobalTrueVSize ( ) const
inline

Definition at line 285 of file pfespace.hpp.

◆ GlobalVSize()

HYPRE_BigInt mfem::ParFiniteElementSpace::GlobalVSize ( ) const
inline

Definition at line 283 of file pfespace.hpp.

◆ GroupComm() [1/2]

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

Return a reference to the internal GroupCommunicator (on VDofs)

Definition at line 338 of file pfespace.hpp.

◆ GroupComm() [2/2]

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.

◆ Lose_Dof_TrueDof_Matrix()

void mfem::ParFiniteElementSpace::Lose_Dof_TrueDof_Matrix ( )

Definition at line 1543 of file pfespace.cpp.

◆ LoseDofOffsets()

void mfem::ParFiniteElementSpace::LoseDofOffsets ( )
inline

Definition at line 404 of file pfespace.hpp.

◆ LoseTrueDofOffsets()

void mfem::ParFiniteElementSpace::LoseTrueDofOffsets ( )
inline

Definition at line 405 of file pfespace.hpp.

◆ NewTrueDofVector()

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.

◆ Nonconforming()

bool mfem::ParFiniteElementSpace::Nonconforming ( ) const
inline

Definition at line 408 of file pfespace.hpp.

◆ PrintPartitionStats()

void mfem::ParFiniteElementSpace::PrintPartitionStats ( )

Definition at line 195 of file pfespace.cpp.

◆ ScalarGroupComm()

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.

◆ SharedNDTriangleDofs()

bool mfem::ParFiniteElementSpace::SharedNDTriangleDofs ( ) const
inline

Definition at line 410 of file pfespace.hpp.

◆ Synchronize()

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.

◆ TrueVSize()

int mfem::ParFiniteElementSpace::TrueVSize ( ) const
inline

Obsolete, kept for backward compatibility.

Definition at line 434 of file pfespace.hpp.

◆ Update()

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.

◆ UpdatesFinished()

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

◆ face_nbr_element_dof

Table mfem::ParFiniteElementSpace::face_nbr_element_dof

Definition at line 212 of file pfespace.hpp.

◆ face_nbr_element_fos

Table mfem::ParFiniteElementSpace::face_nbr_element_fos

Definition at line 214 of file pfespace.hpp.

◆ face_nbr_glob_dof_map

Array<HYPRE_BigInt> mfem::ParFiniteElementSpace::face_nbr_glob_dof_map

Definition at line 218 of file pfespace.hpp.

◆ face_nbr_ldof

Table mfem::ParFiniteElementSpace::face_nbr_ldof

Definition at line 216 of file pfespace.hpp.

◆ num_face_nbr_dofs

int mfem::ParFiniteElementSpace::num_face_nbr_dofs

Definition at line 210 of file pfespace.hpp.

◆ send_face_nbr_ldof

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: