pyna - Python DYNAmics

pyna is a Python library for dynamical systems analysis and magnetic confinement fusion (MCF) physics – from field-line tracing and Poincare maps to analytic torus-deformation theory and publication-quality tokamak visualizations.

Field-line Tracing

RK4 integrator with optional CUDA acceleration (118x speedup).

Field-line Tracing (pyna.flt)

Poincare Maps & Islands

Multi-section maps, X/O-point detection, island width extraction.

Topology (pyna.topo)

Manifold Visualization

Publication-quality stable/unstable manifold plots in the preferred pyna.toroidal namespace.

Topology (pyna.topo)

Torus Deformation

Non-resonant BNF-derived analytic spectral theory (Wei 2025), surfaced through pyna.toroidal.

FPT Topology Control (pyna.control)

Toroidal Equilibria

Solov’ev, Grad-Shafranov, stellarator analytic/numeric solutions.

API Reference

Magnetic Coordinates

PEST, Boozer, Hamada, Equal-arc transformations via pyna.toroidal.

API Reference

English Documentation

• Installation
  • Requirements
  • From PyPI
  • From source
  • C++ acceleration (cyna)
  • Verify installation
• Quick Start
  • 1. Build an Analytic Equilibrium
  • 2. Trace Field Lines and Accumulate Poincaré Crossings
  • 3. Locate a Rational Surface and Measure an Island
  • 4. Next Steps
• API Reference
  • Field-line Tracing (pyna.flt)
  • Topology (pyna.topo)
  • FPT Topology Control (pyna.control)
• Tutorials
  • Magnetic Coordinate Systems in Tokamak Equilibria
  • Island Jacobian Analysis: Periodic Orbits and Monodromy Matrices
  • RMP Island Width Validation �?Solov’ev Analytic Equilibrium
  • RMP Stellarator Resonance Analysis

Chinese Documentation

• 安装指南
  • 系统要求
  • 从 PyPI 安装
  • 从源码安装
  • C++ 扩展 (cyna)
  • 验证安装
• 快速入门
  • 基本用法
  • 更多示例
• API 参考