quartic2d.HarmonicTransform.converge#

HarmonicTransform.converge(*, rtol=0.001, atol=0.0, subdivisions=(1, 2, 4, 8), hstart=0.05, hdecrement=2.0, maxiter=15, apply=False)#

Converge only the radial quadrature on the current q grid.

This low-level helper leaves q_max and n_q unchanged. Finite methods repeat each retained harmonic with progressively larger subdivisions and choose a common value sufficient for all modes. Use converge_parameters() when q support and q-grid interpolation must also be included in the convergence search.

Parameters:

  • rtol (float, default=1e-3) – Relative self-convergence threshold between successive radial quadrature refinements.

  • atol (float, default=0) – Absolute self-convergence threshold used together with rtol.

  • subdivisions (iterable of int, default=(1, 2, 4, 8)) – Candidate finite-grid refinements, tried in order. Each value is the number of integration panels placed inside one original radial interval.

  • hstart (float, default=0.05) – Initial Ogata resolution parameter.

  • hdecrement (float, default=2) – Factor controlling the Ogata resolution search.

  • maxiter (int, default=15) – Maximum number of Ogata search iterations for each retained mode.

  • apply (bool, default=False) – If True, recompute this object with the selected radial quadrature parameters.

Returns:

Internal self-convergence record and selected parameters.

Return type:

ConvergenceResult

Raises:

  • RuntimeError – If apply=True but the search does not produce converged parameters.

  • ImportError – If the active method is 'ogata' and the optional hankel dependency is unavailable.

Notes

The reported error compares numerical refinements. It is not an independent reference error.