Skip to content

feat(equilibrium): calculate q(psi) from 2D psi map and F(psi) (#647) - #680

Merged
HongSik-Yun-Fusion merged 3 commits into
developfrom
feat/647-q-profile-from-psi-map
Sep 9, 2026
Merged

feat(equilibrium): calculate q(psi) from 2D psi map and F(psi) (#647)#680
HongSik-Yun-Fusion merged 3 commits into
developfrom
feat/647-q-profile-from-psi-map

Conversation

@HongSik-Yun-Fusion

Copy link
Copy Markdown
Contributor
  • Expose q_from_flux_surface_averages in vaft.formula.equilibrium for the pure
    geometric formula with explicit 2*pi normalization and COCOS sign
  • Extend flux_surface_quantities in vaft.process.equilibrium to compute and return
    'q' on each resolved contour and extrapolate q0 to magnetic axis in psi_N
  • Implement calculate_q_profile_from_psi in vaft.process.equilibrium supporting
    full COCOS compliance (Wb vs Wb/rad, signs), flexible f_profile inputs
    (scalar, array, callable, tuple), and return_details
  • Benchmark against exact analytic Solov'ev axis limit q0 and high-precision 1D
    contour quadrature across surfaces

- Expose q_from_flux_surface_averages in vaft.formula.equilibrium for the pure
  geometric formula with explicit 2*pi normalization and COCOS sign
- Extend flux_surface_quantities in vaft.process.equilibrium to compute and return
  'q' on each resolved contour and extrapolate q0 to magnetic axis in psi_N
- Implement calculate_q_profile_from_psi in vaft.process.equilibrium supporting
  full COCOS compliance (Wb vs Wb/rad, signs), flexible f_profile inputs
  (scalar, array, callable, tuple), and return_details
- Benchmark against exact analytic Solov'ev axis limit q0 and high-precision 1D
  contour quadrature across surfaces
- Add docstring unit tag [-] for cocos in q_from_flux_surface_averages.
- Remove q_from_flux_surface_averages from vaft.process.equilibrium module exports to fix Jekyll doc building.
- Extrapolate q to axis using low-degree polynomial over innermost resolved surfaces to filter discrete contour jitter.
- Interpolate q gaps linearly in psi_N instead of sqrt(psi_N).
- Handle unsorted/descending levels and extrapolate q_axis when 0.0 is not present in return_details.
- Infer negative toroidal field (sigma_b0 = -1) when negative F is supplied with default sigma_b0=1.
- Make spline evaluation lazy and move formula import outside inner loop.
- Add regression tests covering all cold review cases.
@HongSik-Yun-Fusion
HongSik-Yun-Fusion merged commit d9649b9 into develop Sep 9, 2026
10 checks passed
@HongSik-Yun-Fusion
HongSik-Yun-Fusion deleted the feat/647-q-profile-from-psi-map branch September 9, 2026 02:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant