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¶
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 liveSincPulsePreviewplots.Explicit Couplings (
CouplingInspectorPanel): Inspects object-pair or region-pair couplings (toggle-enabled,delete) with immediate history-tracked mutations viaMODEL_COUPLINGS_RESOURCE_KEY.Frozen Spins Constraints (
FrozenSpinsInspectorPanel): AuthorsFrozenSpinsDefinitionpolicies usingSelectionExpressionBuilderpredicates, 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), andsinc/sinusoidalwaveform parameters (frequency,cutoff,t0,phase,offset), with automatic migration from legacy representations andscene_revisionconflict detection/rebase.Conductor, Port & Electromagnetic Solve Authoring (
antenna/Sub-Panels):AntennaCompositionSummaryPanel,AntennaGeometryPanel,AntennaConductorAuthoring,AntennaPortComposer,AntennaFieldSolveAuthoring,AntennaExternalLeadInspectionPanel, andAntennaFieldBasisPreviewinspect conductor placement, port excitations, piecewise waveform tables, external lead bindings, and pre-solved antenna magnetic field basis overlays in the 3D viewport.
Spin Transport, Spin Torques, Oersted Fields & Spin Interfaces¶
Current & Spin Transport (
TransportAuthoringInspector): Authorscurrent_transportandspin_transportscene 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: Supportszhang_li(adiabatic/non-adiabatic \(\beta\)),slonczewski(\(\lambda\) asymmetry, \(\epsilon'\), polarization, free-layer thickness, fixed-layer orientation), andprescribed_sot(\(\xi_{\text{DL}}\), \(\xi_{\text{FL}}\), stack normal), bound either directly to prescribed current density or to an upstreamcurrent_transportsource.oersted_field: Supportsoersted_cylinderandoersted_field(from_current_solution) bound to current transport solutions.
Spin Interfaces (
SpinInterfaceInspectorPanel): Authorstransparentand normal/ferromagnet mixing interfaces across explicit regions. On tetrahedral FEM meshes,verifySpinInterfaceMeshOrientationqueries sharedtet4interface 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\)).
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), andspin-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-pyconstructors on objects, regions, andStudy.Any specialized material field closure or custom solver coefficient without a dedicated inspector form remains
TODO: frontend supportin 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 |
|
|
Shared physics overview & dependency header |
|
|
Regional field drives & sinc preview |
|
|
Explicit inter-object/region couplings |
|
|
Frozen spins constraints & selection rules |
|
|
Antenna RF & waveform authoring |
|
|
Current & spin transport closures |
|
|
Spin torque & Oersted inspectors |
|
|
Spin interface & tet4 orientation proof |
|
|