Cylindrically-separable wrapper potential¶

class galpy.potential.CylindricallySeparablePotentialWrapper(*args, **kwargs)[source]¶

Potential wrapper class that approximates a given axisymmetric potential as a potential that is separable in cylindrical coordinates, by defining

\begin{align} \Phi_R(R) & = \Phi(R,0)\,,\\ \Phi_z(z) & = \Phi(R',z) - \Phi(R',0)\,, \end{align}

where \(R'\) is a reference radius (default: \(R'=1\) in internal units). The potential is then given by

\begin{align} \Phi(R,z) & = \Phi_R(R) + \Phi_z(z)\,. \end{align}

This approximation is used in the adiabatic-approximation for action-angle coordinates (e.g., Binney 2010; Bovy 2026).

__init__(amp=1.0, pot=None, Rp=1.0, ro=None, vo=None)[source]¶

Initialize an CylindricallySeparablePotentialWrapper Potential.

Parameters:

amp (float, optional) – Amplitude to be applied to the potential. Default is 1.0.
pot (Potential or a combined potential formed using addition (pot1+pot2+…)) – Potential instance or a combined potential formed using addition (pot1+pot2+…); this potential is made into a cylindrically separable potential.
Rp (float or Quantity, optional) – Reference radius \(R'\) (in internal units) at which to evaluate \(\Phi(R',z)\); default is 1.0 (in internal units).
ro (float or Quantity, optional) – Distance scale for translation into internal units (default from configuration file).
vo (float or Quantity, optional) – Velocity scale for translation into internal units (default from configuration file).

Notes