WorksPhysics and Astronomy
FOORT: Flexible Object-Oriented Ray Tracing
Abstract
We present FOORT (Flexible Object-Oriented Ray Tracing), an open C++ code for ray-tracing images of black holes and other compact objects in arbitrary spacetimes. FOORT is designed to offer flexibility and can handle horizons, naked singularities and numerical metrics, allowing it to ray-trace numerous different metrics including Kerr and other black holes, as well as horizonless objects such as fuzzballs and boson stars. New metrics, analytical or numerical, can be added with minimal effort, and geodesics are initialized at the camera without reference to conserved quantities, so no special structure of the metric is required. Besides the intensity observed from a geometrically and optically thin equatorial disk, FOORT is set up to track a number of diagnostics along each geodesic, such as the number of equatorial crossings and the radius of closest approach. Its adaptive mesh can refine the image on any of these diagnostics, efficiently resolving narrow features such as higher-order photon rings. Accompanying Python tools convert the output into images and interferometric visibility amplitudes. We describe the main features of the code, validate it against analytic results in the Schwarzschild and Kerr spacetimes, demonstrate it on several non-Kerr metrics, and characterize its scaling with the number of OpenMP threads. FOORT is lightweight, requiring only C++17 and OpenMP, and has already been used in a number of studies of black hole and compact-object imaging. The code is publicly available in a GitHub repository.
Introduction
When the Event Horizon Telescope (EHT) Collaboration published their studies of the supermassive black holes (SMBHs) [1] and Sagittarius A* [2], the latter residing at the center of our own Milky Way, they opened up the avenue for a new way to probe black hole physics. Using very long baseline interferometry (VLBI), the EHT Collaboration managed to reconstruct images of these cosmic giants in the millimeter regime, for the first time resolving length scales comparable to the diameter of the event horizon, the one-way membrane from which nothing can escape. While a BH is dark by definition, the plasma in the surrounding accretion disk shines bright, producing the light that is eventually detected. As a consequence, the presence of an SMBH is inferred from the reconstructed image, as a dark central brightness depression associated with the event horizon.
Although the details of the image are heavily based on the astrophysical details of the plasma surrounding the central object, the extent of the dark region can provide an estimate for the mass of the SMBH. In the case of Sagittarius A*, this is consistent with dynamical estimates based on the motion of stars at the center of the Milky Way [3, 4]. However, in order to provide more stringent tests of general relativity (GR) and the Kerr hypothesis, it is essential to identify and analyze imaging observables that are (largely) independent of the uncertainties associated with the details of the plasma [5] (see e.g. [6] for a pedagogical review). The most promising candidates in this regard are various properties of the photon rings, bright ring-like features in the images that are determined by the underlying spacetime geometry [7]. The photon ring is a consequence of the strong bending of null geodesics near the horizon, and its properties are typically intimately connected to the details of the geometry without depending too much on the details of the emitting plasma — for example, it has been shown that the GR prediction for the photon ring shape can indeed feasibly be measured precisely with near-future VLBI observations [8, 9, 10].
Large collections of general-relativistic magnetohydrodynamic (GRMHD) plasma simulations are essential to support the data analysis of the EHT studies. This data is typically fed to ray-tracing codes that solve the radiative transfer equations along null geodesics to predict a series of images that we as distant observers would detect. GRMHD simulations are expensive and time consuming, however, such that cheaper alternatives are desirable for theoretical studies in which the precise details of the plasma dynamics are unimportant. Moreover, snapshots of GRMHD simulations contain complicated and variable structures in the plasma, time averaged images of simulations can wash out some of these fluctuations. Simple analytical models, such as that used in [8] (and presented below in § 3.5), can simulate features of time-averaged emission from a geometrically thin accretion disk; this allows for a computationally cheaper method to study what (time-averaged) images of certain BH accretion disks could look like.
Most ray-tracing efforts focus on the Kerr geometry, as one expects SMBHs to assume this metric in GR. However, an exciting question to ask is how VLBI images would differ in theories beyond GR, especially when the SMBH is actually not a black hole but rather a different, horizonless exotic compact object (ECO) as could be expected within theories resolving classical black hole paradoxes. Many studies have addressed some aspects of this question, e.g. [11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21]. Exploring the vast zoo of non-Kerr black holes and ECOs is infeasible for full GRMHD simulations — although some studies have been carried out for e.g. boson stars [22, 23]. This underlines the necessity for faster tools, such as ray-tracing codes employing simplified, analytical prescriptions for the emission.
As explained in [6], it is hard to find truly discriminatory observables in VLBI black hole imaging, where image predictions from GR can be truly distinguished from those coming from an alternative theory. Properties of the higher-order photon (sub)rings are interesting candidates for observables which may reveal beyond-GR signatures. Specifically, in VLBI imaging, measurements consist of sampling the visibility, which is the Fourier transform of the image (see also § 3.5); the photon rings produce strong universal signatures in the long-baseline regime of the visibility [7]. It is therefore also important to investigate what signatures beyond-GR effects or ECOs would source in the observed visibility in the photon-ring regime. Note that a detection of the photon ring in M87* has been claimed [24], although this remains debated [25, 26]; inclusions of longer baselines by the addition of an antenna in space [27] or on the Moon [28] should enable future upgrades of the EHT to confidently resolve at least the subring, meaning such precise photon-ring observations are plausibly accessible in the near future.
A multitude of ray-tracing codes exist, and we refer the reader to e.g. [29] for a comparison of several ray-tracing codes used in the EHT Collaboration. We highlight several codes here of particular relevance to FOORT.
ipole [30, 31] and Blacklight [32] brought adaptive ray tracing to black hole imaging, where more geodesics are integrated in regions of the image that require high resolution. Ref. [33] introduces AART, which focuses on the Kerr geometry and leverages the analytical solutions (see also Ref. [34, 35]) to the geodesic equations to improve accuracy, while also boasting a layered mesh that allows for high resolution in the series of lensing bands, where the photon rings reside. This enables the user to better resolve the photon rings, which become exponentially narrower as increases. Additionally, AART goes beyond the GLM prescription (see § 3.5) for the optically thin accretion disk, and can sample noise realizations on top of this to mimic a more dynamical disk, coming closer to standard GRMHD simulations.
Various ray-tracers also allow for non-Kerr spacetimes. GYOTO [36] is a well-established code for analytical and numerical spacetimes, with a range of emission sources including thin disks and orbiting stars, and has been used e.g. for boson stars [14]. PyHole [16] was created to ray-trace BHs with scalar hair and boson stars. RAPTOR [37] handles analytical and numerical spacetimes, runs on both CPUs and GPUs, and implements time-dependent (“slow-light”) radiative transfer, in which the plasma evolves while the light propagates. BHOSS [38] has been used, among others, to compare accreting boson stars with classical BHs [22]. A number of other ray-tracers or geodesic integrators allow for arbitrary spacetimes, e.g. Arcmancer [39], Mahakala [40], FANTASY [41], and Gradus.jl [42]; recently, the Python code TARTARUS [43], which uses just-in-time compilation for speed. Mahakala, FANTASY, and Gradus.jl compute the Christoffel symbols by automatic differentiation, whereas FOORT uses finite differences (see § 2).
In this work, we introduce a new ray-tracing code, FOORT [44], with different objectives in mind, which distinguish it from the plethora of other ray-tracers1:
Primarily, FOORT is focused on modularity and adaptability. The code is written in C++ and allows the user to extend the code with minimal effort to add new spacetime geometries and additional diagnostics.
FOORT is specifically designed for (but not limited to) studying non-Kerr geometries, in GR and beyond, both with and without horizons. A range of metrics are already implemented, ranging from classical BHs to (horizonless) fuzzballs and boson stars — see App. § 8. While several other codes can handle non-Kerr geometries, FOORT’s built-in framework can easily handle horizons, naked singularities of arbitrary codimension, horizonless objects, and numerical metrics with its built-in termination conditions. In addition, the light rays originating at the camera are initialized without any reference to conserved quantities, making the camera metric-agnostic.
FOORT also features a flexible adaptive mesh refinement (AMR) scheme that allows for the resolution of small image features. Importantly, the adaptive mesh can be refined on the basis of any diagnostic variable that is tracked during integration, not just the observed intensity. Many such diagnostics are already built in FOORT, including a four-color screen, equatorial passes, and closest-approach radius.
FOORT is designed to be user-friendly, keeping a possible user base in mind that may not be overly familiar with (ray-tracing) codes. FOORT is also light-weight and self-contained, requiring only C++17 and OpenMP and no external libraries. It includes Python tools to facilitate converting raw FOORT output to images as well as visibility amplitudes.
FOORT has already been used in several works. Its first use case was to study whether BHs that deviate from Kerr can lead to observable differences in their photon rings; more precisely in their shape and the Lyapunov exponent [11]. It has also been used to image fuzzballs [45], which have been shown to cast emergent shadows due to their complex microstructure, despite the absence of an event horizon [13]. FOORT has been used to study the shadows of scalarized BHs, including non-trivial Ricci couplings [46], and BHs in astrophysical environments [47]. More recently, it has been used to investigate the influence of a non-minimal coupling between the curvature and the electromagnetic field [12] and to image ultracompact boson stars [48, 49] and wormholes [50].
The rest of this paper is structured as follows. In § 2, we introduce the essential geodesic equations and the strategy that FOORT takes to integrate them, and we show tests of FOORT’s performance, precision and scaling. § 3 discusses the more FOORT-specific features of its metric-agnostic geodesic initialization procedures, the different features included to analyze the ultimate output, the adaptive mesh algorithm, and its emission model that can be used to simulate GRMHD images and interferometric visibility amplitudes. Then, in § 4, we provide several explicit demonstrations of images produced by FOORT for various metrics. Finally, we provide our conclusions in § 5. App. § 8 provides details of all the different metrics currently implemented in FOORT, and App. § 9 discusses further details of the simulated accretion disk properties used in the emission model.
Note that FOORT includes extensive documentation on all implemented metrics, diagnostics, terminations, outputs, as well as its Python library pyFOORT that serves to facilitate creating images out of FOORT raw outputs. For technical or practical details on how to use any particular feature discussed in this paper, we refer to this documentation. Unless otherwise specified, we set .
Basic Ray Tracing Code Features
The goal of a ray-tracing code in GR is to determine what a spacetime exhibiting a region of strong gravity — typically a BH or another compact object — looks like for an observer located at a large distance. Typically, the spacetime is assumed to be asymptotically flat, such that the observer is located in a region where the spacetime is approximately (spherical) Minkowski. To determine what the distant observer sees, a collection of null geodesics is traced back from its position in the direction of the central region.
The geodesic equations are cast in a first-order system:
where is an affine parameter and are the usual Christoffel symbols. Greek indices run from 0 to 3 and correspond to the coordinates in which the metric is given. Note that certain features of FOORT implicitly assume a spherical-type coordinate system with with ranging between 0 and while ranges between 0 and ; in particular, this assumption can be seen in the geodesic initialization and the adaptive step size calculation below.
Geodesic Integration
The user can specify a position for the distant observer; the null geodesics are then initialized at this observer’s position with an appropriate initial velocity to simulate a pinhole camera of an appropriate angular aperture at the observer’s location. This velocity is past-pointing as we are integrating the geodesic backwards in time starting at the observer (see § 3.1 below for further details).
FOORT implements standard integration schemes for numerically solving the geodesic equations (1)–(2). At the moment, the code supports a fourth order Runge–Kutta (RK4) scheme and a second-order velocity Verlet algorithm. By default, the Verlet scheme is selected, which advances the geodesic equations as follows [51]:
In this form, the scheme is explicit. However, steps (5)–(6) can be iterated until the change in the velocity vector is below some predefined tolerance, making the scheme semi-implicit: upon iteration, is replaced by the most recent . By default, this iteration loop is turned off, but if activated by the user it can improve the accuracy of the integration.
The advantage of the Verlet scheme is that the Christoffel symbols only need to be evaluated twice per step, at and , irrespective of this final iteration. This can offer a significant speedup for more complex spacetime metrics, enabling a faster visualization process. However, it should be noted that RK4 gives more accurate results, especially for relatively simple spacetimes, like Kerr: we thus recommend the user to consider both integrators for production runs. On the other hand, it has been shown that symplectic integrators, unlike the ones considered here, possess better geometric properties for long geodesic integrations (see, e.g., Refs. [52, 53]). Such symplectic integrators can be included in future versions of FOORT. Note that the calculation of the Christoffel symbols in the geodesic equations requires spacetime derivatives of the metric, which are calculated numerically using second-order finite differencing:
where is a parameter that can be set in the FOORT configuration, defaulting to . Furthermore, FOORT also makes use of the adaptive step-size routine introduced in Refs. [51, 54] and used in other ray tracing codes such as Ref. [37]. The step-size is determined by2
where
In this approach, is a small positive parameter — set to — that prevents division by 0, whereas determines the overall scale of the step size. FOORT also has a configuration parameter setting a minimum step-size, which defaults to . The above routine improves accuracy and efficiency in regions where the numerical integration becomes challenging, like in the vicinity of the event horizon and the poles. For numerical efficiency, most implemented metrics support logarithmic rescaling of the radial coordinate, i.e. evolving instead of .
Tests & performance
To test the code’s performance on parallel architectures, we carry out a standard geodesic calculation for Minkowski (flat), Schwarzschild, and Kerr (with spin ) spacetimes. We employ a uniform mesh with 65536 pixels, and in all cases we set the camera at , (), , with a screen size of . Numerical integration uses the Verlet scheme, with StepSize = 0.03 and SmallestPossibleStepsize = 1e-7. This setting provides a scenario that is relatively imbalanced for parallel calculations: when a BH is present, the shadow covers a large fraction of the viewscreen, implying that many (infalling) geodesics will be integrated for a much shorter time (i.e. until they reach the horizon) than those that hover just around the shadow’s edge. Geodesics passing sufficiently far from the BH will also take a much shorter time to be integrated. In essence, a handful of light rays that are integrated for a long time are spread across a few threads, and are therefore driving the overall code’s performance.
We conduct this calculation on an increasing number of OMP threads and record the runtime. The results are shown in Figure 1, where we report the code’s speedup from the baseline (i.e. the runtime on 1 OMP thread) up to 384 threads. We observe that the code performs fairly well throughout the scaling, in spite of the imbalance brought about by this choice of metric. At 384 threads, the measured speedup deviates from the ideal scaling by .
Figure 1. Scaling test for FOORT up to 384 threads, tracing 65536 pixels on a uniform grid in Minkowski (flat), Schwarzschild, and Kerr () spacetimes. The scaling remains very close to the ideal line when ray tracing BHs, even though a large part of the screen is covered by black pixels (infalling geodesics) that add imbalance to the scaling.
Ultracompact spacetimes contain bound null geodesics that neither escape nor fall into a potential horizon. These bound geodesics lead to photon rings: thin, nearly circular features that are expected to contribute significantly to images of BHs and dominate on long interferometric baselines [7] — see e.g. Ref. [6] for a recent review. The photon rings are caused by nearly bound geodesics that approximate the bound ones: the radial coordinate of the nearly bound geodesic exhibits a characteristic exponential divergence away from the radius of the bound geodesic, determined by the Lyapunov exponent . We have used FOORT to integrate the bound circular geodesic at , in Schwarzschild spacetime. Due to discretization errors, the geodesic quickly starts deviating from , thus becoming nearly bound. Figure 2 shows the value of the radial coordinate as a function of the number of half-orbits (corresponding to changing by ), showing that the geodesic indeed exponentially diverges away from at the correct rate set by the Lyapunov exponent for Schwarzschild spacetime [7]. This test demonstrates that FOORT is able to reproduce the characteristic behavior of nearly bound orbits.

