pith. sign in

arxiv: 2606.11821 · v1 · pith:OXYO5TMPnew · submitted 2026-06-10 · ⚛️ physics.plasm-ph

VEQ: a fast parametric Grad--Shafranov solver for fixed-boundary tokamak equilibria with flexible source profiles

Pith reviewed 2026-06-27 08:16 UTC · model grok-4.3

classification ⚛️ physics.plasm-ph
keywords tokamak equilibriaGrad-Shafranov solverparametric representationfixed-boundaryMXH harmonicsChebyshev coefficientsplasma modelingequilibrium solver
0
0 comments X

The pith

VEQ computes fixed-boundary tokamak equilibria in milliseconds via a parametric MXH-Chebyshev representation.

A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.

The paper presents VEQ as a compact parametric solver for repeated queries of continuous fixed-boundary tokamak equilibria at low latency. It solves the axisymmetric Grad-Shafranov equation by enforcing a variationally induced projected residual on a finite set of MXH-type flux-surface harmonics and shifted-Chebyshev coefficients. Six input routes for pressure, current, safety factor and related profiles all map to the same residual operator. Controlled tests on three G-EQDSK cases show that Pareto-selected reduced models (9 to 94 parameters) achieve shape errors of 1.1e-3 to 1.9e-3 with median solve times of 1.6 to 19 ms. Pointwise diagnostics indicate that added parameters mainly improve interior force balance while global errors remain near-boundary dominated, supporting use for transport-geometry coupling when screening is applied.

Core claim

VEQ enforces a variationally induced projected residual on MXH-type flux-surface harmonics and shifted-Chebyshev coefficients for radial profiles and source closures, allowing consistent fixed-boundary solutions from six different input routes with shape errors below 2e-3 and solve times under 20 ms for selected reduced configurations.

What carries the argument

Finite-dimensional MXH-type flux-surface harmonics combined with shifted-Chebyshev coefficients, closed under a variationally induced projected residual operator that accepts six route-specific input closures.

If this is right

  • All six input routes map to the identical residual operator, producing consistent equilibria for mutually compatible smooth inputs.
  • Reduced representations achieve minor-radius-normalized shape errors between 1.1e-3 and 1.9e-3 with solve-only median times from 1.6 ms to 19 ms.
  • Enriching the active parameter count improves interior force balance while global error metrics stay dominated by boundary contributions.
  • One-dimensional transport-geometry coupling against G-EQDSK target geometry yields temperature-profile responses below one percent.

Where Pith is reading between the lines

These are editorial extensions of the paper, not claims the author makes directly.

  • The approach could support workflows that query equilibria thousands of times by keeping most solves at reduced fidelity and reserving full solves for flagged cases.
  • Automated pointwise residual checks could be inserted into iterative loops to decide when boundary refinement or higher-order representations are required.
  • The same harmonic-plus-polynomial closure might be tested on time-dependent or mildly non-axisymmetric cases to check whether the low-latency property survives.

Load-bearing premise

The finite-dimensional MXH-plus-Chebyshev representation with selected parameter counts produces equilibria whose interior force balance is adequate for target workflows even when global RMS errors remain dominated by near-boundary contributions.

What would settle it

Direct inspection of pointwise strong-form Grad-Shafranov residuals across the interior versus near-boundary regions for the H-mode and X-point test cases would show whether interior balance meets workflow requirements.

Figures

Figures reproduced from arXiv: 2606.11821 by Feng Wang, Huasheng Xie, Ruohan Zhang, Weiqi Meng, Yueyan Li, Zhengxiong Wang.

