Frequency-domain solvers

Last changes: Documentation changelog

This section documents the harmonic driven frequency-response solvers in FullMag. Whereas the modal eigensolvers (Eigensolvers) solve the homogeneous eigenvalue problem for free spin-wave resonances, the frequency-domain response solvers evaluate the forced steady-state complex magnetization response \(\widehat{\mathbf q}(\omega)\), dynamic Polder susceptibility tensor \(\widehat{\boldsymbol\chi}(\omega)\), and cycle-averaged absorbed power density \(p_{\mathrm{abs}}(\omega)\) under a time-harmonic excitation field \(\widehat{\mathbf h}_{\mathrm{ext}}\mathrm e^{-\mathrm i\omega t}\).

Architectural overview

Component

Role in driven response pipeline

Key source files

Python DSL & ProblemIR

Authors FrequencyResponseStageSpec, FrequencyResponseSolverPolicy, SaveResponse, and FloquetBC; lowers to StudyIR::FrequencyResponse.

packages/fullmag-py/src/fullmag/model/study.py, packages/fullmag-py/src/fullmag/model/outputs.py

Planner & Runtime Gate

Validates periodic/Floquet constraint sets (frequency_response_periodic_constraint_sets) and enforces the explicit solver-method runtime gate (frequency_response_solver_method_rejection_reason).

crates/fullmag-plan/src/fem.rs, crates/fullmag-runner/src/frequency_response.rs

Native Shifted Linear Solver

Assembles \(\mathsf A(\omega) = \mathsf K - \mathrm i\omega\mathsf G\), solves \(\mathsf A(\omega)\widehat{\mathbf q} = \widehat{\mathbf b}(\omega)\) across frequency samples, and gates acceptance on the unpreconditioned residual \(\varepsilon_{\mathrm{true}}(\omega)\).

backends/fem/src/frequency_domain/driven_response_solver.cpp, crates/fullmag-runner/src/eigen/response_block_real.rs

Chapters in this section

  • Driven frequency-response solver — harmonic ansatz, shifted tangent system \(\mathsf A(\omega)\widehat{\mathbf q} = \widehat{\mathbf b}\), susceptibility and absorbed power definitions, and true-residual gates.

  • Floquet frequency-domain response — Bloch–Floquet phase prolongation \(C(\mathbf k)\) and 2.5D waveguide shifted-gradient operators for driven response at \(\mathbf k \neq \mathbf 0\).