DOFs¶
A degree of freedom pairs a kernel \(\kappa\) with the input function \(v\) over the entity \(E\) it is defined on:
In FUSE this is DOF(pairing, kernel). The pairing is DeltaPairing
(point evaluation) or L2Pairing (integral moment). The kernel is one of
PointKernel, VectorKernel, PolynomialKernel or
BarycentricPolynomialKernel.
Kernel actions¶
A kernel’s action says how its value transforms under a map of the cell: a symmetry, or the map immersing an entity into a larger cell. It is given with the kernel:
DOF(L2Pairing(), VectorKernel((1, 0), action=HCurl))
H1, HCurl, HDiv and L2 are shorthands for
FormAction, which reads the value as a k-form:
Shorthand |
Action |
Value |
|---|---|---|
|
|
a scalar function (the default for scalar kernels) |
|
|
a 1-form; immersed along the entity (tangential) |
|
|
a (d-1)-form; immersed across the entity (normal) |
|
|
a top form (a density) |
None means the degree is taken from the entity the kernel is defined on.
Other actions can be added by subclassing KernelAction.
Generation¶
DOFGenerator(X, A) applies each member of the generation transversal
A to each DOF in X. A must be a left transversal of the stabiliser
of the span of X. This is not checked on construction; call
check_transversal() to check it.
Immersion¶
immerse(cell, triple) attaches the DOFs of a triple defined on a
sub-entity to cell. Each DOF is lifted into the cell by its kernel’s
action, and the trace applied to the input function is the dual of that lift,
so no trace is passed. Derivative DOFs are the exception: they pass
TrGrad or TrHess.