Figure 2. Deviation of the radial coordinate of a bound, circular geodesic initialized at with velocity vector tangent to and . Theoretically, the geodesic should remain at , but numerical errors quickly perturb it, after which the growth in the deviation follows the characteristic exponential divergence as function of the number of half-orbits , set by the Lyapunov exponent . Both integration schemes perform comparatively well, with a fractional error below for the first 5 half-orbits.
As a second test, we use FOORT to integrate the geodesic shown in black in Figure 3. This geodesic starts at an observer located at , to which it returns after orbiting the black hole twice, giving rise to a secondary Einstein ring. The coordinate time elapsed for this geodesic is calculated3 to be (see e.g. [52, 55]). The initial velocity vector of the geodesic is given by

Figure 3. Visualization of the null geodesics in Schwarzschild spacetime relevant for testing the code’s performance. Black: a geodesic creating a secondary Einstein ring at . Orange: the bound orbit at . The red circle represents the event horizon at .
where . We stop the integration of the geodesic once it passes again, using the boundary sphere termination (see § 3.3), and interpolate onto that sphere (in postprocessing) to obtain the final coordinates of the geodesic. We then compare the difference between this position and the expected values using the error measure
where are the analytic values mentioned before. Figure 4 shows the values of this metric as a function of the number of integration steps . The number of steps is not directly controlled, but rather a consequence of the value of the parameter in the adaptive step size routine ((8)): over the range plotted, to good approximation. In this test, RK4 clearly outperforms Verlet, which displays the expected second-order convergence. RK4 is fourth-order accurate, which is seen for the smallest , but convergence stalls and the error measure (13) flattens at : this is a consequence of the finite-difference stencil (7). Indeed, using analytic expressions for the Schwarzschild Christoffel symbols extends the regime of fourth-order convergence until a plateau at is reached, set by round-off error. As noted before, for more complex spacetimes no analytic Christoffel symbols may be available, and evaluating the metric can be more expensive. As the Verlet integrator is cheaper per step, it usually suffices in initial, exploratory simulations where the results need not be extremely precise.

