FIRM3D: Fast ion reduced models in 3D
Pith reviewed 2026-05-19 20:08 UTC · model grok-4.3
The pith
FIRM3D supplies an open-source suite that integrates guiding-center orbits of energetic particles through three-dimensional magnetic fields while linking to MHD equilibrium and wave codes.
A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.
Core claim
FIRM3D performs parallelized integration of the guiding-center orbit equation for Monte Carlo samples drawn from energetic-particle distributions, supplies orbit visualization and transport diagnostics such as Poincaré maps and weighted Birkhoff averages, and includes ready interfaces to BOOZ_XFORM for MHD equilibria and to AE3D and FAR3D for wave stability data.
What carries the argument
The extended guiding-center orbit integrator, grown from SIMSOPT routines, that advances particle trajectories in 3D fields with optional symplectic or Runge-Kutta steps and feeds results into classification and averaging diagnostics.
If this is right
- Monte Carlo ensembles of energetic-particle orbits can be integrated at scale on both CPUs and GPUs.
- Resonant transport driven by MHD waves can be quantified by coupling the orbit solver directly to wave-stability outputs.
- Poincaré maps and orbit-classification routines become available for rapid identification of confined versus lost particles.
- New physics modules for particle-wave interactions or additional diagnostics can be added with few external dependencies.
Where Pith is reading between the lines
- Stellarator design teams could insert FIRM3D into optimization loops to penalize configurations that produce large fast-ion losses.
- GPU scaling would permit statistical sampling of rare loss events across thousands of particles in a single run.
- The same orbit infrastructure might later incorporate finite-Larmor-radius corrections or self-consistent wave evolution without rewriting the core integrator.
Load-bearing premise
The guiding-center approximation remains valid for the energetic particles of interest and external codes supply accurate, compatible field and wave data without large numerical artifacts.
What would settle it
A side-by-side comparison of FIRM3D guiding-center trajectories against full-orbit Lorentz integrations for a test particle whose gyroradius becomes comparable to the magnetic-field scale length.
Figures
read the original abstract
The dynamics of energetic particle (EP) species, born from fusion reactions or plasma heating schemes, are critical for predicting the behavior of magnetic confinement fusion experiments and future fusion reactors. Because energetic particles are largely collisionless, the orbits of Monte Carlo samples drawn from a given distribution function can be efficiently integrated in prescribed electromagnetic fields. In addition to the static magneto-hydrodynamic (MHD) equilibrium fields produced by the electromagnetic coils of a fusion device, MHD waves can be excited by -- and resonantly transport -- energetic particle populations. FIRM3D is an open-source Python/C++/CUDA software suite for modeling energetic particle dynamics in 3D magnetic fields, available at https://github.com/ColumbiaStellaratorTheory/firm3d. The core guiding-center integration routines grew out of SIMSOPT (Landreman et al., 2021), but have been extended to include additional physics and diagnostics not typically required in the stellarator optimization context. This standalone framework enables focused development of energetic particle physics capabilities with minimal dependencies, making it accessible to the broader stellarator and plasma physics community. Components of FIRM3D include interfaces with MHD equilibrium and wave stability software (BOOZ_XFORM, AE3D, FAR3D); CPU and GPU parallelized integration of the guiding center orbit equation, with symplectic and Runge-Kutta integrator options; and orbit visualization and transport diagnostics, including Poincare maps, orbit classification, and weighted Birkhoff averaging.
Editorial analysis
A structured set of objections, weighed in public.
Referee Report
Summary. The manuscript describes FIRM3D, an open-source Python/C++/CUDA software suite for modeling energetic particle dynamics in 3D magnetic fields. It extends guiding-center integration routines originally from SIMSOPT with added EP physics, diagnostics, and interfaces to MHD equilibrium and wave stability codes (BOOZ_XFORM, AE3D, FAR3D). Core capabilities include CPU/GPU-parallelized integration of the guiding-center orbit equation using symplectic and Runge-Kutta options, plus orbit visualization and transport diagnostics such as Poincaré maps, orbit classification, and weighted Birkhoff averaging.
Significance. If the described implementation and interfaces function as stated, FIRM3D would provide a valuable, focused, standalone framework for energetic particle studies in stellarators and other 3D configurations. Strengths include its open-source distribution, minimal dependencies, parallelization support, and explicit linkages to established tools, which promote accessibility and reproducibility for the broader plasma physics community.
minor comments (2)
- Abstract: The diagnostic 'weighted Birkhoff averaging' is referenced without a short definition or citation; adding one sentence of explanation would improve accessibility for readers outside the immediate subfield.
- The manuscript should include a brief section or table summarizing verification tests (e.g., comparison of integrators against analytic orbits or conservation properties) to substantiate the numerical accuracy claims.
Simulated Author's Rebuttal
We thank the referee for their positive summary of the FIRM3D manuscript and for recognizing its potential value as a focused, open-source framework for energetic particle studies in 3D configurations. We appreciate the recommendation for minor revision and have prepared corresponding updates to improve clarity and accessibility.
Circularity Check
No significant circularity; software description with no derivation chain
full rationale
The paper presents FIRM3D as an open-source software framework for guiding-center orbit integration in 3D fields, extending SIMSOPT routines with added diagnostics and interfaces to BOOZ_XFORM, AE3D, and FAR3D. No equations, predictions, or first-principles results are claimed that could reduce by construction to fitted parameters, self-citations, or ansatzes. The central content is a tool description and capability summary rather than a mathematical derivation; standard modeling prerequisites such as guiding-center validity are stated without internal reduction to the paper's own outputs. This is a self-contained software distribution with no load-bearing steps that exhibit circularity.
Axiom & Free-Parameter Ledger
axioms (1)
- domain assumption Guiding-center approximation is appropriate for the energetic particle dynamics under consideration.
Lean theorems connected to this paper
-
IndisputableMonolith/Foundation/DimensionForcing.lean (and AlexanderDuality.lean)reality_from_one_distinction / alexander_duality_circle_linking unclear?
unclearRelation between the paper passage and the cited Recognition theorem.
CPU and GPU parallelized integration of the guiding center orbit equation, with symplectic and Runge-Kutta integrator options; orbit visualization and transport diagnostics, including Poincaré maps, orbit classification, and weighted Birkhoff averaging.
-
IndisputableMonolith/Cost/FunctionalEquation.leanwashburn_uniqueness_aczel unclear?
unclearRelation between the paper passage and the cited Recognition theorem.
The equilibrium magnetic field is typically provided through an interface with BOOZ_XFORM ... The magnetic field perturbation corresponding to an MHD mode from AE3D or FAR3D can then be superimposed
What do these tags mean?
- matches
- The paper's claim is directly supported by a theorem in the formal canon.
- supports
- The theorem supports part of the paper's argument, but the paper may add assumptions or extra steps.
- extends
- The paper goes beyond the formal theorem; the theorem is a base layer rather than the whole result.
- uses
- The paper appears to rely on the theorem as machinery.
- contradicts
- The paper's claim conflicts with a theorem or certificate in the canon.
- unclear
- Pith found a possible connection, but the passage is too broad, indirect, or ambiguous to say the theorem truly supports the claim.
Reference graph
Works this paper leans on
-
[1]
Albert, C. G., Buchholz, R., Kasilov, S. V., Kernbichler, W., & Rath, K. (2023). Alpha particle confinement metrics based on orbit classification in stellarators. Journal of Plasma Physics, 89(3), 955890301
work page 2023
-
[2]
Albert, C. G., Kasilov, S. V., & Kernbichler, W. (2020). Symplectic integration with non-canonical quadrature for guiding-center orbits in magnetic confinement devices. Journal of Computational Physics, 403, 109065
work page 2020
-
[3]
Boost.Numeric.Odeint. (2025). Boost.odeint: Solving ordinary differential equations in C++ . https://www.boost.org/libs/numeric/odeint
work page 2025
-
[4]
Boozer, A. H. (1995). Quasi-helical symmetry in stellarators. Plasma Physics and Controlled Fusion, 37(11A), A103
work page 1995
-
[5]
Chambliss, A., Paul, E. J., & Hudson, S. R. (2025). Fast particle trajectories and integrability in quasiaxisymmetric and quasihelical stellarators. Journal of Plasma Physics, 91(3), E74
work page 2025
-
[6]
CATAPULT: A CUDA-Accelerated Timestepper for Alpha Particles Using Local Tricubics
Czekanski, M., Knyazev, A. R., Bindel, D., & Paul, E. J. (2026). CATAPULT: A CUDA-accelerated timestepper for alpha particles using local tricubics. arXiv Preprint arXiv:2604.07617
work page internal anchor Pith review Pith/arXiv arXiv 2026
-
[7]
Duignan, N., & Meiss, J. D. (2023). Distinguishing between regular and chaotic orbits of flows by the weighted birkhoff average. Physica D: Nonlinear Phenomena, 449, 133749
work page 2023
-
[8]
Gorelenkov, N. N., Pinches, S. D., & Toi, K. (2014). Energetic particle physics in fusion research in preparation for burning plasma experiments. Nuclear Fusion, 54(12), 125001
work page 2014
-
[9]
Jakob, W., Rhinelander, J., & Moldovan, D. (2017). pybind11 -- seamless operability between C++11 and Python . Zenodo. https://doi.org/10.5281/zenodo.3748217
- [10]
-
[11]
Landreman, M. (2021). Booz\_xform. Zenodo. https://doi.org/10.5281/zenodo.4876646
-
[12]
Landreman, M., Buller, S., & Drevlak, M. (2022). Optimization of quasi-symmetric stellarators with self-consistent bootstrap current and energetic particle confinement. Physics of Plasmas, 29(8)
work page 2022
-
[13]
Landreman, M., Medasani, B., Wechsung, F., Giuliani, A., Jorge, R., & Zhu, C. (2021). SIMSOPT: A flexible framework for stellarator optimization. Journal of Open Source Software, 6(65), 3525
work page 2021
-
[14]
Landreman, M., & Paul, E. J. (2022). Magnetic fields with precise quasisymmetry for plasma confinement. Physical Review Letters, 128(3), 035001
work page 2022
-
[15]
Linden, J. von der, Labbate, J., Paul, E., Flom, E., Dudt, D., Wu, R., Kruger, T., Swanson, C., Kumar, S., Gates, D., & others. (2026). Alpha confinement in the quasi-axisymmetric helios fusion power plant. Fusion Engineering and Design, 229, 115801
work page 2026
-
[16]
J., Bhattacharjee, A., Landreman, M., Alex, D., Velasco, J
Paul, E. J., Bhattacharjee, A., Landreman, M., Alex, D., Velasco, J. L., & Nies, R. (2022). Energetic particle loss mechanisms in reactor-scale equilibria close to quasisymmetry. Nuclear Fusion, 62(12), 126054
work page 2022
-
[17]
Paul, E. J., Mynick, H. E., & Bhattacharjee, A. (2023). Fast-ion transport in quasisymmetric equilibria in the presence of a resonant alfv é nic perturbation. Journal of Plasma Physics, 89(5), 905890515
work page 2023
-
[18]
Press, W. H. (2007). Numerical recipes 3rd edition: The art of scientific computing. Cambridge university press
work page 2007
-
[19]
Rahbarnia, K., Thomsen, H., Schilling, J., Vaz Mendes, S., Endler, M., Kleiber, R., Könies, A., Borchardt, M., Slaby, C., Bluhm, T., & others. (2020). Alfv é nic fluctuations measured by in-vessel Mirnov coils at the Wendelstein 7-X stellarator . Plasma Physics and Controlled Fusion, 63(1), 015005
work page 2020
-
[20]
Spong, D. A., D'azevedo, E., & Todo, Y. (2010). Clustered frequency analysis of shear alfv é n modes in stellarators. Physics of Plasmas, 17(2)
work page 2010
- [21]
-
[22]
Toi, K., Ogawa, K., Isobe, M., Osakabe, M., Spong, D. A., & Todo, Y. (2011). Energetic-ion-driven global instabilities in stellarator/helical plasmas and comparison with tokamak plasmas. Plasma Physics and Controlled Fusion, 53(2), 024008
work page 2011
-
[23]
Varela, J., Spong, D., Garcia, L., Ghai, Y., Ortiz, J., & Collaborators, F. P. (2024). Stability optimization of energetic particle driven modes in nuclear fusion devices: The FAR3d gyro-fluid code. Frontiers in Physics, 12, 1422411
work page 2024
- [24]
discussion (0)
Sign in with ORCID, Apple, or X to comment. Anyone can read and Pith papers without signing in.