GalPort: Investigation of the bar in action-angle space
arXiv:2607.07262 · doi:10.1016/j.ascom.2026.101163
Abstract
GalPort is a Python package for analysing the orbital dynamics of evolving disc galaxy numerical models in action-angle space. The package implements novel numerical methods for efficiently estimating actions, angles, and frequencies across different, particle-specific timescales: on the scale of radial or vertical oscillation and on the resonant libration/circulation timescale. The algorithm allows calculation of these dynamic quantities simultaneously at all time steps of the simulated galactic evolution. With this tool, one can trace orbital behaviour within time-varying galactic potentials and classify orbits (resonantly trapped, circulating, or passing through a resonance) based on their angle evolution. GalPort also includes specialised options for analysing the phase-space structure of a galactic bar in the disc plane and along its major axis. We demonstrate the package's performance on a typical N-body model of a barred galaxy, obtaining the global distributions of actions and frequencies and performing a detailed orbital decomposition. The code is publicly available under the MIT license at: https://github.com/vdzozulia/galport
arXiv comment18 pages, 7 figures, 1 table, Accepted for publication in Astronomy and Computing
References in corpus (42)
- Array Programming with NumPy
- The Structure of Cold Dark Matter Halos
- galpy: A Python Library for Galactic Dynamics
- AGAMA: Action-based galaxy modelling architecture
- Proper motions and dynamics of the Milky Way globular cluster system from Gaia DR2
- Actions for axisymmetric potentials
- Made-to-Measure models of the Galactic Box/Peanut bulge: stellar and total mass in the bulge region
- The Global Dynamical Atlas of the Milky Way mergers: Constraints from Gaia EDR3 based orbits of globular clusters, stellar streams and satellite galaxies
- Models of our Galaxy II
- The Galactic Disc in Action Space as seen by Gaia DR2
- The Milky Way Halo in Action Space
- Generation of mock tidal streams
- Resonance sweeping by a decelerating Galactic bar
- Signatures of resonance and phase mixing in the Galactic disc
- Tree-ring structure of Galactic bar resonance
- Resonances in Barred Galaxies
- A Vertical Resonance Heating Model for X- or Peanut-Shaped Galactic Bulges
- Three Mechanisms for Bar Thickening
- Trapped orbits and solar-neighbourhood kinematics
- Growth of a peanut shaped bulge via resonant trapping of stellar orbits in the vertical Inner Lindblad Resonances
- Angle-action estimation in a general axisymmetric potential
- Self-consistent models of our Galaxy
- Torus mapper: a code for dynamical models of galaxies
- Galactic potential constraints from clustering in action space of combined stellar stream data
- A fast algorithm for estimating actions in triaxial potentials
- Galactic Bar Resonances Inferred from Kinematically Hot Stars in Gaia EDR3
- Box/peanut-shaped bulges in action space
- Identifying resonances of the Galactic bar in Gaia DR2: II. Clues from angle space
- What determines the flatness of X-shaped structures in edge-on galaxies
- On the stability of tidal streams in action space
- Radial halo substructure in harmony with the Galactic bar
- Orbital support and evolution of flat profiles of bars (shoulders)
- Action-based Dynamical Modelling for the Milky Way Disk
- Chaotic motion and the evolution of morphological components in a time-dependent model of a barred galaxy within a dark matter halo
- Orbital classification in an N-body bar
- Classifying globular clusters and applying them to estimate the mass of the Milky Way
- Face-on structure of barlenses and boxy bars: an insight from spectral dynamics
- Dynamical friction and feedback on galactic bars in the general fast-slow regime
- Quantifying the influence of bars on action-based dynamical modelling of disc galaxies
- First direct identification of the barlens vertical structure in galaxy models
- Diffusion of radial action in a galactic disc
- Phase-space distortion as a key to unraveling galactic bar buckling