t8_time_prism_adapt.cxx

t8_time_prism_adapt

Overview

The t8_time_prism_adapt.cxx benchmark demonstrates adaptive mesh refinement (AMR) in time-prism domains, which are essential in simulations involving time-dependent partial differential equations.

This benchmark serves as a performance and correctness test for the library's AMR features.

---

Command-Line Options

Option	Argument	Description
-h, --help		Display a short help message.
-s, --slevel	INT	Initial refinement level.
-f, --flevel	INT	Final refinement level. Should be greater than or equal to initial refinement level.
-a, --adapt	INT (0/1)	Use adaptive refinement (1 = enabled, 0 = disabled).
-b, --balance		Establish a 2:1 balance in the forest (enforces mesh quality).
-c, --cube	INT (0/1)	Use hypercube mesh and visual output (1 = enabled).
-e, --elements	INT	Type of elements: 5 = tetrahedra, 6 = prisms.

---

Sample Usage

mpirun -np 2 ./t8_time_prism_adapt -s 1 -f 3 -e 6 -a 1 -c 1

This command runs the benchmark with:

• Prism elements (-e 6)
• Adaptivity enabled (-a 1)
• Hypercube mesh with visual output (-c 1)
• Initial refinement level set to 1 and final refinement level to 3

---

Output

• Timing and correctness information for AMR operations.
• Visual output files (if -c 1 is set) for mesh visualization in tools like ParaView.

---

Troubleshooting

• Ensure that the element type (-e) matches your simulation setup (5 for tetrahedra, 6 for prisms).
• Use -h to view the help message with full option details.
• If the program does not start or reports missing libraries, check your t8code build and MPI setup.