The KerrGeodesics package for Mathematica provides functions for computing bound timelike geodesics and their properties in Kerr spacetime.

Getting the package

The latest development version will always be available from the project git repository:

git clone


The KerrGeodesics package requires a recent version of Mathematica. It is typically tested with only the latest available version.


Clone the repository and place it somewhere on Mathematica’s $Path. Typical locations are inside ${HOME}/.Mathematica/Applications/ for Linux or inside ${HOME}/Library/Mathematica/Applications/ for Mac OSX.


The package may be loaded into Mathematica using the command:

<< KerrGeodesics`

Documentation and examples

Examples are included in the documentation. See the KerrGeodesics page in Documentation Center. The package includes functions to calculate, e.g.,


7 August 2018: Added generic orbit calculation (thanks for M. van de Meent for contributing code). Currently the code is separated in KerrGeoOrbit2[..] but will soon replace the earlier code.
7 September 2017: Initial version publicly released.
10 June 2017: Initial version created.

Known problems

Known bugs are recorded in the project bug tracker.


This code is distributed under the University of Illinois/NCSA Open Source License. Details can be found in the LICENSE file.


Niels Warburton Maarten van de Meent