Compiling ExoZvezda

In order to compile ExoZvezda, you need to checkout the adapted Chombo version (responsible for AMR and paralellisation) that can be found here. You should check the list of prerequisite libraries here and instructions on how to compile Chombo here. Once done, please set the shell environment variable CHOMBO_HOME as the path to the Chombo library. Usually the command for this is something like:

export CHOMBO_HOME=/path/to/Chombo/lib/

Next, you will also need to clone the main GRChombo repository, as we will use some of its functions from the Source folder. In order for your compiler to know where to look for these functions, please properly set the environment variable GRCHOMBO_SOURCE to the Source folder of the GRChombo code, e.g.

export GRCHOMBO_SOURCE=path/to/GRChombo/Source/

From now on, we will assume you have completed these required steps.

Now you are ready to compile ExoZvezda. First, clone the repository onto your local machine:

git clone https://github.com/GRTLCollaboration/ExoZvezda.git

If you plan to make significant changes to the code, we recommend you create your own fork, so that you can store your updates to the code. Please do not create branches in the ExoZvezda repository unless you have contacted us about an update.

Go to any example folder, e.g. Examples/BBSEqualMassFix and run

make all

This should compile without errors. See GRChombo's wiki page for advice on common errors.

If this example works, you can also navigate to the top of the ExoZvezda directory and compile all the examples in one go using the command

make all

If you subsequently change compiler options, use the command

make clean

or

make realclean

To start the compilation from a clean slate or change the XTRACONFIG variable in the Chombo Make.defs.local.