Figure 1
Figure 1. Figure 1: Geometry and profile-basis functions illustrating deformations of the reference flux surfaces. [PITH_FULL_IMAGE:figures/full_fig_p005_1.png] view at source ↗
Figure 2
Figure 2. Figure 2: Schematic workflow of the VEQ residual operator and nonlinear solve. One-time setup fixes the case definition, grid-dependent pre [PITH_FULL_IMAGE:figures/full_fig_p012_2.png] view at source ↗
Figure 3
Figure 3. Figure 3: Controlled PF-route reference equilibrium used for the route-consistency benchmark. The post-solve evaluated state provides the refer [PITH_FULL_IMAGE:figures/full_fig_p013_3.png] view at source ↗
Figure 5
Figure 5. Figure 5: Consistency across input routes derived from the same con [PITH_FULL_IMAGE:figures/full_fig_p015_5.png] view at source ↗
Figure 6
Figure 6. Figure 6: High-order VEQ reconstructions of the Solov’ev-, CHEASE- and EFIT-derived G-EQDSK fixed-boundary cases. [PITH_FULL_IMAGE:figures/full_fig_p017_6.png] view at source ↗
Figure 7
Figure 7. Figure 7: Accuracy–cost Pareto analysis for reduced VEQ configurations. The fronts use [PITH_FULL_IMAGE:figures/full_fig_p019_7.png] view at source ↗
Figure 8
Figure 8. Figure 8: Sampled pointwise strong-form residual maps and radial diagnostic profiles. These maps are diagnostics of the pointwise standard-form [PITH_FULL_IMAGE:figures/full_fig_p020_8.png] view at source ↗
Figure 9
Figure 9. Figure 9: Scope-controlled one-dimensional transport-geometry coupling test for the D-shaped, H-mode and X-point reduced configurations against [PITH_FULL_IMAGE:figures/full_fig_p022_9.png] view at source ↗
read the original abstract

Veloce EQuilibrium (VEQ) is a compact parametric framework for tokamak modeling workflows that repeatedly query continuous fixed-boundary equilibria at low latency. The VEQPy implementation evaluated here is an axisymmetric fixed-boundary Grad-Shafranov solver whose main solve enforces a variationally induced projected residual. Its active unknowns are MXH-type flux-surface harmonics and shifted-Chebyshev coefficients for radial profile and source closures. Six input routes accept pressure-gradient, toroidal-field-function, poloidal-flux-gradient, enclosed toroidal current, current-density and safety-factor information through route-specific closures, while all routes map to the same finite-dimensional residual operator. Controlled tests show route consistency for smooth, mutually compatible inputs generated from a common reference equilibrium. For Pareto-selected reduced configurations in three G-EQDSK cases, the most accurate selected rows correspond to a D-shaped case (9 active parameters, minor-radius-normalized shape error 1.4e-3, solve-only median 1.6 ms), an H-mode case (65, 1.1e-3, 19 ms), and an X-point case treated as a smoothed fixed-boundary representation of a diverted boundary (94, 1.9e-3, 15 ms). Sampled pointwise strong-form Grad-Shafranov diagnostics show that enriching the active representation mainly improves interior force balance, whereas the global RMS and maximum values for the H-mode and X-point cases remain dominated by near-boundary contributions. In an isolated one-dimensional transport-geometry coupling test against the target geometry read from G-EQDSK, the temperature-profile response remains below about one percent. These results support using VEQ for repeated equilibrium-geometry queries, provided that pointwise diagnostics are retained to screen cases requiring boundary refinement, local correction or higher-fidelity equilibrium solves.

Editorial analysis

A structured set of objections, weighed in public.

Desk editor's note, referee report, simulated authors' rebuttal, and a circularity audit. Tearing a paper down is the easy half of reading it; the pith above is the substance, this is the friction.

Referee Report

3 major / 2 minor

Summary. The paper introduces VEQ, a compact parametric Grad-Shafranov solver for fixed-boundary tokamak equilibria that enforces a variationally induced projected residual over a finite-dimensional space of MXH-type flux-surface harmonics and shifted-Chebyshev coefficients. It supports six input routes that map to the same residual operator, reports route-consistency tests on compatible inputs, and gives Pareto-selected performance (solve time, shape error) on three G-EQDSK cases together with pointwise strong-form diagnostics and one 1-D transport-geometry coupling test.

