Airbox geometry and enclosure¶
Last changes: Documentation changelog
Physical problem¶
The FEM airbox is the finite auxiliary domain around magnetic bodies. study.universe(...) authors it; it neither creates a mesh nor selects a demagnetization boundary condition. mode="manual" requires size; mode="auto" retains automatic-universe intent.
Governing equations¶
For manual rectangular input, the authored bounds are:
For mode="auto" with positive per-axis padding, asset_pipeline._study_universe_airbox_options
resolves the aggregate object bounds exactly as
Symbols and SI units¶
Symbol |
Meaning |
SI unit |
|---|---|---|
\(\Omega_a\) |
authored auxiliary airbox domain |
\(\mathrm{m^3}\) |
\(\mathbf{x}\) |
spatial coordinate |
\(\mathrm{m}\) |
\(c_i\) |
center component |
\(\mathrm{m}\) |
\(L_i\) |
size component |
\(\mathrm{m}\) |
\(p_i\) |
authored non-negative padding component |
\(\mathrm{m}\) |
\(x_{i,\min}^{\mathrm{obj}}\) |
minimum aggregate object bound |
\(\mathrm{m}\) |
\(x_{i,\max}^{\mathrm{obj}}\) |
maximum aggregate object bound |
\(\mathrm{m}\) |
Assumptions and validity¶
padding is validated and serialized. With no declared size, the asset pipeline uses the two
auto equations above when at least one padding component is positive; otherwise it returns no
airbox options. A declared size is authoritative in either manual or auto mode and is checked
against aggregate geometry bounds with a scale-aware tolerance. AirboxOptions(shape="sphere")
exists below this API; component-aware and concatenated-STL paths can report a bbox degradation.
Mesh and outer-distance convergence remain separate scientific work.
Solver lane |
Status |
Limit |
|---|---|---|
FEM CPU |
source-backed |
No runtime result is claimed. |
FEM GPU |
capability-gated |
No GPU runtime qualification is claimed. |
FDM CPU |
not applicable |
This is a FEM shared-domain mesh API. |
FDM GPU |
not applicable |
This is a FEM shared-domain mesh API. |
Python API¶
# %%
import fullmag as fm
nm = 1e-9
study = fm.study("manual_airbox")
study.engine("fem")
study.device("cpu", precision="double")
study.mode("strict")
# %%
study.universe(mode="manual", size=(600 * nm, 400 * nm, 200 * nm), center=(0.0, 0.0, 0.0), padding=(0.0, 0.0, 0.0))
study.universe.mesh(maximum_element_size=80 * nm, minimum_element_size=10 * nm)
body = study.geometry(fm.Box(size=(200 * nm, 100 * nm, 10 * nm), name="film"), name="film")
body.mesh(maximum_element_size=8 * nm, minimum_element_size=4 * nm, order=1)
body.Ms = 800e3
body.Aex = 13e-12
body.m = fm.texture.uniform(1.0, 0.0, 0.0)
# %%
study.exchange()
study.demag(model="airbox", variant="robin")
study.build_domain_mesh()
study.stages.add_relax(stage_id="equilibrium", algorithm="llg_overdamped", max_steps=1000)
Python |
Type |
Default |
SI unit |
Validation |
Meaning |
Backend support |
ProblemIR |
|---|---|---|---|---|---|---|---|
|
|
|
\(1\) |
|
universe mode |
FEM authoring/lowering is source-backed; runtime lane requires separate qualification; FDM not applicable |
|
|
|
|
\(\mathrm{m}\) |
three strictly positive components when present |
outer dimensions |
FEM authoring/lowering is source-backed; runtime lane requires separate qualification; FDM not applicable |
|
|
|
|
\(\mathrm{m}\) |
three finite components |
outer-domain center |
FEM authoring/lowering is source-backed; runtime lane requires separate qualification; FDM not applicable |
|
|
|
|
\(\mathrm{m}\) |
three non-negative components |
authored padding |
FEM authoring/lowering is source-backed; runtime lane requires separate qualification; FDM not applicable |
|
ProblemIR¶
StudyUniverseConfig.to_ir writes mode, size, center, padding, airbox_hmax,
airbox_hmin, airbox_growth_rate, and airbox_grading. The table rows map one-to-one to
the first four keys. _study_universe_airbox_options lowers explicit bounds or computes auto
bounds and returns AirboxOptions(size=..., center=...); this resolved mesher input remains
distinct from observed mesh coordinates.
Round-trip and failure semantics¶
Requested intent is StudyUniverseConfig. Resolved execution first includes the explicit
or auto AirboxOptions produced by asset_pipeline, then the shared-domain mesh/report after
study.build_domain_mesh(). Validation errors include invalid mode, non-positive size,
negative padding, manual mode without size, and explicit bounds that do not contain all geometry.
Unsupported combinations include treating the FEM airbox as an FDM grid or assuming a
requested sphere is always realized.
Discrete realization¶
_study_universe_airbox_options owns conversion of authored universe metadata into
AirboxOptions. _rectangular_airbox_bounds_from_options then resolves rectangular min/max
bounds from center and size. build_domain_mesh materializes the shared-domain FEM mesh.
Implementation mapping¶
Responsibility |
Repository path |
Stable symbol |
|---|---|---|
validation and serialization |
||
public authoring facade |
||
universe update lowering |
||
mesh request |
||
explicit/auto bounds and grading lowering |
||
rectangular realized bounds |
||
shape status |
|
Validation¶
Reject invalid authoring inputs, then inspect realized bounds, air elements, markers, boundary facets, and operation statuses. Vary outer distance independently from mesh controls for physics convergence. Runtime and device evidence are not supplied here.
Limitations¶
The padding expansion and bbox center are source-backed, but they do not provide an open-boundary error estimate, Robin coefficient, mesh-convergence receipt, or GPU qualification.
Scientific bibliography¶
C. Geuzaine and J.-F. Remacle, International Journal for Numerical Methods in Engineering 79 (2009), doi:10.1002/nme.2579.
Source-code index¶
Claim |
Repository path |
Stable symbol |
Evidence |
|---|---|---|---|
geometry and IR fields |
source-backed |
||
public authoring facade |
Public |
||
universe update lowering |
Public |
||
auto and explicit bounds lowering |
source-backed |
||
realized rectangular bounds |
source-backed |