Thorn IDAxiBrillBH provides analytic initial data for a vacuum black hole spacetime: a single Schwarzschild black hole in isotropic coordinates plus Brill wave. This initial data is provided for ADMBase 3-metric and extrinsic curvature, and optionally also for the StaticConformal conformal factor and its 1st and 2nd spatial derivatives.
The pioneer, Bernstein, studied a single black hole which is non-rotating and distorted in azimuthal line symmetry of 2 dimensional case [1]. In this non-rotating case, one chooses the condition, \(K_{ij} = 0\), and \begin {equation} \gamma _{ab} = \psi ^4 \hat \gamma _{ab}, \end {equation} where \(\gamma _{ab}\) is the physical three metric and \(\hat {\gamma }_{ab}\) is some chosen conformal three metric.
The Hamiltonian constraint reduces to \begin {equation} \hat \Delta \psi = \frac {1}{8}\psi \hat R, \label {IDAxiBrillBH/eqn:conformal-hamiltonian} \end {equation} where \(\hat \Delta \) is the covariant Laplacian and \(\hat R\) is the Ricci tensor for the conformal three metric. This form allows us to choose an arbitrary conformal three metric, and then solve an elliptic equation for the conformal factor, therefore satisfying the constraint equations (\(K_{ij} = 0\) trivially satisfies the momentum constraints in vacuum). This approach was used to create “Brill waves” in a spacetime without black holes [2]. Bernstein extended this to the black hole spacetime. Using spherical-polar coordinates, one can write the 3-metric, \begin {equation} \label {IDAxiBrillBH/eqn:sph-coord} ds^2 = \psi ^4 (e^{2q} (dr^2 + r^2 d \theta ^2) + r^2 \sin \theta d \phi ^2), \end {equation} where \(q\) is the Brill “packet” which takes some functional form. Using this ansatz with (??) leads to an elliptic equation for \(\psi \) which must be solved numerically. Applying the isometry condition on \(\psi \) at a finite radius, and applying \(M/2r\) falloff conditions on \(\psi \) at the outer boundary (the “Robin” condition), along with a packet which obeys the appropriate symmetries (including being invariant under the isometry operator), will make this solution describe a black hole with an incident gravitational wave. The choice of \(q=0\) produces the Schwarzschild solution. The typical \(q\) function used in axisymmetry, and considered here in the non-rotating case, is \begin {equation} \label {IDAxiBrillBH/eqn:Q} q = Q_0 \sin ^n \theta \left [ \exp \left (\frac {\eta - \eta _0^2}{\sigma ^2}\right ) + \exp \left (\frac {\eta + \eta _0^2}{\sigma ^2}\right ) \right ]. \end {equation} Note regularity along the axis requires that the exponent \(n\) must be even. Choosing a logarithmic radial coordinate \begin {equation} \label {IDAxiBrillBH/eta-coord} \eta = \ln {\frac {2r}{m}}. \end {equation} (where \(m\) is a scale parameter), one can rewrite (??) as \begin {equation} ds^2 = \psi (\eta )^4 [ e^{2 q} (d \eta ^2 + d\theta ^2) + \sin ^2 \theta d\phi ^2]. \end {equation}
The scale parameter \(m\) is equal to the mass of the Schwarzschild black hole, if \(q=0\). In this coordinate, the 3-metric is \begin {equation} \label {IDAxiBrillBH/eqn:metric-brill-eta} ds^2 = \tilde {\psi }^4 (e^{2q} (d\eta ^2+d\theta ^2)+\sin ^2 \theta d\phi ^2), \end {equation} and the Schwarzschild solution is \begin {equation} \label {IDAxiBrillBH/eqn:psi} \tilde {\psi } = \sqrt {2M} \cosh (\frac {\eta }{2}). \end {equation} We also change the notation of \(\psi \) for the conformal factor is same as \(\tilde {\psi }\) [3], for the \(\eta \) coordinate has the factor \(r^{1/2}\) in the conformal factor. Clearly \(\psi (\eta )\) and \(\psi \) differ by a factor of \(\sqrt {r}\). The Hamiltonian constraint is \begin {equation} \label {IDAxiBrillBH/eqn:ham} \frac {\partial ^2 \tilde {\psi }}{\partial \eta ^2} + \frac {\partial ^2 \tilde {\psi }}{\partial \theta ^2} + \cot \theta \frac {\partial \tilde {\psi }}{\partial \theta } = - \frac {1}{4} \tilde {\psi } (\frac {\partial ^2 q}{\partial \eta ^2} + \frac {\partial ^2 q}{\partial \theta ^2} -1). \end {equation}
For solving this Hamiltonian constraint numerically. At first we substitute
to the equation (??), then we can linearize it as \begin {equation} \frac {\partial ^2 \delta \tilde {\psi }}{\partial \eta ^2} + \frac {\partial ^2 \delta \tilde {\psi }}{\partial \theta ^2} + \cot \theta \frac {\partial \delta \tilde {\psi }}{\partial \theta } = - \frac {1}{4} (\delta \tilde {\psi } + \tilde {\psi }_0) (\frac {\partial ^2 q}{\partial \eta ^2} + \frac {\partial ^2 q}{\partial \theta ^2} -1). \label {IDAxiBrillBH/eqn:ham-linear} \end {equation} For the boundary conditions, we use for the inner boundary condition an isometry condition: \begin {equation} \frac {\partial \tilde {\psi }}{\partial \eta }|_{\eta = 0} = 0, \label {IDAxiBrillBH/eqn:isometry-inner-BC} \end {equation} and outer boundary condition, a Robin condition: \begin {equation} (\frac {\partial \tilde {\psi }}{\partial \eta } + \frac {1}{2} \tilde {\psi })|_{\eta =\eta _{max}} = 0. \end {equation}
This thorn normalizes things so that if there is no perturbation, it produces a Schwarzschild (\(=\) Brill-Lindquist) slice of the \(m=2\) Schwarzschild spacetime.^{1} You can’t change this mass. :(
In any case (perturbation or not), this thorn also reports an ADM mass for the slice. This seems to be pretty reliable.
This thorn solves equation (??) on a 2-D \((\eta ,\theta )\) grid. However, Cactus needs a 3-D grid, typically with Cartesian coordinates. Therefore, this thorn interpolates \(\psi \) and its \((\eta ,\theta )\) derivatives to the Cartesian grid. More precisely, for each Cactus grid point, this thorn calculates the corresponding \((\eta ,\theta )\) coordinates, and interpolates the 2-D solution to that point.
Because of the isometry condition (??), the 2-D grid need only cover the region \(\eta \ge 0\); the code just takes the absolute value of \(\eta \) before interpolating.
The 2-D grid covers the region \(|\eta | \in [0,\code {etamax}]\), \(\theta \in [0,\pi ]\), where the parameter etamax defaults to 5. If any 3-D grid point’s \((|\eta |,\theta )\) is outside this 2-D grid, this thorn will abort with a fatal error message from the interpolator. In practice, the most common cause of such an out-of-range point is the 3-D grid having a grid point at, or very near to, the origin. For example:
WARNING level 1 in thorn AEILocalInterp processor 0 host ic0087 (line 1007 of /nfs/nethome/pollney/runs/CactusDev/arrangements/AEIThorns/AEILocalInterp/src /Lagrange-tensor-product/../template.c): -> CCTK_InterpLocalUniform(): interpolation point is either outside the grid, or inside but too close to the grid boundary! 0-origin interpolation point number pt=307062 of N_interp_points=614125 interpolation point (x,y)=(36.1875,0.955317) grid x_min(delta_x)x_max = -0.0199336(0.0199336)6.01993 grid y_min(delta_y)y_max = -0.0290888(0.0581776)3.17068 WARNING level 0 in thorn IDAxiBrillBH processor 0 host ic0087 (line 484 of IDAxiBrillBH.F): -> error in interpolator: ierror= -1002
Here the 3-D grid had a point right at the origin (which by virtue of (??) would have given \(\eta = -\infty \)), but some software moved the grid point by \(10^{-16}m\) or so (the standard Cactus work-around to try to avoid divisions by zero), giving \(\eta \equiv \ln (2 \,{\times }\, 10^{-16}) \approx -36\). The absolute value of this is the “\(x\)” coordinate the interpolator is complaining about.
In an ideal world, someone would enhance IDAxiBrillBH so it could handle a grid point at (or very near to) the origin.^{2} However, so far noone has volunteered to do this.
In the meantime, a staggered grid is the “standard” work-around for this problem.
The parameters neta and nq specify the resolution of this thorn’s 2-D grid in \(\eta \) and \(\theta \) respectively.^{3} The default values are a reasonable starting point, but you may need to increase them substantially if you need very high accuracy (very small constraint violations).
To help judge what resolution may be needed, this thorn has an option to write out \(\psi (\eta )\) and \(\psi \) on the 2-D grid to an ASCII data file where it can be examined and/or plotted. To do this, set the Boolean parameter output_psi2D, and possibly also the string parameter output_psi2D_file_name.
This thorn uses the standard Cactus CCTK_InterpLocalUniform() local interpolation system for this interpolation. The interpolation operator is specified with the interpolator_name parameter (this defaults to "uniform cartesian", the interpolation operator provided by thorn CactusBase/LocalInterp).
The interpolation order and/or other parameters can be specified in either of two ways:^{4}
The integer parameter interpolation_order may be used directly to specify the interpolation order.
More generally, the string parameter interpolator_pars may be set to any nonempty string (it defaults to the empty string). If this is done, this parameter overrides interpolation_order, and explicitly specifies a parameter string for the interpolator.
Note that the default interpolator parameters specify linear interpolation. This is rather inaccurate, and (due to aliasing effects between the 2-D and 3-D grids) will give a fair bit of noise in the metric components. You may want to specify a higher-order interpolator to reduce this noise.
For example, for one test series where I (JT) needed very accurate initial data (I wanted the initial-data errors to be much less than the errors from 4th order finite differencing on the 3-D Cactus grid), I had to use a resolution of \(1000\) in \(\eta \) and \(2000\) in \(\theta \), together with either 4th order Lagrange or 3rd order Hermite interpolation (provided by thorn AEIThorns/AEILocalInterp) to get sufficient accuracy.
One problem with such high resolutions is that IDAxiBrillBH uses an internal multigrid solver which allocates local arrays on the stack, whose size depends on the \(\eta \) and \(\theta \) resolutions. For high resolutions these arrays may exceed system- and/or shell-imposed limits on the maximum stack size, causing the code to crash (core-dump). In an ideal world, someone would fix the offending code to allocate large arrays on the heap. Unless/until that happens, you can either use lower resolution :(, or try raising the operating-system and/or shell stack-size limits. For example, using tcsh the shell command limit shows the current limits, and limit stacksize unlimited raises your limit to as much as the operating system will allow. Using bash the corresponding commands are ulimit -a and ulimit -s unlimited.
By default, IDAxiBrillBH generates initial data which uses a nontrivial static conformal factor (as defined by thorn StaticConformal). This initial data includes both the conformal factor and its 1st and 2nd spatial derivatives, so IDAxiBrillBH sets conformal_state to 3.
However, if the Boolean parameter generate_StaticConformal_metric is set to false, then IDAxiBrillBH generates a pure physical 3-metric (and sets conformal_state to 0). This is useful if you have other thorns which don’t grok a conformal metric.
This thorn has options to print very detailed debugging information about internal quantities at selected grid points. This is enabled by setting the integer parameter debug to a positive value (the default is \(0\), which means no debugging output). See param.ccl and the source code src/IDAxiBrillBH.F for details.
[1] D. Bernstein, Ph.D thesis University of Illinois Urbana-Champaign, (1993)
[2] D. S. Brill,Ann. Phys.7, 466 (1959)
[3] K. Camarda, Ph.D thesis University of Illinois Urbana-Champaign, (1998)
amp | Scope: private | REAL |
Description: Brill wave amplitude
| ||
Range | Default: 0.1 | |
*:* | No restriction
| |
debug | Scope: private | INT |
Description: level of debugging information to print (0 = none, 2 = a little, 6 = a lot, 10 = huge
amounts)
| ||
Range | Default: (none) | |
0:* | any integer >= 0
| |
debug_i | Scope: private | INT |
Description: i coordinate for per-grid-point debug printing
| ||
Range | Default: 14 | |
*:* | any integer
| |
debug_ii | Scope: private | INT |
Description: i coordinate for per-2D-grid-point debug printing
| ||
Range | Default: 14 | |
*:* | any integer
| |
debug_j | Scope: private | INT |
Description: j coordinate for per-grid-point debug printing
| ||
Range | Default: 15 | |
*:* | any integer
| |
debug_jj | Scope: private | INT |
Description: j coordinate for per-2D-grid-point debug printing
| ||
Range | Default: 15 | |
*:* | any integer
| |
debug_k | Scope: private | INT |
Description: k coordinate for per-grid-point debug printing
| ||
Range | Default: 10 | |
*:* | any integer
| |
error_tolerance | Scope: private | REAL |
Description: tolerance parameter for elliptic solver
| ||
Range | Default: 1.0e-12 | |
(0:* | any positive real number
| |
eta0 | Scope: private | REAL |
Description: Brill wave center (in eta coords)
| ||
Range | Default: 0.0 | |
*:* | No restriction
| |
etamax | Scope: private | REAL |
Description: eta value for outer edge of grid
| ||
Range | Default: 5.0 | |
*:* | No restriction
| |
generate_staticconformal_metric | Scope: private | BOOLEAN |
Description: should we generate a StaticConformal conformal metric (true), or a pure ADMBase
physical metric (false)
| ||
Default: true | ||
interpolation_order | Scope: private | INT |
Description: Order for interpolation
| ||
Range | Default: 1 | |
0:9 | any integer accepted by the interpolator
| |
interpolator_name | Scope: private | STRING |
Description: name of CCTK_InterpLocalUniform() interpolation operator
| ||
Range | Default: uniform cartesian | |
.* | any string
| |
interpolator_pars | Scope: private | STRING |
Description: parameters for the interpolation operator
| ||
Range | Default: (none) | |
.* | ”any nonempty string acceptable to Util_TableSetFromStr ing() and
to the interpolator, or the empty string to use ’order=n’, where n is
specified by the interpolation_order parameter”
| |
n | Scope: private | INT |
Description: sin theta in Brill wave
| ||
Range | Default: 2 | |
*:* | No restriction
| |
ne | Scope: private | INT |
Description: eta resolution for solve
| ||
Range | Default: 300 | |
*:* | No restriction
| |
nq | Scope: private | INT |
Description: theta resolution for solve
| ||
Range | Default: 50 | |
*:* | No restriction
| |
output_psi2d | Scope: private | BOOLEAN |
Description: should we output the conformal factor psi on the 2D grid?
| ||
Default: false | ||
output_psi2d_file_name | Scope: private | STRING |
Description: if we output the conformal factor psi on the 2D grid, what file name should we use
for the output file?
| ||
Range | Default: psi2D.dat | |
.+ | any non-empty string that’s a valid file name
| |
sigma | Scope: private | REAL |
Description: Brill wave width (in eta)
| ||
Range | Default: 1.0 | |
*:* | No restriction
| |
initial_data | Scope: shared from ADMBASE | KEYWORD |
Extends ranges:
| ||
axibrillbh | Axisymmetry Initial data for Black hole + Brill wave
| |
initial_lapse | Scope: shared from ADMBASE | KEYWORD |
Extends ranges:
| ||
schwarz | Set lapse to Schwarzschild
| |
metric_type | Scope: shared from ADMBASE | KEYWORD |
Implements:
idaxibrillbh
Inherits:
admbase
grid
staticconformal
This section lists all the variables which are assigned storage by thorn EinsteinInitialData/IDAxiBrillBH. Storage can either last for the duration of the run (Always means that if this thorn is activated storage will be assigned, Conditional means that if this thorn is activated storage will be assigned for the duration of the run if some condition is met), or can be turned on for the duration of a schedule function.
NONE
CCTK_PARAMCHECK (conditional)
idaxibrillbh_paramchecker
check that the metric_type is recognised
Language: | c | |
Options: | global | |
Type: | function | |
ADMBase_InitialData (conditional)
idaxibrillbh
construct idaxibrillbh
Language: | fortran | |
Reads: | grid::coordinates(everywhere) | |
Storage: | staticconformal::confac | |
staticconformal::confac_1derivs | ||
staticconformal::confac_2derivs | ||
Type: | function | |
Writes: | admbase::metric(everywhere) | |
admbase::curv(everywhere) | ||
admbase::lapse(everywhere) | ||
admbase::shift(everywhere) | ||
staticconformal::confac(everywhere) | ||
staticconformal::confac_1derivs(everywhere) | ||
staticconformal::confac_2derivs(everywhere) | ||
staticconformal::conformal_state(everywhere) | ||