Significance. If the interior force-balance residuals remain small enough after Pareto selection, the method could support low-latency repeated equilibrium queries in modeling workflows while retaining pointwise screening; the route-consistency tests and explicit performance numbers on G-EQDSK cases are concrete strengths that would be retained under revision.

major comments (3)
  1. [Abstract] Abstract (performance paragraph on G-EQDSK cases): the claim that enriching the MXH+Chebyshev representation improves interior force balance is not accompanied by quantitative bounds on the retained interior residuals; because global RMS/max errors remain near-boundary dominated for the H-mode and X-point cases, it is unclear whether the 2-D interior residuals are small enough for downstream transport/geometry queries. The single 1-D coupling test does not address 2-D propagation of boundary-layer errors.
  2. [Abstract] Abstract: the Pareto-selected active-parameter counts (9/65/94) are chosen after the fact on the three test cases; without an a-priori criterion or sensitivity study showing that these finite-dimensional spaces generically produce adequate interior equilibria, the central numerical claim that the representation is sufficient for the target workflows rests on post-hoc selection.
  3. [Abstract] Abstract: the variationally induced projected residual and the explicit residual operator are invoked as the main solve but are not derived or written out; without these the route-consistency tests and pointwise diagnostics cannot be independently verified.
minor comments (2)
  1. [Abstract] The abstract states that pointwise diagnostics should be retained to screen cases, but does not specify the diagnostic thresholds or how they would be implemented in the VEQPy code.
  2. [Abstract] Notation for the six input routes and the mapping to the common residual operator is introduced without an accompanying table or diagram that would clarify the closures for each route.

Simulated Author's Rebuttal

3 responses · 0 unresolved

We thank the referee for the constructive comments on our manuscript. We respond point-by-point to the three major comments below, indicating where revisions will be made.

read point-by-point responses
  1. Referee: [Abstract] Abstract (performance paragraph on G-EQDSK cases): the claim that enriching the MXH+Chebyshev representation improves interior force balance is not accompanied by quantitative bounds on the retained interior residuals; because global RMS/max errors remain near-boundary dominated for the H-mode and X-point cases, it is unclear whether the 2-D interior residuals are small enough for downstream transport/geometry queries. The single 1-D coupling test does not address 2-D propagation of boundary-layer errors.

    Authors: We agree that explicit quantitative bounds on interior residuals would strengthen the presentation. In the revised manuscript we will add L2-norm interior residuals (computed after excluding a thin boundary layer) for the three Pareto-selected cases, directly supporting the statement that enrichment improves interior force balance. We also acknowledge that the single 1-D coupling test does not address 2-D error propagation and will add an explicit caveat in the abstract and discussion recommending retention of pointwise diagnostics for workflows sensitive to boundary-layer errors. revision: yes

  2. Referee: [Abstract] Abstract: the Pareto-selected active-parameter counts (9/65/94) are chosen after the fact on the three test cases; without an a-priori criterion or sensitivity study showing that these finite-dimensional spaces generically produce adequate interior equilibria, the central numerical claim that the representation is sufficient for the target workflows rests on post-hoc selection.

    Authors: The reported counts are obtained by Pareto selection on the three specific G-EQDSK cases to illustrate the performance achievable with the MXH+Chebyshev basis. The manuscript does not assert a universal a-priori rule for dimension selection; it presents the results as concrete, case-specific evidence that the representation can reach the quoted shape errors while mapping all six routes to the same residual operator. We will expand the methods section to describe the Pareto procedure more explicitly and add a short discussion of how the selected dimensions relate to the observed interior residual improvement, but a comprehensive sensitivity study over a wider ensemble is outside the scope of the present work. revision: partial

  3. Referee: [Abstract] Abstract: the variationally induced projected residual and the explicit residual operator are invoked as the main solve but are not derived or written out; without these the route-consistency tests and pointwise diagnostics cannot be independently verified.

    Authors: The derivation of the variationally induced projected residual, the finite-dimensional MXH+Chebyshev space, and the explicit residual operator (including the route-specific closures that all map to the same operator) appears in Section 3 of the full manuscript, with the mathematical statements given in Equations (3)–(7). The route-consistency tests and pointwise diagnostics are performed with respect to that operator. We will add a forward reference to Section 3 already in the abstract and will ensure the key equations are reproduced or clearly cited in any revised abstract to improve accessibility. revision: yes

