Appearance
Hazards
This page collects the PRISM inputs that are refused, and the ones that run but behave differently than their key names suggest. Every other PRISM page links here instead of restating these rules. The keys themselves are in the input reference.
Two stop points appear below. Load is the parsing of the INI file. Initialization is the backend set-up after it, before the first step. A few checks fire later, at the first solve that needs them; the tables say so.
Divergence correction
The GLM scalars φ (for [numerics] divergence_correction = hyperbolic. constrained_transport selects which of them are carried. physics sets their slots and the variable names from one branch (#11, #61):
constrained_transport | divergence_correction | Result |
|---|---|---|
no | no | nv = 9 |
D, B, DB | no | constrained transport ignored with a warning, nv = 9 |
D or B | hyperbolic | nv = 10 (φ or ψ in slot 7) |
DB | hyperbolic | nv = 11 (φ in 7, ψ in 8) |
no | hyperbolic | refused at load: there is no scalar to carry |
| any | poisson | refused at load: no backend implements the projection |
PIC models add rho, one more slot, up to NV_MAX = 12 (state vector). The cleaning equations are on the models page.
Seam div(B)
On a uniform grid the centred curl and divergence commute, so
- The source is truncation-order,
: it converges under refinement. - At fixed
it grows without bound in time, independent of . On rmf-amr-fd-pulse(source-free pulse, 1 rank,ni = 16) the seam maxgrows from 6.9 to 1002 in 100 steps; the uniform-grid control stays at 0. stays bounded (−3 % over the same run): this is a constraint violation, not an energy instability. - The same source appears with
fd_centeredandfv_centered, and on octrees and quadtrees.
Five local fixes were ruled out (#29). The resolution is accept-truncation. An upwinded or dissipative GLM coupling at the seams is open as #99; a staggered-
Key ([IO]) | Default | Effect |
|---|---|---|
seam_divB_tol | -1 (off) | When > 0, warn when the global max |
seam_divB_error | .false. | .true. stops the run instead of warning. |
Mitigation. divergence_correction = hyperbolic with constrained_transport = B or DB and a damping rate [physics] alpha > 0 delays the growth. It does not cure it.
Inter-realm seams. A 1:1 inter-realm seam is divergence-free only with coupling_cadence = stage_coincident (β); under α the stages after the first read stale seam ghosts (#31). The cadences are on the numerics page.
PML constraints
| Backend | Accepted | Checked at |
|---|---|---|
| CPU | PML_type CLASSIC, CLASSIC_DIRECT, BERMUDEZ, CFS; scheme_space = fd_centered; scheme_time = runge_kutta with SSP-11/22/33/54; divergence_correction = no (hence no constrained transport) | initialization |
| FNL | the same PML_type kinds; fd_centered; runge_kutta with SSP-11/22/33/54; no hyperbolic correction, no constrained transport | initialization, before any device allocation |
Any other combination is fatal. The [PML] section itself is also checked at load:
width > 0and the six face flags are required; every flag.false.is fatal.- Each
PML_typehas its own required parameters (the[PML]table). A missing one is fatal, not defaulted. An unknownPML_typeis fatal. CLASSIC_DIRECTis not a Runge–Kutta PML. It skips the auxiliary variables and their integration, and damps the tangential components directly. It is a testing instrument, not the production path (absorbing layers).
Elliptic boundary map
The t0 solves (numerics) run on FLAIL's FFT solver with PRISM's own operator fdv_order. Each face kind maps to an elliptic kind (build_elliptic_bc_types), then to a FLAIL face kind (solve_time_zero):
[bc_*] type | Elliptic kind | FLAIL face kind |
|---|---|---|
periodic | periodic | FLAIL_BC_PERIODIC |
Dirichlet | Dirichlet | FLAIL_BC_ZERO_GHOSTS (every ghost layer zero) |
PEC | PEC | FLAIL_BC_DIRICHLET (φ, tangential FLAIL_BC_NEUMANN (normal |
Neumann, Silver_Muller | exact/open | FLAIL_BC_FREE_GHOSTS (the free-space potential of the source in the ghosts, summed over the whole domain) |
extrapolation | — | fatal, at the first t0 solve |
The map is total, but it runs only when a solve first touches the faces. An input with an extrapolation face passes load and initialization, and stops at t0 if a PIC field or a t0 current needs a solve. A null axis takes the periodic kind.
Refused combinations
| Input | Where it stops |
|---|---|
[numerics] scheme_time = leapfrog, blanes_moan, commutator_free_magnus | initialization, both backends (#55) |
[PIC] scheme_time = leapfrog | initialization, both backends |
[numerics] divergence_correction = poisson | load |
divergence_correction = hyperbolic without constrained transport | load |
[bc_*] type = radiative | load (#57) |
[initial_conditions] type = riemann-problem, magnetic_nozzle, rmf_magnetic_nozzle | load (#56) |
[external_fields] external_fields_applied = magnetic_nozzle, rmf_and_magnetic_nozzle | initialization |
[numerics] scheme_space = weno on FNL | initialization, after the device allocation |
runge-kutta-yoshida on FNL | initialization |
| a non-SSP Runge–Kutta scheme with PIC or the PML | initialization |
| a non-SSP Runge–Kutta scheme on the staged path (2:1 faces, forests) | when the forest first queries the stages |
[PIC] current_weighting_model = conserving on the CPU backend with more than one block or one rank | initialization, at the t0 conserving deposit (the first step on a restart) |
[PIC] current_weighting_model = conserving on the staged path (2:1 faces, forests) | the first staged step, both backends |
[PIC] current_weighting_model = conserving with periodic faces and current_conserving_solver = londrillo or esirkepov_tail_cleanup = .true. | initialization, both backends (PIC) |
| a refined grid that enters a t0 elliptic solve | the solve (#84 E7: the wide operator across 2:1 faces is not defined) |
fdv_order = 10 with a t0 elliptic solve | the solve (FLAIL accepts 2, 4, 6, 8) |
an extrapolation face with a t0 elliptic solve | the solve (above) |
Every refusal prints a message naming the combination. src/tests/prism/regression/refusals.sh keeps them refused, one leg per refusal (cookbook).