Geometry, Materials, Regions & Magnetic Textures¶
Last changes: Documentation changelog
Domain entity panels edit scene objects, magnetic material properties, absorbing boundaries,
sub-object regions, and initial magnetization textures using isolated drafts and unit-aware SI
inputs (QuantityField and Vector3Field supporting m, mm, um/µm, and nm).
Geometry, Transform, and CSG Scope (GeometryObjectPanel, ObjectPlacementPanel)¶
GeometryObjectPanel (apps/control-room/src/modules/inspector/panels/GeometryObjectPanel.tsx)
and ObjectPlacementPanel handle primitive shape parameters (box, cylinder, sphere,
microstrip, cpw, thin_film, and read-only inspection of script-created geometries such as CSG
composites), rigid translation (translation, also interactively via Ribbon Move W), metadata
(name, notes, ObjectGeneralPanel), and unit conversions via quantityDraftFields.
Rigid rotation & scale policy: Rigid
rotationandscalecontrols stay disabled in the UI (PROBLEM_IR_03_RIGID_TRANSFORM_REASON); interactive Boolean CSG builder commands on the Ribbon are currently gated behindpreview: trueand stripped from the active toolbar, so multi-body CSG operations remainTODO: frontend supportand should be authored in Python.Optimistic revision reconciliation: If a live Python script modifies an unrelated object while a Geometry draft is open,
reconcileObjectEditAck/reconcileObjectIdentityAckpreserves unconflicted local edits or presents explicit rebase controls.
Materials, Absorbing Boundaries, and Regions (ObjectMaterialPanel, ObjectRegionsPanel)¶
Materials (
ObjectMaterialPanel,ObjectAbsorbingBoundaryPanel): Edits scalar magnetic parameters (\(M_{\text{sat}}\), exchange stiffness \(A_{\text{ex}}\), Gilbert damping \(\alpha\), uniaxial anisotropy \(K_{u1}\) and easy axis), creates or assigns library/session materials (createMaterialThenAssign), and configuresObjectAbsorbingBoundaryPaneldamping ramps on outer boundary faces (faces,frame,profile).Spatial Regions (
ObjectRegionsPanel,RegionsListPanel): Organizes sub-panels underinspector/panels/region/(ObjectRegionOverviewPanel,ObjectRegionGeometryPanel,ObjectRegionMagneticParametersPanel,ObjectRegionMeshPanel,ObjectRegionTexturePanel,ObjectRegionVisualizationPanel,ObjectRegionDiagnosticsPanel, andObjectRegionNestedRegionsPanel). Raw SI entries are staged in aQuantityFieldDraftScopeand validated against owning object bounds (clampObjectRegionDraftShapeToOwnerBounds) before commit.
Magnetic Textures (ObjectMagneticTexturePanel)¶
ObjectMagneticTexturePanel (apps/control-room/src/modules/inspector/panels/ObjectMagneticTexturePanel.tsx)
writes initial magnetization assignments and presets targeting either an entire object or a specific
spatial region. MAGNETIZATION_TEXTURE_PRESETS (texturePresets.ts) exposes sixteen current preset
builders (plus legacy random_seeded compatibility):
Uniform & stochastic:
uniform,random(Random seeded);Vortex & skyrmion textures:
vortex,antivortex,bloch_skyrmion,neel_skyrmion,antiskyrmion,skyrmionium,bimeron;Domain walls & modulations:
domain_wall(normal_axis,center_offset,width,kind,left,right),two_domain,vortex_wall,helical,conical;3D topological textures:
hopfion(radius,hopf_charge,background_sign,axial_scale,phase_rad) andhopfion_compact_support(major_radius,minor_radius).
Each preset accepts explicit coordinate-mapping transforms (mappingSpace, mappingProjection,
pivot, translation, rotationDeg, scale, clampMode) and triggers targeted 3D field
invalidation (returnToCurrentFieldView) once commitMagneticTextureApply completes.
Screenshots illustrate the interface; they are not runtime or physics qualification evidence.
Control Room crosswalk¶
Selection routes:
object/object.geometry/object.general/object.placement(GeometryObjectPanel,ObjectGeneralPanel,ObjectPlacementPanel),object.material/material(ObjectMaterialPanel),object.region/region(ObjectRegionsPanel,RegionsListPanel), andobject.magnetization(ObjectMagneticTexturePanel).Transaction boundary: Changes stay staged in local draft stores until Apply commits with
runAuthoringMutationWithHistory.Gated items: Boolean CSG authoring, rigid
Rotate/Scaleauthoring, and arbitrary spatially varying functional expressions remainTODO: frontend supportin Control Room capability register.
Python/API crosswalk¶
Geometry primitives, CSG compositions, materials, absorbing boundary frames, region overrides, and initial magnetization fields are constructed in
packages/fullmag-pyand preserved verbatim during livefm.connectsessions.Script export preserves authored region IDs and material assignments without mutating backend representations.
Physics and bibliography scope¶
This page documents UI property editors, unit formatting, and revision concurrency; material constitutive laws and magnetization texture definitions belong to the physics documentation.
Source-code index¶
Responsibility |
Repository path |
Stable symbol |
|---|---|---|
Geometry, placement & conflict rebase |
|
|
Scalar material & anisotropy authoring |
|
|
Absorbing boundary layer configuration |
|
|
Object-owned regions & nested overrides |
|
|
Initial magnetization texture & transform editor |
|
|
Canonical preset catalog |
|
|