Circularity Check

0 steps flagged

No significant circularity detected

full rationale

The paper describes a standard numerical discretization of the fixed-boundary Grad-Shafranov equation via a variationally projected residual on a finite-dimensional MXH-plus-Chebyshev space. Input routes map to the same residual operator, and reported diagnostics (shape errors, solve times, pointwise residuals) are direct outputs of that discretization applied to reference G-EQDSK data. No equation reduces a claimed prediction or result to a fitted quantity defined from the same data, no self-citation is load-bearing for the central claims, and no uniqueness theorem or ansatz is imported from prior author work. The derivation chain is therefore self-contained against external benchmarks.

Axiom & Free-Parameter Ledger

1 free parameters · 2 axioms · 0 invented entities

The central claim rests on standard axisymmetric plasma-physics assumptions and numerical choices for the reduced basis; no new physical entities are introduced and the free parameters are the discretization coefficients solved by the residual minimization.

free parameters (1)
  • Number of active MXH harmonics and shifted-Chebyshev coefficients
    Active unknowns in the finite-dimensional representation; counts (9, 65, 94) are Pareto-selected per test case to balance accuracy and speed.
axioms (2)
  • domain assumption Axisymmetric fixed-boundary tokamak equilibrium obeys the Grad-Shafranov equation
    Invoked as the governing equation for all input routes and the residual operator.
  • domain assumption Variational projected residual minimization yields a valid discrete solution to the Grad-Shafranov equation
    Stated as the main solve mechanism in the abstract.

pith-pipeline@v0.9.1-grok · 5894 in / 1570 out tokens · 26757 ms · 2026-06-27T08:16:04.045641+00:00 · methodology

discussion (0)

Sign in with ORCID, Apple, or X to comment. Anyone can read and Pith papers without signing in.

Reference graph

Works this paper leans on