Figure 4. Distance metric (13) as function of the number of integration steps for the black geodesic in Figure 3. The number of integration steps is controlled by the parameter in (8), which is approximately linearly related to , as illustrated by the top axis. The Verlet method (with the velocity iteration turned off here) exhibits second-order convergence, and the RK4 integrator flattens out at due to the finite-difference stencil (7). Using analytic expressions for the Schwarzschild Christoffel symbols maintains fourth-order convergence for longer.
Specific FOORT Code Features
FOORT is designed with flexibility in mind: in particular, it is designed to be as straightforward as possible to add new metrics, diagnostics, and terminations. Furthermore, the code is made efficient through the use of an adaptive mesh, enabling the image to obtain high resolution in the regions of interest. The current implementation of FOORT already contains a number of metrics, which are listed and briefly described in App. § 8.
Geodesic initialization
Ray tracers specializing to Kerr often construct the initial photon momenta at the camera using the conserved quantities of the spacetime. FOORT, instead, is designed to initialize its geodesics in a metric-agnostic way. We assume only that the metric is asymptotically flat in coordinates that are (asymptotically) spherical, and that is timelike at the observer location (so that a static camera position is physically sensible). The camera is then placed at a location , chosen by the user, and points at the origin. The construction of the photon initial momenta proceeds in two steps: we first initialize the camera and light rays in flat space, and then map the resulting flat-space momentum to the curved spacetime using a particular local vielbein.
Flat-space camera and view screen
If are ordinary spherical coordinates in flat space (related to usual flat space Cartesian coordinates in the canonical way), we can introduce Cartesian camera coordinates with their origin at the observer location , with pointing away from the origin (opposite to the viewing direction) and aligned with the projection of the original -axis onto the plane orthogonal to the line of sight. These follow from the original Cartesian coordinates by a translation to the camera position and two rotations; the resulting axes are simply
evaluated at the camera location (and using hats to denote unit vectors in a given direction). For example, a camera on the positive -axis (, ) has .
We can then consider the viewscreen as the plane through the origin , orthogonal to the line of sight, with Cartesian coordinates along and ; see Figure 5. The pixel is assigned the (flat-space) ray that runs from the camera to the point , so that the camera acts as a pinhole camera with the screen at distance .4 This ray running from the camera towards the pixel on the viewscreen has unit spatial direction:
Figure 5. The camera sits at and points at the origin. The pixel on the screen through the origin defines the initial direction of the (backwards-traced) ray.
We trace geodesics backwards in time, so we take the photon momentum to be past-directed and pointing into the screen. Using (14) and (15), the components of the photon’s momentum in the flat-space spherical coordinates are
which is null with respect to the flat metric at the camera
for any normalization .
Local vielbein and curved-space initial momentum
We construct a vielbein , normalized to the flat spherical metric (17), to carry (16) over to curved spacetime. We use a Gram–Schmidt orthogonalization procedure in the order , with seed vectors:
Using the gradients and rather than and is what makes the construction robust: since for any vector , the gradient is automatically orthogonal to , , and , and similarly for . The Gram–Schmidt procedure then collapses to the explicit vielbein
This vielbein requires no symmetry assumptions or particular structure of the metric. Physically, is the four-velocity of a static observer, so the image is the one seen by a camera at rest with respect to the asymptotic frame. We evaluate and use our vielbein at the camera location .
The initial momentum of a photon in curved-space coordinates is
with given by Eq. (16). Since the factors of in cancel between and the vielbein, Eq. (20) can equivalently be written in terms of the unit vectors and as
The construction thus amounts to a pinhole camera in the rest frame of the static observer, with the screen at distance : the pixel corresponds to a ray at angle from the line of sight, with , and with and measured along and respectively.5
The parameter is the photon energy measured by the (static) observer. The conserved energy associated with (for the physical, future-directed photon with momentum ) is
and note that at large , . We simply set for all geodesics in FOORT.
This choice of vielbein gives sensible results both for metrics in Boyer–Lindquist-type coordinates and for metrics with many off-diagonal components, such as Kerr in Kerr–Schild coordinates; in the latter case is not orthogonal to , and is in fact null everywhere (), whereas is positive precisely outside the horizon. For large in the Kerr spacetime, the physical photon momentum satisfies and , so reduce to the standard celestial coordinates of Bardeen [56], and . At finite , the two differ at relative order .
To be more precise, for Kerr in Boyer–Lindquist coordinates, the exact relation between our screen coordinates and Bardeen’s is:
where , and and are the relevant Kerr metric functions, evaluated at the camera coordinates . For large , this becomes
The isotropic factor is the gravitational blueshift at the camera. The -dependent shift in is a frame-dragging effect since the camera has and thus is a static observer instead of a zero-angular-momentum observer. Note that a consequence of Eq. (24) is that screen sizes measured in FOORT’s screen coordinates, such as ring diameters compared with analytic critical curves, are smaller by a factor . For a camera distance (FOORT’s default), this is typically sub-pixel level for reasonable image resolutions — e.g. this is undetectable in Figure 6.

Figure 6. Comparison of the BH shadow, as extracted by FOORT, with the analytic prediction for a Kerr BH with spin . From left to right, we show the four-color screen, the extracted shadow and predicted critical curve, and a zoomed-in version focussing on the blue square. The FOORT data uses RK4 integration with , and the critical curve is corrected for the finite distance through Eq. (24).
Output & analysis
The geodesic integrator will keep on computing trajectories until predetermined termination conditions are met. Depending on the metric of interest, different terminations for the geodesic integrator can be included:
Boundary sphere: The geodesic integrator will stop once the geodesic arrives at a (user-defined) boundary sphere with a tunable radius. This should be large enough such that geodesics reaching this boundary sphere can really be considered as “escaped to infinity”.
Time out: One can set a limit on the number of integration steps that are taken per geodesic. This is particularly useful for geodesics that approach bound orbits or coordinate singularities.
Event horizon: For certain metrics with an event horizon (currently only horizons at a fixed value of the radial coordinate), a parameter can be set such that the geodesic integration is terminated once the geodesic reaches .
-singularity: Metrics where one of the coordinates is the polar angle typically become singular at the poles. To avoid numerical instability, geodesic integration is terminated once the geodesic position approaches the poles within a tunable .
General singularity: Metrics can contain any number of (naked) singularities, of any codimension. A parameter can be set such that geodesic integration will be terminated when geodesics come within a flat distance of a singularity.6
Additionally, geodesic integration can also be terminated when a NaN is encountered.
At the moment, FOORT allows the user to track the following diagnostics:
Geodesic position: When switched on,
FOORTwill keep track of the entire geodesic trajectory and output it to a file. This is useful e.g. to visualize individual geodesic trajectories.
Four-color screen: This diagnostic assigns a number 1–4 to the geodesic based on the quadrant of the boundary sphere where the geodesic terminates (see left panel in Figure 6). If the geodesic does not reach the boundary sphere (e.g. due to terminating at a horizon or singularity), it will be assigned 0.
Equatorial passes: This allows the user to track the number of times a geodesic passes through the equatorial plane . If the geodesic escapes to infinity, this number will be non-negative: if it falls into a horizon, it will get a minus sign. This is typically useful in the context of lensing bands or photon rings, which are indexed by the number of times their light rays pass through the equatorial plane.
Closest radius: This diagnostic keeps track of the smallest value for the radial coordinate a geodesic encounters. If the geodesic falls into a horizon, the code will report .
Equatorial emission: This keeps track of the brightness intensity of the geodesic assuming a particular model for emission from an equatorial disk. The calculation of this brightness intensity is described in more detail in Sec. 3.4.
These different terminations and diagnostics allow the user to study the geometry of exotic spacetimes, and enable the analysis of their potential photon rings even though this may not be feasible analytically. The full documentation provides details on how to use these different diagnostics and terminations, as well as how to add new diagnostics and terminations to FOORT in a few simple steps.
The FOORT repository contains a Python module, pyFOORT, which provides helper functions to easily visualize raw output of these diagnostics with standard Python packages. Since the output of an adaptive mesh is not on a regular pixel grid, pyFOORT first interpolates the raw data onto a uniform grid; from this, a provided function for every image-type output listed above can convert the raw data file to an image. pyFOORTInterferometry is another included Python module which can output visibility amplitudes based on FOORT data (see § 3.5 below). Specific parameters and options for the use of all diagnostics and terminations, as well as pyFOORT and pyFOORTInterferometry, are described in the extended documentation on the repository.
Adaptive mesh integration
FOORT features a specific adaptive mesh which allows high image resolutions to be achieved by efficiently choosing the geodesics to integrate. Our adaptive mesh algorithm starts by integrating an evenly spaced, square grid of pixels. Each pixel is then assigned a “weight”, based on how much the specified image feature changes in its nearby pixels. Based on all of these pixel weights, at each iteration the algorithm decides to divide the squares associated with pixels of the highest weights.
The tuneable parameters of the algorithm are the initial number of pixels to integrate, ; the maximum number of subdivisions that may be made, (the initial grid is considered to be the first subdivision, so necessarily ), the maximum number of pixels allowed to integrate (with necessarily ); and the number of pixels to subdivide each iteration, .
The algorithm can then be broken down into steps as follows:
Step 0. Integrate a square grid of pixels.
Note that the mesh algorithm creates a grid that is already the maximum possible size, i.e. . Pixel row and column coordinates then lie between and ; the initial grid is all pixels with coordinates for ; see Figure 7.

