Legacy Poisson API
The Poisson operator interface is a legacy single-field API kept for compatibility.
For new models, prefer the multifield weak-form DSL (`Grad`, `Div`, `SymGrad`, `Id`, `TensorDiv`, `Adv`, `∫`) documented in [Multifield](multifield.md).Main Poisson Operators
LowLevelFEM.poissonMatrix — FunctionpoissonMatrix(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)
∫∇oN_c_∇oN_dΩ(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)Assembles the global stiffness matrix for a Poisson-type diffusion operator
K_ab = ∫_Ω (∇N_a · ∇N_b) α(x) dΩ
coefficient can be a constant (Number) or an elementwise ScalarField (interpolated to Gauss points using the Lagrange basis, as in the original implementation).
LowLevelFEM.reactionMatrix — FunctionreactionMatrix(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)
∫N_c_N_dΩ(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)Assembles the global (weighted) mass / reaction matrix
M_ab = ∫_Ω N_a N_b c(x) dΩ
coefficient can be a constant (Number) or an elementwise ScalarField, interpolated to Gauss points using the Lagrange basis (same mechanism as stiffness).
LowLevelFEM.advectionMatrix — FunctionadvectionMatrix(problem::Problem;
coefficient::Union{Number,ScalarField}=1.0,
dir::Int = 1)aliases:
∫N_c_∂N∂x_dΩ(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)
∫N_c_∂N∂y_dΩ(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)
∫N_c_∂N∂z_dΩ(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)Assembles the global convection (advection/drift) matrix
C_ab = ∫_Ω N_a (∂N_b/∂x_dir) β(x) dΩ
dir=1corresponds to x,dir=2to y,dir=3to z (when available).coefficientcan be a constant (Number) or an elementwiseScalarField, interpolated to Gauss points as in the stiffness implementation.
LowLevelFEM.gradDivMatrix — FunctiongradDivMatrix(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)
∫∇N_c_∇N_dΩ(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)Assembles the global matrix corresponding to the grad-div bilinear form
G_ab = ∫_Ω (∇·u_h) (∇·v_h) α(x) dΩ
This is the weak form associated with the operator ∇(∇·u) (up to sign conventions), commonly appearing in linear elasticity and in grad-div stabilization.
Notes
- Requires
problem.pdim == problem.dim(vector unknown with one component per spatial dimension). coefficientcan be a constant (Number) or an elementwiseScalarField, interpolated to Gauss points using the Lagrange basis (same mechanism as inpoissonMatrix).
LowLevelFEM.symmetricGradientMatrix — FunctionsymmetricGradientMatrix(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)Assembles the global matrix for the symmetric-gradient (strain) bilinear form
A(u,v) = ∫_Ω 2μ ε(u) : ε(v) dΩ
ε(u) = 1/2 (∇u + ∇uᵀ)
Notes
- Requires
problem.pdim == problem.dim. coefficientis typically the shear modulusμ(constant orScalarField).
LowLevelFEM.curlCurlMatrix — FunctioncurlCurlMatrix(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)
∫∇xN_c_∇xN_dΩ(problem::Problem; coefficient::Union{Number,ScalarField}=1.0)Assembles the global curl–curl matrix
C(u,v) = ∫_Ω (∇×u) · (∇×v) α(x) dΩ
Notes
- Requires
problem.pdim == problem.dim(vector field). - Uses standard Lagrange H¹ elements (NOT H(curl)-conforming).
- Intended for operator studies, stabilization terms, and educational use.
- Not suitable as a primary operator for Maxwell-type problems.
LowLevelFEM.gradMatrix — FunctiongradMatrix(problem_u::Problem, problem_p::Problem)Assembles the mixed gradient matrix G mapping a scalar field (pressure) to a vector field (velocity), corresponding to the weak form
(G p, v) = -∫_Ω p ∇·v dΩNotes
- Requires problemu.pdim == problemu.dim (vector field).
- Requires problem_p.pdim == 1 (scalar field).
- Requires problemu.dim == problemp.dim.
- The divergence matrix is obtained as D = -G'.
LowLevelFEM.navierStokesAdvectionMatrix — FunctionnavierStokesAdvectionMatrix(problem::Problem, u;
time_index::Int = 1)Assembles the (linearized) Navier–Stokes convection operator in Oseen/Picard form:
C(w,v) = ∫_Ω (u·∇)w · v dΩwhere u is a given velocity field (the coefficient), w is the unknown velocity, and v is the test function.
Matrix size:
problem.pdim == problem.dimis required (vector field).- Returns a
SystemMatrixof size (dimN) × (dimN).
Arguments
problem::Problem: Must represent the velocity unknown (vector field).u: Given advection velocity in the SAME dof ordering asVectorFielduses:[u1x,u1y(,u1z), u2x,u2y(,u2z), ...]. Accepted forms:VectorField(nodal, same mesh)AbstractVector{<:Real}(length = dim*problem.non)
Keyword arguments
time_index: Ifustores multiple time steps internally (e.g. as a matrix), you can select which column to use. For plain vectors it is ignored.
Notes
- This is NOT the scalar
advectionMatrix. This operator uses the given velocityuinside the Gauss integration, assembled in ONE pass (no splitting to 3 scalar fields). - The resulting operator is block-diagonal by velocity components (no component mixing), consistent with (u·∇) acting component-wise in Cartesian coordinates.
LowLevelFEM.tensorLaplaceMatrix — FunctiontensorLaplaceMatrix(problem::Problem;
coefficient::Union{Number,ScalarField}=1.0)Assembles the tensor Laplace operator
∫_Ω ∇(sym σ) : ∇(sym τ) dΩfor a nodal TensorField with pdim = 9.
Notes
- Operator is restricted to the symmetric tensor subspace.
coefficientmay be constant or an elementwise ScalarField.
LowLevelFEM.traceLaplaceMatrix — FunctiontraceLaplaceMatrix(problem::Problem;
coefficient::Union{Number,ScalarField}=1.0)Assembles the trace Laplace operator
∫_Ω ∇tr(σ) · ∇tr(τ) dΩfor a nodal TensorField with pdim = 9.
LowLevelFEM.beltramiMichellMatrix — FunctionbeltramiMichellMatrix(problem::Problem;
coeff_laplace::Union{Number,ScalarField}=1.0,
coeff_trace::Union{Number,ScalarField}=1.0)Assemble the Beltrami-Michell operator as tensorLaplaceMatrix + traceLaplaceMatrix.
Arguments
problem::Problem: Tensor-field problem definition.coeff_laplace: Coefficient fortensorLaplaceMatrix.coeff_trace: Coefficient fortraceLaplaceMatrix.
Returns
SystemMatrix: Sum of the two assembled operators.
Example
Kbm = beltramiMichellMatrix(problem; coeff_laplace=1.0, coeff_trace=1.0)LowLevelFEM.tensorDivDivMatrix — FunctiontensorDivDivMatrix(problem::Problem;
coefficient::Union{Number,ScalarField}=1.0)Assembles the tensor div–div matrix
D(σ,τ) = ∫_Ω (∇·σ_h) · (∇·τ_h) α(x) dΩ
Notes
- Requires
problem.pdim == dim^2(second-order tensor field). - Acts as an equilibrium-enforcing operator in stress-based formulations (e.g. Beltrami–Michell).
coefficientmay be a constant (Number) or an elementwiseScalarField.
LowLevelFEM.loadTensor — FunctionloadTensor(problem::Problem;
source::Union{Matrix{Float64},TensorField} = zeros(3,3))Assembles an L2 right-hand-side vector for tensor-valued problems (pdim = 9):
f_{a,α} = ∫_Ω N_a(x) * S_α(x) dΩwhere S is either
- a constant 3×3 tensor (
Matrix{Float64}), or - a nodal
TensorField.
Notes
- Intended for Beltrami–Michell and other stress-based formulations.
- No traction, pressure, or surface force interpretation.
Legacy Kernel Integrals
LowLevelFEM.∫∇oN_c_∇oN_dΩ — Function∫∇oN_c_∇oN_dΩ(problem::Problem; coefficient=1.0)Legacy compatibility wrapper for poissonMatrix, returning its SystemMatrix. Accepts a numeric or element-wise ScalarField coefficient. For new formulations use the weak-form DSL documented under ∫.
LowLevelFEM.∫∇N_c_∇N_dΩ — Function∫∇N_c_∇N_dΩ(problem::Problem; coefficient=1.0)Legacy compatibility wrapper for gradDivMatrix, returning its SystemMatrix. Accepts a numeric or element-wise ScalarField coefficient. For new formulations use the weak-form DSL documented under ∫.
LowLevelFEM.∫∇xN_c_∇xN_dΩ — Function∫∇xN_c_∇xN_dΩ(problem::Problem; coefficient=1.0)Legacy compatibility wrapper for curlCurlMatrix, returning its SystemMatrix. Accepts a numeric or element-wise ScalarField coefficient. For new formulations use the weak-form DSL documented under ∫.
LowLevelFEM.∫N_c_N_dΩ — Function∫N_c_N_dΩ(problem::Problem; coefficient=1.0)Legacy compatibility wrapper for reactionMatrix, returning its SystemMatrix. Accepts a numeric or element-wise ScalarField coefficient. For new formulations use the weak-form DSL documented under ∫.
LowLevelFEM.∫N_c_∂N∂x_dΩ — Function∫N_c_∂N∂x_dΩ(problem::Problem; coefficient=1.0)Legacy shorthand for advectionMatrix(problem; coefficient, dir=1). Assemble the trial derivative in global x with an identity test operator; this direction must lie within problem.dim. Return a SystemMatrix. See advectionMatrix for coefficient and domain conventions.
LowLevelFEM.∫N_c_∂N∂y_dΩ — Function∫N_c_∂N∂y_dΩ(problem::Problem; coefficient=1.0)Legacy shorthand for advectionMatrix(problem; coefficient, dir=2). Assemble the trial derivative in global y with an identity test operator; this direction must lie within problem.dim. Return a SystemMatrix. See advectionMatrix for coefficient and domain conventions.
LowLevelFEM.∫N_c_∂N∂z_dΩ — Function∫N_c_∂N∂z_dΩ(problem::Problem; coefficient=1.0)Legacy shorthand for advectionMatrix(problem; coefficient, dir=3). Assemble the trial derivative in global z with an identity test operator; this direction must lie within problem.dim. Return a SystemMatrix. See advectionMatrix for coefficient and domain conventions.
sourceVector and ∫N_c_dΩ are aliases of the legacy loadVector interface. Their signatures and behavior are identical. See the migration map for scalar diffusion, reaction and advection.