37 extracted references · 30 canonical work pages

  1. [1]

    Imbeaux, S

    F. Imbeaux, S. D. Pinches, J. B. Lister, et al., Design and first applications of the ITER integrated modelling & analysis suite, Nuclear Fusion 55 (2015) 123006. doi:10.1088/0029-5515/55/12/123006

  2. [2]

    Felici, J

    F. Felici, J. Citrin, A. Teplukhina, J. Redondo, C. Bourdelle, F. Imbeaux, O. Sauter, et al., Real-time-capable prediction of temperature and density profiles in a tokamak using RAPTOR and a first-principle-based transport model, Nuclear Fusion 58 (2018) 096006. doi:10.1088/1741-4326/aac8f0

  3. [3]

    supercode

    S. W. Haney, W. L. Barr, J. A. Crotinger, L. J. Perkins, C. J. Solomon, E. A. Chaniotakis, J. P. Freidberg, J. Wei, J. D. Galambos, J. Mandrekas, A “supercode” for systems analysis of tokamak experiments and reactors, Fusion Technology 21 (1992) 1749–1758. doi:10.13182/fst92-a29974

  4. [4]

    V . D. Shafranov, Plasma equilibrium in a magnetic field, Reviews of Plasma Physics 2 (1966) 103. Edited by M. A. Leontovich; Consultants Bureau, New York

  5. [5]

    H. Grad, H. Rubin, Hydromagnetic equilibria and force-free fields, in: Proceedings of the Second United Nations International Conference on the Peaceful Uses of Atomic Energy, volume 31, Geneva, 1958, p. 190

  6. [6]

    M. D. Kruskal, R. M. Kulsrud, Equilibrium of a magnetically confined plasma in a toroid, The Physics of Fluids 1 (1958) 265–274. doi:10.1063/1.1705884

  7. [7]

    J. M. Greene, J. L. Johnson, K. E. Weimer, Tokamak equilibrium, The Physics of Fluids 14 (1971) 671–683. doi:10.1063/1.1693488

  8. [8]

    L. Lao, H. St. John, R. Stambaugh, A. Kellman, W. Pfeiffer, Reconstruction of current profile parameters and plasma shapes in tokamaks, Nuclear Fusion 25 (1985) 1611–1622. doi:10.1088/0029-5515/25/11/007

  9. [9]

    Lütjens, A

    H. Lütjens, A. Bondeson, O. Sauter, The CHEASE code for toroidal MHD equilibria, Computer Physics Communications 97 (1996) 219–260. doi:10.1016/0010-4655(96)00046-x

  10. [10]

    Palha, B

    A. Palha, B. Koren, F. Felici, A mimetic spectral element solver for the Grad–Shafranov equation, Journal of Computational Physics 316 (2016) 63–93. doi:10.1016/j.jcp.2016.04.002

  11. [11]

    Sánchez-Vizuet, M

    T. Sánchez-Vizuet, M. E. Solano, A hybridizable discontinuous galerkin solver for the Grad–Shafranov equation, Computer Physics Communications 235 (2019) 120–132. doi:10.1016/j.cpc.2018.09.013

  12. [12]

    Pataki, A

    A. Pataki, A. J. Cerfon, J. P. Freidberg, L. Greengard, M. O’Neil, A fast, high-order solver for the grad–shafranov equation, Journal of Computational Physics 243 (2013) 28–45. doi:10.1016/j.jcp.2013.02.045

  13. [13]

    J. Lee, A. Cerfon, ECOM: A fast and accurate solver for toroidal axisymmetric MHD equilibria, Computer Physics Communications 190 (2015) 72–88. doi:10.1016/j.cpc.2015.01.015

  14. [14]

    D. W. Dudt, E. Kolemen, DESC: A stellarator equilibrium solver, Physics of Plasmas 27 (2020) 102513. doi:10.1063/5.0020743

  15. [15]

    J. F. Artaud, et al., METIS: a fast integrated tokamak modelling tool for scenario design, Nuclear Fusion 58 (2018) 105001. doi:10.1088/1741-4326/aad5b1

  16. [16]

    R. L. Miller, M. S. Chu, J. M. Greene, Y . R. Lin-Liu, R. E. Waltz, Noncircular, finite aspect ratio, local equilib- rium model, Physics of Plasmas 5 (1998) 973–978. doi:10.1063/1.872666. 31

  17. [17]

    Arbon, J

    R. Arbon, J. Candy, E. A. Belli, Rapidly-convergent flux-surface shape parameterization, Plasma Physics and Controlled Fusion 63 (2021) 012001. doi:10.1088/1361-6587/abc63b

  18. [18]

    Snoep, J

    G. Snoep, J. T. W. Koenders, C. Bourdelle, J. Citrin, Improved flux-surface parameterization through constrained nonlinear optimization, Physics of Plasmas 30 (2023) 063906. doi:10.1063/5.0145001

  19. [19]

    X. Li, H. Xie, L. Wei, Z. Wang, Investigation of toroidal rotation effects on spherical torus equilibria using the fast spectral solver VEQ-R, 2026. doi:10.48550/arXiv.2602.11422, arXiv:2602.11422

  20. [20]

    H. Xie, Y . Li, What is the minimum number of parameters required to represent solutions of the Grad–Shafranov equation?, 2026. doi:10.48550/arXiv.2601.02942, arXiv:2601.02942

  21. [21]

    L. L. Lao, S. P. Hirshman, R. M. Wieland, Variational moment solutions to the grad–shafranov equation, The Physics of Fluids 24 (1981) 1431–1440. doi:10.1063/1.863562

  22. [22]

    L. Lao, R. Wieland, W. Houlberg, S. Hirshman, VMOMS – a computer code for finding moment solu- tions to the grad–shafranov equation, Computer Physics Communications 27 (1982) 129–146. doi:10.1016/ 0010-4655(82)90069-8

  23. [23]

    Lao, Variational moment method for computing magnetohydrodynamic equilibria, Computer Physics Com- munications 31 (1984) 201–212

    L. Lao, Variational moment method for computing magnetohydrodynamic equilibria, Computer Physics Com- munications 31 (1984) 201–212. doi:10.1016/0010-4655(84)90045-6

  24. [24]

    S. W. Haney, J. P. Freidberg, C. J. Solomon, A fast, user-friendly code for calculating magnetohydrodynamic equilibria, Computers in Physics 9 (1995) 216–224. doi:10.1063/1.168526

  25. [25]

    G. O. Ludwig, Direct variational solutions to the grad–schluter–shafranov equation, Plasma Physics and Con- trolled Fusion 37 (1995) 633–646. doi:10.1088/0741-3335/37/6/003

  26. [26]

    Sauter, S

    O. Sauter, S. Medvedev, Tokamak coordinate conventions: COCOS, Computer Physics Communications 184 (2013) 293–302. doi:10.1016/j.cpc.2012.09.010

  27. [27]

    L. N. Trefethen, Spectral Methods in MATLAB, Society for Industrial and Applied Mathematics, 2000. doi:10. 1137/1.9780898719598

  28. [28]

    H. R. Lewis, P. M. Bellan, Physical constraints on the coefficients of fourier expansions in cylindrical coordi- nates, Journal of Mathematical Physics 31 (1990) 2592–2596. doi:10.1063/1.529009

  29. [29]

    Nocedal, S

    J. Nocedal, S. J. Wright, Numerical Optimization, Springer Series in Operations Research and Financial Engi- neering, 2 ed., Springer, New York, 2006. doi:10.1007/978-0-387-40065-5

  30. [30]

    E., et al

    P. Virtanen, et al., SciPy 1.0: fundamental algorithms for scientific computing in Python, Nature Methods 17 (2020) 261–272. doi:10.1038/s41592-019-0686-2

  31. [31]

    S. K. Lam, A. Pitrou, S. Seibert, Numba: an LLVM-based Python JIT compiler, in: Proceedings of the Second Workshop on the LLVM Compiler Infrastructure in HPC, SC15, ACM, 2015, pp. 1–6. doi:10.1145/2833157. 2833162

  32. [32]

    one size fits all

    A. J. Cerfon, J. P. Freidberg, “one size fits all” analytic solutions to the grad–shafranov equation, Physics of Plasmas 17 (2010) 032502. doi:10.1063/1.3328818

  33. [33]

    Accessed 2026-05-07

    FreeQDSK developers, GEQDSK file format documentation, FreeQDSK 0.5.2 documentation, 2026. Accessed 2026-05-07

  34. [34]

    Kripner, M

    L. Kripner, M. Tomeš, M. Peterka, J. Urban, E. Macúšová, F. Jaulmes, D. Fridrich, O. Grover, O. Ficker, J. Krbec, J. ˇCerovský, Towards the integrated analysis of tokamak plasma equilibria: PLEQUE, in: WDS’19 Proceedings of Contributed Papers — Physics, 2019, pp. 100–105. 32

  35. [35]

    B. M. Garcia, M. V . Umansky, J. Watkins, J. Guterl, O. Izacard, INGRID: An interactive grid generator for 2d edge plasma modeling, Computer Physics Communications 275 (2022) 108316. doi:10.1016/j.cpc.2022. 108316

  36. [36]

    N. C. Amorisco, A. Agnello, G. Holt, M. Mars, J. Buchanan, S. J. P. Pamela, FreeGSNKE: A Python-based dynamic free-boundary toroidal plasma equilibrium solver, Physics of Plasmas 31 (2024) 042517. doi:10.1063/ 5.0188467

  37. [37]

    S. P. Hirshman, J. C. Whitson, Steepest-descent moment method for three-dimensional magnetohydrodynamic equilibria, The Physics of Fluids 26 (1983) 3553–3568. doi:10.1063/1.864116. 33