Appearance
Inter-realm 2:1 seam
| Cases | Issues | Type | Backends | Figure | Regression |
|---|---|---|---|---|---|
rmf-2realm-fd-pulse-refined | #52 | C | CPU, FNL | no | — |
Case and scope
rmf-amr-fd-pulse (seam div(B)) split at its 2:1 face coupling = refined. The union of the realms is the single-realm cell set. The inter-realm 2:1 seam reuses the intra-realm 2:1 formulas (coarse→fine ghost interpolation, the fine→coarse
What the case catches:
- any difference between the inter-realm and the intra-realm 2:1 seam operators;
- a seam
monitor blind to inter-realm seams; - a collective ghost update that hangs or misbehaves on an empty rank: at 2 ranks one rank holds no block of one realm.
Models and numerics
| Item | Choice | Code |
|---|---|---|
| Equations | Maxwell, SI, no source | models |
| Space | centred finite differences of order 6 | adam_fdv_operators_library.F90 |
| Time | SSP Runge–Kutta (5,4), CFL 0.5, β cadence | adam_rk_object.F90 |
| Seam | coupling = refined: the intra-realm 2:1 interpolation, restriction and register across the realm boundary | fill_seam_from_peer_forest, adam_prism_cpu_object.F90; adam_seam_exchange.F90; adam_seam_interpolation_library.F90 |
| Monitor | [IO] seam_divB_tol, warn-only | save_divergence_history, adam_prism_common_object.F90; hazards |
Initial and boundary conditions
| Item | Fine realm | Coarse realm | Single realm (reference) |
|---|---|---|---|
| Extent | |||
| Grid | 64 blocks of iu_ref_levels = 2), | 8 blocks of iu_ref_levels = 1), | rmf-amr-fd-pulse: |
| Cells | 131072 | 16384 | 147456 |
Common: Gaussian pulse along sigma = 0.01, B0 = 10; Neumann outer faces; 5 steps; 2 ranks (--np N), so every seam row crosses ranks. The script arms the monitor with seam_divB_tol = 1 in both realms.
Input files
| File | Role |
|---|---|
src/tests/prism/regression/rmf-2realm-fd-pulse-refined/input.ini, realm_{1,2}.ini | the manifest and the realms |
src/tests/prism/regression/rmf-amr-fd-pulse/input.ini | the single-realm reference |
src/tests/prism/regression/rmf-2realm-fd-pulse-refined/check.sh | runs both and compares (--build, --np N; PRISM_EXE) |
src/tests/flume/verification/multirealm/multirealm_oracle.py | the union of the realms against the single realm, --tol 0 |
bash
cd src/tests/prism/regression/rmf-2realm-fd-pulse-refined && ./check.sh
PRISM_EXE=$PWD/../../../../../exe/adam_prism_fnl ./check.sh # FNLResults
| Leg | Asserts | Bound | CPU | FNL |
|---|---|---|---|---|
| health | both runs reach 100 % with no error/abort/NaN | — | pass | pass |
| fields | every checkpoint field (div_*, res_*) of the union equals the single realm on every cell | bitwise | 147456 cells, 27 fields | 147456 cells, 27 fields |
| divergence histories | at every step the single-realm max | printed digits | pass | pass |
| seam max | reported | — | 6.86 → 12.65 | 6.86 → 12.65 |
| monitor | WARNING: seam div(B) ... exceeds [IO].seam_divB_tol in the split's log | fires | 15 warnings | 15 warnings |
Related pages: seam div(B) for the single-realm source; inter-realm 1:1 seams.
Findings
- The split equals the single realm bit for bit on every field, on both backends: an inter-realm 2:1 seam is an intra-realm 2:1 seam across a realm boundary.
- The split carries the single-realm seam source exactly. The coarse realm holds the maximum at steps 1–2, the fine realm at steps 3–5.
- The seam
monitor covers inter-realm 2:1 seams.