This is the documentation of the most upstream development version of GRACE. If you're looking for the last stable release please select a different version of this documentation.

grmhd

This page contains a full reference of all parameters available for the grmhd module. At the bottom of the page you can find an example parameter block that can be used in your parameter file.

grmhd

GRMHD

Name:

bc_kind

Type:

keyword

Default:

outgoing

Range:

outgoing, none

Description:

Boundary conditions

Name:

id_type

Type:

keyword

Default:

minkowski_vacuum

Range:

minkowski_vacuum, shocktube, magnetic_rotor, bondi_flow, orszag_tang_vortex, fmtorus, tov, blastwave, gas_cloud, puncture, lorene_bns, two_punctures, fuka

Description:

Initial data type

atmosphere

Parameters describing atmosphere conditions

Name:

rho_fl

Type:

double

Default:

1e-14

Range:

[0,*)

Description:

Rest mass density floor

Name:

ye_fl

Type:

double

Default:

0.0

Range:

[0,*)

Description:

Ye floor (if not beta_eq)

Name:

temp_fl

Type:

double

Default:

0.0

Range:

[0,*)

Description:

temperature floor

Name:

rho_scaling

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Atmosphere density is rho_fl * r^(rho_scaling)

Name:

temp_scaling

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Atmosphere temperature is temp_fl * r^(temp_scaling)

Name:

atmosphere_is_beta_eq

Type:

bool

Default:

True

Description:

Override ye_fl with beta equilibrium ye at atmosphere conditions

Name:

atmo_tol

Type:

double

Default:

1e-3

Range:

[0,*)

Description:

When setting points to atmosphere, check if rho < rho_atm * (1+tol)

excision

Parameters describing excision conditions

Name:

excision_criterion

Type:

keyword

Default:

lapse

Range:

lapse, radius

Description:

Either excise when alpha<alpha_exc or r<r_exc

Name:

excision_lapse

Type:

double

Default:

0.05

Range:

(0,*)

Description:

If excision criterion is lapse, where to excise

Name:

excision_radius

Type:

double

Default:

1.0

Range:

(0,*)

Description:

If excision criterion is radius, where to excise

c2p

Parameters that control the behaviour of the c2p

Name:

tolerance

Type:

double

Default:

1e-10

Range:

(0,*)

Description:

Tolerance for accepting c2p inversion

Name:

max_lorentz

Type:

double

Default:

50

Range:

[1,*)

Description:

Maximum allowed Lorentz factor

Name:

max_sigma

Type:

double

Default:

100

Range:

[0,*)

Description:

Maximum allowed magnetization

Name:

use_c2p_entropy_backup

Type:

bool

Default:

True

Description:

Fall back to entropy prescription on c2p failure

Name:

beta_fallback

Type:

double

Default:

1e-2

Range:

[0,*)

Description:

Directly use entropy backup if beta<fallback_threshold

Name:

bh_alp_thresh

Type:

double

Default:

0.2

Range:

(0,*)

Description:

If alp <= thresh we are inside a BH and c2p errors become lenient

Name:

B_field_initialization

Type:

keyword

Default:

none

Range:

none, from_Avec, direct

Description:

How should we initialize the magnetic field?

Avec_ID

Parameters for initialization of vector potential at cell edges

Name:

Avec_kind

Type:

keyword

Default:

poloidal_confined

Range:

poloidal_confined

Description:

Avec prescription

Name:

cutoff_var

Type:

string

Default:

press

Description:

Variable on which A depends

Name:

cutoff_fact

Type:

double

Default:

0.02

Range:

(0,1)

Description:

Fraction of max(var) at below which A is zero

Name:

Bmax_target

Type:

double

Default:

0.0

Range:

[0,*)

Description:

Target |B|_max at cell center, in code units

Name:

A_n

Type:

double

Default:

1.0

Range:

[0,*)

Description:

Power law index of A(var) dependence

Name:

is_binary

Type:

bool

Default:

False

Description:

Is initial data a binary system?

Name:

x_c_1

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Center around which A is set (if binary center of star 1)

Name:

y_c_1

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Center around which A is set (if binary center of star 1)

Name:

z_c_1

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Only for binary: center of second star

Name:

radius_1

Type:

double

Default:

100

Range:

(0,*)

Description:

Approximate radius of star 1, must not overlap with companion, must contain star.

Name:

x_c_2

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Only for binary: center of second star

Name:

y_c_2

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Only for binary: center of second star

Name:

z_c_2

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Only for binary: center of second star

Name:

radius_2

Type:

double

Default:

1

Range:

(0,*)

Description:

Approximate radius of star 2, must not overlap with companion, must contain star.

bondi_flow

Parameters for Bondi ID

Name:

r_c

Type:

double

Default:

8.0

Range:

(0,*)

Description:

