PostNewtonianSelfForce
Install this package!The PostNewtonianSelfForce package provides a set of functions for working with post-Newtonian expansions in the self-force regime. The results are categorized by the spacetime (Schwarzschild/Kerr) or orbit type (e.g. circular, eccentric, etc). The results give the highest-order PN results known. Each subdirectory has a README.md file that shows who has contributed to the growth of these PN series over the years.
Listing and loading the PN series
Listing and loading PN series is done using the PostNewtonianExpansion
command. To list all the available PN series use PostNewtonianExpansion[]
. This will produce a long list. To return a subset of this list you can provide a String or List of Stings as an argument. You can also use a !
prefix to exclude a given String. For example, if you want to list all PN series for circular orbits in Schwarzschild spacetime, but not ones involving spin you can use
PostNewtonianExpansion[{"Schwarzschild", "!Spin", "Circular"}]
At the time of writing this returns
{"/Schwarzschild/Circular/Flux/Horizon", "/Schwarzschild/Circular/Flux/Infinity-l2m2",
"/Schwarzschild/Circular/Flux/Infinity", "/Schwarzschild/Circular/Local/RedShift"}
To load a PN series provide a String or List of Strings that returns a unique result. For example to load the PN series for the flux radiated to infinity for a particle on a circular orbit about a Schwarzschild black hole use the command
PNSeries = PostNewtonianExpansion["Schwarzschild/Circular/Flux/Infinity"]
Alternatively, you could use, e.g., PNSeries = PostNewtonianExpansion[{"Schwarzschild", "Flux", "Infinity", "Circular"}]
but note that as more PN series are added this might not return a unique series.
Executing the above command returns
This PostNewtonianData
object stores the PN series and information about it.
Working with the PN series
The entire PN series can be extracted using the command
PNSeries["Series"]
In this case the series is very large. If instead you just want a particular coefficient use PostNewtonianCoefficient[PNSeries, n]
where n is the power of $y$ whose coefficient you’re interested in.
Citing
Package
In addition to acknowledging the Black Hole Perturbation Toolkit as suggested on the front page we also recommend citing the specific package version you use via the citation information on the package’s Zenodo page linked from the above DOI.
Post-Newtonian Series
If you make use of any PN series in your work you can find the correct reference by calling PNSeries["References"]
. In this case this returns
{"Gravitational Waves from a Particle in Circular Orbits around a
Schwarzschild Black Hole to the 22nd Post-Newtonian Order, R. Fujita,
Prog. Theor. Phys. 128 (2012) pp. 971-992, arXiv:1211.5535."}
It is important to note that this reference is only for the most recent paper concerning that PN series. For a fill list of all the contributions made my many authors over the years please look for the README files in the in the SeriesData folder in the repository (e.g., in the circular orbit series directory).
Further examples
Example notebooks can be found in the Mathematica Toolkit Examples repository.
Authors and contributors
Package: Barry Wardell, Niels Warburton, Priti Gupta
PN series: Donato Bini, Thibault Damour, Charles Evans, Ryuichi Fujita, Seth Hopper, Chris Kavanagh, Chris Munna, Adrian Ottewill, Abhay Shah, Norichika Sago, Barry Wardell