Figure 7. (left) The total grid generated for , has 25 pixels total. The initial pixels integrated in Step 0 are indicated in blue. (right) The grid with , after some number of integration iterations. The integrated pixels are indicated in blue. The neighbors of the dark blue central pixel are given by the arrows, and its “square” is given by the four pixels in the red dashed lines. Note that the dark blue pixel has .
Step 1. Calculate the “weight” of all pixels, i.e. a quantitative measure of how much a specified image feature changes in nearby pixels.
A particular diagnostic - i.e. those detailed in § 3.3 - is set as the mesh diagnostic in the FOORT configuration. This mesh diagnostic assigns a value to each geodesic at the end of its integration; this value can be a vector of real numbers of any size (determined by the particular diagnostic). Every diagnostic also specifies a way of determining a distance between such values. The weight of a pixel is then determined as the maximum of the distances between itself and its lower, right, and low-right neighbors — i.e. between itself and the other three pixels that define its “square” (see Figure 7).
For example, the diagnostic FourColorScreen assigns a number between 1 and 4 to each geodesic as its value, depending on which color has been assigned. The distance between two pixels is then the discrete metric, i.e. 0 if their colors are the same and 1 if they are different. Another example is the diagnostic GeodesicPosition: this assigns to a pixel as value the angular coordinates of the position of the geodesic at termination. The distance between two pixels is then the great-circle angle on the unit sphere between these two sets of coordinates.
Step 2. Order all pixels by their weight and select the highest-weight pixels.
Step 3. Subdivide the squares associated with all of these highest-weight pixels and integrate geodesics for these pixels.
Step 4. Go back to step 1 as long as the total number of geodesics integrated is still smaller than .
FOORT keeps track of all pixels and their properties in a specific struct. Every pixel keeps track of:
Its position on the screen (i.e. pixel coordinates);
Its weight;
Its subdivision level ( for the initial grid and for the finest level). A pixel at level has its right and lower neighbors at a distance of . The pixels on the rightmost column and bottom row are assigned ; they have no right or lower neighbors.
A pointer to the pixel
structof its right, lower, and lower-right neighbors; these are always at a distance governed by the pixel’s subdivision . Together with itself, these four pixels define the pixel’s own “square”; see Figure 7.A pointer to the pixel
structof its upper and left neighbor; these are solely defined as being reciprocal with respect to the right- and lower-neighbors. For example, pixel has as its left neighbor if has as its right neighbor; see Figure 7.
Having each pixel struct contain pointers to its neighbor structs allows efficient traversal of the grid around any given pixel when needed.
Emission models and interferometry
FOORT has the option to model an accretion disk in the spacetime of interest, serving as a light source whose photons are ray-traced to the observer. At the moment, the only emission model that is implemented is the GLMJohnsonSU model [8]. It describes a geometrically thin disk in the equatorial plane, with an intensity profile given by
where the parameters and control the peak and the width of the profile, whereas controls the skewness of the profile: a negative value makes the profile fall off rapidly at smaller radii, while maintaining a more gradual slope outside the peak radius. While this is a highly simplified, overly symmetric model for emission from an accretion disk, it has nevertheless proven useful to understand certain features of BH images and especially the BH photon rings [6, 7, 8, 33].7
The total brightness intensity for the geodesic is calculated as
In this expression, is the number of times the geodesic passes through the equatorial plane8 and is the geometric fudge factor used to mimic the effects of a geometrically thick disk: and . is the local intensity at the th point of passing ; is the redshift factor from the relative motion between the accretion disk fluid and an observer at infinity. The power of the redshift is set to 3 by default.9
In order to determine the redshift factor , we need to assume a model for the velocity of the emitting matter. The GeneralCircularRadialFluid model in FOORT allows for a mix of (sub)Keplerian circular orbits and radially infalling orbits. It takes three parameters: the sub-Keplerian parameter and the mixing parameters and , all in . The model is briefly summarized below, following Refs. [33, 57], and detailed further in App. § 9.
If the ISCO exists, it is first found using a bisection method. The conserved quantities associated with this ISCO are determined and saved. Then, to determine the equatorial fluid four-velocity at a given point (i.e., a point of passage of the geodesic through the equatorial plane), we expand it as
and proceed to find , , using the following procedure:
First, we determine the “circular velocity” vector at the point . The calculation depends on whether the radial coordinate of the point is in- or outside the ISCO, as detailed in App. § 9, and involves optional rescaling with the sub-Keplerian parameter .
The radial infall velocity vector is calculated at .
The final velocity vector is now calculated as a mix of the two above using the mixing parameters , as
where (31) follows from the normalization . It should be noted that, in general, the flow described by Eqs. (29)–(31) is not geodesic. With this model for the fluid velocity, the redshift factor can now be determined as
where represents the current velocity of the geodesic; the extra minus sign in the equation is necessary since is past-pointing (so is future-pointing).
The resulting intensity profile on the observer screen can be transformed to Fourier space in order to obtain the visibility — the quantity actually measured in VLBI experiments. The complex visibility is defined as
where denotes angular coordinates on the sky (in radians), measured from the center of the observer screen, and is the baseline projected onto the sky plane, in units of the observing wavelength. FOORT comes with a Python module, pyFOORTInterferometry, that contains functions to convert FOORT data into (normalized) visibility amplitudes . In practice, the projection-slice theorem is used to compute the visibility along a line in the Fourier plane that passes through the origin () at an angle measured counterclockwise with respect to the horizontal axis. To this end, the image is first projected onto the line through the image-plane origin at the same angle , i.e. its Radon transform is computed by integrating the intensity along lines perpendicular to that direction; this one-dimensional projection is then Fourier transformed.
The visibility can then be analyzed for universal signatures of the underlying spacetime, such as properties of the photon rings [6, 7]; in particular, the shape and slope of the visibility amplitude are determined by the photon rings and their properties. The dependence of these signatures on the compact-object spacetime can be efficiently explored and compared with FOORT without the need for expensive GRMHD simulations; of course, the visibility functions obtained with FOORT in this way, using a simplified emission model, do not reflect the complexity of realistic accretion disks.
Demonstrations & Applications
First of all, we verify that FOORT can reproduce an analytic BH shadow. As an example, Figure 6 compares the shadow, as extracted by FOORT, to the analytic prediction (see App. § 8.§ 2.1 for details) for a Kerr BH with spin . The zoomed-in panel demonstrates that FOORT reproduces the expected curve to the pixel level.
We continue by visualizing the Kerr spacetime with spin , as seen by an observer at inclination . We use the GLM model (25) with (the radial coordinate of the ISCO), , and . The fluid is assumed to be Keplerian (). The top row in Figure 8 shows — from left to right — the four-color screen, the emission, and the number of equatorial passes. The emission contains the expected photon ring, which can be linked to the geodesics that pass through the equatorial plane multiple times, as shown by the rightmost column.

