Skip to content

axionMultiPhysics

axionMultiPhysics is a finite-element package for electromagnetics, structural mechanics, heat conduction, fluid flow and electrochemistry, with a Python interface, a command line and an interactive field viewer. We built it to design axion dark-matter experiments, which include lumped-element detectors, cavity haloscopes and SRF heterodyne cavities, and it has dedicated tools for them. The solvers themselves are general. Axisymmetric geometries are drawn from polygons, arcs and boolean combinations; 3D geometries from primitives, revolved or extruded profiles and imported CAD (STEP) solids. The same code applies to magnets, superconducting devices, RF structures and resonators in other settings.

What it solves

  • Magnetostatics and magnetoquasistatics: superconducting, resistive and iron-core magnets and shields; fields, inductances and forces, with exact open boundaries.
  • Full-wave electromagnetics: impedances and S-parameters (Touchstone export), radiation losses, eigenmodes and self-resonances.
  • Superconductors: ideal superconductors with flux or current constraints, critical surfaces of NbTi, Nb₃Sn and REBCO, and the HTS critical state.
  • Electrostatics: capacitance matrices.
  • Circuits: networks with the noise of every element, and multiport networks from field solutions.
  • Mechanics and heat: stresses from Lorentz forces and cooldown, and steady heat conduction with a temperature-dependent conductivity.
  • Shape sensitivities and optimization: adjoint gradients, with local, global and derivative-free optimizers.
  • Fluids (beta): Stokes and Navier–Stokes flow, steady and transient, inductionless MHD, and heat transport with natural convection.
  • Electrochemistry (beta): stiff chemical kinetics, reactors, and current distributions in electrolytes.
  • Model documents (beta): one physics-based input format for fluids, heat, electrochemistry and coupled physics, with a physics catalogue, validation, axmp explain, axmp patch and a JSON Schema; planar and axisymmetric documents are meshed with named boundaries, and the meshes can be handed to the fluids and chemistry engines. Solving a model document is not available yet.
  • Export to Geant4 and particle transport (beta): field maps of solved designs, solids and GDML of axisymmetric and 3D designs, and particle transport in axmp-transport, a separate Geant4 program built on request, through the solids and the field map of a design.

Axisymmetric problems run on one machine; 3D problems use MPI.

Walkthroughs

Installation · Quick start · API reference

Citing axionMultiPhysics, contact and issues: About

Toroidal detector in the axionMultiPhysics viewer

Pickup field in a toroidal detector.

Overlap density of the pump and signal modes in an SRF cavity Overlap density of the pump and signal modes in an SRF cavity Von Mises stress in a solenoid winding under its own Lorentz force Von Mises stress in a solenoid winding under its own Lorentz force

Left: overlap of the pump and signal fields in an SRF heterodyne cavity (beta). Right: von Mises stress in a solenoid winding under its own Lorentz force.

Natural convection in a differentially heated square cavity Natural convection in a differentially heated square cavity Primary current distribution on a disk electrode Primary current distribution on a disk electrode

Left: natural convection in a heated square cavity at Ra = 10⁵, temperature and streamlines (beta). Right: primary current distribution on a disk electrode (beta).

Contributors: Joshua N. Benabou, Joshua W. Foster, Benjamin R. Safdi.