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.

amr

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

amr

Grid parameters

Name:

xmin

Type:

double

Default:

-1.0

Range:

(*,*)

Description:

Lower end of grid in x direction

Name:

xmax

Type:

double

Default:

1.0

Range:

(*,*)

Description:

Upper end of grid in x direction

Name:

ymin

Type:

double

Default:

-1.0

Range:

(*,*)

Description:

Lower end of grid in y direction

Name:

ymax

Type:

double

Default:

1.0

Range:

(*,*)

Description:

Upper end of grid in y direction

Name:

zmin

Type:

double

Default:

-1.0

Range:

(*,*)

Description:

Lower end of grid in z direction

Name:

zmax

Type:

double

Default:

1.0

Range:

(*,*)

Description:

Upper end of grid in z direction

Name:

initial_refinement_level

Type:

unsigned int

Default:

0

Range:

[0,*)

Description:

Refinement level of base grid

Name:

npoints_block_x

Type:

unsigned int

Default:

16

Range:

[1,*)

Description:

Number of cells/quadrant in x direction. Prefer powers of 2, must be larger than 2*n_ghost. WARNING: currently grace requires number of cells in all directions to be equal.

Name:

npoints_block_y

Type:

unsigned int

Default:

16

Range:

[1,*)

Description:

Number of cells/quadrant in y direction. Prefer powers of 2, must be larger than 2*n_ghost. WARNING: currently grace requires number of cells in all directions to be equal.

Name:

npoints_block_z

Type:

unsigned int

Default:

16

Range:

[1,*)

Description:

Number of cells/quadrant in z direction. Prefer powers of 2, must be larger than 2*n_ghost. WARNING: currently grace requires number of cells in all directions to be equal.

Name:

n_ghostzones

Type:

unsigned int

Default:

4

Range:

[1,*)

Description:

Number of ghost cells per quadrant. Must be even. Unless code is modified, must be >=4 for WENO-5 reconstruction and 4th order FD.

Name:

periodic_x

Type:

bool

Default:

False

Description:

Is the grid periodic in x?

Name:

periodic_y

Type:

bool

Default:

False

Description:

Is the grid periodic in y?

Name:

periodic_z

Type:

bool

Default:

False

Description:

Is the grid periodic in z?

reflection_symmetries

Grid reflection symmetries

Name:

x

Type:

bool

Default:

False

Description:

X reflection symmetry

Name:

y

Type:

bool

Default:

False

Description:

Y reflection symmetry

Name:

z

Type:

bool

Default:

False

Description:

Z reflection symmetry

Name:

regrid_every

Type:

int

Default:

-1

Range:

[-1,*)

Description:

Regrid frequency, expressed in iteration count. -1 switches off the regrid

Name:

max_refinement_level

Type:

unsigned int

Default:

11

Range:

[1,*)

Description:

Maximum allowed regrid depth. Note this only affects AMR. FMR ignores this.

Name:

regrid_at_preinitial

Type:

bool

Default:

False

Description:

If enabled, performs a regrid before initial data is set.

Name:

preinitial_regrid_depth

Type:

unsigned int

Default:

1

Range:

[1,*)

Description:

If regrid_at_preinitial, how many regrids are performed

Name:

regrid_at_postinitial

Type:

bool

Default:

False

Description:

If enabled, performs a regrid after initial data is set and before evolution.

Name:

postinitial_regrid_depth

Type:

unsigned int

Default:

1

Range:

[1,*)

Description:

If regrid_at_postinitial, how many regrids are performed

Name:

refinement_criterion

Type:

keyword

Default:

FLASH_second_deriv

Range:

FLASH_second_deriv, simple_threshold, gradient, shear, binary_tracker

Description:

Criterion for refinement/derefinement

Name:

refinement_criterion_reduction

Type:

keyword

Default:

max

Range:

max, min

Description:

How to reduce the error estimate across cells in a quadrant

Name:

refinement_criterion_CTORE

Type:

double

Default:

0.8

Range:

(*,*)

Description:

If error_estimate > CTORE, flag for refinement

Name:

refinement_criterion_CTODE

Type:

double

Default:

0.8

Range:

(*,*)

Description:

If error_estimate < CTODE, flag for derefinement

Name:

refinement_criterion_var

Type:

string

Default:

dens

Description:

Name of variable used for error estimate evaluation, only cell centered is valid.

Name:

refinement_criterion_var_is_aux

Type:

bool

Default:

False

Description:

Is the variable used in refinement an auxiliary variable?

Name:

FLASH_criterion_eps

Type:

double

Default:

0.01

Range:

(0,*)

Description:

Epsilon in the denominator of second derivative refinement criterion

binary_tracker_amr_criterion

AMR criterion that tracks two compact objects

Name:

compact_object_1_refine_radius_factor

Type:

double

Default:

1

Range:

(0,*)

Description:

Refine blocks within this x radius of the CO 1’s center

Name:

compact_object_2_refine_radius_factor

Type:

double

Default:

1

Range:

(0,*)

Description:

Refine blocks within this x radius of the CO 2’s center

Name:

compact_object_1_coarsen_radius_factor

Type:

double

Default:

10

Range:

(0,*)

Description:

Refine blocks outside this x radius of the CO 1’s center

Name:

compact_object_2_coarsen_radius_factor

Type:

double

Default:

10

Range:

(0,*)

Description:

Refine blocks outside this x radius of the CO 2’s center

Name:

post_merger_refine_radius

Type:

double

Default:

10

Range:

(0,*)

Description:

After merger, refine a region within this radius of the origin

Name:

post_merger_coarsen_radius

Type:

double

Default:

20

Range:

(0,*)

Description:

After merger, coarsen anything outside this radius of the origin (FMR grid is always preserved).

Name:

n_fmr_boxes

Type:

unsigned int

Default:

0

Range:

[0,*)

Description:

Number of FMR boxes set up before initial data

fmr_boxes

Fixed mesh refinement boxes applied before initial data.

Name:

target_level_delta

Type:

unsigned int

Default:

1

Range:

[1,*)

Description:

How many levels above the base grid?

Name:

x_min

Type:

double

Default:

-1.0

Range:

(*,*)

Description:

Name:

x_max

Type:

double

Default:

1.0

Range:

(*,*)

Description:

Name:

y_min

Type:

double

Default:

-1.0

Range:

(*,*)

Description:

Name:

y_max

Type:

double

Default:

1.0

Range:

(*,*)

Description:

Name:

z_min

Type:

double

Default:

-1.0

Range:

(*,*)

Description:

Name:

z_max

Type:

double

Default:

1.0

Range:

(*,*)

Description: