Designs and solvers¶
Lumped-element detectors and cavity haloscopes search for axion dark matter. In this guide we describe axionMultiPhysics designs and solvers.
A design is a JSON document describing geometry, materials, magnet windings,
readout and mesh settings in SI units. Numeric fields accept expressions over
named parameters; later regions replace earlier ones where they overlap,
and unassigned space is air.
Design file¶
We write, load and solve a complete JSON design, toroid.json, for a toroidal
magnet with a superconducting pickup sheath to obtain coupling and inductance.
import axionmultiphysics as axmp
axmp.template("toroid", R=2.0, H=2.0).save("toroid.json")
design = axmp.load("toroid.json")
print(design.validate())
result = design.solve("runs/toroid")
print(result.Psi, result.L_p)
Validation reports ok: True and evaluated parameters, or identifies an invalid
field. The solve returns coupling in \(\mathrm{H\,T\,m^2}\) and inductance in
henries; we check mesh refinement and residuals before using them.
| Top-level keys | Purpose |
|---|---|
schema, name, symmetry |
Format, name and geometry dimension |
parameters |
Named numbers and expressions |
regions, curves, materials |
Volumes, sheets and material properties |
windings, circuits, background |
Static-field sources |
superconductors, pickup |
Constraints and readout |
mesh |
Element sizes and order |
fullwave, cavity |
Driven frequency sweeps or cavity modes |
scan, benchmarks, cost |
Sensitivity assumptions and cost metric |
Field models¶
axionMultiPhysics's magnetoquasistatic (MQS) solver neglects displacement current and is appropriate when the detector is small compared with the signal wavelength. Its full-wave solver retains displacement current to resolve radiation, resonances and frequency-dependent coupling. With time dependence \(e^{-i\omega t}\),
Here \(\omega\) is angular frequency, \(\mathbf E_I\) is the field driven by pickup current \(I\), \(\mathbf B_{\rm lab}\) is the static field and \(Z\) is terminal impedance. Both quantities approach their MQS values at low frequency; negative inductance indicates a capacitive response.
We add "fullwave": {"frequencies": [1e5, 1e6, 1e7], "boundary": "radiation"}
for a sweep in hertz; pec instead closes the domain with a perfect conductor.
Each result.fullwave["sweep"] row reports f_Hz, Psi_abs and L_H.
Both models default to "symmetry": "axisymmetric", for rotationally symmetric
geometry and excitation. We set "symmetry": "3d" for slits or localized feeds;
this requires an MPI-enabled installation. Axisymmetric feeds are
distributed uniformly around the axis. Eigenmode calculations are described in
Cavity haloscopes.
Tree-cotree solve¶
The tree-cotree solve is beta.
At low frequency, separating gradient fields from magnetic-flux-carrying fields
avoids cancellation in the 3D full-wave matrix. We set AXMP_FW_SOLVER=strumpack
and AXMP_FW_GAUGE=tree-cotree; this requires STRUMPACK, first-order Nédélec
elements, real lossless materials and PEC on every boundary. We assess
split_true_relative_residual; the factorization occupies one MPI rank.
Multiport circuits and components¶
axionmultiphysics.multiport.MultiportCircuit connects the detector impedance matrix to
external loads, preserving the relative phases of axion-induced voltages.
axionmultiphysics.multiport_components.LosslessTransmissionLine adds propagation delay
and stored energy for distributed connections. We include only components absent
from the FEM model, and supply reciprocal, passive impedances.
We orient circuit branches along each gap's current profile; circuit current is
opposite the current entering the FEM device.
3D ports and magnetic sources¶
Each gap in fullwave.ports touches two conducting terminal patches; toward
sets its current direction, while the primary pickup needs a conducting return
through one body. Each sweep row contains Z_matrix_re_ohm, Z_matrix_im_ohm
and coherent Psi_vector: the pickup comes first, matrix rows are measured
ports and columns are driven ports. fullwave.source supplies an independent
static field for the axion overlap (beta, below).
Prescribed static source¶
The prescribed static source is beta.
For example, we add "boundary": "pec", "source": {"kind": "uniform", "B_T": [0, 1, 0]}
inside fullwave for a \(1\,\mathrm T\) field along the global \(y\) axis.
This replaces only the RF overlap field, leaving MQS energies and forces
unchanged; it does not compute screening. With radiation boundaries, we use
closed current segments inside the domain and check source quadrature as well
as RF mesh convergence.