Figure 8. From left to right, we show the four-color screen, the emission and the number of equatorial passes for (top) a Kerr BH with spin and (bottom) the Johannsen BH with the same spin and deviation parameter , as seen by an observer at inclination . The screen size is . These examples have moderate resolution, and are provided in the repository.
As an example, we also provide the same images for the Johannsen metric (A.9) with deviation parameter ; as the latter is rather large, the changes are clearly visible. Note that we kept the value of fixed to the Kerr ISCO, whereas the ISCO of this Johannsen BH is now ; this is automatically taken into account in FOORT.
Figure 9 shows visibility amplitudes associated with both emission images in Figure 8, extracted using the built-in functions in the FOORT repository. Given that the images were already visibly distinct, it is no surprise that the visibility amplitudes start deviating early on too. To obtain highly accurate results (at large baselines), these visibility amplitudes should be obtained from high-resolution versions of the images in Figure 8.10

Figure 9. Normalized visibility amplitudes associated with the emission images in Figure 8, along an angle of . The images were assumed to have a width of , i.e. an angular size of .
FOORT is specifically constructed to allow for ray-tracing more exotic metrics for objects that can either have horizons, singularities, or both. As an example, in Figure 10, we show ray-traced images of a Manko–Novikov BH (see App. § 8.2.3) and a so-called “ring fuzzball” (see App. § 8.§ 3). The Manko–Novikov BH can be seen as a multipole-deformed vacuum black hole and has a horizon which is partly singular. The fuzzball metric is a horizonless BH mimicker which is constructed in string theory as a smooth metric in higher dimensions; however, it consists of naked singularities in four dimensions.

Figure 10. Images of a Manko–Novikov BH (left) and a ring fuzzball (right). The Manko–Novikov BH has parameters and ; see App. § 8.2.3. The ring fuzzball has parameters , , ; see App. § 8.§ 3. Both are imaged at inclination and with emission parameters , , and with , (for Manko–Novikov) or , (for the fuzzball). Reproduced from Ref. [45].
Aside from analytical metrics, FOORT can also be used to ray-trace numerically obtained metrics, as long as they can be read in from files. An example is the solitonic boson star (BS) metric (see App. § 8.§ 4), which is sufficiently compact to have a pair of light rings. Figure 11, reproduced from Ref. [48], shows a comparison of this BS and a Schwarzschild BH of the same mass, where the emission is provided by an equatorial disk described by Eq. (25). The images are obtained with the Verlet scheme, for an observer located at areal radius in units where the mass of the boson star is . The image width in these units is in the same units, and uses 5 refinement levels. The insets focus on a region of , with 4 refinement levels. The disk parameters are fixed to , with the first value corresponding to , the radial coordinate of the ISCO in Schwarzschild spacetime: the ultracompact BS has a marginally stable circular orbit (MSCO) here, but it is not the ISCO, as circular orbits with are also stable. The fluid parameters are , corresponding to pure Keplerian orbits. Cunningham’s prescription (see App. § 9) is still applied from the MSCO inwards, as the intensity model (25) with the above parameters is approximately zero at these inner stable circular orbits. Due to the ultracompact nature of the BS, having a light ring at approximately the Schwarzschild value , the photon ring structure outside the critical curve matches that of the BH very well. Inside the critical curve, the absence of a horizon creates additional photon rings: this gives rise to low-frequency modulations in the visibility amplitude — see Ref. [49] for more details.

