Physics, Couplings, Frozen Spins, Antennas & Transport

Last changes: Documentation changelog

The Control Room splits micromagnetic and spintronic physics authoring into dedicated inspector panels governed by lane capabilities (useActiveLaneCapabilities and interactionSpecsForDiscretization). Every panel shares the PhysicsInspectorOverview header contract (scope.kind, stableRef, and upstream dependency readiness) and enforces optimistic scene_revision concurrency on commit.

Micromagnetic Interactions, Couplings, and Frozen Spins

Frozen Spins inspector configuring constraint frz_edge_pin with In region selection targeting obj_yig_film and reg_pinning_ring
  • Local & Global Interactions (PhysicsInteractionPanel): Edits per-object or study-wide micromagnetic terms—exchange, uniaxial/cubic anisotropy, external Zeeman bias, Dzyaloshinskii–Moriya interactions (bulk, interfacial, D2d), RKKY/surface coupling terms, and stray/demagnetizing toggles—showing active-lane availability and disabled reasons (resolveActiveLaneOperation) when a discretization or solver lane withholds a term.

  • Regional Field Drives (RegionalFieldDrivePanel): Configures spatially localized or masked external field waveforms (sinc, sinusoidal, piecewise_linear) with unit-aware scalar inputs (ps/ns, GHz/Hz, m/nm, rad, mT/T) and live SincPulsePreview plots.

  • Explicit Couplings (CouplingInspectorPanel): Inspects object-pair or region-pair couplings (toggle-enabled, delete) with immediate history-tracked mutations via MODEL_COUPLINGS_RESOURCE_KEY.

  • Frozen Spins Constraints (FrozenSpinsInspectorPanel): Authors FrozenSpinsDefinition policies using SelectionExpressionBuilder predicates, membership and reference-state policies, runtime preview visualization (FrozenSpinsOverlay), and solver activation controls across objects or regions.

RF Antennas and Arbitrary Waveforms

  • Canonical Field-Drive Antennas (AntennaObjectPanel): Configures antenna excitation direction, field amplitude (mT/T), and sinc / sinusoidal waveform parameters (frequency, cutoff, t0, phase, offset), with automatic migration from legacy representations and scene_revision conflict detection/rebase.

  • Conductor, Port & Electromagnetic Solve Authoring (antenna/ Sub-Panels): AntennaCompositionSummaryPanel, AntennaGeometryPanel, AntennaConductorAuthoring, AntennaPortComposer, AntennaFieldSolveAuthoring, AntennaExternalLeadInspectionPanel, and AntennaFieldBasisPreview inspect conductor placement, port excitations, piecewise waveform tables, external lead bindings, and pre-solved antenna magnetic field basis overlays in the 3D viewport.

Solved antenna drive inspector showing Preview t0, Current I(t) [A] waveform plot, CSV/TSV/PNG export controls, and preview sample scrubber

Spin Transport, Spin Torques, Oersted Fields & Spin Interfaces

  • Current & Spin Transport (TransportAuthoringInspector): Authors current_transport and spin_transport scene records (TransportAuthoringInspectorModel), including closure definitions, structured current source cuts, validation requests (transport-authoring-validation.v1), and prescribed density policies where supported by the active lane.

  • Spin-Transfer / Spin–Orbit Torques & Oersted Fields (SpinAuthoringInspector):

    • spin_torque: Supports zhang_li (adiabatic/non-adiabatic \(\beta\)), slonczewski (\(\lambda\) asymmetry, \(\epsilon'\), polarization, free-layer thickness, fixed-layer orientation), and prescribed_sot (\(\xi_{\text{DL}}\), \(\xi_{\text{FL}}\), stack normal), bound either directly to prescribed current density or to an upstream current_transport source.

    • oersted_field: Supports oersted_cylinder and oersted_field (from_current_solution) bound to current transport solutions.

  • Spin Interfaces (SpinInterfaceInspectorPanel): Authors transparent and normal/ferromagnet mixing interfaces across explicit regions. On tetrahedral FEM meshes, verifySpinInterfaceMeshOrientation queries shared tet4 interface facet adjacency and verifies whether the authored interface normal agrees with side \(A \to B\) orientation (reporting shared facet count and physical interface area in \(\text{m}^2\)).

Transport torque inspector displaying st_sot_stack scope, lane, and status cards, Prescribed SOT model, and SOT drive JSON payload

Screenshots illustrate the interface; they are not runtime or physics qualification evidence.

Control Room crosswalk

  • Selection routes: physics (PhysicsInteractionPanel), coupling (CouplingInspectorPanel), field-drive (RegionalFieldDrivePanel), frozen-spins (FrozenSpinsInspectorPanel), antenna (AntennaObjectPanel + antenna/*), current-transport / spin-transport (TransportAuthoringInspector), spin-torque / oersted-field (SpinAuthoringInspector), and spin-interface (SpinInterfaceInspectorPanel).

  • Mutation discipline: All authoring transactions run through runAuthoringMutationWithHistory, support Undo/Redo, and verify active lane capability matrices before enabling writes.

Python/API crosswalk

  • Physics modules, field drives, antennas, frozen spins, current/spin transport, and spin interfaces map directly to their packages/fullmag-py constructors on objects, regions, and Study.

  • Any specialized material field closure or custom solver coefficient without a dedicated inspector form remains TODO: frontend support in Control Room capability register.

Physics and bibliography scope

This page documents UI parameter editors and geometry/mesh verification checks only; solver formulations for exchange, DMI, spin diffusion, Slonczewski/Zhang–Li torques, and magnetostatic Oersted coupling are specified in the physics and numerical-methods sections.

Source-code index

Responsibility

Repository path

Stable symbol

Local/global interaction panel

apps/control-room/src/modules/inspector/panels/PhysicsInteractionPanel.tsx

PhysicsInteractionPanel

Shared physics overview & dependency header

apps/control-room/src/modules/inspector/panels/PhysicsInspectorOverview.tsx

PhysicsInspectorOverview

Regional field drives & sinc preview

apps/control-room/src/modules/inspector/panels/RegionalFieldDrivePanel.tsx

RegionalFieldDrivePanel

Explicit inter-object/region couplings

apps/control-room/src/modules/inspector/panels/CouplingInspectorPanel.tsx

CouplingInspectorPanel

Frozen spins constraints & selection rules

apps/control-room/src/modules/inspector/panels/constraint/FrozenSpinsInspectorPanel.tsx

FrozenSpinsInspectorPanel

Antenna RF & waveform authoring

apps/control-room/src/modules/inspector/panels/AntennaObjectPanel.tsx

AntennaObjectPanel

Current & spin transport closures

apps/control-room/src/modules/inspector/panels/TransportAuthoringInspector.tsx

TransportAuthoringInspector

Spin torque & Oersted inspectors

apps/control-room/src/modules/inspector/panels/SpinAuthoringInspector.tsx

SpinTorqueInspectorPanel, OerstedFieldInspectorPanel

Spin interface & tet4 orientation proof

apps/control-room/src/modules/inspector/panels/SpinInterfaceInspector.tsx

SpinInterfaceInspectorPanel