English

KerrGeoPy: A Python Package for Computing Timelike Geodesics in Kerr Spacetime

General Relativity and Quantum Cosmology 2024-06-04 v1

Abstract

KerrGeoPy is a Python package which computes both stable and plunging timelike geodesics in Kerr spacetime using analytic solutions to the geodesic equation that are written in terms of Legendre elliptic integrals. It mirrors and builds upon much of the functionality of the KerrGeodesics Mathematica library. Users can construct a geodesic by providing the initial position and four-velocity, or by providing either the constants of motion or a generalized version of the parameters defining a Keplerian orbit. The package provides methods for computing the four-velocity, fundamental frequencies, and constants of motion associated with a given geodesic along with the location of the separatrix. It also includes several methods for visualizing and animating geodesics.

Cite

@article{arxiv.2406.01413,
  title  = {KerrGeoPy: A Python Package for Computing Timelike Geodesics in Kerr Spacetime},
  author = {Seyong Park and Zachary Nasipak},
  journal= {arXiv preprint arXiv:2406.01413},
  year   = {2024}
}

Comments

4 pages, 1 figure; repository: https://github.com/BlackHolePerturbationToolkit/KerrGeoPy ; documentation: https://kerrgeopy.readthedocs.io/

R2 v1 2026-06-28T16:51:19.409Z