Critical radius

Name:

K

Type:

double

Default:

1.0

Range:

(0,*)

Description:

Initial data adiabat

Name:

gamma

Type:

double

Default:

1.3333

Range:

(1,*)

Description:

Initial data gamma

Name:

temp_min

Type:

double

Default:

0.01

Range:

(0,*)

Description:

Lower bound for T

Name:

temp_max

Type:

double

Default:

10

Range:

(0,*)

Description:

Upper bound of T

Name:

spin

Type:

double

Default:

0.0

Range:

[0,1)

Description:

Black hole spin

Name:

spec_ang_mom

Type:

double

Default:

0.0

Range:

[0,*)

Description:

Specific angular momentum

Name:

spec_ang_mom_scaling

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Scaling of j with theta

Name:

is_magnetized

Type:

bool

Default:

False

Description:

Add a radial monopole B field?

Name:

beta_c

Type:

double

Default:

0.246

Range:

(0,*)

Description:

Plasma beta at rc for B field normalization

vacuum

Parameters for minkowski constant state

Name:

rho_floor

Type:

double

Default:

1e-15

Range:

(0,*)

Description:

Rest mass density

Name:

press_floor

Type:

double

Default:

1e-15

Range:

(0,*)

Description:

Pressure

Name:

velocity_x

Type:

double

Default:

0.0

Range:

(*,*)

Description:

v^x

Name:

velocity_y

Type:

double

Default:

0.0

Range:

(*,*)

Description:

v^y

Name:

velocity_z

Type:

double

Default:

0.0

Range:

(*,*)

Description:

v^z

shocktube

Parameters for shocktube problem

Name:

press_L

Type:

double

Default:

13.3

Range:

(0,*)

Description:

Pressure in left state

Name:

press_R

Type:

double

Default:

6.6e-07

Range:

(0,*)

Description:

Pressure in right state

Name:

rho_L

Type:

double

Default:

10.0

Range:

(0,*)

Description:

Rest mass density in left state

Name:

rho_R

Type:

double

Default:

1.0

Range:

(0,*)

Description:

Rest mass density in right state

Name:

Bx_L

Type:

double

Default:

0.0

Range:

(*,*)

Description:

B^x in left state (note you must set B_initialization to direct)

Name:

Bx_R

Type:

double

Default:

0.0

Range:

(*,*)

Description:

B^x in right state (note you must set B_initialization to direct)

Name:

By_L

Type:

double

Default:

0.0

Range:

(*,*)

Description:

B^y in left state (note you must set B_initialization to direct)

Name:

By_R

Type:

double

Default:

0.0

Range:

(*,*)

Description:

B^y in right state (note you must set B_initialization to direct)

Name:

Bz_L

Type:

double

Default:

0.0

Range:

(*,*)

Description:

B^z in left state (note you must set B_initialization to direct)

Name:

Bz_R

Type:

double

Default:

0.0

Range:

(*,*)

Description:

B^z in right state (note you must set B_initialization to direct)

magnetic_rotor

Parameters for magnetic rotor test

Name:

rho_in

Type:

double

Default:

10.0

Range:

(0,*)

Description:

Density inside cylinder

Name:

rho_out

Type:

double

Default:

1.0

Range:

(0,*)

Description:

Density outside cylinder

Name:

press

Type:

double

Default:

1.0

Range:

(0,*)

Description:

Pressure

Name:

B0

Type:

double

Default:

1.0

Range:

(*,*)

Description:

B^x

orszag_tang_vortex

Parameters for Orszag-Tang vortex test

Name:

press

Type:

double

Default:

10.0

Range:

(0,*)

Description:

Pressure

Name:

rho

Type:

double

Default:

1.0

Range:

(0,*)

Description:

density

fmtorus

Parameters for Fishborne Moncrief torus

Name:

a_BH

Type:

double

Default:

0.9375

Range:

(0,1)

Description:

Black hole spin

Name:

rho_min

Type:

double

Default:

1e-05

Range:

(0,*)

Description:

Minimum density

Name:

rho_max

Type:

double

Default:

1.0

Range:

(0,*)

Description:

Maximum density

Name:

lapse_min

Type:

double

Default:

0.2

Range:

(0,*)

Description:

Minimum lapse

Name:

press_min

Type:

double

Default:

3.33e-08

Range:

(0,*)

Description:

Minimum pressure

Name:

r_in

Type:

double

Default:

6.0

Range:

(0,*)

Description:

Radius of inner edge

Name:

r_at_max_density

Type:

double

Default:

12.0

Range:

(0,*)

Description:

Radius of max density location

Name:

gamma

Type:

double

Default:

1.333333

Range:

(1,*)

Description:

Gamma of initial data EOS (polytrope selected by rho_max/press_max)

Name:

max_inverse_beta

Type:

double

