Getting Started - cmyoo/cosmos GitHub Wiki

How to start a numerical relativity simulation?

• There are only a few steps to just run a numerical relativity simulation with the simplest setup in a three-dimensional box.

• Before going further to compile and run, please see Prerequisites, although COSMOS does not require any other libraries.

1. Downloading COSMOS

The first step is to download a copy of COSMOS from this repo.

2. Making Project Directory

The second step is to make your own project by utilizing the attached script "makecosmos.sh". In short, as the initial test, you may create /flat_simplest directory at the top of COSMOS directory by doing the command as

./makecosmos.sh flat_simplest.

If the flat_simplest directory is created successfully at the top of COSMOS directory, you are ready to compile and run the code with the simplest setup.

3. Compiling and Running the Code

The last step is to move to the /flat_simplest directory as cd flat_simplest, do make there, and run the executable output as ./cosmos.

• This starts the numerical relativity simulation with the simplest setup explained in Flat Test.

4. Tutorials and examples

Here are tutorials for changing the setup in the simulation.

• Tutorial 1: This explains how to change initial conditions.

• Tutorial 2: This explains how to change boundary conditions.

• Non-trivial examples are further provided to understand how to actually do physical simulations in cosmological setups.