Analytical Cases

Last changes: Documentation changelog

Analytical validation compares FullMag against closed-form micromagnetics results rather than another solver. The cases below mirror the physical models behind the FEM/FDM terminals; the public page states which ones have current executed evidence and which remain scripted but runtime-open.

Exchange sinusoidal mode

A \(180^\circ\)-mode sinusoidal magnetization has a closed-form exchange field, \(\mathbf{H}_{\mathrm{ex}} = \frac{2 A_{\mathrm{ex}}}{\mu_0 M_s} \nabla^2 \mathbf{m}\), and an exchange energy converging to \(A_{\mathrm{ex}} k^2 V\). The acceptance gate is scripted in tests/fem_exchange_validation/sinusoidal_mode.py and requires a MFEM/libCEED runtime for the full refinement sweep.

  • Criterion — recovered \(H_{\mathrm{ex}}\) agrees with the analytic Laplacian within 25% on the finest mesh and the energy converges to \(A_{\mathrm{ex}} k^2 V\) under refinement.

  • Status — scripted; the representative finest-mesh stage materializes and runs on the managed CPU path, while the full sweep is runtime-open.

Uniformly magnetized sphere

A uniformly magnetized sphere produces the demagnetizing field \(\mathbf{H}_{\mathrm{demag}} = -\frac{M_s}{3} \mathbf{m}\) inside the body. The gate is tests/fem_demag_validation/sphere_validation.py.

  • Criterion — interior \(H_{\mathrm{demag}} \approx -M_s/3\).

  • Status — scripted; requires the MFEM/libCEED/hypre runtime.

Osborn ellipsoid demagnetization factors

For an ellipsoid magnetized uniformly along a principal axis, the demagnetization factors follow Osborn’s closed form. The gate is tests/fem_demag_validation/ellipsoid_validation.py.

  • Criterion — per-axis demagnetization factors agree with Osborn within 10% and sum to 1 within 0.15 per shape.

  • Status — scripted; requires the MFEM/libCEED/hypre runtime.

Macrospin LLG checkpoints

Two damping-only macrospin checks constrain the LLG right-hand side:

  • the damping-only macrospin energy decreases under relaxation (fem_llg_rhs_contract);

  • the directed STT current-perpendicular macrospin torque reproduces the expected precession direction (fem_stt_contract).

Also the contracted Poisson demagnetization sign uses the uniformly magnetized sphere. DMI sign, chirality, boundary-tilt, and thermal variance (Brown scaling with \(1/dt\)) have both local weak residual contract gates and separate MFEM-visible runtime gates.

Evidence boundary

Local contract executables (no MFEM host) are valid source/unit/sign regression gates but are not runtime qualification. A row is qualified only when the executable runtime case passes in the matching MFEM/CUDA environment; the individual solver pages record which acceptance commands they cover.

Control Room crosswalk

Validation pages are inspection-only in Control Room. The UI may expose runtime metadata, fields, tables, or reports for inspection, but it does not create a qualification claim. TODO: frontend support applies to validation workflow authoring and report publication unless a specific control is named. See Control Room capability register.

Python/API crosswalk

Validation is not a standalone Python constructor unless the linked case page names one. Reproduce the exact case, inputs, device, precision, and receipt described by the page; use the referenced API pages for callable signatures.

Physics and bibliography scope

The page either states the governing benchmark model or delegates it to the linked physics/numerical-methods page. Any missing derivation is a documented boundary, not an implicit equation. Bibliography and source evidence remain the authoritative references listed by the validation case.

Source-code index

  • No standalone implementation function is introduced by this validation page. Source evidence is the exact API, managed recipe, runtime manifest, and receipt named by the validation case.