To set up Kerr-Schild initial data, with a shifted radial coordinate.
A complete description of a black hole spacetime in Kerr-Schild spherical polar coordinates that includes an explicit analytic form of the extrinsic curvature for arbitrary spin parameters does not exist in the literature, so we first include it here for completeness. Then we present our strategy for transforming spacetime quantities into shifted Kerr-Schild Cartesian coordinates.
In unshifted spherical polar coordinates, where , is the black hole mass, and is the black hole spin parameter, the Kerr-Schild lapse, shift, and 3-metric are given by
Next, we define a few useful quantities,
Then the extrinsic curvature (see, e.g., Eq. 13 in Ref. [1]) with , may be written in spherical polar coordinates as
All GiRaFFE curved-spacetime code validation tests adopt shifted Kerr-Schild Cartesian coordinates , which map to the finite radius in standard (unshifted) Kerr-Schild spherical polar coordinates. So, in many ways, this is similar to a trumpet spacetime. Though this radial shift acts to shrink the black hole’s coordinate size, it also renders the very strongly-curved spacetime fields at to vanish deep inside the horizon, which can contribute to numerical stability when evolving hydrodynamic, MHD, and FFE fields inside the horizon.
The shifted radial coordinate relates to the standard spherical polar radial coordinate via , where is the (constant) radial shift.
As an example, to compute at some arbitrary point , we first convert the coordinate into shifted spherical-polar coordinates via , as a purely radial shift like this preserves the original angles. Next, we evaluate the components of the Kerr-Schild extrinsic curvature (provided above) in standard spherical polar coordinates at . Defining as the th shifted spherical polar coordinate and as the th (unshifted) spherical polar coordinate, is computed via the standard coordinate transformations:
(18) |
However, we have , since the radial shift is a constant and the angles are unaffected by the radial shift. This implies that and .
So after computing any spacetime quantity at a point , we need only apply the standard spherical-to-Cartesian coordinate transformation to evaluate that quantity in shifted Cartesian coordinates.
ShiftedKerrSchild defines the following parameters for the constants defined in section 2:
parameter name | constant |
KerrSchild_radial_shift | , |
BH_mass | , |
BH_spin | . |
This thorn is part of the Einstein Toolkit and included in the WVUThorns arrangement.
This thorn sets up initial data for use by thorn ADMBase based on ADMBase’s parameters initial_data, initial_lapse and initial_shift.
For a complete example, please see the GiRaFFE test GiRaFFE_tests_MagnetoWald.par.
# Shifted KerrSchild ActiveThorns = "ShiftedKerrSchild" ShiftedKerrSchild::BH_mass = 1.0 ShiftedKerrSchild::BH_spin = 0.9 ShiftedKerrSchild::KerrSchild_radial_shift = 0.4359 ADMBase::initial_data = "ShiftedKerrSchild" ADMBase::initial_lapse = "ShiftedKerrSchild" ADMBase::initial_shift = "ShiftedKerrSchild"
Please contact the author or the Einstein Toolkit mailing list users@einsteintoolkit.org.
bh_mass | Scope: restricted | REAL |
Description: The mass of the black hole. Let’s keep this at 1!
| ||
Range | Default: 1.0 | |
0.0:* | Positive
| |
bh_spin | Scope: restricted | REAL |
Description: The z-axis *dimensionless* spin of the black hole
| ||
Range | Default: 0.0 | |
-1.0:1.0 | Anything between -1 and +1
| |
kerrschild_radial_shift | Scope: restricted | REAL |
Description: Radial shift for Kerr Schild initial data. Actual shift =
KerrSchild_radial_shift*BH_mass
| ||
Range | Default: 0.0 | |
0.0:* | Positive
| |
initial_data | Scope: shared from ADMBASE | KEYWORD |
Extends ranges:
| ||
ShiftedKerrSchild | Initial data from ShiftedKerrSchild solution
| |
initial_lapse | Scope: shared from ADMBASE | KEYWORD |
Extends ranges:
| ||
ShiftedKerrSchild | Initial lapse from ShiftedKerrSchild solution
| |
initial_shift | Scope: shared from ADMBASE | KEYWORD |
Extends ranges:
| ||
ShiftedKerrSchild | Initial shift from ShiftedKerrSchild solution
| |
metric_type | Scope: shared from ADMBASE | KEYWORD |
Implements:
shiftedkerrschild
Inherits:
admbase
boundary
grid
Group Names | Variable Names | Details | |
shiftedkerrschild_3metric_shift | compact | 0 | |
SKSgrr | description | Shifted Kerr-Schild 3 metric and shift | |
SKSgrth | dimensions | 3 | |
SKSgrph | distribution | DEFAULT | |
SKSgthth | group type | GF | |
SKSgthph | tags | prolongation=”none” | |
SKSgphph | timelevels | 1 | |
SKSbetar | variable type | REAL | |
This section lists all the variables which are assigned storage by thorn WVUThorns/ShiftedKerrSchild. 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.
Always: | |
ShiftedKerrSchild_3metric_shift[1] | |
CCTK_PARAMCHECK (conditional)
shiftedkerrschild_paramcheck
check parameters for consitency and unsupported values
Language: | c | |
Type: | function | |
CCTK_INITIAL (conditional)
shiftedkerrschild_initial
schedule shiftedkerrschild initial data group
After: | admbase_initialgauge | |
Before: | hydrobase_initial | |
Type: | group | |
ShiftedKerrSchild_Initial (conditional)
shiftedks_id
set up shifted kerr-schild initial data
Language: | c | |
Type: | function | |
CCTK_PRESTEP (conditional)
shiftedks_id
set up shifted kerr-schild initial data
Language: | c | |
Type: | function | |
CCTK_ANALYSIS (conditional)
shiftedks_id
set up shifted kerr-schild initial data
Language: | c | |
Type: | function | |