Default:

100

Range:

[0,*)

Description:

Scale of magnetic field

Name:

perturbation_amplitude

Type:

double

Default:

0.0

Range:

[0,*)

Description:

Pressure perturbation scale, currently broken

Name:

rho_power

Type:

double

Default:

-1.5

Range:

(*,*)

Description:

Power law decay in rho

Name:

press_power

Type:

double

Default:

-2.5

Range:

(*,*)

Description:

Power law decay in press

lorene_bns

Lorene BNS ID

Name:

filename

Type:

string

Default:

./id.res

Description:

Filename containing initial data for LORENE ID

Name:

set_shift_to_zero

Type:

bool

Default:

False

Description:

Initially set the shift to zero?

Name:

reset_eps

Type:

bool

Default:

False

Description:

Recompute eps after initial data?

fuka

FUKA ID

Name:

filename

Type:

string

Description:

Filename containing initial data for FUKA ID

Name:

id_dir

Type:

string

Description:

Directory containing the FUKA ID

Name:

fuka_id_type

Type:

keyword

Default:

BNS

Range:

BH, BBH, NS, BNS, BHNS

Description:

type of FUKA data

Name:

id_interpolation_offset

Type:

double

Default:

0.0

Range:

[0,*)

Description:

Offset applied during ID interpolation

Name:

junk_interp_order

Type:

int

Default:

8

Range:

[3,8]

Description:

Interpolation order used for junk radiation removal

Name:

delta_r_rel

Type:

double

Default:

0.3

Range:

(0,*)

Description:

Relative radial offset for interpolation grid adjustment

Name:

set_shift_to_zero

Type:

bool

Default:

True

Description:

set the initial shift to zero (recommended)

two_punctures

Parameters for TwoPunctures initial data

Name:

par_b

Type:

double

Default:

1

Range:

(0,*)

Description:

Distance of the two punctures along the x axis

Name:

target_M_plus

Type:

double

Default:

1

Range:

(0,*)

Description:

ADM mass of the first puncture

Name:

par_P_plus_x

Type:

double

Default:

0

Range:

(*,*)

Description:

Momentum of the first puncture along x

Name:

par_P_plus_y

Type:

double

Default:

0

Range:

(*,*)

Description:

Momentum of the first puncture along y

Name:

par_P_plus_z

Type:

double

Default:

0

Range:

(*,*)

Description:

Momentum of the first puncture along z

Name:

par_S_plus_x

Type:

double

Default:

0

Range:

(*,*)

Description:

Angular momentum of the first puncture along x

Name:

par_S_plus_y

Type:

double

Default:

0

Range:

(*,*)

Description:

Angular momentum of the first puncture along y

Name:

par_S_plus_z

Type:

double

Default:

0

Range:

(*,*)

Description:

Angular momentum of the first puncture along z

Name:

target_M_minus

Type:

double

Default:

1

Range:

(0,*)

Description:

ADM mass of the second puncture

Name:

par_P_minus_x

Type:

double

Default:

0

Range:

(*,*)

Description:

Momentum of the second puncture along x

Name:

par_P_minus_y

Type:

double

Default:

0

Range:

(*,*)

Description:

Momentum of the second puncture along y

Name:

par_P_minus_z

Type:

double

Default:

0

Range:

(*,*)

Description:

Momentum of the second puncture along z

Name:

par_S_minus_x

Type:

double

Default:

0

Range:

(*,*)

Description:

Angular momentum of the second puncture along x

Name:

par_S_minus_y

Type:

double

Default:

0

Range:

(*,*)

Description:

Angular momentum of the second puncture along y

Name:

par_S_minus_z

Type:

double

Default:

0

Range:

(*,*)

Description:

Angular momentum of the second puncture along z

Name:

npoints_A

Type:

unsigned int

Default:

30

Range:

(0,*)

Description:

Number of points on grid for first puncture

Name:

npoints_B

Type:

unsigned int

Default:

30

Range:

(0,*)

Description:

Number of points on grid for second puncture

Name:

npoints_phi

Type:

unsigned int

Default:

16

Range:

(0,*)

Description:

Number of points on phi grid, must be multiple of 4

Name:

TP_epsilon

Type:

double

Default:

0

Range:

[0,*)

Description:

A small number to smooth out singularities at the puncture locations

tov

TOV initial data

Name:

rho_c

Type:

double

Default:

0.00128

Range:

(0,*)

Description:

Central density of the TOV

Name:

press_floor

Type:

double

Default:

1e-6

Range:

(0,*)

Description:

Floor of the pressure

Name:

dr

Type:

double

Default:

1e-3

Range:

(0,*)

Description:

Radial grid spacing

Name:

pert_amp

Type:

double

Default:

0.0

Range:

(*,*)

Description:

Radial velocity perturbation amplitude