Skip to content

A 2D ideal GRMHD code derived from iharm3d with fewer dependencies and better documentation

License

Notifications You must be signed in to change notification settings

AFD-Illinois/iharm2d_v4

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

iharm2d_v4

iharm2d_v4 is the 2D version of iharm3d with minimal dependencies. iharm2d_v4 parallelizes computation across all cores of a single node using OpenMP. This means you must have a C compiler with OpenMP. Data is written out to ASCII files and a sample analysis script is provided at files/plot_density.py to get a feel for the output format. A more complete documentation of the native output format, both grid and dump files, can be found here. (One can always browse through core/io.c to get a better sense for the dump output).

Compiling and running

One can make the program from the output directory,

$ make -f IHARM2D_v4_DIRECTORY/makefile PROB=PROBLEM

where IHARM2D_v4_DIRECTORY is the path to your local iharm2d_v4 respository that contains the makefile. PROBLEM is the name of the problem you wish to run. NOTE: This must match the problem name in the prob directory. The makefile by default assumes the GCC as your compiler and that it is in your PATH.

The makefile will produce a directory named build_archive in your output directory. This contains all the source files (source code and header files) and a copy of the executable, harm. The executable is copied over to the output directory. Much like iharm3d, if build_archive already exists, make will prefer an newer/modified files in that directory over their equivalents in the original source. This allows you to modify the source code without disrupting the original repository.

When it comes to modifying parameters, iharm2d_v4 follows the ideology of iharm3d. Compile-time parameters are present in parameters.h located in build_archive while run-time parameters are provided via an additional parameter file param.dat. If you're modifying compile-time parameters (eg: grid size, floors, reconstruction scheme, boundary conditions), you'll have to rerun the make command. A sample param.dat file is provided at prob/PROBLEM/param.dat which must be copied over to your output directory. Run-time parameters include duration of the run, domain size, fluid properties, and any other problem specific parameters.

The problem can be executed by calling the harm executable,

$ ./harm -p param.dat >OUTPUT_LOG_FILE

where the STDOUT will be redirected to OUTPUT_LOG_FILE. If STDOUT is not redirected, the run-time log will be printed on the terminal.

About

A 2D ideal GRMHD code derived from iharm3d with fewer dependencies and better documentation

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published