Figure 11. Side-by-side comparison of ray-traced images of a (left) Schwarzschild BH and (right) an ultracompact solitonic BS of the same ADM mass. Both panels also provide a zoom-in of the photon ring region, exhibiting their fractal structure. Reproduced from Ref. [48].
Conclusion
This paper presents FOORT, a highly flexible and modular ray-tracing code that is specifically designed to visualize spacetimes beyond the standard Kerr black hole. We have provided details on some of the numerical techniques FOORT implements, and demonstrated good scaling and convergence properties through various tests. Furthermore, we presented in detail its adaptive mesh algorithm, which can provide high resolution in regimes where any desired diagnostic changes sufficiently. Finally, we discussed the implementation of the GLM intensity model, as well as the generalized Keplerian fluid that we assume to source the emission.
We have showcased how FOORT can be used to image a variety of spacetimes, ranging from modified black holes to boson stars and fuzzballs, and how the accompanying Python packages can be used to do photon-ring interferometry.
There are numerous ways FOORT can be upgraded — which the authors explicitly encourage, in line with FOORT’s philosophy of flexibility and modularity. Emission models can be extended from FOORT’s current implementation of equatorial, geometrically thin disks, to handle e.g. volumetric radiative transfer or time-dependent sources. FOORT could also relatively easily be modified to keep track of photon polarization, or add source terms to the geodesic equation. More ambitious expansions could include implementing FOORT within frameworks exploiting parallelization beyond CPUs and the use of OpenMP.
Code availability
FOORT (version 1.0.0) [44] is publicly available at https://github.com/drmayerson/FOORT and free to use under the MIT license. Further documentation is provided in the repository.
Acknowledgments
We especially want to thank everyone who has tested FOORT in some capacity or contributed to various features: A. Cárdenas-Avendaño (for assistance in visibility amplitudes and the Python implementation of their generation), L. Van Dael (for implementing the fuzzball metric), P. Fernandes (for the Apple makefile, contributions to the Python plotting scripts, and testing/debugging various features related especially to Kerr-Schild coordinates), S. Giri (for the Arch makefile and testing/debugging various features).
Additionally, we would like to thank J. Davelaar, S. Gralla, T. Hertog, L. Küchler, T. Lemmens, T. Li, A. Lupsasca, O. McGloin, H. Olivares, H. Paugnat, B. Ripperda, B. Vercnocke for interesting discussions and earlier ray-tracing collaborations. D.R.M. acknowledges support from the IBOF grant IBOF/21/084, Leuven Gravity Institute grant TPU-E6297-Incubatiefinanciering Inst LGI, and FWO grant QPG-3E4102-HERTOG-FWO-PROJECT TEAM ET. S.J.S. is supported by the Centre for Doctoral Training at the University of Cambridge funded through STFC (ST/W006812/1, 2882538). F.B. acknowledges support from the FED-tWIN programme (profile Prf-2020-004, project “ENERGY”) issued by BELSPO, and from the FWO Junior Research Project G020224N granted by the Research Foundation – Flanders (FWO).. This work is also partially supported by the KU Leuven C1 grant C16/25/010. Computing resources were provided and supported by the VSC (Flemish Supercomputer Center), funded by the Research Foundation Flanders (FWO) and the Flemish Government – department EWI.
Implemented metrics
FOORT comes with several implemented BH metrics, as well as a fuzzball and boson star example. The modularity of the code makes it straightforward to add new metrics, as explained in the documentation. This appendix summarizes the spacetime metrics that are currently available.
As with the other FOORT configuration options, such as the diagnostics and terminations described in § 3.3, a detailed description of how to configure these metrics, their parameters, and options in practice is described in the extended documentation on the repository.
Flat space
As a baseline, FOORT has the Minkowski (flat space) metric implemented in the form
One can also choose to integrate the logarithmic radius .
Black holes
FOORT features a collection of BH metrics that inherit from a parent SphericalHorizonMetric class, which requires the existence of an event horizon at a fixed value of the radial coordinate .
Kerr
The Kerr metric is implemented in standard Boyer–Lindquist coordinates:
with
and the rotational parameter.
For the Kerr metric, the analytic expressions describing the critical curve are known: this is the separatrix on the observer’s screen between geodesics that fall into the event horizon and those that escape back to infinity, when ray-traced backwards [56]. We briefly list the expressions relevant to Figure 6 below — for more details, we refer the reader to e.g. Ref. [6].
The critical curve is parametrized11 by a range of Boyer–Lindquist radii given by
The impact parameters on the screen, for an observer at angle , are
given in terms of the conserved quantities associated with spherical geodesics at radii in the range ,
The metric is also implemented in Kerr–Schild coordinates12 obtained from the standard metric (A.2) through the coordinate transformations [59]
resulting in
Johannsen
The Johannsen metric is a stationary and axisymmetric generalization of the Kerr metric that keeps a Carter-like constant and thus separability of the geodesic equations [60]. We follow [11] in only keeping the first non-zero correction in the deviation functions, giving as metric
where
This new metric depends on four additional parameters with respect to Kerr: , , , and .
The Johannsen metric is asymptotically flat and reduces to Kerr when all deviation parameters , , , vanish. The event horizon of this BH is still the same as that of the Kerr metric, . Demanding regularity outside of the horizon restricts the parameters as
together with the requirement that
everywhere outside the horizon.
Manko–Novikov
The Manko–Novikov metric is constructed as a solution to the vacuum Einstein equations with arbitrary multipole moments [61]; it can be thought of as deforming the Kerr BH with (multipole) “bumps”. Uniqueness theorems imply the solution is singular; in particular, the event horizon is singular at the equator. The general form of the Manko–Novikov metric, in Boyer–Lindquist-type coordinates, is
The functions , are given by
where . The event horizon is at
The functions , , for a generic Manko–Novikov BH depend on an infinite series of multipole parameters. We follow [11] in only admitting an octopole-bump parameter ; when , the metric reduces to the Kerr BH. See App. A of [11] for the precise expressions of , , in this case.
Rasheed–Larsen
The Rasheed–Larsen BH can be obtained by a Kaluza–Klein reduction of five-dimensional Einstein gravity [62, 63], i.e. it is a solution to the four-dimensional Lagrangian
where is the Ricci scalar, is the dilaton field, and is associated with the electromagnetic gauge field . The Rasheed–Larsen BH is a solution to Eq. (A.16) given by
The functions , , , , and the 1-form are given by
The solution depends on four parameters , , , . These are related to the physical quantities of the metric: mass (), angular momentum (), and electric and magnetic charges ( and ) as
The event horizon of the Rasheed–Larsen BH is located at
which implies the bound . The other parameters need to satisfy , where equality corresponds to the vanishing of the electric and/or magnetic charges. The case corresponds to the chargeless Kerr limit (in which the mass is given by ).
Fuzzball
This is implemented as the ST3Cr metric in FOORT.13 This is the “ring fuzzball” introduced in [13], with metric given by
with
where the harmonic functions are given by:
Here, are the distances on the flat three-dimensional subspace spanned by to the “center” positions , which are located on the -axis at . We further have
where is the complete elliptical integral of the first kind,14 and
Finally, the rotation one-form is entirely defined by
with the Hodge dual on the three-dimensional flat space; for this metric, it follows that . The expression for in FOORT contains an explicit integral which comes from integrating (A.31) and makes this metric relatively computationally heavy to ray-trace.
The entire metric ultimately only depends on the parameters , , and ; roughly, and are related to electric and magnetic charges of the solution, and determines the “size” as well as its angular momentum. Note that these parameters cannot be chosen arbitrarily, since we must have that ; and moreover must hold as well for the scaling-limit () black hole to have a real horizon area.
This is the metric for a supersymmetric multicentered geometry or “fuzzball”; although it derives from well-behaved branes in higher dimensions, the four-dimensional metric has naked singularities at the centers on the -axis () as well as the “ring” in the plane at . In FOORT, this metric implements these singularities by descending from the SingularityMetric class which allows for singularities to be flagged in the metric. Note that the metric is axisymmetric as well as equatorially symmetric.
Solitonic boson star
Boson stars in GR are described by the action of a complex scalar field minimally coupled to gravity,
FOORT provides an example of a spherically symmetric BS where the potential takes the solitonic form
with the solitonic parameter . The solution is obtained by assuming the harmonic ansatz , where are the standard time and radial coordinates in a metric of the form
The frequency needs to be solved for, which is done with a shooting algorithm (not included in FOORT) that solves the system of differential equations governing the BS model, as described in, e.g., Ref. [64]. The example files in FOORT correspond to a ground-state model (no zero crossings in ) with central amplitude — as considered in e.g. Ref. [48]. This specific model is an example of an ultracompact BS, featuring a pair of light rings, one stable and one unstable. Two files are given, one containing and one containing where
The BS metric is implemented using cubic-spline interpolation following Ref. [65].
Expressions for the fluid velocity model
The fluid velocity model that is currently implemented in FOORT assumes a metric that is stationary, axisymmetric, reflection-symmetric about the equator, and circular, as well as written in coordinates adapted to circularity:
Stationarity and axisymmetry are assumed as are implicitly assumed to be conserved quantities for the fluid trajectory geodesics.
Equatorial-reflection symmetry is needed to ensure that geodesic trajectories confined to the equatorial plane exist.15
The fluid velocity model also assumes that the metric is diagonal in and and block-diagonal in (in particular, metric components such as must vanish). Circular metrics can always be written in such a form.
In addition, asymptotic flatness is assumed when calculating the radially infalling velocity (see below in App. § 9.§ 4).
Care must be taken when using this fluid velocity model on a metric that does not satisfy these constraints, as undefined and unphysical behavior may result. For example, using this fluid model on the Kerr–Schild form (A.8) of the Kerr metric (which e.g. has ) gives different (and wrong) emission compared to the Kerr metric. In certain cases (especially when e.g. equatorial symmetry is broken slightly), the fluid model can still give sensible results — see e.g. the Manko–Novikov picture of Figure 10.
Finding the ISCO
We briefly detail how the ISCO is determined in FOORT. We take it to be the outermost radius at which stable circular orbits (at larger radii) give way to unstable or non-existent ones (at smaller radii). For BHs such as Kerr this is the usual ISCO; for horizonless objects with an inner region of stable circular orbits, such as the BS of § 4, it is the outer marginally stable circular orbit (MSCO). The search is confined to the equatorial plane and to an interval 16 and proceeds as follows:
Check that a stable circular orbit exists at ; otherwise, no ISCO is determined.
Scan inward from in 200 equal steps until a radius is found without a stable circular orbit (i.e. the circular orbit is unstable, or no circular orbit exists). If there is no such radius, no ISCO is determined.
Bisect between this (unstable circular orbit) radius and the last stable orbit to further narrow down the ISCO location. We repeat the bisection until a specified tolerance is reached, or a maximal number of iterations has taken place.
A warning is printed if the result lies within 1% of the search interval of either bound.
Circular velocity outside the ISCO
Consider an equatorial, circular timelike geodesic with conserved momenta and , and , parametrized by . The radial geodesic equation reads
and a circular orbit at radius requires . Defining , , and , this condition becomes a quadratic equation for ,
where we select the root17 that maximizes while keeping the geodesic timelike, corresponding to prograde orbits when the angular momentum of the spacetime is positive.18 The four-velocity normalization then fixes the energy,
Thus, a timelike circular orbit exists at if and only if and the bracket above is positive. We end up with
and
To make this sub-Keplerian, we reduce the angular momentum with as . This then warrants a recalculation of [66].
Stability of circular geodesics
To assess the stability of the circular orbit, we perturb the radius, , keeping and fixed. To linear order, this gives
such that the orbit is stable if . The radial derivative is evaluated using finite differencing with a fourth-order central stencil.
Circular velocity inside the ISCO
We extend the circular flow smoothly inside the ISCO according to Cunningham’s prescription [67]. The conserved energy and angular momentum are assumed to be those of the geodesic associated with the ISCO; the four-velocity then requires a non-zero component for the radial momentum such that the normalization is satisfied. In the case that unstable circular orbits exist inside the ISCO, in particular, this means that the momentum given by the above prescription does not agree with that of the unstable circular geodesic.
If extending the flow in this way does not succeed, and a circular velocity cannot be found, FOORT sets the fluid velocity to be purely radially infalling. This can happen, e.g., for horizonless spacetimes, such as the BS, if Cunningham’s prescription is applied from an MSCO inwards (see § 4). Towards the center of the star, a centrifugal barrier is hit beyond which the conserved quantities of the MSCO do not allow for a circular-infalling velocity.
Radially infalling velocity
The fluid velocity for radially infalling particles is easily determined by relating it to a geodesic that is radially infalling from infinity, with zero initial velocity.19 For the latter, at infinity, we have
At a finite radius , the normalization implies that
where we leave the possibility for a -component in the metric. From the above, the expression for follows, where the negative sign makes the fluid infalling:
References
- [1]Event Horizon Telescope Collaboration, “First M87 Event Horizon Telescope Results. I. The Shadow of the Supermassive Black Hole”, The Astrophysical Journal 875, ADS Bibcode: 2019ApJ...875L...1E, L1 (2019) 10.3847/2041-8213/ab0ec7.DOI
- [2]Event Horizon Telescope Collaboration, “First Sagittarius A* Event Horizon Telescope Results. I. The Shadow of the Supermassive Black Hole in the Center of the Milky Way”, The Astrophysical Journal 930, ADS Bibcode: 2022ApJ...930L..12E, L12 (2022) 10.3847/2041-8213/ac6674.DOI
- [3]T. Do et al., “Relativistic redshift of the star S0-2 orbiting the Galactic center supermassive black hole”, Science 365, 664-668 (2019) 10 . 1126 / science . aav8137, arXiv:1907.10731 [astro-ph.GA].
- [4]R. Abuter et al. (GRAVITY), “Mass distribution in the Galactic Center based on interferometric astrometry of multiple stellar orbits”, Astron. Astrophys. 657, L12 (2022) 10.1051/0004-6361/202142465, arXiv:2112.07478 [astro-ph.GA].DOI
- [5]S. E. Gralla, “Can the EHT M87 results be used to test general relativity?”, Phys. Rev. D 103, 024023 (2021) 10.1103/PhysRevD.103.024023.DOI
- [6]A. Lupsasca et al., “A Beginner’s Guide to Black Hole Imaging and Associated Tests of General Relativity”, in Recent Progress on Gravity Tests. Challenges and Future Perspectives, edited by C. Bambi and A. Cardenas-Avendano (2024), pp. 183–237, 10.1007/978-981-97-2871-8_6, arXiv:2402.01290 [gr-qc].arxiv.org/abs/2402.01290
- [7]M. D. Johnson et al., “Universal interferometric signatures of a black hole’s photon ring”, Science advances 6, eaaz1310 (2020).DOI
- [8]S. E. Gralla et al., “The shape of the black hole photon ring: A precise test of strong-field general relativity”, en, Physical Review D 102, 124004 (2020) 10.1103/PhysRevD.102.124004.DOI
- [9]H. Paugnat et al., “Photon ring test of the Kerr hypothesis: Variation in the ring shape”, Astron. Astrophys. 668, A11 (2022) 10.1051/0004-6361/202244216, arXiv:2206.02781 [astro-ph.HE].DOI
- [10]A. Lupsasca et al., “The Black Hole Explorer: photon ring science, detection, and shape measurement”, Proc. SPIE Int. Soc. Opt. Eng. 13092, 130926Q (2024) 10.1117/12.3019437, arXiv:2406.09498 [gr-qc].DOI
- [11]S. Staelens et al., “Black hole photon rings beyond general relativity”, Phys. Rev. D 107, 124026 (2023) 10.1103/PhysRevD.107.124026.DOI
- [12]R. Carballo-Rubio et al., “Nonminimal light-curvature couplings and black-hole imaging”, Phys. Rev. D 112, 103016 (2025) 10 . 1103 / pxpm - 8dgy, arXiv:2505 . 21431 [astro-ph.HE].
- [13]F. Bacchini et al., “Fuzzball Shadows: Emergent Horizons from Microstructure”, en, Physical Review Letters 127, 171601 (2021) 10.1103/PhysRevLett.127.171601.DOI
- [14]F. H. Vincent et al., “Imaging a boson star at the Galactic center”, Classical and Quantum Gravity 33, 105015 (2016) 10.1088/0264-9381/33/10/105015.DOI
- [15]P. V. P. Cunha et al., “Shadows of kerr black holes with scalar hair”, Phys. Rev. Lett. 115, 211102 (2015) 10.1103/PhysRevLett.115.211102.DOI
- [16]P. V. P. Cunha et al., “Chaotic lensing around boson stars and kerr black holes with scalar hair”, Phys. Rev. D 94, 104023 (2016) 10.1103/PhysRevD.94.104023.DOI
- [17]J. L. Rosa et al., “Imaging compact boson stars with hot spots and thin accretion disks”, Phys. Rev. D 108, 044021 (2023) 10.1103/PhysRevD.108.044021.DOI
- [18]Y.-X. Gao, “Higher-order inner photon rings of a horizonless ultracompact object with an antiphoton sphere and their interferometric pattern”, Chin. Phys. C 49, 105102 (2025) 10.1088/1674-1137/adcc52, arXiv:2504.16719 [gr-qc].arxiv.org/abs/2504.16719
- [19]D. Ayzenberg et al., “Fundamental physics opportunities with the next-generation Event Horizon Telescope”, Living Rev. Rel. 28, [Erratum: Living Rev.Rel. 28, 7 (2025)], 4 (2025) 10.1007/s41114-025-00057-0, arXiv:2312.02130 [astro-ph.HE].arxiv.org/abs/2312.02130
- [20]A. Eichhorn and A. Held, “From a locality-principle for new physics to image features of regular spinning black holes with disks”, JCAP 05, 073 (2021) 10.1088/1475-7516/2021/05/073, arXiv:2103.13163 [gr-qc].DOI
- [21]A. Eichhorn et al., “Universal signatures of singularity-resolving physics in photon rings of black holes and horizonless objects”, JCAP 01, 043 (2023) 10.1088/1475-7516/2023/01/043, arXiv:2204.02429 [gr-qc].DOI
- [22]H. Olivares et al., “How to tell an accreting boson star from a black hole”, Mon. Not. Roy. Astron. Soc. 497, 521–535 (2020) 10.1093/mnras/staa1878, arXiv:1809.08682 [gr-qc].DOI
- [23]V. Jaramillo et al., “The imitation game (r)evolutions: Q-star effective shadow from GRMHD analysis”, JCAP 05, 100 (2026) 10.1088/1475-7516/2026/05/100, arXiv:2603.16995 [gr-qc].arxiv.org/abs/2603.16995
- [24]A. E. Broderick et al., “The Photon Ring in M87*”, Astrophys. J. 935, 61 (2022) 10.3847/1538-4357/ac7c1d, arXiv:2208.09004 [astro-ph.HE].DOI
- [25]W. Lockhart and S. E. Gralla, “How narrow is the M87* ring? I. The choice of closure likelihood function”, Mon. Not. Roy. Astron. Soc. 509, 3643–3659 (2021) 10.1093/mnras/stab3204, arXiv:2107.06948 [astro-ph.HE].DOI
- [26]W. Lockhart and S. E. Gralla, “How narrow is the M87* ring – II. A new geometric model”, Mon. Not. Roy. Astron. Soc. 517, 2462–2470 (2022) 10.1093/mnras/stac2743, arXiv:2208.09989 [astro-ph.HE].DOI
- [27]M. D. Johnson et al., “The Black Hole Explorer: motivation and vision”, in Space telescopes and instrumentation 2024: optical, infrared, and millimeter wave, Vol. 13092, edited by L. E. Coyle et al. (International Society for Optics and Photonics, 2024), p. 130922D, 10.1117/12.3019835.DOI
- [28]S.-S. Zhao et al., “Beyond Sgr A* and M87*: Sub-Microarcsecond Black Hole Shadow Detection via Lunar-based Extremely Long Baseline Interferometry”, Mon. Not. Roy. Astron. Soc. 551 (2026) 10.1093/mnras/stag1580, arXiv:2601.02812 [astro-ph.GA].DOI
- [29]R. Gold et al. (Event Horizon Telescope), “Verification of Radiative Transfer Schemes for the EHT”, Astrophys. J. 897, 148 (2020) 10.3847/1538-4357/ab96c6.DOI
- [30]M. Moscibrodzka and C. F. Gammie, “ipole – semi-analytic scheme for relativistic polarized radiative transport”, Mon. Not. Roy. Astron. Soc. 475, 43–54 (2018) 10.1093/mnras/stx3162, arXiv:1712.03057 [astro-ph.HE].arxiv.org/abs/1712.03057
- [31]Z. Gelles et al., “The Role of Adaptive Ray Tracing in Analyzing Black Hole Structure”, Astrophys. J. 912, 39 (2021) 10.3847/1538-4357/abee13, arXiv:2103.07417 [astro-ph.HE].DOI
- [32]C. J. White, “Blacklight: A General-relativistic Ray-tracing and Analysis Tool”, Astrophys. J. Supp. 262, 28 (2022) 10.3847/1538-4365/ac77ef, arXiv:2203.15963 [astro-ph.HE].DOI
- [33]A. Cárdenas-Avendaño et al., “Adaptive analytical ray tracing of black hole photon rings”, Phys. Rev. D 107, 043030 (2023) 10.1103/PhysRevD.107.043030, arXiv:2211.07469 [gr-qc].
- [34]J. Dexter and E. Agol, “A Fast New Public Code for Computing Photon Orbits in a Kerr Spacetime”, Astrophys. J. 696, 1616–1629 (2009) 10.1088/0004-637X/696/2/1616, arXiv:0903.0620 [astro-ph.HE].DOI
- [35]J. Dexter, “A public code for general relativistic, polarised radiative transfer around spinning black holes”, Mon. Not. Roy. Astron. Soc. 462, 115–136 (2016) 10.1093/mnras/stw1526, arXiv:1602.03184 [astro-ph.HE].DOI
- [36]F. H. Vincent et al., “GYOTO: a new general relativistic ray-tracing code”, Class. Quant. Grav. 28, 225011 (2011) 10.1088/0264-9381/28/22/225011, arXiv:1109.4769 [gr-qc].DOI
- [37]T. Bronzwaer et al., “RAPTOR-I. time-dependent radiative transfer in arbitrary space-times”, Astronomy & Astrophysics 613, A2 (2018).DOI
- [38]Z. Younsi et al., “Modelling the polarised emission from black holes on event horizon-scales”, IAU Symp. 342, 9–12 (2020) 10.1017/S1743921318007263, arXiv:1907.09196 [astro-ph.HE].DOI
- [39]P. Pihajoki et al., “General purpose ray-tracing and polarized radiative transfer in General Relativity”, Astrophys. J. 863, 8 (2018) 10.3847/1538-4357/aacea0, arXiv:1804.04670 [astro-ph.HE].DOI
- [40]A. Sharma et al., “Mahakala: A Python-based Modular Ray-tracing and Radiative Transfer Algorithm for Curved Spacetimes”, Astrophys. J. 985, 40 (2025) 10.3847/1538-4357/ad c104, arXiv:2304.03804 [astro-ph.HE].arxiv.org/abs/2304.03804
- [41]P. Christian and C.-K. Chan, “FANTASY: User-Friendly Symplectic Geodesic Integrator for Arbitrary Metrics with Automatic Differentiation”, Astrophys. J. 909, 67 (2021) 10.3847/1538-4357/abdc28, arXiv:2010.02237 [gr-qc].DOI
- [42]F. J. E. Baker and A. J. Young, “GRADUS.JL: spacetime-agnostic general relativistic ray-tracing for X-ray spectral modelling”, Mon. Not. Roy. Astron. Soc. 545, staf1770 (2025) 10.1093/mnras/staf1770, arXiv:2510.15049 [astro-ph.HE].DOI
- [43]D. F. Bambague and A. Larrañaga, “TARTARUS: A High-Performance Python Code for Ray Tracing in Curved Spacetimes”, (2026), arXiv:2609.08988 [gr-qc].
- [44]D. R. Mayerson et al., FOORT: Flexible Object-Oriented Ray Tracing, version 1.0.0, Nov. 2026, 10.5281/zenodo.24132984.arxiv.org/abs/2611.15331
- [45]D. R. Mayerson and B. Vercnocke, Observational opportunities for the fuzzball program, 2023, arXiv:2306.01565 [hep-th].arxiv.org/abs/2306.01565
- [46]P. G. S. Fernandes et al., “Shadows and properties of spin-induced scalarized black holes with and without a ricci coupling”, Phys. Rev. D 109, 104033 (2024) 10.1103/PhysRevD.109.104033.DOI
- [47]P. G. S. Fernandes and V. Cardoso, “Spinning Black Holes in Astrophysical Environments”, Phys. Rev. Lett. 135, 211403 (2025) 10.1103/9shv-5d21, arXiv:2507.04389 [gr-qc].DOI
- [48]G. A. Marks et al., “Long-Term Stable Nonlinear Evolutions of Ultracompact Black-Hole Mimickers”, Phys. Rev. Lett. 135, 131402 (2025) 10.1103/1k48-7r2f, arXiv:2504.17775 [gr-qc].DOI
- [49]S. J. Staelens and E. Alkan, “Ray tracing ultracompact boson stars: visibility modulations and incomplete photon rings”, (2026), arXiv:2606.30729 [gr-qc].arxiv.org/abs/2606.30729
- [50]N. Mehta and B. Ripperda, “Visualizing black holes and wormholes through raytracing”, Journal of Emerging Investigators 8 (2025) 10.59720/24–074.
- [51]J. C. Dolence et al., “Grmonty: a monte carlo code for relativistic radiative transport”, The Astrophysical Journal Supplement Series 184, 387 (2009) 10.1088/0067-0049/184/2/387.DOI
- [52]F. Bacchini et al., “Generalized, energy-conserving numerical simulations of particles in general relativity. i. time-like and null geodesics”, The Astrophysical Journal Supplement Series 237, 6 (2018) 10.3847/1538-4365/aac9ca.DOI
- [53]E. Hairer et al., Geometric numerical integration: structure-preserving algorithms for ordinary differential equations, Springer Series in Computational Mathematics (Springer Berlin Heidelberg, 2006).
- [54]S. C. Noble et al., “Simulating the emission and outflows from accretion discs”, Classical and Quantum Gravity 24, S259–S274 (2007) 10.1088/0264-9381/24/12/S17, arXiv:astro-ph/0701778 [astro-ph].DOI
- [55]T. Müller, “Einstein rings as a tool for estimating distances and the mass of a schwarzschild black hole”, Physical Review D—Particles, Fields, Gravitation, and Cosmology 77, 124042 (2008).DOI
- [56]J. M. Bardeen, “Timelike and null geodesics in the Kerr metric”, in Black Holes (Les Astres Occlus), edited by C. DeWitt and B. S. DeWitt (1973), pp. 215–240.
- [57]H.-Y. Pu et al., “The effects of accretion flow dynamics on the black hole shadow of Sagittarius a*”, The Astrophysical Journal 831, 4 (2016) 10.3847/0004-637X/831/1/4.DOI
- [58]M. Visser, “The Kerr spacetime: A Brief introduction”, in Kerr Fest: Black Holes in Astrophysics, General Relativity and Quantum Gravity (June 2007), arXiv:0706.0622 [gr-qc].arxiv.org/abs/0706.0622
- [59]P. Papadopoulos and J. A. Font, “Relativistic hydrodynamics around black holes and horizon adapted coordinate systems”, Phys. Rev. D 58, 024005 (1998) 10. 1103/PhysRevD.58.024005.DOI
- [60]T. Johannsen, “Regular black hole metric with three constants of motion”, Physical Review D 88, 044002 (2013).DOI
- [61]V. Manko and I. Novikov, “Generalizations of the Kerr and Kerr-Newman metrics possessing an arbitrary set of mass-multipole moments”, Classical and Quantum Gravity 9, 2477 (1992).DOI
- [62]D. Rasheed, “The Rotating dyonic black holes of Kaluza-Klein theory”, Nucl. Phys. B 454, 379–401 (1995) 10.1016/0550-3213(95)00396-A, arXiv:hep-th/9505038.DOI
- [63]F. Larsen, “Rotating kaluza–klein black holes”, Nuclear Physics B 575, 211–230 (2000).DOI
- [64]T. Helfer et al., “Malaise and remedy of binary boson-star initial data”, Class. Quant. Grav. 39, 074001 (2022) 10.1088/1361-6382/ac53b7, arXiv:2108.11995 [gr-qc].DOI
- [65]T. Kluge, C++ cubic spline interpolation, URL: https://github.com/ttk592/spline/tree/master, 2021.
- [66]R. F. Penna et al., “A new equilibrium torus solution and GRMHD initial conditions”, Astron. Astrophys. 559, A116 (2013) 10.1051/0004-6361/201219666, arXiv:1309.3680 [astro-ph.HE].DOI
- [67]C. T. Cunningham, “The effects of redshifts and focusing on the spectrum of an accretion disk around a Kerr black hole.”, Astrophysical Journal 202, 788–802 (1975) 10.1086/154033.DOI

