torus-solver¶
JAX-differentiable surface-current modeling and optimization on a circular torus, with targets motivated by stellarators and tokamaks.
This documentation is written for two audiences:
Newcomers: you can start from scratch, learn the physics assumptions and equations, and run the examples end-to-end.
Domain experts: you can quickly map the equations to the implementation details, understand algorithmic tradeoffs, and extend the code.
Gallery¶
Electrode-driven helical optimization: 3D field lines from the Biot–Savart field of the optimized surface currents.¶
VMEC target surface: optimized normalized normal field \(B_n/|B|\) (REGCOIL-like current-potential model).¶
Regularization scan (“L-curve”-style): tradeoff between current magnitude (\(K_{\mathrm{rms}}\)) and field quality (max\(|B_n/B|\)).¶
Getting Started
Theory
API Reference
- API reference
- torus_solver.torus
- torus_solver.spectral
- torus_solver.poisson
- torus_solver.sources
- torus_solver.current_potential
- torus_solver.biot_savart
- torus_solver.fields
- torus_solver.fieldline
- torus_solver.optimize
- torus_solver.metrics
- torus_solver.targets
- torus_solver.surface_ops
- torus_solver.vmec
- torus_solver.plotting
- torus_solver.gui_vtk