Rodin/Variational/H1.h file

Positive-degree continuous Lagrange spaces and reference elements.

H1 constructs a conforming field from degree- $k$ reference elements, with $k\geq1$ . Vertex, edge, face and cell degrees of freedom are shared according to the mesh incidence and the family trace maps. Scalar, vector and matrix ranges use the corresponding range specialization.

Approximation spaces

On affine simplices the reference space is $\mathbb P_k$ ; on tensor cells it is $\mathbb Q_k$ . Wedges combine triangular and segment factors, while pyramids use their compatible rational construction. The physical basis is transported by the geometric map, $\phi_i=\widehat\phi_i\circ F_K^{-1}$ .

For scalar elements the local counts are:

GeometryScalar degrees of freedom
Segment $k+1$
Triangle $(k+1)(k+2)/2$
Quadrilateral $(k+1)^2$
Tetrahedron $(k+1)(k+2)(k+3)/6$
Wedge $(k+1)^2(k+2)/2$
Hexahedron $(k+1)^3$
Pyramid $(k+1)(k+2)(2k+3)/6$

Reference nodal duality, geometric mapping and global coefficient numbering are separate objects. Use the element and space accessors when evaluating fields or transferring their coefficients. Polynomial approximation rates depend on solution regularity, mesh quality, geometry and quadrature.

Usage

A quadratic scalar space on a prepared mesh is constructed by selecting its degree at compile time.

H1 quadratic(std::integral_constant<size_t, 2>{}, mesh);
TrialFunction u(quadratic);
TestFunction v(quadratic);

The finite element space example constructs and samples constant, linear and quadratic fields on one mesh. RealH1Element<K> exposes a scalar reference element; range-specific aliases and space specializations provide the other supported field types.