MFEMGenericFESpace

Overview

This is a low-level routine which allows the user maximum control over the finite element space being constructed. It takes the name of the finite element collection and what MFEM calls "vdim" (the number of degrees of freedom per basis function); these are the same arguments as one would use with raw MFEM. Information on how to construct the name of a finite element collection can be [found in the MFEM documentation](https://docs.mfem.org/html/classmfem_1_1FiniteElementCollection.html#a15fcfa553d4949eb08f9926ac74d1e80).

Most users will find it easier to use the MFEMScalarFESpace and MFEMVectorFESpace classes instead. These will select the appropriate finite element collection and vdim based on your mesh and a few other parameters. However, not all MFEM finite element collections are supported by those classes.

Example Input File Syntax

Input Parameters

fec_nameThe name of the finite element collection to use for this space. See MFEM documentation for details.
C++ Type:std::string
Controllable:No
Description:The name of the finite element collection to use for this space. See MFEM documentation for details.

Required Parameters

orderingVDIMOrdering style to use for vector DoFs.
Default:VDIM
C++ Type:MooseEnum
Options:NODES, VDIM
Controllable:No
Description:Ordering style to use for vector DoFs.
submeshSubmesh to define the FESpace on. Leave blank to use base mesh.
C++ Type:std::string
Controllable:No
Description:Submesh to define the FESpace on. Leave blank to use base mesh.
vdim1The number of degrees of freedom per basis function.
Default:1
C++ Type:int
Controllable:No
Description:The number of degrees of freedom per basis function.

Optional Parameters

control_tagsAdds user-defined labels for accessing object parameters via control logic.
C++ Type:std::vector<std::string>
Controllable:No
Description:Adds user-defined labels for accessing object parameters via control logic.
enableTrueSet the enabled status of the MooseObject.
Default:True
C++ Type:bool
Controllable:No
Description:Set the enabled status of the MooseObject.

Advanced Parameters

Input Files

(test/tests/mfem/submeshes/boundary_submesh.i)

(test/tests/mfem/submeshes/boundary_submesh.i)

[Mesh]
  type = MFEMMesh
  file = ../mesh/cylinder-hex-q2.gen
  uniform_refine = 1
[]

[Problem]
  type = MFEMProblem
[]

[SubMeshes]
  [exterior]
    type = MFEMBoundarySubMesh
    boundary = curved_surface
  []
[]

[FESpaces]
  [SubMeshH1FESpace]
    type = MFEMGenericFESpace
    fec_name = H1_2D_P1
    submesh = exterior
  []
[]

[Variables]
  [submesh_potential]
    type = MFEMVariable
    fespace = SubMeshH1FESpace
  []
[]

[Kernels]
  [mass]
    type = MFEMMassKernel
    variable = submesh_potential
  []
  [source]
    type = MFEMDomainLFKernel
    variable = submesh_potential
    coefficient = 3.0
  []
[]

[Preconditioner]
  [boomeramg]
    type = MFEMHypreBoomerAMG
  []
[]

[Solver]
  type = MFEMHypreGMRES
  preconditioner = boomeramg
  l_tol = 1e-8
  l_max_its = 1000
[]

[Executioner]
  type = MFEMSteady
  device = cpu
[]

[Outputs]
  [ParaViewDataCollection]
    type = MFEMParaViewDataCollection
    file_base = OutputData/BoundaryPotential
    vtk_format = ASCII
    submesh = exterior
  []
[]

Overview
Example Input File Syntax
Input Parameters
Input Files